@deepseek-harness-tui/dsh-tui 0.10.0-beta.4 → 0.10.0

package/README.md

@@ -17,13 +17,11 @@
 
 # dsh-TUI
 
->一个美观且实用的 Claude Code 风格 TUI 插件：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。
+>一个面向 DeepSeek Harness 的交互式终端界面插件：提供像素鲸鱼顶栏、实时工作状态行、流式思考展示、双击 Esc 时间回溯、上下文进度条与 TPS 仪表。
 >零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
->献给钟爱tui的各位极客们~
 >
->A beautiful, practical Claude Code-style TUI plugin: pixel whale top bar, dual flowing-glow title, real-time status line, streaming thought expansion, double-Esc time rewind, blue-white context progress bar + TPS gauge.
+>An interactive terminal UI plugin for DeepSeek Harness: pixel-whale header, live work status, streaming thinking display, double-Esc time rewind, a context progress bar, and a TPS gauge.
 >Zero core changes, pure plugin mounting. Install to enable; uninstall leaves no core patches.
->For all TUI-loving geeks~
 
 ## 🎉 官方收录
 
@@ -52,11 +50,27 @@
 
 ## 核心能力
 
+Windows Terminal 支持 Sixel 时，全屏会话记录可直接显示内嵌缩略图，点击后打开大图预览；非全屏 inline 模式仍保留文字回退。
+Sixel 使用最多 256 色的自适应调色板，透明像素与背景合成；Worker 缓存量化结果，滚动时仅编码可见部分，移出视野或被浮层覆盖时擦除旧图。
+附件读取与解码最多两路并发；最后一个使用者离开后取消读取，未启动的解码不再执行。多图缓存、排队任务与单帧传输均有容量上限，超限时保留文字回退。
+自动探测优先 Kitty，其次使用 DA1 声明的 Sixel 能力。`DSH_TUI_IMAGE_PROTOCOL=auto|kitty|sixel|none` 可覆盖协议选择；
+`DSH_TUI_DISABLE_TERMINAL_IMAGES=1`、无障碍模式、非 TTY 输出以及 tmux/screen 仍禁用图形。
+缺少图片依赖或编码失败时保留文字回退；强制协议也不会启用 inline Sixel。
+浅色主题的面板和图片预览默认使用白底，图片预览边框使用中性色。
+大图预览以对话区约 95% 宽高为预算，最长边可达 2048 像素，仍限制总像素量和后台开销；缩略图大小不变。
+预览支持适应窗口、100% 原像素与 200%/400%/800% 放大，拖动、滚轮或方向按钮平移；100% 需终端报告字符格像素尺寸。
+底部「打开原图」链接直接调用系统看图程序，打开未经重编码的原始附件，包括从历史会话恢复的图片。
+大图弹窗用 `←`/`→` 或底部 `‹`/`›` 切换上一张、下一张，显示当前张数，首尾不循环；切图回到适应窗口。
+
   - **终端交互**：低资源占用，长会话稳定可靠；多种主题切换，样式美观，实时显示工作状态、TPS、缓存命中率等
     推理等级、输入/输出 token 与 Git/会话信息；终端卡多行命令可经 `/settings` 折叠为首行 + 计数提示（Ctrl+O 或点击卡片展开）；全屏模式下悬停在截断的工具卡标题、用户消息或会话标题上约 600ms，浮层显示完整内容。
-  - **功能全面**：`/resume` 按工作目录分类浏览、搜索与预览历史会话（左键恢复、右键弹出操作菜单；可固定常用会话——「已固定」分组置顶显示，行内 ★ 或 `Ctrl+P` 切换，持久化到 `~/.dsh-tui`），另有 `/agentview` 会话总览（CC 同款 agent view：空输入 `←` 一键后台化，后台会话派发/预览/回复/停止一站式管理）、`/new`、`/compact`、`/export`、`/btw`，模型热切换，原生subagent，会话fork，自动更新，输入框 `/vim` vim 编辑模式、鼠标选区编辑（拖选高亮、Shift+click 扩展、双击选词、Ctrl+C 复制选区）与全屏草稿编辑（`Ctrl+Shift+E` 或输入行 `⛶` 按钮：行号 + 当前行高亮、Enter 换行、Ctrl+Enter 发送、滚轮滚动、点击/拖选，长草稿独占整屏；`/settings` 可关）；可在vs code中[以vscode插件形式启动](docs/vscode.md)，已上架 VS Code Marketplace。
+    用户附图及助手/工具结果中的持久图片块会直接显示在会话记录中；Kitty graphics 或 Sixel 可用时显示等比缩略图，否则保留同尺寸文字回退。全屏下点击输入框 `[Image #N]` 或 transcript 缩略图在对话区域居中打开大图预览，卡片外的对话文字变暗，不遮挡输入栏（Esc/点击外部关闭），标题为 `Image #N — 格式 · 尺寸 · 体积 · 文件名`，本会话暂存的图片在卡片底行显示来源路径；Finder 复制的图片文件粘贴时直接入附件库为 `[Image #N]`；输入框里的 `[Image #N]` 是一个整体，光标整体跳过、删除整体生效，光标落在其上时整块反显并自动打开预览、离开时关闭。Vim 的 `x`/`X`/`d…` 同样整张删除，`u` 同时恢复文字与附件；撤销仅限当前草稿。
+    终端图片预览默认开启，可在 `/settings → 终端图片预览` 或配置 `terminalImages: false` 中关闭，使用 `/restart` 后生效。已保存的 `/settings` 选择优先于 Cordis 配置；若曾保存为开启，请在 `/settings` 中关闭后再 `/restart`。关闭时保留文字信息并跳过预览解码，不影响向模型发送图片；`DSH_TUI_DISABLE_TERMINAL_IMAGES=1` 始终强制关闭预览。
+  - **功能全面**：`/resume` 按工作目录分类浏览、搜索与预览历史会话（左键恢复、右键弹出操作菜单；可固定常用会话——「已固定」分组置顶显示，行内 ★ 或 `Ctrl+P` 切换，持久化到 `~/.dsh-tui`），另有 `/agentview` 会话总览（空输入 `←` 一键后台化，后台会话派发、预览、回复与停止一站式管理）、`/new`、`/compact`、`/export`、`/btw`，模型热切换（新会话默认推理强度可在 /settings → 默认推理强度 预设），原生subagent，会话fork，自动更新，输入框 `/vim` vim 编辑模式、鼠标选区编辑（拖选高亮、Shift+click 扩展、双击选词、Ctrl+C 复制选区）与全屏草稿编辑（`Ctrl+Shift+E` 或输入行 `⛶` 按钮：行号 + 当前行高亮、Enter 换行、Ctrl+Enter 发送、滚轮滚动、点击/拖选，长草稿独占整屏；`/settings` 可关）；可在vs code中[以vscode插件形式启动](docs/vscode.md)，已上架 VS Code Marketplace。
   - **扩展丰富**：原生浏览器交互，compter use等大量附属功能性扩展
   - **技能归 DSH 管理**：`/skills` 展示当前 profile、用户与项目发现的技能；dsh-TUI 不预装通用技能。
