Vai al contenuto principale
Z

dsh-radar

zz12hui/dsh-radar

Ranking navigator for DSH plugins and agent skills: ships the 6,245-entry catalog (plus 896 skill repos) inside the bundle, scans it locally on every open against configurable keyword groups and star/download/recency thresholds, and generates an install prompt you paste into a session instead of installing anything itself. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installazione

dsh plugin --profile web add github:zz12hui/dsh-radar

README

生态雷达 —— DSH 插件与 Agent Skills 的排行导航站

DSH version 6,245 plugins 896 skills MIT


1. 它是什么

侧栏多一个「生态雷达」,点开就是插件与技能排行榜。

社区目录里现在有 6,245 个 DSH 插件,GitHub 上还有 896 个 agent skills 仓库。光靠搜索翻不出重点——你不知道哪个三个月没提交过,也不知道哪些是同一个作者批量发的。这个插件把这些数据打包带进 DSH,在本地扫一遍,按你调的阈值筛出值得看的。

跟静态排名站的区别是最后一步:勾选任意条目,生成一段安装提示词,粘到会话里让 agent 直接装。

打开 → 调阈值 → 复制提示词

自动发现

排行榜

2. 为什么是「复制提示词」而不是「一键安装」

插件是在你机器上跑任意代码的东西。做成一个「立即安装」按钮,等于把装载权限交给一个刚打开两分钟的页面。

现在的做法是:页面只负责生成这段文本,装载动作由你自己粘进会话触发。中间那一步你还能改——去掉不想装的、补一句「先看 README 再装」。多花五秒,换来一次确认。

生成的提示词长这样:

帮我把下面这些 DSH 扩展装上,装完逐个确认是否真的生效。

## 插件
- dsh-context · https://github.com/xxx/dsh-context
  上下文透视面板,看这次会话被什么吃满了
- cc-safety-net · https://github.com/xxx/cc-safety-net
  执行前守卫:破坏性 git 和文件命令会被拦下,读 SSH 密钥或 .env 的调用也拦。

插件用 `dsh plugin --profile <当前 profile> add <包名>` 安装,或走 plugin_manager。
装完到 插件 页确认对应行已启用,把失败的包名和报错贴出来。

技能段会换成克隆命令和目标目录,并说明「克隆完不用安装,重启会话后确认能被识别」。

3. 自动发现怎么工作

页面里内联了全部记录,扫描在浏览器本地跑。打开插件、改任一个设置,都会重新扫一遍全量 7,141 条,实测 27ms(Node 24,一次性冷扫)。

维度内容
词条字典19 组 204 个词,覆盖记忆 / 上下文 / 搜索 / 浏览器 / 视觉 / 语音 / 界面 / 主题 / 用量 / 模型 / Git / 安全 / 工作流 / 远程 / 通知 / 文档 / 数据 / 娱乐 / 开发
阈值星标、npm 月下载、最近更新天数、综合分,四条滑块
开关一起扫技能仓库 / 包含已归档 / 优先最近更新
命中规则名字、作者、中英简介、分类任一命中即触发;命中词越多排越前,同分看提交时间再看星标

三档预设的实测差异:

预设星标月下载更新综合分命中
宽松00365 天30全部
标准00180 天40922 条
严格3,00020,00060 天60118 条

阈值和词条状态存在浏览器 localStorage,刷新不丢。

4. 快速开始

dsh plugin --profile desktop add github:zz12hui/dsh-radar

装完重启 DSH(托盘退出再开,刷新页面不算),侧栏会出现「生态雷达」。

