前言¶
在 DeepSeek Harness（DSH）裏用 OpenCode Go 或 Go Plus 訂閱跑模型時，常見做法是自行配置 provider、把 API key 寫進配置文件或環境變量，用量也要另開頁面查。Harness 內置的 opencode-go provider 有獨立憑據路徑，和社區插件若不同步，容易出現「模型能看見、調用卻未授權」或 key 重複維護的問題。
下面介紹社區插件 dsh-opencode-go-auth（維護者 solstice621，MIT 許可）。它面向 DeepSeek Harness Desktop，提供原生 bundle、後端 provider 與客戶端設置頁：在 Harness 內保存並校驗 oc_sk_… 形式的 API key、展示官方返回的額度窗口、同步 Go 模型目錄，並在設置裏勾選會話中要顯示的模型。插件不修改 App 安裝包或 asar，也不增加 OpenCode 額度或改變賬號權限；與 OpenCode / Anomaly 官方無關聯。
這是什麼¶
dsh-opencode-go-auth 是 DSH 社區目錄中的客戶端類插件，倉庫地址 github.com/solstice621/dsh-opencode-go-auth，目錄頁 skillhub.cn/plugins/solstice621/dsh-opencode-go-auth。
一句話定位：在 Harness 桌面版連接 OpenCode Go / Go Plus 訂閱，憑據進 Harness 憑據存儲，用量與模型在設置頁可視化管理；會話裏該連接顯示爲 OpenCode · Go 額度。
核心功能¶
以下能力均來自倉庫 README 的功能表與說明。
賬號與憑據
- 在設置頁粘貼 API key，插件先調額度接口驗證再保存；401 提示 key 無效，403 提示需要 Go / Go Plus 訂閱。
- 推薦保存到 Harness 憑據存儲的
OPENCODE_GO_API_KEY，配置文件裏不出現明文。 - 若本機已用 OpenCode CLI 完成
/connect，可複用~/.local/share/opencode/auth.json（跟隨XDG_DATA_HOME，可用authFile覆蓋）；僅識別type: "api"的條目。 - 憑據解析按優先級：
apiKey配置字面值 → 憑據存儲 / 環境變量 → CLI 的auth.json；輪換 key 無需重啓 Harness。
用量
- 展示官方 5 小時、每週、每月三個額度窗口的剩餘比例與重置時間。
- 打開設置頁先顯示上次成功讀取的快照，再在後臺刷新；Harness 運行且連接啓用時，默認每 5 分鐘後臺刷新額度。
- 快照按 API key 隔離，默認路徑爲
~/.dsh/cache/dsh-opencode-go-auth/<baseUrl 哈希>/quota.json。
模型
- 啓動時及默認每 6 小時從公開目錄同步模型；登錄前也可在「模型自動同步」中手動刷新。
- 「模型顯示」中搜索、勾選會話模型選擇器裏要出現的模型，勾選即時保存；未設置
selectedModelIds時顯示完整目錄，[]則隱藏該插件全部模型。 - 內置目錄缺少的模型會嘗試從 Zen 目錄借用元數據或按保守設置補齊；對話能力複用 Harness adapter 的流式輸出、工具調用、歷史 replay 與圖片處理。
其他
- 可啓用或停用 Harness 中的 OpenCode Go 連接；錄屏前可隱藏 key 標籤。
- macOS 上可在 Host 未顯式配置代理時使用系統 HTTP/HTTPS 代理（
useSystemProxy）；PAC / SOCKS-only 系統代理暫不支持。
安裝與啓用¶
插件以當前 DSH 進程權限運行，安裝前應閱讀倉庫源碼與 MIT 許可證。倉庫提供可直接運行的 JavaScript 與原生 client entry，無需執行 prepare、postinstall 或第三方安裝腳本。
- 在 opencode.ai/auth 訂閱 Go 或 Go Plus，複製 API key。
- 在 Harness 左側打開「插件」→「添加插件」。
- 輸入以下 GitHub 包地址（來自 README，固定版本可將
main換成已確認的提交 SHA）：
github:solstice621/dsh-opencode-go-auth#main
- 安裝並啓用插件，然後完全退出並重新打開 Harness。
- 打開「設置」→ OpenCode / Go，點擊「登錄 OpenCode Go」粘貼 key 並保存；本機已有 CLI 登錄時會自動識別。
- 在「模型自動同步」中點擊「刷新模型」，在「模型顯示」中勾選常用模型。
- 回到會話，在模型選擇器的 OpenCode · Go 額度 下選擇模型。
本地安裝可在倉庫中執行 npm pack --ignore-scripts，在「添加插件」中填寫生成的 .tgz 絕對路徑。
典型用法與配置要點¶
設置頁順序（README 約定）：賬號連接 → 訂閱額度 → 模型自動同步 → 模型顯示。將 showModelSync 設爲 false 只隱藏同步卡片，仍可勾選模型。
常用配置項（修改後除連接開關、模型勾選、已保存 key 更換外，多數需重啓 Harness）：
| 字段 | 默認值 | 含義 |
|---|---|---|
enabled |
true |
是否在 Harness 中啓用該連接 |
baseUrl |
https://opencode.ai/zen/go/v1 |
Zen Go 接口根地址 |
apiKeyEnv |
OPENCODE_GO_API_KEY |
憑據引用名 |
quotaRefreshMinutes |
5 |
後臺額度刷新間隔（1–1440 分鐘） |
modelRefreshMinutes |
360 |
模型目錄自動刷新間隔（5–10080 分鐘） |
requestTimeoutMs |
20000 |
額度與目錄請求超時 |
默認網絡訪問 https://opencode.ai 的 /zen/go/v1/usage 與 /zen/go/v1/models；模型推理由原生傳輸層按各模型協議發往 OpenCode Go 端點。公開模型目錄請求不攜帶 key；額度與實際調用需要有效 Go API key。
模型篩選行爲：恢復默認時，之後同步到的新模型會自動出現在會話列表；手動勾選或「全選」後，新模型需再手動勾選。「移除授權」刪除 Harness 中的 key，不影響本機 CLI 的 auth.json；「停用此連接」只停用 provider，保留已保存 key。
適用場景與注意¶
適合誰
- 已在 OpenCode 訂閱 Go / Go Plus，希望在 Harness Desktop 內完成登錄、看額度、選模型並對話，而不想長期把 key 寫在插件配置明文裏。
- 本機已配置 OpenCode CLI，希望 Harness 與 CLI 共用同一
auth.json。
兼容性與限制（以 README 爲準）
- 當前文檔記載的驗證環境以 macOS + DeepSeek Harness Desktop
0.2.1-rc.3+ pi-ai1.1.0爲主，含授權、額度、桌面模型勾選與實際對話；另在 Harness SDK0.2.1-rc.5+ pi-ai1.4.0做過插件導入與適配器相關自動化檢查（未發送模型請求）。Keychain 形式、Windows 和 Linux 桌面環境尚未驗證。 - 能看到模型但提示未授權時：公開目錄無需登錄，須在設置頁保存有效 key 並在會話中選擇 OpenCode · Go 額度。
- 插件配置中的
apiKey優先於憑據存儲；更換 key 後若仍像舊授權，需檢查配置字面值與環境變量來源。
DSH 生態強調「一切皆插件」；skillhub.cn 上的社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件爲社區維護，使用前請自行評估網絡披露（package.json 中 disclosure.cloud 爲 true，需訪問 https://opencode.ai）。
結尾¶
dsh-opencode-go-auth 把 OpenCode Go 訂閱的 key 託管、三窗口用量展示、模型目錄同步與會話模型勾選收進 Harness 原生設置頁，安裝包地址爲 github:solstice621/dsh-opencode-go-auth#main。更多細節與 FAQ 見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/solstice621/dsh-opencode-go-auth
- GitHub：https://github.com/solstice621/dsh-opencode-go-auth
