@fishwithcat/dsh-tui-app 0.2.2-alpha.2 → 0.2.2-alpha.3.fork.1

package/README.i18n.yaml

@@ -18,11 +18,11 @@
   en: 88c14b005e03bf78
   zh: 0b9ad8bc5a690a3c
 /deepseek-ai-dsh-tui-app/use-this-package/composing-prompting-and-interrupting:
-  en: 0bc848b77b216c5b
-  zh: fa71999a0000a4be
+  en: 34da0bc57f324c76
+  zh: 7ca36d67e490aeaf
 /deepseek-ai-dsh-tui-app/use-this-package/watching-a-subagent:
-  en: 04a9620f0df09c18
-  zh: 7e5ed8c97289009b
+  en: 06e52609345e4e25
+  zh: fde80695a5359b03
 /deepseek-ai-dsh-tui-app/use-this-package/commands:
   en: 39e96c52dda57e65
   zh: d2aade8d44940539
@@ -36,8 +36,8 @@
   en: a7daa7d1183a433f
   zh: 8abbd0d3ec08a8d6
 /deepseek-ai-dsh-tui-app/understand-the-implementation/rendering:
-  en: 60fb0ec3193dafd2
-  zh: f24cc170e73aa958
+  en: 5acabadd3a7a501d
+  zh: de3908c848d3d1fa
 /deepseek-ai-dsh-tui-app/understand-the-implementation/interaction-seams:
   en: ad6ba4563696862a
   zh: 469b082552af2e27

package/README.md

@@ -57,17 +57,17 @@ Press Shift+Tab to toggle plan mode for the session's Agent. While plan mode is
 | `Space` | Check or uncheck an option in a multi-select question |
 | `Ctrl+L` | Repaint from scratch |
 
-Exiting — Ctrl+C with nothing running, Ctrl+D, or `/quit` — restores the terminal and prints the session id as a `dsh --resume <session-id>` command, so a later invocation continues the same conversation. Resuming — that command at startup, or `/resume` in the composer — restores the stored conversation into the transcript before the composer accepts the next prompt, so the earlier prompts, replies, and Tool rows are back on screen instead of only their effects on the model. The `/resume` picker and `/sessions` label each stored session with its title — the leading words of the first human message, a generated title, or an explicit rename — beside its id, start time, and workspace. The hint is printed only where the deployment mounts a session-persistence backend; without one there is nothing for `--resume` to open.
+Exiting — Ctrl+C with nothing running, Ctrl+D, or `/quit` — restores the terminal and prints the session id as a `dsh-tui --resume <session-id>` command, so a later invocation continues the same conversation. Resuming — that command at startup, or `/resume` in the composer — restores the stored conversation into the transcript before the composer accepts the next prompt, so the earlier prompts, replies, and Tool rows are back on screen instead of only their effects on the model. The `/resume` picker and `/sessions` label each stored session with its title — the leading words of the first human message, a generated title, or an explicit rename — beside its id, start time, and workspace. The hint is printed only where the deployment mounts a session-persistence backend; without one there is nothing for `--resume` to open.
 
 ### Watching a subagent
 
 When a local subagent starts, the TUI publishes a loopback connection record and then prints a watch command as an ordinary notice:
 
 ```
-· watch: dsh watch <session-id>
+· watch: dsh-tui watch <session-id>
 ```
 
-The earlier `dsh tui --watch <session-id>` spelling also works.
+The `--watch <session-id>` application flag is equivalent.
 
 `/subagents` opens a pinned panel listing the session's delegated descendants through the subagent service, each with its activation state and the exact watch command. The read reaches stored children as well as resident ones, and a child catalog it cannot read appears as a diagnostic row. The panel refreshes when a catalog fact or lifecycle edge lands, so children that start or settle while it is open join or leave the list; the list never writes a transcript row, and the main Agent keeps streaming underneath without moving it. Up and Down or PageUp and PageDown scroll a list taller than the panel, and Enter, Esc, or Ctrl+C closes it without cancelling the Agent.
 
@@ -124,7 +124,7 @@ While the renderer owns the terminal, console writes from mounted plugins are ca
 
 ### Rendering
 
