前言¶

在 DeepSeek Harness（DSH）裏使用清華算力平臺（easycompute.cs.tsinghua.edu.cn）上的 Paratera 模型時，通常要分開處理幾件事：用清華統一身份認證（id.tsinghua.edu.cn）維持瀏覽器會話、在平臺上查看算力券餘額、到控制台創建或輪換 API 密鑰，再把模型和參數寫進 DSH 的 provider 配置。這些步驟彼此獨立，也容易在會話過期或密鑰變更時脫節。

dsh-tsinghua-paratera 是社區維護的非官方 DSH 插件，把上述環節收進 DSH 的設置頁與輸入欄。下面介紹它的定位、能力與安裝用法；事實以倉庫 README 與發佈說明爲準。

這是什麼¶

• 名稱：DSH 清華算力 · Paratera（npm 包名 dsh-tsinghua-paratera）
• 維護者：MsCutey
• 目錄頁：skillhub.cn/plugins/MsCutey/dsh-tsinghua-paratera
• 源碼：github.com/MsCutey/dsh-tsinghua-paratera
• 當前修復版版本：1.0.5-windows.2（基於上游 1.0.4 功能線；許可證 MIT）

插件不隸屬於清華大學、Paratera 或 DeepSeek。DSH 生態主張「一切皆插件」；SkillHub 等目錄是社區站點，與 DeepSeek / 幻方無官方從屬關係。本插件從 GitHub Releases 下載源碼 ZIP 或插件 TGZ 後，用倉庫自帶的 install.mjs 掛到已初始化的 DSH desktop profile，而不是通過 dsh plugin add github:... 一類全局命令安裝。

適用範圍：僅適用於通過 id.tsinghua.edu.cn 登錄的清華算力平臺賬號。Paratera 官方賬號或其他高校、企業的 Paratera 接入不在支持範圍內。

核心功能¶

資料中明確列出的能力如下。

登錄、會話與餘額¶

• 專用 Chrome 會話完成登錄與續期，不使用日常 Chrome profile。
• 可選將登錄密碼存入系統憑據庫：macOS Keychain / Windows 當前用戶 DPAPI。
• 支持短信、企業微信二次認證；驗證碼由用戶在界面輸入；信任瀏覽器默認關閉。
• 輸入欄在當前供應商爲 paratera 時顯示算力券餘額（數據來自平臺 couponFree）；設置頁同時展示餘額與會話狀態。餘額不是賬單或實時結算保證。

控制台 API 密鑰¶

• 在 DSH 內列出、新建、改名、啓停、刪除密鑰，並將所選密鑰導入 DSH。
• 設置頁只顯示密鑰的 SHA-256 摘要指紋，不返回完整 API 密鑰字符串。
• 密鑰導入前會先驗證模型列表，不發送計費的模型推理；覆蓋舊密鑰前由 DSH 備份。
• 1.0.5-windows.2 修正了相對上游的認證算法差異（SHA-256 → 與官網一致的 SparkMD5/MD5），並完成真實新建→刪除密鑰的驗收說明（見倉庫 docs/KEY-MANAGEMENT.md）。

模型導入與參數¶

• 導入 Paratera 模型，並調整名稱、上下文長度、最大輸出、文本/圖片輸入類型、思考擋位等；變更通過 DSH Settings 即時生效。
• 新模型默認思考擋位爲 low / high / max。平臺模型廣場與公開目錄僅用於生成推薦值，實際路由上限需按目標模型自行驗證。

診斷與可選後臺續期¶

• 提供宿主兼容性診斷。
• 後臺續期爲可選功能，安裝時默認不註冊；需要時再通過安裝腳本註冊計劃任務（Windows）或 LaunchAgent（Mac），約每 6 小時檢查一次。

環境要求¶

上游在 Apple Silicon Mac 上做過實機驗證；1.0.5-windows.2 在 Windows 上驗證了隔離 profile 下的 pnpm 安裝/卸載及宿主 SDK。診斷兼容區間不代表每個 DSH 版本都逐一實測。

安裝與啓用¶

從 GitHub Releases 下載並解壓到長期保留的目錄，然後執行安裝腳本。安裝器會備份 profile 清單、追加本地鏈接和 bundle，重複執行不會重複追加。

macOS / Linux 終端（先預覽再安裝、最後校驗）：

cd /path/to/dsh-tsinghua-paratera
node scripts/install.mjs --dry-run
node scripts/install.mjs
node scripts/install.mjs --verify

