dsh-git-commit：Git 提交助手

前言¶

在 DeepSeek Harness (DSH) 的插件生態中，工作流類插件負責處理重複性的系統級任務。dsh-git-commit 是一個針對 Git 倉庫管理的工具，它解決的是開發者在維護提交歷史、生成變更日誌和確定版本號時需要投入的重複精力。

插件簡介¶

該插件由 uckkk 維護，核心功能是分析 git 倉庫，生成規範化提交信息、CHANGELOG 與版本號建議。其實現基於純 Node.js + git，無需網絡連接或外部服務。

核心功能¶

插件提供以下三個主要工具：

1. suggest_commit：分析 git status 變更，按 Conventional Commits 規則生成提交信息建議。
2. generate_changelog：讀取提交歷史（按類型分組），生成 CHANGELOG.md 文件。
3. suggest_version：依據 SemVer 規則，建議下一個版本號（major/minor/patch）。

安裝與啓用¶

在終端執行以下命令安裝插件：

dsh plugin add github:uckkk/dsh-git-commit

安裝後，需要在 profile 的 package.json 中配置 dsh.profile.bundles，加入 "dsh-git-commit"。

典型用法¶

在 DSH 會話中，可以直接調用上述工具。以下是常見的調用方式：

• 生成提交信息：調用 suggest_commit()。插件會根據文件類型自動判斷提交類型：新代碼對應 feat，改代碼對應 fix，測試對應 test，文檔對應 docs，配置對應 chore，樣式對應 style。
• 生成 CHANGELOG：調用 generate_changelog(since="v1.0.0", outFile="CHANGELOG.md")。
• 建議版本號：調用 suggest_version()。判斷邏輯爲：有 BREAKING CHANGE 或 !: 標記則爲 major，有 feat 則爲 minor，其餘情況爲 patch。

需要注意的是，生成的建議信息是啓發式默認值，模型可以在生成後進一步潤色，使其更貼合實際場景。

注意事項¶

安裝該插件即在本機運行第三方代碼。在使用前，建議自行審閱源碼與許可證（MIT）。

結語¶

dsh-git-commit 通過本地分析 git 倉庫，爲 Conventional Commits 規範化和版本管理提供了自動化支持。更多細節可參考插件目錄或源碼倉庫。