-[`src/transcript.ts`](src/transcript.ts) folds those events into ordered rows — prompts, assistant messages, retained reasoning, Tool calls with their settled outcome, approval decisions, and app notices — and invalidates its rendered lines through a revision counter, while the view re-renders only the rows that revision changed: it caches each row's lines by row identity and viewport width, so a streamed delta renders the live row alone instead of the whole transcript. A prompt renders its image markers before its text, one marker per attached image in content order, because the terminal has no thumbnail and the durable content blocks are the record of what was attached. Message rows carry a role gutter: a prompt opens with `›` and every later line continues under a `│` rule in the prompt color, while an assistant message opens with `◆` and continues under its own `│` rule, so the two roles stay apart even without color. Injected context is model input rather than conversation, so it produces a row only when its producer declared a one-line `notice` form: a workspace-instruction, skill-catalog, or runtime-context message stays in the session log, while a model switch, a plan-mode change, or a goal appears as an app notice. The footer sits under the composer in both screen strategies and occupies two lines: the workspace and Agent state right-aligned against the routed model and its reasoning effort, then the occupancy of the next request against the routed model's capacity, with the whole log's token figures at the bottom-right edge. Once the session has delegated any child, the occupancy is followed by a `● subagents (running/total)` marker — `●` while a child activation runs, `○` once every recorded child has settled — read from the same catalogs `/subagents` lists, and shown alone on a frame that knows no occupancy yet. Those figures are the decode throughput in tokens per second, the billed prompt-plus-output total, and the cache-read share of billed prompt tokens; each is omitted until it has data, the rate is the whole-log average the Web stats strip reports rather than a live instantaneous one, and the group yields before the occupancy when the terminal is too narrow for both. Plan mode adds a `plan` marker beside the Agent state, toggled by `Shift+Tab` through `ctx.planMode`. The key hints are the placeholder of the empty composer rather than a footer line: the composer is wrapped so its content line shows them until the first typed character, because the editor component renders no placeholder of its own. Occupancy and capacity come from the `contextPressure` projection of the mounted `ctx.tokenMeter`, the totals from its `tokenUsage` projection, and the throughput from the `sessionStats` projection this bundle inserts; the `(auto)` marker comes from `ctx.compaction.autoCompactionEnabled`; the model's provider qualifies the label only when the deployment registers several. [`src/views.ts`](src/views.ts) turns rows into terminal lines with [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui) components, truncating every line to the viewport width because the renderer treats an over-wide line as a component defect, and flattening a Tool heading to one line because one row owns exactly one terminal row: a multi-line argument would otherwise print its own line breaks and spill the row into the pinned footer. A picker or prompt renders as ordinary output rather than a dialog — a plain title, a blank row, and the body — anchored directly above the composer in the alternate-screen layout, with every row padded to the viewport width so the transcript cannot show through beside it. The alternate-screen renderer owns scrolling: the transcript is its primary scroll view, so PageUp/PageDown and the wheel move the transcript while the status bar and composer stay pinned; stopping the renderer writes the whole transcript back to the normal screen, so the output stays selectable after exit. `stop()` then flushes the session and writes the resume command to stderr, after the restore because the surface no longer owns the screen, and only where a persistence backend is mounted. A Tool's declared Host presentation decides its row: the call and result views resolved through `ctx.tools` while the fold runs render as a `card: 'diff'` unified diff with the Tool's own heading and a `+added -removed` count, a `card: 'terminal'` command with its description, working directory, output, and exit-status pill, a `card: 'read'` numbered line window, a `card: 'search'` grouped match or path list with its cap signal, a `card: 'web'` cited-source or fetch summary, and a `card: 'generic'` title with its salient input. A card body folds after a bounded number of lines; a settled result view replaces the pending one, an omitted result view keeps the call-time card, and a failed mutation falls back to the ordinary name-and-summary row with its error text. A Tool row's ordinary result body renders in the palette's tool-result grey rather than the assistant body's terminal foreground. The palette follows the terminal background: `colorScheme` pins dark or light, and `auto` reads the terminal's `COLORFGBG` background signal, defaulting to dark. Switching sessions releases the transcript view’s cached lines and Markdown components. Provider reasoning stays visible after streaming ends and is restored from the session log when resuming.
+[`src/transcript.ts`](src/transcript.ts) folds those events into ordered rows — prompts, assistant messages, retained reasoning, Tool calls with their settled outcome, approval decisions, and app notices — and invalidates its rendered lines through a revision counter, while the view re-renders only the rows that revision changed: it caches each row's lines by row identity and viewport width, so a streamed delta renders the live row alone instead of the whole transcript. A prompt renders its image markers before its text, one marker per attached image in content order, because the terminal has no thumbnail and the durable content blocks are the record of what was attached. Message rows mark their role on the first line: a prompt opens with `›` and an assistant message with `◆`, in that role's color, while every later line aligns under a two-space indent. The first-line glyphs keep the roles apart even without color, and no rule is drawn into the continuation lines, so copying a reply does not drag a vertical bar along. Injected context is model input rather than conversation, so it produces a row only when its producer declared a one-line `notice` form: a workspace-instruction, skill-catalog, or runtime-context message stays in the session log, while a model switch, a plan-mode change, or a goal appears as an app notice. The footer sits under the composer in both screen strategies and occupies two lines: the workspace and Agent state right-aligned against the routed model and its reasoning effort, then the occupancy of the next request against the routed model's capacity, with the whole log's token figures at the bottom-right edge. Once the session has delegated any child, the occupancy is followed by a `● subagents (running/total)` marker — `●` while a child activation runs, `○` once every recorded child has settled — read from the same catalogs `/subagents` lists, and shown alone on a frame that knows no occupancy yet. Those figures are the decode throughput in tokens per second, the billed prompt-plus-output total, and the cache-read share of billed prompt tokens; each is omitted until it has data, the rate is the whole-log average the Web stats strip reports rather than a live instantaneous one, and the group yields before the occupancy when the terminal is too narrow for both. Plan mode adds a `plan` marker beside the Agent state, toggled by `Shift+Tab` through `ctx.planMode`. The key hints are the placeholder of the empty composer rather than a footer line: the composer is wrapped so its content line shows them until the first typed character, because the editor component renders no placeholder of its own. Occupancy and capacity come from the `contextPressure` projection of the mounted `ctx.tokenMeter`, the totals from its `tokenUsage` projection, and the throughput from the `sessionStats` projection this bundle inserts; the `(auto)` marker comes from `ctx.compaction.autoCompactionEnabled`; the model's provider qualifies the label only when the deployment registers several. [`src/views.ts`](src/views.ts) turns rows into terminal lines with [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui) components, truncating every line to the viewport width because the renderer treats an over-wide line as a component defect, and flattening a Tool heading to one line because one row owns exactly one terminal row: a multi-line argument would otherwise print its own line breaks and spill the row into the pinned footer. A picker or prompt renders as ordinary output rather than a dialog — a plain title, a blank row, and the body — anchored directly above the composer in the alternate-screen layout, with every row padded to the viewport width so the transcript cannot show through beside it. The alternate-screen renderer owns scrolling: the transcript is its primary scroll view, so PageUp/PageDown and the wheel move the transcript while the status bar and composer stay pinned; stopping the renderer writes the whole transcript back to the normal screen, so the output stays selectable after exit. `stop()` then flushes the session and writes the resume command to stderr, after the restore because the surface no longer owns the screen, and only where a persistence backend is mounted. A Tool's declared Host presentation decides its row: the call and result views resolved through `ctx.tools` while the fold runs render as a `card: 'diff'` unified diff with the Tool's own heading and a `+added -removed` count, a `card: 'terminal'` command with its description, working directory, output, and exit-status pill, a `card: 'read'` numbered line window, a `card: 'search'` grouped match or path list with its cap signal, a `card: 'web'` cited-source or fetch summary, and a `card: 'generic'` title with its salient input. A card body folds after a bounded number of lines; a settled result view replaces the pending one, an omitted result view keeps the call-time card, and a failed mutation falls back to the ordinary name-and-summary row with its error text. A Tool row's ordinary result body renders in the palette's tool-result grey rather than the assistant body's terminal foreground. The palette follows the terminal background: `colorScheme` pins dark or light, and `auto` reads the terminal's `COLORFGBG` background signal, defaulting to dark. Switching sessions releases the transcript view’s cached lines and Markdown components. Provider reasoning stays visible after streaming ends and is restored from the session log when resuming.
 
 ### Interaction seams
 

