dsh-cloudq 0.2.0 → 0.2.1

package/lib/client.js

@@ -408,6 +408,46 @@ linear-gradient(-30deg, transparent 49.5%, #2c2c31 49.5%, #2c2c31 50.5%, transpa
   overflow: hidden;
   text-overflow: ellipsis;
 }
+/* Outdated-plugin badge appended after the sidebar button label. */
+.dsh-cloudq-version-badge {
+  position: relative;
+  flex: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 16px;
+  height: 16px;
+  margin-left: 6px;
+  border-radius: 50%;
+  background: var(--dsw-alias-state-warning, #d18400);
+  color: #fff;
+  font-size: 11px;
+  font-weight: 700;
+  line-height: 16px;
+  cursor: pointer;
+}
+.dsh-cloudq-version-badge.is-busy {
+  opacity: .7;
+  cursor: default;
+}
+.dsh-cloudq-version-badge__tip {
+  display: none;
+  position: fixed;
+  z-index: 1000;
+  padding: 6px 10px;
+  border-radius: 6px;
+  background: rgba(20, 24, 31, .92);
+  color: #fff;
+  font-size: 12px;
+  font-weight: 400;
+  line-height: 18px;
+  white-space: nowrap;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, .18);
+}
+.dsh-cloudq-version-badge:hover .dsh-cloudq-version-badge__tip,
+.dsh-cloudq-version-badge:focus .dsh-cloudq-version-badge__tip {
+  display: block;
+}
 /* Persisted CloudQ marker shown on rows whose session id is in the registry. */
 .dsh-cloudq-session-badge {
   flex: none;
@@ -773,6 +813,75 @@ linear-gradient(-30deg, transparent 49.5%, #2c2c31 49.5%, #2c2c31 50.5%, transpa
 				if (button) button.remove();
 			};
 		}
+		const API_VERSION = "/api/dsh-cloudq/version";
+		const API_UPDATE = "/api/dsh-cloudq/update";
+		const API_RESTART = "/api/dsh-cloudq/restart";
+		let cloudqOutdatedInfo = null;
+		let cloudqSelfUpdateRunning = false;
+		function positionVersionTip(badge, tip) {
+			const rect = badge.getBoundingClientRect();
+			tip.style.left = `${Math.max(8, rect.left)}px`;
+			tip.style.top = `${rect.bottom + 6}px`;
+			tip.style.bottom = "auto";
+		}
+		/** Append the "!" badge after the sidebar button label (retries while the
+		*  button is not mounted yet). The button node is reused across sidebar
+		*  re-mounts, so a child badge survives them. */
+		function attachVersionBadge(attempt = 0) {
+			if (!cloudqOutdatedInfo) return;
+			const button = document.getElementById("dsh-cloudq-sidebar-entry");
+			if (!button) {
+				if (attempt < 20) window.setTimeout(() => attachVersionBadge(attempt + 1), 500);
+				return;
+			}
+			if (button.querySelector(".dsh-cloudq-version-badge")) return;
+			const badge = document.createElement("span");
+			badge.className = "dsh-cloudq-version-badge";
+			badge.dataset.testid = "cloudq-version-badge";
+			badge.textContent = "!";
+			badge.setAttribute("role", "button");
+			badge.setAttribute("aria-label", `CloudQ 插件有新版本 ${cloudqOutdatedInfo.latest}，点击更新`);
+			const tip = document.createElement("span");
+			tip.className = "dsh-cloudq-version-badge__tip";
+			tip.textContent = `当前版本 ${cloudqOutdatedInfo.current} 不是最新版本 ${cloudqOutdatedInfo.latest}，点击自动更新`;
+			badge.appendChild(tip);
+			badge.addEventListener("mouseenter", () => positionVersionTip(badge, tip));
+			badge.addEventListener("click", (event) => {
+				event.preventDefault();
+				event.stopPropagation();
+				runCloudqSelfUpdate(badge, tip);
+			});
+			button.appendChild(badge);
+		}
+		/** Badge click flow: update → restart host → wait for it → reload page. */
+		async function runCloudqSelfUpdate(badge, tip) {
+			if (cloudqSelfUpdateRunning) return;
+			cloudqSelfUpdateRunning = true;
+			badge.classList.add("is-busy");
+			tip.textContent = "正在更新到最新版本…";
+			try {
+				await cloudqRequest(API_UPDATE, { method: "POST" }, 15e4);
+			} catch (error) {
+				tip.textContent = `更新失败：${error.message}`;
+				badge.classList.remove("is-busy");
+				cloudqSelfUpdateRunning = false;
+				return;
+			}
+			tip.textContent = "更新完成，正在重启 DSH 服务…";
+			try {
+				await cloudqRequest(API_RESTART, { method: "POST" }, 5e3);
+			} catch {}
+			const sleep = (ms) => new Promise((resolvePromise) => window.setTimeout(resolvePromise, ms));
+			const deadline = Date.now() + 6e4;
+			while (Date.now() < deadline) try {
+				await cloudqRequest(API_VERSION, void 0, 3e3);
+				window.location.reload();
+				return;
+			} catch {
+				await sleep(1e3);
+			}
+			tip.textContent = "服务重启超时，请手动重启 DSH 后刷新页面。";
+		}
 		/** Build the exact visible row order from Host workspace membership. */
 		function orderedVisibleSessions(snapshot, workspaces, sortByUpdated) {
 			const archived = new Set(workspaces?.archivedSessionIds ?? []);
@@ -3276,7 +3385,7 @@ display: none;
 					});
 				} catch (error) {
 					setValidated(false);
-					const invalid = error instanceof CloudQApiError && error.code !== "network-error" && error.code !== "invalid-response";
+					const invalid = error instanceof CloudQApiError && error.code !== "network-error" && error.code !== "invalid-response" && error.code !== "script-launch-failed";
 					setFeedback({
 						kind: "error",
 						text: invalid ? "AKSK 无效，请检查后重新配置。" : error.message
@@ -3696,6 +3805,20 @@ display: none;
 					}
 				});
 			}, "dsh-cloudq: refresh artifacts on turn completion");
