dsh-plugin-github-search

动手前先搜一搜。 一个 DeepSeek Harness 插件： 让 agent 在写新插件/新能力之前先检查 GitHub 和 npm 上是否已有类似项目——避免把时间花在重新发明轮子上。

功能

• github_search —— 结构化 GitHub 仓库搜索（名称、星数、描述、语言），按星数排序，走 GitHub 搜索 API。 默认附加 topic:dsh-plugin 限定；传显式 topic（或空字符串）可覆盖。
• npm_search —— 结构化 npm 包搜索，补上"发布了 npm 但没打 GitHub 话题"的插件。支持 npm 限定词如 keywords:dsh-plugin。
• 系统提示词规则（guidePrompt，默认开）：agent 在写新插件/能力前必须先调用这两个工具、汇报已有项目， 然后才决定"新建 / 借用 / 跳过"。

试运行

# 可选：GitHub token 可提高匿名搜索限额
$env:GH_TOKEN = "ghp_..."          # Windows
export GH_TOKEN=ghp_...            # macOS/Linux

# 把 bundle 装进任意 profile（prepare 脚本会在安装时构建）
dsh plugin --profile web add github:Tianbaidi/dsh-plugin-github-search

然后问："我想做一个让纯文本模型读图的 dsh 插件——先搜搜 GitHub 上有没有类似项目。" agent 会搜索、总结已有项目，并给出"新建/借用/跳过"的建议。

Windows 注意：开发 overlay 里插件路径必须用 file:// URL（file:///D:/...%20...）。

配置

键	默认值	含义
ghTokenEnv	GH_TOKEN	存放可选 GitHub token 的环境变量名。
defaultTopic	dsh-plugin	未显式传 topic 时附加的话题限定；空字符串禁用。
limit	8	默认结果数。
guidePrompt	true	安装"先搜索再开工"系统提示词规则。

开发

pnpm install
pnpm typecheck
pnpm test           # 10 个 vitest 用例：URL 构建、响应解析、工具执行

License

MIT