开源复用助手 fzuleo/dsh-github-reuse

dsh-github-reuse

让 DSH 的智能体先查 GitHub，再动手写代码：检索成熟开源项目、体检候选、确认依赖与真实 API，然后优先装包集成，而不是从零实现。

全程只走 HTTP（GitHub REST API + raw 文件通道），不 clone 任何仓库，几乎不占磁盘。

它解决什么问题

默认情况下，AI 面对一个需求会直接开写。结果是你得到一份自己造、没人维护、还可能有坑的实现。
这个插件把流程改成：

1. 先检索：这个能力别人已经开源过了吗？
2. 再体检：star、许可证、最近更新、仓库体积、依赖规模能不能接受？
3. 确认 API：读真实的类型定义和示例，而不是凭记忆猜函数名。
4. 才动手：装包集成（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