@fa-software/semi2-dsh 0.0.14-preview.20260927035651 → 0.0.15

package/README.md

@@ -23,9 +23,9 @@ Redmine 走另一条路：地址与密钥都来自 hub，插件按 hub 下发的
 | `credentialRetryIntervalMs` | 150 | 凭据重试间隔（ms） |
 | `webFenceTimeoutMs` | 5000 | `webServer` 在而校验接口迟迟不出现时补一条诊断日志的上限 |
 
-状态与工作区映射都不落盘：状态段是一行内存覆盖（与模型路由同一条通道），工作区映射只在进程内，
-启动时按 dsh 工作区基线重新登记。本端既无网页服务也无 dsh 工作区服务（NPC 一次性容器）时不发状态行。
-设置写入只剩盘上自铸内容的认领清理（本插件写过的状态段、带着自铸名字的路由与密钥引用）。
+状态与工作区映射都不落盘：状态由 `GET /semi2/status` 按请求现算（浏览器半边拉取），工作区映射只在进程内，
+启动时按 dsh 工作区基线重新登记。本端无网页服务（NPC 一次性容器）时不注册状态路由。
+设置写入只剩带着自铸名字的路由与密钥引用的维护。
 
 ## 提供的服务与事件
 

package/lib/client.js

@@ -8,43 +8,40 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region src/contract.ts
-		/**
-		* 插件自身设置段的条目 id：dsh 的设置命名空间就是 Profile 插件条目 id（bundle patch 里那一行的 id），
-		* 状态 / 健康 / 工作区映射都写在这一段里。host 与浏览器半边共用这一个常量。
-		*/
-		const SEMI2_SETTINGS_ENTRY = "semi2-dsh";
 		/** 动作通道前缀：登录 / 登出 / 同步都经官方 connection 的逻辑 RPC，一次调用落在 POST <前缀>/<endpoint>。 */
 		const SEMI2_ACTION_CHANNEL = "/semi2";
 		//#endregion
 		//#region src/client/projection.ts
