dsh-prospector
DeepSeek Harness 的 GitHub 研究助手：提供面向模型的工具，用于搜索代码仓库、阅读 README 和源代码以及克隆候选项目，使代理能够针对某个想法探索开源解决方案并汇总实施计划。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Perfirstvito/dsh-prospector#ac108dee911e09c66d9ba47e8a2bdbb05676a1e8Prospector 以 dsh-prospector 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
GitHub research ("prospecting") assistant for DeepSeek Harness — gives the agent model-facing tools to search repositories, read READMEs and source files, list file trees, and clone candidates, then synthesize an implementation plan from the best open-source solutions it finds.
| Tool | Does |
|---|---|
github_search_repos(query, limit?) | Search repositories; supports topic:/language:/stars:>N qualifiers. |
github_get_readme(owner, repo) | Fetch a README, bounded by maxReadmeBytes. |
github_read_file(owner, repo, path) | Fetch one file, bounded by maxFileBytes. |
github_list_tree(owner, repo) | List file paths (blobs only), bounded by maxTreePaths. |
github_clone_repo(owner, repo, into?) | Shallow-clone into the workspace (into = topic subfolder) and return the local path. |
The agent combines these (search → read README/source → clone → read deeply); the plugin only supplies the eyes.
/research [low|medium|high] <idea>Research an idea end to end and propose a plan. The optional leading tier (default medium) sets search breadth and read depth. Each idea gets its own subfolder under the workspace.
/gh-loginReport the GitHub authentication state and show login steps when unauthenticated.
| Tier | Search | Read depth | Clone |
|---|---|---|---|
low | top 5 | README only | no |
medium | top 10 | README + key files + tree of top 1-2 | 1-2 most promising |
high | top 20, qualifiers + pagination | core source across several files + full trees | several |
Mount it in the composition; the shipped cordis.patch.yml inserts it automatically when installed as a bundle:
- name: 'dsh-prospector'
config:
client: 'rest' # 'rest' (default) or 'gh'
ghPath: 'gh' # absolute path if gh is not on PATH
workspaceRoot: '~/dsh-prospector' # optional; default is ~/dsh-prospector
Mount it beside a subprocess provider and the filesystem tools.
The plugin never stores a token. Read operations resolve a token from GH_TOKEN/GITHUB_TOKEN, else gh auth token. Run gh auth login once (device flow → github.com/login/device), or set GH_TOKEN.
Clones live under a dedicated workspace root (~/dsh-prospector by default), one subfolder per research topic:
~/dsh-prospector/
<topic-slug>/ # one folder per /research idea
<owner>__<repo>/ # shallow clones
The workspace root and each topic folder are created automatically on first use.
| Field | Default | Meaning |
|---|---|---|
client | rest | Read backend: rest (in-process HTTP) or gh (GitHub CLI). Clone always uses git. |
ghPath | gh | Path to the gh executable. |
workspaceRoot | ~/dsh-prospector | Root where per-topic folders and clones live. |
maxReadmeBytes | 200000 | Byte budget per README. |
maxFileBytes | 100000 | Byte budget per file. |
maxTreePaths | 2000 | Max file paths per tree listing. |
searchLimit | 10 | Default search result count. |
maxAttempts | 3 | Max REST attempts (retries on rate-limit/server/network errors). |
fallbackToGh | true | Fall back to gh when REST hits an infrastructure error. |
gh and git are required — gh for auth/token, git for cloning.cordis.yml; the interactive tier selector and settings card depend on DSH's client-bundle tooling for external plugins.MIT