+			ctx.effect(() => {
+				let disposed = false;
+				cloudqRequest(API_VERSION).then((data) => {
+					if (disposed || data?.outdated !== true || typeof data?.latest !== "string") return;
+					cloudqOutdatedInfo = {
+						current: String(data.current ?? ""),
+						latest: data.latest
+					};
+					attachVersionBadge();
+				}).catch(() => {});
+				return () => {
+					disposed = true;
+				};
+			}, "dsh-cloudq: version check");
 			ctx.effect(() => {
 				const markIfCloudqClaim = () => {
 					const textarea = document.querySelector("textarea[class*=input]");

package/lib/index.js

@@ -1,11 +1,12 @@
 import { createRequire } from "node:module";
+import { spawn, spawnSync } from "node:child_process";
 import { existsSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { get } from "node:https";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import Schema from "@deepseek-ai/schemastery";
 import { Buffer as Buffer$1 } from "node:buffer";
 import yaml from "js-yaml";
-import { spawn } from "node:child_process";
 //#region src/http.js
 /** Maximum accepted JSON request body size. */
 const MAX_JSON_BODY_BYTES = 65536;
@@ -147,13 +148,13 @@ function readJsonBody(request, { maxBytes = MAX_JSON_BODY_BYTES } = {}) {
 //#region src/plugin-manager.js
 /** Host-side management of optional profile bundle entries. */
 const PROTECTED_BUNDLES = /* @__PURE__ */ new Set(["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app"]);
-function profileDirectory(baseUrl) {
+function profileDirectory$1(baseUrl) {
 	const url = new URL(".", baseUrl);
 	if (url.protocol !== "file:") throw new Error("The active DSH profile URL must use the file protocol.");
 	return fileURLToPath(url);
 }
 function patchPath(baseUrl) {
-	return resolve(profileDirectory(baseUrl), "cordis.patch.yml");
+	return resolve(profileDirectory$1(baseUrl), "cordis.patch.yml");
 }
 function parsePatchList(content) {
 	if (!content.trim()) return [];
@@ -226,7 +227,7 @@ function writePatchAtomically(path, content, originalSnapshot) {
 * @returns {Array<{id: string, name: string, bundle: string, disabled: boolean, self: boolean}>}
 */
 function listPlugins(baseUrl) {
-	const profileDir = profileDirectory(baseUrl);
+	const profileDir = profileDirectory$1(baseUrl);
 	const userPatchPath = patchPath(baseUrl);
 	const overrides = (existsSync(userPatchPath) ? parsePatchList(readFileSync(userPatchPath, "utf8")) : []).filter((entry) => entry && typeof entry === "object" && typeof entry.id === "string");
 	const plugins = [];
@@ -289,6 +290,24 @@ function setPluginDisabled(baseUrl, id, disabled) {
 //#endregion
 //#region src/script-runner.js
 const MAX_SCRIPT_OUTPUT_BYTES = 1048576;
+let resolvedPythonCommand = null;
+function pythonCommand() {
+	if (resolvedPythonCommand) return resolvedPythonCommand;
+	for (const candidate of [
+		"python3",
+		"python",
+		"py"
+	]) try {
+		if (spawnSync(candidate, ["--version"], {
+			stdio: "ignore",
+			timeout: 5e3
+		}).status === 0) {
+			resolvedPythonCommand = candidate;
+			return candidate;
+		}
+	} catch {}
+	return "python3";
+}
 function safeCode(value) {
 	return typeof value === "string" && /^[a-zA-Z0-9._-]{1,80}$/.test(value) ? value : "script-failed";
 }
@@ -307,7 +326,8 @@ function redact(value, sensitiveValues) {
 */
 function runScript$1(scriptsDirectory, scriptName, args, { timeoutMs = 3e4, jsonOnly = true, stdin, sensitiveValues = [], spawnProcess = spawn } = {}) {
 	return new Promise((resolveRun, rejectRun) => {
-		const child = spawnProcess("python3", [resolve(scriptsDirectory, scriptName), ...args], {
+		const script = resolve(scriptsDirectory, scriptName);
+		const child = spawnProcess(pythonCommand(), [script, ...args], {
 			stdio: [
 				stdin === void 0 ? "ignore" : "pipe",
 				"pipe",
@@ -346,7 +366,7 @@ function runScript$1(scriptsDirectory, scriptName, args, { timeoutMs = 3e4, json
 			stderr = collect(stderr, chunk);
 		});
 		child.on("error", () => {
-			rejectOnce(new HttpError(502, "script-launch-failed", "The CloudQ helper could not be started."));
+			rejectOnce(new HttpError(502, "script-launch-failed", "无法启动 Python 运行环境，请先安装 Python 3 后重试。"));
 		});
 		child.on("close", (code) => {
 			if (settled) return;
@@ -405,6 +425,121 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 function skillDirectory() {
 	return resolve(__dirname, "../skills/cloudq");
 }
+/** This plugin's own version, read from the installed package manifest. */
+const PACKAGE_VERSION = (() => {
+	try {
+		return JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf8"))?.version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+})();
+/**
+* Profile directory holding this plugin (`<profile>/node_modules/dsh-cloudq`).
+* Both src/ (dev) and lib/ (packed) sit one level under the package root.
+*/
+function profileDirectory() {
+	return resolve(__dirname, "../../..");
+}
+/** Fetch the latest published version from the npm registry (best effort). */
+function fetchLatestPackageVersion() {
+	return new Promise((resolvePromise) => {
+		const request = get("https://registry.npmjs.org/dsh-cloudq/latest", { timeout: 8e3 }, (res) => {
+			if (res.statusCode !== 200) {
+				res.resume();
+				resolvePromise(null);
+				return;
+			}
+			let body = "";
+			res.on("data", (chunk) => {
+				body += chunk;
+				if (body.length > 65536) request.destroy();
+			});
+			res.on("end", () => {
+				try {
+					resolvePromise(JSON.parse(body)?.version ?? null);
+				} catch {
+					resolvePromise(null);
+				}
+			});
+		});
+		request.on("error", () => resolvePromise(null));
+		request.on("timeout", () => {
+			request.destroy();
+			resolvePromise(null);
+		});
+	});
+}
+let latestVersionCache = {
+	at: 0,
+	version: null
+};
+async function latestPackageVersion() {
+	if (latestVersionCache.version && Date.now() - latestVersionCache.at < 6e5) return latestVersionCache.version;
+	const version = await fetchLatestPackageVersion();
+	if (version) latestVersionCache = {
+		at: Date.now(),
+		version
+	};
+	return version;
+}
+/** Semver-ish compare: is `latest` strictly newer than `current`? */
+function isNewerVersion(latest, current) {
+	const parse = (value) => String(value).split(".").map((part) => parseInt(part, 10) || 0);
+	const next = parse(latest);
+	const now = parse(current);
+	for (let index = 0; index < 3; index += 1) if (next[index] !== now[index]) return next[index] > now[index];
+	return false;
+}
+const UPDATE_TIMEOUT_MS = 12e4;
+/** Install the latest published plugin version into the active profile. */
+function runProfileUpdate() {
+	return new Promise((resolveRun, rejectRun) => {
+		const child = spawn("pnpm", [
+			"add",
+			"dsh-cloudq@latest",
+			"--registry=https://registry.npmjs.org/"
+		], { cwd: profileDirectory() });
+		let output = "";
+		const collect = (chunk) => {
+			output += chunk;
+			if (output.length > 65536) child.kill();
+		};
+		child.stdout.on("data", collect);
+		child.stderr.on("data", collect);
+		const timer = setTimeout(() => {
+			child.kill();
+			rejectRun(new HttpError(504, "update-timeout", "更新超时，请检查网络后重试。"));
+		}, UPDATE_TIMEOUT_MS);
+		child.on("error", () => {
+			clearTimeout(timer);
+			rejectRun(new HttpError(502, "update-failed", "无法启动 pnpm，请在终端手动执行：dsh plugin --profile web add dsh-cloudq"));
+		});
+		child.on("close", (code) => {
+			clearTimeout(timer);
+			if (code === 0) resolveRun();
+			else rejectRun(new HttpError(502, "update-failed", `更新失败：${output.trim().slice(-200) || "pnpm 执行异常"}`));
+		});
+	});
+}
+/**
+* Restart the DSH host after an update. A detached watcher respawns the same
+* command line the moment this process exits; there is no supervisor, so the
+* plugin exits itself once the watcher is armed.
+*/
+function scheduleSelfRestart() {
+	if (process.platform === "win32") throw new HttpError(501, "restart-unsupported", "当前系统不支持自动重启，请手动重启 DSH 服务。");
+	const quote = (value) => `'${String(value).replaceAll("'", "'\\''")}'`;
+	const command = [
+		`while kill -0 ${process.pid} 2>/dev/null; do sleep 0.5; done`,
+		"sleep 1",
+		`cd ${quote(process.cwd())} && nohup ${quote(process.argv[0])} ${process.argv.slice(1).map(quote).join(" ")} >> /tmp/dsh-cloudq-restart.log 2>&1 &`
+	].join("; ");
+	spawn("/bin/sh", ["-c", command], {
+		detached: true,
+		stdio: "ignore"
+	}).unref();
+	setTimeout(() => process.exit(0), 300).unref();
+}
 /** Raw SKILL.md body. */
 function rawSkillContent() {
 	return readFileSync(resolve(skillDirectory(), "SKILL.md"), "utf8");
@@ -676,6 +811,53 @@ function apply(ctx) {
 				}
 			}
 		}));
+		disposers.push(ctx.webServer.register({
+			kind: "exact",
+			path: "/api/dsh-cloudq/version",
+			handler: async (request, response) => {
+				try {
+					assertSafeRequest(request, "GET");
+					const latest = await latestPackageVersion();
+					sendJson(response, 200, {
+						ok: true,
+						current: PACKAGE_VERSION,
+						latest,
+						outdated: latest !== null && isNewerVersion(latest, PACKAGE_VERSION)
+					});
+				} catch (error) {
+					sendError(response, error);
+				}
+			}
+		}));
+		disposers.push(ctx.webServer.register({
+			kind: "exact",
+			path: "/api/dsh-cloudq/update",
+			handler: async (request, response) => {
+				try {
+					assertSafeRequest(request, "POST");
+					await runProfileUpdate();
+					sendJson(response, 200, { ok: true });
+				} catch (error) {
+					sendError(response, error);
+				}
+			}
+		}));
+		disposers.push(ctx.webServer.register({
+			kind: "exact",
+			path: "/api/dsh-cloudq/restart",
+			handler: async (request, response) => {
+				try {
+					assertSafeRequest(request, "POST");
+					sendJson(response, 200, {
+						ok: true,
+						restarting: true
+					});
+					scheduleSelfRestart();
+				} catch (error) {
+					sendError(response, error);
+				}
+			}
+		}));
 		disposers.push(ctx.webServer.register({
 			kind: "exact",
 			path: "/api/dsh-cloudq/credential/test",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cloudq",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CloudQ integration for DeepSeek Harness with secure credential, workspace, and plugin-management surfaces",
   "license": "MIT",
   "type": "module",