@deepseek-ai/dsh-client-ui-settings-general 0.0.1-rc.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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: ab27e073dc76335efc619f56365d1705007f7ef2
+README.zh.md: 16ff5604bee5425569b783e27a29699344f630e3

package/README.md

@@ -0,0 +1,21 @@
+# @deepseek-ai/dsh-client-ui-settings-general
+
+English | [中文](README.zh.md)
+
+Settings ownerless-copy and product-onboarding plugin: registers everything on the Settings surface that belongs to no single feature — the shell's trigger/header/close chrome content, the local configuration-file action, the General section and its `settings.general.item` slot, the `settings` dictionaries, and the first ordered welcome step. Feature-owned rows (Permission, Language, Appearance), sections (Models), and conditional onboarding steps stay with their feature packages.
+
+A loopback browser loads the provider's `hasDocument` capability through `settings.describe` and renders **Open configuration file** only when the Host confirms that a provider-owned local document can be prepared. The action sends the pathless, loopback-only `settings.openDocument` request; the Host resolves the provider path again, materializes an absent document, and hands it to a native text editor (`open -t` on macOS, bypassing a browser file association; the desktop file association on Linux and Windows; Windows association after `wslpath -w` translation on WSL). Open failures keep the action available and render a localized error. Reopening the dialog or reconnecting refreshes availability after a transient read failure or Host topology change. Remote browsers never register the action and never issue the privileged settings read.
+
+`src/onboarding-copy.ts` is the single editable owner of the complete notice plus `WELCOME_NOTICE_VERSION`; both supported GUI locales intentionally render the same Chinese copy. The Host half registers `ui-onboarding` in the user-settings seam. A loopback browser compares `welcomeNoticeVersion` for exact equality and writes the current value only after Continue succeeds. The path mutation is idempotent across tabs and preserves sibling settings, while `host/settings-changed` makes an externally acknowledged notice advance without a reload. A non-loopback browser cannot access the privileged settings API: it still presents the notice, but Continue advances only the current browser process and a reload presents the notice again. A different version deliberately presents the notice again. The welcome page preserves every authored paragraph, gives the requested clause in the final paragraph the sole emphasis, initially focuses the title, and has no close, Escape, mask-click, or secondary path. None of its copy or acknowledgement enters a Session log or model request. The notice identifies `DSH_TELEMETRY_DISABLED=1` as the telemetry opt-out.
+
+## Model Experience
+
+None, as the plugin renders browser settings UI; nothing here reaches a model request.
+
+#### KV Cache effect
+
+None; this package neither assembles nor sends a provider request.
+
+## Known Limitations and Deferred Work
+
+- The General section has no built-in rows; each row appears only when its owning feature plugin is mounted.

package/README.zh.md

@@ -0,0 +1,21 @@
+# @deepseek-ai/dsh-client-ui-settings-general
+
+[English](README.md) | 中文
+
+设置界面无特定功能归属的文案与产品引导插件：在设置界面注册所有不属于单一功能的内容，包括外壳的触发器、标题栏与关闭控件内容、本地配置文件操作，「通用」分区及其 `settings.general.item` slot、`settings` 字典，以及第一个有序欢迎步骤。归具体功能所有的行（「权限」、「语言」、「外观」）、分区（「模型」）和条件式首次使用引导步骤仍由各自的功能包提供。
+
+回环浏览器通过 `settings.describe` 加载提供方的 `hasDocument` 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染**打开配置文件**。该操作发送无路径参数且仅限回环访问的 `settings.openDocument` 请求；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 `open -t`，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 `wslpath -w` 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。远程浏览器从不注册该操作，也从不发起这项特权设置读取。
+
+`src/onboarding-copy.ts` 是完整通知文案和 `WELCOME_NOTICE_VERSION` 的唯一可编辑来源；GUI 支持的两种 locale 都有意渲染同一份中文文案。宿主端在用户设置 seam 中注册 `ui-onboarding`。回环浏览器会比较 `welcomeNoticeVersion` 是否精确相等，仅在「继续」操作成功后写入当前值。该路径变更在不同标签页间幂等，并会保留同级设置；`host/settings-changed` 则让页面在通知被外部确认后，无需重新加载即可推进。非回环浏览器不能访问受保护的设置 API：它仍会显示通知，但「继续」只推进当前浏览器进程，重新加载后会再次显示通知。版本不同时，系统也会有意重新显示通知。欢迎页保留原文的每个段落，仅强调最后一段中指定的句段，初始焦点落在标题上，并且没有关闭操作、Escape、点击遮罩或次要操作路径。其文案和确认状态均不会进入会话日志或模型请求。通知明确以 `DSH_TELEMETRY_DISABLED=1` 作为遥测关闭方式。
+
+## 模型体验
+
+无。该插件渲染浏览器设置 UI；这里没有任何内容进入模型请求。
+
+#### KV Cache 影响
+
+无；该包既不组装也不发送提供方请求。
+
+## 已知限制与暂缓事项
+
+- 「通用」分区没有内置行；每一行仅在其所属功能插件挂载时出现。

package/lib/client.js

