前言¶
DSH 的理念是通过插件组合能力。dsh-commit-review 是 the-qian 维护的一个 DSH 插件,为 Web GUI 增加 /commit 与 /review 两个斜杠命令,用于处理当前 git 变更的提交与审查。该插件采用 MIT 许可证,包名与仓库名均为 dsh-commit-review。
这是什么¶
dsh-commit-review 采用 dsh.bundle.patch 形态接入 Web profile,为 DSH Web GUI 提供两个命令入口:
/commit:分析当前 git 变更,并创建提交。/review:审查当前未提交的变更,并输出报告。
插件本体是纯 Host 侧、零依赖、无构建步骤,lib/index.js 即最终产物。
核心能力¶
/commit¶
/commit 会分析当前 git 变更,并真正创建提交,而不仅输出提交建议。它支持 Conventional Commits 类型/范围。提交引导可以通过命令参数给出,例如:
/commit fix the login bug
资料中列出的 git 安全约定包括:
- 不改 config
- 不 force
- 不跳过 hooks
- hooks 失败时修复后新建提交,不 amend
- 永不提交
.env、凭据、私钥等密钥
/review¶
/review 审查当前未提交的变更,输出按严重度分级的 Markdown 审查报告。该命令只审查,不修改任何文件。
已核实资料列出的可选修饰词包括 security、performance、simplicity、style、i18n、with-context、guidance;其中 guidance 的示例未在已核实资料中展示,本文不展开其用法。
修饰词使用空格语法,例如:
/review security
这是因为 DSH 命令解析器 [a-z0-9_-] 不支持冒号,因此不使用 /review:security 这类写法。
预检与执行边界¶
当预检失败时,例如非 git 仓库、工作区干净、git 未安装,插件会直接返回卡片提示。工作区干净时,资料提示可用 /review HEAD~1 审查指定提交。
提交与审查动作由模型用自身工具执行,并走 DSH 沙箱与审批策略。命令注册随插件行生命周期自动装卸,使用 ctx.effect 包裹。
安装与启用¶
先执行安装命令,将插件加入 web profile:
dsh plugin --profile web add https://github.com/the-qian/dsh-commit-review.git
安装完成后需要重启 profile,因为 bundle 层在 boot 时装配:
dsh web
重启后在输入框输入 /,即可在命令面板看到 commit 和 review。
典型用法¶
不带参数时:
/commit
/review
带引导或修饰词时:
/commit fix the login bug
/review security
/review performance
/review simplicity
/review style
/review i18n
/review with-context
适用场景与注意¶
适合在 DSH Web GUI 中固化 git 提交和代码审查流程的开发者。使用前建议:
- 检查源码与许可证,确认符合项目要求。
- 在可信仓库中使用;插件会创建提交,并依赖 DSH 的沙箱与审批策略执行动作。
- 避免把密钥、凭据、私钥等敏感文件放入提交范围。
- 工作区干净时,可根据提示改用
/review HEAD~1审查指定提交。
由于插件以当前 DSH 进程权限运行,安装前应对来源和代码有基本确认。
相关链接¶
- GitHub:https://github.com/the-qian/dsh-commit-review
- 目录页:https://www.skillhub.cn/plugins/the-qian/dsh-commit-review