dsh-github-reuse
让 DSH 的 agent 先查 GitHub，再动手写代码：检索成熟开源项目、体检候选、确认依赖与真实 API，然后优先装包集成，而不是从零实现。
全程只走 HTTP（GitHub REST API + raw 文件通道），不 clone 任何仓库，几乎不占磁盘。
它解决什么问题
默认情况下，AI 面对一个需求会直接开写。结果是你得到一份自己造、没人维护、还可能有坑的实现。
这个插件把流程改成：
- 先检索：这个能力别人已经开源过了吗？
- 再体检：star、许可证、最近更新、仓库体积、依赖规模能不能接受？
- 确认 API：读真实的类型定义和示例，而不是凭记忆猜函数名。
- 才动手：装包集成（
npm i / pnpm add / pip install），而不是复制整个仓库。
提供的工具
| 工具 | 作用 |
|---|
github_search | 检索仓库，支持 star 下限、语言、许可证、最近推送天数、topic 过滤与排序 |
github_inspect | 仓库体检：star/fork/issue、语言、最近推送、体积、归档状态、许可证、最新 release、依赖概况、README 摘要、复用建议 |
github_tree_and_manifest | 在线读取根目录依赖清单（package.json / pyproject.toml / requirements.txt / Cargo.toml / go.mod / composer.json / pubspec.yaml / Gemfile），给出依赖数、明细与装包命令 |
github_read | 读取仓库内任意文本文件（raw 通道，不消耗 API 配额），确认导出 API / 示例 / 许可证 |
另外注入：
- 一段系统提示词：硬性门槛（动手前必须给出 ≥2 个开源候选或说明检索无果）+ 选型规则；
- 一个技能
oss-reuse：完整工作流（需求拆解 → 分区检索 → 体检对比 → 确认 API → 试集成 → 记录决策）。
安装
DSH 插件以 profile 组合包的形式加载。克隆或下载本仓库后：
# 1) 把插件目录放到 profile 里
$p = "$env:USERPROFILE\.dsh\profiles\desktop"
Copy-Item . "$p\.dsh-github-reuse" -Recurse
# 2) 建立 node_modules 链接
cmd /c mklink /J "$p\node_modules\dsh-github-reuse" "$p\.dsh-github-reuse"
# 3) 在 $p\package.json 里登记
# dependencies 加 "dsh-github-reuse": "link:.dsh-github-reuse"
# dsh.profile.bundles 末尾加 "dsh-github-reuse"
# 4) 重启 DSH
也可以放进任意 profile，把上面命令里的 desktop 换成目标 profile 名。
配置（可选）
在 profile 的 cordis.patch.yml 里加 config：
- id: github-reuse
config:
token: 'ghp_xxxxxxxx' # 也可用环境变量 GITHUB_TOKEN / GH_TOKEN / GITHUB_API_TOKEN
timeoutMs: 30000 # 单次 HTTP 超时（毫秒）
retries: 3 # 网络失败重试次数
concurrency: 4 # 清单文件并发探测数
maxOutputChars: 16000 # 单个工具输出上限（字符）
配额与降级
- 匿名调用：核心 API 60 次/小时、搜索 10 次/分钟；配置 token 后 5000 次/小时。
github_read、github_tree_and_manifest 走 raw 通道，不受 API 配额限制。- API 不可用时，
github_inspect 会自动降级为 raw 通道体检（缺少 star / 提交时间等信息，会在结果里注明）。
- 网络抖动会自动重试（默认 3 次，退避 400ms × 次数），并限制并发，规避连接超时。
已知限制
- 只读公开仓库；私有仓库需要 token 且该 token 有对应权限。
- 不做代码搜索（GitHub Code Search API 需要认证），需要定位具体实现时用
github_read 直接读文件。
- 输出已做长度截断，超长文件请用
startLine / maxLines 分段读取。
许可证
MIT
