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 仓库。