dsh-gitflow

面向 DeepSeek Harness 的 Git 状态、diff、日志、提交、分支和可选恢复点工具集。

可安装的 v0.1.1 面向 DSH 0.1.0-rc.6；npm 是后续可选的额外分发渠道。

English

MVP

• git_status 读取当前分支和工作树状态计数；
• git_diff 读取未暂存或已暂存 diff，不改动 index；
• git_log 返回有上限的结构化提交记录，并处理空仓库；
• git_commit 只提交已经暂存的改动，并经过 DSH 审批；
• git_branch 列出本地分支，创建和切换需要审批；
• /commit 先加载暂存改动审查技能，再调用 git_commit；
• checkpoint_list 和两阶段 checkpoint_restore 委托给可选的 Change Ledger 服务；
• 可选的 autoCheckpoint 在配置的写工具执行前创建 Change Ledger 恢复点。

PR 创建、push、worktree 管理和分支删除不在 MVP 范围内。

安全约束

GitFlow 不会隐式暂存文件，也不会执行 git add、git reset、git stash、git push、跳过 hook 的参数或破坏性分支命令。Git 参数经过 shell 引用，提交信息通过 stdin 传给 Git。所有 Git 进程都经过 DSH shell service，因此沿用其超时、沙箱、取消和执行环境。

会修改状态的工具调用经过 DSH 审批。/commit 只负责排入用户显式调用的技能，最终的 git_commit 工具调用仍会触发审批。

与 Change Ledger 的关系

dsh-turn-rewind 负责工作区快照、恢复计划、救援点、过期计划检查和恢复后验证。GitFlow 不再实现第二套 stash 或 commit-tree 恢复引擎。

没有挂载兼容的 ctx.changeLedger 服务时，普通 Git 工具照常工作，检查点工具会明确提示配置缺失。恢复点本身已经是持久事实源，因此插件不会再用必需的自定义会话事件复制一份状态。

安装

当前代码面向 DSH 0.1.0-rc.6 插件 API，要求 Node.js ^22.19 || >=24。

dsh plugin --profile web add https://github.com/lonelymoon87/dsh-gitflow/releases/download/v0.1.1/dsh-gitflow-0.1.1.tgz