dsh-ntr 0.1.1 → 0.1.2

package/lib/types/client/acp-ui.d.ts

@@ -281,6 +281,14 @@ export declare function closeAcpMenu(): void;
 export declare function setAcpMenuError(error?: string): void;
 /** Subscribe to the open-picker state (both the chips and the overlay read it). */
 export declare function useAcpMenu(): MenuState | null;
+/** Open the NTR settings dialog (the empty agent roster's way forward). */
+export declare function openAcpSettingsDialog(): void;
+/** Close the NTR settings dialog (close button, mask click, Escape). */
+export declare function closeAcpSettingsDialog(): void;
+/** Current dialog state, for tests and non-React readers. */
+export declare function acpSettingsDialogIsOpen(): boolean;
+/** Subscribe to the dialog state (the root overlay entry reads it). */
+export declare function useAcpSettingsDialogOpen(): boolean;
 /** One selectable row of a picker. */
 export interface AcpMenuItem {
     id: string;

package/lib/types/client/session-controls.d.ts

@@ -49,10 +49,12 @@
  * 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.
  */
 import type { CSSProperties } from 'react';
 import type { AcpChatInjected, AcpMenuKind, AcpMenuSection, AcpSessionHook } from './acp-ui.tsx';
@@ -88,6 +90,16 @@ interface RouteInfo {
     effectiveEffort?: string;
     effortLabel?: string;
 }
+/**
+ * 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.
+ */
+export declare function agentBaseHasData(bound: ChatSessionView | undefined, agents: readonly AgentView[], rosterLoaded: boolean): boolean;
 /**
  * The agent this conversation is LOCKED to, if its first ACP turn has run.
  *
@@ -202,9 +214,11 @@ export declare function advancedOptions(catalog: AgentCatalogResult | undefined,
  * 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.
  */
-export declare function agentBaseChip(route: RouteInfo, routed: boolean, acp: AcpChatInjected['acp']): {
+export declare function agentBaseChip(route: RouteInfo, routed: boolean, acp: AcpChatInjected['acp'], rosterEmpty?: boolean): {
     label: string;
     title: string;
 };
@@ -269,6 +283,13 @@ export interface MenuContext {
  * `agentId@value`.
  */
 export declare 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.
+ */
+export declare const OPEN_SETTINGS_ITEM = "__open-settings__";
 /**
  * REMOVED on purpose (2026-10-17): the agent's own `session/set_mode` list used
  * to ride inside the agent base's menu. It has its own control

package/lib/types/client/settings-dialog.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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`).
+ */
+import type { AcpStore } from './store.ts';
+/** The root overlay entry's inject face. */
+export interface AcpSettingsDialogProps {
+    acp: AcpStore;
+}
+/** Frame-wide NTR settings surface; renders nothing while closed. */
+export declare function AcpSettingsDialog(props: AcpSettingsDialogProps): import("react").JSX.Element | null;

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

@@ -118,6 +118,12 @@ export interface UiState {
     localeRev: number;
     stream: 'init' | 'live' | 'down';
     agents: AgentView[];
+    /**
+     * Whether the host has answered `agents/list` at least once in this page.
+     * `agents: []` alone cannot tell "no agent configured" from "not read yet";
+     * a surface that offers a setup entry on an empty roster must wait for this.
+     */
+    agentsLoaded: boolean;
     sessions: SessionView[];
     activeSessionId?: string;
     blocks: Block[];

package/locale/en.json

@@ -1,5 +1,5 @@
 {
   "meta": {
-    "description": "Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent, stream its session, answer permission requests as a human."
+    "description": "Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent and stream its session."
   }
 }

package/locale/zh.json

@@ -1,5 +1,5 @@
 {
   "meta": {
-    "description": "面向 DSH Web 界面的 ACP（Agent Client Protocol）客户端：接入任意支持 ACP 的 agent，实时展示它的会话，权限请求由你亲自答复。"
+    "description": "面向 DSH Web 界面的 ACP（Agent Client Protocol）客户端：接入任意支持 ACP 的 agent，实时展示它的会话。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ntr",
-  "version": "0.1.1",
-  "description": "Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent, stream its session, answer permission requests as a human.",
+  "version": "0.1.2",
+  "description": "Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent and stream its session.",
   "repository": "https://github.com/GDWhisper/dsh-ntr.git",
   "type": "module",
   "main": "lib/index.js",

package/src/client/acp-ui.tsx

@@ -434,6 +434,54 @@ export function useAcpMenu(): MenuState | null {
   )
 }
 
+// ---- The NTR settings dialog ----
+
+/**
+ * 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 = new Set<() => void>()
+
+function emitSettingsDialog(): void {
+  for (const listener of [...settingsDialogListeners]) listener()
+}
+
+/** Open the NTR settings dialog (the empty agent roster's way forward). */
+export function openAcpSettingsDialog(): void {
+  if (settingsDialogOpen) return
+  settingsDialogOpen = true
+  emitSettingsDialog()
+}
+
+/** Close the NTR settings dialog (close button, mask click, Escape). */
+export function closeAcpSettingsDialog(): void {
+  if (!settingsDialogOpen) return
+  settingsDialogOpen = false
+  emitSettingsDialog()
+}
+
+/** Current dialog state, for tests and non-React readers. */
+export function acpSettingsDialogIsOpen(): boolean {
+  return settingsDialogOpen
+}
+
+/** Subscribe to the dialog state (the root overlay entry reads it). */
+export function useAcpSettingsDialogOpen(): boolean {
+  return useSyncExternalStore(
+    cb => {
+      settingsDialogListeners.add(cb)
+      return () => { settingsDialogListeners.delete(cb) }
+    },
+    acpSettingsDialogIsOpen,
+  )
+}
+
 // ---- Menu presentation ----
 
 /** One selectable row of a picker. */
@@ -883,6 +931,26 @@ const STYLE = `
 .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 = false

package/src/client/index.tsx

@@ -18,6 +18,7 @@ import { AcpSettingsSection } from './panel.tsx'
 import { AcpComposerMode } from './composer-mode.tsx'
 import { AcpComposerAgentTag, AcpSessionControls, AcpSessionMenu } from './session-controls.tsx'
 import { AcpConversationView } from './acp-view.tsx'
+import { AcpSettingsDialog } from './settings-dialog.tsx'
 import {
   createModelSeatClaim,
   createPermissionSeatClaim,
@@ -173,6 +174,19 @@ export function apply(ctx: Context): void {
     inject: () => ({ acp: store }),
   }, AcpSettingsSection)), 'dsh-ntr: settings section')
 
+  // The same NTR settings, opened from the composer when the agent roster is
+  // empty (the agent base's picker action). It rides the frame's overlay layer
+  // because the composer seat and the dialog live in unrelated slot trees; the
+  // host settings shell has no programmatic open seam, so the dialog mounts the
+  // same section the shell mounts (see settings-dialog.tsx). Renders nothing
+  // while closed.
+  ctx.effect(() => ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+    name: 'shell.overlay',
+    id: 'acp-settings-dialog',
+    order: 30,
+    inject: () => ({ acp: store }),
+  }, AcpSettingsDialog as unknown as SlotComponent<any>)), 'dsh-ntr: NTR settings dialog')
+
   // The agent's OWN modes sit in the composer tool row — the seat the slot
   // contract reserves for exactly this ("entries sit beside that chrome, never
   // replace it"). They are a different layer from everything the host controls:

package/src/client/panel.tsx

@@ -147,16 +147,18 @@ const STYLE = `
 .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; }
@@ -173,7 +175,19 @@ const STYLE = `
 .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; }
@@ -190,7 +204,6 @@ const STYLE = `
   .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; }
@@ -198,6 +211,7 @@ const STYLE = `
 }
 @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; }
 }
 `
 
@@ -1535,6 +1549,23 @@ function RowMenu({
   )
 }
 
+/**
+ * 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: HTMLElement): void {
+  const view = row.querySelector<HTMLElement>('.dwa-model-row-value')
+  const text = view?.querySelector<HTMLElement>('.dwa-model-row-value-text')
+  if (view === null || view === undefined || text === null || text === undefined) 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
@@ -1597,6 +1628,11 @@ function ModelCatalogBlock({
   const modelChoices = result?.catalog.model?.choices ?? []
   /** Result of the last click on 「检测可用模型」 (what the refresh changed). */
   const [detectNote, setDetectNote] = useState<string | undefined>(undefined)
+  // Each list folds on its own so a long selection can be parked while the
+  // other pane keeps the full column. The list stays mounted (display-toggled)
+  // to keep its scroll position.
+  const [allCollapsed, setAllCollapsed] = useState(false)
+  const [selectedCollapsed, setSelectedCollapsed] = useState(false)
 
   // Display read, not a probe: the host answers from its persisted catalog
   // cache, so the panes already list the known models the first time the card
@@ -1846,7 +1882,7 @@ function ModelCatalogBlock({
         </div>
 
         <div className="dwa-model-transfer">
-          <div className="dwa-model-pane">
+          <div className={`dwa-model-pane${allCollapsed ? ' is-collapsed' : ''}`}>
             <div className="dwa-model-pane-head">
               <span>{acp.label('全部模型', 'All models')}</span>
               {result !== undefined && <span className="dwa-badge">{modelChoices.length}</span>}
@@ -1859,6 +1895,15 @@ function ModelCatalogBlock({
               >
                 {acp.label('全部加入', 'Add all')}
               </button>
+              <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')}
+              >
+                <span className="dwa-caret" aria-hidden>{allCollapsed ? '▸' : '▾'}</span>
+              </button>
             </div>
             <div className="dwa-model-list">
               {visibleChoices.map(choice => {
@@ -1876,6 +1921,7 @@ function ModelCatalogBlock({
                     className={`dwa-model-row${checked ? ' is-on' : ''}`}
                     title={title}
                     onClick={() => toggleChoice(choice.value)}
+                    onPointerEnter={event => { armModelIdMarquee(event.currentTarget) }}
                   >
                     <span className="dwa-model-row-mark">{checked ? '✓' : '+'}</span>
                     <span className="dwa-model-row-name">
@@ -1883,7 +1929,17 @@ function ModelCatalogBlock({
                       {choice.name}
                     </span>
                     {choice.value !== choice.name && (
-                      <span className="dwa-model-row-value">{choice.value}</span>
+                      <span className="dwa-model-row-value">
+                        <span className="dwa-model-row-value-text">{choice.value}</span>
+                      </span>
+                    )}
+                    {/* Credit / capability notes belong on the row itself: the
+                        list exists to compare models, and a hover-only price
+                        cannot be scanned. Grouped choices reuse the group label
+                        as their fallback description — that one is already
+                        printed before the name. */}
+                    {choice.description !== undefined && choice.description !== choice.group && (
+                      <span className="dwa-model-row-desc">{choice.description}</span>
                     )}
                   </button>
                 )
@@ -1892,7 +1948,7 @@ function ModelCatalogBlock({
             </div>
           </div>
 
-          <div className="dwa-model-pane">
+          <div className={`dwa-model-pane${selectedCollapsed ? ' is-collapsed' : ''}`}>
             <div className="dwa-model-pane-head">
               <span>{acp.label('已选模型', 'Selected models')}</span>
               <span className="dwa-badge dwa-badge-info">{basis.length}</span>
@@ -1904,6 +1960,15 @@ function ModelCatalogBlock({
               >
                 {acp.label('清空', 'Clear')}
               </button>
+              <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')}
+              >
+                <span className="dwa-caret" aria-hidden>{selectedCollapsed ? '▸' : '▾'}</span>
+              </button>
             </div>
             <div className="dwa-model-list">
               {selectedChoices.length === 0 && (
@@ -1918,13 +1983,19 @@ function ModelCatalogBlock({
                   className="dwa-model-row is-on"
                   title={choice.description === undefined ? choice.value : `${choice.value}\n${choice.description}`}
                   onClick={() => toggleChoice(choice.value)}
+                  onPointerEnter={event => { armModelIdMarquee(event.currentTarget) }}
                 >
                   <span className="dwa-model-row-name">
                     {choice.group !== undefined && <span style={{ opacity: 0.7 }}>{choice.group} · </span>}
                     {choice.name}
                   </span>
                   {choice.value !== choice.name && (
-                    <span className="dwa-model-row-value">{choice.value}</span>
+                    <span className="dwa-model-row-value">
+                      <span className="dwa-model-row-value-text">{choice.value}</span>
+                    </span>
+                  )}
+                  {choice.description !== undefined && choice.description !== choice.group && (
+                    <span className="dwa-model-row-desc">{choice.description}</span>
                   )}
                   <span className="dwa-model-row-remove" aria-hidden="true">×</span>
                 </button>

package/src/client/session-controls.tsx

@@ -49,10 +49,12 @@
  * 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.
  */
 
 import { useEffect, useState } from 'react'
@@ -61,7 +63,7 @@ import type { CSSProperties } from 'react'
 import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
 import {
   AcpChip, AcpMenu, AcpShatterParts, buildAcpModelId, closeAcpMenu, ensureAcpStyle,
-  openAcpMenu, setAcpMenuError, splitAcpModelId, useAcpMenu, useUi,
+  openAcpMenu, openAcpSettingsDialog, setAcpMenuError, splitAcpModelId, useAcpMenu, useUi,
 } from './acp-ui.tsx'
 import { playAgentLockAnim, useAgentLockPhase } from './agent-lock-anim.ts'
 import type {
@@ -150,6 +152,23 @@ function routeAgentId(
   return undefined
 }
 
+/**
+ * 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.
+ */
+export function agentBaseHasData(
+  bound: ChatSessionView | undefined,
+  agents: readonly AgentView[],
+  rosterLoaded: boolean,
+): boolean {
+  return bound !== undefined || agents.length > 0 || rosterLoaded
+}
+
 /**
  * The agent this conversation is LOCKED to, if its first ACP turn has run.
  *
@@ -374,21 +393,29 @@ export function advancedOptions(
  * 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.
  */
 export function agentBaseChip(
   route: RouteInfo,
   routed: boolean,
   acp: AcpChatInjected['acp'],
+  rosterEmpty = false,
 ): { label: string; title: string } {
   const label = route.agentTitle === undefined
     ? (routed ? 'NTR' : acp.label('选择 Agent', 'Choose agent'))
     : `NTR · ${route.agentTitle}`
   const title = route.agentId === undefined
-    ? acp.label(
-      '这条会话当前没有 NTR agent 服务；点开可选择 agent',
-      'No NTR agent is serving this conversation right now — open to choose one',
-    )
+    ? 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',
@@ -530,9 +557,12 @@ export function AcpSessionControls(props: AcpClusterProps) {
     lockedTo ?? ui.chatBoundAgent[sessionId],
     choice,
   )
-  // A conversation with no ACP story to tell gets no chrome: the ACP view tab
-  // owns the entry point for starting one.
-  if (bound === undefined && agents.length === 0) return null
+  // An empty roster is the SETUP case, not "no story": the base stays and its
+  // picker carries the way into NTR settings. Only the window before the host
+  // has answered `agents/list` stays blank — `agents: []` there means "not read
+  // yet", and the setup entry would accuse a configured deployment (see
+  // `agentBaseHasData`).
+  if (!agentBaseHasData(bound, agents, ui.agentsLoaded)) return null
   // Set up = an agent serves this conversation: a live session, a persisted
   // pick, the host's optimistic binding, OR the plugin default the guard's
   // route rewrite falls back to. The last one is what makes a brand-new
@@ -613,7 +643,7 @@ export function AcpSessionControls(props: AcpClusterProps) {
           itself is the shatter played here (see `shattering`). */}
       {showAgentBase && (
         <AcpChip
-          {...agentBaseChip(route, routed, acp)}
+          {...agentBaseChip(route, routed, acp, agents.length === 0)}
           active={routed}
           className={shattering ? 'ntr-acp-shatter' : undefined}
           onClick={shattering ? undefined : (trigger) => { open('agent', trigger) }}
@@ -648,6 +678,14 @@ export interface MenuContext {
  */
 export 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.
+ */
+export const OPEN_SETTINGS_ITEM = '__open-settings__'
+
 /** The agent roster rows: one row per configured ACP agent, current one marked. */
 function agentSection(context: MenuContext): AcpMenuSection {
   const { acp, route } = context
@@ -659,12 +697,21 @@ function agentSection(context: MenuContext): AcpMenuSection {
     active: route.agentId === agent.id,
   }))
   if (items.length === 0) {
+    // The base stays on an empty roster (see `agentBaseHasData`), so this menu
+    // is the setup surface: a status row that says what is missing, then an
+    // ACTION row that opens the NTR settings. The action is a row of its own
+    // because a disabled status row cannot be the way forward.
     items.push({
       id: 'none',
       label: acp.label('还没有配置 NTR agent', 'No NTR agent configured yet'),
-      detail: acp.label('设置 → NTR', 'Settings → NTR'),
+      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',
@@ -987,6 +1034,15 @@ export function AcpSessionMenu(props: AcpClusterProps) {
         if (agentId !== undefined) await acp.probeModels(agentId)
         return
       }
+      if (sectionId === 'agent' && itemId === OPEN_SETTINGS_ITEM) {
+        // The empty roster's way out (see `agentSection`): there is no agent to
+        // bind, so this row opens the NTR settings surface instead. Close the
+        // picker first — the dialog is a frame overlay and the menu must not
+        // linger behind it.
+        closeAcpMenu()
+        openAcpSettingsDialog()
+        return
+      }
       if (sectionId === 'agent') {
         await acp.bindChatAgent(sessionId, itemId)
       } else if (sectionId === 'model') {