前言¶
在 DeepSeek Harness（DSH）裏寫代碼、調智能體時，若同時訂閱了 Kimi Code 會員，5 小時與 7 天兩檔額度往往要單獨打開 Kimi Code 控制台或查郵件才能對齊。DSH 本身不提供 Kimi 側用量展示；社區插件 dsh-kimi-code-usage 把額度拉到對話輸入框下方，本地輪詢、點開可看明細，並在同一界面管理 API Key 與區域，減少切站覈對。
這是什麼¶
dsh-kimi-code-usage 是由維護者 ancientbag 發佈的 DeepSeek Harness 插件（分類：客戶端）。它在 Web UI 中展示 Kimi Code 訂閱配額，而不是按量計費的開發者平臺 api.moonshot.ai。密鑰形態爲 sk-kimi-…，需在 Kimi Code Console 創建；插件面向會員 API：api.kimi.ai/coding 或 api.kimi.com/coding。
核心功能¶
下面能力是 README 中寫明的行爲，安裝後可在界面上直接驗證。
- 輸入框下方徽章：緊湊展示類似
Kimi 5h 28% · 7d 12%的用量摘要；隨佔用升高由綠經黃至紅。 - 點擊彈出詳情：進度條、已用/剩餘、重置時間（24 小時制）、賬戶等級。
- API Key 管理：在彈層中粘貼並保存；密鑰存入 Harness 憑據倉庫，而非明文寫在配置裏。
- 區域切換：Oversea（
https://api.kimi.ai/coding）或 CN（https://api.kimi.com/coding），彈層中可改，配置文件也可設baseUrl。
實現上，宿主側 index.js 註冊經認證的 /api/kimi.balance，代理 GET {baseUrl}/v1/usages 與 /v1/me 並對上游請求防抖；客戶端 client.js 將徽章掛到 conversation.composer.dock，彈層掛到 shell.overlay，約每分鐘及每次點擊徽章時輪詢本地路由。
安裝與啓用¶
在 DeepSeek Harness 中可通過 Settings → Plugins → Install bundle 安裝，或對智能體說出安裝意圖。官方 README 給出的命令如下。
通過 bundle 名稱安裝：
Install the bundle dsh-kimi-code-usage
不經 npm、直接從 GitHub 安裝：
Install the bundle github:ancientbag/dsh-kimi-code-usage
若安裝後未出現 Kimi 用量徽章，README 建議 重新啓動 DeepSeek Harness 後再試。出現徽章後，點擊輸入框下方的徽章，粘貼 API Key 並保存即可開始拉取用量。
配置說明¶
可選行配置寫在 cordis.patch.yml 中，字段含義如下。
| 字段 | 默認值 | 含義 |
|---|---|---|
apiKey |
"" |
Kimi Code API Key；更推薦在彈層中配置，並以 MOONSHOT_API_KEY 憑據形式存儲。 |
baseUrl |
https://api.kimi.ai/coding |
國內賬號可用 https://api.kimi.com/coding；亦可在彈層切換。 |
cacheSeconds |
60 |
硬防抖：該間隔內至多一次上游請求；最小 30。 |
密鑰優先級：config.apiKey → 憑據倉庫 / 啓動環境 / .env 中的 MOONSHOT_API_KEY。
典型用法¶
- 按上一節任一方式安裝 bundle，必要時重啓 DSH。
- 點擊 composer 下方 Kimi 徽章，在彈層中粘貼
sk-kimi-…並選擇 Oversea 或 CN，保存。 - 平時看徽章顏色與百分比；需要重置時間與等級時點開彈層；若需改區域或 Key，仍在同一彈層操作。
無需額外 CLI；用量經本地 /api/kimi.balance 聚合，避免瀏覽器直連 Kimi API 時暴露 Key 到前端配置。
適用場景與注意¶
適合：在 DSH Web 端長期使用 Kimi Code 會員、希望邊寫邊瞄 5 小時/周額度、且希望 Key 走 Harness 憑據鏈路的開發者。
注意：
- 插件針對 Kimi Code 會員 API，與 Moonshot 按量開發者 API 不是同一條線；Key 須在 Kimi Code Console 創建。
- 插件與當前 DSH 進程同權限運行；安裝前應閱讀 GitHub 倉庫 源碼並確認 MIT 許可證是否滿足你的合規要求。
- 社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；「一切皆插件」是 DSH 生態理念，本文介紹的是社區維護的客戶端 bundle。
結尾¶
dsh-kimi-code-usage 把 Kimi Code 訂閱用量嵌進 DSH 對話界面，用徽章、彈層與憑據化 Key 管理減少反覆登錄控制台。進一步瞭解可訪問目錄頁 SkillHub 與源碼倉庫 github.com/ancientbag/dsh-kimi-code-usage。
