dsh-ntr 0.1.0 → 0.1.2

package/lib/client.js

@@ -270,8 +270,10 @@ window.__ModuleLoader__.load({
 			locale;
 			state = {
 				open: false,
+				localeRev: 0,
 				stream: "init",
 				agents: [],
+				agentsLoaded: false,
 				sessions: [],
 				blocks: [],
 				permissions: [],
@@ -343,6 +345,8 @@ window.__ModuleLoader__.load({
 			seatCatalogReads = /* @__PURE__ */ new Set();
 			/** In-flight `agent/cached-models` reads, keyed by agent id. */
 			cachedModelReads = /* @__PURE__ */ new Set();
+			/** Counts behind the last successful explicit re-detect, so a locale switch can re-render its summary. */
+			detectCounts;
 			constructor(rpc, locale) {
 				this.rpc = rpc;
 				this.locale = locale;
@@ -476,6 +480,7 @@ window.__ModuleLoader__.load({
 					const detectedAgents = detectResult && detectResult.agents.length > 0 ? detectResult.agents : this.state.detectedAgents.length > 0 ? this.state.detectedAgents : [...DEFAULT_KNOWN_PRESETS];
 					this.mutate({
 						agents,
+						agentsLoaded: true,
 						sessions,
 						defaultAgent: defaultAgentInfo?.agentId,
 						detectedAgents,
@@ -495,14 +500,19 @@ window.__ModuleLoader__.load({
 					const result = await this.call("agents/detect");
 					const agents = result.agents.length > 0 ? result.agents : [...DEFAULT_KNOWN_PRESETS];
 					const installed = agents.filter((agent) => agent.detected).length;
+					this.detectCounts = {
+						total: agents.length,
+						installed
+					};
 					this.mutate({
 						detectedAgents: agents,
 						detecting: false,
-						detectSummary: this.locale(`已检测 ${String(agents.length)} 个预设：${String(installed)} 个已安装，其余可从「添加智能体」启用。`, `Detected ${String(agents.length)} presets: ${String(installed)} installed, enable the rest via "Add agent".`)
+						detectSummary: this.detectSummaryOf(agents.length, installed)
 					});
 				} catch (error) {
 					const msg = error instanceof Error ? error.message : String(error);
 					const notice = msg.includes("unknown endpoint agents/detect") ? this.locale("宿主服务运行着旧版本代码，请在终端重启 dsh web 服务以激活主机检测功能。", "Host running older version. Please restart dsh web to enable agent detection.") : msg;
+					this.detectCounts = void 0;
 					this.mutate({
 						detecting: false,
 						notice,
@@ -511,6 +521,9 @@ window.__ModuleLoader__.load({
 					});
 				}
 			}
+			detectSummaryOf(total, installed) {
+				return this.locale(`已检测 ${String(total)} 个预设：${String(installed)} 个已安装，其余可从「添加智能体」启用。`, `Detected ${String(total)} presets: ${String(installed)} installed, enable the rest via "Add agent".`);
+			}
 			async saveAgent(payload) {
 				try {
 					await this.call("agent/save", payload);
@@ -1254,6 +1267,19 @@ window.__ModuleLoader__.load({
 			* renders or every row re-renders on every store notification.
 			*/
 			label = (zh, en) => this.locale(zh, en);
+			/**
+			* Republish the snapshot after a locale switch. Every `label()` resolves
+			* against the current language while rendering, so a notification is all
+			* that is needed — except the detect summary, which the store owns as an
+			* already-resolved string and rebuilds from its counts here.
+			*/
+			refreshLocale() {
+				const counts = this.detectCounts;
+				this.mutate({
+					localeRev: this.state.localeRev + 1,
+					...counts === void 0 ? {} : { detectSummary: this.detectSummaryOf(counts.total, counts.installed) }
+				});
+			}
 			clearNotice() {
 				this.mutate({ notice: void 0 });
 			}
@@ -1812,6 +1838,45 @@ window.__ModuleLoader__.load({
 			}, () => menuState);
 		}
 		/**
+		* Open state of the frame-wide NTR settings dialog (`settings-dialog.tsx`).
+		*
+		* Module-level because the two ends live in unrelated slot trees: the trigger
+		* is the composer's agent base (a session-scoped model-seat entry) and the
+		* dialog itself rides the root `shell.overlay` layer. A React context cannot
+		* span that boundary, so this is the same tiny external-store seam the menu
+		* uses above.
+		*/
+		let settingsDialogOpen = false;
+		const settingsDialogListeners = /* @__PURE__ */ new Set();
+		function emitSettingsDialog() {
+			for (const listener of [...settingsDialogListeners]) listener();
+		}
+		/** Open the NTR settings dialog (the empty agent roster's way forward). */
+		function openAcpSettingsDialog() {
+			if (settingsDialogOpen) return;
+			settingsDialogOpen = true;
+			emitSettingsDialog();
+		}
+		/** Close the NTR settings dialog (close button, mask click, Escape). */
+		function closeAcpSettingsDialog() {
+			if (!settingsDialogOpen) return;
+			settingsDialogOpen = false;
+			emitSettingsDialog();
+		}
+		/** Current dialog state, for tests and non-React readers. */
+		function acpSettingsDialogIsOpen() {
+			return settingsDialogOpen;
+		}
+		/** Subscribe to the dialog state (the root overlay entry reads it). */
+		function useAcpSettingsDialogOpen() {
+			return (0, react.useSyncExternalStore)((cb) => {
+				settingsDialogListeners.add(cb);
+				return () => {
+					settingsDialogListeners.delete(cb);
+				};
+			}, acpSettingsDialogIsOpen);
+		}
+		/**
 		* Pure popup placement, viewport coordinates: the menu docks with its right
 		* edge under the trigger's, `gap`px above it — and only then clamps to the
 		* viewport (flip below when the top has no room, slide left at the right edge).
@@ -2344,6 +2409,26 @@ window.__ModuleLoader__.load({
 .ntr-acp-empty-hint { color: var(--dsw-alias-text-secondary, #6b7280); font-size: 12px; }
 .ntr-acp-seat-diag { font-family: var(--dsw-alias-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace); opacity: 0.72; word-break: break-word; }
 .ntr-acp-empty-actions { display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; }
+/* ---- NTR settings dialog (shell.overlay) ---- */
+/* Frame-wide surface opened from the agent base's empty-roster menu. The
+   overlay layer itself is click-through, so the layer opts back in and blocks
+   the app while it is up. */
+.ntr-acp-dialog-layer { position: fixed; inset: 0; z-index: 1000; display: flex; align-items: center; justify-content: center; pointer-events: auto; }
+.ntr-acp-dialog-mask { position: absolute; inset: 0; background: var(--dsw-alias-bg-mask-1, rgba(0, 0, 0, 0.4)); }
+.ntr-acp-dialog {
+  position: relative; display: flex; flex-direction: column; overflow: hidden;
+  width: min(920px, calc(100vw - 48px)); height: min(820px, calc(100vh - 48px));
+  background: var(--dsw-alias-bg-layer-2, #fff); color: inherit;
+  border-radius: 24px; box-shadow: var(--dsw-elevation-prominent, 0 24px 60px rgba(0, 0, 0, 0.25));
+}
+.ntr-acp-dialog-head { flex: none; display: flex; align-items: center; gap: 8px; padding: 16px 16px 8px 24px; }
+.ntr-acp-dialog-title { flex: 1; font-size: 16px; font-weight: 600; }
+.ntr-acp-dialog-close { font: inherit; font-size: 14px; line-height: 1; width: 30px; height: 30px; padding: 0; border: none; border-radius: 999px; background: none; color: inherit; cursor: pointer; }
+.ntr-acp-dialog-close:hover { background: var(--dsw-alias-interactive-bg-active, #0000000d); }
+.ntr-acp-dialog-body { flex: 1; min-height: 0; overflow: auto; }
+/* The section brings its own page scroll for the settings shell's content
+   column; the dialog body is the scroll owner here. */
+.ntr-acp-dialog-body > .dwa-root { max-width: none; overflow: visible; }
 `;
 		let styleMounted$1 = false;
 		/** Mount the shared stylesheet once (same pattern as the settings panel's). */
@@ -2492,16 +2577,18 @@ window.__ModuleLoader__.load({
 .dwa-inline-setting { display: flex; align-items: flex-start; gap: 10px; padding: 10px 12px; border-radius: var(--ntr-radius-sm); background: var(--dsw-alias-bg-layer-2, #f9fafb); }
 .dwa-inline-setting .dwa-switch { flex-shrink: 0; margin-top: 1px; }
 .dwa-setting-copy { color: var(--ntr-muted); font-size: var(--ntr-font-xs); }
-/* Panes stay flush (equal height) whatever the two list lengths are; the
-   shorter list's list body grows to fill, so its leftover is scrolling room
-   inside the list rather than a detached block under the last row. */
-.dwa-model-transfer { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; align-items: stretch; }
-/* Tall enough for a comfortable selection (about ten rows) before scrolling:
-   both panes share this ceiling, so equal heights cost at most one row of
-   slack on the shorter side instead of a whole empty half. */
+/* Stacked, not side by side: the rows carry name, id and credit, and a
+   half-width pane truncated them at every realistic settings width. Each list
+   gets the whole column instead. */
+.dwa-model-transfer { display: grid; grid-template-columns: minmax(0, 1fr); gap: 10px; }
+/* Tall enough for a comfortable selection (about ten rows) before scrolling;
+   the cap keeps the two stacked panes from pushing the rest of the card away. */
 .dwa-model-pane { min-width: 0; max-height: 360px; display: flex; flex-direction: column; border: var(--ntr-line); border-radius: var(--ntr-radius-sm); background: var(--dsw-alias-bg-layer-1, #fff); overflow: hidden; }
 .dwa-model-pane-head { display: flex; align-items: center; gap: 6px; padding: 7px 9px; border-bottom: var(--ntr-line); font-size: var(--ntr-font-xs); font-weight: 600; color: var(--dsw-alias-text-secondary, #4b5563); }
 .dwa-model-pane-head .dwa-btn { margin-left: auto; min-height: 26px; padding: 2px 8px; font-size: var(--ntr-font-xs); }
+.dwa-model-pane-head .dwa-caret-btn { flex: none; width: 22px; height: 22px; background: transparent; }
+.dwa-model-pane-head .dwa-caret-btn:hover { background: var(--dsw-alias-interactive-bg-active, #e5e7eb); }
+.dwa-model-pane.is-collapsed .dwa-model-list { display: none; }
 .dwa-model-list { display: flex; flex-direction: column; gap: 2px; padding: 5px; flex: 1 1 auto; min-height: 0; overflow-y: auto; }
 .dwa-model-section { margin-top: 12px; display: flex; flex-direction: column; gap: 8px; font-size: 12px; }
 .dwa-model-toolbar { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
@@ -2518,7 +2605,19 @@ window.__ModuleLoader__.load({
 .dwa-model-row.is-on { background: #3b82f614; color: #2563eb; }
 .dwa-model-row-mark { width: 12px; flex: none; text-align: center; opacity: 0.75; }
 .dwa-model-row-name { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.dwa-model-row-value { flex: 0 1 auto; max-width: 45%; opacity: 0.55; font-size: 10px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* Name and credit keep their room; the id is the only cell that collapses. */
+.dwa-model-row-desc { flex: 0 0 auto; max-width: 45%; opacity: 0.75; font-size: 10px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* The trailing 14px is reserved for the fade mask: while the id fits, the
+   gradient only covers empty padding; once it overflows, its tail dissolves
+   instead of ending in a hard ellipsis. armModelIdMarquee reads the same
+   padding to scroll the full text under the pointer. */
+.dwa-model-row-value { flex: 0 1 auto; flex-shrink: 1000; box-sizing: border-box; min-width: 0; max-width: 45%; padding-right: 14px; opacity: 0.55; font-size: 10px; overflow: hidden; white-space: nowrap; mask-image: linear-gradient(to right, #000 calc(100% - 14px), transparent); -webkit-mask-image: linear-gradient(to right, #000 calc(100% - 14px), transparent); }
+.dwa-model-row-value-text { display: inline-block; white-space: nowrap; }
+.dwa-model-row:hover .dwa-model-row-value-text { animation: dwa-model-id-marquee var(--dwa-id-duration, 1.4s) ease-in-out 0.2s infinite alternate; }
+@keyframes dwa-model-id-marquee {
+  from { transform: translateX(0); }
+  to { transform: translateX(var(--dwa-id-shift, 0px)); }
+}
 .dwa-model-row-remove { flex: none; opacity: 0.5; padding: 0 2px; }
 .dwa-model-row:hover .dwa-model-row-remove { opacity: 1; }
 .dwa-seg { display: inline-flex; border-radius: var(--ntr-radius-sm); border: 1px solid var(--dsw-alias-border-l2, #d1d5db); overflow: hidden; vertical-align: middle; }
@@ -2535,7 +2634,6 @@ window.__ModuleLoader__.load({
   .dwa-page-header { flex-direction: column; }
   .dwa-page-actions { width: 100%; }
   .dwa-page-actions .dwa-btn { width: 100%; }
-  .dwa-model-transfer { grid-template-columns: 1fr; }
   .dwa-model-toolbar-actions { width: 100%; }
   .dwa-model-search { flex: 1 1 auto; width: auto; }
   .dwa-subsection-head, .dwa-preference-row { align-items: flex-start; flex-direction: column; }
@@ -2543,6 +2641,7 @@ window.__ModuleLoader__.load({
 }
 @media (prefers-reduced-motion: reduce) {
   .dwa-root *, .dwa-root *::before, .dwa-root *::after { transition: none !important; }
+  .dwa-model-row:hover .dwa-model-row-value-text { animation: none !important; }
 }
 `;
 		let styleMounted = false;
@@ -3837,6 +3936,22 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
+		* Measure the id cell on row hover so its CSS marquee can reach the end of the
+		* text. The id is the only cell that yields width, and the panel is resizable,
+		* so the overflow is re-read on every entry rather than cached. The animation
+		* itself lives in CSS and only runs while the row is hovered; `title` on the
+		* row stays the fallback for reduced-motion users.
+		*/
+		function armModelIdMarquee(row) {
+			const view = row.querySelector(".dwa-model-row-value");
+			const text = view?.querySelector(".dwa-model-row-value-text");
+			if (view === null || view === void 0 || text === null || text === void 0) return;
+			const fade = Number.parseFloat(getComputedStyle(view).paddingRight) || 0;
+			const shift = Math.max(0, text.offsetWidth - (view.clientWidth - fade));
+			row.style.setProperty("--dwa-id-shift", `${String(-shift)}px`);
+			row.style.setProperty("--dwa-id-duration", `${String(Math.min(4, Math.max(1.2, shift / 30)))}s`);
+		}
+		/**
 		* Model / thought-level catalog display plus the native-selector visibility
 		* filter, as a two-pane transfer list: every known model on the left, the
 		* selection that reaches the NTR surfaces on the right. Variants are still
@@ -3872,6 +3987,8 @@ window.__ModuleLoader__.load({
 			const modelChoices = result?.catalog.model?.choices ?? [];
 			/** Result of the last click on 「检测可用模型」 (what the refresh changed). */
 			const [detectNote, setDetectNote] = (0, react.useState)(void 0);
+			const [allCollapsed, setAllCollapsed] = (0, react.useState)(false);
+			const [selectedCollapsed, setSelectedCollapsed] = (0, react.useState)(false);
 			(0, react.useEffect)(() => {
 				if (!active) return;
 				acp.loadCachedModels(agentId);
@@ -4075,7 +4192,7 @@ window.__ModuleLoader__.load({
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dwa-model-transfer",
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dwa-model-pane",
+								className: `dwa-model-pane${allCollapsed ? " is-collapsed" : ""}`,
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "dwa-model-pane-head",
 									children: [
@@ -4091,6 +4208,18 @@ window.__ModuleLoader__.load({
 											onClick: addVisible,
 											title: acp.label("把当前搜索范围内的模型全部加入右侧", "Add every model matching the current search"),
 											children: acp.label("全部加入", "Add all")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "dwa-caret-btn",
+											"aria-expanded": !allCollapsed,
+											onClick: () => setAllCollapsed((value) => !value),
+											title: allCollapsed ? acp.label("展开全部模型", "Expand all models") : acp.label("收起全部模型", "Collapse all models"),
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dwa-caret",
+												"aria-hidden": true,
+												children: allCollapsed ? "▸" : "▾"
+											})
 										})
 									]
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -4103,6 +4232,9 @@ window.__ModuleLoader__.load({
 											className: `dwa-model-row${checked ? " is-on" : ""}`,
 											title,
 											onClick: () => toggleChoice(choice.value),
+											onPointerEnter: (event) => {
+												armModelIdMarquee(event.currentTarget);
+											},
 											children: [
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dwa-model-row-mark",
@@ -4117,7 +4249,14 @@ window.__ModuleLoader__.load({
 												}),
 												choice.value !== choice.name && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 													className: "dwa-model-row-value",
-													children: choice.value
+													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+														className: "dwa-model-row-value-text",
+														children: choice.value
+													})
+												}),
+												choice.description !== void 0 && choice.description !== choice.group && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dwa-model-row-desc",
+													children: choice.description
 												})
 											]
 										}, choice.value);
@@ -4127,7 +4266,7 @@ window.__ModuleLoader__.load({
 									})]
 								})]
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dwa-model-pane",
+								className: `dwa-model-pane${selectedCollapsed ? " is-collapsed" : ""}`,
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "dwa-model-pane-head",
 									children: [
@@ -4142,6 +4281,18 @@ window.__ModuleLoader__.load({
 											disabled: basis.length === 0,
 											onClick: clearAll,
 											children: acp.label("清空", "Clear")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "dwa-caret-btn",
+											"aria-expanded": !selectedCollapsed,
+											onClick: () => setSelectedCollapsed((value) => !value),
+											title: selectedCollapsed ? acp.label("展开已选模型", "Expand selected models") : acp.label("收起已选模型", "Collapse selected models"),
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dwa-caret",
+												"aria-hidden": true,
+												children: selectedCollapsed ? "▸" : "▾"
+											})
 										})
 									]
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -4154,6 +4305,9 @@ window.__ModuleLoader__.load({
 										className: "dwa-model-row is-on",
 										title: choice.description === void 0 ? choice.value : `${choice.value}\n${choice.description}`,
 										onClick: () => toggleChoice(choice.value),
+										onPointerEnter: (event) => {
+											armModelIdMarquee(event.currentTarget);
+										},
 										children: [
 											/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 												className: "dwa-model-row-name",
@@ -4164,7 +4318,14 @@ window.__ModuleLoader__.load({
 											}),
 											choice.value !== choice.name && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 												className: "dwa-model-row-value",
-												children: choice.value
+												children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dwa-model-row-value-text",
+													children: choice.value
+												})
+											}),
+											choice.description !== void 0 && choice.description !== choice.group && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dwa-model-row-desc",
+												children: choice.description
 											}),
 											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 												className: "dwa-model-row-remove",
@@ -4429,10 +4590,12 @@ window.__ModuleLoader__.load({
 		* different slots, so they share that module's phase clock rather than trying
 		* to animate across slot boundaries.
 		*
-		* It is deliberately quiet: the base renders NOTHING for a conversation no ACP
-		* agent has served, so an ordinary chat is untouched even before the gate
-		* stands down. The ACP view tab is the entry point for those (and for re-entry
-		* after a detour through another provider).
+		* It is deliberately quiet: outside ACP mode the gate never mounts it, and
+		* before the host has answered the agent roster it renders nothing. Once the
+		* roster is KNOWN to be empty the base stays and its picker carries the
+		* "open NTR settings" action — an NTR conversation with nothing configured
+		* still has a way forward instead of an empty cell. The ACP view tab remains
+		* the entry point for conversations no agent has served.
 		*/
 		const STATE_COLORS = {
 			ready: "#22c55e",
@@ -4477,6 +4640,18 @@ window.__ModuleLoader__.load({
 			if (defaultAgent !== void 0 && agents.some((agent) => agent.id === defaultAgent)) return defaultAgent;
 		}
 		/**
+		* Whether the agent base has anything honest to show.
+		*
+		* An empty roster has two meanings, and they must not be conflated: before the
+		* host answers `agents/list` it means "not read yet" (rendering a setup entry
+		* there would accuse a correctly configured deployment on every page load),
+		* while after the answer it means "nothing is configured" — exactly the state
+		* that must keep the base and offer the way into NTR settings.
+		*/
+		function agentBaseHasData(bound, agents, rosterLoaded) {
+			return bound !== void 0 || agents.length > 0 || rosterLoaded;
+		}
+		/**
 		* The agent this conversation is LOCKED to, if its first ACP turn has run.
 		*
 		* The host's `lockedAgentId` is the durable answer: it is written when the
@@ -4641,12 +4816,14 @@ window.__ModuleLoader__.load({
 		* The tooltip claims only what the menu behind the chip does: switch the agent.
 		* The agent's models and thought levels have chips of their own (user decision,
 		* 2026-10-17), so the previous wording — "switch the agent, its model and the
-		* thought level" — promised a menu that holds the roster alone.
+		* thought level" — promised a menu that holds the roster alone. An EMPTY
+		* roster is its own case: the menu cannot switch to anything, it offers the
+		* way into NTR settings, so the tooltip says that instead of promising a pick.
 		*/
-		function agentBaseChip(route, routed, acp) {
+		function agentBaseChip(route, routed, acp, rosterEmpty = false) {
 			return {
 				label: route.agentTitle === void 0 ? routed ? "NTR" : acp.label("选择 Agent", "Choose agent") : `NTR · ${route.agentTitle}`,
-				title: route.agentId === void 0 ? acp.label("这条会话当前没有 NTR agent 服务；点开可选择 agent", "No NTR agent is serving this conversation right now — open to choose one") : acp.label("这条会话由外接 NTR agent 服务；点开可切换 agent", "This conversation is served by an external NTR agent — open to switch the agent")
+				title: route.agentId === void 0 ? rosterEmpty ? acp.label("这条会话当前没有 NTR agent；点开可前往 NTR 设置添加", "No NTR agent is serving this conversation — open to set one up in NTR settings") : acp.label("这条会话当前没有 NTR agent 服务；点开可选择 agent", "No NTR agent is serving this conversation right now — open to choose one") : acp.label("这条会话由外接 NTR agent 服务；点开可切换 agent", "This conversation is served by an external NTR agent — open to switch the agent")
 			};
 		}
 		/**
@@ -4757,7 +4934,7 @@ window.__ModuleLoader__.load({
 				agentId
 			]);
 			const route = describeRoute(agents, bound, lockedTo === void 0 ? ui.defaultAgent : void 0, catalog, lockedTo ?? ui.chatBoundAgent[sessionId], choice);
-			if (bound === void 0 && agents.length === 0) return null;
+			if (!agentBaseHasData(bound, agents, ui.agentsLoaded)) return null;
 			const routed = route.agentId !== void 0;
 			(0, react.useEffect)(() => {
 				if (lockedTo === void 0 || menu === null) return;
@@ -4807,7 +4984,7 @@ window.__ModuleLoader__.load({
 						}
 					}),
 					showAgentBase && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AcpChip, {
-						...agentBaseChip(route, routed, acp),
+						...agentBaseChip(route, routed, acp, agents.length === 0),
 						active: routed,
 						className: shattering ? "ntr-acp-shatter" : void 0,
 						onClick: shattering ? void 0 : (trigger) => {
@@ -4826,6 +5003,13 @@ window.__ModuleLoader__.load({
 		* `agentId@value`.
 		*/
 		const REFRESH_CATALOG_ITEM = "__refresh-catalog__";
+		/**
+		* The empty roster's setup action. Like the model picker's refresh row it is an
+		* ACTION inside the picker, not an agent: agent ids match
+		* `[a-z0-9][a-z0-9._-]{0,63}` (no leading underscore), so no real id can
+		* collide with it.
+		*/
+		const OPEN_SETTINGS_ITEM = "__open-settings__";
 		/** The agent roster rows: one row per configured ACP agent, current one marked. */
 		function agentSection(context) {
 			const { acp, route } = context;
@@ -4836,12 +5020,19 @@ window.__ModuleLoader__.load({
 				dot: STATE_COLORS[agent.state],
 				active: route.agentId === agent.id
 			}));
-			if (items.length === 0) items.push({
-				id: "none",
-				label: acp.label("还没有配置 NTR agent", "No NTR agent configured yet"),
-				detail: acp.label("设置 → NTR", "Settings → NTR"),
-				disabled: true
-			});
+			if (items.length === 0) {
+				items.push({
+					id: "none",
+					label: acp.label("还没有配置 NTR agent", "No NTR agent configured yet"),
+					detail: acp.label("添加并启用一个 agent 后即可开始对话", "Add and enable an agent to start"),
+					disabled: true
+				});
+				items.push({
+					id: OPEN_SETTINGS_ITEM,
+					label: acp.label("打开 NTR 设置", "Open NTR settings"),
+					detail: acp.label("添加或启用 agent", "Add or enable an agent")
+				});
+			}
 			return {
 				id: "agent",
 				items
@@ -5072,6 +5263,11 @@ window.__ModuleLoader__.load({
 						if (agentId !== void 0) await acp.probeModels(agentId);
 						return;
 					}
+					if (sectionId === "agent" && itemId === "__open-settings__") {
+						closeAcpMenu();
+						openAcpSettingsDialog();
+						return;
+					}
 					if (sectionId === "agent") await acp.bindChatAgent(sessionId, itemId);
 					else if (sectionId === "model") await acp.setChatSessionModel(sessionId, itemId, agentId);
 					else if (sectionId === "thought") await acp.setChatSessionEffort(sessionId, itemId === "provider-default" ? void 0 : itemId, agentId);
@@ -5436,9 +5632,10 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
-		* One stream block, dispatched by kind. Memoized on its props — `block` and
-		* the store's instance-bound `label` — so a folded batch re-renders only the
-		* rows whose block object changed (`foldUpdate` replaces blocks immutably)
+		* One stream block, dispatched by kind. Memoized on its props — `block`, the
+		* store's instance-bound `label`, and `localeRev` (it moves on a language
+		* switch, so translated copy re-renders) — so a folded batch re-renders only
+		* the rows whose block object changed (`foldUpdate` replaces blocks immutably)
 		* instead of the whole transcript on every store notification. `key` stays the
 		* index on purpose: blocks fold append-only, and identity is the block object.
 		*/
@@ -5685,12 +5882,83 @@ window.__ModuleLoader__.load({
 						children: t("还没有消息：在下面的输入框里发给它。", "Nothing yet — send it a message below.")
 					}) : transcript.blocks.map((block, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BlockView, {
 						block,
-						label: acp.label
+						label: acp.label,
+						localeRev: ui.localeRev
 					}, index))
 				})]
 			});
 		}
 		//#endregion
+		//#region src/client/settings-dialog.tsx
+		/**
+		* The NTR settings dialog, opened from the agent base's empty-roster menu.
+		*
+		* WHY A DIALOG OF OUR OWN: the host settings shell owns its open state and
+		* exposes no programmatic way in. The sidebar seat that receives `openSettings`
+		* (`settings.launcher`) is a single-occupant slot already held by the account
+		* menu, and `openSection` is only handed to `settings.onboarding` registrants —
+		* so a conversation surface cannot drive the shell's modal. This dialog mounts
+		* the SAME `AcpSettingsSection` the shell mounts, on the frame's overlay layer
+		* (`shell.overlay`): one settings surface, two entrances, no duplicated
+		* configuration logic.
+		*
+		* The trigger (composer model seat) and this dialog (root overlay) live in
+		* unrelated slot trees, so the open state is the module-level store in
+		* `acp-ui.tsx` (`openAcpSettingsDialog`).
+		*/
+		/** Frame-wide NTR settings surface; renders nothing while closed. */
+		function AcpSettingsDialog(props) {
+			ensureAcpStyle();
+			const { acp } = props;
+			const open = useAcpSettingsDialogOpen();
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const onKey = (event) => {
+					if (event.key !== "Escape") return;
+					event.preventDefault();
+					event.stopPropagation();
+					closeAcpSettingsDialog();
+				};
+				document.addEventListener("keydown", onKey, true);
+				return () => {
+					document.removeEventListener("keydown", onKey, true);
+				};
+			}, [open]);
+			if (!open) return null;
+			const title = acp.label("NTR 设置", "NTR settings");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "ntr-acp-dialog-layer",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "ntr-acp-dialog-mask",
+					"aria-hidden": true,
+					onClick: closeAcpSettingsDialog
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "ntr-acp-dialog",
+					role: "dialog",
+					"aria-modal": "true",
+					"aria-label": title,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "ntr-acp-dialog-head",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "ntr-acp-dialog-title",
+							children: title
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: "ntr-acp-dialog-close",
+							title: acp.label("关闭", "Close"),
+							"aria-label": acp.label("关闭 NTR 设置", "Close NTR settings"),
+							autoFocus: true,
+							onClick: closeAcpSettingsDialog,
+							children: "✕"
+						})]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "ntr-acp-dialog-body",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AcpSettingsSection, { acp })
+					})]
+				})]
+			});
+		}
+		//#endregion
 		//#region src/client/model-seat.tsx
 		/** Exact key of the composer's model seat (a `single`, session-scoped slot). */
 		const MODEL_SEAT_KEY = "conversation.input.model";
