863683348/dsh-trend-radar

别人是目录，你是仪表盘。 每小时对 dsh-plugin topic 与 awesome-dsh-plugin 收录列表做一次快照（本地 JSONL 历史），然后从时间维度分析趋势：周报、新插件雷达、star 增速榜、类别热度、收录覆盖率。

为什么需要它

• 现有市场/目录都是"当前时刻"的静态视图；趋势是空白——没有人在看"这周新增了什么、谁在涨、哪个类别在热"。
• 快照只占本地磁盘（每条约几十 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	提示词段落顺序

数据流

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、无注入。
• Roadmap：Web UI 仪表盘（增长曲线、类别分布）——client 面板与 focusBoard 同款 experimental 模式，待运行实例验证。

测试

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.