@deepseek-ai/dsh-client-ui-settings-general 0.1.6-alpha.1 → 0.1.6-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-settings-general/README.md
-README.md: af68c42ad111f74e68037436e18a5be57195a64b
-README.zh.md: f929df66a13cde7beb63721922f2a3f4aa90ba43
+README.md: 0ea39cbb56b2040004513723b6d838a1ce9e7557
+README.zh.md: 9566471c68067e4ec461c28aeeb9a806a718fb90

package/README.md

@@ -27,6 +27,8 @@ Use this package to give the dsh web client a Settings panel, connection-recover
 
 Users reach the shell through the sidebar's bottom Settings control; feature plugins contribute their pages and onboarding steps through the slot ledgers this shell projects. In both the expanded sidebar and collapsed rail, the control exposes the localized Settings label as its accessible name. A pale-yellow **Disconnected** action beside Settings indicates browser offline suspension; its permanent retry glyph marks the retry action, which the Chinese outage copy also names (连接异常，刷新重试). Every recovery attempt shows a spinner beside **Reconnecting** with one to three dots advancing every 500ms, and an attempt stays visible for at least 800ms so brief retries do not flicker. Selecting either yellow state starts an immediate retry; press feedback stays within the warning palette. Recovery changes the region to pale-green **Connected** for two seconds from the moment the green pill becomes visible. The pill fades in on appearance, fades out over 150ms on removal, and sizes to its current label. Initial startup and uninterrupted healthy operation remain silent. The shell renders the modal panel, the navigation built from `settings.section` entries, and exactly one mounted onboarding step at a time.
 
+In Desktop, the account-row update control shows availability, progress, verification, readiness, and persistent retry feedback. The preload carries semantic phase, version, progress, and classified failures; the component resolves every visible and accessible string from the active `settings` locale, including after an in-application language change. Selecting an available update starts downloading; installation requires a separate shell-owned confirmation. A collapsed sidebar shows the same status as a dot on its top expand button. Connection feedback takes priority except during shell-reported installation, when the expected backend disconnect must not hide update status. Failure restores connection feedback. Both controls share one carrier subscription; browser code cannot choose packages or authorize installation. [Desktop updates](../../../apps/desktop/README.md) owns the release workflow.
+
 ### The General section
 
 The General section holds rows registered into `settings.general.item` by feature packages — it has no built-in rows. Feature plugins own the row copy and behavior; the shell only provides the section and its slot. The Appearance row, for example, lives in ui-theme.

package/README.zh.md

@@ -27,6 +27,8 @@ kind: "package-reference"
 
 用户通过侧边栏底部的 Settings 控件进入外壳；功能插件通过本外壳所投影的 slot 账本贡献自己的页面与引导步骤。在展开侧边栏和收起轨道中，该控件都会把本地化的 Settings 文案作为其可访问名称。Settings 右侧浅黄色的**连接异常**操作表示浏览器离线暂停；其常驻重试图形与中文文案「连接异常，刷新重试」都指明重试动作。每次恢复尝试都显示 spinner 加**重新连接中**，其后一至三个点每 500ms 前进一次，且每次尝试至少可见 800ms，短暂重试不会闪动。选中任一黄色状态都会立即发起重试；按压反馈留在黄色色阶内。恢复后该区域变为浅绿色的**连接成功**，从绿色药丸可见起驻留 2 秒再消失。药丸出现时淡入、移除时以 150ms 淡出，宽度随当前文案自适应。首次启动与未曾中断的健康连接保持静默。外壳渲染模态面板、由 `settings.section` 条目构建的导航，以及每次只挂载一个的引导步骤。
 
+在 Desktop 中，账户行更新控件显示可用版本、进度、验证、就绪和持久重试反馈。预加载仅传递语义化阶段、版本、进度和失败类别；组件从当前 `settings` locale 解析全部可见与无障碍文案，并在应用内语言变化后同步更新。选择可用更新即开始下载；安装需要独立的壳拥有的确认。侧栏收起时，其顶部展开按钮以圆点显示相同状态。连接反馈通常优先展示，但壳报告正在安装时，预期的后端断开不能遮盖更新状态；失败后恢复连接反馈。两个控件共用一次载体订阅；浏览器代码不能选择安装包或授权安装。[Desktop 更新](../../../apps/desktop/README.zh.md)负责发布流程。
+
 ### 「通用」分区
 
 「通用」分区承载由功能包注册进 `settings.general.item` 的行——它没有内置行。功能插件拥有行文案与行为；外壳只提供分区及其 slot。例如「外观」行位于 ui-theme。

