-
Notifications
You must be signed in to change notification settings - Fork 0
hyp difflog.md
maoxiaoyue edited this page Apr 14, 2026
·
1 revision
v0.8.5+此命令為 HypGo v0.8.5 新增功能,v0.8.1 版本不包含。
記錄所有 AI(或人)對專案的改動,產出每日 log 檔案。可開關控制 — 關閉時省 token,開啟時追蹤完整過程。
hyp diff-log # 記錄當前所有未 commit 的改動 hyp diff-log --on # 開啟追蹤(AI 工具會自動記錄) hyp diff-log --off # 關閉追蹤(省 token) hyp diff-log --status # 查看當前設定
| Flag | 說明 |
|---|---|
--on |
開啟 diff-log,寫入 .hyp/config.json
|
--off |
關閉 diff-log |
--status |
顯示當前開關狀態 |
| (無 flag) | 執行一次記錄 |
logs/ai.diff_20260410.log
每天一個檔案,同一天的多次記錄會 append 到同一個檔案。
===== 2026年04月10日 01:06:53 =====
Branch: dev_20260403
--- Changed Files ---
cmd/hyp/generate.go | 21 +++-
pkg/grpc/server.go | 187 ++++++
--- Line Changes (added/deleted/file) ---
20 1 cmd/hyp/generate.go
187 0 pkg/grpc/server.go
--- New Files (untracked) ---
+ pkg/grpc/server.go (187 lines)
+ pkg/grpc/interceptor/auth.go (67 lines)
==========================================
設定存在 .hyp/config.json(專案級別):
{
"diff_log": true
}hyp ai-rules 生成的 AGENTS.md / GEMINI.md 等配置檔會包含:
- After making changes: Run `hyp diff-log` to log your changes
所有 AI 工具看到這行指令,改完後就會自動跑 hyp diff-log。
AGENTS.md 不包含上述指令 — AI 不知道要記錄,省下 ~20 tokens/次。
# 開發初期:開啟追蹤,了解 AI 做了什麼 hyp diff-log --on hyp ai-rules # 更新 AI 配置檔 # 穩定期:關閉追蹤,省 token hyp diff-log --off hyp ai-rules # 移除追蹤指令 # 臨時查看當前改動 hyp diff-log # 不管開關,手動跑一次
hyp diff-log 是主動記錄(AI 或人手動呼叫)。若需要 commit 時自動記錄,可搭配 git pre-commit hook:
# .git/hooks/pre-commit 會自動記錄 staged changes # hyp diff-log 記錄所有改動(包含 unstaged + untracked)
兩者互補,不衝突。
- hyp ai-rules — 生成 AI 配置檔(受 diff-log 開關影響)
- hyp impact — 變更前分析影響範圍
設計文件
套件
- config — 設定
- context — 請求上下文
- router — 路由器
- server — 伺服器
- middleware — 中介層
- websocket — WebSocket
- hidb — 資料庫 ORM
- hidb/cassandra — Cassandra
- logger — 日誌
- json — JSON 處理
- grpc — gRPC
AI 協作工具鏈
- schema — Schema-first 路由
- manifest — 專案 Manifest
- contract — Contract Testing
- errors — Typed Error Catalog
- migrate — Migration Diff
- scaffold — 智慧 Scaffold
- airules — AI Rules
CLI 命令
- hyp 總覽
- hyp new
- hyp api
- hyp run
- hyp restart
- hyp generate
- hyp migrate
- hyp context
- hyp ai-rules
- hyp chkcomment
- hyp impact
- hyp docker
- hyp health
- hyp version
- hyp difflog
Design Docs
Packages
- config — Configuration
- context — Request Context
- router — Router
- server — Server
- middleware — Middleware
- websocket — WebSocket
- hidb — Database ORM
- hidb/cassandra - Cassandra 5.0
- logger — Logger
- json — JSON
- grpc — gRPC
AI Collaboration Toolchain
- schema — Schema-first Routing
- manifest — Project Manifest
- contract — Contract Testing
- errors — Typed Error Catalog
- migrate — Migration Diff
- scaffold — Smart Scaffold
- airules — AI Rules
CLI Commands