opencode-go-usage-tui 1.0.1 → 1.1.0

package/README.md

@@ -2,6 +2,8 @@
 
 在 OpenCode 侧边栏实时显示 OpenCode Go 额度用量（5小时/每周/每月）。
 
+支持中英双语界面（`/go-lang` 切换，首次启动自动引导选择语言）。
+
 ## 安装
 
 ### 方式一：OpenCode 命令安装（推荐）
@@ -79,6 +81,13 @@ Cookie 有效期约 1 年，过期后重新获取。
 - 用量超过阈值（默认 80%，可用 `OPENCODE_GO_WARN_THRESHOLD` 调整）显示为红色
 - 点击面板标题可折叠/展开
 - 配置错误时面板会提示"未配置账号"，输入 `/go-config` 即可设置
+- 面板标题显示当前插件版本号（如 `v1.1.0`）
+
+## 语言
+
+- 首次安装启动时自动弹出语言选择，选择后若未配置账号会继续引导 `/go-config`
+- 随时执行 `/go-lang` 可切换 中文 / English，语言偏好会记住
+- 自动检测系统语言（中文系统默认中文，其余默认英文）
 
 ## 开发
 

package/README_EN.md

@@ -0,0 +1,103 @@
+# opencode-go-usage-tui
+
+Display your OpenCode Go quota usage (5h / weekly / monthly) in the OpenCode sidebar in real time.
+
+Bilingual UI (Chinese / English) — switch with `/go-lang`, or pick a language during the first-run onboarding.
+
+## Install
+
+### Option 1: Install via OpenCode command (recommended)
+
+In OpenCode, press **`Ctrl+P`** to open the command palette, search for **`install plugin`**, and enter:
+
+```
+opencode-go-usage-tui@latest
+```
+
+Press Enter, restart OpenCode, and the "Go Usage" panel will appear in the sidebar.
+
+### Option 2: npm global install
+
+```bash
+npm install -g opencode-go-usage-tui
+```
+
+Then add it to the `plugin` array in `~/.config/opencode/tui.json`:
+
+```json
+{
+  "plugin": ["opencode-go-usage-tui@latest"]
+}
+```
+
+Restart OpenCode.
+
+## Configuration
+
+### Option 1: Slash command (recommended)
+
+Run in the TUI:
+
+```
+/go-config
+```
+
+Enter two values (unique per user — get them by logging into opencode.ai):
+
+1. **workspace_id**: starts with `wrk_`, found in the opencode.ai console URL
+2. **auth cookie**: in your browser, F12 → Application → Cookies → opencode.ai → copy the `auth` value (starts with `Fe26.2*`)
+
+Config is saved to `~/.config/opencode/go-usage-config.json`.
+
+### Option 2: Environment variables
+
+| Variable | Description |
+| -------- | ----------- |
+| `OPENCODE_GO_WORKSPACE_ID` | Workspace ID |
+| `OPENCODE_GO_AUTH_COOKIE` | Auth cookie value |
+
+### Option 3: Config file
+
+Create `~/.config/opencode/go-usage-config.json` manually:
+
+```json
+{
+  "workspace_id": "wrk_xxxxxxxxxxxx",
+  "cookie": "Fe26.2*..."
+}
+```
+
+## Getting the auth cookie
+
+1. Log into opencode.ai in Chrome
+2. Press F12 to open DevTools → Application → Cookies → select opencode.ai
+3. Find `auth`, copy its Value
+
+The cookie is valid for about 1 year; get a new one after it expires.
+
+## Usage
+
+- The sidebar panel auto-refreshes every 60 seconds (adjustable via `OPENCODE_GO_CHECK_INTERVAL`, in milliseconds)
+- Usage above the threshold (default 80%, adjustable via `OPENCODE_GO_WARN_THRESHOLD`) is shown in red
+- Click the panel title to collapse/expand
+- If misconfigured, the panel shows "Not configured" — run `/go-config` to set up
+- The panel title shows the current plugin version (e.g. `v1.1.0`)
+
+## Language
+
+- On first install, a language picker pops up automatically; if the account isn't configured yet, it continues into the `/go-config` onboarding
+- Run `/go-lang` anytime to switch between 中文 / English; your preference is remembered
+- Auto-detects system language (Chinese systems default to 中文, everything else defaults to English)
+
+## Development
+
+```bash
+# Build
+bun run build.tui.mjs
+# or
+npm run build
+```
+
+## License
+
+MIT

package/build.tui.mjs

@@ -1,5 +1,8 @@
 import * as esbuild from "esbuild"
 import { solidPlugin } from "esbuild-plugin-solid"
