dsh-opencode-go-usage 1.1.0 → 1.2.1

package/lib/client.js

@@ -37,7 +37,8 @@ window.__ModuleLoader__.load({
 				".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);
 		}
@@ -45,7 +46,7 @@ window.__ModuleLoader__.load({
 		// ── locale dictionaries ──
 		const NS = "dsh-opencode-go-usage";
 		const zh = {
-			"window.rolling": "滚动窗口",
+			"window.rolling": "滚动窗口 (5h)",
 			"window.weekly": "周窗口",
 			"window.monthly": "月窗口",
 			"window.rolling.hint": "5 小时",
@@ -57,7 +58,9 @@ window.__ModuleLoader__.load({
 			"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)",
@@ -72,7 +75,9 @@ window.__ModuleLoader__.load({
 			"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 ──
@@ -194,6 +199,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.0",
+  "version": "1.2.1",
   "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",