dsh-opencode-go-usage 1.1.1 → 1.2.2

package/README.md

@@ -2,6 +2,8 @@
 
 English | [中文](README.zh.md)
 
+> ⚡ Get an **OpenCode GO plan**: [buycodingplan.com](https://buycodingplan.com/)
+
 A [DSH](https://github.com/deepseek-ai/deepseek-harness) (DeepSeek Harness) plugin that watches your **OpenCode GO plan** quota — the $10/month subscription that gives you usage limits on open-source models (rolling 5-hour, weekly, and monthly windows).
 
 ## Features

package/README.zh.md

@@ -2,6 +2,8 @@
 
 [English](README.md) | 中文
 
+> ⚡ **OpenCode GO 套餐**: [buycodingplan.com](https://buycodingplan.com/)
+
 [DSH](https://github.com/deepseek-ai/deepseek-harness)(DeepSeek Harness)插件:监控你的 **OpenCode GO 套餐**额度 —— 10 美元/月的订阅,按模型提供滚动 5 小时 / 每周 / 每月三个窗口的用量限额。
 
 ## 功能

package/lib/client.js

@@ -25,19 +25,23 @@ window.__ModuleLoader__.load({
 			tag.dataset.plugin = "dsh-opencode-go-usage";
 			tag.dataset.pluginCss = CSS_ID;
 			tag.textContent = [
-				".ocg-widget{box-sizing:border-box;width:100%;min-width:0;padding:8px 6px;display:flex;flex-direction:column;gap:6px;border-top:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}",
+				".ocg-widget{box-sizing:border-box;width:100%;min-width:0;padding:6px 6px 4px;display:flex;flex-direction:column;gap:4px;border-top:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}",
 				".ocg-widget:hover{background:var(--dsw-alias-interactive-bg-hover)}",
 				".ocg-head{display:flex;align-items:center;justify-content:space-between;gap:8px;font-size:12px;font-weight:600;line-height:18px}",
 				".ocg-refresh{cursor:pointer;border:none;background:none;padding:0;color:var(--dsw-alias-label-secondary);font-size:11px;line-height:18px}",
 				".ocg-refresh:hover{color:var(--dsw-alias-label-primary)}",
 				".ocg-row{display:flex;flex-direction:column;gap:3px;min-width:0}",
-				".ocg-row-label{display:flex;justify-content:space-between;gap:8px;font-size:11px;line-height:16px;color:var(--dsw-alias-label-secondary)}",
+				".ocg-row-label{display:flex;justify-content:space-between;gap:8px;font-size:11px;line-height:15px;color:var(--dsw-alias-label-secondary)}",
 				".ocg-row-label b{font-weight:500;color:var(--dsw-alias-label-primary)}",
+				".ocg-meta{display:flex;align-items:center;gap:6px;min-width:0}",
+				".ocg-meta .ocg-track{flex:1;min-width:0}",
+				".ocg-meta>span{font-size:10px;line-height:14px;color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none}",
 				".ocg-track{box-sizing:border-box;height:5px;border-radius:3px;background:var(--dsw-alias-border-l2);overflow:hidden}",
 				".ocg-fill{height:100%;border-radius:3px;transition:width .4s ease}",
 				".ocg-err{font-size:11px;line-height:16px;color:var(--dsw-alias-label-secondary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
 				".ocg-rail{box-sizing:border-box;width:36px;height:36px;display:flex;align-items:center;justify-content:center;border-radius:8px;font-size:10px;font-weight:700;color:var(--dsw-alias-label-primary);cursor:default}",
-				".ocg-rail:hover{background:var(--dsw-alias-interactive-bg-hover)}"
+				".ocg-rail:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+				".ocg-update{display:inline-block;padding:1px 6px;border-radius:8px;font-size:10px;line-height:16px;font-weight:600;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover);text-decoration:none;cursor:pointer;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:110px}"
 			].join("");
 			document.head.appendChild(tag);
 		}
@@ -48,31 +52,33 @@ window.__ModuleLoader__.load({
 			"window.rolling": "滚动窗口 (5h)",
 			"window.weekly": "周窗口",
 			"window.monthly": "月窗口",
-			"window.rolling.hint": "5 小时",
-			"status.ok": "正常",
+			"window.rolling.hint": "5h",
 			"time.soon": "即将重置",
-			"time.minutes": "{n} 分后重置",
-			"time.hours": "{n} 小时 {m} 分后",
-			"time.days": "{n} 天 {m} 小时后",
+			"time.minutes": "{n}分",
+			"time.hours": "{n}小时{m}分",
+			"time.days": "{n}天{m}小时",
 			"refresh": "刷新",
 			"loading": "加载中…",
 			"rail.title": "OpenCode GO 月用量 {pct}%",
-			"rail.plain": "OpenCode GO"
+			"rail.plain": "OpenCode GO",
+			"update.available": "新版本 v{v}",
+			"update.title": "点击查看升级说明"
 		};
 		const en = {
 			"window.rolling": "Rolling (5h)",
 			"window.weekly": "Weekly",
 			"window.monthly": "Monthly",
-			"window.rolling.hint": "5 hours",
-			"status.ok": "OK",
+			"window.rolling.hint": "5h",
 			"time.soon": "resets soon",
-			"time.minutes": "in {n} min",
-			"time.hours": "in {n}h {m}m",
-			"time.days": "in {n}d {m}h",
+			"time.minutes": "{n}m",
+			"time.hours": "{n}h{m}m",
+			"time.days": "{n}d{m}h",
 			"refresh": "Refresh",
 			"loading": "Loading…",
 			"rail.title": "OpenCode GO monthly {pct}%",
-			"rail.plain": "OpenCode GO"
+			"rail.plain": "OpenCode GO",
+			"update.available": "v{v} available",
+			"update.title": "Click for upgrade instructions"
 		};
 
 		// ── data helpers ──
@@ -95,11 +101,11 @@ window.__ModuleLoader__.load({
 			return t("time.days", { n: Math.floor(hours / 24), m: hours % 24 });
 		}
 
-		/** Fill color by usage percent. */
+		/** Fill color by usage percent — themed alias tokens (light/dark safe). */
 		function fillColor(percent) {
-			if (percent >= 90) return "#ff3b30";
-			if (percent >= 70) return "#ff9500";
-			return "#34c759";
+			if (percent >= 90) return "var(--dsw-alias-state-error-primary)";
+			if (percent >= 70) return "var(--dsw-alias-state-warn-primary)";
+			return "var(--dsw-alias-state-success-primary)";
 		}
 
 		// ── widget component ──
@@ -159,28 +165,34 @@ window.__ModuleLoader__.load({
 				rows.push(react_jsx_runtime.jsx("div", {
 					className: "ocg-row",
 					children: [
+						// Name + percentage on one line (percentage right-aligned).
 						react_jsx_runtime.jsx("div", {
 							className: "ocg-row-label",
 							children: [
 								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("b", { children: win.percent + "%" })
 							]
 						}),
+						// Track + countdown on one line (track flexes, countdown
+						// right-aligned small text; status replaces it when not ok).
 						react_jsx_runtime.jsx("div", {
-							className: "ocg-track",
-							children: react_jsx_runtime.jsx("div", {
-								className: "ocg-fill",
-								style: {
-									width: Math.max(0, Math.min(100, win.percent)) + "%",
-									background: fillColor(win.percent)
-								}
-							})
-						}),
-						react_jsx_runtime.jsx("div", {
-							className: "ocg-row-label",
+							className: "ocg-meta",
 							children: [
-								react_jsx_runtime.jsx("span", { children: win.status === "ok" ? t("status.ok") : win.status }),
-								react_jsx_runtime.jsx("span", { children: win.percent + "%" })
+								react_jsx_runtime.jsx("div", {
+									className: "ocg-track",
+									children: react_jsx_runtime.jsx("div", {
+										className: "ocg-fill",
+										style: {
+											width: Math.max(0, Math.min(100, win.percent)) + "%",
+											background: fillColor(win.percent)
+										}
+									})
+								}),
+								react_jsx_runtime.jsx("span", {
+									children: win.status === "ok"
+										? (win.resetsAt ? timeUntil(win.resetsAt, t) : (w.hintKey ? t(w.hintKey) : ""))
+										: win.status
+								})
 							]
 						})
 					]
@@ -194,6 +206,16 @@ window.__ModuleLoader__.load({
 						className: "ocg-head",
 						children: [
 							react_jsx_runtime.jsx("span", { children: "OpenCode GO" }),
+							(data && data.update && data.update.available && data.update.latest
+								? react_jsx_runtime.jsx("a", {
+									className: "ocg-update",
+									href: "https://www.npmjs.com/package/dsh-opencode-go-usage",
+									target: "_blank",
+									rel: "noreferrer",
+									title: t("update.title"),
+									children: t("update.available", { v: data.update.latest })
+								})
+								: null),
 							react_jsx_runtime.jsx("button", {
 								className: "ocg-refresh",
 								onClick: () => setStamp(stamp + 1),

package/lib/index.js

@@ -23,9 +23,12 @@
  *     settings.
  *
  * Settings namespace `dsh-opencode-go-usage`:
- *   - apiKeyEnv: credential ref / env var for the API key (default OPENCODE_GO_API_KEY)
- *   - baseUrl:   GO gateway base (default https://opencode.ai/zen/go)
- *   - cacheMs:   host-side cache TTL (default 30000)
+ *   - apiKeyEnv:    credential ref / env var for the API key (default OPENCODE_GO_API_KEY)
+ *   - baseUrl:      GO gateway base (default https://opencode.ai/zen/go)
+ *   - cacheMs:      host-side cache TTL (default 30000)
+ *   - updateCheck:  check npm for newer versions (default true); result shows
+ *                   in the widget and the command — the plugin never installs
+ *                   itself, upgrading stays an explicit user action.
  */
 
 import { readFileSync } from "node:fs";
@@ -43,12 +46,43 @@ export const namespace = "dsh-opencode-go-usage";
 const DEFAULT_BASE_URL = "https://opencode.ai/zen/go";
 const DEFAULT_API_KEY_ENV = "OPENCODE_GO_API_KEY";
 const DEFAULT_CACHE_MS = 30_000;
+/** npm package name this plugin is published under (update checks). */
+const NPM_PACKAGE = "dsh-opencode-go-usage";
+/** How often the update check may hit the npm registry (ms). */
+const UPDATE_CHECK_INTERVAL_MS = 24 * 3600_000;
+
+/** The version this running copy was installed as (read once at load). */
+const CURRENT_VERSION = readPackageVersion();
+
+/** Read `version` from the installed package.json next to this file. */
+function readPackageVersion() {
+	try {
+		const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+		if (typeof pkg?.version === "string") return pkg.version;
+	} catch {
+		// fall through
+	}
+	return "0.0.0";
+}
+
+/** Compare two `x.y.z` version strings; returns true when `a` is newer than `b`. */
+function isNewer(a, b) {
+	const pa = String(a).split("-")[0].split(".").map(Number);
+	const pb = String(b).split("-")[0].split(".").map(Number);
+	for (let i = 0; i < 3; i++) {
+		const na = pa[i] ?? 0;
+		const nb = pb[i] ?? 0;
+		if (na !== nb) return na > nb;
+	}
+	return false;
+}
 
 /** Settings schema for this plugin's namespace. */
 export const Config = z.object({
 	apiKeyEnv: z.string().default(DEFAULT_API_KEY_ENV),
 	baseUrl: z.string().default(DEFAULT_BASE_URL),
-	cacheMs: z.number().default(DEFAULT_CACHE_MS)
+	cacheMs: z.number().default(DEFAULT_CACHE_MS),
+	updateCheck: z.boolean().default(true)
 });
 
 /**
@@ -150,10 +184,50 @@ export function apply(ctx, rawConfig = {}) {
 			apiKeyEnv: stored.apiKeyEnv,
 			baseUrl: stored.baseUrl,
 			cacheMs: stored.cacheMs,
+			updateCheck: stored.updateCheck !== false,
 			locale
 		};
 	};
 
+	// ── update check (npm) ─────────────────────────────────────────────────
+	// Checks the registry at most once per UPDATE_CHECK_INTERVAL_MS; failures
+	// are silent. The plugin only reports — upgrading stays a user action
+	// (`dsh plugin --profile web add dsh-opencode-go-usage@latest`).
+	/** @type {{ at: number, latest: string | null } | null} */
+	let updateState = null;
+	const checkForUpdate = async (config) => {
+		const now = Date.now();
+		if (updateState !== null && now - updateState.at < UPDATE_CHECK_INTERVAL_MS) return updateState;
+		const snapshot = { at: now, latest: null };
+		try {
+			const res = await fetch(`https://registry.npmjs.org/${NPM_PACKAGE}/latest`, {
+				signal: AbortSignal.timeout(10_000)
+			});
+			if (res.ok) {
+				const json = await res.json();
+				if (typeof json?.version === "string" && isNewer(json.version, CURRENT_VERSION)) {
+					snapshot.latest = json.version;
+				}
+			}
+		} catch {
+			// offline / registry hiccup — keep the previous result, refresh later
+			snapshot.at = updateState?.at ?? now;
+			snapshot.latest = updateState?.latest ?? null;
+		}
+		updateState = snapshot;
+		return snapshot;
+	};
+	const updateInfoOf = (config) => {
+		const st = updateState;
+		if (!config.updateCheck || st === null || st.latest === null) {
+			return { current: CURRENT_VERSION, available: false, latest: null };
+		}
+		return { current: CURRENT_VERSION, available: true, latest: st.latest };
+	};
+
+	// Kick off the first check shortly after boot (non-blocking).
+	void checkForUpdate(readConfig()).catch(() => {});
+
 	// Host-side cache: one in-flight promise + a TTL, so several open tabs or
 	// the command never hammer the gateway.
 	/** @type {{ at: number, promise: Promise<unknown> } | null} */
@@ -180,8 +254,12 @@ export function apply(ctx, rawConfig = {}) {
 		res.setHeader("content-type", "application/json; charset=utf-8");
 		res.setHeader("cache-control", "no-store");
 		try {
+			const config = readConfig();
+			// Trigger a background refresh when the interval elapsed (never
+			// block the response on the registry).
+			void checkForUpdate(config).catch(() => {});
 			const data = await quotaOnce();
-			res.end(JSON.stringify(data));
+			res.end(JSON.stringify({ ...data, update: updateInfoOf(config) }));
 		} catch (error) {
 			res.statusCode = 502;
 			res.end(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }));
@@ -235,8 +313,16 @@ export function apply(ctx, rawConfig = {}) {
 		description: "show OpenCode GO plan usage (rolling/weekly/monthly windows)",
 		handler: async () => {
 			try {
+				const config = readConfig();
 				const data = await quotaOnce();
-				return { kind: "success", text: renderUsageText(data, readConfig().locale) };
+				let text = renderUsageText(data, config.locale);
+				const update = updateInfoOf(config);
+				if (update.available && update.latest !== null) {
+					text += config.locale === "en"
+						? `\n\nUpdate available: v${update.latest} — run \`dsh plugin --profile web add ${NPM_PACKAGE}@latest\` to upgrade.`
+						: `\n\n发现新版本 v${update.latest} — 执行 \`dsh plugin --profile web add ${NPM_PACKAGE}@latest\` 升级。`;
+				}
+				return { kind: "success", text };
 			} 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.1.1",
+  "version": "1.2.2",
   "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",