dsh-commit-review:为 DSH Web GUI 增加 /commit 与 /review

前言

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 审查报告。该命令只审查,不修改任何文件。

已核实资料列出的可选修饰词包括 securityperformancesimplicitystylei18nwith-contextguidance;其中 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

重启后在输入框输入 /,即可在命令面板看到 commitreview

典型用法

不带参数时:

/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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