前言¶
在 DeepSeek Harness (DSH) 的插件生态中，工作流类插件负责处理重复性的系统级任务。dsh-git-commit 是一个针对 Git 仓库管理的工具，它解决的是开发者在维护提交历史、生成变更日志和确定版本号时需要投入的重复精力。
插件简介¶
该插件由 uckkk 维护，核心功能是分析 git 仓库，生成规范化提交信息、CHANGELOG 与版本号建议。其实现基于纯 Node.js + git，无需网络连接或外部服务。
核心功能¶
插件提供以下三个主要工具：
suggest_commit：分析git status变更，按 Conventional Commits 规则生成提交信息建议。generate_changelog：读取提交历史（按类型分组），生成 CHANGELOG.md 文件。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 规范化和版本管理提供了自动化支持。更多细节可参考插件目录或源码仓库。
