前言¶

在使用 DeepSeek Harness（DSH）开发智能体或配置工作流时，确保仓库符合标准规范（如包含文档、许可证等）是常规需求。dsh-repo-health 插件通过自动化检查，替代了人工逐一核对的过程，直接返回检查结果与修复建议。

插件简介¶

此插件用于检查仓库的常见最佳实践，包括 README、LICENSE、.gitignore、测试、CI、锁文件、脚本和 .env.example 等，并返回体检报告卡。该插件采用纯 Node.js 实现，无需联网或依赖外部服务。

核心功能¶

插件提供 health_check 工具，用于逐项检查并输出结果。主要检查项包括：
* README
* LICENSE
* .gitignore
* 测试
* CI 工作流
* 依赖锁文件
* npm scripts
* .env.example

工具返回每项的 ✓/✗ 状态、修复建议以及总分。

安装与启用¶

在命令行中执行以下命令安装：

dsh plugin add github:uckkk/dsh-repo-health

安装完成后，需在项目的 package.json 配置文件中启用该插件。在 dsh.profile.bundles 字段中加入：

"dsh-repo-health"

典型用法¶

在 DSH 会话中调用 health_check 工具，指定项目根目录路径。示例：

health_check(root="/workspace")

注意事项¶

• 代码执行权限：该插件以当前 DSH 进程的权限在本地运行代码，请务必在安装前自行审阅源码。
• 依赖要求：该插件需要 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 作为依赖。

后续¶

通过上述步骤，可以快速了解项目是否符合最佳实践规范。更多细节可参考插件目录或 GitHub 仓库。

目录与链接
- 插件目录：https://www.skillhub.cn/plugins/uckkk/dsh-repo-health
- GitHub 仓库：https://github.com/uckkk/dsh-repo-health