前言¶

DeepSeek Harness（DSH）的核心理念是“一切皆插件”。隨着生態擴展，開發者需要在一個龐大的倉庫集合中尋找適合的工具。dsh-weekly-hot 是爲此設計的 DSH Web UI 插件，它不依賴後端服務器，直接在瀏覽器端連接 GitHub API，生成「飆升榜」與「精選主題榜」。由 XCNXNXNX 維護，遵循 BSD-3-Clause 許可證。

功能¶

入口與彈窗¶

插件在 DSH Web UI 右緣提供一個懸浮按鈕（默認顯示“🔥 本週熱門插件”），點擊即可打開面板。該入口可在面板設置或主設置中關閉。

面板支持定時彈窗功能。用戶可選擇關閉、每天、每週、每兩週或自定義分鐘數作爲彈出間隔。手動打開面板會重置計時。

榜單邏輯¶

插件提供兩種榜單生成方式：

1. 飆升榜：利用 GitHub Search API 的 topic:dsh-plugin 全量檢索倉庫。增長數通過 localStorage 記錄的基線差值計算（首次訪問無基線時會按近期活躍度估算並標註“估算”）。算法對新倉庫和近 30 天推送活躍度進行加權。
2. 精選主題榜：解析 awesome-dsh-plugin、Oh-My-DSH 等社區精選列表，並依據主題標籤（如 #UI、#工具、#工作流）進行分桶展示。

卡片與安裝¶

榜單以卡片形式展示插件信息，包括名稱、GitHub 鏈接、README 首句描述、Topics 標籤、Star 數及增長數。

卡片提供“一鍵安裝”功能。點擊後，瀏覽器向宿主側的 /api/dsh-weekly-hot/install 發起 POST 請求，宿主側接收後執行 dsh plugin --profile web add github:<owner>/<repo>。安裝失敗時會展示錯誤詳情。

穩定性與緩存¶

針對 GitHub API 限流，插件內置了完善的降級處理。當觸發限流時，不再顯示英文錯誤，而是倒計時並在配額恢復時自動重試，若存在緩存則直接展示。

緩存策略分層：
* 搜索結果緩存 1 小時
* 精選列表緩存 6 小時
* README 與包校驗緩存 24 小時

此外，插件會對 package.json 中的 dsh 字段進行校驗，並在卡片上標記驗證狀態，同時排除 DeepSeek 官方核心倉庫。

安裝¶

使用官方 CLI 安裝：

dsh plugin --profile web add dsh-weekly-hot

安裝完成後，重啓 dsh web 生效。

配置¶

插件隨分發附帶了 config.json，支持通過文件或面板設置修改。

榜單配置：設置飆升榜的時間窗口（7/30/90 天）、最小 Star 數及榜單長度；設置精選主題榜的主題列表及每主題數量。

數據源：配置是否優先使用社區精選列表及 GitHub Token（Token 優先存儲於瀏覽器 localStorage，面板設置中可填）。

UI：設置自動刷新間隔、默認榜單及時間窗口。

示例配置：

{
  "榜單配置": {
    "飆升榜": { "時間窗口": [7, 30, 90], "最小Star數": 0, "榜單長度": 50 },
    "精選主題榜": { "主題列表": ["UI", "工具", "記憶", "工作流", "視覺", "多模態"], "每主題數量": 10 }
  },
  "數據源": {
    "優先使用社區精選": true,
    "GitHub Token": ""
  },
  "UI": { "自動刷新間隔": 3600, "默認榜單": "飆升榜", "默認時間窗口": 7 }
}

開發¶

如需自行構建，請執行：

npm install   # 或 pnpm install
npm run build # esbuild 雙產物（lib/index.js 宿主半體 + lib/client.js 瀏覽器半體）+ tsc 類型

注意事項¶

• 零依賴：該插件不提供服務器，零運行時依賴（僅 React 爲 peer 依賴），所有數據獲取均由瀏覽器直連 GitHub。
• Token 管理：GitHub Token 僅存儲在瀏覽器的 localStorage 中，不會上傳到任何服務器。
• 權限範圍：安裝操作需宿主側支持 /api/dsh-weekly-hot/install 接口，且僅迴環可達。