前言¶
在 DeepSeek Harness(DSH)的工作流中,Git 提交通常涉及模型读取大量原始 git 输出并生成 Shell 命令,这不仅消耗 token,还容易出错。dsh-plugin-git-commit-push 是一个 0 Token Git 提交推送插件,旨在将这一流程压缩为 1-2 次工具调用或一个斜杠命令,按 Conventional Commits 规范为每个变更文件自动生成提交信息,并按 type(scope) 拆分后一次推送到远程仓库。
核心功能¶
- 斜杠命令调用:通过
/git-commit-push使用,完全不经过模型,真正实现 0 Token 提交与推送。 - 工具调用:通过
git_commit_push工具调用,极少量 Token 即可完成高质量的注释和拆分提交。 - 自动生成提交信息:按 Conventional Commits 为每个变更文件自动生成提交信息。
- 拆分提交:按
type(scope)拆成多次提交后一次推送。 - 跨平台支持:支持 Windows、macOS、Linux。
安装¶
使用插件命令安装,安装后需重启 DSH 使其生效。
dsh plugin --profile web add dsh-plugin-git-commit-push
使用方式¶
1. 斜杠命令¶
直接在输入框输入 /git-commit-push,由脚本自动执行提交与推送。
2. 工具调用¶
模型可通过工具调用完成操作。
// 自动提交并推送
git_commit_push({ action: 'auto' })
// 仅汇总改动,不修改仓库(用于用户挑选提交信息)
git_commit_push({ action: 'prepare' })
// 使用自定义提交信息进行提交与推送
git_commit_push({ action: 'apply', message: 'feat(x): …' })
// 自动提交并推送,附带标签
git_commit_push({ action: 'auto', tag: 'v1.2.3' })
注意事项¶
- 触发条件:插件只在用户敲斜杠命令或明确要求时触发,绝不自动触发。例如,编辑文件不等于要求提交。
- 环境要求:需要 DSH 版本
>=0.2.0-rc.1 <0.3.0,Node.js>=24,git>=2.36。 - Token 消耗:斜杠命令路径为 0 Token;工具调用路径需消耗少量 Token(参数 + 卡片);只要插件安装且工具可见,其 schema 会进入每次请求,约消耗 600 Token。