未單獨安裝 Node 時，可使用 DSH 內置運行時，例如 macOS：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/node/bin/node" scripts/install.mjs

Windows PowerShell（默認入口僅預覽；-Action Install 執行安裝）：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\windows.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\windows.ps1 -Action Install

Windows 上也可把安裝目錄中 resources\runtime\primary-runtime\dependencies\node\bin\node.exe 加入 PATH，或顯式調用該 node.exe 運行 scripts/install.mjs。

可選參數：--dsh-home DIR、--profile NAME；環境變量 DSH_PNPM 可指定 pnpm.cjs。安裝成功後需完全退出並重開 DSH。

插件以當前 DSH 進程權限運行；安裝前應閱讀源碼、LICENSE 及 PRIVACY.md / SECURITY.md，自行判斷是否與使用環境匹配。

典型用法¶

賬號登錄與查看餘額¶

打開 DSH「設置 → 清華算力餘額 → 賬號登錄」。

1. 選擇「重新登錄」，在專用 Chrome 窗口完成清華統一身份認證，回到 DSH 刷新。
2. 若需自動登錄，可選「保存憑據」，在系統原生窗口輸入密碼；保存關閉後會嘗試登錄。
3. 二次認證時自行選擇接收渠道並輸入驗證碼；默認不把瀏覽器設爲長期可信。
4. 在「模型」中選擇已導入的 Paratera 模型後，輸入欄模型名稱旁會顯示餘額。

手動登錄不會由插件保存登錄密碼，但瀏覽器會話與短期 token 仍保存在本機。驗證碼和密碼不要粘貼到對話或工單中。

導入密鑰與模型¶

完成平臺登錄後：「連接控制台 → 加載密鑰 → 導入」。

• 「導入並添加」：保存所選密鑰並追加所選模型。
• 「僅保存密鑰」：只保存密鑰，不添加模型。

刪除密鑰會影響使用該密鑰的應用；新建或刪除結果不確定時，應先刷新或按名稱覈實，避免重複操作。創建密鑰不等於購買訂閱，後續調用仍受平臺計費規則約束。

註冊後臺續期（可選）¶

node scripts/install.mjs --task

遇到二次認證時，後臺任務會結束當次檢查，需回到 DSH 完成認證。自定義 DSH_HOME 會使用獨立的瀏覽器目錄與任務名稱。

卸載與本地數據¶

node scripts/install.mjs --uninstall              # 同時移除已導入的模型與會話
node scripts/install.mjs --uninstall --keep-data  # 只摘除插件，保留模型與會話
node scripts/install.mjs --uninstall --purge-profile  # 另外刪除專用 Chrome profile

卸載會從 profile 清單移除依賴、按 cordis.patch.yml 清理寫入的 paratera provider（改動前自動備份），並刪除會話狀態文件等。刪除 provider 不會撤銷平臺上的 API 密鑰；宿主持有的 PARATERA_API_KEY 等需另行確認。請先手動退出 DSH、專用 Chrome 和憑據窗口。Windows 細節見倉庫 docs/WINDOWS.md。

適用場景與注意¶

適合誰：已在清華算力平臺使用 Paratera 路由、並在 DSH 中希望用圖形化方式完成 SSO 登錄、看算力券餘額、管理控制台密鑰與模型參數的 macOS / Windows 用戶。

不適合誰：非 id.tsinghua.edu.cn 登錄路徑的 Paratera 賬號；無法在本機安裝 Google Chrome 或無法滿足 Node / DSH 版本要求的環境。

安全與隱私：插件 README 寫明不含遙測或分析服務代碼；聯網行爲還受 DSH 與 Chrome 自身設置影響。本機 bearer token 緩存不等於硬件隔離；勿在不可信共享系統上保存密碼或長期敞開登錄窗口。問題反饋只需版本號、錯誤碼與復現步驟，不要上傳密碼、完整 API 密鑰或會話文件。

結尾¶

dsh-tsinghua-paratera 把清華算力 SSO、算力券餘額展示、Paratera 控制台密鑰與模型配置收進 DSH，適合已在該路徑上使用 Paratera 的開發者做日常聯調。安裝與行爲以倉庫文檔爲準。

• 目錄頁：https://www.skillhub.cn/plugins/MsCutey/dsh-tsinghua-paratera
• GitHub：https://github.com/MsCutey/dsh-tsinghua-paratera