+  - **工作状态动画**：默认使用 `moon8`；读取旧版本地配置中的 `claude` 值时自动映射为 `moon8`，选择器只显示当前预设。
+  - **像素鲸鱼娘**：开屏随机三选一开场动画；欢迎期（开始第一个任务前）可**点击冒爱心并唤醒睡着的鲸鱼**，闲置时摆鱼鳍、拍尾巴、入睡冒 Z（`/settings → whaleIdle` 可关）。**开始第一个任务后永久定格为静态标准帧**，零持续开销。鲸鱼娘的 22 帧手绘原图与闲置行为移植自 [dsh-ui-whale](https://github.com/lhh010/dsh-ui-whale)（作者 [@lhh010](https://github.com/lhh010)），特此致谢。
 
 
 
@@ -70,11 +84,6 @@
         <br>
         <strong>首屏：像素鲸鱼顶栏</strong>
       </td>
-      <td align="center" valign="middle" width="50%">
-        <img src="screenshots/working-line.png" alt="工作状态行 + 上下文进度条" width="480">
-        <br>
-        <strong>工作状态行 + 上下文进度条</strong>
-      </td>
     </tr>
   </table>
 </div>
@@ -155,7 +164,9 @@ sh install.sh
 | [主题系统](docs/themes.md) | 内置主题、自动检测、静态 JSON 与 npm 插件主题、校验规则 |
 | [交互与命令](docs/interaction.md) | 快捷键、鼠标、问卷、slash command 与会话工作流 |
 | [架构与限制](docs/architecture.md) | 运行链路、渲染与持久化设计、安全边界、已知限制 |
-| [VS Code 使用指南](docs/vscode.md) | 在 VS Code 集成终端运行 dsh-tui；companion 扩展 `dsh-tui-vscode` 提供与 Claude Code 官方扩展几乎一致的体验（已上架 Marketplace） |
+| [社区管理框架](docs/community-management.md) | 社区入口、角色、提案流程、roadmap 规则与维护节奏 |
+| [项目路线图](docs/roadmap.md) | 公开目标、阶段、任务状态、退出条件与 Future Work |
+| [VS Code 使用指南](docs/vscode.md) | 在 VS Code 集成终端运行 dsh-tui；companion 扩展 `dsh-tui-vscode` 提供多会话、会话历史与指定会话恢复（已上架 Marketplace） |
 | [贡献与开发约定](docs/contributing.md) | 贡献流程、仓库地图、构建产物、验证矩阵与修改规则 |
 | [插件准入与开发指南](https://github.com/T-Auto/dsh-ecosystem-spec/blob/main/docs/plugin-admission-and-development.md) | 接口与兼容性协定 / 插件准入规范 / 插件接缝 / 契约 / 验证清单（已并入 dsh-ecosystem-spec） |
 
@@ -169,9 +180,9 @@ sh install.sh
 - **社区交流群**：使用问题、插件创意、功能许愿，都欢迎进来聊。
 - **行为准则**：参与前请读一遍[贡献者行为准则](CODE_OF_CONDUCT.md)。
 
-| 微信群 | QQ 群（群号 572549239） | 微信四群 |
-| :---: | :---: | :---: |
-| <img src="screenshots/wechat-group.jpg" alt="dsh-TUI 社区交流群微信群二维码" width="200"> | <img src="screenshots/qq-group.png" alt="dsh-TUI 社区交流群 QQ 群二维码" width="200"> | <img src="screenshots/wechat-group4.jpg" alt="dsh-TUI 社区交流四群微信群二维码" width="200"> |
+| 微信群（dsh-TUI 社区交流 4 群） | QQ 群（群号 572549239） |
+| :---: | :---: |
+| <img src="screenshots/wechat-group.jpg" alt="dsh-TUI 社区交流 4 群微信群二维码" width="200"> | <img src="screenshots/qq-group.png" alt="dsh-TUI 社区交流群 QQ 群二维码" width="200"> |
 
 > 微信群二维码约 7 天过期一次，如遇失效请走 QQ 群（572549239），或开个 issue 提醒我们更新。
 
@@ -179,10 +190,14 @@ sh install.sh
 
 > **Windows 安全警告：** Windows profile 默认使用 `danger-full-access`，且 approval 默认是 `never`。这会授予工具不受限制的访问权限；在敏感凭证或不可信仓库环境中启动前，务必先检查并收紧 profile 配置。
 
-`dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略。权限预设来自 DSH `permissionPresets` registry：服务缺失时使用 legacy 三项兼容名册；服务已挂载但为空、损坏或不一致时标记为 unavailable，TUI fail closed，不伪造名册。可用 registry 按声明顺序提供第三方预设，只有符合既有 command-token 语法的 ID 才进入补全，`custom` 只显示为当前态，不是可选择目标；切换始终走官方 `/permission <preset>` 命令。若外部 `/permission` 命令本身未注册，输入沿用现有默认命令/model dispatch。在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
+`dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略。权限预设来自 DSH `permissionPresets` registry：服务缺失时使用 legacy 三项兼容名册；服务已挂载但为空、损坏或不一致时标记为 unavailable，TUI fail closed，不伪造名册。可用 registry 按声明顺序提供第三方预设并自动进入补全、picker 与 `Shift+Tab` 循环（排除 `custom`/`status`、canonical 预设、重复 identity 与不安全 token）；首次观察遵循 registry 顺序，后续刷新保留已见 identity 的相对顺序。服务可用时 `/permission` 以本地命令形式常驻菜单：切换优先调用官方 `/permission <preset>` 命令；命令行未暴露给本 agent 时，回退到 permissionPresets 服务自身的官方写路径（与命令 handler 同一实现，写真实 `permission/preset`/`sandbox/mode`/`approval/policy` 事件，绝不由 TUI 伪造），并以事件/读回确认；两条路都不可用时显式提示，绝不静默。计划模式退出先恢复进入前的 atom，再把权限身份还原到你进入前所在的预设（registry 仍提供时）。在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
 
 详见[权限边界与已知限制](docs/architecture.md#权限与安全边界)。
 
+### 致谢
+
+- 像素鲸鱼娘的 22 帧手绘原图（Excel 逐格绘制）与闲置动画行为（摆鱼鳍、拍尾巴、入睡冒 Z、点击冒爱心）移植自 **[dsh-ui-whale](https://github.com/lhh010/dsh-ui-whale)**（DeepSeek Harness Web 端鲸鱼宠物插件，作者 [@lhh010](https://github.com/lhh010)，BSD-3-Clause），感谢作者与灵感 🐋💜
+
 ### 友情链接
 
 朋友们开发的[社区、相关项目与周边工具](docs/links.md)

package/bin/dsh-tui.js

@@ -14,7 +14,7 @@
  *   profile 内副本（被委托执行，或 junction/源码目录里直接运行）→ 完整
  *   启动逻辑（与 0.8.6 及之前一致）：
  *     dsh 预检 / profile 版本核对 / --resume 与工作区目标拦截 /
- *     旧环境变量警告 / `dsh --profile dsh-tui` 启动与退出码透传。
+ *     `dsh --profile dsh-tui` 启动与退出码透传。
  *
  * 自举角色判定用 realpath：Windows Junction 轨（profile 指回仓库）与
  * `pnpm run dev` 源码运行都会折叠成同一物理目录 → 走完整逻辑，不会
@@ -120,7 +120,7 @@ const isVersionNewer = (a, b) => {
   return false
 }
 
-const lang = (process.env.DSH_TUI_LANG ?? process.env.CC_TUI_LANG) === 'en' ? 'en' : 'zh'
+const lang = process.env.DSH_TUI_LANG === 'en' ? 'en' : 'zh'
 const MSG = {
   noDsh: {
     en: '[dsh-tui] dsh CLI not found. Install the official client first:\n  npm install -g @deepseek-ai/dsh',
@@ -170,10 +170,6 @@ const MSG = {
     en: code => `[dsh-tui] dsh profile exited with code ${code}. Run it directly for diagnostics:\n  dsh --profile ${PROFILE}`,
     zh: code => `[dsh-tui] dsh profile 已退出（退出码 ${code}）。可直接运行以下命令查看诊断：\n  dsh --profile ${PROFILE}`,
   },
-  legacyEnv: {
-    en: (oldName, newName) => `[dsh-tui] note: env ${oldName} was renamed to ${newName}; the old name no longer takes effect.`,
-    zh: (oldName, newName) => `[dsh-tui] 提示：环境变量 ${oldName} 已更名为 ${newName}，旧名不再生效。`,
-  },
   notInstalled: {
     en: '(not installed)',
     zh: '（未安装）',
@@ -498,19 +494,15 @@ if (!runningInsideProfile && ownVersion !== undefined && process.env.DSH_TUI_NO_
     }
   }
 
-  // --resume / 工作区目标拦截（issue #120/#53 的启动器契约）。
+  // --resume / 工作区目标拦截（launcher 契约，见 src/sessionHistory.ts）。
   const setResumeEnv = sessionId => {
     process.env.DSH_TUI_RESUME_SESSION = sessionId
-    process.env.DSH_CC_RESUME_SESSION = sessionId
   }
   const readLastResumeTarget = () => {
-    for (const dir of ['.dsh-tui', '.dsh-cc']) {
-      try {
-        const sessionId = readFileSync(join(homedir(), dir, 'resume.txt'), 'utf8').trim()
-        if (sessionId) return sessionId
-      } catch {
-        // 没有历史会话可恢复——静默忽略，正常冷启动。
-      }
+    try {
+      return readFileSync(join(homedir(), '.dsh-tui', 'resume.txt'), 'utf8').trim()
+    } catch {
+      // 没有历史会话可恢复——静默忽略，正常冷启动。
     }
     return ''
   }
@@ -538,28 +530,6 @@ if (!runningInsideProfile && ownVersion !== undefined && process.env.DSH_TUI_NO_
     }
   }
 
-  // 旧环境变量警告（必须在 TUI 渲染前输出，fullscreen 下写 stderr 会破坏
-  // 界面）。与 utils/paths 的 RENAMED_ENV 同表，内联以维持零 lib 依赖。
-  const RENAMED_ENV = {
-    CC_TUI_THEME: 'DSH_TUI_THEME',
-    CC_TUI_LANG: 'DSH_TUI_LANG',
-    CC_TUI_PERSONA: 'DSH_TUI_PERSONA',
-    CC_TUI_PRESET: 'DSH_TUI_PRESET',
-    CC_TUI_DISABLE_MOUSE: 'DSH_TUI_DISABLE_MOUSE',
-    CC_TUI_DEBUG: 'DSH_TUI_DEBUG',
-    CC_TUI_COMPACT_RATIO: 'DSH_TUI_COMPACT_RATIO',
-    CC_TUI_COMPACT_RETAIN: 'DSH_TUI_COMPACT_RETAIN',
-    DSH_CC_UPDATED_FROM: 'DSH_TUI_UPDATED_FROM',
-    DSH_CC_RENDER_LOG: 'DSH_TUI_RENDER_LOG',
-    DSH_CC_SESSION_ROOT: 'DSH_TUI_SESSION_ROOT',
-    DSH_CC_WORKSPACE: 'DSH_TUI_WORKSPACE',
-  }
-  for (const oldName of Object.keys(RENAMED_ENV)) {
-    if (process.env[oldName] !== undefined) {
-      console.error(msg('legacyEnv')(oldName, RENAMED_ENV[oldName]))
-    }
-  }
-
   // 启动：被委托场景下本副本自己的版本即对齐诊断所见的启动器代际。
   if (process.env.DSH_TUI_LAUNCHER_VERSION === undefined && ownVersion !== undefined) {
     process.env.DSH_TUI_LAUNCHER_VERSION = ownVersion

package/cordis.patch.yml

@@ -37,9 +37,9 @@
   config:
     agents: []
 
-# Preserve the TUI's opt-in privacy stance across the alpha base default
+# Preserve the TUI's opt-in privacy stance across the 0.1.2 base default
 # change to FEEDBACK_ONLY. An explicit DSH_TELEMETRY_MODE still wins. This
-# restates the whole alpha config because include patches replace config
+# restates the whole 0.1.2 config because include patches replace config
 # objects rather than merging them.
 - id: session-telemetry-otel
   config:
@@ -55,7 +55,7 @@
       maxExportBatchSize: 2048
       exportTimeoutMillis: 1500
 
-# The alpha base sends the active Loader package inventory on official
+# The 0.1.2 base sends the active Loader package inventory on official
 # DeepSeek requests by default. TUI keeps that diagnostic metadata opt-in.
 - id: plugin-package-inventory-deepseek
   config:
@@ -66,8 +66,8 @@
 # The model-facing plugin set moves INTO the agent-presets roster: every
 # session composes its tools/prompt sections from one preset directory
 # (standard/ptc/minimal/cordis) instead of the host rows below. The TUI's
-# roster row uses the scoped `dsh-tui-agent-presets` id. alpha packages prepend
-# their bundled system root; the validated rc line still needs the dsh CLI's
+# roster row uses the scoped `dsh-tui-agent-presets` id. The 0.1.2 generation
+# prepends its bundled system root; legacy 0.1.1-rc.2 still needs the dsh CLI's
 # `config/agent-presets/` directory supplied explicitly. Both append
 # `$DSH_HOME/.agent-presets`. Mirroring the official dsh-web-app patch: every
 # dsh-base row a preset now owns is disabled here, so a minimal agent does not
@@ -81,9 +81,9 @@
   disabled: true
 
 # compaction lives in the preset's own isolate realm (standard/ptc/cordis
-# carry `compaction-basic` with package defaults; minimal has none). The
-# CC_TUI_COMPACT_RATIO/CC_TUI_COMPACT_RETAIN tunables retired with this host
-# row — preset compositions own their compaction config.
+# carry `compaction-basic` with package defaults; minimal has none). The old
+# ratio/retain tunables retired with this host row — preset compositions own
+# their compaction config.
 - id: compaction-basic
   disabled: true
 
@@ -104,9 +104,9 @@
 
 - id: command-goal
   # rc.2 presets do not carry this command, so their host row must remain
-  # active. alpha disables it only when the shipped standard preset really
-  # owns the command; reading the capability avoids guessing from another
-  # optional Loader row.
+  # active. Newer packages disable it only when the shipped standard preset
+  # really owns the command; reading the capability avoids guessing from
+  # another optional Loader row.
   disabled: !!js >-
     (() => {
       const require = process.getBuiltinModule('node:module').createRequire(ctx.baseUrl)
@@ -245,7 +245,7 @@
       name: '@deepseek-ai/dsh-code-runtime-worker-thread'
       disabled: !!js "[...ctx.loader.entries()].some(entry => entry.options.id === 'code-runtime' && entry.options.name === '@deepseek-ai/dsh-code-runtime-worker-thread' && !entry.disabled)"
 
-    # Alpha presets opt their delegation tool into Host-owned model-selection
+    # 0.1.2 presets opt their delegation tool into Host-owned model-selection
     # settings. Without this service standard/ptc/cordis preset mounting fails.
     # The package subpath does not exist on rc.2, so resolve that capability
     # directly before Loader attempts the import. An enabled official row still
@@ -302,9 +302,9 @@
       name: '@deepseek-harness-tui/dsh-tui/extensions'
 
     # The agent-preset roster (issue #8): `ctx.agentPresets`, the service the
-    # TUI composes every session's model-facing world from. alpha packages
-    # prepend their bundled presets as the read-only system root; rc.2 packages
-    # have no bundled root and still scan the dsh CLI directory. Both append
+    # TUI composes every session's model-facing world from. 0.1.2 packages
+    # prepend their bundled presets as the read-only system root; legacy rc.2
+    # packages have no bundled root and still scan the dsh CLI directory. Both append
     # `$DSH_HOME/.agent-presets` as the user root. Deployment-added roots may
     # still be supplied by a later patch.
     - id: dsh-tui-agent-presets
@@ -353,9 +353,8 @@
     # The interactive front door. The plugin creates/resumes its agent at
     # runtime, seeds the startup status line, and disposes the whole app tree
     # (exiting the process) when the TUI unmounts. `dsh-tui --resume`
-    # feeds the session id through DSH_TUI_RESUME_SESSION (the pre-rename
-    # DSH_CC_RESUME_SESSION is still honored as a fallback for old
-    # launchers — TODO: drop once they age out, issue #120).
+    # feeds the session id through DSH_TUI_RESUME_SESSION (see
+    # src/sessionHistory.ts for the launcher contract).
     - id: dsh-tui
       name: '@deepseek-harness-tui/dsh-tui'
       # The entry-level dependency augments the plugin's `agents` inject and
@@ -375,13 +374,15 @@
       # verify-workspace-attachment.mjs asserts the name→inject distance.)
       config:
         provider: deepseek-official
-        # Alt-screen fullscreen（CC 同款）：应用内鼠标选区（选择即复制, OSC 52 +
+        # Alt-screen fullscreen 布局：应用内鼠标选区（选择即复制, OSC 52 +
         # wl-copy/xclip/xsel 兜底）、滚轮滚动、双击选词/三击选行。出厂默认开启，
         # 与 schema 默认（index.ts fullscreen default true）保持一致——两处必须
         # 同步翻转，否则本覆盖层会盖住 schema 默认，更新后用户仍落在 inline。
         # 想退回 inline 主屏（终端原生滚动/选择）：/settings 全屏开关或 cordis.yml
         # `fullscreen: false`——显式选择始终优先于默认。
         fullscreen: true
+        # 在支持的终端预览图片；/settings 可关闭，重启生效。
+        terminalImages: true
         # Edit/Write diff 呈现：auto（≥110 列双栏对照，窄屏统一式）/
         # split（强制双栏）/ unified（强制统一式）。/settings 屏可实时改。
         # diffLayout: auto
@@ -412,7 +413,7 @@
         # wins over the roster default (standard).
         preset: !!js process.env.DSH_TUI_PRESET ?? undefined
         workspace: !!js process.env.DSH_TUI_WORKSPACE_TARGET ?? undefined
-        sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? process.env.DSH_CC_RESUME_SESSION ?? undefined
+        sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? undefined
 
     # Live working-line data source (thinking copy / running tool / turn
     # summary). Mounted through @deepseek-harness-tui/dsh-tui's own

package/cordis.yml

@@ -57,10 +57,12 @@
   inject: [agents, tuiWorkspaces, tuiScenes, tuiDialogs, tuiStatus, tuiShortcuts, tuiRenderers, tuiThemes]
   config:
     provider: deepseek-official
-    # Alt-screen fullscreen (CC 同款): 应用内鼠标选区（选择即复制, OSC 52 +
+    # Alt-screen fullscreen 布局: 应用内鼠标选区（选择即复制, OSC 52 +
     # wl-copy/xclip/xsel 兜底）、滚轮滚动、双击选词/三击选行。false 则退回
     # inline 渲染, 鼠标交给终端模拟器原生选择。
     fullscreen: true
+    # 在支持的终端预览图片；/settings 可关闭，重启生效。
+    terminalImages: true
     # Reasoning effort applied to every request, validated against the live
     # route's adapter levels. An unlisted level falls back to the adapter
     # default; this wins over the persisted /effort choice and seeds the
@@ -83,9 +85,9 @@
     #     plan: false
     #     sandbox: danger-full-access
     #     approval: never
-    #  feeds the chosen session id through this env var (DSH_TUI_ name; the
-    #  pre-rename DSH_CC_ spelling is still honored, issue #120).
-    sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? process.env.DSH_CC_RESUME_SESSION ?? undefined
+    #  feeds the chosen session id through this env var (see
+    #  src/sessionHistory.ts for the launcher contract).
+    sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? undefined
     workspace: !!js process.env.DSH_TUI_WORKSPACE_TARGET ?? undefined
 
 # The DeepSeek adapter. Shipped default: full thinking at max effort.

package/lib/types/activityPrefs.js

@@ -9,7 +9,7 @@
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { isPresetName } from './components/activityFrames.js';
+import { isPresetName, normalizeActivityPreset } from './components/activityFrames.js';
 import { parseWorkingActivityConfig } from 'dsh-working-activity/config';
 import { DATA_DIR } from './utils/paths.js';
 const PREFS_DIR = DATA_DIR;
@@ -24,7 +24,7 @@ export function parseActivityFrames(text) {
         if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
             return undefined;
         const frames = parsed.frames;
-        return typeof frames === 'string' && isPresetName(frames) ? frames : undefined;
+        return typeof frames === 'string' && isPresetName(frames) ? normalizeActivityPreset(frames) : undefined;
     }
     catch {
         return undefined;
@@ -68,7 +68,7 @@ export function readActivityConfig(dir = PREFS_DIR) {
 export function writeActivityFrames(name, dir = PREFS_DIR) {
     try {
         mkdirSync(dir, { recursive: true });
-        writeFileSync(join(dir, 'working-activity.json'), JSON.stringify({ frames: name }, null, 2));
+        writeFileSync(join(dir, 'working-activity.json'), JSON.stringify({ frames: normalizeActivityPreset(name) }, null, 2));
         return true;
     }
     catch {

package/lib/types/bootstrap/state.d.ts

@@ -1,8 +1,6 @@
 /**
- * Interaction-time telemetry stubs consumed by the ported Ink core
- * (ink/ink.tsx, ink/components/App.tsx, ink/components/ScrollBox.tsx). The
- * original functions fed Claude Code's session-activity tracking; dsh-tui
- * does not track interaction time.
+ * Interaction-time telemetry stubs used by the renderer's input and scroll
+ * paths. dsh-tui does not track interaction time, so these hooks are no-ops.
  */
 /** No-op interaction-time flush stub; dsh-tui does not track interaction time. */
 export declare function flushInteractionTime(): void;

package/lib/types/bootstrap/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/bootstrap/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,IAAI,CAAG;AAE/C,mFAAmF;AACnF,wBAAgB,yBAAyB,IAAI,IAAI,CAAG;AAEpD,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,IAAI,CAAG"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/bootstrap/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,IAAI,CAAG;AAE/C,mFAAmF;AACnF,wBAAgB,yBAAyB,IAAI,IAAI,CAAG;AAEpD,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,IAAI,CAAG"}

package/lib/types/bootstrap/state.js

@@ -1,8 +1,6 @@
 /**
- * Interaction-time telemetry stubs consumed by the ported Ink core
- * (ink/ink.tsx, ink/components/App.tsx, ink/components/ScrollBox.tsx). The
- * original functions fed Claude Code's session-activity tracking; dsh-tui
- * does not track interaction time.
+ * Interaction-time telemetry stubs used by the renderer's input and scroll
+ * paths. dsh-tui does not track interaction time, so these hooks are no-ops.
  */
 /** No-op interaction-time flush stub; dsh-tui does not track interaction time. */
 export function flushInteractionTime() { }

package/lib/types/commands.d.ts

@@ -1,7 +1,6 @@
 /**
- * Local slash commands for the dsh-tui TUI. Claude Code's command system is
- * deeply wired into its engine; dsh-tui ships a small built-in set with the
- * same `/name — description` suggestion chrome, and merges plugin-registered
+ * Local slash commands for dsh-tui, presented as `/name — description`.
+ * The built-in set is merged with plugin-registered
  * commands (plan/goal/…) from the DSH command registry (`dsh-commands`) —
  * `runCommand` in the Chat screen dispatches either kind, with the registry
  * handler winning for names both sides declare.
@@ -22,6 +21,9 @@ export interface LocalCommand {
     tag?: string;
     /** True when a DSH plugin registered this command (not built in). */
     external?: boolean;
+    /** True when this command explicitly accepts composer images. Local
+     * commands default to false; registry entries mirror `input.images`. */
+    acceptsImages?: boolean;
     /**
      * True when the entry is a user-invocable skill discovered by the DSH
      * skill registry (issue #86). Skill entries are completion-only: dispatch
@@ -106,7 +108,7 @@ export declare function parseCommandName(line: string): {
  */
 export declare function isLocalCommandName(input: string, list?: readonly LocalCommand[]): boolean;
 /**
- * Filter commands by a `/…` input prefix (matches the CC overlay behavior).
+ * Filter commands by a `/…` input prefix.
  * The prefix is the whole input after the slash, so `/plan off` matches
  * nothing and the overlay stays closed — Enter still dispatches through
  * `parseCommandName`.

package/lib/types/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA+DxC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAElD,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAuCrB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;4EACwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA+DxC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAElD,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAuCrB"}

package/lib/types/commands.js

@@ -1,7 +1,6 @@
 /**
- * Local slash commands for the dsh-tui TUI. Claude Code's command system is
- * deeply wired into its engine; dsh-tui ships a small built-in set with the
- * same `/name — description` suggestion chrome, and merges plugin-registered
+ * Local slash commands for dsh-tui, presented as `/name — description`.
+ * The built-in set is merged with plugin-registered
  * commands (plan/goal/…) from the DSH command registry (`dsh-commands`) —
  * `runCommand` in the Chat screen dispatches either kind, with the registry
  * handler winning for names both sides declare.
@@ -23,14 +22,14 @@ export const LOCAL_COMMANDS = [
     // Conversation
     { name: 'new', description: 'Start a new conversation' },
     { name: 'clear', description: 'Clear the conversation' },
-    { name: 'compact', description: 'Compact the conversation history' },
-    { name: 'resume', description: 'Resume a previous session' },
+    { name: 'compact', description: 'Summarize earlier turns to free context space' },
+    { name: 'resume', description: 'Continue a saved session' },
     { name: 'rename', description: 'Rename the current session' },
     { name: 'recap', description: 'Generate a recap of recent session activity' },
-    { name: 'rewind', description: 'Rewind the conversation to a previous message' },
+    { name: 'rewind', description: 'Return the session to an earlier message' },
     { name: 'tree', description: 'Browse the session family tree (rewind / fork / adopt)' },
     { name: 'fork', description: 'Fork the current session into a resumable copy' },
-    { name: 'export', description: 'Export the conversation to a markdown file' },
+    { name: 'export', description: 'Save the session as a Markdown file' },
     { name: 'btw', description: 'Ask a quick side question without interrupting the conversation' },
     { name: 'trace', description: 'Show the session event trace timeline' },
     { name: 'agentview', description: 'Open the agent view (all sessions)' },
@@ -71,7 +70,7 @@ export const LOCAL_COMMANDS = [
     // Skills are discovered through the DSH registry and added at runtime.
     // A local entry of the same name would win the collision filter.
     // Misc / not applicable on this leaf
-    { name: 'vim', description: 'Toggle vim mode' },
+    { name: 'vim', description: 'Turn Vim keybindings on or off' },
     { name: 'terminal-setup', description: 'Show terminal setup instructions' },
     { name: 'connect', description: 'Connect to a remote machine' },
     { name: 'workspace', description: 'Resume, rename, or open a workspace' },
@@ -145,7 +144,7 @@ export function isLocalCommandName(input, list = LOCAL_COMMANDS) {
     return HIDDEN_COMMAND_NAMES.has(name) || list.some(command => command.name === name);
 }
 /**
- * Filter commands by a `/…` input prefix (matches the CC overlay behavior).
+ * Filter commands by a `/…` input prefix.
  * The prefix is the whole input after the slash, so `/plan off` matches
  * nothing and the overlay stays closed — Enter still dispatches through
  * `parseCommandName`.

package/lib/types/components/ActivityLine.d.ts

@@ -13,7 +13,7 @@ export declare function contextPressurePct(usage: {
 } | undefined, contextWindow: number | undefined): number | undefined;
 /**
  * The working-activity line, rendered either in the spinner slot (while a
- * turn runs — replacing the CC random-verb spinner) or on the status bar
+ * turn runs — alongside the random-verb spinner) or on the status bar
  * (the turn-summary card once idle). pi working-activity style: an animated
  * indicator frame, an ice-blue shimmer sweep over the line, an amber/red
  * `⚠ ctx N%` pressure prefix, and a trailing token suffix for the spinner

package/lib/types/components/ActivityLine.js

@@ -22,7 +22,7 @@ export function contextPressurePct(usage, contextWindow) {
 }
 /**
  * The working-activity line, rendered either in the spinner slot (while a
- * turn runs — replacing the CC random-verb spinner) or on the status bar
+ * turn runs — alongside the random-verb spinner) or on the status bar
  * (the turn-summary card once idle). pi working-activity style: an animated
  * indicator frame, an ice-blue shimmer sweep over the line, an amber/red
  * `⚠ ctx N%` pressure prefix, and a trailing token suffix for the spinner
@@ -38,10 +38,10 @@ export function ActivityLine({ activity, activityFrames, warnPct, warnDanger, su
     const frameIndex = Math.floor(time / preset.intervalMs) % preset.frames.length;
     const frame = preset.frames[frameIndex] ?? '·';
     const color = activity.phase === 'done' || activity.phase === 'tool'
-        ? 'claude'
-        : 'claudeBlue_FOR_SYSTEM_SPINNER';
+        ? 'accent'
+        : 'activity';
     const baseRGB = activity.phase === 'tool'
-        ? (parseRGB(theme.claude) ?? BRAND)
-        : (parseRGB(theme.claudeBlue_FOR_SYSTEM_SPINNER) ?? ICE);
+        ? (parseRGB(theme.accent) ?? BRAND)
+        : (parseRGB(theme.activity) ?? ICE);
     return (_jsxs(Text, { wrap: "truncate", children: [activity.phase !== 'done' && (_jsxs(Text, { color: color, children: [frame, " "] })), warnPct !== undefined && warnPct >= 80 && (_jsxs(Text, { color: warnDanger ? 'error' : 'warning', children: [t('activity-ctx-warn'), warnPct, "% \u00B7", ' '] })), activity.phase === 'done' ? (_jsx(Text, { color: color, children: activity.line })) : (_jsx(Text, { children: sweep(activity.line, time, baseRGB, FLASH, 60) })), suffix !== undefined && _jsx(Text, { dimColor: true, children: suffix })] }));
 }

package/lib/types/components/ActivityPicker.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 /**
- * Working-activity indicator picker in the CC ModelPicker style (ported
- * from the pi extension's `/activity` interactive select): a
+ * Working-activity indicator picker (ported from the pi extension's
+ * `/activity` interactive select): a
  * permission-colored Pane listing every preset (random first) with its
  * frame preview, `❯` focus pointer and `✓` on the active preset. Enter
  * applies through `channel.setActivityFrames`, Esc cancels.

package/lib/types/components/ActivityPicker.js

@@ -6,8 +6,8 @@ import { Select } from './Select.js';
 import { HintLine } from './design-system/HintLine.js';
 import { FRAME_PRESETS, PRESET_NAMES } from './activityFrames.js';
 /**
- * Working-activity indicator picker in the CC ModelPicker style (ported
- * from the pi extension's `/activity` interactive select): a
+ * Working-activity indicator picker (ported from the pi extension's
+ * `/activity` interactive select): a
  * permission-colored Pane listing every preset (random first) with its
  * frame preview, `❯` focus pointer and `✓` on the active preset. Enter
  * applies through `channel.setActivityFrames`, Esc cancels.

package/lib/types/components/BalanceReportRow.js

@@ -4,7 +4,7 @@ import { Box, Text } from '../ui.js';
 import { Divider } from './design-system/Divider.js';
 import { t } from '../i18n.js';
 import { estimateSessionCostSplitCny, isPeakHour, priceForModel } from '../deepseekPricing.js';
-import { formatTokens } from '../cc/format.js';
+import { formatTokens } from '../terminal-utils/format.js';
 /**
  * `/balance` 余额报告行：Divider + 一行安静摘要，hover 展开明细
  * （各币种赠送/充值拆分、本会话 token 与花费估算、失败原因），点击行

package/lib/types/components/BtwPanel.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 /**
- * /btw side-question panel (CC's btw.tsx, inline-pane form like the local
- * pickers): title line with the question, a scrollable answer body (error /
+ * /btw side-question panel, an inline-pane form like the local pickers:
+ * title line with the question, a scrollable answer body (error /
  * markdown answer / answering spinner), and a hint line. Owns the keyboard
  * while open — every key it sees is consumed here.
  */

package/lib/types/components/BtwPanel.js

@@ -6,8 +6,8 @@ import { SpinnerGlyph } from './Spinner/SpinnerGlyph.js';
 import { t } from '../i18n.js';
 import { isPlainReturnInput } from '../utils/modifiers.js';
 /**
- * /btw side-question panel (CC's btw.tsx, inline-pane form like the local
- * pickers): title line with the question, a scrollable answer body (error /
+ * /btw side-question panel, an inline-pane form like the local pickers:
+ * title line with the question, a scrollable answer body (error /
  * markdown answer / answering spinner), and a hint line. Owns the keyboard
  * while open — every key it sees is consumed here.
  */

package/lib/types/components/Chat/JobCard.d.ts

@@ -15,9 +15,9 @@ import type { JobRow } from '../../dsh-adapter/channel.js';
  * tail of the agent's own job_output results as they stream through the
  * transcript.
  */
-export declare function JobCard({ job, addMargin, onClick }: {
+export declare function JobCard({ job, marginTopOnTurn, onClick }: {
     job: JobRow;
-    addMargin: boolean;
+    marginTopOnTurn: boolean;
     onClick?(): void;
 }): React.ReactNode;
 //# sourceMappingURL=JobCard.d.ts.map

package/lib/types/components/Chat/JobCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobCard.d.ts","sourceRoot":"","sources":["../../../../src/components/Chat/JobCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAkD1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB,GAAG,KAAK,CAAC,SAAS,CAuDlB"}
+{"version":3,"file":"JobCard.d.ts","sourceRoot":"","sources":["../../../../src/components/Chat/JobCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAkD1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,eAAe,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB,GAAG,KAAK,CAAC,SAAS,CAuDlB"}

package/lib/types/components/Chat/JobCard.js

@@ -63,7 +63,7 @@ function clipLine(text, maxWidth) {
  * tail of the agent's own job_output results as they stream through the
  * transcript.
  */
-export function JobCard({ job, addMargin, onClick }) {
+export function JobCard({ job, marginTopOnTurn, onClick }) {
     const settled = job.status === 'completed' || job.status === 'failed' || job.status === 'killed';
     // 动画订阅仅限存活卡片：settled 后退订共享 clock（同 SubagentMessage 的
     // 约定）。1s tick 只驱动运行时长跳动——状态标是静态的（见 statusInfo）。
@@ -82,5 +82,5 @@ export function JobCard({ job, addMargin, onClick }) {
     // 调用（run_in_background 卡）的延续，与工具卡通栏左对齐；子代理卡才
     // 是嵌套子实体、保留缩进。瀑布的 `  │ ` 槽自带两格，正好与工具卡正文
     // 的 `  ⎿ ` 槽位一致。
-    return _jsxs(Box, { flexDirection: "column", marginTop: addMargin ? 1 : 0, ref: viewportRef, onClick: onClick, onMouseEnter: clickable ? () => setHovered(true) : undefined, onMouseLeave: clickable ? () => setHovered(false) : undefined, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: hovered && clickable ? 'claude' : info.color, children: info.glyph }), _jsx(Text, { bold: true, color: hovered && clickable ? 'claude' : undefined, children: `${t('jobs-card-prefix')}${job.id}` }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: job.kind }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { children: clipLine(job.label, Math.max(10, rowWidth - 30)) }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: formatJobDuration(job) }), headerDetail !== undefined && _jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: headerDetail })] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: info.color, children: info.label })] }), !settled && activity.length > 0 && activity.map((line, index) => (_jsx(Text, { dimColor: true, wrap: "truncate", children: `  │ ${clipLine(line, rowWidth)}` }, `${job.id}-wf-${index}`))), settled && job.status !== 'completed' && headerDetail !== undefined && (_jsx(Text, { dimColor: true, wrap: "truncate", children: `  └ ${clipLine(headerDetail, rowWidth)}` }))] });
+    return _jsxs(Box, { flexDirection: "column", marginTop: marginTopOnTurn ? 1 : 0, ref: viewportRef, onClick: onClick, onMouseEnter: clickable ? () => setHovered(true) : undefined, onMouseLeave: clickable ? () => setHovered(false) : undefined, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: hovered && clickable ? 'accent' : info.color, children: info.glyph }), _jsx(Text, { bold: true, color: hovered && clickable ? 'accent' : undefined, children: `${t('jobs-card-prefix')}${job.id}` }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: job.kind }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { children: clipLine(job.label, Math.max(10, rowWidth - 30)) }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: formatJobDuration(job) }), headerDetail !== undefined && _jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: headerDetail })] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: info.color, children: info.label })] }), !settled && activity.length > 0 && activity.map((line, index) => (_jsx(Text, { dimColor: true, wrap: "truncate", children: `  │ ${clipLine(line, rowWidth)}` }, `${job.id}-wf-${index}`))), settled && job.status !== 'completed' && headerDetail !== undefined && (_jsx(Text, { dimColor: true, wrap: "truncate", children: `  └ ${clipLine(headerDetail, rowWidth)}` }))] });
 }