@@ -0,0 +1,612 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-settings-general",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_dsh_client_web_react = require("@deepseek-ai/dsh-client-web-react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/chrome.module.css.mjs
+		const css$3 = ".UQsH_q_triggerLabel{white-space:nowrap;overflow:hidden}";
+		const tagId$3 = "@deepseek-ai/dsh-client-ui-settings-general/chrome.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 chrome_module_css_default = { "triggerLabel": "UQsH_q_triggerLabel" };
+		//#endregion
+		//#region lib/types/client/chrome.js
+		/**
+		* Shell chrome content registered into the shell's trigger/header seats: the
+		* trigger row icon + label (figma sidebar foot) and the panel title text.
+		* The shell renders the surrounding chrome (button, nav heading row) and
+		* reads each entry's `label` option for aria text.
+		*/
+		/**
+		* Render the trigger row content (icon; label only in the wide column).
+		* @param props - composed slot props.
+		* @returns the trigger content fragment.
+		*/
+		function TriggerContent({ wide, t }) {
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [wide ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSettingsOutline16, { size: 16 }) : (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSettingsOutline14, { size: 18 }), wide && (0, react_jsx_runtime.jsx)("span", {
+				className: chrome_module_css_default.triggerLabel,
+				children: t("trigger")
+			})] });
+		}
+		/**
+		* Render the panel title text.
+		* @param props - composed slot props.
+		* @returns the title text node.
+		*/
+		function HeaderContent({ t }) {
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("title") });
+		}
+		/**
+		* Render the close button's visually-hidden label text.
+		* @param props - composed slot props.
+		* @returns the label text node.
+		*/
+		function CloseLabel({ t }) {
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("close") });
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/GeneralSection.module.css.mjs
+		const css$2 = "._WvWnq_section{flex-direction:column;width:100%;display:flex}._WvWnq_section>:last-child{border-bottom:none}";
+		const tagId$2 = "@deepseek-ai/dsh-client-ui-settings-general/GeneralSection.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$2;
+			tag.textContent = css$2;
+			document.head.appendChild(tag);
+		}
+		var GeneralSection_module_css_default = { "section": "_WvWnq_section" };
+		//#endregion
+		//#region lib/types/client/GeneralSection.js
+		/**
+		* Render the General section content column.
+		* @param props - composed slot props (contract/slots.ts).
+		* @returns the section element tree.
+		*/
+		function GeneralSection({ renderSlot }) {
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: GeneralSection_module_css_default.section,
+				children: renderSlot("settings.general.item", {})
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/SettingsDocumentAction.module.css.mjs
+		const css$1 = ".me01iq_action{align-items:center;gap:8px;min-width:0;display:flex}.me01iq_error{max-width:180px;color:var(--dsw-alias-state-error-primary);text-overflow:ellipsis;white-space:nowrap;font-size:12px;line-height:18px;overflow:hidden}";
+		const tagId$1 = "@deepseek-ai/dsh-client-ui-settings-general/SettingsDocumentAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var SettingsDocumentAction_module_css_default = {
+			"action": "me01iq_action",
+			"error": "me01iq_error"
+		};
+		//#endregion
+		//#region lib/types/client/SettingsDocumentAction.js
+		/** Optional settings-header action for opening a file-backed Host document. */
+		/**
+		* Render the open-document action only after Host metadata confirms document availability.
+		* @param props - header owner props, localized copy, and injected document state.
+		* @returns the action, or null while unavailable or unresolved.
+		*/
+		function SettingsDocumentAction({ controller, useSnapshot, t }) {
+			const state = useSnapshot((snapshot) => snapshot);
+			(0, react.useEffect)(() => {
+				controller.load();
+			}, [controller]);
+			if (state.status !== "ready") return null;
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SettingsDocumentAction_module_css_default.action,
+				children: [state.error === null ? null : (0, react_jsx_runtime.jsx)("span", {
+					className: SettingsDocumentAction_module_css_default.error,
+					role: "alert",
+					children: t("openDocument.error")
+				}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					size: "sm",
+					disabled: state.opening,
+					onClick: () => {
+						controller.open();
+					},
+					children: t("openDocument")
+				})]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/settings-document-store.js
+		/** State owner for the optional local settings-document action. */
+		function messageOf$1(error) {
+			return error instanceof Error ? error.message : String(error);
+		}
+		/** Loads local-document availability and invokes the pathless Host-owned open operation. */
+		var SettingsDocumentStore = class {
+			api;
+			/** uSES-safe state source shared by the registered header action. */
+			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+				status: "idle",
+				opening: false,
+				error: null
+			});
+			generation = 0;
+			/**
+			* @param api - loopback settings wire face that reports and opens the provider document.
+			*/
+			constructor(api) {
+				this.api = api;
+			}
+			/**
+			* Load whether the current provider owns a local document.
+			* @returns after the latest metadata response updates the store.
+			*/
+			async load() {
+				const generation = ++this.generation;
+				this.store.update((state) => {
+					state.status = "loading";
+					state.error = null;
+				});
+				try {
+					const { result } = await this.api.settings.describe({});
+					if (generation !== this.generation) return;
+					if (!result.ok) {
+						this.store.update((state) => {
+							state.status = "unavailable";
+							state.error = result.error.message;
+						});
+						return;
+					}
+					this.store.update((state) => {
+						state.status = result.value.hasDocument ? "ready" : "unavailable";
+						state.error = null;
+					});
+				} catch (error) {
+					if (generation !== this.generation) return;
+					this.store.update((state) => {
+						state.status = "unavailable";
+						state.error = messageOf$1(error);
+					});
+				}
+			}
+			/**
+			* Open the loaded document once; concurrent gestures collapse behind the in-flight action.
+			* @returns after the native-open request settles, or immediately when unavailable/already opening.
+			*/
+			async open() {
+				const current = this.store.getSnapshot();
+				if (current.status !== "ready" || current.opening) return;
+				this.store.update((state) => {
+					state.opening = true;
+					state.error = null;
+				});
+				try {
+					const response = await this.api.settings.openDocument({});
+					if (!response.result.ok) throw new Error(response.result.error.message);
+				} catch (error) {
+					this.store.update((state) => {
+						state.error = messageOf$1(error);
+					});
+				} finally {
+					this.store.update((state) => {
+						state.opening = false;
+					});
+				}
+			}
+		};
+		/**
+		* Refresh document availability after reconnect only when a surface has already requested it.
+		* @param controller - optional loopback document state owner.
+		*/
+		function refreshDocumentIfLoaded(controller) {
+			if (controller === void 0 || controller.store.getSnapshot().status === "idle") return;
+			controller.load();
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/WelcomeNotice.module.css.mjs
+		const css = ".k2cPoG_page{z-index:1;box-sizing:border-box;width:min(640px,100vw - 64px);max-height:100vh;color:var(--dsw-alias-label-primary);--welcome-ease-out:cubic-bezier(.23, 1, .32, 1);padding:clamp(64px,9vh,104px) 0 40px;position:relative;overflow-y:auto}.k2cPoG_brand{color:var(--dsw-alias-label-primary);align-items:center;margin-bottom:42px;display:flex}.k2cPoG_title{letter-spacing:-.02em;outline:none;margin:0;font-size:28px;font-weight:600;line-height:36px}.k2cPoG_opening,.k2cPoG_reflection,.k2cPoG_feedback,.k2cPoG_error{margin:0}.k2cPoG_opening{margin-top:30px}.k2cPoG_reflection{margin-top:36px;padding:0}.k2cPoG_feedback{margin-top:30px}.k2cPoG_opening,.k2cPoG_reflection,.k2cPoG_feedback{color:var(--dsw-alias-label-secondary);font-size:16px;line-height:28px}.k2cPoG_feedback strong{color:inherit;font-weight:500}.k2cPoG_footer{justify-content:flex-end;margin-top:32px;display:flex}.k2cPoG_error{color:var(--dsw-alias-state-error-primary);margin-top:20px;font-size:14px;line-height:22px}.k2cPoG_primary{min-width:120px;transition:transform .14s var(--welcome-ease-out)}.k2cPoG_primary:active:not(:disabled){transform:scale(.97)}.k2cPoG_brand,.k2cPoG_title,.k2cPoG_opening,.k2cPoG_reflection,.k2cPoG_feedback,.k2cPoG_footer{animation:k2cPoG_welcome-enter .28s var(--welcome-ease-out) both}.k2cPoG_title{animation-delay:40ms}.k2cPoG_opening{animation-delay:80ms}.k2cPoG_reflection{animation-delay:.12s}.k2cPoG_feedback{animation-delay:.16s}.k2cPoG_footer{animation-delay:.2s}@keyframes k2cPoG_welcome-enter{0%{opacity:0;transform:translateY(8px)}to{opacity:1;transform:translateY(0)}}@media (prefers-reduced-motion:reduce){.k2cPoG_brand,.k2cPoG_title,.k2cPoG_opening,.k2cPoG_reflection,.k2cPoG_feedback,.k2cPoG_footer{animation:none}.k2cPoG_primary{transition:none}}@media (width<=560px){.k2cPoG_page{width:calc(100vw - 40px);padding-top:38px}.k2cPoG_brand{margin-bottom:30px}.k2cPoG_opening{margin-top:24px}.k2cPoG_reflection,.k2cPoG_feedback{margin-top:28px}.k2cPoG_footer{margin-top:30px}.k2cPoG_primary{width:100%}}";
+		const tagId = "@deepseek-ai/dsh-client-ui-settings-general/WelcomeNotice.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-settings-general";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var WelcomeNotice_module_css_default = {
+			"page": "k2cPoG_page",
+			"error": "k2cPoG_error",
+			"title": "k2cPoG_title",
+			"footer": "k2cPoG_footer",
+			"brand": "k2cPoG_brand",
+			"welcome-enter": "k2cPoG_welcome-enter",
+			"feedback": "k2cPoG_feedback",
+			"primary": "k2cPoG_primary",
+			"reflection": "k2cPoG_reflection",
+			"opening": "k2cPoG_opening"
+		};
+		//#endregion
+		//#region lib/types/client/WelcomeNotice.js
+		/** Product-wide, versioned first-run welcome step. */
+		function emphasizedFeedback(paragraph, emphasis) {
+			const index = paragraph.indexOf(emphasis);
+			/* v8 ignore next -- both locale values derive from one owner object that contains the emphasis */
+			if (index < 0) return paragraph;
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				paragraph.slice(0, index),
+				(0, react_jsx_runtime.jsx)("strong", { children: emphasis }),
+				paragraph.slice(index + emphasis.length)
+			] });
+		}
+		/** Render the mandatory notice until its current version is acknowledged. */
+		function WelcomeNotice(props) {
+			const { complete, controller, useSnapshot, t } = props;
+			const state = useSnapshot((snapshot) => snapshot);
+			const finished = (0, react.useRef)(false);
+			const titleRef = (0, react.useRef)(null);
+			const finish = (0, react.useCallback)(() => {
+				if (finished.current) return;
+				finished.current = true;
+				complete();
+			}, [complete]);
+			(0, react.useEffect)(() => {
+				if (state.status === "idle") controller.load();
+			}, [controller, state.status]);
+			(0, react.useEffect)(() => {
+				if (state.acknowledged) finish();
+			}, [finish, state.acknowledged]);
+			(0, react.useEffect)(() => {
+				if (state.status === "ready" && !state.acknowledged) titleRef.current?.focus();
+			}, [state.acknowledged, state.status]);
+			if (state.status === "idle" || state.status === "loading" || state.acknowledged) return null;
+			const acknowledge = async () => {
+				if (await controller.acknowledge()) finish();
+			};
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.OnboardingSurface, { children: (0, react_jsx_runtime.jsxs)("section", {
+				className: WelcomeNotice_module_css_default.page,
+				role: "region",
+				"aria-labelledby": "welcome-notice-title",
+				children: [
+					(0, react_jsx_runtime.jsx)("div", {
+						className: WelcomeNotice_module_css_default.brand,
+						"aria-hidden": "true",
+						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.BrandWordmark, { size: 24 })
+					}),
+					(0, react_jsx_runtime.jsx)("h2", {
+						ref: titleRef,
+						id: "welcome-notice-title",
+						className: WelcomeNotice_module_css_default.title,
+						tabIndex: -1,
+						children: t("welcome.title")
+					}),
+					(0, react_jsx_runtime.jsx)("p", {
+						className: WelcomeNotice_module_css_default.opening,
+						children: t("welcome.paragraph.0")
+					}),
+					(0, react_jsx_runtime.jsx)("blockquote", {
+						className: WelcomeNotice_module_css_default.reflection,
+						children: t("welcome.paragraph.1")
+					}),
+					(0, react_jsx_runtime.jsx)("p", {
+						className: WelcomeNotice_module_css_default.feedback,
+						children: emphasizedFeedback(t("welcome.paragraph.2"), t("welcome.feedbackEmphasis"))
+					}),
+					state.error === null ? null : (0, react_jsx_runtime.jsx)("p", {
+						className: WelcomeNotice_module_css_default.error,
+						role: "alert",
+						children: t("welcome.error")
+					}),
+					(0, react_jsx_runtime.jsx)("div", {
+						className: WelcomeNotice_module_css_default.footer,
+						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							variant: "primary",
+							className: WelcomeNotice_module_css_default.primary,
+							disabled: state.status === "saving",
+							onClick: () => {
+								acknowledge();
+							},
+							children: t("welcome.continue")
+						})
+					})
+				]
+			}) });
+		}
+		//#endregion
+		//#region lib/types/onboarding-copy.js
+		/** Durable settings namespace for product-wide GUI onboarding facts. */
+		const WELCOME_NOTICE_SETTINGS_NAMESPACE = "ui-onboarding";
+		/** Field storing the last welcome notice version the user acknowledged. */
+		const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
+		/**
+		* Bump only when the notice changes materially and every user should see it
+		* again. The acknowledgement is compared for exact equality.
+		*/
+		const WELCOME_NOTICE_VERSION = "2026-07-30.7";
+		/** The complete editable welcome notice in both supported GUI locales. */
+		const WELCOME_NOTICE_COPY = {
+			zh: {
+				title: "内测声明",
+				paragraphs: [
+					"感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。",
+					"“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。",
+					"为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"
+				],
+				feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们",
+				continueLabel: "继续"
+			},
+			en: {
+				title: "内测声明",
+				paragraphs: [
+					"感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。",
+					"“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。",
+					"为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"
+				],
+				feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们",
+				continueLabel: "继续"
+			}
+		};
+		//#endregion
+		//#region lib/types/client/welcome-store.js
+		/** Welcome-notice state, durable when the browser may use Host settings. */
+		function messageOf(error) {
+			return error instanceof Error ? error.message : String(error);
+		}
+		function acknowledgementOf(view) {
+			if (typeof view.value !== "object" || view.value === null) return void 0;
+			const value = view.value[WELCOME_NOTICE_ACK_FIELD];
+			return typeof value === "string" ? value : void 0;
+		}
+		/** Coordinates durable Host acknowledgement or a process-local remote fallback. */
+		var WelcomeNoticeStore = class {
+			api;
+			persistence;
+			/** uSES-safe state source shared by the registered welcome step. */
+			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+				status: "idle",
+				acknowledged: false,
+				error: null
+			});
+			generation = 0;
+			/**
+			* @param api - settings wire face used for durable reads and writes.
+			* @param persistence - remote browsers use memory because settings is loopback-only.
+			*/
+			constructor(api, persistence = "host") {
+				this.api = api;
+				this.persistence = persistence;
+			}
+			/** Load the acknowledgement from Host settings or initialize process-local state. */
+			async load() {
+				const generation = ++this.generation;
+				if (this.persistence === "memory") {
+					this.store.update((state) => {
+						state.status = "ready";
+						state.error = null;
+					});
+					return;
+				}
+				this.store.update((state) => {
+					state.status = "loading";
+					state.error = null;
+				});
+				try {
+					const response = await this.api.settings.describe({});
+					if (!response.result.ok) throw new Error(response.result.error.message);
+					const view = response.result.value.namespaces.find((candidate) => candidate.ns === WELCOME_NOTICE_SETTINGS_NAMESPACE);
+					if (view === void 0) throw new Error("welcome acknowledgement settings are unavailable");
+					if (generation !== this.generation) return;
+					this.store.update((state) => {
+						state.status = "ready";
+						state.acknowledged = acknowledgementOf(view) === WELCOME_NOTICE_VERSION;
+						state.error = null;
+					});
+				} catch (error) {
+					if (generation !== this.generation) return;
+					this.store.update((state) => {
+						state.status = "error";
+						state.acknowledged = false;
+						state.error = messageOf(error);
+					});
+				}
+			}
+			/**
+			* Acknowledge this copy version. The Host path mutation is idempotent across
+			* tabs and preserves sibling settings; remote fallback changes only this store.
+			* @returns true when the selected persistence mode accepted the acknowledgement.
+			*/
+			async acknowledge() {
+				const generation = ++this.generation;
+				if (this.persistence === "memory") {
+					this.store.update((state) => {
+						state.status = "ready";
+						state.acknowledged = true;
+						state.error = null;
+					});
+					return true;
+				}
+				this.store.update((state) => {
+					state.status = "saving";
+					state.error = null;
+				});
+				try {
+					const response = await this.api.settings.mutate({
+						ns: WELCOME_NOTICE_SETTINGS_NAMESPACE,
+						ops: [{
+							op: "set",
+							path: [WELCOME_NOTICE_ACK_FIELD],
+							value: WELCOME_NOTICE_VERSION
+						}]
+					});
+					if (!response.result.ok) throw new Error(response.result.error.message);
+					if (generation === this.generation) this.store.update((state) => {
+						state.status = "ready";
+						state.acknowledged = true;
+						state.error = null;
+					});
+					return true;
+				} catch (error) {
+					if (generation === this.generation) this.store.update((state) => {
+						state.status = "error";
+						state.acknowledged = false;
+						state.error = messageOf(error);
+					});
+					return false;
+				}
+			}
+		};
+		/**
+		* Refresh only after welcome state has left idle. A memory-mode load retains
+		* acknowledgement so reconnect and settings-change refreshes do not reopen a
+		* process-local notice.
+		* @param controller - welcome state owner whose current status decides whether to load.
+		*/
+		function refreshWelcomeIfLoaded(controller) {
+			if (controller.store.getSnapshot().status === "idle") return;
+			controller.load();
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Shell chrome, General-nav, and welcome-notice dictionaries; feature rows own their copy. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"trigger": "设置",
+			"title": "设置",
+			"close": "关闭",
+			"openDocument": "打开配置文件",
+			"openDocument.error": "无法打开配置文件",
+			"general.nav": "通用设置",
+			"welcome.title": WELCOME_NOTICE_COPY.zh.title,
+			"welcome.paragraph.0": WELCOME_NOTICE_COPY.zh.paragraphs[0],
+			"welcome.paragraph.1": WELCOME_NOTICE_COPY.zh.paragraphs[1],
+			"welcome.paragraph.2": WELCOME_NOTICE_COPY.zh.paragraphs[2],
+			"welcome.feedbackEmphasis": WELCOME_NOTICE_COPY.zh.feedbackEmphasis,
+			"welcome.continue": WELCOME_NOTICE_COPY.zh.continueLabel,
+			"welcome.error": "暂时无法保存确认状态，请重试。"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"trigger": "Settings",
+			"title": "Settings",
+			"close": "Close",
+			"openDocument": "Open configuration file",
+			"openDocument.error": "Could not open configuration file",
+			"general.nav": "General",
+			"welcome.title": WELCOME_NOTICE_COPY.en.title,
+			"welcome.paragraph.0": WELCOME_NOTICE_COPY.en.paragraphs[0],
+			"welcome.paragraph.1": WELCOME_NOTICE_COPY.en.paragraphs[1],
+			"welcome.paragraph.2": WELCOME_NOTICE_COPY.en.paragraphs[2],
+			"welcome.feedbackEmphasis": WELCOME_NOTICE_COPY.en.feedbackEmphasis,
+			"welcome.continue": WELCOME_NOTICE_COPY.en.continueLabel,
+			"welcome.error": "The acknowledgement could not be saved. Please try again."
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin (shell chrome + General copy). */
+		const NS = "settings";
+		/**
+		* Required services (cordis fiber inject). The target slots are declared by
+		* ui-settings' apply, whose activation order relative to this one is NOT
+		* constrained; registrations depend on their slots through `slots.inject()`.
+		*/
+		const inject = [
+			"slots",
+			"locale",
+			"connection"
+		];
+		/**
+		* Register the `settings` dictionaries, the chrome content, and the General
+		* section, each once its slot declaration is on the ledger.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-settings-general: dictionaries");
+			const t = ctx.locale.bind(NS);
+			const connection = ctx.get("connection");
+			const documentController = connection.isLoopback ? new SettingsDocumentStore(connection.api) : void 0;
+			const documentInjected = documentController === void 0 ? void 0 : (() => {
+				const useSnapshot = (0, _deepseek_ai_dsh_client_web_react.bindSnapshotSelector)(documentController.store);
+				return () => ({
+					controller: documentController,
+					useSnapshot
+				});
+			})();
+			const welcomeController = new WelcomeNoticeStore(connection.api, connection.isLoopback ? "host" : "memory");
+			const useWelcomeSnapshot = (0, _deepseek_ai_dsh_client_web_react.bindSnapshotSelector)(welcomeController.store);
+			const welcomeInjected = () => ({
+				controller: welcomeController,
+				useSnapshot: useWelcomeSnapshot
+			});
+			ctx.effect(() => {
+				const refresh = (ns) => {
+					if (ns !== void 0 && ns !== "ui-onboarding") return;
+					refreshWelcomeIfLoaded(welcomeController);
+				};
+				const disposers = [ctx.on("settings/changed", refresh), ctx.on("connection/reset", () => {
+					refresh();
+					refreshDocumentIfLoaded(documentController);
+				})];
+				return () => {
+					for (const dispose of disposers) dispose();
+				};
+			}, "ui-settings-general: metadata invalidations");
+			ctx.slots.inject("settings.trigger", () => ctx.slots.register({
+				name: "settings.trigger",
+				locale: NS
+			}, TriggerContent));
+			ctx.slots.inject("settings.header", () => ctx.slots.register({
+				name: "settings.header",
+				locale: NS
+			}, HeaderContent));
+			if (documentInjected !== void 0) ctx.slots.inject("settings.action", () => ctx.slots.register({
+				name: "settings.action",
+				id: "open-document",
+				order: 0,
+				locale: NS,
+				inject: documentInjected
+			}, SettingsDocumentAction));
+			ctx.slots.inject("settings.close", () => ctx.slots.register({
+				name: "settings.close",
+				locale: NS
+			}, CloseLabel));
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "general",
+				order: 0,
+				label: () => t("general.nav"),
+				locale: NS,
+				children: { "settings.general.item": {
+					kind: "list",
+					scope: "root"
+				} }
+			}, GeneralSection));
+			ctx.slots.inject("settings.onboarding", () => ctx.slots.register({
+				name: "settings.onboarding",
+				id: "welcome-notice",
+				order: -100,
+				locale: NS,
+				inject: welcomeInjected
+			}, WelcomeNotice));
+		}
+		//#endregion
+		exports.SettingsDocumentStore = SettingsDocumentStore;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,47 @@
+import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+//#region lib/types/onboarding-copy.js
+/** Durable settings namespace for product-wide GUI onboarding facts. */
+const WELCOME_NOTICE_SETTINGS_NAMESPACE = "ui-onboarding";
+/** Field storing the last welcome notice version the user acknowledged. */
+const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
+/**
+* Bump only when the notice changes materially and every user should see it
+* again. The acknowledgement is compared for exact equality.
+*/
+const WELCOME_NOTICE_VERSION = "2026-07-30.7";
+/** The complete editable welcome notice in both supported GUI locales. */
+const WELCOME_NOTICE_COPY = {
+	zh: {
+		title: "内测声明",
+		paragraphs: [
+			"感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。",
+			"“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。",
+			"为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"
+		],
+		feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们",
+		continueLabel: "继续"
+	},
+	en: {
+		title: "内测声明",
+		paragraphs: [
+			"感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。",
+			"“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。",
+			"为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"
+		],
+		feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们",
+		continueLabel: "继续"
+	}
+};
+//#endregion
+//#region lib/types/index.js
+/** Host loader entry for the browser implementation exported from `./client`. */
+const OnboardingSettingsSchema = z.object({ [WELCOME_NOTICE_ACK_FIELD]: z.string() });
+/** Register the durable GUI-onboarding section when a settings provider exists. */
+function apply(ctx) {
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.register(settingsNamespace(WELCOME_NOTICE_SETTINGS_NAMESPACE), OnboardingSettingsSchema);
+	});
+}
+//#endregion
+export { WELCOME_NOTICE_ACK_FIELD, WELCOME_NOTICE_COPY, WELCOME_NOTICE_SETTINGS_NAMESPACE, WELCOME_NOTICE_VERSION, apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-settings-general`.
+* @module @deepseek-ai/dsh-client-ui-settings-general/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-settings-general";
+/** Cordis companion plugin name. */
+const name = "client-ui-settings-general-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the settings seam validates and publishes the durable
+* welcome section, while slot conflicts fail loud in the slot core. The local
+* document action is browser state over typed RPC responses and is covered by
+* store/component tests rather than a Cordis runtime relationship.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,11 @@
+/** The General section: one column rendering feature-owned item contributions. */
+import type { PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Full component props: section owner share plus item render share. */
+export type GeneralSectionComponentProps = PropsRuntime<'settings.section'> & PropsRenderSlots<'settings.general.item'>;
+/**
+ * Render the General section content column.
+ * @param props - composed slot props (contract/slots.ts).
+ * @returns the section element tree.
+ */
+export declare function GeneralSection({ renderSlot }: GeneralSectionComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=GeneralSection.d.ts.map

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

@@ -0,0 +1,21 @@
+/** Optional settings-header action for opening a file-backed Host document. */
+import type { ReactNode } from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-web-react';
+import type { SettingsDocumentState, SettingsDocumentStore } from './settings-document-store.ts';
+/** Registrant-owned dependencies of {@link SettingsDocumentAction}. */
+export interface SettingsDocumentActionInjected {
+    /** Provider metadata and action state owner. */
+    controller: SettingsDocumentStore;
+    /** Bound selector hook for the controller snapshot. */
+    useSnapshot: SnapshotSelectorHook<SettingsDocumentState>;
+}
+/** Header-action owner share, localized copy, and the registrant's state face. */
+export type SettingsDocumentActionProps = PropsRuntime<'settings.action'> & PropsLocale<'settings'> & SettingsDocumentActionInjected;
+/**
+ * Render the open-document action only after Host metadata confirms document availability.
+ * @param props - header owner props, localized copy, and injected document state.
+ * @returns the action, or null while unavailable or unresolved.
+ */
+export declare function SettingsDocumentAction({ controller, useSnapshot, t }: SettingsDocumentActionProps): ReactNode;
+//# sourceMappingURL=SettingsDocumentAction.d.ts.map

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

@@ -0,0 +1,15 @@
+/** Product-wide, versioned first-run welcome step. */
+import type { ReactNode } from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-web-react';
+import type { WelcomeNoticeState, WelcomeNoticeStore } from './welcome-store.ts';
+/** Registrant-owned dependencies of {@link WelcomeNotice}. */
+export interface WelcomeNoticeInjected {
+    controller: WelcomeNoticeStore;
+    useSnapshot: SnapshotSelectorHook<WelcomeNoticeState>;
+}
+/** Coordinator owner props plus the welcome step's injected face. */
+export type WelcomeNoticeProps = PropsRuntime<'settings.onboarding'> & PropsLocale<'settings'> & WelcomeNoticeInjected;
+/** Render the mandatory notice until its current version is acknowledged. */
+export declare function WelcomeNotice(props: WelcomeNoticeProps): ReactNode;
+//# sourceMappingURL=WelcomeNotice.d.ts.map

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

@@ -0,0 +1,26 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Trigger content props: the sidebar column state + the standard locale seat. */
+export type TriggerContentProps = PropsRuntime<'settings.trigger'> & PropsLocale<'settings'>;
+/** Header content props: the standard locale seat only. */
+export type HeaderContentProps = PropsRuntime<'settings.header'> & PropsLocale<'settings'>;
+/**
+ * Render the trigger row content (icon; label only in the wide column).
+ * @param props - composed slot props.
+ * @returns the trigger content fragment.
+ */
+export declare function TriggerContent({ wide, t }: TriggerContentProps): import("react").JSX.Element;
+/**
+ * Render the panel title text.
+ * @param props - composed slot props.
+ * @returns the title text node.
+ */
+export declare function HeaderContent({ t }: HeaderContentProps): import("react").JSX.Element;
+/** Close-button label text props: the standard locale seat only. */
+export type CloseLabelProps = PropsRuntime<'settings.close'> & PropsLocale<'settings'>;
+/**
+ * Render the close button's visually-hidden label text.
+ * @param props - composed slot props.
+ * @returns the label text node.
+ */
+export declare function CloseLabel({ t }: CloseLabelProps): import("react").JSX.Element;
+//# sourceMappingURL=chrome.d.ts.map

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

@@ -0,0 +1,36 @@
+/**
+ * Settings ownerless-copy plugin, browser half: registers everything on the
+ * Settings surface that belongs to no single feature — the trigger/header
+ * chrome content, local-document action, General section, and `settings`
+ * dictionaries. Feature-owned rows and sections stay with their features.
+ * Export discipline: packages/client/AGENTS.md.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type SettingsKey } from './locales.ts';
+export type { CloseLabelProps, HeaderContentProps, TriggerContentProps, } from './chrome.tsx';
+export type { GeneralSectionComponentProps, } from './GeneralSection.tsx';
+export type { SettingsDocumentActionInjected, SettingsDocumentActionProps } from './SettingsDocumentAction.tsx';
+export type { SettingsDocumentState } from './settings-document-store.ts';
+export { SettingsDocumentStore } from './settings-document-store.ts';
+export type { WelcomeNoticeInjected, WelcomeNoticeProps } from './WelcomeNotice.tsx';
+export type { WelcomeNoticeState } from './welcome-store.ts';
+export type { SettingsKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Shell chrome + shell-owned General section copy. */
+        settings: SettingsKey;
+    }
+}
+/**
+ * Required services (cordis fiber inject). The target slots are declared by
+ * ui-settings' apply, whose activation order relative to this one is NOT
+ * constrained; registrations depend on their slots through `slots.inject()`.
+ */
+export declare const inject: string[];
+/**
+ * Register the `settings` dictionaries, the chrome content, and the General
+ * section, each once its slot declaration is on the ledger.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,35 @@
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    trigger: string;
+    title: string;
+    close: string;
+    openDocument: string;
+    'openDocument.error': string;
+    'general.nav': string;
+    'welcome.title': "内测声明";
+    'welcome.paragraph.0': "感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。";
+    'welcome.paragraph.1': "“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。";
+    'welcome.paragraph.2': "为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。";
+    'welcome.feedbackEmphasis': "如果您有任何反馈与建议，请在企业微信群中留言告诉我们";
+    'welcome.continue': "继续";
+    'welcome.error': string;
+};
+/** The settings namespace key union. */
+export type SettingsKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    trigger: string;
+    title: string;
+    close: string;
+    openDocument: string;
+    'openDocument.error': string;
+    'general.nav': string;
+    'welcome.title': "内测声明";
+    'welcome.paragraph.0': "感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。";
+    'welcome.paragraph.1': "“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。";
+    'welcome.paragraph.2': "为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。";
+    'welcome.feedbackEmphasis': "如果您有任何反馈与建议，请在企业微信群中留言告诉我们";
+    'welcome.continue': "继续";
+    'welcome.error': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/settings-document-store.d.ts

@@ -0,0 +1,39 @@
+/** State owner for the optional local settings-document action. */
+import type { IApiClient } from '@deepseek-ai/dsh-client-connection/client';
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** Browser state of the Host-owned settings document. */
+export interface SettingsDocumentState {
+    /** Metadata-loading phase; unavailable means the provider has no local document or the read failed. */
+    status: 'idle' | 'loading' | 'ready' | 'unavailable';
+    /** Whether one native-open request is in flight. */
+    opening: boolean;
+    /** Last metadata/native-open diagnostic; UI exposes only localized copy. */
+    error: string | null;
+}
+/** Loads local-document availability and invokes the pathless Host-owned open operation. */
+export declare class SettingsDocumentStore {
+    private readonly api;
+    /** uSES-safe state source shared by the registered header action. */
+    readonly store: SnapshotStore<SettingsDocumentState>;
+    private generation;
+    /**
+     * @param api - loopback settings wire face that reports and opens the provider document.
+     */
+    constructor(api: Pick<IApiClient, 'settings'>);
+    /**
+     * Load whether the current provider owns a local document.
+     * @returns after the latest metadata response updates the store.
+     */
+    load(): Promise<void>;
+    /**
+     * Open the loaded document once; concurrent gestures collapse behind the in-flight action.
+     * @returns after the native-open request settles, or immediately when unavailable/already opening.
+     */
+    open(): Promise<void>;
+}
+/**
+ * Refresh document availability after reconnect only when a surface has already requested it.
+ * @param controller - optional loopback document state owner.
+ */
+export declare function refreshDocumentIfLoaded(controller: SettingsDocumentStore | undefined): void;
+//# sourceMappingURL=settings-document-store.d.ts.map

package/lib/types/client/welcome-store.d.ts

@@ -0,0 +1,38 @@
+/** Welcome-notice state, durable when the browser may use Host settings. */
+import type { IApiClient } from '@deepseek-ai/dsh-client-connection/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** State rendered by the welcome step. */
+export interface WelcomeNoticeState {
+    status: 'idle' | 'loading' | 'ready' | 'saving' | 'error';
+    acknowledged: boolean;
+    error: string | null;
+}
+/** Coordinates durable Host acknowledgement or a process-local remote fallback. */
+export declare class WelcomeNoticeStore {
+    private readonly api;
+    private readonly persistence;
+    /** uSES-safe state source shared by the registered welcome step. */
+    readonly store: SnapshotStore<WelcomeNoticeState>;
+    private generation;
+    /**
+     * @param api - settings wire face used for durable reads and writes.
+     * @param persistence - remote browsers use memory because settings is loopback-only.
+     */
+    constructor(api: Pick<IApiClient, 'settings'>, persistence?: 'host' | 'memory');
+    /** Load the acknowledgement from Host settings or initialize process-local state. */
+    load(): Promise<void>;
+    /**
+     * Acknowledge this copy version. The Host path mutation is idempotent across
+     * tabs and preserves sibling settings; remote fallback changes only this store.
+     * @returns true when the selected persistence mode accepted the acknowledgement.
+     */
+    acknowledge(): Promise<boolean>;
+}
+/**
+ * Refresh only after welcome state has left idle. A memory-mode load retains
+ * acknowledgement so reconnect and settings-change refreshes do not reopen a
+ * process-local notice.
+ * @param controller - welcome state owner whose current status decides whether to load.
+ */
+export declare function refreshWelcomeIfLoaded(controller: WelcomeNoticeStore): void;
+//# sourceMappingURL=welcome-store.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,6 @@
+/** Host loader entry for the browser implementation exported from `./client`. */
+import type { Context } from '@deepseek-ai/cordis';
+export { WELCOME_NOTICE_ACK_FIELD, WELCOME_NOTICE_COPY, WELCOME_NOTICE_SETTINGS_NAMESPACE, WELCOME_NOTICE_VERSION, } from './onboarding-copy.ts';
+/** Register the durable GUI-onboarding section when a settings provider exists. */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-settings-general`.
+ * @module @deepseek-ai/dsh-client-ui-settings-general/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-settings-general-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/onboarding-copy.d.ts

@@ -0,0 +1,25 @@
+/** Durable settings namespace for product-wide GUI onboarding facts. */
+export declare const WELCOME_NOTICE_SETTINGS_NAMESPACE = "ui-onboarding";
+/** Field storing the last welcome notice version the user acknowledged. */
+export declare const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
+/**
+ * Bump only when the notice changes materially and every user should see it
+ * again. The acknowledgement is compared for exact equality.
+ */
+export declare const WELCOME_NOTICE_VERSION = "2026-07-30.7";
+/** The complete editable welcome notice in both supported GUI locales. */
+export declare const WELCOME_NOTICE_COPY: {
+    readonly zh: {
+        readonly title: "内测声明";
+        readonly paragraphs: readonly ["感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。", "“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。", "为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"];
+        readonly feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们";
+        readonly continueLabel: "继续";
+    };
+    readonly en: {
+        readonly title: "内测声明";
+        readonly paragraphs: readonly ["感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。", "“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。", "为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。"];
+        readonly feedbackEmphasis: "如果您有任何反馈与建议，请在企业微信群中留言告诉我们";
+        readonly continueLabel: "继续";
+    };
+};
+//# sourceMappingURL=onboarding-copy.d.ts.map

package/package.json

@@ -0,0 +1,84 @@
+{
+  "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.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-settings-general"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-connection"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}