package/lib/client.js

@@ -25,13 +25,13 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/SettingsRoot.module.css.mjs
-		const css$3 = ".VOzbGW_triggerRow{flex:none;align-items:center;gap:8px;width:calc(100% + 4px);margin:4px -2px;display:flex}.VOzbGW_triggerRow.VOzbGW_railRow{width:36px;margin:8px 0 10px}.VOzbGW_trigger{box-sizing:border-box;cursor:pointer;width:auto;min-width:0;height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:1;align-items:center;gap:8px;margin:0;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.VOzbGW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_trigger.VOzbGW_rail{corner-shape:round;border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.VOzbGW_triggerLabel{white-space:nowrap;overflow:hidden}.VOzbGW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.VOzbGW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.VOzbGW_panel{z-index:1;background:var(--dsw-alias-bg-layer-2);width:800px;max-width:calc(100vw - 48px);height:min(800px,100vh - 48px);box-shadow:var(--dsw-elevation-prominent);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:32px;display:flex;position:relative;overflow:hidden}.VOzbGW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.VOzbGW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.VOzbGW_navList{flex-direction:column;gap:4px;display:flex}.VOzbGW_navCell{box-sizing:border-box;cursor:pointer;height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:9px 16px 9px 12px;font-family:inherit;font-size:14px;font-weight:400;line-height:22px;display:flex}.VOzbGW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.VOzbGW_navCell.VOzbGW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.VOzbGW_navIcon{flex:none}.VOzbGW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.VOzbGW_content{flex-direction:column;flex:1;min-width:0;display:flex}.VOzbGW_header{box-sizing:border-box;flex:none;justify-content:space-between;align-items:flex-start;gap:8px;height:54px;padding:20px 14px 8px 10px;display:flex}.VOzbGW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.VOzbGW_close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:0;display:inline-flex}.VOzbGW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.VOzbGW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
-		const tagId$3 = "@deepseek-ai/dsh-client-ui-settings-general/SettingsRoot.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
+		const css$4 = ".VOzbGW_triggerRow{flex:none;align-items:center;gap:8px;width:calc(100% + 4px);margin:4px -2px;display:flex;position:relative}.VOzbGW_triggerRow.VOzbGW_railRow{width:36px;margin:8px 0 10px}.VOzbGW_trigger{box-sizing:border-box;cursor:pointer;width:auto;min-width:0;height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:1;align-items:center;gap:8px;margin:0;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.VOzbGW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_trigger.VOzbGW_rail{flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.VOzbGW_triggerLabel{white-space:nowrap;overflow:hidden}.VOzbGW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.VOzbGW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.VOzbGW_panel{z-index:1;background:var(--dsw-alias-bg-layer-2);width:800px;max-width:calc(100vw - 48px);height:min(800px,100vh - 48px);box-shadow:var(--dsw-elevation-prominent);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:32px;display:flex;position:relative;overflow:hidden}.VOzbGW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.VOzbGW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.VOzbGW_navList{flex-direction:column;gap:4px;display:flex}.VOzbGW_navCell{box-sizing:border-box;cursor:pointer;height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:9px 16px 9px 12px;font-family:inherit;font-size:14px;font-weight:400;line-height:22px;display:flex}.VOzbGW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.VOzbGW_navCell.VOzbGW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.VOzbGW_navIcon{flex:none}.VOzbGW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.VOzbGW_content{flex-direction:column;flex:1;min-width:0;display:flex}.VOzbGW_header{box-sizing:border-box;flex:none;justify-content:space-between;align-items:flex-start;gap:8px;height:54px;padding:20px 14px 8px 10px;display:flex}.VOzbGW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.VOzbGW_close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:0;display:inline-flex}.VOzbGW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.VOzbGW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
+		const tagId$4 = "@deepseek-ai/dsh-client-ui-settings-general/SettingsRoot.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
-			tag.dataset.pluginCss = tagId$3;
-			tag.textContent = css$3;
+			tag.dataset.pluginCss = tagId$4;
+			tag.textContent = css$4;
 			document.head.appendChild(tag);
 		}
 		var SettingsRoot_module_css_default = {
@@ -58,6 +58,135 @@ window.__ModuleLoader__.load({
 			"triggerRow": "VOzbGW_triggerRow"
 		};
 		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/DesktopUpdateIndicator.module.css.mjs
+		const css$3 = ".DOUpOa_indicator{border:1px solid color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 20%, transparent);color:var(--dsw-alias-brand-primary-new-colorprimary-new-color);background:color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 8%, transparent);font:inherit;white-space:nowrap;cursor:pointer;border-radius:6px;flex:none;align-items:center;gap:6px;margin-inline-end:4px;padding:1px 8px;font-size:12px;line-height:20px;display:inline-flex}.DOUpOa_indicator[data-error]{color:var(--dsw-alias-state-error-primary)}.DOUpOa_badge{inset-inline-end:2px;corner-shape:round;background:var(--dsw-alias-brand-primary-new-colorprimary-new-color);border-radius:50%;width:6px;height:6px;position:absolute;top:2px}.DOUpOa_badge[data-error],.DOUpOa_errorDot{background:var(--dsw-alias-state-error-primary)}.DOUpOa_errorDot{corner-shape:round;border-radius:50%;width:6px;height:6px}.DOUpOa_spinner{animation:1s linear infinite DOUpOa_spin}@keyframes DOUpOa_spin{to{transform:rotate(360deg)}}@media (prefers-reduced-motion:reduce){.DOUpOa_spinner{animation:none}}.DOUpOa_indicator[aria-disabled=true]{cursor:default}";
+		const tagId$3 = "@deepseek-ai/dsh-client-ui-settings-general/DesktopUpdateIndicator.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$3;
+			tag.textContent = css$3;
+			document.head.appendChild(tag);
+		}
+		var DesktopUpdateIndicator_module_css_default = {
+			"badge": "DOUpOa_badge",
+			"errorDot": "DOUpOa_errorDot",
+			"indicator": "DOUpOa_indicator",
+			"spin": "DOUpOa_spin",
+			"spinner": "DOUpOa_spinner"
+		};
+		//#endregion
+		//#region lib/types/client/DesktopUpdateIndicator.js
+		/** Optional Electron status presentation; the native shell owns actions and Web owns visible copy. */
+		const BUSY_PHASES = new Set([
+			"checking",
+			"downloading",
+			"verifying",
+			"installing"
+		]);
+		function updateCopy(state, t) {
+			const label = {
+				idle: "",
+				checking: t("desktop.update.checking"),
+				available: t("desktop.update.available"),
+				downloading: t("desktop.update.progress", { percent: state.percent ?? 0 }),
+				verifying: t("desktop.update.verifying"),
+				installing: t("desktop.update.installing"),
+				ready: t("desktop.update.ready"),
+				error: t("desktop.update.retry")
+			}[state.phase];
+			if (state.phase === "error") return {
+				label,
+				detail: {
+					check: t("desktop.update.checkFailed"),
+					"check-network": t("desktop.update.checkNetworkFailed"),
+					download: t("desktop.update.downloadFailed"),
+					"download-network": t("desktop.update.downloadNetworkFailed"),
+					install: t("desktop.update.installFailed"),
+					"install-network": t("desktop.update.installNetworkFailed"),
+					"stop-failed": t("desktop.update.stopFailed"),
+					"tasks-changed": t("desktop.update.tasksChanged"),
+					"tasks-unavailable": t("desktop.update.tasksUnavailable")
+				}[state.failure ?? "install"]
+			};
+			if (state.phase === "downloading" && state.version !== void 0) return {
+				label,
+				detail: t("desktop.update.downloadDetail", {
+					percent: state.percent ?? 0,
+					version: state.version
+				})
+			};
+			return {
+				label,
+				detail: state.version === void 0 ? label : t("desktop.update.versionDetail", {
+					label,
+					version: state.version
+				})
+			};
+		}
+		/**
+		* @param props - Connection priority, sidebar width, and localized bridge-failure copy.
+		* @returns Desktop-only status beside the account button, or nothing in browsers.
+		*/
+		function DesktopUpdateIndicator({ wide, hidden, t, view, onOpen }) {
+			const { presentation: state, failed, opening } = view;
+			if (!wide || hidden || !failed && (state === void 0 || state.phase === "idle")) return null;
+			const retryLabel = t("desktop.update.retry");
+			const copy = state === void 0 ? {
+				label: retryLabel,
+				detail: retryLabel
+			} : updateCopy(state, t);
+			const label = failed ? retryLabel : copy.label;
+			const error = failed || state?.phase === "error";
+			const busy = opening || state !== void 0 && BUSY_PHASES.has(state.phase);
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: failed ? retryLabel : copy.detail,
+				side: "top",
+				children: (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: DesktopUpdateIndicator_module_css_default.indicator,
+					"data-error": error || void 0,
+					"aria-label": label,
+					"aria-disabled": busy,
+					onClick: () => {
+						if (!busy) onOpen();
+					},
+					children: [error ? (0, react_jsx_runtime.jsx)("span", {
+						className: DesktopUpdateIndicator_module_css_default.errorDot,
+						"aria-hidden": "true"
+					}) : busy ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {
+						className: DesktopUpdateIndicator_module_css_default.spinner,
+						size: 16
+					}) : (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDownloadOutline16, { size: 14 }), (0, react_jsx_runtime.jsx)("span", { children: label })]
+				})
+			});
+		}
+		/**
+		* @param props - Framework-bound carrier and connection state.
+		* @returns A non-interactive notification on the sidebar expand button.
+		*/
+		function DesktopUpdateBadge({ useDesktopUpdate, useConnectionState, t }) {
+			const { presentation: state, failed } = useDesktopUpdate((value) => value);
+			const connection = useConnectionState((value) => value);
+			if ((connection === "disconnected" || connection === "connecting") && state?.phase !== "installing" || !failed && (state === void 0 || state.phase === "idle")) return null;
+			const retryLabel = t("desktop.update.retry");
+			const copy = state === void 0 ? {
+				label: retryLabel,
+				detail: retryLabel
+			} : updateCopy(state, t);
+			const label = failed ? retryLabel : copy.label;
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: failed ? label : copy.detail,
+				side: "right",
+				children: (0, react_jsx_runtime.jsx)("span", {
+					role: "img",
+					"aria-label": label,
+					className: DesktopUpdateIndicator_module_css_default.badge,
+					"data-error": failed || state?.phase === "error" || void 0
+				})
+			});
+		}
+		//#endregion
 		//#region lib/types/client/SettingsRoot.js
 		/**
 		* Settings shell root: the sidebar-foot trigger row plus the centered modal
@@ -182,7 +311,7 @@ window.__ModuleLoader__.load({
 		* @returns the settings shell element tree.
 		*/
 		function SettingsRoot(props) {
-			const { wide, reconnect, useConnectionState, useSections, useOnboardingSteps, useSessions, renderSlot, t } = props;
+			const { wide, reconnect, useConnectionState, useSections, useOnboardingSteps, useSessions, renderSlot, t, useDesktopUpdate, openDesktopUpdate } = props;
 			const [open, setOpen] = (0, react.useState)(false);
 			const [activeId, setActiveId] = (0, react.useState)(void 0);
 			const [completedOnboarding, setCompletedOnboarding] = (0, react.useState)(() => /* @__PURE__ */ new Set());
@@ -204,10 +333,14 @@ window.__ModuleLoader__.load({
 				setOpen(true);
 			}, []);
 			const rows = useSections((s) => s);
+			const desktopUpdate = useDesktopUpdate((state) => state);
 			const connectionState = useConnectionState((state) => state);
 			const previousConnectionState = (0, react.useRef)(connectionState);
 			const onboardingSteps = useOnboardingSteps((s) => s);
-			const onboardingActive = useSessions((state) => state.phase === "ready" && (state.current === void 0 || state.byId[state.current]?.blank === true));
+			const onboardingActive = useSessions((state) => {
+				const main = Object.values(state.byId).find((session) => (session.retainedBy.mainView ?? 0) > 0);
+				return state.phase === "ready" && (main === void 0 || main.blank);
+			});
 			const onboardingStep = onboardingActive ? onboardingSteps.find((step) => !completedOnboarding.has(step.id)) : void 0;
 			(0, react.useEffect)(() => {
 				if (onboardingActive) return;
@@ -264,26 +397,36 @@ window.__ModuleLoader__.load({
 			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 				(0, react_jsx_runtime.jsxs)("div", {
 					className: clsx(SettingsRoot_module_css_default.triggerRow, !wide && SettingsRoot_module_css_default.railRow),
-					children: [(0, react_jsx_runtime.jsx)("button", {
-						ref: triggerButton,
-						type: "button",
-						className: clsx(SettingsRoot_module_css_default.trigger, !wide && SettingsRoot_module_css_default.rail),
-						"aria-label": t("trigger"),
-						"aria-haspopup": "dialog",
-						"aria-expanded": open,
-						onClick: () => {
-							setOpen(true);
-						},
-						children: renderSlot("settings.trigger", { wide })
-					}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ConnectionIndicator, {
-						state: wide ? connectionIndicator : void 0,
-						disconnectedLabel: t("connection.error"),
-						connectingLabel: t("connection.connecting"),
-						recoveredLabel: t("connection.connected"),
-						reconnectActionLabel: t("connection.reconnect"),
-						restartActionLabel: t("connection.restart"),
-						onReconnect: reconnect
-					})]
+					children: [
+						(0, react_jsx_runtime.jsx)("button", {
+							ref: triggerButton,
+							type: "button",
+							className: clsx(SettingsRoot_module_css_default.trigger, !wide && SettingsRoot_module_css_default.rail),
+							"aria-label": t("trigger"),
+							"aria-haspopup": "dialog",
+							"aria-expanded": open,
+							onClick: () => {
+								setOpen(true);
+							},
+							children: renderSlot("settings.trigger", { wide })
+						}),
+						(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ConnectionIndicator, {
+							state: wide && desktopUpdate.presentation?.phase !== "installing" ? connectionIndicator : void 0,
+							disconnectedLabel: t("connection.error"),
+							connectingLabel: t("connection.connecting"),
+							recoveredLabel: t("connection.connected"),
+							reconnectActionLabel: t("connection.reconnect"),
+							restartActionLabel: t("connection.restart"),
+							onReconnect: reconnect
+						}),
+						(0, react_jsx_runtime.jsx)(DesktopUpdateIndicator, {
+							wide,
+							hidden: connectionIndicator !== void 0 && desktopUpdate.presentation?.phase !== "installing",
+							t,
+							view: desktopUpdate,
+							onOpen: openDesktopUpdate
+						})
+					]
 				}),
 				open && (0, react_jsx_runtime.jsx)(SettingsPanel, {
 					rows,
@@ -302,6 +445,76 @@ window.__ModuleLoader__.load({
 			] });
 		}
 		//#endregion
+		//#region lib/types/client/desktop-update-source.js
+		/** Client-owned observation of the optional Desktop preload. */
+		/** Owns one preload subscription across both sidebar locations. */
+		var DesktopUpdateSource = class {
+			bridge;
+			/** Framework-observed carrier status shared by both sidebar controls. */
+			store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
+				failed: false,
+				opening: false
+			});
+			live = true;
+			received = false;
+			unsubscribe;
+			/** @param bridge - Optional isolated Electron API, absent in ordinary browsers. */
+			constructor(bridge) {
+				this.bridge = bridge;
+				this.unsubscribe = bridge?.subscribe((presentation) => {
+					if (!this.live) return;
+					this.received = true;
+					this.store.set({
+						...this.store.getSnapshot(),
+						presentation,
+						failed: false
+					});
+				});
+				bridge?.status().then((presentation) => {
+					if (this.live && !this.received) this.store.set({
+						...this.store.getSnapshot(),
+						presentation
+					});
+				}, () => {
+					if (this.live && !this.received) this.store.set({
+						...this.store.getSnapshot(),
+						failed: true
+					});
+				});
+			}
+			/** Invoke one user action; subsequent clicks join the shell-owned operation. */
+			open() {
+				if (!this.live || this.bridge === void 0) return;
+				const state = this.store.getSnapshot();
+				if (state.opening || state.presentation !== void 0 && [
+					"checking",
+					"downloading",
+					"verifying",
+					"installing"
+				].includes(state.presentation.phase)) return;
+				this.store.set({
+					...state,
+					opening: true
+				});
+				this.bridge.open().catch(() => {
+					if (this.live) this.store.set({
+						...this.store.getSnapshot(),
+						failed: true
+					});
+				}).finally(() => {
+					if (this.live) this.store.set({
+						...this.store.getSnapshot(),
+						opening: false
+					});
+				});
+			}
+			/** Detach the carrier and ignore any pending status or action completion. */
+			dispose() {
+				this.live = false;
+				this.unsubscribe?.();
+			}
+		};
+		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/chrome.module.css.mjs
 		const css$2 = ".UQsH_q_triggerLabel{white-space:nowrap;overflow:hidden}";
 		const tagId$2 = "@deepseek-ai/dsh-client-ui-settings-general/chrome.module.css";
@@ -510,6 +723,24 @@ window.__ModuleLoader__.load({
 		/** Simplified Chinese dictionary (the key-set source of truth). */
 		const zh = {
 			"trigger": "设置",
+			"desktop.update.available": "新版本",
+			"desktop.update.checking": "正在检查更新…",
+			"desktop.update.progress": "{percent}%…",
+			"desktop.update.verifying": "正在校验更新文件…",
+			"desktop.update.installing": "正在准备重启…",
+			"desktop.update.ready": "安装并重启",
+			"desktop.update.retry": "重试更新",
+			"desktop.update.versionDetail": "{label} — V{version}",
+			"desktop.update.downloadDetail": "正在下载更新：{percent}%\n目标版本：V{version}",
+			"desktop.update.checkFailed": "检查更新失败，请稍后重试。",
+			"desktop.update.downloadFailed": "下载更新失败，请重试。",
+			"desktop.update.installFailed": "安装更新失败，请稍后重试。",
+			"desktop.update.checkNetworkFailed": "检查更新失败，请稍后重试。网络连接异常，请检查网络后重试。",
+			"desktop.update.downloadNetworkFailed": "下载更新失败，请重试。网络连接异常，请检查网络后重试。",
+			"desktop.update.installNetworkFailed": "安装更新失败，请稍后重试。网络连接异常，请检查网络后重试。",
+			"desktop.update.stopFailed": "未能安全停止任务，更新未安装。请稍后重试。",
+			"desktop.update.tasksChanged": "有新任务开始，请重新确认更新。",
+			"desktop.update.tasksUnavailable": "无法确认任务状态，请在工作区就绪后重试更新。",
 			"title": "设置",
 			"close": "关闭",
 			"openDocument": "打开配置文件",
@@ -524,6 +755,24 @@ window.__ModuleLoader__.load({
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
 			"trigger": "Settings",
+			"desktop.update.available": "Update",
+			"desktop.update.checking": "Checking for updates…",
+			"desktop.update.progress": "{percent}%…",
+			"desktop.update.verifying": "Verifying update files…",
+			"desktop.update.installing": "Preparing to restart…",
+			"desktop.update.ready": "Install and Restart",
+			"desktop.update.retry": "Retry update",
+			"desktop.update.versionDetail": "{label} — V{version}",
+			"desktop.update.downloadDetail": "Downloading update: {percent}%\nTarget version: V{version}",
+			"desktop.update.checkFailed": "Could not check for updates. Please try again later.",
+			"desktop.update.downloadFailed": "Could not download the update. Please try again.",
+			"desktop.update.installFailed": "Could not install the update. Please try again later.",
+			"desktop.update.checkNetworkFailed": "Could not check for updates. Please try again later. The connection was interrupted. Check your network and try again.",
+			"desktop.update.downloadNetworkFailed": "Could not download the update. Please try again. The connection was interrupted. Check your network and try again.",
+			"desktop.update.installNetworkFailed": "Could not install the update. Please try again later. The connection was interrupted. Check your network and try again.",
+			"desktop.update.stopFailed": "Tasks could not be stopped safely. The update was not installed. Please try again later.",
+			"desktop.update.tasksChanged": "New tasks started. Review the update confirmation again.",
+			"desktop.update.tasksUnavailable": "Task status is unavailable. Try updating again when the workspace is ready.",
 			"title": "Settings",
 			"close": "Close",
 			"openDocument": "Open configuration file",
@@ -563,6 +812,19 @@ window.__ModuleLoader__.load({
 				en
 			}), "ui-settings-general: dictionaries");
 			const connection = ctx.get("connection");
+			const carrier = globalThis.dshDesktop;
+			const desktopUpdate = new DesktopUpdateSource(carrier?.protocolVersion === 1 ? carrier.updates : void 0);
+			ctx.effect(() => () => {
+				desktopUpdate.dispose();
+			}, "ui-settings-general: desktop update carrier");
+			ctx.slots.inject("sidebar.toggle.badge", () => ctx.slots.register({
+				name: "sidebar.toggle.badge",
+				locale: NS,
+				inject: () => ({ hooks: {
+					desktopUpdate: desktopUpdate.store,
+					connectionState: connection.state
+				} })
+			}, DesktopUpdateBadge));
 			const t = ctx.locale.bind(NS);
 			const documentController = ctx.remote.$host.isLoopback ? new SettingsDocumentStore(ctx, ctx.settingsScope.describe()) : void 0;
 			const documentInjected = documentController === void 0 ? void 0 : () => ({
@@ -578,10 +840,14 @@ window.__ModuleLoader__.load({
 			let onboardingVersion = -1;
 			let onboardingSteps = [];
 			const shellInjected = () => ({
+				openDesktopUpdate: () => {
+					desktopUpdate.open();
+				},
 				reconnect: () => {
 					connection.reconnect();
 				},
 				hooks: {
+					desktopUpdate: desktopUpdate.store,
 					connectionState: connection.state,
 					sections: {
 						getSnapshot: () => {

package/lib/types/client/DesktopUpdateIndicator.d.ts

@@ -0,0 +1,23 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DesktopUpdateView } from './desktop-update-bridge.ts';
+import type { SettingsRootInjected } from './shell-contract.ts';
+type SettingsTranslate = PropsLocale<'settings'>['t'];
+/**
+ * @param props - Connection priority, sidebar width, and localized bridge-failure copy.
+ * @returns Desktop-only status beside the account button, or nothing in browsers.
+ */
+export declare function DesktopUpdateIndicator({ wide, hidden, t, view, onOpen }: {
+    wide: boolean;
+    hidden: boolean;
+    t: SettingsTranslate;
+    view: DesktopUpdateView;
+    onOpen: () => void;
+}): import("react").JSX.Element | null;
+type BadgeProps = PropsRuntime<'sidebar.toggle.badge'> & PropsLocale<'settings'> & Pick<InjectFace<SettingsRootInjected>, 'useDesktopUpdate' | 'useConnectionState'>;
+/**
+ * @param props - Framework-bound carrier and connection state.
+ * @returns A non-interactive notification on the sidebar expand button.
+ */
+export declare function DesktopUpdateBadge({ useDesktopUpdate, useConnectionState, t }: BadgeProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=DesktopUpdateIndicator.d.ts.map

package/lib/types/client/desktop-update-bridge.d.ts

@@ -0,0 +1,23 @@
+/** Optional Electron preload declarations consumed by the settings row. */
+/** Classified failure copy selected by the Web locale without exposing raw updater diagnostics. */
+export type DesktopUpdateFailureKind = 'check' | 'check-network' | 'download' | 'download-network' | 'install' | 'install-network' | 'stop-failed' | 'tasks-changed' | 'tasks-unavailable';
+/** Public semantic preload fields consumed by the settings row. */
+export interface DesktopUpdatePresentation {
+    readonly phase: 'idle' | 'checking' | 'available' | 'downloading' | 'verifying' | 'installing' | 'ready' | 'error';
+    readonly version?: string;
+    readonly percent?: number;
+    readonly failure?: DesktopUpdateFailureKind;
+}
+/** Optional carrier API; it cannot select artifacts or authorize installation. */
+export interface DesktopUpdateBridge {
+    status(): Promise<DesktopUpdatePresentation>;
+    open(): Promise<void>;
+    subscribe(listener: (state: DesktopUpdatePresentation) => void): () => void;
+}
+/** Shared carrier status for the account row and collapsed sidebar badge. */
+export interface DesktopUpdateView {
+    readonly presentation?: DesktopUpdatePresentation;
+    readonly failed: boolean;
+    readonly opening: boolean;
+}
+//# sourceMappingURL=desktop-update-bridge.d.ts.map

package/lib/types/client/desktop-update-source.d.ts

@@ -0,0 +1,17 @@
+import type { DesktopUpdateBridge, DesktopUpdateView } from './desktop-update-bridge.ts';
+/** Owns one preload subscription across both sidebar locations. */
+export declare class DesktopUpdateSource {
+    private readonly bridge;
+    /** Framework-observed carrier status shared by both sidebar controls. */
+    readonly store: import("@deepseek-ai/dsh-client-store").SnapshotStore<DesktopUpdateView>;
+    private live;
+    private received;
+    private readonly unsubscribe;
+    /** @param bridge - Optional isolated Electron API, absent in ordinary browsers. */
+    constructor(bridge: DesktopUpdateBridge | undefined);
+    /** Invoke one user action; subsequent clicks join the shell-owned operation. */
+    open(): void;
+    /** Detach the carrier and ignore any pending status or action completion. */
+    dispose(): void;
+}
+//# sourceMappingURL=desktop-update-source.d.ts.map

package/lib/types/client/locales.d.ts

@@ -2,6 +2,24 @@
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
     trigger: string;
+    'desktop.update.available': string;
+    'desktop.update.checking': string;
+    'desktop.update.progress': string;
+    'desktop.update.verifying': string;
+    'desktop.update.installing': string;
+    'desktop.update.ready': string;
+    'desktop.update.retry': string;
+    'desktop.update.versionDetail': string;
+    'desktop.update.downloadDetail': string;
+    'desktop.update.checkFailed': string;
+    'desktop.update.downloadFailed': string;
+    'desktop.update.installFailed': string;
+    'desktop.update.checkNetworkFailed': string;
+    'desktop.update.downloadNetworkFailed': string;
+    'desktop.update.installNetworkFailed': string;
+    'desktop.update.stopFailed': string;
+    'desktop.update.tasksChanged': string;
+    'desktop.update.tasksUnavailable': string;
     title: string;
     close: string;
     openDocument: string;
@@ -18,6 +36,24 @@ export type SettingsKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
     trigger: string;
+    'desktop.update.available': string;
+    'desktop.update.checking': string;
+    'desktop.update.progress': string;
+    'desktop.update.verifying': string;
+    'desktop.update.installing': string;
+    'desktop.update.ready': string;
+    'desktop.update.retry': string;
+    'desktop.update.versionDetail': string;
+    'desktop.update.downloadDetail': string;
+    'desktop.update.checkFailed': string;
+    'desktop.update.downloadFailed': string;
+    'desktop.update.installFailed': string;
+    'desktop.update.checkNetworkFailed': string;
+    'desktop.update.downloadNetworkFailed': string;
+    'desktop.update.installNetworkFailed': string;
+    'desktop.update.stopFailed': string;
+    'desktop.update.tasksChanged': string;
+    'desktop.update.tasksUnavailable': string;
     title: string;
     close: string;
     openDocument: string;

package/lib/types/client/shell-contract.d.ts

@@ -8,6 +8,7 @@
  */
 import type { ConnectionState } from '@deepseek-ai/dsh-client-connection/client';
 import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DesktopUpdateView } from './desktop-update-bridge.ts';
 /** One nav row projected from a settings.section registration's options. */
 export interface SettingsSectionRow {
     id: string;
@@ -25,9 +26,13 @@ export interface SettingsOnboardingStep {
  * sources, while the reconnect command remains a plain callback.
  */
 export type SettingsRootInjected = {
+    /** Request the current shell-owned update action. */
+    openDesktopUpdate: () => void;
     /** Request a fresh logical generation and physical WebSocket immediately. */
     reconnect: () => void;
     hooks: {
+        /** Shared Electron status for both sidebar locations. */
+        desktopUpdate: HostObservable<DesktopUpdateView>;
         /** Connection-owned state for the current Host connection. */
         connectionState: HostObservable<ConnectionState | undefined>;
         /** settings.section ledger projected into ordered nav rows. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-general",
   "description": "Settings ownerless-copy and product onboarding plugin: the General section, shell trigger/header chrome content, settings dictionaries, and the versioned welcome notice",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -48,20 +48,20 @@
     "@types/react": "~18.3.1",
     "clsx": "^2.0.0",
     "react": "^18.2.0",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.2"
   },
   "files": [
     "lib/index.js",