OpenCode Go Usage
OpenCode Go Usage 讓你在 VS Code 聊天中使用 OpenCode Go 模型，查看 Go 方案用量及本機聊天請求明細。需要 VS Code 1.116 或更新版本。
開始使用
- 在 OpenCode Console 建立 OpenCode Go API Key。
- 執行
OpenCode Usage: Set Go API Key 並輸入金鑰。擴充套件會將金鑰存入 VS Code SecretStorage；再次執行並留空可清除金鑰。
- 在 VS Code 聊天模型選擇器中開啟「管理模型」，將 OpenCode Go 模型設為可見，再選擇要使用的模型。
同一把金鑰用於聊天、模型可用性查詢及方案用量查詢。聊天訊息會送至 OpenCode Go API。模型目錄與五小時預估次數則從公開資料來源載入。
聊天模型
模型名稱會附上所選方案的官方五小時預估請求數。預估次數不是保證次數，也不是帳戶目前的剩餘次數。實際限制會依 Token 成本、快取與時間週期而變。設定 opencodeUsage.chat.plan 為 Go Plus 只會切換模型名稱上的預估次數，不會變更你的訂閱方案。
擴充套件從 models.dev 模型目錄 取得模型資料，並從 OpenCode Go 說明 取得五小時預估次數。公開資料快取最長一小時。更新失敗時會使用上次成功資料或隨附資料，並在 Output Channel 記錄錯誤。執行 OpenCode Usage: Refresh Go Models 可手動更新。
模型清單預設依目前金鑰可用的模型篩選，並依所選方案的五小時預估次數排序。Unlimited 排在前面，沒有公布次數的模型排在最後。已棄用模型預設隱藏。你可以設定最低預估次數篩選模型；免費模型會通過篩選，沒有公布次數的模型不會通過。
擴充套件支援串流文字、模型目錄標示支援的圖片輸入，以及 VS Code 工具呼叫。VS Code 呼叫端負責執行工具及處理核准。聊天輸入的 Token 計數是依 UTF-8 文字長度估算，不是模型專用 tokenizer；圖片使用固定估值。音訊、影片與非文字工具結果尚未支援。
方案用量與本機明細
狀態列顯示五小時、每週及每月用量百分比與重置時間。用量達 70% 時顯示警告色，超過 95% 時顯示危險色。預設每 5 分鐘更新一次。執行 OpenCode Usage: Refresh Now 可立即更新；執行 OpenCode Usage: Stop/Resume Updates 可停止或恢復自動及手動更新。
執行 OpenCode Usage: Show Local Usage Details 可查看本擴充套件完成的聊天請求。擴充套件在 VS Code 本機儲存最多 500 筆記錄，並依目前金鑰分開顯示。明細包括請求數、API 回報的 Token、依模型價格估算的費用、模型與本地日期彙整，以及最近 100 筆請求。估算費用不是官方帳單；沒有回報 Token 或模型沒有價格時會顯示「—」。明細不含其他工具或過去的帳戶歷史，這些資料請至 OpenCode Console 查詢。
設定
在 VS Code 設定中搜尋 opencodeUsage，可調整方案用量及聊天模型行為。
| 設定 |
預設值 |
說明 |
opencodeUsage.refreshIntervalMinutes |
5 分鐘 |
方案用量自動更新間隔，最少 1 分鐘。 |
opencodeUsage.timeoutMs |
30,000 毫秒 |
方案用量 HTTP 請求逾時，範圍為 1,000 至 120,000 毫秒。 |
opencodeUsage.chat.plan |
Go |
模型名稱使用 Go 或 Go Plus 的五小時預估次數。此設定不會變更訂閱。 |
opencodeUsage.chat.autoDiscovery |
開啟 |
使用 API 可用模型清單篩選目錄；需要 Go API Key。 |
opencodeUsage.chat.showDeprecatedModels |
關閉 |
顯示目錄中已棄用的模型。 |
opencodeUsage.chat.minFiveHourRequests |
0 |
只顯示預估次數大於或等於此門檻的模型。0 不篩選；免費模型會通過，未公布次數的模型不會通過。 |
opencodeUsage.chat.reasoningEffort |
auto |
設定思考強度：auto 使用模型預設，none 關閉思考，也可選 minimal、low、medium、high、xhigh 或 max。不支援的強度會使用模型預設。 |
opencodeUsage.chat.requestTimeoutMs |
600,000 毫秒 |
聊天請求的整段串流逾時。 |
opencodeUsage.chat.maxOutputTokens |
8,192 tokens |
每次回覆的輸出上限，仍受模型上限限制。 |
具推理能力的模型可在 VS Code 模型選單中選擇思考層級。模型選單中的選擇優先於 opencodeUsage.chat.reasoningEffort；選擇 auto 時使用模型預設。
方案用量查詢的連線設定
方案用量查詢支援 HTTPS_PROXY 或 https_proxy。兩者都未設定時，會使用 ALL_PROXY。設定 NO_PROXY 或 no_proxy 可讓符合的主機直接連線；http:// 代理會透過 HTTPS CONNECT 連線。
系統 DNS 查詢失敗時，擴充套件會使用 OPENCODE_DNS_SERVERS 指定的 IPv4 DNS 伺服器。未設定時使用 1.1.1.1,8.8.8.8。這些代理與 DNS 設定用於方案用量查詢。
指令
| 指令 |
說明 |
OpenCode Usage: Set Go API Key |
設定或清除聊天、模型與方案用量共用的金鑰。 |
OpenCode Usage: Refresh Go Models |
更新聊天模型清單與五小時預估次數。 |
OpenCode Usage: Refresh Now |
立即查詢方案用量。 |
OpenCode Usage: Stop/Resume Updates |
停止或恢復方案用量更新。 |
OpenCode Usage: Show Local Usage Details |
查看本機儲存的聊天請求明細。 |
OpenCode Usage: Diagnose |
檢查金鑰是否已設定，並查詢 DNS 與方案用量連線；診斷不顯示金鑰內容。 |
OpenCode Usage: Open OpenCode Usage Page |
開啟 OpenCode Console。 |
OpenCode Usage: Show Output |
顯示查詢與診斷紀錄。 |
