dsh-prospector：DeepSeek Harness 的 GitHub 研究助手

在 DeepSeek Harness（DSH）中開發智能體時，通常需要先調研現有的開源實現，再決定如何構建。手動搜索倉庫、閱讀文檔、克隆代碼效率較低。dsh-prospector 提供了模型可直接調用的工具，讓智能體能夠自動搜索、閱讀和克隆候選倉庫，並綜合出實現方案。

插件定位¶

這是一個給 DeepSeek Harness 提供的 GitHub 研究助手插件。它給模型提供了面向 GitHub 的工具，包括搜索倉庫、讀取 README 和源碼文件、列出文件樹以及克隆候選代碼。插件的核心作用是輔助智能體從開源解決方案中提取實現計劃。

核心功能¶

插件提供了一系列 GitHub 工具，支持多種限定符和讀取限制：

搜索倉庫：支持 topic:、language:、stars:>N 等限定符。
讀取內容：限制最大讀取字節數，分別支持獲取 README、單個文件、列出文件路徑（僅 Blob）。
克隆倉庫：將倉庫淺克隆到工作區。
內置命令：提供 /research [low|medium|high] <idea> 和 /gh-login 命令。

插件還支持三種研究深度分級：
* low：搜索前 5 個，僅讀取 README，不克隆。
* medium：搜索前 10 個，讀取 README 和關鍵文件，克隆前 1-2 個最有可能的倉庫。
* high：搜索前 20 個並支持分頁和限定符，讀取核心源碼和完整樹，克隆多個倉庫。

安裝與啓用¶

安裝時需要在 DSH 的組合中掛載該插件，隨包附帶的 cordis.patch.yml 會自動處理配置。配置項如下：

- name: 'dsh-prospector'
  config:
    client: 'rest'               # 'rest' (默認) 或 'gh'
    ghPath: 'gh'                 # gh 可執行文件的絕對路徑（如未在 PATH 中）
    workspaceRoot: '~/dsh-prospector'  # 可選，默認爲 ~/dsh-prospector

典型用法¶

使用前需要完成 GitHub 認證。運行以下命令：

/gh-login：報告認證狀態並顯示登錄步驟。
/research medium <idea>：以中等深度研究想法並生成計劃。默認爲 medium 級別。

依賴與限制¶

插件依賴系統環境中的 gh（用於認證/令牌）和 git（用於克隆）。

速率限制：GitHub 搜索 API 有認證速率限制（約 30 請求/分鐘）。
權限：除克隆外，插件僅讀。它不會修改模型請求或會話表面。
操作限制：嘗試克隆到同一文件夾會失敗，需要先移除。
配置：目前沒有設置面板或分級選擇器 UI；配置通過 cordis.yml 完成。

生態背景¶

作爲 DeepSeek Harness 生態的一部分，DSH 遵循“一切皆插件”的理念。此插件由社區維護，與 DeepSeek 或幻方無官方從屬關係。更多信息請參閱插件目錄或 GitHub 倉庫。