前言¶
DeepSeek Harness (dsh) 是一個基於插件的智能體開發框架。在使用第三方網關（如 TokensForce）時，通常需要手動管理 API Key 和配置。dsh-tokensforce 插件旨在通過自動化流程，解決這一繁瑣的配置與登錄問題。
插件定位¶
dsh-tokensforce 是 DeepSeek Harness 的一個插件，由 spirits001 維護。它集成 TokensForce 詞元網關，支持一鍵登錄、自動配置提供方以及用量儀表盤集成。核心價值在於實現“登錄一次，模型即用”，無需手動填 Key 或改配置文件。
核心功能¶
插件提供以下核心能力：
- 一鍵登錄與自動注入：首次啓動時自動彈出登錄窗口，選擇企業或組後，API Key 與網關地址自動寫入。
- 多企業/組支持：支持在設置頁面添加新組，登錄態保留 7 天，期間無需重新登錄。
- 用量儀表盤：在會話視圖新增“TokensForce”標籤，可查看用量、費用與排行，與網頁版一致。
- 7天登錄態保持：瀏覽器僅保留 JWT 登錄態，7 天內有效。
- 安全存儲：組密鑰存儲於本地憑據文件（
~/.dsh/.credentials.yaml），瀏覽器不存儲密鑰。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add dsh-tokensforce
安裝後啓動服務：
dsh web
打開瀏覽器訪問 http://127.0.0.1:3080，登錄嚮導會自動彈出。
典型用法¶
- 首次啓動：dsh 啓動且尚未配置任何模型時，會自動彈出 TokensForce 登錄窗口。登錄方式與網頁版一致（郵箱驗證碼）。
- 選擇組織：如果賬號屬於多個企業或組，會彈出選擇界面；如果只有一個，則自動跳過。
- 自動配置：完成選擇後，所選組的 API Key 與網關地址自動配置。模型上下文默認設爲 1M（除非網關披露真實值）。
- 添加新組：之後在設置頁面點擊右上角“連接 TokensForce”按鈕，即可添加新組（登錄態 7 天內有效）。
- 查看用量：在會話視圖點擊“TokensForce”標籤，即可查看用量與費用儀表盤。
注意事項¶
- 禁用官方引導：插件會禁用官方 DeepSeek 提供方引導，避免開屏出現兩處登錄提示。模型引擎仍走 dsh 自帶的 OpenAI 兼容通道。
- 自定義部署：若公司自行部署了 TokensForce 網關，需修改
node_modules/dsh-tokensforce/lib/client.js中的SITE_ORIGIN爲你的站點地址，並重啓 dsh。站點需允許登錄頁嵌入。 - 密鑰安全：密鑰存儲在本地，瀏覽器只保留 JWT 登錄態。模型請求由 dsh 宿主進程直連網關，不經過瀏覽器。
- 適用場景：適合需要統一管理多個企業/組 API Key，並需要實時查看 TokensForce 用量數據的用戶。
總結¶
dsh-tokensforce 通過插件化方式簡化了接入 TokensForce 的流程。它將認證、配置和監控集成在 DSH 生態中，適合需要頻繁切換組織或關注網關用量統計的開發者。
