前言¶
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
