dsh-opencode-go-usage 1.0.1 → 1.1.0

package/lib/client.js

@@ -6,7 +6,8 @@
 // (react / react/jsx-runtime are in the static table). It registers a widget
 // into the sidebar's `sidebar.footer.action` list slot and polls the
 // same-origin proxy route owned by the host half — the GO API key never
-// enters the browser.
+// enters the browser. UI strings are bilingual via the DSH locale service
+// (dictionaries registered under the `dsh-opencode-go-usage` namespace).
 window.__ModuleLoader__.load({
 	id: "dsh-opencode-go-usage",
 	factory: (require) => {
@@ -41,24 +42,57 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 
+		// ── locale dictionaries ──
+		const NS = "dsh-opencode-go-usage";
+		const zh = {
+			"window.rolling": "滚动窗口",
+			"window.weekly": "周窗口",
+			"window.monthly": "月窗口",
+			"window.rolling.hint": "5 小时",
+			"status.ok": "正常",
+			"time.soon": "即将重置",
+			"time.minutes": "{n} 分后重置",
+			"time.hours": "{n} 小时 {m} 分后",
+			"time.days": "{n} 天 {m} 小时后",
+			"refresh": "刷新",
+			"loading": "加载中…",
+			"rail.title": "OpenCode GO 月用量 {pct}%",
+			"rail.plain": "OpenCode GO"
+		};
+		const en = {
+			"window.rolling": "Rolling (5h)",
+			"window.weekly": "Weekly",
+			"window.monthly": "Monthly",
+			"window.rolling.hint": "5 hours",
+			"status.ok": "OK",
+			"time.soon": "resets soon",
+			"time.minutes": "in {n} min",
+			"time.hours": "in {n}h {m}m",
+			"time.days": "in {n}d {m}h",
+			"refresh": "Refresh",
+			"loading": "Loading…",
+			"rail.title": "OpenCode GO monthly {pct}%",
+			"rail.plain": "OpenCode GO"
+		};
+
 		// ── data helpers ──
 		const WINDOWS = [
-			{ key: "rolling", label: "滚动窗口", hint: "5 小时" },
-			{ key: "weekly", label: "周窗口" },
-			{ key: "monthly", label: "月窗口" }
+			{ key: "rolling", labelKey: "window.rolling", hintKey: "window.rolling.hint" },
+			{ key: "weekly", labelKey: "window.weekly", hintKey: null },
+			{ key: "monthly", labelKey: "window.monthly", hintKey: null }
 		];
 
-		/** Short human relative time until `iso`. */
-		function timeUntil(iso) {
+		/** Short human relative time until `iso`, localized. */
+		function timeUntil(iso, t) {
 			const target = new Date(iso).getTime();
 			if (!Number.isFinite(target)) return "";
 			const diff = target - Date.now();
-			if (diff <= 0) return "即将重置";
+			if (diff <= 0) return t("time.soon");
 			const mins = Math.floor(diff / 60000);
-			if (mins < 60) return mins + " 分后重置";
+			if (mins < 60) return t("time.minutes", { n: mins });
 			const hours = Math.floor(mins / 60);
-			if (hours < 24) return hours + " 小时 " + (mins % 60) + " 分后";
-			return Math.floor(hours / 24) + " 天 " + (hours % 24) + " 小时后";
+			if (hours < 24) return t("time.hours", { n: hours, m: mins % 60 });
+			return t("time.days", { n: Math.floor(hours / 24), m: hours % 24 });
 		}
 
 		/** Fill color by usage percent. */
@@ -70,10 +104,12 @@ window.__ModuleLoader__.load({
 
 		// ── widget component ──
 		/**
-		 * @param {{ wide?: boolean }} props - owner share from the sidebar
-		 * (`sidebar.footer.action` is rendered with `{ wide }`).
+		 * @param {{ wide?: boolean, t?: Function }} props - owner share from the
+		 * sidebar (`sidebar.footer.action` is rendered with `{ wide }`) plus the
+		 * locale translate seat declared by this registration.
 		 */
 		function Widget(props) {
+			const t = props.t || ((key) => key);
 			const [data, setData] = react.useState(null);
 			const [error, setError] = react.useState(null);
 			const [stamp, setStamp] = react.useState(0);
@@ -110,7 +146,7 @@ window.__ModuleLoader__.load({
 			if (!props.wide) {
 				return react_jsx_runtime.jsx("div", {
 					className: "ocg-rail",
-					title: error ? ("OpenCode GO: " + error) : (pct === null ? "OpenCode GO" : "OpenCode GO 月用量 " + pct + "%"),
+					title: error ? ("OpenCode GO: " + error) : (pct === null ? t("rail.plain") : t("rail.title", { pct: pct })),
 					children: pct === null ? "GO" : pct + "%"
 				});
 			}
@@ -126,8 +162,8 @@ window.__ModuleLoader__.load({
 						react_jsx_runtime.jsx("div", {
 							className: "ocg-row-label",
 							children: [
-								react_jsx_runtime.jsx("b", { children: w.label }),
-								react_jsx_runtime.jsx("span", { children: (win.resetsAt ? timeUntil(win.resetsAt) : w.hint) })
+								react_jsx_runtime.jsx("b", { children: t(w.labelKey) }),
+								react_jsx_runtime.jsx("span", { children: (win.resetsAt ? timeUntil(win.resetsAt, t) : (w.hintKey ? t(w.hintKey) : "")) })
 							]
 						}),
 						react_jsx_runtime.jsx("div", {
@@ -143,7 +179,7 @@ window.__ModuleLoader__.load({
 						react_jsx_runtime.jsx("div", {
 							className: "ocg-row-label",
 							children: [
-								react_jsx_runtime.jsx("span", { children: win.status === "ok" ? "正常" : win.status }),
+								react_jsx_runtime.jsx("span", { children: win.status === "ok" ? t("status.ok") : win.status }),
 								react_jsx_runtime.jsx("span", { children: win.percent + "%" })
 							]
 						})
@@ -161,26 +197,28 @@ window.__ModuleLoader__.load({
 							react_jsx_runtime.jsx("button", {
 								className: "ocg-refresh",
 								onClick: () => setStamp(stamp + 1),
-								children: "刷新"
+								children: t("refresh")
 							})
 						]
 					}),
 					error ? react_jsx_runtime.jsx("div", { className: "ocg-err", children: error }) : null,
-					!error && data === null ? react_jsx_runtime.jsx("div", { className: "ocg-err", children: "加载中…" }) : null,
+					!error && data === null ? react_jsx_runtime.jsx("div", { className: "ocg-err", children: t("loading") }) : null,
 					rows.length > 0 ? react_jsx_runtime.jsx(react.Fragment, { children: rows }) : null
 				]
 			});
 		}
 
 		// ── cordis plugin entry ──
-		const inject = ["slots"];
+		const inject = ["slots", "locale"];
 
 		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "dsh-opencode-go-usage: dictionaries");
 			ctx.effect(() => ctx.slots.register({
 				name: "sidebar.footer.action",
 				id: "dsh-opencode-go-usage",
 				order: 0,
-				label: "OpenCode GO 用量"
+				label: "OpenCode GO",
+				locale: NS
 			}, Widget), "dsh-opencode-go-usage: widget registration");
 		}
 

package/lib/index.js

@@ -75,21 +75,24 @@ async function fetchUsage(baseUrl, apiKey) {
 	return await res.json();
 }
 
-/** Human-friendly chat output. */
-function renderUsageText(data) {
+/** Human-friendly chat output, localized (zh | en). */
+function renderUsageText(data, lang) {
+	const zh = lang !== "en";
 	const u = data?.usage;
 	if (!u || typeof u !== "object") return "OpenCode GO: unexpected response shape.";
-	const lines = ["OpenCode GO 套餐用量:"];
+	const lines = [zh ? "OpenCode GO 套餐用量:" : "OpenCode GO plan usage:"];
 	const defs = [
-		["rolling", "滚动窗口 (5h)"],
-		["weekly", "周窗口"],
-		["monthly", "月窗口"]
+		["rolling", zh ? "滚动窗口 (5h)" : "Rolling (5h)"],
+		["weekly", zh ? "周窗口" : "Weekly"],
+		["monthly", zh ? "月窗口" : "Monthly"]
 	];
 	for (const [key, label] of defs) {
 		const w = u[key];
 		if (!w || typeof w.percent !== "number") continue;
-		const status = w.status === "ok" ? "正常" : w.status;
-		const resets = w.resetsAt ? `重置于 ${new Date(w.resetsAt).toLocaleString("zh-CN")}` : "";
+		const status = w.status === "ok" ? (zh ? "正常" : "ok") : w.status;
+		const resets = w.resetsAt
+			? (zh ? `重置于 ${new Date(w.resetsAt).toLocaleString("zh-CN")}` : `resets at ${new Date(w.resetsAt).toLocaleString("en-US")}`)
+			: "";
 		lines.push(`  ${label}: ${w.percent}% (${status})${resets ? `, ${resets}` : ""}`);
 	}
 	return lines.join("\n");
@@ -140,10 +143,14 @@ export function apply(ctx, rawConfig = {}) {
 
 	const readConfig = () => {
 		const stored = ctx.settings.get(namespace) ?? {};
+		// DSH's own locale preference ("locale.preference": zh | en); absent
+		// falls back to zh (the browser decides when the user never picked).
+		const locale = ctx.settings.get("locale")?.preference ?? "zh";
 		return {
 			apiKeyEnv: stored.apiKeyEnv,
 			baseUrl: stored.baseUrl,
-			cacheMs: stored.cacheMs
+			cacheMs: stored.cacheMs,
+			locale
 		};
 	};
 
@@ -157,7 +164,11 @@ export function apply(ctx, rawConfig = {}) {
 		if (quotaCache !== null && now - quotaCache.at < config.cacheMs) return quotaCache.promise;
 		const promise = (async () => {
 			const key = await resolveApiKey(ctx, config.apiKeyEnv);
-			if (key === null) throw new Error(`OpenCode GO: no API key (set credential ${config.apiKeyEnv})`);
+			if (key === null) {
+				throw new Error(config.locale === "en"
+					? `OpenCode GO: no API key (set credential ${config.apiKeyEnv})`
+					: `OpenCode GO: 未配置 API key(在 credential ${config.apiKeyEnv} 中设置)`);
+			}
 			return await fetchUsage(config.baseUrl, key);
 		})();
 		quotaCache = { at: now, promise };
@@ -225,7 +236,7 @@ export function apply(ctx, rawConfig = {}) {
 		handler: async () => {
 			try {
 				const data = await quotaOnce();
-				return { kind: "success", text: renderUsageText(data) };
+				return { kind: "success", text: renderUsageText(data, readConfig().locale) };
 			} catch (error) {
 				return { kind: "error", text: error instanceof Error ? error.message : String(error) };
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opencode-go-usage",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "DSH (DeepSeek Harness) plugin: OpenCode GO plan quota widget in the sidebar, same-origin usage proxy, and a /opencode-go chat command",
   "type": "module",
   "main": "lib/index.js",