dsh-trend-radar

dsh-trend-radar — 生态行情面板 (Ecosystem trend dashboard)

别人是目录，你是仪表盘。 每小时对 dsh-plugin topic 与 awesome-dsh-plugin 收录列表做一次快照（本地 JSONL 历史），然后从时间维度分析趋势：周报、新插件雷达、star 增速榜、类别热度、收录覆盖率 —— 并带一个 experimental 的 Web 面板（增长曲线、类别热度、Top 榜单）直接叠在会话输入框上方。

为什么需要它

• 现有市场/目录都是"当前时刻"的静态视图；趋势是空白——没有人在看"这周新增了什么、谁在涨、哪个类别在热"。
• 快照只占本地磁盘（每条约几十 KB JSONL），分析全部本地完成。

工具

工具	作用
trend_snapshot	立即采集一次快照（GitHub topic:dsh-plugin 搜索 + awesome 收录树），追加到本地历史；窗口期内自动跳过（force: true 强制）
trend_report	分析历史 → 周报：新增插件、star 增速榜、类别热度、awesome 覆盖率；支持 days 窗口与 keywords 过滤
trend_watch	关键词订阅雷达：add/remove/list/check——新品命中或 star 突增（≥surgeStars）即报

安装

dsh plugin --profile <profile> add dsh-trend-radar

配置

键	默认	说明
dataDir	.dsh/trends	快照与订阅的存储目录（相对宿主 fs cwd）
staleHours	1	快照新鲜度窗口（小时）
surgeStars	20	雷达的 star 突增阈值
githubTokenEnv	``	可选：GitHub token 的环境变量名（匿名 API 限流 60 次/小时，够用；设 token 更稳）
sectionOrder	5	提示词段落顺序

Web 面板（experimental）

装在有 Web UI 的 profile 上时，插件把最近一次 trend_report / trend_snapshot 的仪表盘数据（增长曲线、类别热度、新增插件榜、star 增速榜）通过 session projection 推给浏览器，渲染成输入框上方的只读面板。让 Agent 跑一次 trend_snapshot 或 trend_report 面板即刷新；每次新 turn 自动清空，避免展示过期数据。

数据流

GitHub search (topic:dsh-plugin, top 100)
  + awesome-dsh-plugin git tree (data/plugins/*.yml)
        ↓ collectSnapshot()
.data dsh/trends/snapshots-YYYY-MM-DD.jsonl   (append-only)
        ↓ computeReport() / deltaBetween()
trend_report (周报) · trend_watch (雷达) · trend_snapshot (增量)

设计

• 纯逻辑分离：lib/trends.js（增量/周报/雷达过滤/渲染）、lib/storage.js（JSONL + watch.json）、lib/github.js（采集 + 解析分离）——全部零 DSH/Cordis 依赖，可单测。
• 安全：只读公开 API，写本地数据目录；无 secrets、无注入。
• Web 面板：lib/client.js 走 dsh-plugin-focus 同款 experimental client 模式（dsh.client manifest + session projection），待运行实例验证。

测试

node test/trends.test.mjs

License

MIT

FAQ

• How often should I snapshot? The trend_snapshot tool auto-skips inside the staleHours window (default 1h). There is no background timer; collection happens when a tool runs and the history is stale.
• Rate limits? Anonymous GitHub search is 10 req/min / 60 req/h — plenty for hourly snapshots. Set githubTokenEnv (e.g. GH_T) to a token for 5000 req/h.
• Where is the data? dataDir (default .dsh/trends): append-only snapshots-YYYY-MM-DD.jsonl plus watch.json. Delete files to reset history.
• The Web UI dashboard? On the roadmap — same experimental client-panel path as dsh-plugin-focus.