package/README.zh.md

@@ -57,17 +57,17 @@ dsh
 | `Space` | 在多选问题中勾选或取消勾选一个选项 |
 | `Ctrl+L` | 全量重绘 |
 
-退出时——无运行时按 Ctrl+C、按 Ctrl+D，或执行 `/quit`——应用会恢复终端，并把会话 id 以 `dsh --resume <session-id>` 命令的形式打印出来，以便之后的调用继续同一段对话。恢复时——启动时执行该命令，或在输入框执行 `/resume`——应用会把已存储的对话恢复到对话记录中，然后才接受下一条提示，因此此前的提示、回复与工具行都会重新出现在屏幕上，而不只是留在模型上下文中。`/resume` 选择器与 `/sessions` 用会话标题——第一条人类消息的开头词语、生成的标题或显式重命名——作为标识，并在其旁显示 id、开始时间与工作区。仅当部署挂载了会话持久化后端时才会打印该提示；没有后端时 `--resume` 无可打开的对象。
+退出时——无运行时按 Ctrl+C、按 Ctrl+D，或执行 `/quit`——应用会恢复终端，并把会话 id 以 `dsh-tui --resume <session-id>` 命令的形式打印出来，以便之后的调用继续同一段对话。恢复时——启动时执行该命令，或在输入框执行 `/resume`——应用会把已存储的对话恢复到对话记录中，然后才接受下一条提示，因此此前的提示、回复与工具行都会重新出现在屏幕上，而不只是留在模型上下文中。`/resume` 选择器与 `/sessions` 用会话标题——第一条人类消息的开头词语、生成的标题或显式重命名——作为标识，并在其旁显示 id、开始时间与工作区。仅当部署挂载了会话持久化后端时才会打印该提示；没有后端时 `--resume` 无可打开的对象。
 
 ### 查看子代理
 
 本地 subagent 启动后，TUI 会先发布回环连接记录，然后以普通提示显示查看命令：
 
 ```
-· watch: dsh watch <session-id>
+· watch: dsh-tui watch <session-id>
 ```
 