-		/** 空快照：段被 serve 但宿主还没发布状态行（页面据此停在登录态）。 */
-		function emptySnapshot(snapshot) {
+		/** 空快照：还没拿到过任何数据（页面据此停在登录态 / 错误卡）。 */
+		function emptySnapshot(frame) {
 			return {
 				fields: {},
 				tabs: [],
-				writable: snapshot.writable === true,
-				revision: snapshot.revision,
+				writable: frame.writable === true,
 				connected: false
 			};
 		}
-		/** 投影一帧设置段快照；空值沿用上一轮，其余按 `status` 决定是否进控制台。 */
-		function projectSnapshot(snapshot, previous) {
-			const value = snapshot.value;
-			if (value === void 0 || typeof value.status !== "string" || value.status === "") return previous === void 0 ? emptySnapshot(snapshot) : {
+		/** 投影一帧状态应答；空值沿用上一轮，其余按 `status` 决定是否进控制台。 */
+		function projectSnapshot(frame, previous) {
+			const value = frame.section;
+			if (value === void 0 || typeof value.status !== "string" || value.status === "") return previous === void 0 ? emptySnapshot(frame) : {
 				...previous,
-				revision: snapshot.revision
+				writable: frame.writable === true
 			};
 			return {
 				fields: value,
 				tabs: Array.isArray(value.workspaceTabs) ? value.workspaceTabs : [],
-				writable: snapshot.writable === true,
-				revision: snapshot.revision,
+				writable: frame.writable === true,
 				connected: value.status === "ready"
 			};
 		}
 		//#endregion
 		//#region src/client/controller.ts
 		const OVERVIEW_KEY = "overview";
+		/** 状态路由：唯一的状态来源。 */
+		const STATUS_PATH = "/semi2/status";
+		/** 页面可见时的慢心跳：状态页不是仪表盘，30s 足够接住会话期事实（项目画像等）。 */
+		const REFRESH_INTERVAL_MS = 3e4;
 		/** 运行平台原值（数据层只存 cnb / host）→ 展示标签（本地化）。 */
 		function platformText(t, platform) {
 			if (typeof platform !== "string" || platform === "") return "—";
@@ -117,24 +114,42 @@ window.__ModuleLoader__.load({
 		}
 		var Semi2Controller = class {
 			ctx;
-			scope;
 			listeners = /* @__PURE__ */ new Set();
-			unsubscribe;
+			disposers = [];
+			doFetch;
 			projected;
+			view = "loading";
 			loginBusy = false;
 			logoutBusy = false;
 			actionError = null;
 			constructor(ctx) {
 				this.ctx = ctx;
-				this.scope = ctx.configForms.get(SEMI2_SETTINGS_ENTRY);
-				this.projected = projectSnapshot(this.scope.getSnapshot(), void 0);
-				this.unsubscribe = this.scope.subscribe(() => {
-					this.projected = projectSnapshot(this.scope.getSnapshot(), this.projected);
-					for (const listener of this.listeners) listener();
+				this.doFetch = globalThis.fetch.bind(globalThis);
+				this.projected = projectSnapshot({}, void 0);
+				const offReset = ctx.on?.("connection/reset", () => {
+					this.refresh();
 				});
+				if (offReset !== void 0) this.disposers.push(() => {
+					offReset();
+				});
+				const state = ctx.connection?.state;
+				if (state !== void 0) this.disposers.push(state.subscribe(() => {
+					if (state.getSnapshot() === "connected") this.refresh();
+				}));
+				const browser = globalThis;
+				if (browser.document !== void 0) {
+					const timer = setInterval(() => {
+						if (browser.document?.visibilityState !== "hidden") this.refresh();
+					}, REFRESH_INTERVAL_MS);
+					this.disposers.push(() => {
+						clearInterval(timer);
+					});
+				}
+				this.refresh();
 			}
 			dispose() {
-				this.unsubscribe();
+				for (const dispose of this.disposers) dispose();
+				this.disposers.length = 0;
 				this.listeners.clear();
 			}
 			subscribe(listener) {
@@ -146,6 +161,7 @@ window.__ModuleLoader__.load({
 			getSnapshot() {
 				return {
 					projected: this.projected,
+					view: this.view,
 					loginBusy: this.loginBusy,
 					logoutBusy: this.logoutBusy,
 					actionError: this.actionError
@@ -154,7 +170,25 @@ window.__ModuleLoader__.load({
 			notify() {
 				for (const listener of this.listeners) listener();
 			}
-			/** 登录：草稿只在提交时发出；成功清空密码，失败保留草稿并报错。 */
+			/** 拉一帧状态：失败只落 `view`（从未拿到过数据才显示错误卡），拿到过数据就沿用旧值。 */
+			async refresh() {
+				try {
+					const response = await this.doFetch(STATUS_PATH, { headers: { accept: "application/json" } });
+					if (!response.ok) throw new Error(`HTTP ${String(response.status)}`);
+					const body = await response.json();
+					if (body === null || typeof body !== "object" || Array.isArray(body)) throw new Error("invalid payload");
+					const section = body;
+					this.projected = projectSnapshot({
+						section,
+						writable: section.writable === true
+					}, this.projected);
+					this.view = "data";
+				} catch {
+					if (this.view !== "data") this.view = "error";
+				}
+				this.notify();
+			}
+			/** 登录：草稿只在提交时发出；成功清空密码，失败保留草稿并报错；动作后重拉状态。 */
 			async login(draft) {
 				if (this.loginBusy) return;
 				this.loginBusy = true;
@@ -164,6 +198,7 @@ window.__ModuleLoader__.load({
 				this.loginBusy = false;
 				if (!outcome.ok) this.actionError = outcome.code;
 				this.notify();
+				await this.refresh();
 				return outcome;
 			}
 			async logout() {
@@ -175,6 +210,7 @@ window.__ModuleLoader__.load({
 				this.logoutBusy = false;
 				if (!outcome.ok) this.actionError = outcome.code;
 				this.notify();
+				await this.refresh();
 				return outcome;
 			}
 			/**
@@ -188,6 +224,7 @@ window.__ModuleLoader__.load({
 					this.actionError = outcome.code;
 					this.notify();
 				}
+				await this.refresh();
 			}
 		};
 		/** useSyncExternalStore 适配（控制器快照是稳定引用，动作后手动 bump）。 */
@@ -562,10 +599,40 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		function OverviewTab({ t, projected, controller, actionError }) {
+		/** 从未拿到过数据且拉取失败：错误卡 + 手动重试（不伪装成登录表单）。 */
+		function ErrorCard({ t, controller }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "semi2-card",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+						className: "semi2-cardTitle",
+						children: t("statusUnavailableTitle")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "semi2-hint",
+						children: t("statusUnavailableHint")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "semi2-formActions",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							variant: "primary",
+							onClick: () => {
+								controller.refresh();
+							},
+							children: t("retry")
+						})
+					})
+				]
+			});
+		}
+		function OverviewTab({ t, projected, controller, actionError, view }) {
 			const { fields } = projected;
 			const [diagnosticsOpen, setDiagnosticsOpen] = (0, react.useState)(false);
 			const { showLogin } = connectionMode(projected);
+			if (view === "error") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ErrorCard, {
+				t,
+				controller
+			});
 			if (showLogin) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LoginCard, {
 				t,
 				projected,
@@ -683,7 +750,8 @@ window.__ModuleLoader__.load({
 		*/
 		function Semi2Page(props) {
 			const { t, controller, renderSlot } = props;
-			const { projected } = useController(controller);
+			const state = useController(controller);
+			const { projected } = state;
 			const [active, setActive] = (0, react.useState)(OVERVIEW_KEY);
 			const tabs = (0, react.useMemo)(() => projected.tabs.filter((tab) => tab.title !== ""), [projected.tabs]);
 			const keys = (0, react.useMemo)(() => [OVERVIEW_KEY, ...tabs.map(tabKey)], [tabs]);
@@ -741,7 +809,8 @@ window.__ModuleLoader__.load({
 							t,
 							projected,
 							controller,
-							actionError: showLogin ? actionError : void 0
+							actionError: showLogin ? actionError : void 0,
+							view: state.view
 						}) : renderSlot !== void 0 ? renderSlot("semi2.workspace", { view: "page" }, { entryKey: active }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WorkspaceTab, {
 							t,
 							controller,
@@ -798,6 +867,9 @@ window.__ModuleLoader__.load({
 			workspaceSyncedAt: "同步时间",
 			workspaceUnresolved: "未解析（不归 semi2-hub 管）",
 			workspaceNone: "没有已登记的工作区",
+			statusUnavailableTitle: "状态暂不可用",
+			statusUnavailableHint: "取不到宿主状态（宿主插件未就绪或版本不匹配），可重试",
+			retry: "重试",
 			domainModels: "模型",
 			domainSecrets: "模型密钥",
 			domainSkills: "技能",
@@ -867,6 +939,9 @@ window.__ModuleLoader__.load({
 			workspaceSyncedAt: "Synced at",
 			workspaceUnresolved: "Unresolved (not managed by semi2-hub)",
 			workspaceNone: "No registered workspaces",
+			statusUnavailableTitle: "Status unavailable",
+			statusUnavailableHint: "Cannot read host status (host plugin not ready or version mismatch); retry",
+			retry: "Retry",
 			domainModels: "Models",
 			domainSecrets: "Model keys",
 			domainSkills: "Skills",
@@ -989,7 +1064,6 @@ window.__ModuleLoader__.load({
 		const PANEL_ID = "semi2";
 		const inject = [
 			"slots",
-			"configForms",
 			"connection",
 			"locale"
 		];
@@ -1031,9 +1105,9 @@ window.__ModuleLoader__.load({
 					workspaceEntries.set(key, dispose);
 				}
 			};
-			ctx.effect(() => ctx.configForms.whileServed([SEMI2_SETTINGS_ENTRY], () => {
-				const registered = /* @__PURE__ */ new Map();
+			ctx.effect(() => {
 				syncWorkspaceEntries();
+				const registered = /* @__PURE__ */ new Map();
 				registered.set("tabs", controller.subscribe(syncWorkspaceEntries));
 				registered.set("panel", ctx.slots.inject("main", () => ctx.slots.register({
 					name: "main",
@@ -1058,10 +1132,11 @@ window.__ModuleLoader__.load({
 					for (const dispose of workspaceEntries.values()) dispose();
 					workspaceEntries.clear();
 				};
-			}), "semi2: sidebar entry + main page");
+			}, "semi2: sidebar entry + main page");
 		}
 		//#endregion
 		exports.PANEL_ID = PANEL_ID;
+		exports.Semi2Controller = Semi2Controller;
 		exports.apply = apply;
 		exports.inject = inject;
 		return module.exports;