前言¶

在 DeepSeek Harness (DSH) 環境中，智能體通常難以直接調用項目特定的構建或測試指令。傳統的做法是依賴智能體猜測命令，或者通過對話逐步詢問。這種方式效率低下且容易出錯。command-scout 插件解決了這一問題，它能夠讀取項目本身聲明的構建命令，並將其直接轉化爲智能體可調用的工具。

插件介紹¶

該插件由 JohnXu22786 維護，核心功能是在插件激活時掃描工作區根目錄。它支持 Makefile、package.json 腳本、justfile 和 deno 任務，提取其中的命令定義，並暴露爲 DSH 工具。這讓智能體無需猜測，直接執行項目定義的構建流程。

核心功能¶

• 啓動掃描：在插件激活時對工作區根目錄進行一次掃描。
• 多系統支持：支持 Makefile、package.json 腳本（自動檢測包管理器）、justfile 和 deno 任務。
• 元數據支持：提供命令的描述、先決條件列表和變量信息。
• 安全命名：工具名稱採用確定性算法生成（如 make_build），避免命名衝突，並提供數字後綴處理衝突。
• 零運行時依賴：插件本身獨立運行，不依賴外部庫。

安裝與配置¶

安裝前請確保已安裝 DeepSeek Harness，並配置了 pnpm。環境需滿足 Node.js >= 18.17。

使用官方安裝命令添加插件：

dsh plugin --profile demo add github:JohnXu22786/command-scout

插件支持通過配置文件調整掃描行爲。配置項包括掃描根目錄、啓用的收集器（如 Makefile、scripts）、命名風格（scoped 或 flat）以及執行超時時間。

典型用法¶

安裝並激活插件後，項目中的構建命令會自動註冊爲工具。例如，如果項目包含 Makefile 的 build 目標，智能體即可調用 make_build 工具。

也可以在未運行 Harness 的環境下，作爲獨立 CLI 工具使用：

command-scout scan --root path/to/project

注意事項與適用場景¶

適用場景：需要智能體自動執行項目特定構建流程的開發者。

注意事項：
1. 掃描機制：每次激活插件時只掃描一次。如果修改了 Makefile 或 package.json，必須重新加載插件或開啓新會話才能更新工具列表。
2. 執行限制：命令執行有硬超時限制（默認 120000ms）。
3. 權限安全：命令以 Harness 用戶的權限運行，且 args 參數會被原樣追加到命令行。插件需結合 Harness 的安全策略（如 tools/pre-execute）使用。

短結尾¶

command-scout 插件通過自動化提取項目構建指令，降低了智能體與具體工程環境的交互門檻。更多技術細節可參考社區目錄或 GitHub 倉庫。