dsh-cloudq 0.1.9 → 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 ?? []);
@@ -1014,7 +1123,9 @@ body.dsh-cloudq-mode-active [class*=composerHero] [class*=root][class*=hero] {
 }
 .dsh-cloudq-convo-chip {
   position: fixed;
-  top: 20px;
+  /* Below the conversation header divider (header bottom ≈76px) so the chip
+     never overlaps the Session log affordance in the title row. */
+  top: 88px;
   right: 16px;
   display: inline-flex;
   align-items: center;
@@ -1605,12 +1716,24 @@ body.dsh-cloudq-mode-active [class*=composerHero] [class*=root][class*=hero] {
 }
 .dsh-cloudq-artifact__download {
   justify-self: end;
+  padding: 0;
+  border: 0;
+  background: none;
   color: var(--dsw-alias-state-business-primary, #006eff);
+  font: inherit;
   text-decoration: none;
+  cursor: pointer;
 }
 .dsh-cloudq-artifact__download:hover {
   text-decoration: underline;
 }
+.dsh-cloudq-artifact__download:disabled {
+  cursor: default;
+  opacity: .6;
+}
+span.dsh-cloudq-artifact__download {
+  cursor: default;
+}
 /* architecture library */
 .dsh-cloudq-arch__toolbar {
   position: relative;
@@ -2036,12 +2159,10 @@ display: none;
 		let panelBody = null;
 		let panelView = "usage";
 		let panelExpanded = false;
-		let inspirationCache = null;
 		let inspirationCategory = 0;
-		let artifactCache = null;
-		let artifactTotal = 0;
-		let architectureDirectoriesCache = null;
-		let architectureFirstFolderId = null;
+		const artifactCollapsedSessions = /* @__PURE__ */ new Set();
+		let artifactRefreshTimer = 0;
+		let artifactRetryTimer = 0;
 		let architectureRequestSeq = 0;
 		let architecturePickerCleanup = null;
 		function renderUsageView() {
@@ -2345,17 +2466,12 @@ display: none;
 					list.appendChild(card);
 				}
 			};
-			if (inspirationCache) {
-				paint(inspirationCache);
-				return;
-			}
 			const hint = document.createElement("div");
 			hint.className = "dsh-cloudq-panel__hint";
 			hint.textContent = "正在加载灵感…";
 			list.appendChild(hint);
 			requireCloudqCredential().then(() => cloudqRequest(API_INSPIRATIONS)).then((data) => {
-				inspirationCache = Array.isArray(data.inspirations) ? data.inspirations : [];
-				paint(inspirationCache);
+				paint(Array.isArray(data.inspirations) ? data.inspirations : []);
 			}).catch((error) => {
 				if (!panelExpanded) return;
 				list.textContent = "";
@@ -2365,140 +2481,181 @@ display: none;
 				list.appendChild(err);
 			});
 		}
-		function renderArtifactView({ force = false } = {}) {
+		/**
+		* Refresh the artifact list in the background after a CloudQ conversation
+		* turn completes. Never shows the loading hint: the visible list stays
+		* untouched and is repainted synchronously once fresh data arrives. The
+		* delayed retry covers artifacts archived with a lag.
+		*/
+		function scheduleArtifactSilentRefresh() {
+			window.clearTimeout(artifactRefreshTimer);
+			window.clearTimeout(artifactRetryTimer);
+			const run = () => {
+				cloudqRequest(API_ARTIFACTS).then((data) => {
+					if (panelView !== "artifact" || !panelExpanded) return;
+					paintArtifactList(Array.isArray(data?.sessions) ? data.sessions : [], Number(data?.total) || 0);
+				}).catch(() => {});
+			};
+			artifactRefreshTimer = window.setTimeout(run, 3e3);
+			artifactRetryTimer = window.setTimeout(run, 15e3);
+		}
+		function paintArtifactList(sessions, total) {
+			if (panelView !== "artifact" || !panelExpanded) return;
 			panelBody.textContent = "";
-			const paint = (sessions, total) => {
-				if (panelView !== "artifact" || !panelExpanded) return;
-				panelBody.textContent = "";
-				const safeSessions = Array.isArray(sessions) ? sessions : [];
-				const artifactCount = safeSessions.reduce((sum, session) => {
-					return sum + (Array.isArray(session?.Artifacts) ? session.Artifacts : []).length;
-				}, 0);
-				const toolbar = document.createElement("div");
-				toolbar.className = "dsh-cloudq-artifact__toolbar";
-				const summary = document.createElement("span");
-				summary.textContent = `共 ${Number(total) || safeSessions.length} 组会话，${artifactCount} 个制品`;
-				const refresh = document.createElement("button");
-				refresh.type = "button";
-				refresh.className = "dsh-cloudq-artifact__refresh";
-				refresh.dataset.testid = "cloudq-artifact-refresh-btn";
-				refresh.textContent = "刷新";
-				refresh.addEventListener("click", () => {
-					artifactCache = null;
-					artifactTotal = 0;
-					renderArtifactView({ force: true });
-				});
-				toolbar.appendChild(summary);
-				toolbar.appendChild(refresh);
-				panelBody.appendChild(toolbar);
-				if (safeSessions.length === 0) {
-					const empty = document.createElement("div");
-					empty.className = "dsh-cloudq-usage__table__empty";
-					empty.textContent = "暂无制品";
-					panelBody.appendChild(empty);
-					return;
-				}
-				const list = document.createElement("div");
-				list.className = "dsh-cloudq-artifact__list";
-				const columns = document.createElement("div");
-				columns.className = "dsh-cloudq-artifact__columns";
-				for (const label of [
-					"报告名称",
-					"用户名称",
-					"生成时间",
-					"操作"
-				]) {
-					const cell = document.createElement("span");
-					cell.textContent = label;
-					columns.appendChild(cell);
-				}
-				list.appendChild(columns);
-				for (const session of safeSessions) {
-					const artifacts = Array.isArray(session?.Artifacts) ? session.Artifacts : [];
-					const group = document.createElement("section");
-					group.className = "dsh-cloudq-artifact__session";
-					const sessionHead = document.createElement("button");
-					sessionHead.type = "button";
-					sessionHead.className = "dsh-cloudq-artifact__session-head";
-					sessionHead.dataset.testid = `cloudq-artifact-session-${session?.SessionID ?? "unknown"}`;
-					sessionHead.setAttribute("aria-expanded", "true");
-					const chevron = document.createElement("span");
-					chevron.className = "dsh-cloudq-artifact__chevron";
-					chevron.textContent = "▼";
-					const title = document.createElement("span");
-					title.className = "dsh-cloudq-artifact__session-title";
-					title.textContent = session?.SessionTitle || "未命名会话";
-					title.title = title.textContent;
-					const latestTime = artifacts.reduce((latest, artifact) => {
-						const time = String(artifact?.ArchiveTime ?? "");
-						return time > latest ? time : latest;
-					}, "");
-					const meta = document.createElement("span");
-					meta.className = "dsh-cloudq-artifact__session-meta";
-					meta.textContent = `${artifacts.length} 个制品${latestTime ? ` · 最近 ${latestTime.slice(0, 10)}` : ""}`;
-					sessionHead.appendChild(chevron);
-					sessionHead.appendChild(title);
-					sessionHead.appendChild(meta);
-					const files = document.createElement("div");
-					files.className = "dsh-cloudq-artifact__files";
-					for (const artifact of artifacts) {
-						const row = document.createElement("div");
-						row.className = "dsh-cloudq-artifact__file";
-						const main = document.createElement("div");
-						main.className = "dsh-cloudq-artifact__file-main";
-						const type = document.createElement("span");
-						type.className = "dsh-cloudq-artifact__file-type";
-						type.textContent = artifact?.FileType || "file";
-						const name = document.createElement("span");
-						name.className = "dsh-cloudq-artifact__file-name";
-						name.textContent = artifact?.FileName || "未命名文件";
-						name.title = `${name.textContent} · ${formatFileSize(artifact?.SizeBytes)}`;
-						main.appendChild(type);
-						main.appendChild(name);
-						const owner = document.createElement("span");
-						owner.className = "dsh-cloudq-artifact__owner";
-						owner.textContent = artifact?.UserName || "—";
-						const time = document.createElement("span");
-						time.className = "dsh-cloudq-artifact__time";
-						time.textContent = formatDateTime(artifact?.ArchiveTime);
-						const downloadUrl = safeDownloadUrl(artifact?.DownloadURL);
-						const action = document.createElement(downloadUrl ? "a" : "span");
-						action.className = "dsh-cloudq-artifact__download";
-						action.textContent = downloadUrl ? "下载" : "不可用";
-						if (downloadUrl) {
-							action.href = downloadUrl;
-							action.target = "_blank";
-							action.rel = "noopener noreferrer";
-							action.dataset.testid = `cloudq-artifact-download-${artifact?.ArtifactID ?? "unknown"}`;
-						}
-						row.appendChild(main);
-						row.appendChild(owner);
-						row.appendChild(time);
-						row.appendChild(action);
-						files.appendChild(row);
+			const safeSessions = Array.isArray(sessions) ? sessions : [];
+			const artifactCount = safeSessions.reduce((sum, session) => {
+				return sum + (Array.isArray(session?.Artifacts) ? session.Artifacts : []).length;
+			}, 0);
+			const toolbar = document.createElement("div");
+			toolbar.className = "dsh-cloudq-artifact__toolbar";
+			const summary = document.createElement("span");
+			summary.textContent = `共 ${Number(total) || safeSessions.length} 组会话，${artifactCount} 个制品`;
+			const refresh = document.createElement("button");
+			refresh.type = "button";
+			refresh.className = "dsh-cloudq-artifact__refresh";
+			refresh.dataset.testid = "cloudq-artifact-refresh-btn";
+			refresh.textContent = "刷新";
+			refresh.addEventListener("click", () => renderArtifactView());
+			toolbar.appendChild(summary);
+			toolbar.appendChild(refresh);
+			panelBody.appendChild(toolbar);
+			if (safeSessions.length === 0) {
+				const empty = document.createElement("div");
+				empty.className = "dsh-cloudq-usage__table__empty";
+				empty.textContent = "暂无制品";
+				panelBody.appendChild(empty);
+				return;
+			}
+			const list = document.createElement("div");
+			list.className = "dsh-cloudq-artifact__list";
+			const columns = document.createElement("div");
+			columns.className = "dsh-cloudq-artifact__columns";
+			for (const label of [
+				"报告名称",
+				"用户名称",
+				"生成时间",
+				"操作"
+			]) {
+				const cell = document.createElement("span");
+				cell.textContent = label;
+				columns.appendChild(cell);
+			}
+			list.appendChild(columns);
+			for (const session of safeSessions) {
+				const artifacts = Array.isArray(session?.Artifacts) ? session.Artifacts : [];
+				const sessionKey = String(session?.SessionID ?? "");
+				const group = document.createElement("section");
+				group.className = "dsh-cloudq-artifact__session";
+				const startCollapsed = sessionKey !== "" && artifactCollapsedSessions.has(sessionKey);
+				if (startCollapsed) group.classList.add("is-collapsed");
+				const sessionHead = document.createElement("button");
+				sessionHead.type = "button";
+				sessionHead.className = "dsh-cloudq-artifact__session-head";
+				sessionHead.dataset.testid = `cloudq-artifact-session-${session?.SessionID ?? "unknown"}`;
+				sessionHead.setAttribute("aria-expanded", String(!startCollapsed));
+				const chevron = document.createElement("span");
+				chevron.className = "dsh-cloudq-artifact__chevron";
+				chevron.textContent = "▼";
+				const title = document.createElement("span");
+				title.className = "dsh-cloudq-artifact__session-title";
+				title.textContent = session?.SessionTitle || "未命名会话";
+				title.title = title.textContent;
+				const latestTime = artifacts.reduce((latest, artifact) => {
+					const time = String(artifact?.ArchiveTime ?? "");
+					return time > latest ? time : latest;
+				}, "");
+				const meta = document.createElement("span");
+				meta.className = "dsh-cloudq-artifact__session-meta";
+				meta.textContent = `${artifacts.length} 个制品${latestTime ? ` · 最近 ${latestTime.slice(0, 10)}` : ""}`;
+				sessionHead.appendChild(chevron);
+				sessionHead.appendChild(title);
+				sessionHead.appendChild(meta);
+				const files = document.createElement("div");
+				files.className = "dsh-cloudq-artifact__files";
+				for (const artifact of artifacts) {
+					const row = document.createElement("div");
+					row.className = "dsh-cloudq-artifact__file";
+					const main = document.createElement("div");
+					main.className = "dsh-cloudq-artifact__file-main";
+					const type = document.createElement("span");
+					type.className = "dsh-cloudq-artifact__file-type";
+					type.textContent = artifact?.FileType || "file";
+					const name = document.createElement("span");
+					name.className = "dsh-cloudq-artifact__file-name";
+					name.textContent = artifact?.FileName || "未命名文件";
+					name.title = `${name.textContent} · ${formatFileSize(artifact?.SizeBytes)}`;
+					main.appendChild(type);
+					main.appendChild(name);
+					const owner = document.createElement("span");
+					owner.className = "dsh-cloudq-artifact__owner";
+					owner.textContent = artifact?.UserName || "—";
+					const time = document.createElement("span");
+					time.className = "dsh-cloudq-artifact__time";
+					time.textContent = formatDateTime(artifact?.ArchiveTime);
+					const downloadUrl = safeDownloadUrl(artifact?.DownloadURL);
+					const fileName = artifact?.FileName || "未命名文件";
+					const action = document.createElement(downloadUrl ? "button" : "span");
+					action.className = "dsh-cloudq-artifact__download";
+					action.textContent = downloadUrl ? "下载" : "不可用";
+					if (downloadUrl) {
+						action.type = "button";
+						action.dataset.testid = `cloudq-artifact-download-${artifact?.ArtifactID ?? "unknown"}`;
+						action.addEventListener("click", () => {
+							if (action.disabled) return;
+							action.disabled = true;
+							action.textContent = "下载中…";
+							const restore = () => {
+								action.disabled = false;
+								action.textContent = "下载";
+							};
+							fetch(downloadUrl).then((res) => {
+								if (!res.ok) throw new Error(`download failed: ${res.status}`);
+								return res.blob();
+							}).then((blob) => {
+								const objectUrl = URL.createObjectURL(blob);
+								const link = document.createElement("a");
+								link.href = objectUrl;
+								link.download = fileName;
+								link.rel = "noopener noreferrer";
+								link.click();
+								window.setTimeout(() => URL.revokeObjectURL(objectUrl), 1e4);
+							}).catch(() => {
+								const link = document.createElement("a");
+								link.href = downloadUrl;
+								link.download = fileName;
+								link.rel = "noopener noreferrer";
+								link.click();
+							}).finally(restore);
+						});
 					}
-					sessionHead.addEventListener("click", () => {
-						const collapsed = group.classList.toggle("is-collapsed");
-						sessionHead.setAttribute("aria-expanded", String(!collapsed));
-					});
-					group.appendChild(sessionHead);
-					group.appendChild(files);
-					list.appendChild(group);
+					row.appendChild(main);
+					row.appendChild(owner);
+					row.appendChild(time);
+					row.appendChild(action);
+					files.appendChild(row);
 				}
-				panelBody.appendChild(list);
-			};
-			if (artifactCache !== null && !force) {
-				paint(artifactCache, artifactTotal);
-				return;
+				sessionHead.addEventListener("click", () => {
+					const collapsed = group.classList.toggle("is-collapsed");
+					sessionHead.setAttribute("aria-expanded", String(!collapsed));
+					if (sessionKey) {
+						if (collapsed) artifactCollapsedSessions.add(sessionKey);
+						else artifactCollapsedSessions.delete(sessionKey);
+					}
+				});
+				group.appendChild(sessionHead);
+				group.appendChild(files);
+				list.appendChild(group);
 			}
+			panelBody.appendChild(list);
+		}
+		function renderArtifactView() {
+			panelBody.textContent = "";
 			const hint = document.createElement("div");
 			hint.className = "dsh-cloudq-panel__hint";
 			hint.textContent = "正在加载制品…";
 			panelBody.appendChild(hint);
 			requireCloudqCredential().then(() => cloudqRequest(API_ARTIFACTS)).then((data) => {
-				artifactCache = Array.isArray(data?.sessions) ? data.sessions : [];
-				artifactTotal = Number(data?.total) || artifactCache.length;
-				paint(artifactCache, artifactTotal);
+				paintArtifactList(Array.isArray(data?.sessions) ? data.sessions : [], Number(data?.total) || 0);
 			}).catch((error) => {
 				if (panelView !== "artifact" || !panelExpanded) return;
 				panelBody.textContent = "";
@@ -2733,14 +2890,16 @@ display: none;
 						}
 						for (const architecture of architectures) {
 							const imageUrl = safeDownloadUrl(architecture?.SvgURL);
-							const card = document.createElement(imageUrl ? "a" : "article");
+							const archId = typeof architecture?.ArchId === "string" ? architecture.ArchId.trim() : "";
+							const consoleUrl = archId ? `https://console.cloud.tencent.com/advisor?archId=${encodeURIComponent(archId)}` : "";
+							const card = document.createElement(consoleUrl ? "a" : "article");
 							card.className = "dsh-cloudq-arch__card";
 							card.dataset.testid = `cloudq-architecture-card-${architecture?.ArchId ?? "unknown"}`;
-							if (imageUrl) {
-								card.href = imageUrl;
+							if (consoleUrl) {
+								card.href = consoleUrl;
 								card.target = "_blank";
 								card.rel = "noopener noreferrer";
-								card.setAttribute("aria-label", `查看架构图：${architecture?.ArchName || "未命名系统"}`);
+								card.setAttribute("aria-label", `打开架构图：${architecture?.ArchName || "未命名系统"}`);
 							}
 							const preview = document.createElement("div");
 							preview.className = "dsh-cloudq-arch__preview";
@@ -2759,7 +2918,7 @@ display: none;
 								image.addEventListener("load", () => placeholder.remove());
 								image.addEventListener("error", () => {
 									image.remove();
-									placeholder.textContent = "预览加载失败，点击可打开原图";
+									placeholder.textContent = consoleUrl ? "预览加载失败，点击打开架构图" : "预览加载失败";
 								});
 								preview.appendChild(image);
 							}
@@ -2791,14 +2950,8 @@ display: none;
 				};
 				loadArchitectures(selectedFolderId);
 			};
-			if (architectureDirectoriesCache !== null) {
-				paintDirectories(architectureDirectoriesCache, architectureFirstFolderId);
-				return;
-			}
 			requireCloudqCredential().then(() => cloudqRequest(API_ARCH_DIRECTORIES)).then((data) => {
-				architectureDirectoriesCache = Array.isArray(data?.folders) ? data.folders : [];
-				architectureFirstFolderId = Number(data?.firstFolderId) || null;
-				paintDirectories(architectureDirectoriesCache, architectureFirstFolderId);
+				paintDirectories(Array.isArray(data?.folders) ? data.folders : [], Number(data?.firstFolderId) || null);
 			}).catch((error) => {
 				if (panelView !== "architecture" || !panelExpanded || viewRequest !== architectureRequestSeq) return;
 				panelBody.textContent = "";
@@ -3073,12 +3226,7 @@ display: none;
 					panelEl = null;
 					panelBody = null;
 				}
-				inspirationCache = null;
 				inspirationCategory = 0;
-				artifactCache = null;
-				artifactTotal = 0;
-				architectureDirectoriesCache = null;
-				architectureFirstFolderId = null;
 				architectureRequestSeq += 1;
 				panelView = "usage";
 			};
@@ -3237,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
@@ -3644,6 +3792,33 @@ display: none;
 					window.removeEventListener("storage", onStorage);
 				};
 			}, "dsh-cloudq: reconcile durable session identities");
+			ctx.effect(() => {
+				const list = ctx?.sessions?.list;
+				if (!list?.subscribe || !list?.getSnapshot) return void 0;
+				const prevRunning = /* @__PURE__ */ new Map();
+				return list.subscribe(() => {
+					const byId = list.getSnapshot()?.byId ?? {};
+					for (const [id, summary] of Object.entries(byId)) {
+						const running = summary?.running === true;
+						if (prevRunning.get(id) === true && !running && cloudqSessions.has(id)) scheduleArtifactSilentRefresh();
+						prevRunning.set(id, running);
+					}
+				});
+			}, "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.1.9",
+  "version": "0.2.1",
   "description": "CloudQ integration for DeepSeek Harness with secure credential, workspace, and plugin-management surfaces",
   "license": "MIT",
   "type": "module",

package/skills/cloudq/scripts/create_role.py

@@ -104,7 +104,7 @@ def find_available_role_name() -> tuple:
 
 
 def save_config(account_uin: str, role_arn: str, role_id: str = "",
-                auto_created: bool = True):
+                auto_created: bool = True, role_name: str = ""):
     """保存配置到文件"""
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
 
@@ -114,15 +114,25 @@ def save_config(account_uin: str, role_arn: str, role_id: str = "",
         except OSError:
             pass
 
+    # 保留 DSH 插件写入的免密开关偏好，避免重建角色时被重置。
+    existing = {}
+    if CONFIG_FILE.exists():
+        try:
+            existing = json.loads(CONFIG_FILE.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, IOError):
+            existing = {}
+
     config = {
         "accountUin": account_uin,
-        "roleName": ROLE_NAME,
+        "roleName": role_name or ROLE_NAME,
         "roleArn": role_arn,
         "roleId": role_id,
         "configuredAt": datetime.now(timezone.utc).isoformat(),
         "autoCreated": auto_created,
         "version": "1.0",
     }
+    if isinstance(existing.get("enabled"), bool):
+        config["enabled"] = existing["enabled"]
 
     CONFIG_FILE.write_text(
         json.dumps(config, indent=2, ensure_ascii=False),
@@ -153,6 +163,21 @@ def main():
     secret_id = os.environ.get("TENCENTCLOUD_SECRET_ID", "")
     secret_key = os.environ.get("TENCENTCLOUD_SECRET_KEY", "")
 
+    # 环境变量缺失时回退到凭证文件（与 login_url.py 一致），
+    # 使 DSH 插件等宿主可直接调用而无需注入环境变量。
+    if not secret_id or not secret_key:
+        try:
+            from credential_manager import get_credential
+            cred = get_credential()
+            secret_id = cred["secretId"]
+            secret_key = cred["secretKey"]
+            if cred.get("token"):
+                os.environ["TENCENTCLOUD_TOKEN"] = cred["token"]
+        except ImportError:
+            pass
+        except Exception:
+            pass
+
     if not secret_id or not secret_key:
         print(output_json(output_error(
             "MissingCredentials",
@@ -210,7 +235,7 @@ def main():
                     attach_warnings.append(f"策略 {policy_name} 关联失败: {err_msg}")
                     print(f"WARNING: {attach_warnings[-1]}", file=sys.stderr)
 
-        save_config(account_uin, role_arn, role_id, auto_created=False)
+        save_config(account_uin, role_arn, role_id, auto_created=False, role_name=target_role)
         result = output_success(role_arn, account_uin, role_id)
         result["data"]["roleName"] = target_role
         if attach_warnings:
@@ -266,7 +291,7 @@ def main():
 
     # ============== 6. 保存配置 ==============
     role_arn = f"qcs::cam::uin/{account_uin}:roleName/{target_role}"
-    save_config(account_uin, role_arn, role_id, auto_created=True)
+    save_config(account_uin, role_arn, role_id, auto_created=True, role_name=target_role)
 
     # ============== 7. 输出结果 ==============
     result = output_success(role_arn, account_uin, role_id)