hyp difflog.md - maoxiaoyue/hypgo GitHub Wiki
hyp diff-log — AI 變更追蹤
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 # 查看當前設定
Flags
| Flag | 說明 |
|---|---|
--on |
開啟 diff-log，寫入 .hyp/config.json |
--off |
關閉 diff-log |
--status |
顯示當前開關狀態 |
| （無 flag） | 執行一次記錄 |
Log 輸出位置
logs/ai.diff_20260410.log
每天一個檔案，同一天的多次記錄會 append 到同一個檔案。
Log 格式
===== 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 # 不管開關，手動跑一次
與 git hook 的關係
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 — 變更前分析影響範圍