前言¶

在使用 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