智能提交 qingyou002/dsh-git-commit

dsh-git-commit

DeepSeek Harness 插件，添加一个全局斜杠命令 —— /commit。它把会话工作目录里的所有改动暂存起来，交给会话当前使用的模型总结暂存的 diff，再用这条消息提交。

English · 中文说明

它做什么

/commit 分五步执行：

1. 检查会话工作目录是否在 Git 工作树内，不在就停下来并给出说明。
2. 用 git add -A 暂存所有内容，包括未跟踪的文件。
3. 除非你自己提供了提交消息，否则把 git diff --cached 发给会话当前使用的模型，让它写一条提交消息：第一行用 模块: 描述 的形式（模块加改了什么，≤ 50 个字符），后面跟 3–8 条 - 要点，按模块或主题总结实质性改动，而不是罗列文件。
4. 用 git commit -m -m <bullets> 提交。
5. 报告短哈希、要点，以及文件清单，每个文件带 +added / -deleted 计数。

有两条路径会跳过模型调用：

- 你自己传了消息 —— /commit 修正登录超时 就用这段文字当标题。
- 自动兜底 —— 模型路由未设置、调用超时，或回复不可用时，插件根据改动的路径拼出一条确定的中文标题，照常提交，并在输出开头加一条警告，写明失败原因和它尝试的路由。模型出错绝不会把你的改动留在暂存区不提交。

路由取自会话的 model/selection 事件和最后一次 request/header 中较新的那个，所以会话中途切换模型会被尊重，而不是沿用智能体创建时捕获的路由。

它不做的事：从不 push，从不创建或切换分支，从不 amend，从不碰远程。它只运行 git add -A 和 git commit，都在会话工作目录里。

它也不带任何浏览器 UI。命令通过 commands 服务在宿主侧注册，所以只要某个配置档提供了这个服务就能用 —— 不限于 web。

安装

dsh plugin --profile web add github:qingyou002/dsh-git-commit

dsh plugin 会在配置档目录里转发给 pnpm，然后把包追加到 dsh.profile.bundles，因为它声明了 dsh.bundle。命令在该配置档的每个会话里都能用 —— 如果 DSH 已经在运行，重启一下。

从克隆仓库做开发安装：

git clone https://github.com/qingyou002/dsh-git-commit
in ~/.dsh/profiles/web/package.json add:
"dsh-git-commit": "link:/absolute/path/to/dsh-git-commit"
cd ~/.dsh/profiles/web && pnpm install

用法

/commit # the model writes the message
/commit 修复登录超时 # your text becomes the title; no model call

输出示例：

✅ 已提交 a1b2c3d：后台: 修复令牌过期后未刷新

📝 改动要点
- 令牌过期时改为静默刷新并重试原请求
- 新增刷新失败后的登出提示

📦 文件清单（3 个文件：修改 2，新增 1）修改 application/api/auth.js (+18 -4) 新增 application/api/token.js (+42 -0) 修改 public/assets/app.js (+3 -1)

配置

每个选项都可选；默认值如下。

| 选项 | 默认值 | 含义 |
| timeoutMs | 90000 | 总结模型调用的截止时间，单位毫秒。 |
| maxDiffChars | 48000 | 暂存的 diff 超过这么多字符就会被截断——保留头尾，中间用标记标出缺口——然后再发送。 |
| maxTokens | 2048 | 总结调用的 token 上限。 |
| maxTitleChars | 100 | 首行的硬性上限；标题过长会被截断并加上 ... 后缀。 |
| maxBullets | 12 | 从回复中保留的要点行数上限。 |

在配置档补丁层里覆盖它们：

~/.dsh/profiles/web/cordis.patch.yml
- id: dsh-git-commit
config:
timeoutMs: 60000

环境要求

- 一个提供 @deepseek-ai/dsh-commands、@deepseek-ai/dsh-llm 和 @deepseek-ai/dsh-util-values 的 DeepSeek Harness 构建——这些声明为 peerDependencies，已针对 0.1.5-rc.3 测试。
- Node.js ≥ 20。
- PATH 中有 git。插件会调用 git 二进制文件，缺失时会直接说明。
- 会话中配置了模型路由，用于生成 AI 撰写的提交信息；没有配置时，本地回退逻辑仍会完成提交。

中文说明

/commit 是全局斜杠命令：把当前会话工作目录里的全部改动 git add -A 暂存，用会话当前正在使用的模型总结 git diff --cached，再按总结结果提交。

- /commit：模型生成提交信息，首行为 模块: 描述（≤50 字），随后 3~8 条 - 要点，按模块或主题概括实质改动，不逐文件罗列文件名。
- /commit 你自己写的说明：直接用你的文字作标题，不调用模型。
- 模型调用失败时（未配置模型路由、超时、输出无法解析）不会中断提交：改用本地规则按改动路径生成中文标题正常提交，并在输出开头标注失败原因与尝试过的路由。模型报错不会把你的改动留在「已暂存未提交」状态。
- 只做本地 git add -A 与 git commit：不会 push、不会新建或切换分支、不会 amend、不碰远端。
- 不带任何浏览器界面：命令通过 commands 服务注册在宿主侧，凡是提供该服务的 profile（不限于 web）都能用。

配置项与默认值：timeoutMs 90000、maxDiffChars 48000、maxTokens 2048、maxTitleChars 100、maxBullets 12；在 ~/.dsh/profiles/web/cordis.patch.yml 里用 - id: dsh-git-commit 加 config: 覆盖。

安装：

dsh plugin --profile web add github:qingyou002/dsh-git-commit

License

MIT