dsh-find-ideas
针对开发想法进行现有技术检索：在 GitHub 上搜索类似项目，按相关性和星标数进行加权排名，然后阅读选定的代码仓库，并报告其代码的实际内容。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-find-ideas@0.3.0
Find Ideas 以 dsh-find-ideas 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Before you build it, check whether it already exists.
Describe your idea in one sentence. The agent searches GitHub for similar projects, ranks them by relevance weighted with stars, and returns a card. Pick a few repositories from it and the agent reads their README, dependency manifest, directory tree and key files, then writes up an architecture you can borrow from.
a ranked card and the repository inspection that follows it# from npm (recommended)
dsh plugin --profile web add dsh-find-ideas
# or from GitHub
dsh plugin --profile web add github:tianyao2003/dsh-find-ideas
# or from a local directory
dsh plugin --profile web add /path/to/dsh-find-ideas
The npm package is 391 KB to download, 805 KB unpacked, 28 files, and has no runtime dependencies. Installing from GitHub runs the build once at install time and needs pnpm to allow build scripts; the npm package ships the compiled output, so there is no such step.
GitHub limits unauthenticated search requests to 10 per minute per public IP, and everyone behind the same egress IP shares that quota. A token raises it to 30 per minute, counted per account.
The plugin reads GITHUB_TOKEN through DSH's credential store. Set it in the environment that launches DSH:
export GITHUB_TOKEN=ghp_... # bash
$env:GITHUB_TOKEN = 'ghp_...' # PowerShell, current session
Everything works without a token, but inspect_projects refuses an anonymous batch it estimates above 10 requests.
Restart dsh after installing, then describe your idea — the agent calls the three built-in tools on its own:
scout_projects → rank_candidates → inspect_projects are independent and share no state. The 0–10 relevance is the agent's judgement; the tools only search, compute, sort and read, and never judge semantic similarity. The ranking formula is relevance × (1 + log10(max(stars, 10) + 1)) / 2. A ranked card always has eight columns: rank, project, last updated, relevance, stars, score, language, description.
scout_projects turns the idea into several GitHub search queries and returns a star-sorted pool — deliberately not ranked by relevance. When the idea contains no Latin letters it is translated into English search terms first; when that is impossible (the caller gave no Latin keywords and no LLM is available) it returns plan_failed.rank_candidates scores the pool with relevance × (1 + log10(max(stars, 10) + 1)) / 2 and produces the card.inspect_projects reads up to 5 repositories — README, dependency manifest, tree summary and a few key files.relevance is the agent's 0–10 judgement; score is computed from it and the star count, so the order cannot be set from prose.0: a query term that was never tested on its own reads 未知（未测得）, a missing archive count reads 数据缺失.github.com or raw.githubusercontent.com.reason and a detail, and a partial result says why it is partial.$DSH_HOME/cache/dsh-find-ideas/, and deleting that directory is always safe.Search queries and repository paths go to api.github.com, and inspect_projects only reads repository content on GitHub — your local code is never uploaded. The one other destination is the model DSH already uses, and only to translate an idea with no Latin letters when the caller supplied no Latin keywords; a purely English idea is never sent anywhere for translation.
Requires Node ≥ 22. The @deepseek-ai/dsh-tools peer range accepts every published version from 0.1.0-rc.6 on, which covers the current DSH release lines — latest (0.2.0-rc.2) and next (0.2.1-rc.2). npm run check:peers re-checks that against the npm registry.
| Version | What changed |
|---|---|
| 0.3.0 (current) | Cache and package footprint. Descriptions are stored at 512 characters instead of unbounded, the in-memory cache is capped at 64 entries, the disk cache sweeps expired entries and stays under 64 MB, and the published package no longer ships src/, test/, scripts/ or source maps — 805 KB unpacked instead of 2.07 MB. Tool names, parameters and output are unchanged. |
| 0.2.1 | Published to npm. Same functionality as 0.2.0. |
| 0.2.0 | The card shows how many query channels found each row and how many rows are archived repositories. |
| 0.1.0 | First usable version: the scout_projects → rank_candidates → inspect_projects chain. |
npm install
npm run build # tsc -> lib/ ; run this first, the tests import lib/
npm test # node test/run-all.test.mjs
npm run typecheck # tsc --noEmit
npm run check:peers # check the peer range against the current DSH versions
test/ holds 30 *.test.mjs files. test/run-all.test.mjs runs the 29 that are not itself, and two of those (baseline, stage2) skip because the recorded test data under eval/runs/ was never ported — so a full local run is 27 files and 6463 assertions. Skips are listed under skipped (fixture absent, NOT verified) and never counted as passes.
Issues and pull requests are both welcome.
master, make the change with a test, run npm run check && npm test until green, then open a pull request. CI runs the same two commands on Node 22 and 24.feat: / fix: / docs: / chore:.MIT. See LICENSE.