+import { readFileSync } from "node:fs"
+
+const pkg = JSON.parse(readFileSync("package.json", "utf8"))
 
 await esbuild.build({
   entryPoints: ["src/index.tsx"],
@@ -9,5 +12,6 @@ await esbuild.build({
   bundle: true,
   external: ["@opencode-ai/*", "@opentui/*", "solid-js", "node:fs", "node:path"],
   plugins: [solidPlugin({ solid: { moduleName: "@opentui/solid", generate: "universal" } })],
+  define: { __PLUGIN_VERSION__: JSON.stringify(pkg.version) },
   logLevel: "info",
 })

package/dist/tui.js

@@ -11,10 +11,114 @@ import { createElement as _$createElement } from "@opentui/solid";
 import { createSignal, createEffect, onMount, onCleanup, Show } from "solid-js";
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
+
+// src/i18n.ts
+var ZH_T = {
+  panelTitle: "Go \u7528\u91CF",
+  rowRolling: "5\u5C0F\u65F6\u7528\u91CF",
+  rowWeekly: "\u6BCF\u5468\u7528\u91CF",
+  rowMonthly: "\u6BCF\u6708\u7528\u91CF",
+  weeklyShort: "\u5468",
+  updatedAt: "\u6700\u8FD1\u66F4\u65B0",
+  notConfigured: "\u672A\u914D\u7F6E\u8D26\u53F7",
+  notConfiguredHint: "\u8F93\u5165 /go-config \u8BBE\u7F6E",
+  loading: "\u52A0\u8F7D\u4E2D...",
+  queryFailed: "\u67E5\u8BE2\u5931\u8D25",
+  cookieExpired: "cookie \u5DF2\u8FC7\u671F",
+  reconfigureHint: "\u8F93\u5165 /go-config \u91CD\u65B0\u914D\u7F6E",
+  resetDone: "\u5DF2\u91CD\u7F6E",
+  dayHour: "{d}\u5929{h}\u5C0F\u65F6",
+  hourMin: "{h}\u5C0F\u65F6{m}\u5206\u949F",
+  minute: "{m}\u5206\u949F",
+  cmdTitle: "Go Usage: Configure",
+  cmdDesc: "\u8BBE\u7F6E OpenCode Go workspace ID \u548C auth cookie",
+  wsPromptTitle: "\u8F93\u5165 workspace_id",
+  wsPromptDesc: "\u5728 opencode.ai \u63A7\u5236\u53F0 URL \u4E2D\u83B7\u53D6\uFF08wrk_ \u5F00\u5934\uFF09",
+  wsPlaceholder: "wrk_xxxxxxxxxxxx",
+  cookiePromptTitle: "\u8F93\u5165 auth cookie",
+  cookiePromptDesc: "\u767B\u5F55 opencode.ai \u540E\uFF0C\u6D4F\u89C8\u5668 F12 \u2192 Application \u2192 Cookies \u2192 opencode.ai \u2192 \u590D\u5236 auth \u7684\u503C",
+  cookiePlaceholder: "Fe26.2*...",
+  configSaved: "Go \u7528\u91CF\u914D\u7F6E\u5DF2\u4FDD\u5B58",
+  langTitle: "\u663E\u793A\u8BED\u8A00",
+  langCmdTitle: "Go Usage: Language",
+  langCmdDesc: "\u5207\u6362\u663E\u793A\u8BED\u8A00 | Switch display language",
+  langSwitchedZh: "\u5DF2\u5207\u6362\u4E3A\u4E2D\u6587",
+  langSwitchedEn: "Switched to English",
+  onboardLangTitle: "Welcome to Go Usage / \u6B22\u8FCE\u4F7F\u7528 Go \u7528\u91CF",
+  onboardLangDesc: "Choose display language / \u9009\u62E9\u663E\u793A\u8BED\u8A00",
+  onboardConfigTitle: "Welcome to Go Usage / \u6B22\u8FCE\u4F7F\u7528 Go \u7528\u91CF",
+  onboardConfigDesc: "First-time setup / \u9996\u6B21\u4F7F\u7528\u9700\u914D\u7F6E\u8D26\u53F7",
+  setupCanceled: "\u5DF2\u53D6\u6D88\u914D\u7F6E\uFF0C\u8F93\u5165 /go-config \u53EF\u91CD\u65B0\u8BBE\u7F6E"
+};
+var EN_T = {
+  panelTitle: "Go Usage",
+  rowRolling: "5h usage",
+  rowWeekly: "Weekly",
+  rowMonthly: "Monthly",
+  weeklyShort: "Wk",
+  updatedAt: "Updated",
+  notConfigured: "Not configured",
+  notConfiguredHint: "Run /go-config to set up",
+  loading: "Loading...",
+  queryFailed: "Query failed",
+  cookieExpired: "Cookie expired",
+  reconfigureHint: "Run /go-config to reconfigure",
+  resetDone: "Reset",
+  dayHour: "{d}d {h}h",
+  hourMin: "{h}h {m}m",
+  minute: "{m}m",
+  cmdTitle: "Go Usage: Configure",
+  cmdDesc: "Set OpenCode Go workspace ID and auth cookie",
+  wsPromptTitle: "Enter workspace_id",
+  wsPromptDesc: "Get it from the opencode.ai console URL (starts with wrk_)",
+  wsPlaceholder: "wrk_xxxxxxxxxxxx",
+  cookiePromptTitle: "Enter auth cookie",
+  cookiePromptDesc: "After logging into opencode.ai, press F12 \u2192 Application \u2192 Cookies \u2192 opencode.ai \u2192 copy the auth value",
+  cookiePlaceholder: "Fe26.2*...",
+  configSaved: "Go usage config saved",
+  langTitle: "Display language",
+  langCmdTitle: "Go Usage: Language",
+  langCmdDesc: "\u5207\u6362\u663E\u793A\u8BED\u8A00 | Switch display language",
+  langSwitchedZh: "\u5DF2\u5207\u6362\u4E3A\u4E2D\u6587",
+  langSwitchedEn: "Switched to English",
+  onboardLangTitle: "Welcome to Go Usage / \u6B22\u8FCE\u4F7F\u7528 Go \u7528\u91CF",
+  onboardLangDesc: "Choose display language / \u9009\u62E9\u663E\u793A\u8BED\u8A00",
+  onboardConfigTitle: "Welcome to Go Usage / \u6B22\u8FCE\u4F7F\u7528 Go \u7528\u91CF",
+  onboardConfigDesc: "First-time setup / \u9996\u6B21\u4F7F\u7528\u9700\u914D\u7F6E\u8D26\u53F7",
+  setupCanceled: "Setup canceled, run /go-config to reconfigure"
+};
+var LANGS = { zh: ZH_T, en: EN_T };
+var LANG_META = [
+  { code: "zh", label: "\u4E2D\u6587" },
+  { code: "en", label: "English" }
+];
+function applyParams(tpl, params) {
+  if (!params) return tpl;
+  return tpl.replace(
+    /\{(\w+)\}/g,
+    (m, k) => k in params ? String(params[k]) : m
+  );
+}
+function createT(getCode) {
+  return (key, params) => applyParams(LANGS[getCode()][key], params);
+}
+function detectLang() {
+  try {
+    const loc = Intl.DateTimeFormat().resolvedOptions().locale.toLowerCase();
+    if (loc.startsWith("zh")) return "zh";
+    return "en";
+  } catch {
+    return "en";
+  }
+}
+
+// src/index.tsx
+var VERSION = "1.1.0";
 var CHECK_INTERVAL = Number(process?.env?.OPENCODE_GO_CHECK_INTERVAL ?? 6e4);
 var WARN_THRESHOLD = Number(process?.env?.OPENCODE_GO_WARN_THRESHOLD ?? 0.8);
 var CONFIG_DIR = process?.env?.OPENCODE_CONFIG_DIR || (process?.env?.USERPROFILE ? `${process.env.USERPROFILE}\\.config\\opencode` : "") || process?.env?.HOME + "/.config/opencode";
 var CONFIG_FILE = join(CONFIG_DIR, "go-usage-config.json");
+var KV_PREFIX = "go-usage";
 function loadConfig() {
   const env = process?.env ?? {};
   let fileCfg = {};
@@ -56,6 +160,21 @@ function saveConfig(patch) {
   }
 }
 var [configTick, setConfigTick] = createSignal(0);
+var [langCode, setLangCode] = createSignal(detectLang());
+var t = createT(() => langCode());
+function kvTryGet(api, key) {
+  try {
+    return api.kv.get(key);
+  } catch {
+    return void 0;
+  }
+}
+function kvTrySet(api, key, val) {
+  try {
+    api.kv.set(key, val);
+  } catch {
+  }
+}
 async function fetchUsage(workspaceId, authCookie) {
   if (!workspaceId || !authCookie) return {
     error: "not_configured"
@@ -119,13 +238,21 @@ async function fetchUsage(workspaceId, authCookie) {
   }
 }
 function formatReset(sec) {
-  if (sec <= 0) return "\u5DF2\u91CD\u7F6E";
+  if (sec <= 0) return t("resetDone");
   const d = Math.floor(sec / 86400);
   const h = Math.floor(sec % 86400 / 3600);
   const m = Math.floor(sec % 3600 / 60);
-  if (d > 0) return `${d}\u5929${h}\u5C0F\u65F6`;
-  if (h > 0) return `${h}\u5C0F\u65F6${m}\u5206\u949F`;
-  return `${m}\u5206\u949F`;
+  if (d > 0) return t("dayHour", {
+    d,
+    h
+  });
+  if (h > 0) return t("hourMin", {
+    h,
+    m
+  });
+  return t("minute", {
+    m
+  });
 }
 function progressBar(percent, width) {
   const clamped = Math.max(0, Math.min(100, percent));
@@ -177,11 +304,11 @@ function GoUsagePanel(props) {
     setConfigured(true);
     const u = await fetchUsage(cfg.workspaceId, cfg.authCookie);
     if (u === null) {
-      setError("\u67E5\u8BE2\u5931\u8D25");
+      setError(t("queryFailed"));
       return;
     }
     if (u.error === "cookie_expired") {
-      setError("cookie \u5DF2\u8FC7\u671F");
+      setError(t("cookieExpired"));
       return;
     }
     if (u.error === "not_configured") {
@@ -208,12 +335,12 @@ function GoUsagePanel(props) {
     ...FALLBACK
   });
   createEffect(() => {
-    const t = props.theme;
+    const th = props.theme;
     const p = {
       ...FALLBACK
     };
     for (const k of Object.keys(FALLBACK)) {
-      const h = hex(t?.[k]);
+      const h = hex(th?.[k]);
       if (h) p[k] = h;
     }
     setPal(p);
@@ -271,7 +398,7 @@ function GoUsagePanel(props) {
   };
   const sep = () => "\u2500".repeat(Math.max(1, panelWidth() - 4));
   return (() => {
-    var _el$1 = _$createElement("box"), _el$10 = _$createElement("text"), _el$11 = _$createElement("span"), _el$12 = _$createElement("span"), _el$13 = _$createElement("b");
+    var _el$1 = _$createElement("box"), _el$10 = _$createElement("text"), _el$11 = _$createElement("span"), _el$12 = _$createElement("span"), _el$13 = _$createElement("b"), _el$14 = _$createElement("span"), _el$15 = _$createTextNode(` v`);
     _$insertNode(_el$1, _el$10);
     var _ref$ = boxEl;
     typeof _ref$ === "function" ? _$use(_ref$, _el$1) : boxEl = _el$1;
@@ -286,23 +413,28 @@ function GoUsagePanel(props) {
     });
     _$insertNode(_el$10, _el$11);
     _$insertNode(_el$10, _el$12);
+    _$insertNode(_el$10, _el$14);
     _$setProp(_el$10, "onMouseUp", () => setOpen((o) => !o));
     _$insert(_el$11, () => open() ? "\u25BC " : "\u25B6 ");
     _$insertNode(_el$12, _el$13);
-    _$insertNode(_el$13, _$createTextNode(`Go \u7528\u91CF`));
+    _$insert(_el$13, () => t("panelTitle"));
+    _$insertNode(_el$14, _el$15);
+    _$insert(_el$14, VERSION, null);
     _$insert(_el$10, _$createComponent(Show, {
       get when() {
         return _$memo(() => !!!open())() && usage();
       },
       get children() {
-        var _el$15 = _$createElement("span"), _el$16 = _$createTextNode(`  \u5468 `), _el$18 = _$createTextNode(`%`);
-        _$insertNode(_el$15, _el$16);
-        _$insertNode(_el$15, _el$18);
-        _$insert(_el$15, () => usage().weeklyUsage.usagePercent, _el$18);
-        _$effect((_$p) => _$setProp(_el$15, "style", {
+        var _el$16 = _$createElement("span"), _el$17 = _$createTextNode(`  `), _el$18 = _$createTextNode(` `), _el$19 = _$createTextNode(`%`);
+        _$insertNode(_el$16, _el$17);
+        _$insertNode(_el$16, _el$18);
+        _$insertNode(_el$16, _el$19);
+        _$insert(_el$16, () => t("weeklyShort"), _el$18);
+        _$insert(_el$16, () => usage().weeklyUsage.usagePercent, _el$19);
+        _$effect((_$p) => _$setProp(_el$16, "style", {
           fg: colorFor(usage().weeklyUsage.usagePercent)
         }, _$p));
-        return _el$15;
+        return _el$16;
       }
     }), null);
     _$insert(_el$1, _$createComponent(Show, {
@@ -311,23 +443,23 @@ function GoUsagePanel(props) {
       },
       get children() {
         return [(() => {
-          var _el$19 = _$createElement("text");
-          _$insert(_el$19, sep);
-          _$effect((_$p) => _$setProp(_el$19, "fg", colors().muted, _$p));
-          return _el$19;
+          var _el$20 = _$createElement("text");
+          _$insert(_el$20, sep);
+          _$effect((_$p) => _$setProp(_el$20, "fg", colors().muted, _$p));
+          return _el$20;
         })(), _$createComponent(Show, {
           get when() {
             return !configured();
           },
           get children() {
             return [(() => {
-              var _el$20 = _$createElement("text");
-              _$insertNode(_el$20, _$createTextNode(`\u672A\u914D\u7F6E\u8D26\u53F7`));
-              _$effect((_$p) => _$setProp(_el$20, "fg", colors().warning, _$p));
-              return _el$20;
+              var _el$21 = _$createElement("text");
+              _$insert(_el$21, () => t("notConfigured"));
+              _$effect((_$p) => _$setProp(_el$21, "fg", colors().warning, _$p));
+              return _el$21;
             })(), (() => {
               var _el$22 = _$createElement("text");
-              _$insertNode(_el$22, _$createTextNode(`\u8F93\u5165 /go-config \u8BBE\u7F6E`));
+              _$insert(_el$22, () => t("notConfiguredHint"));
               _$effect((_$p) => _$setProp(_el$22, "fg", colors().muted, _$p));
               return _el$22;
             })()];
@@ -347,49 +479,50 @@ function GoUsagePanel(props) {
                     return configured();
                   },
                   get children() {
-                    var _el$31 = _$createElement("text");
-                    _$insertNode(_el$31, _$createTextNode(`\u52A0\u8F7D\u4E2D...`));
-                    _$effect((_$p) => _$setProp(_el$31, "fg", colors().muted, _$p));
-                    return _el$31;
+                    var _el$29 = _$createElement("text");
+                    _$insert(_el$29, () => t("loading"));
+                    _$effect((_$p) => _$setProp(_el$29, "fg", colors().muted, _$p));
+                    return _el$29;
                   }
                 });
               },
               get children() {
-                return [_$memo(() => renderRow("5\u5C0F\u65F6\u7528\u91CF", usage().rollingUsage)), _$memo(() => renderRow("\u6BCF\u5468\u7528\u91CF", usage().weeklyUsage)), _$memo(() => renderRow("\u6BCF\u6708\u7528\u91CF", usage().monthlyUsage)), (() => {
-                  var _el$27 = _$createElement("text"), _el$28 = _$createElement("span"), _el$30 = _$createElement("span");
-                  _$insertNode(_el$27, _el$28);
-                  _$insertNode(_el$27, _el$30);
-                  _$insertNode(_el$28, _$createTextNode(`\u6700\u8FD1\u66F4\u65B0 `));
-                  _$insert(_el$30, lastUpdated);
+                return [_$memo(() => renderRow(t("rowRolling"), usage().rollingUsage)), _$memo(() => renderRow(t("rowWeekly"), usage().weeklyUsage)), _$memo(() => renderRow(t("rowMonthly"), usage().monthlyUsage)), (() => {
+                  var _el$25 = _$createElement("text"), _el$26 = _$createElement("span"), _el$27 = _$createTextNode(` `), _el$28 = _$createElement("span");
+                  _$insertNode(_el$25, _el$26);
+                  _$insertNode(_el$25, _el$28);
+                  _$insertNode(_el$26, _el$27);
+                  _$insert(_el$26, () => t("updatedAt"), _el$27);
+                  _$insert(_el$28, lastUpdated);
                   _$effect((_p$) => {
-                    var _v$8 = {
+                    var _v$9 = {
                       fg: colors().muted
-                    }, _v$9 = {
+                    }, _v$0 = {
                       fg: colors().muted
                     };
-                    _v$8 !== _p$.e && (_p$.e = _$setProp(_el$28, "style", _v$8, _p$.e));
-                    _v$9 !== _p$.t && (_p$.t = _$setProp(_el$30, "style", _v$9, _p$.t));
+                    _v$9 !== _p$.e && (_p$.e = _$setProp(_el$26, "style", _v$9, _p$.e));
+                    _v$0 !== _p$.t && (_p$.t = _$setProp(_el$28, "style", _v$0, _p$.t));
                     return _p$;
                   }, {
                     e: void 0,
                     t: void 0
                   });
-                  return _el$27;
+                  return _el$25;
                 })()];
               }
             });
           },
           get children() {
             return [(() => {
+              var _el$23 = _$createElement("text");
+              _$insert(_el$23, error);
+              _$effect((_$p) => _$setProp(_el$23, "fg", colors().error, _$p));
+              return _el$23;
+            })(), (() => {
               var _el$24 = _$createElement("text");
-              _$insert(_el$24, error);
-              _$effect((_$p) => _$setProp(_el$24, "fg", colors().error, _$p));
+              _$insert(_el$24, () => t("reconfigureHint"));
+              _$effect((_$p) => _$setProp(_el$24, "fg", colors().muted, _$p));
               return _el$24;
-            })(), (() => {
-              var _el$25 = _$createElement("text");
-              _$insertNode(_el$25, _$createTextNode(`\u8F93\u5165 /go-config \u91CD\u65B0\u914D\u7F6E`));
-              _$effect((_$p) => _$setProp(_el$25, "fg", colors().muted, _$p));
-              return _el$25;
             })()];
           }
         })];
@@ -400,15 +533,19 @@ function GoUsagePanel(props) {
         fg: colors().muted
       }, _v$7 = {
         fg: colors().primary
+      }, _v$8 = {
+        fg: colors().muted
       };
       _v$5 !== _p$.e && (_p$.e = _$setProp(_el$1, "borderColor", _v$5, _p$.e));
       _v$6 !== _p$.t && (_p$.t = _$setProp(_el$11, "style", _v$6, _p$.t));
       _v$7 !== _p$.a && (_p$.a = _$setProp(_el$12, "style", _v$7, _p$.a));
+      _v$8 !== _p$.o && (_p$.o = _$setProp(_el$14, "style", _v$8, _p$.o));
       return _p$;
     }, {
       e: void 0,
       t: void 0,
-      a: void 0
+      a: void 0,
+      o: void 0
     });
     return _el$1;
   })();
@@ -428,63 +565,121 @@ function createSidebarSlot(api) {
     }
   };
 }
-var tui = async (api) => {
-  api.slots.register(createSidebarSlot(api));
-  api.command?.register(() => [{
-    title: "Go Usage: Configure",
-    value: "go-usage.config",
-    description: "\u8BBE\u7F6E OpenCode Go workspace ID \u548C auth cookie",
-    slash: {
-      name: "go-config"
+function runConfigDialog(api, dialog) {
+  dialog?.replace(() => _$createComponent(api.ui.DialogPrompt, {
+    get title() {
+      return t("wsPromptTitle");
     },
-    onSelect: (dialog) => {
+    description: () => (() => {
+      var _el$30 = _$createElement("text");
+      _$insert(_el$30, () => t("wsPromptDesc"));
+      return _el$30;
+    })(),
+    get placeholder() {
+      return t("wsPlaceholder");
+    },
+    onConfirm: (value) => {
+      const wsId = value.trim();
+      if (!wsId) {
+        dialog?.clear();
+        return;
+      }
+      saveConfig({
+        workspace_id: wsId
+      });
       dialog?.replace(() => _$createComponent(api.ui.DialogPrompt, {
-        title: "\u8F93\u5165 workspace_id",
+        get title() {
+          return t("cookiePromptTitle");
+        },
         description: () => (() => {
-          var _el$33 = _$createElement("text");
-          _$insertNode(_el$33, _$createTextNode(`\u5728 opencode.ai \u63A7\u5236\u53F0 URL \u4E2D\u83B7\u53D6\uFF08wrk_ \u5F00\u5934\uFF09`));
-          return _el$33;
+          var _el$31 = _$createElement("text");
+          _$insert(_el$31, () => t("cookiePromptDesc"));
+          return _el$31;
         })(),
-        placeholder: "wrk_xxxxxxxxxxxx",
-        onConfirm: (value) => {
-          const wsId = value.trim();
-          if (!wsId) {
+        get placeholder() {
+          return t("cookiePlaceholder");
+        },
+        onConfirm: (val) => {
+          const cookie = val.trim();
+          if (!cookie) {
             dialog?.clear();
             return;
           }
           saveConfig({
-            workspace_id: wsId
+            cookie
           });
-          dialog?.replace(() => _$createComponent(api.ui.DialogPrompt, {
-            title: "\u8F93\u5165 auth cookie",
-            description: () => (() => {
-              var _el$35 = _$createElement("text");
-              _$insertNode(_el$35, _$createTextNode(`\u767B\u5F55 opencode.ai \u540E\uFF0C\u6D4F\u89C8\u5668 F12 \u2192 Application \u2192 Cookies \u2192 opencode.ai \u2192 \u590D\u5236 auth \u7684\u503C`));
-              return _el$35;
-            })(),
-            placeholder: "Fe26.2*...",
-            onConfirm: (val) => {
-              const cookie = val.trim();
-              if (!cookie) {
-                dialog?.clear();
-                return;
-              }
-              saveConfig({
-                cookie
-              });
-              setConfigTick((v) => v + 1);
-              api.ui.toast({
-                variant: "success",
-                message: "Go \u7528\u91CF\u914D\u7F6E\u5DF2\u4FDD\u5B58"
-              });
-              dialog?.clear();
-            },
-            onCancel: () => dialog?.clear()
-          }));
+          setConfigTick((v) => v + 1);
+          api.ui.toast({
+            variant: "success",
+            message: t("configSaved")
+          });
+          dialog?.clear();
         },
         onCancel: () => dialog?.clear()
       }));
-    }
+    },
+    onCancel: () => dialog?.clear()
+  }));
+}
+function runLangDialog(api, dialog) {
+  dialog?.replace(() => _$createComponent(api.ui.DialogSelect, {
+    get title() {
+      return t("langTitle");
+    },
+    get options() {
+      return LANG_META.map((m) => ({
+        title: `${m.label}${langCode() === m.code ? " \u2713" : ""}`,
+        value: m.code
+      }));
+    },
+    onSelect: (opt) => {
+      const code = opt.value;
+      setLangCode(code);
+      kvTrySet(api, `${KV_PREFIX}.lang`, code);
+      api.ui.toast({
+        message: code === "zh" ? t("langSwitchedZh") : t("langSwitchedEn")
+      });
+      const cfg = loadConfig();
+      if (!cfg.workspaceId || !cfg.authCookie) {
+        runConfigDialog(api, dialog);
+      } else {
+        dialog?.clear();
+      }
+    },
+    onCancel: () => dialog?.clear()
+  }));
+}
+var tui = async (api) => {
+  api.slots.register(createSidebarSlot(api));
+  const savedLang = kvTryGet(api, `${KV_PREFIX}.lang`);
+  if (savedLang === "zh" || savedLang === "en") setLangCode(savedLang);
+  else setLangCode(detectLang());
+  const onboarded = kvTryGet(api, `${KV_PREFIX}.onboarded`);
+  if (!onboarded) {
+    kvTrySet(api, `${KV_PREFIX}.onboarded`, "1");
+    setTimeout(() => {
+      try {
+        api.command.trigger("go-usage.lang");
+      } catch {
+      }
+    }, 1500);
+  }
+  api.command?.register(() => [{
+    title: t("cmdTitle"),
+    value: "go-usage.config",
+    description: t("cmdDesc"),
+    slash: {
+      name: "go-config"
+    },
+    onSelect: (dialog) => runConfigDialog(api, dialog)
+  }, {
+    title: t("langCmdTitle"),
+    value: "go-usage.lang",
+    description: t("langCmdDesc"),
+    slash: {
+      name: "go-lang"
+    },
+    onSelect: (dialog) => runLangDialog(api, dialog)
   }]);
 };
 var mod = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-go-usage-tui",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "OpenCode TUI plugin displaying OpenCode Go usage in the sidebar",
   "type": "module",
   "exports": {
@@ -15,7 +15,8 @@
     "dist",
     "src",
     "build.tui.mjs",
-    "README.md"
+    "README.md",
+    "README_EN.md"
   ],
   "scripts": {
     "build": "bun run build.tui.mjs",

package/src/i18n.ts

@@ -0,0 +1,108 @@
+export type LangCode = "zh" | "en"
+
+const ZH_T = {
+  panelTitle: "Go 用量",
+  rowRolling: "5小时用量",
+  rowWeekly: "每周用量",
+  rowMonthly: "每月用量",
+  weeklyShort: "周",
+  updatedAt: "最近更新",
+  notConfigured: "未配置账号",
+  notConfiguredHint: "输入 /go-config 设置",
+  loading: "加载中...",
+  queryFailed: "查询失败",
+  cookieExpired: "cookie 已过期",
+  reconfigureHint: "输入 /go-config 重新配置",
+  resetDone: "已重置",
+  dayHour: "{d}天{h}小时",
+  hourMin: "{h}小时{m}分钟",
+  minute: "{m}分钟",
+  cmdTitle: "Go Usage: Configure",
+  cmdDesc: "设置 OpenCode Go workspace ID 和 auth cookie",
+  wsPromptTitle: "输入 workspace_id",
+  wsPromptDesc: "在 opencode.ai 控制台 URL 中获取（wrk_ 开头）",
+  wsPlaceholder: "wrk_xxxxxxxxxxxx",
+  cookiePromptTitle: "输入 auth cookie",
+  cookiePromptDesc: "登录 opencode.ai 后，浏览器 F12 → Application → Cookies → opencode.ai → 复制 auth 的值",
+  cookiePlaceholder: "Fe26.2*...",
+  configSaved: "Go 用量配置已保存",
+  langTitle: "显示语言",
+  langCmdTitle: "Go Usage: Language",
+  langCmdDesc: "切换显示语言 | Switch display language",
+  langSwitchedZh: "已切换为中文",
+  langSwitchedEn: "Switched to English",
+  onboardLangTitle: "Welcome to Go Usage / 欢迎使用 Go 用量",
+  onboardLangDesc: "Choose display language / 选择显示语言",
+  onboardConfigTitle: "Welcome to Go Usage / 欢迎使用 Go 用量",
+  onboardConfigDesc: "First-time setup / 首次使用需配置账号",
+  setupCanceled: "已取消配置，输入 /go-config 可重新设置",
+} as const
+
+export type Translation = { [K in keyof typeof ZH_T]: string }
+
+const EN_T: Translation = {
+  panelTitle: "Go Usage",
+  rowRolling: "5h usage",
+  rowWeekly: "Weekly",
+  rowMonthly: "Monthly",
+  weeklyShort: "Wk",
+  updatedAt: "Updated",
+  notConfigured: "Not configured",
+  notConfiguredHint: "Run /go-config to set up",
+  loading: "Loading...",
+  queryFailed: "Query failed",
+  cookieExpired: "Cookie expired",
+  reconfigureHint: "Run /go-config to reconfigure",
+  resetDone: "Reset",
+  dayHour: "{d}d {h}h",
+  hourMin: "{h}h {m}m",
+  minute: "{m}m",
+  cmdTitle: "Go Usage: Configure",
+  cmdDesc: "Set OpenCode Go workspace ID and auth cookie",
+  wsPromptTitle: "Enter workspace_id",
+  wsPromptDesc: "Get it from the opencode.ai console URL (starts with wrk_)",
+  wsPlaceholder: "wrk_xxxxxxxxxxxx",
+  cookiePromptTitle: "Enter auth cookie",
+  cookiePromptDesc: "After logging into opencode.ai, press F12 → Application → Cookies → opencode.ai → copy the auth value",
+  cookiePlaceholder: "Fe26.2*...",
+  configSaved: "Go usage config saved",
+  langTitle: "Display language",
+  langCmdTitle: "Go Usage: Language",
+  langCmdDesc: "切换显示语言 | Switch display language",
+  langSwitchedZh: "已切换为中文",
+  langSwitchedEn: "Switched to English",
+  onboardLangTitle: "Welcome to Go Usage / 欢迎使用 Go 用量",
+  onboardLangDesc: "Choose display language / 选择显示语言",
+  onboardConfigTitle: "Welcome to Go Usage / 欢迎使用 Go 用量",
+  onboardConfigDesc: "First-time setup / 首次使用需配置账号",
+  setupCanceled: "Setup canceled, run /go-config to reconfigure",
+}
+
+export const LANGS: Record<LangCode, Translation> = { zh: ZH_T, en: EN_T }
+
+export const LANG_META: { code: LangCode; label: string }[] = [
+  { code: "zh", label: "中文" },
+  { code: "en", label: "English" },
+]
+
+export function applyParams(tpl: string, params?: Record<string, string | number>): string {
+  if (!params) return tpl
+  return tpl.replace(/\{(\w+)\}/g, (m, k: string) =>
+    k in params ? String(params[k]) : m,
+  )
+}
+
+export function createT(getCode: () => LangCode) {
+  return (key: keyof Translation, params?: Record<string, string | number>): string =>
+    applyParams(LANGS[getCode()][key], params)
+}
+
+export function detectLang(): LangCode {
+  try {
+    const loc = Intl.DateTimeFormat().resolvedOptions().locale.toLowerCase()
+    if (loc.startsWith("zh")) return "zh"
+    return "en"
+  } catch {
+    return "en"
+  }
+}

package/src/index.tsx

@@ -12,15 +12,19 @@ import { createSignal, createEffect, onMount, onCleanup, Show } from "solid-js"
 import type { JSX } from "@opentui/solid"
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs"
 import { join, dirname } from "node:path"
+import { createT, detectLang, LANG_META } from "./i18n"
+import type { LangCode } from "./i18n"
 
 declare const process: { env: Record<string, string | undefined> } | undefined
 
+const VERSION: string = __PLUGIN_VERSION__
 const CHECK_INTERVAL = Number(process?.env?.OPENCODE_GO_CHECK_INTERVAL ?? 60000)
 const WARN_THRESHOLD = Number(process?.env?.OPENCODE_GO_WARN_THRESHOLD ?? 0.8)
 const CONFIG_DIR = process?.env?.OPENCODE_CONFIG_DIR
   || (process?.env?.USERPROFILE ? `${process.env.USERPROFILE}\\.config\\opencode` : "")
   || process?.env?.HOME + "/.config/opencode"
 const CONFIG_FILE = join(CONFIG_DIR, "go-usage-config.json")
+const KV_PREFIX = "go-usage"
 
 function loadConfig(): { workspaceId: string; authCookie: string } {
   const env = process?.env ?? {}
@@ -58,6 +62,17 @@ function saveConfig(patch: { workspace_id?: string; cookie?: string }): void {
 // 模块级共享信号：/go-config 保存配置后递增，面板监听它立即刷新
 const [configTick, setConfigTick] = createSignal(0)
 
+// 模块级共享语言信号：/go-lang 或首次引导切换后，面板和命令实时响应
+const [langCode, setLangCode] = createSignal<LangCode>(detectLang())
+const t = createT(() => langCode())
+
+function kvTryGet(api: TuiPluginApi, key: string): string | undefined {
+  try { return api.kv.get<string>(key) } catch { return undefined }
+}
+function kvTrySet(api: TuiPluginApi, key: string, val: unknown): void {
+  try { api.kv.set(key, val) } catch { /* 忽略 */ }
+}
+
 interface Usage {
   rollingUsage: { usagePercent: number; resetInSec: number }
   weeklyUsage: { usagePercent: number; resetInSec: number }
@@ -107,13 +122,13 @@ async function fetchUsage(workspaceId: string, authCookie: string): Promise<Usag
 }
 
 function formatReset(sec: number): string {
-  if (sec <= 0) return "已重置"
+  if (sec <= 0) return t("resetDone")
   const d = Math.floor(sec / 86400)
   const h = Math.floor((sec % 86400) / 3600)
   const m = Math.floor((sec % 3600) / 60)
-  if (d > 0) return `${d}天${h}小时`
-  if (h > 0) return `${h}小时${m}分钟`
-  return `${m}分钟`
+  if (d > 0) return t("dayHour", { d, h })
+  if (h > 0) return t("hourMin", { h, m })
+  return t("minute", { m })
 }
 
 function progressBar(percent: number, width: number): string {
@@ -175,8 +190,8 @@ function GoUsagePanel(props: { theme: TuiThemeCurrent; api: TuiPluginApi }): JSX
     }
     setConfigured(true)
     const u = await fetchUsage(cfg.workspaceId, cfg.authCookie)
-    if (u === null) { setError("查询失败"); return }
-    if (u.error === "cookie_expired") { setError("cookie 已过期"); return }
+    if (u === null) { setError(t("queryFailed")); return }
+    if (u.error === "cookie_expired") { setError(t("cookieExpired")); return }
     if (u.error === "not_configured") { setConfigured(false); return }
     setUsage(u)
     setLastUpdated(new Date().toLocaleTimeString())
@@ -196,10 +211,10 @@ function GoUsagePanel(props: { theme: TuiThemeCurrent; api: TuiPluginApi }): JSX
 
   const [pal, setPal] = createSignal<Record<string, string>>({ ...FALLBACK })
   createEffect(() => {
-    const t = props.theme as any
+    const th = props.theme as any
     const p: Record<string, string> = { ...FALLBACK }
     for (const k of Object.keys(FALLBACK)) {
-      const h = hex(t?.[k])
+      const h = hex(th?.[k])
       if (h) p[k] = h
     }
     setPal(p)
@@ -250,10 +265,11 @@ function GoUsagePanel(props: { theme: TuiThemeCurrent; api: TuiPluginApi }): JSX
     >
       <text onMouseUp={() => setOpen(o => !o)}>
         <span style={{ fg: colors().muted }}>{open() ? "\u25bc " : "\u25b6 "}</span>
-        <span style={{ fg: colors().primary }}><b>Go 用量</b></span>
+        <span style={{ fg: colors().primary }}><b>{t("panelTitle")}</b></span>
+        <span style={{ fg: colors().muted }}> v{VERSION}</span>
         <Show when={!open() && usage()}>
           <span style={{ fg: colorFor(usage()!.weeklyUsage.usagePercent) }}>
-            {" ".repeat(2)}周 {usage()!.weeklyUsage.usagePercent}%
+            {" ".repeat(2)}{t("weeklyShort")} {usage()!.weeklyUsage.usagePercent}%
           </span>
         </Show>
       </text>
@@ -262,25 +278,25 @@ function GoUsagePanel(props: { theme: TuiThemeCurrent; api: TuiPluginApi }): JSX
         <text fg={colors().muted}>{sep()}</text>
 
         <Show when={!configured()}>
-          <text fg={colors().warning}>未配置账号</text>
-          <text fg={colors().muted}>输入 /go-config 设置</text>
+          <text fg={colors().warning}>{t("notConfigured")}</text>
+          <text fg={colors().muted}>{t("notConfiguredHint")}</text>
         </Show>
 
         <Show when={configured() && error()} fallback={
           <Show when={configured() && usage()} fallback={
-            <Show when={configured()}><text fg={colors().muted}>加载中...</text></Show>
+            <Show when={configured()}><text fg={colors().muted}>{t("loading")}</text></Show>
           }>
-            {renderRow("5小时用量", usage()!.rollingUsage)}
-            {renderRow("每周用量", usage()!.weeklyUsage)}
-            {renderRow("每月用量", usage()!.monthlyUsage)}
+            {renderRow(t("rowRolling"), usage()!.rollingUsage)}
+            {renderRow(t("rowWeekly"), usage()!.weeklyUsage)}
+            {renderRow(t("rowMonthly"), usage()!.monthlyUsage)}
             <text>
-              <span style={{ fg: colors().muted }}>最近更新 </span>
+              <span style={{ fg: colors().muted }}>{t("updatedAt")} </span>
               <span style={{ fg: colors().muted }}>{lastUpdated()}</span>
             </text>
           </Show>
         }>
           <text fg={colors().error}>{error()}</text>
-          <text fg={colors().muted}>输入 /go-config 重新配置</text>
+          <text fg={colors().muted}>{t("reconfigureHint")}</text>
         </Show>
       </Show>
     </box>
@@ -298,50 +314,100 @@ function createSidebarSlot(api: TuiPluginApi): TuiSlotPlugin {
   }
 }
 
-const tui: TuiPlugin = async (api: TuiPluginApi) => {
-  api.slots.register(createSidebarSlot(api))
-
-  api.command?.register(() => [
-    {
-      title: "Go Usage: Configure",
-      value: "go-usage.config",
-      description: "设置 OpenCode Go workspace ID 和 auth cookie",
-      slash: { name: "go-config" },
-      onSelect: (dialog) => {
+function runConfigDialog(api: TuiPluginApi, dialog: any): void {
+  dialog?.replace(() => (
+    <api.ui.DialogPrompt
+      title={t("wsPromptTitle")}
+      description={() => (
+        <text>{t("wsPromptDesc")}</text>
+      )}
+      placeholder={t("wsPlaceholder")}
+      onConfirm={(value) => {
+        const wsId = value.trim()
+        if (!wsId) { dialog?.clear(); return }
+        saveConfig({ workspace_id: wsId })
         dialog?.replace(() => (
           <api.ui.DialogPrompt
-            title="输入 workspace_id"
+            title={t("cookiePromptTitle")}
             description={() => (
-              <text>在 opencode.ai 控制台 URL 中获取（wrk_ 开头）</text>
+              <text>{t("cookiePromptDesc")}</text>
             )}
-            placeholder="wrk_xxxxxxxxxxxx"
-            onConfirm={(value) => {
-              const wsId = value.trim()
-              if (!wsId) { dialog?.clear(); return }
-              saveConfig({ workspace_id: wsId })
-              dialog?.replace(() => (
-                <api.ui.DialogPrompt
-                  title="输入 auth cookie"
-                  description={() => (
-                    <text>登录 opencode.ai 后，浏览器 F12 → Application → Cookies → opencode.ai → 复制 auth 的值</text>
-                  )}
-                  placeholder="Fe26.2*..."
-                  onConfirm={(val) => {
-                    const cookie = val.trim()
-                    if (!cookie) { dialog?.clear(); return }
-                    saveConfig({ cookie })
-                    setConfigTick((v) => v + 1)
-                    api.ui.toast({ variant: "success", message: "Go 用量配置已保存" })
-                    dialog?.clear()
-                  }}
-                  onCancel={() => dialog?.clear()}
-                />
-              ))
+            placeholder={t("cookiePlaceholder")}
+            onConfirm={(val) => {
+              const cookie = val.trim()
+              if (!cookie) { dialog?.clear(); return }
+              saveConfig({ cookie })
+              setConfigTick((v) => v + 1)
+              api.ui.toast({ variant: "success", message: t("configSaved") })
+              dialog?.clear()
             }}
             onCancel={() => dialog?.clear()}
           />
         ))
-      },
+      }}
+      onCancel={() => dialog?.clear()}
+    />
+  ))
+}
+
+function runLangDialog(api: TuiPluginApi, dialog: any): void {
+  dialog?.replace(() => (
+    <api.ui.DialogSelect
+      title={t("langTitle")}
+      options={LANG_META.map((m) => ({
+        title: `${m.label}${langCode() === m.code ? " \u2713" : ""}`,
+        value: m.code,
+      }))}
+      onSelect={(opt) => {
+        const code = opt.value as LangCode
+        setLangCode(code)
+        kvTrySet(api, `${KV_PREFIX}.lang`, code)
+        api.ui.toast({ message: code === "zh" ? t("langSwitchedZh") : t("langSwitchedEn") })
+        // 语言选择后：若无配置则继续引导配置账号
+        const cfg = loadConfig()
+        if (!cfg.workspaceId || !cfg.authCookie) {
+          runConfigDialog(api, dialog)
+        } else {
+          dialog?.clear()
+        }
+      }}
+      onCancel={() => dialog?.clear()}
+    />
+  ))
+}
+
+const tui: TuiPlugin = async (api: TuiPluginApi) => {
+  api.slots.register(createSidebarSlot(api))
+
+  // 恢复已保存的语言；若无则按系统检测
+  const savedLang = kvTryGet(api, `${KV_PREFIX}.lang`) as LangCode | undefined
+  if (savedLang === "zh" || savedLang === "en") setLangCode(savedLang)
+  else setLangCode(detectLang())
+
+  // 首次启动引导：已引导过则跳过（用 kv 标记）
+  const onboarded = kvTryGet(api, `${KV_PREFIX}.onboarded`)
+  if (!onboarded) {
+    kvTrySet(api, `${KV_PREFIX}.onboarded`, "1")
+    setTimeout(() => {
+      // 通过 trigger 触发语言选择命令，命令 onSelect 会拿到 dialog 栈并弹窗
+      try { api.command.trigger("go-usage.lang") } catch { /* 命令未就绪时忽略 */ }
+    }, 1500)
+  }
+
+  api.command?.register(() => [
+    {
+      title: t("cmdTitle"),
+      value: "go-usage.config",
+      description: t("cmdDesc"),
+      slash: { name: "go-config" },
+      onSelect: (dialog) => runConfigDialog(api, dialog),
+    },
+    {
+      title: t("langCmdTitle"),
+      value: "go-usage.lang",
+      description: t("langCmdDesc"),
+      slash: { name: "go-lang" },
+      onSelect: (dialog) => runLangDialog(api, dialog),
     },
   ])
 }