@@ -6237,7 +6505,7 @@ window.__ModuleLoader__.load({
 		//#region src/client/index.tsx
 		const name = "dsh-ntr-client";
 		const inject = ["slots", "connection"];
-		const zh = typeof navigator !== "undefined" && /^zh\b/i.test(navigator.language);
+		const browserPrefersZh = typeof navigator !== "undefined" && /^zh\b/i.test(navigator.language);
 		/**
 		* How long a host verdict may stand as the gate's ONLY fact source before the
 		* gate asks the host again.
@@ -6269,8 +6537,6 @@ window.__ModuleLoader__.load({
 			const rpc = ctx.get("connection")?.rpc;
 			if (rpc === void 0) throw new Error("dsh-ntr: browser connection.rpc is unavailable");
 			const call = (channel, endpoint, payload) => rpc.call(channel, endpoint, payload);
-			const store = new AcpStore(call, (zhText, enText) => zh ? zhText : enText);
-			store.start();
 			/**
 			* Resolve one optional service without injecting it. A plain `ctx.get` at
 			* call time keeps the plugin loadable when the service is absent AND picks it
@@ -6278,6 +6544,36 @@ window.__ModuleLoader__.load({
 			* also making its absence fatal.
 			*/
 			const service = (name) => ctx.get(name);
+			/**
+			* Resolve a Chinese/English pair against the shell's active locale. Read per
+			* call, so a language switch reaches every render-time `label()` call without
+			* rebuilding the store. A host without the locale service keeps the
+			* browser-derived choice the pairs shipped with.
+			*/
+			const label = (zhText, enText) => {
+				const resolved = service("locale")?.resolveText?.({
+					zh: zhText,
+					en: enText
+				});
+				return typeof resolved === "string" && resolved !== "" ? resolved : browserPrefersZh ? zhText : enText;
+			};
+			const store = new AcpStore(call, label);
+			store.start();
+			ctx.effect(() => {
+				let stop;
+				const attach = () => {
+					if (stop !== void 0) return;
+					stop = service("locale")?.subscribe?.(() => {
+						store.refreshLocale();
+					});
+				};
+				attach();
+				const stopService = ctx.on("internal/service", attach);
+				return () => {
+					stopService();
+					stop?.();
+				};
+			}, "dsh-ntr: locale switch re-render");
 			/** This session's command/projection face (`ctx.sessions`); `undefined` before it materializes. */
 			const faceFor = (sessionId) => {
 				try {
@@ -6299,6 +6595,12 @@ window.__ModuleLoader__.load({
 				label: () => "NTR",
 				inject: () => ({ acp: store })
 			}, AcpSettingsSection)), "dsh-ntr: settings section");
+			ctx.effect(() => ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+				name: "shell.overlay",
+				id: "acp-settings-dialog",
+				order: 30,
+				inject: () => ({ acp: store })
+			}, AcpSettingsDialog)), "dsh-ntr: NTR settings dialog");
 			ctx.effect(() => ctx.slots.inject("conversation.input.left", () => ctx.slots.register({
 				name: "conversation.input.left",
 				id: "acp-mode",