不想留入口了?插件配置里把 sidebarEntry 关掉,入口不再注册,/api/dsh-radar/* 还能访问。

5. 拿到条目之后怎么用

勾选几条,底部浮层会亮起来,给三个出口:

动作结果
放进会话退回会话界面,把这批条目写成安装指令塞进输入框,只写不发送,你可以改完再自己按回车
看提示词弹窗预览完整文本,确认无误再复制
复制直接复制到剪贴板

「放进会话」不会覆盖你正在打的内容。输入框里已经有草稿时,新内容追加在后面。

面板里还有这些。

头部左上角是「返回会话」。Esc 也能回去,但分两级:提示词弹窗开着就先关弹窗,再按一次才退出面板。

键盘按 Vim 的习惯来。/ 跳到搜索框,j 和 k 上下挪光标,空格给光标那行打勾,Enter 直接把它放进输入框。光标停在哪行,哪行左侧就有一道蓝条,挪出视野时会自动滚回来。

排行榜顶部有个「只看本机已装」勾选框,12 个在跑的插件一眼就能挑出来。默认不勾。

关闭面板前停在哪个 tab、滚到哪个位置,下次打开原样还给你。状态存在 sessionStorage 的 dsh-radar-ui 里。

6. 接口

全部只接受同源请求(校验 sec-fetch-site 与 Origin),只读为主。

方法路径说明
GET/api/dsh-radar/data完整快照,约 2.2 MB
GET/api/dsh-radar/config{ sidebarEntry }
POST/api/dsh-radar/config写入 sidebarEntry,走 config editor
GET/api/dsh-radar/health快照日期、条目数

data 与 health 在 Host 侧缓存 5 分钟,重复打开页面不会反复读盘。

7. 数据口径

快照打包在 data/radar.json(2.2 MB),字段是定长数组不是对象,省掉一半体积:

插件 [id, repo, cat, zh, en, stars, dl, pushed, score, lic]
技能 [id, owner, name, desc, stars, pushed, score, lic]

综合分口径:

插件 0.50 × 星标 + 0.34 × npm 月下载 + 0.16 × 更新新鲜度
技能 0.62 × 星标 + 0.38 × 新鲜度(150 天窗口)

星标和下载各自取 log10 再归一化。不这么做,前十名全是几万星的仓库。技能单独按技能池自己的最大值归一——用插件池的最大星标会算出 100 分以上的溢出值。

8. 重新生成数据

拿到新快照要重跑整条链路。脚本在 scripts/,按顺序执行:

python scripts/collect.py        # GitHub 搜索,无 token 也能跑,10 次/分
python scripts/fetch-stars.py    # 补星标,约 4.5 次/秒
python scripts/fetch-npm.py      # 补 npm 月下载
python scripts/build-ranking.py  # 合并打分,输出 payload.json
python scripts/build-data.py     # 生成 data/radar.json

collect.py 会跳过已抓过的查询,中途断了能续。整条链路约十几分钟,主要时间在补星标。

build-data.py 读的 payload.json 来自上一步。中间数据加起来约 59 MB,没进仓库。想重建,得先把前四步跑完。

9. 已知限制

快照停在打包那天(当前是 2026-11-19),插件自己不会去 GitHub 拉新数据。想换一批数字,就重跑第 8 节那五条脚本,再装一次。

星标挂在仓库上,不是包上。@linxin666/dsh-* 那十几个插件共享同一个 1.1 万,排名挨得很近是这个原因,不代表每个都有这个热度。

下载量对纯 GitHub 分发的插件恒为 0,所以综合分里它权重压到 0.34,星标仍是主项。

关于安全:这个站只做排序,不做审查。插件是能往你机器上跑任意代码的东西,cc-safety-net 这类守卫也是插件本身。点开仓库看两眼再装,比看分数靠谱。

10. 验证

两个脚本都不需要浏览器。

tools/verify.mjs 用 Node 把纯函数从 client.js 里拉出来,喂真实快照跑。共 21 项断言。

node tools/verify.mjs

它管的是算得对不对:标准档命中 922 条、全量扫描 7,141 条、词条 204 个、严格档收到 118 条、关掉全部词条归零、单开一个词组命中 89 条、排序单调、提示词分段正确。

写入输入框那五种情况也在里面:没有会话时返回失败、空草稿直接写、已有草稿时追加而不覆盖、追加前裁掉尾部空白、写入抛错时不崩。

tools/load-check.mjs 管的是挂得上挂不上。它拿一个最小 React 替身加载 client.js,跑 apply(),然后数 slot 注册。

node tools/load-check.mjs

要看到三条全在:sidebar.panellist、main、conversation.composer.dock。少一条,面板还开得出来,但对应功能是哑的。

11. License

MIT

Plugin correlati