前言¶
在 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 倉庫。