-旧写法 `dsh tui --watch <session-id>` 仍可使用。
+`--watch <session-id>` 应用参数是等效写法。
 
 `/subagents` 通过子代理服务打开一个固定面板，列出当前会话委派的所有后代子代理，并给出各自的执行状态与查看命令。该读取既覆盖常驻子代理，也覆盖已存储的子代理；无法读取的子代理目录会显示为诊断行。面板在目录事实或生命周期边沿到达时刷新，因此在面板打开期间启动或结束的子代理会自动加入或离开列表；列表不写入对话记录，主 Agent 在下方继续输出也不会移动面板。列表超出面板高度时可用 Up/Down 或 PageUp/PageDown 滚动；按 Enter、Esc 或 Ctrl+C 关闭面板，不会取消主 Agent。
 
@@ -124,7 +124,7 @@ dsh
 
 ### 渲染
 
-[`src/transcript.ts`](src/transcript.ts) 把这些事件折叠为有序行——提示、assistant 消息、保留的 reasoning、带最终结果的工具调用、审批决定与应用通知——并通过修订计数器使其渲染行失效；而视图只重新渲染该修订真正改动的行：它按行身份与视口宽度缓存每一行的渲染结果，因此一次流式增量只渲染实时行，而不是整份对话记录。提示会先渲染其图片标记、再渲染文本，每个标记按内容顺序对应一张已附图片，因为终端没有缩略图，而持久内容块才是所附内容的记录。消息行带有角色侧栏：提示以 `›` 开头，其后的每一行都在提示色的 `│` 竖线下续行；assistant 消息以 `◆` 开头，并在自身颜色的 `│` 竖线下续行，因此即使没有颜色，两种角色也能区分。注入的上下文是模型输入而非对话，因此只有生产者声明了一行式 `notice` 形式时才产生行：工作区指令、技能目录与运行时上下文消息只留在会话日志中，而模型切换、plan 模式变化与 goal 以应用通知呈现。两种屏幕策略下页脚都位于输入框之下，共两行：第一行是工作区与 Agent 状态，其右侧右对齐路由模型名及其推理档位；第二行是「下一次请求相对路由模型容量的占用」，其右下角是整段会话的 token 数字。一旦本会话委派过子代理，占用之后会跟随一个 `● subagents (运行中/总数)` 标记——`●` 表示仍有子代理激活在运行，`○` 表示已记录的子代理全部结束——它读取的子代理目录与 `/subagents` 列出的是同一份；尚未得知占用时该标记单独显示。这些数字分别是解码吞吐量（每秒 token 数）、计费的提示词加输出 token 总量，以及计费提示词 token 中由缓存读取提供的占比；每项在有数据前都不显示，速率是 Web 统计条所报的整段会话平均值而非实时瞬时值，终端宽度不足时这一组会先于占用被丢弃。plan 模式开启时会在 Agent 状态旁显示 `plan` 标记，由 `Shift+Tab` 通过 `ctx.planMode` 切换。快捷键提示是空输入框的 placeholder 而非页脚的一行：应用包装了输入框，使其内容行在用户键入第一个字符前显示这些提示，因为编辑器组件本身不渲染 placeholder。占用与容量取自已挂载 `ctx.tokenMeter` 的 `contextPressure` 投影，总量取自其 `tokenUsage` 投影，吞吐量取自本 bundle 插入的 `sessionStats` 投影；`(auto)` 标记取自 `ctx.compaction.autoCompactionEnabled`；只有当部署注册了多个 provider 时，模型标签才会带上 provider。[`src/views.ts`](src/views.ts) 使用 [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui) 组件把行转为终端行，并把每一行截断到视口宽度，因为渲染器会把超宽行视为组件缺陷；工具标题还会被压成单行，因为一行只拥有一个终端行：多行参数否则会打印出自身的换行，使该行越出转录区压到固定页脚上。选择器或提示以普通输出而非对话框的形式呈现——一行普通标题、一行空行和主体——在备用屏幕布局中紧贴输入框上方，并把每一行填充到视口宽度，因此转录内容不会从旁边透出。滚动由备用屏幕渲染器负责：对话记录是它的主滚动视图，因此 PageUp/PageDown 与滚轮移动对话记录，而页脚与输入框保持固定。停止渲染器时会把整份对话记录写回普通屏幕，因此退出后输出仍可选择。`stop()` 随后落盘会话，并把 resume 命令写到 stderr：写在恢复屏幕之后，因为此时界面已不再拥有屏幕；且仅在挂载了持久化后端时写出。工具声明的 Host 呈现决定其行：折叠事件时通过 `ctx.tools` 解析出的调用与结果视图，会分别渲染为 `card: 'diff'` 的统一 diff（含工具自己的标题与 `+新增 -删除` 计数）、`card: 'terminal'` 的命令及其描述、工作目录、输出与退出状态标记、`card: 'read'` 的带行号窗口、`card: 'search'` 的分组匹配或路径列表及其截断信号、`card: 'web'` 的来源引用或抓取摘要，以及 `card: 'generic'` 的标题与关键输入。卡片主体超过限定行数后折叠；已结算的结果视图替换待定卡片，结果视图缺省时保留调用时卡片，失败的变更则回退为普通的名称加摘要行并显示错误文本。工具行的普通结果主体以调色板的工具结果灰渲染，而非 assistant 主体的终端前景色。调色板跟随终端背景：`colorScheme` 固定深色或浅色，`auto` 读取终端的 `COLORFGBG` 背景信号，读不到时默认深色。 切换会话时会释放对话记录视图缓存的行和 Markdown 组件。 模型的思考内容在流式输出结束后仍保留显示，恢复会话时也会从会话日志中还原。
+[`src/transcript.ts`](src/transcript.ts) 把这些事件折叠为有序行——提示、assistant 消息、保留的 reasoning、带最终结果的工具调用、审批决定与应用通知——并通过修订计数器使其渲染行失效；而视图只重新渲染该修订真正改动的行：它按行身份与视口宽度缓存每一行的渲染结果，因此一次流式增量只渲染实时行，而不是整份对话记录。提示会先渲染其图片标记、再渲染文本，每个标记按内容顺序对应一张已附图片，因为终端没有缩略图，而持久内容块才是所附内容的记录。消息行只在首行标记角色：提示以 `›` 开头，assistant 消息以 `◆` 开头，并使用该角色的颜色；其后的每一行都以两个空格缩进对齐。首行符号使两种角色即使没有颜色也能区分，而续行不再绘制竖线，因此复制回复时不会把 `│` 一并带走。注入的上下文是模型输入而非对话，因此只有生产者声明了一行式 `notice` 形式时才产生行：工作区指令、技能目录与运行时上下文消息只留在会话日志中，而模型切换、plan 模式变化与 goal 以应用通知呈现。两种屏幕策略下页脚都位于输入框之下，共两行：第一行是工作区与 Agent 状态，其右侧右对齐路由模型名及其推理档位；第二行是「下一次请求相对路由模型容量的占用」，其右下角是整段会话的 token 数字。一旦本会话委派过子代理，占用之后会跟随一个 `● subagents (运行中/总数)` 标记——`●` 表示仍有子代理激活在运行，`○` 表示已记录的子代理全部结束——它读取的子代理目录与 `/subagents` 列出的是同一份；尚未得知占用时该标记单独显示。这些数字分别是解码吞吐量（每秒 token 数）、计费的提示词加输出 token 总量，以及计费提示词 token 中由缓存读取提供的占比；每项在有数据前都不显示，速率是 Web 统计条所报的整段会话平均值而非实时瞬时值，终端宽度不足时这一组会先于占用被丢弃。plan 模式开启时会在 Agent 状态旁显示 `plan` 标记，由 `Shift+Tab` 通过 `ctx.planMode` 切换。快捷键提示是空输入框的 placeholder 而非页脚的一行：应用包装了输入框，使其内容行在用户键入第一个字符前显示这些提示，因为编辑器组件本身不渲染 placeholder。占用与容量取自已挂载 `ctx.tokenMeter` 的 `contextPressure` 投影，总量取自其 `tokenUsage` 投影，吞吐量取自本 bundle 插入的 `sessionStats` 投影；`(auto)` 标记取自 `ctx.compaction.autoCompactionEnabled`；只有当部署注册了多个 provider 时，模型标签才会带上 provider。[`src/views.ts`](src/views.ts) 使用 [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui) 组件把行转为终端行，并把每一行截断到视口宽度，因为渲染器会把超宽行视为组件缺陷；工具标题还会被压成单行，因为一行只拥有一个终端行：多行参数否则会打印出自身的换行，使该行越出转录区压到固定页脚上。选择器或提示以普通输出而非对话框的形式呈现——一行普通标题、一行空行和主体——在备用屏幕布局中紧贴输入框上方，并把每一行填充到视口宽度，因此转录内容不会从旁边透出。滚动由备用屏幕渲染器负责：对话记录是它的主滚动视图，因此 PageUp/PageDown 与滚轮移动对话记录，而页脚与输入框保持固定。停止渲染器时会把整份对话记录写回普通屏幕，因此退出后输出仍可选择。`stop()` 随后落盘会话，并把 resume 命令写到 stderr：写在恢复屏幕之后，因为此时界面已不再拥有屏幕；且仅在挂载了持久化后端时写出。工具声明的 Host 呈现决定其行：折叠事件时通过 `ctx.tools` 解析出的调用与结果视图，会分别渲染为 `card: 'diff'` 的统一 diff（含工具自己的标题与 `+新增 -删除` 计数）、`card: 'terminal'` 的命令及其描述、工作目录、输出与退出状态标记、`card: 'read'` 的带行号窗口、`card: 'search'` 的分组匹配或路径列表及其截断信号、`card: 'web'` 的来源引用或抓取摘要，以及 `card: 'generic'` 的标题与关键输入。卡片主体超过限定行数后折叠；已结算的结果视图替换待定卡片，结果视图缺省时保留调用时卡片，失败的变更则回退为普通的名称加摘要行并显示错误文本。工具行的普通结果主体以调色板的工具结果灰渲染，而非 assistant 主体的终端前景色。调色板跟随终端背景：`colorScheme` 固定深色或浅色，`auto` 读取终端的 `COLORFGBG` 背景信号，读不到时默认深色。 切换会话时会释放对话记录视图缓存的行和 Markdown 组件。 模型的思考内容在流式输出结束后仍保留显示，恢复会话时也会从会话日志中还原。
 
 ### 交互接缝
 

