前言¶
在 DSH（DeepSeek Harness）里接 OpenRouter 时，模型清单和用量榜会变：新 slug 上线、周榜名次挪动、免费变体单独成榜。若只靠浏览器偶尔打开 openrouter.ai，很难在本地工作流里留下可回看的记录；把榜单页当数据源手工 diff 又费时，且页面结构一改解析就失效。
下面介绍社区插件 dsh-plugin-modelwatch（维护者 gh-gongjin），在 DSH Web 侧边栏「插件」下增加一个面板，用全程只读 GET 拉官方清单与非官方榜单读口，汇总「新上模型 / 热门周榜 / 免费榜单 / 变化流水」，不推任何外部通知，也不替你做模型切换或调用。
这是什么¶
dsh-plugin-modelwatch 是 DSH 的 OpenRouter 模型监控插件，分类为「联网工具」。它在宿主 Web 界面注入入口，默认约每 60 分钟跑一轮检查（可改为 1 / 6 / 12 / 24 小时），每轮对上游发起三次 GET；点模型详情时再按需多一次。不带 OpenRouter key、不向 openrouter 发 POST、不推外部通知。
插件不是 OpenRouter 官方工具，与 openrouter.ai 无隶属关系；热门榜数字来自第三方页面/接口的用量估算，仅供观察，不做成本告警或自动切模型。
核心功能¶
新上模型¶
依据官方模型清单里的 created 时间戳，计算近 N 天内上架的模型（首轮建档即可看到数据，不依赖 diff）。表格列包括名称、slug、上架时间、上下文长度、输入价、输出价。
热门周榜¶
按 token 用量的周榜，取前 topN 条（默认 15，可设 5～20）。名次用金/银/铜徽标，用量列用相对榜首的量级条，便于看出第 1 名与第 15 名的差距。数据来源是 GET https://openrouter.ai/rankings 页面内嵌的 react-query 水合数据，属于非官方读法，对方改版可能导致解析失败；失败时卡片就地提示并保留上次成功快照。
免费榜单¶
针对 :free 变体模型的周榜，走独立数据源 GET https://openrouter.ai/api/frontend/v1/rankings/models?view=week，与热门周榜各挂各的故障闸门，一方失败不连坐另一方。默认同样展示 15 条（页面侧可排更多免费模型）；名次按 token 量自排，卡片来源注会说明与 SSR 页 20 行榜单的差异。
变化流水¶
追加式时间线，事件类型包括 new_model、removed_model、top_enter、top_exit、top_move、source_error（中文标签由宿主侧定义，界面查表展示）。周榜位次挪动 ≥3 才记 top_move，日间小幅变动视为噪声。事件默认保留 500 条（可在 50～2000 间配置），超出则裁旧。
模型详情¶
界面中六处模型名可点击，打开居中详情弹框：上架时间、上下文、价格，以及向官方清单 API GET /models/<slug>/endpoints 按需拉取的逐条端点（进程内缓存 10 分钟，不进定时链路、不落 KV）。弹框标题可跳转 OpenRouter 上该模型的详情页（地址由宿主按源返回的 id 拼出）。详情拉取失败不影响监测主链路，下次点击会重试。
设置与数据源容错¶
设置页可改监测频率、榜单条数、事件保留条数，并展示只读「运行环境」能力表。清单源、SSR 榜单源、免费榜源、详情源各自独立；任一轮从失败恢复时会记 source_error，连续失败不刷屏。KV 不可用时监控仍可跑，但会提示本轮变化无法落库。
安装与启用¶
DSH 生态里插件通过 profile 安装；Web 侧常用 web profile。官方 CLI 安装命令如下（内部走 pnpm，需保证 pnpm 在 PATH 中）：
dsh plugin --profile web add github:gh-gongjin/dsh-plugin-modelwatch
也可对本地克隆目录使用绝对路径：dsh plugin --profile web add <本仓库的绝对路径>。
手工安装时，编辑 ~/.dsh/profiles/web/package.json（Windows 为 %USERPROFILE%\.dsh\profiles\web\package.json），在 dependencies 增加 "dsh-plugin-modelwatch": "link:<绝对路径>"，并在 dsh.profile.bundles 末尾追加 "dsh-plugin-modelwatch"，再在 profile 的 node_modules 下建立目录联接；改 bundle 后需重启 dsh。
临时停用可在 ~/.dsh/profiles/web/cordis.patch.yml 写入：
- id: modelwatch
disabled: true
插件版本 0.1.0，许可证 MIT（见仓库 package.json）。
典型用法¶
安装并重启 DSH 后，从侧边栏进入 modelwatch 面板。页头右侧有数据源状态、检查时刻与模型总数；需要立刻刷新时点 立即检查（与定时共用同一代码路径，进行中会返回 busy 状态）。
| 页签 | 用途 |
|---|---|
| 总览 | 数据源状态、本周前三、新上与变化摘要（默认页） |
| 热门周榜 | 完整周榜表（名次、模型、周 token、量级、较上轮） |
| 免费榜单 | 免费变体周榜，表结构与热门周榜一致 |
| 新上模型 | 近 N 天新上架模型全表 |
| 变化记录 | 事件时间线 |
| 设置 | 监测间隔、topN、事件保留条数 |
相对时间均以本轮检查时刻为基准，而非浏览器当前时间。需要某模型端点与定价时，在任意榜单或新上表中点击模型名打开详情即可。
对外 HTTP 挂在宿主前缀 /modelwatch 下，例如浏览器或脚本可读 GET /modelwatch/api/snapshot、GET /modelwatch/api/stream（SSE）、POST /modelwatch/api/check 触发检查等；详情由 GET /modelwatch/api/model?slug= 代理，避免浏览器直连 openrouter。
适用场景与注意¶
适合：在 DSH Web 环境里开发或运维智能体、需要对照 OpenRouter 模型上新与周榜变化、又希望变更只留在本地面板与 KV、不引入外部通知链路的开发者。
注意：
- 插件以当前 dsh 进程权限运行并访问网络；安装前请阅读 GitHub 源码 与 LICENSE，确认符合你的安全策略。
- 热门榜与免费榜依赖非官方页面/前端接口，OpenRouter 改版可能导致解析失败；面板会保留上次数据并标注来源，勿把陈旧快照当实时权威。
- 不做自动切换模型、不做 API 调用、不做成本告警；若要通知请用 DSH 宿主或其它机制，本插件只负责只读观测与本地流水。
社区目录 SkillHub 插件页 与 GitHub 仓库相互独立，均非 DeepSeek / 幻方官方应用商店；DSH 本身也遵循「一切皆插件」的扩展思路。
结尾¶
dsh-plugin-modelwatch 把 OpenRouter 新模型、热门与免费周榜、以及可回看的变更流水收进 DSH 侧边栏，读路径清晰、通知零绑定。若要安装或看更新说明，可打开 目录页 与 GitHub 仓库。
