dsh-discovery

🌐 中文 | English

DSH 社区插件搜索器（DSH plugin discovery browser）——浏览与检索 DeepSeek Harness 社区插件的只读工具。

核心定位：LLM 审计安装（LLM-audited install）。 DHS 目前没有官方插件市场，任何第三方插件本质上都是「可执行代码」。因此本工具刻意做成只读：它只负责发现、筛选、检索插件；安全审查交由 LLM（DHS 的 agent）完成——利用 LLM 的代码理解与安全分析能力，读源码、查依赖、识别恶意模式，审查通过才执行安装。

---

为什么是「LLM 审计安装」模型

插件是直接注入 DHS host 运行的代码，一旦安装就拥有与你相同的本机权限（读文件、跑命令、访问网络）。没有官方市场做代码审计与签名背书时，第三方插件的信任只能靠「装之前查一遍」。人工逐个仓库读源码成本极高，而 LLM 恰好具备源码级安全分析能力——因此审查环节交由 LLM 完成，这是本工具的核心设计。

dsh-discovery 自身保持严格的只读边界：不安装、不更新、不卸载、不加载任何远程代码——所有与仓库的交互只有拉 listing、拉 README 文本、打开外部链接。审查与安装动作全部由 LLM 在会话内完成，用户始终能看到 LLM 的审查过程与结论。

审计流程

发现 → 筛选 → 一键交审 → LLM 审查 → 通过 / 拒绝
 │      │         │          │          ├─ 通过：LLM 执行 dsh plugin add 安装
 │      │         │          └──────────└─ 有风险：LLM 列出风险点并停止安装
 │      │         └────────────────── 生成审查 prompt，发进当前会话
 │      └────────────────────── 分类 / 搜索 / 场景筛选
 └────────────────────────────── 浏览 GitHub `dsh-plugin` 社区话题

1. 浏览/搜索：按分类、关键词、场景浏览社区插件（只读，不加载任何远程代码）
2. 一键交审：点「审查安装」→ 自动生成审查 prompt 发送到当前会话，交给 LLM
3. LLM 审查（审查 prompt 强制要求）：
   • 无恶意行为：异常网络请求、文件读写、环境变量/密钥窃取、命令执行
   • 与描述相符：无隐藏后门
   • 许可证与依赖安全
4. 执行或拒绝：审查通过 → LLM 用 dsh plugin add 安装该插件；发现风险 → LLM 列出风险点并停止安装
5. 场景批量同理：「场景一键安装」时，LLM 先逐个审查候选仓库安全性，再去重筛选、安装

本质上是用 LLM 的能力做安全检查——把「读仓库、判风险、执行安装」这一整条链路由人肉完成，升级为 LLM 驱动；用户只需在会话里看到审查结论，确认或打断即可。

---

功能

• 社区插件浏览：拉取 GitHub dsh-plugin 话题下全部仓库（DeepSeek 官方文档记载的社区渠道）
• 分类浏览：7 类功能分类 + 其他（基于名称/话题/描述正则归属）
• 场景配置：5 个使用场景 + 场景化筛选（见下文「场景化设计」）
• 中英同义词搜索：38 词映射表，中文关键词也能命中英文插件数据
• 官方/第三方标记：deepseek-ai 官方蓝底 vs 社区描边
• 已安装标识：读 profile manifest bundles，区分内置与用户安装
• LLM 审查安装：一键生成审查 prompt 交 LLM（读源码/查依赖/识别恶意模式），通过则装、有风险则停；内置 Markdown 渲染器预览 README + GitHub 外链
• 检查更新：已安装插件生成更新检查 prompt 交 LLM——对比版本、审查 changelog，更新前同样执行安全审查（对比新旧依赖/代码/权限变更，警惕供应链投毒，通过才 dsh plugin update，有风险则停止）
• listing 缓存：服务端 5 分钟 TTL（?force=1 强制刷新）+ 客户端 sessionStorage 10 分钟
• i18n：zh / en 双语界面

---

拉取规则

数据源是 GitHub 官方 API 的 dsh-plugin 话题搜索（社区插件的唯一权威入口），规则如下：

