插件雷达 yunyunyunyunsuan/dsh-plugin-radar

dsh-plugin-radar（插件雷达）

npm version
npm downloads
License: MIT

DeepSeek Harness（DSH）插件市场雷达：开箱即见 GitHub 上全部 topic:dsh-plugin 插件（7000+），定时增量扫描新插件，卡片流浏览 + README 关键词搜索 + 一键安装/更新/卸载，翻译与 AI 摘要走你自己 DSH 配置的模型额度，插件自身零 API 成本。

界面一览

左下角「🧩 插件雷达」胶囊（可拖动到任意位置，面板与胶囊绑定、相对位置锁死，面板四边可拖拽调大小）：

| 页签 | 内容 |
| 最近 3 天 | 信息流：仅近 3 天的仓库，可切「新建仓库 / 更新仓库」两种视角 |
| 全部 | 完整索引（7000+），支持星数范围筛选（★ 最低–最高）与排序（按时间 / ★ 高→低） |
| 已安装插件 · N | 已装插件管理：更新检测（npm 源，有新版显示「↑ 更新 x.x.x」）、一键删除 |
| 推荐插件 | 按主题精选（界面美化/换肤、IDE 化界面、视觉方案、桌面/启动器、记忆/知识库），只推确认可安装的真 dsh 插件 |

通用能力：
- 搜索：名称 + 简介 + README 全文关键词匹配（搜「视觉」可命中图像识别类插件），各页签通用
- 可安装筛选：一键开关，只看有 package.json、能真正装上的 JS 插件
- NEW 徽标：近 48h 且你还没点开看过的仓库（看过即消失，持久化）
- 胶囊角标：距你上次打开以来有新建/更新的仓库数，打开即清零（持久化，刷新不回弹）
- 居中详情弹窗（4:3 大屏占比）：完整元信息、topics、英文简介一键「译成中文」、AI 中文摘要（基于 README 全文）、README 节选填满下方
- 扫描间隔自定义：面板底部输入框，0.5~720 小时任意改，即时生效

安装

已发布 npm：

dsh plugin --profile web add dsh-plugin-radar

或在 profile 目录手动安装，然后启用：

cd ~/.dsh/profiles/web
pnpm add dsh-plugin-radar

~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: plugin-radar
name: 'dsh-plugin-radar'
config:
refreshIntervalHours: 12 # 可选：扫描间隔

刷新页面，左下角出现「🧩 插件雷达」即安装成功。

装上即见全量列表（包内附种子数据），无需等首次扫描；后台自动增量更新。

功能与机制

开箱即见（种子数据）包内 lib/seed.json 附发布时的全量仓库元数据 + hasPkg 探测结果（不含 README 全文，体积可控）。首次启动无本地缓存即加载种子，后台再增量补全。

扫描机制（增量，不随存量变慢）每次扫描 = ①「最近更新」头部刷新（前 1000，刷新已收录仓库的星数/简介/时间）+ ② 按创建日分片增量补新仓库：
- GitHub Search API 只回前 1000 条，按 created:YYYY-MM-DD 逐日分片可绕过限制做到全量
- 游标持久化（scanCursor.lastCreatedDay），每次只从上次停下的后一天续扫；撞限流停在当日下次接着来
- 日常增量请求数恒定（~10-15 次，5s 节流），与存量 4000 还是 40000 无关；首次冷启动补历史约 4-5 分钟，一次性

一键安装（含安全防护）
- npm 包优先（自动解析仓库真实包名），未发 npm 的走 git+https；pnpm add 后自动写入 cordis.patch.yml，刷新生效
- 非 JS 包（Python 等，无 package.json）拒绝安装——这类包装上会导致 DSH 启动失败
- git 源安装后自动校正 package.json 依赖名，保证与 cordis.patch.yml 一致

AI 能力走使用者额度翻译与摘要由主机端调用 ctx.llm（你 DSH 里配置的 provider/model，默认 deepseek-official/deepseek-v4-flash），按需触发、结果本地持久化缓存。插件本身不消耗任何 API 额度。

配置项

| 字段 | 默认 | 说明 |
| refreshIntervalHours | 12 | 扫描间隔（小时，面板底部可改，0.5~720） |
| pushWindowDays | 3 | 「最近 3 天」信息流窗口（天） |
| deepScanDays | 3 | 深收 README 的时间窗口（天） |
| maxRepos | 6000 | 收录仓库总数上限 |
| pagesPerSort | 30 | 每个排序维度的分页页数（每页 100，受 API 剩余额度保护） |
| pkgProbePerScan | 60 | 每次扫描补探测 hasPkg 的老条目数 |
| readmeMaxChars | 6000 | 每仓库缓存的 README 字符数（搜索/摘要语料） |
| provider | deepseek-official | 翻译/摘要使用的 provider（你 DSH 已配置的） |
| model | deepseek-v4-flash | 翻译/摘要使用的模型 |
| profile | web | 一键安装写入的目标 profile |
| pnpmBin | pnpm | pnpm 路径（自动探测 nvm/homebrew，失败时用它兜底） |
| githubToken | '' | GitHub Token；缺省自动尝试 GITHUB_TOKEN 环境变量与本机 git 凭据 |

原理

- 主机端：标准 cordis 插件，inject: ['webServer', 'llm']，注册 /plugin-radar/api/list|refresh|install|uninstall|update|installed|translate|summarize|config 等 HTTP 路由；运行时缓存落盘 ~/.dsh/plugin-radar-cache.json
- 浏览器端：挂载 shell.overlay 浮动层的 React 面板（纯 fetch 同源 API，无构建依赖）
- AI 调用：ctx.llm.stream() 一次性问答（BlockAssembler 收束文本）

安全声明

收录内容来自 GitHub 公开数据，未经安全检测，本插件不对第三方插件的安全性负责，安装前请自行甄别。

更新日志

- 0.4.13 — 修复「一键卸载没作用」：卸载时移除 cordis.patch.yml 里 name: 带/不带引号的 insert 行（此前只匹配带引号写法，导致如 name: dsh-plugin-moments 这类行删不掉、插件卸载后仍残留）；新增从 dsh.profile.bundles 摘除 bundle 型插件；installedSet 现识别 bundle 型插件，使其出现在「已安装」里可被卸载
- 0.4.12 — 种子数据更新至 7036 插件（开箱即见全量）；窗口式拖动（header / tab 行空白处按住即拖动整个界面）；修 Chrome 下按钮点击后残留 focus 白边；⟳/✕ 图标统一为等大 SVG
- 0.4.0 — 包内种子数据（4756 仓库 + hasPkg 全探测），开箱即见；推荐页只推可安装的真 dsh 插件；「可安装」筛选；非 JS 包拒绝安装；已安装插件更新检测 + 一键更新；git 源安装包名校正
- 0.3.0 — 全量收录（按创建日分片 + 游标增量续扫）；虚拟滚动（4700+ 卡片流畅）；胶囊可拖动、面板四边调大小；角标改为距上次打开以来的更新数（持久化）；星数范围筛选与排序
- 0.2.0 — 居中详情弹窗（4:3）；按需翻译 / AI 摘要（走使用者 DSH 模型额度）；三维度分页扫描；「更新于 X 前」时间明示；安全免责小字
- 0.1.0 — 首版：定时扫描 + 卡片流 + README 关键词搜索 + 一键安装

License

MIT