Claude 对话追踪插件（中文包）

该 NPM 包为中文文档发行版，核心功能复用 claude-conversation-tracker，并提供中文 README 以便团队快速上手。

安装

npm install claude-conversation-tracker-zh claude-conversation-tracker

说明：本包导出内容与核心包一致（通过 re-export），因此使用方式与 claude-conversation-tracker 完全相同；本文档仅提供中文说明。

快速开始

1. 构建核心：

npm run build

2. 启用 Git 提交后钩子（post-commit）：

chmod +x .git/hooks/post-commit

钩子会在每次 git commit 后调用 tools/track-commit.js，把本次提交的文件改动（含 +/− 行数与统一 diff 片段）写入 .talk/conversations/<会话ID>.md。

3. 配置文件：conversation-tracker.config.json

{
  "enabled": true,
  "autoCreateBranch": true,
  "autoCommit": true,
  "autoCreateMR": true,
  "preferLowLevel": true,
  "trackAllTools": true,
  "branchPrefix": "claude-conv-",
  "talkDirectory": ".talk",
  "authorName": "Claude",
  "authorEmail": "[email protected]",
  "defaultTargetBranch": "main",
  "mergeRequestProvider": "gitlab"
}

• enabled：全局开关
• autoCreateBranch：会话开始时自动创建分支（branchPrefix + 会话ID）
• autoCommit：记录变更后自动提交 .talk 更新
• autoCreateMR：会话结束时自动创建 MR（需要平台 CLI 已登录）

可通过环境变量临时覆盖：TRACKER_ENABLED、TRACKER_AUTO_CREATE_MR 等。

手动触发（可选）

# 开始会话
node codex-hook.js start '{"initialMessage":"实现登录功能"}'

# 追踪某次工具使用（例如编辑文件）
node codex-hook.js action '{
  "tool": {"name":"Edit", "parameters": {"file_path":"src/app.ts","old_string":"...","new_string":"..."}},
  "result": {"ok": true}
}'

# 结束会话（根据配置自动提交/推送/建 MR）
node codex-hook.js end

查看输出

• .talk/conversations/<会话ID>.md：会话摘要（初始需求、每次改动、影响级别、diff 片段）
• .talk/index.md：会话索引（同一会话仅保留一条入口，不重复）

故障排查

• 若出现空文件递增或“0 changes”循环：
  • 暂时禁用钩子：mv .git/hooks/post-commit .git/hooks/post-commit.disabled
  • 结束残留进程：终止 tools/track-commit.js 相关进程
  • 清理状态：删除 .talk/.hook-state.json
  • 恢复启用后做一次正常提交进行验证

清理旧会话（可选）

node tools/cleanup-talk.js

仅保留活跃/最新会话并重建索引。

更多细节请参考仓库下的 doc/README.zh-CN.md。