规则	取值
数据源	GET /search/repositories?q=topic:dsh-plugin
排序	按 star 数降序（sort=stars&order=desc）
拉取范围	每页 30 条，最多 10 页（约 300 个仓库）
单请求超时	10 秒（AbortSignal.timeout）
失败降级	单页拉取失败立即停止翻页，返回已拉到的部分（transient 错误不拖垮整个 listing）
服务端缓存	5 分钟 TTL；?force=1 可强制刷新
字段映射	name / owner / description / stars / language / updatedAt / htmlUrl / topics
README 拉取	GET /repos/{owner}/{repo}/readme（raw），5 分钟 TTL，404 缓存错误

设计意图：拉取只读 + 有界——不爬取仓库内文件、不执行任何仓库代码、分页有上限、超时与降级保证体验。

分类规则

基于 name + topics + description（前 400 字符）正则匹配，7 类 + 其他：

分类	匹配关键词示例
UI 增强	sidebar / ui / theme / skin / panel / overlay / web-ui
终端	terminal / tui / shell / cli / console / bash
工具与能力	tool / skill / command / automation / workflow
记忆	memory / recall / remember / store / kv / vector
模型与接入	model / provider / llm / api / gateway / inference
通知与集成	notify / webhook / slack / wechat / feishu / telegram / dingtalk
开发与运行时	dev / runtime / debug / inspect / code / git / docker / sandbox
其他	未命中上述任何规则

搜索规则

插件数据是英文的（name/description/topics），中文用户搜中文词会漏掉英文内容。因此内置 38 词中英同义词表：输入中文关键词（如「记忆」「通知」「模型」）时自动映射到一组英文关键词匹配，支持：分类名直配、同义词展开、名称/所有者/描述/话题全文匹配，结果按 star 降序。

官方标记规则

只有 deepseek-ai（DeepSeek 官方 GitHub 组织）标记为官方。注意：裸账号 deepseek 是休眠占位账户（public_repos = 0），刻意不标记为官方——避免把冒牌/占位账号误判为官方渠道。

---

场景化设计

社区插件是长尾分布：搜一个关键词可能命中几十个相似插件，功能重叠严重。场景化解决「装什么」的选择困难——把 5 个常见使用意图映射到插件功能簇，自动去重、限量推荐：

场景与功能簇

场景	功能关键词簇
✍️ 写作	write / note / memory / template / blog / doc / content / skill / memo / recall
💻 开发	terminal / git / docker / code / debug / runtime / sandbox / browser / cli / tui / shell
🧠 模型接入	model / provider / llm / api / gateway / inference / openai / anthropic / gemini / claude
⚙️ 自动化	tool / workflow / schedule / task / agent / pipeline / command / todo / job
🔔 通知集成	notify / webhook / slack / wechat / feishu / telegram / dingtalk / email / push / im

筛选规则

对每个场景：

1. 匹配：插件 name/description/topics 命中场景正则 → 进入候选
2. 分组：插件归入第一个命中的功能关键词簇（未命中任何关键词的归入 other）
3. 每簇限量：高星前 3 个（MAX_PER_FUNCTION）∪ 最近更新前 1 个新项目（NEW_PROJECTS_PER_FUNCTION，与高星去重）
4. 汇总排序：全部选中插件按 star 降序（并列按更新时间）

设计意图

• 去重：同一功能簇的高星插件只留 3 个，避免一屏全是同质化插件
• 不忽略新项目：每个功能簇额外留 1 个「最近更新」名额——纯 star 阈值会永远淹没刚起步但活跃的新插件
• 场景精简：每个场景最终 10~20 个精选，「一键安装」时交 LLM 逐个审查安全后再去重筛选安装（详见上文审计流程）

---

安装

# 从 GitHub 安装（首次需要允许构建，dsh 会给出提示，把包 key 加入 profile 的 pnpm-workspace.yaml allowBuilds）
dsh plugin add github:EricXu20266/dsh-discovery

# 或从 npm 安装（预构建产物，无需授权）
dsh plugin add dsh-discovery

使用

安装后重启 dsh 会话，侧边栏出现「插件市场」入口，点击打开全屏搜索浏览器。

开发

pnpm install
pnpm build          # tsc 编译 host 侧 → lib/
pnpm bundle:client  # tsdown 打包 client 侧 → client/client.js

许可

MIT