前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，內置用量統計能回答「用了多少 token」，但很難直接回答「這個 New API 中繼站點上還剩多少錢、按最近消耗還能撐幾天」。若你通過 開物雲（Kaiwu Cloud，New API 中繼）轉發模型請求，餘額和充值入口通常在站點控制台，和 DSH 界面是分開的。
下面介紹社區插件 dsh-zhijiang-connector（維護者 Guan-HP），它把開物雲的餘額、消耗與充值入口接到 DSH Web GUI 側欄，並在餘額緊張時用顏色提示。插件歸類爲 admin-security，當前 GitHub 星標爲 1；目錄頁見 SkillHub，源碼與文檔在 GitHub 倉庫。DSH 社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-zhijiang-connector（npm 包名 dsh-zhijiang-connector，版本 0.1.0，MIT 許可證）在 DSH Web 界面提供：
- 側欄持久徽章（例如
開物雲 ¥16.80，可用天數不足時變琥珀色或紅色）； - 點擊後的浮動面板：餘額、已用、近 24 小時、日均消耗、可用天數（runway）、密鑰名稱、過期時間等；
- 一鍵打開站點錢包頁充值（插件不處理支付數據）。
官方簡介：Balance, spend runway and top-up entry for a New API relay in the DSH web GUI sidebar。
核心功能¶
側欄與面板¶
- Sidebar badge：顯示站點名與金額；根據
warningDays/criticalDays改變嚴重程度顏色。 - Floating panel：彙總餘額、消耗與預測；
forecast.level可爲normal、warning、critical或unknown（新裝無消耗歷史時如實顯示，不假裝「還剩 0 天」）。 - Top-up entry：一鍵跳轉
walletURL（默認<baseURL>/console/wallet），不嵌入支付、不代付、不處理兌換碼。
兩條只讀通道¶
| 通道 | 上游 | 需要 | 回答的問題 |
|---|---|---|---|
| 密鑰 | GET /api/usage/token/ |
sk- API key |
該密鑰的上限與該密鑰歸因的消耗 |
| 賬戶 | GET /api/user/self |
控制台 PAT（nap_） |
錢包裏還剩多少錢 |
只配置 sk- 時，插件不展示賬戶餘額（顯示 —），並提示配置 access token；密鑰 unlimited_quota: true 只表示該密鑰無消費上限，不能代替錢包餘額。金額換算從每次刷新的 /api/status 讀取 quota_per_unit 與匯率，不做硬編碼默認值；CNY 站點若缺匯率會失敗並回退緩存，避免靜默算錯。
降級與邊界¶
- 超時或限流時保留上次成功值，並標記 stale。
- 明確不做：嵌入支付、新增獨立頁面路由、探測模型連通（避免真實扣費）、修改
llm-pi-ai提供商配置。 - 本地緩存文件：
$DSH_HOME/storages/zhijiang-connector.json；密鑰寫入~/.dsh/.credentials.yaml（明文，僅當前用戶可讀）。
安裝與啓用¶
要求：Node.js >= 20，DSH >= 0.2.1-rc.1 且 < 0.3.0-0（見 package.json 的 engines）。
Web 配置（推薦從 npm 安裝）：
dsh plugin --profile web add dsh-zhijiang-connector
或從 Git 倉庫安裝（README 佔位符爲 OWNER，實際倉庫爲 Guan-HP）：
dsh plugin --profile web add git+https://github.com/Guan-HP/dsh-zhijiang-connector.git
桌面版需先完全退出 Electron，再執行：
dsh plugin --profile desktop add dsh-zhijiang-connector
安裝會在 $DSH_HOME/profiles/<profile>/package.json 的 dsh.profile.bundles 中登記，並通過 cordis.patch.yml 掛載宿主側邏輯。
典型用法：配置與查看¶
- 打開 Web GUI → 側欄 Settings → Kaiwu Cloud。
- 在 API key 粘貼
sk-密鑰；在 Balance token 粘貼nap_儀表盤訪問令牌（建議在開物雲「Security & Access → Access Tokens」創建，範圍僅 usage:read + wallet:read）。 - 點擊 Save 一次；側欄即出現餘額徽章，無需再找第二個按鈕。
站點地址、刷新間隔、告警閾值在 ▸ Advanced（默認摺疊）；默認 baseURL 爲 https://ai.zhijianginc.com。憑證槽位只讀顯示 Stored as: zhijiangApiKey；多站點用戶可用 Change 改 credentialRef。Clear 與保存空框分離，避免誤刪已存密鑰。
常用配置項（完整表見 README）：
| 字段 | 默認值 | 含義 |
|---|---|---|
baseURL |
https://ai.zhijianginc.com |
站點地址，熱更新 |
credentialRef |
zhijiangApiKey |
存放 sk- 的憑證名 |
accountCredentialRef |
空 | 存放 PAT 的憑證名；空則關閉賬戶通道 |
refreshSeconds |
300 |
刷新間隔，最小 60 |
warningDays |
3 |
低於此可用天數徽章變琥珀 |
criticalDays |
1 |
低於此變紅 |
walletURL |
<baseURL>/console/wallet |
充值深鏈 |
保存 PAT 時內部指向 ZHIJIANG_ACCESS_TOKEN；清除 token 會一併清除對應憑證名。
宿主 HTTP 接口（僅 loopback）¶
插件在 /api/zhijiang/ 下提供五條路徑，均限制爲 loopback 對等訪問；任何路由都不返回密鑰明文。設置頁主要使用 POST /api/zhijiang/credential 與 POST /api/zhijiang/settings；可讀 GET /api/zhijiang/snapshot 獲取緩存或觸發刷新。請求體超過 8 KiB 會拒絕；校驗失敗返回 400 及逐字段 reason。
適用場景與注意¶
適合：在 DSH Web 或 Desktop 中長期使用開物雲（或其它兼容 New API 且行爲一致的中繼），希望在 harness 內一眼看到「還剩多少錢、還能用幾天」，並快速打開錢包充值的用戶。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請自行審閱 源碼 與 MIT 許可證。
- 只看密鑰額度無法替代錢包餘額；要顯示真實餘額必須配置 PAT。
- 僅
sk-時訪問/api/user/self得到 401 是站點設計，不是配錯。 - 社區目錄 SkillHub 插件頁 便於發現同類 admin-security 插件；安裝與配置仍以 GitHub README 爲準。
結尾¶
dsh-zhijiang-connector 補上了 DSH 內置統計沒有的一問：中繼站點上還剩多少資金、按近期消耗還能撐多久，並把充值入口放在側欄一步可達。需要細節時打開 GitHub README（含 中文 README）與 SkillHub 目錄頁 即可。