package/lib/index.js

@@ -66,8 +66,8 @@ function measureUsage(values, automatic) {
 /** Palette for a dark terminal background (the default). */
 const DARK = {
 	user: "1;38;5;81",
-	assistantRule: "38;5;79",
-	reasoning: "38;5;110",
+	assistantMarker: "38;5;79",
+	reasoning: "38;5;245",
 	tool: "1;38;5;214",
 	toolOk: "38;5;114",
 	toolError: "1;38;5;203",
@@ -86,8 +86,8 @@ const DARK = {
 /** Palette for a light terminal background. */
 const LIGHT = {
 	user: "1;38;5;25",
-	assistantRule: "38;5;29",
-	reasoning: "38;5;60",
+	assistantMarker: "38;5;29",
+	reasoning: "38;5;245",
 	tool: "1;38;5;130",
 	toolOk: "38;5;28",
 	toolError: "1;38;5;124",
@@ -152,7 +152,7 @@ function createTheme(options) {
 	return {
 		user: style(spec.user),
 		assistant: (text) => text,
-		assistantRule: style(spec.assistantRule),
+		assistantMarker: style(spec.assistantMarker),
 		reasoning: style(spec.reasoning),
 		tool: style(spec.tool),
 		toolOk: style(spec.toolOk),
@@ -1947,7 +1947,7 @@ var SubagentPanel = class {
 		const indent = `${"  ".repeat(row.depth - 1)}${row.depth > 1 ? "↳ " : ""}`;
 		const glyph = row.running ? this.theme.accent("●") : this.theme.dim(row.mode === "external" ? "◇" : "○");
 		const label = (row.label ?? String(row.id).slice(-12)).replace(/\s+/g, " ");
-		const detail = row.mode === "external" ? "external · no local session" : `${row.mode} · ${this.theme.accent(`dsh watch ${String(row.id)}`)}`;
+		const detail = row.mode === "external" ? "external · no local session" : `${row.mode} · ${this.theme.accent(`dsh-tui watch ${String(row.id)}`)}`;
 		return `${indent}${glyph} ${this.theme.bold(label)} · ${this.theme.dim(detail)}`;
 	}
 };
@@ -2559,16 +2559,14 @@ const TOOL_SUMMARY_KEYS = [
 	"description",
 	"name"
 ];
-/** Columns a message row's role gutter occupies: one glyph and one space. */
+/** Columns a message row's first-line marker or continuation indent occupies. */
 const MESSAGE_GUTTER_WIDTH = 2;
 /** First-line glyph of a human prompt row. */
 const USER_MARKER = "› ";
-/** Continuation glyph of a human prompt row. */
-const USER_RULE = "│ ";
 /** First-line glyph of an assistant message row. */
 const ASSISTANT_MARKER = "◆ ";
-/** Continuation glyph of an assistant message row. */
-const ASSISTANT_RULE = "│ ";
+/** Indent that aligns a message's later lines under its first-line content. */
+const MESSAGE_INDENT = " ".repeat(MESSAGE_GUTTER_WIDTH);
 /** Narrowest gap between a shell row's command and its right-aligned label. */
 const SHELL_LABEL_GAP = 2;
 /** Glyph every streamed shell output line starts with. */
@@ -2851,12 +2849,12 @@ var TranscriptView = class {
 	}
 	renderEntry(entry, width) {
 		switch (entry.kind) {
-			case "user": return prefixBody(promptText(entry), width, this.theme.user(USER_MARKER), this.theme.user(USER_RULE));
+			case "user": return prefixBody(promptText(entry), width, this.theme.user(USER_MARKER), MESSAGE_INDENT);
 			case "assistant": {
-				const lines = this.assistantMarkdown(entry.id, entry.text, Math.max(1, width - MESSAGE_GUTTER_WIDTH)).map((line, index) => (index === 0 ? this.theme.assistantRule(ASSISTANT_MARKER) : this.theme.assistantRule(ASSISTANT_RULE)) + line);
+				const lines = this.assistantMarkdown(entry.id, entry.text, Math.max(1, width - MESSAGE_GUTTER_WIDTH)).map((line, index) => (index === 0 ? this.theme.assistantMarker(ASSISTANT_MARKER) : MESSAGE_INDENT) + line);
 				if (!entry.interrupted) return lines;
 				const cancelled = wrap("[cancelled]", Math.max(1, width - MESSAGE_GUTTER_WIDTH));
-				return [...lines, ...cancelled.map((line) => this.theme.assistantRule(ASSISTANT_RULE) + this.theme.dim(line))];
+				return [...lines, ...cancelled.map((line) => MESSAGE_INDENT + this.theme.dim(line))];
 			}
 			case "reasoning": return prefixBody(entry.text, width, this.theme.reasoning("✻ "), this.theme.reasoning("  "));
 			case "tool": return this.toolLines(entry, width);
@@ -4438,7 +4436,7 @@ var SubagentWatchHub = class {
 				return;
 			}
 			this.published.add(sessionId);
-			this.hooks?.published(sessionId, `dsh watch ${sessionId}`);
+			this.hooks?.published(sessionId, `dsh-tui watch ${sessionId}`);
 		} catch (error) {
 			if (!this.closed) this.hooks?.failed(sessionId, error);
 		}
@@ -4636,7 +4634,7 @@ function isTeardown(error) {
 * @returns the heading and the resume command, each on its own line.
 */
 function resumeHint(sessionId) {
-	return `To resume this session:\n  dsh --resume ${sessionId}\n`;
+	return `To resume this session:\n  dsh-tui --resume ${sessionId}\n`;
 }
 /** The interactive application. */
 var TuiApp = class TuiApp {

package/lib/types/ansi.d.ts

@@ -13,13 +13,13 @@ import type { TuiColorScheme } from './config.ts';
 export type Styler = (text: string) => string;
 /** Semantic styles the transcript, status bar, and prompts share. */
 export interface TuiTheme {
-    /** Human prompt role marker and its continuation rule. */
+    /** Human prompt role marker. */
     user: Styler;
     /** Assistant message body. */
     assistant: Styler;
-    /** Assistant message role marker and its continuation rule. */
-    assistantRule: Styler;
-    /** Provider reasoning text, shown while it streams. */
+    /** Assistant message role marker. */
+    assistantMarker: Styler;
+    /** Provider reasoning text, shown while it streams in a muted light grey. */
     reasoning: Styler;
     /** Tool-call heading. */
     tool: Styler;

package/lib/types/session.d.ts

@@ -11,7 +11,7 @@ import type { ContentBlock } from '@deepseek-ai/dsh-llm';
 import type { Session, SessionEvent, SessionId } from '@deepseek-ai/dsh-session';
 /** One delegated child as the `/subagents` listing reports it. */
 export interface TuiSubagent {
-    /** Durable child session id, also the argument `dsh watch` takes. */
+    /** Durable child session id, also the argument `dsh-tui watch` takes. */
     readonly id: SessionId;
     /** Catalog mode recorded by the parent when the child was created. */
     readonly mode: 'one-shot' | 'continuable' | 'external' | 'unknown';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fishwithcat/dsh-tui-app",
   "description": "The dsh terminal application: an interactive full-screen TUI that drives one in-process Agent over dsh-base",
-  "version": "0.2.2-alpha.2",
+  "version": "0.2.2-alpha.3.fork.1",
   "publishConfig": {
     "access": "public"
   },
@@ -41,72 +41,72 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-cmdline": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-stats": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tool-ask-user": "npm:@fishwithcat/dsh-tool-ask-user@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.6-alpha.1",
+    "@deepseek-ai/dsh-brand": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-cmdline": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-home-paths": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-stats": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tool-ask-user": "npm:@fishwithcat/dsh-tool-ask-user@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.3",
+    "@deepseek-ai/schemastery": "~3.18.6-alpha.2",
     "@earendil-works/pi-tui": "^0.85.1",
     "commander": "^15.0.0",
     "diff": "^9.0.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-agent-default-model": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-compaction": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-plan-mode": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-query": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-shell": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-skill": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tool-ask-user": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.2"
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-commands": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-compaction": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-plan-mode": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-persistence": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-query": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-shell": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-token-meter": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tool-ask-user": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-user-approval": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-user-questions": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.11-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-agent-default-model": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-attachment-local": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-bash-local": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-compaction": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-plan-mode": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-query": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-shell": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-skill": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tool-executor-native": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.2"
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.11-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-agent-loop": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-attachment-local": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-bash-local": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-commands": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-compaction": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-plan-mode": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-persistence": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-query": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-shell": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-token-meter": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tool-executor-native": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-user-approval": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-user-questions": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.3"
   }
 }