@deepseek-harness-tui/dsh-tui 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026, chimney (ccch1mneyyy)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,235 @@
+
+<p align="center">
+  <img src="docs/assets/logo.svg" alt="dsh-TUI - DeepSeek Harness terminal interface" width="560">
+</p>
+<p align="center">
+  <strong>简体中文</strong> | <a href="README_EN.md">English</a>
+</p>
+
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@deepseek-harness-tui/dsh-tui"><img alt="npm" src="https://img.shields.io/npm/v/@deepseek-harness-tui/dsh-tui?style=flat-square&color=4b6fff"></a>
+  <a href="https://github.com/ccch1mneyyy/dsh-TUI/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/ccch1mneyyy/dsh-TUI/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-263146?style=flat-square"></a>
+  <img alt="Public beta" src="https://img.shields.io/badge/status-public%20beta-7da1de?style=flat-square">
+  <img alt="官方收录" src="https://img.shields.io/badge/DeepSeek%20Harness%20官方公众号-收录-brightgreen">
+</p>
+
+# dsh-TUI
+
+> 一个美观且实用的 Claude Code 风格 TUI 插件：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。
+> 零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
+
+## 🎉 官方收录
+
+本插件被 **DeepSeek Harness 官方公众号** 推文收录，作为"内测用户精选插件"展示：
+
+<p align="center">
+  <img src="screenshots/wechat-official.png" alt="DeepSeek Harness 官方公众号推文收录 dsh-TUI" width="560">
+</p>
+
+## 核心能力
+
+  - **终端原生交互**：流式 Markdown、结构化工具卡、命令与文件补全、`@` 文件引用
+    （消息任意位置补全，发送时自动附加文件内容/目录列表）、历史搜索、消息选择、
+    inline/alternate-screen 两种渲染模式，以及 `/lang` 中英界面语言切换。
+  - **可观察的 Agent 状态**：实时工作状态、上下文分段进度、TPS、缓存命中率、
+    推理等级、输入/输出 token 与 Git/会话信息。
+  - **完整会话工作流**：`/resume`、`/new`、`/compact`、`/export`、模型切换，
+    以及双击 `Esc` 发起的会话 rewind/fork。
+  - **DSH 官方能力接入**：Agent preset、Skills、MCP、Goals、Todos、子代理、
+    `ask_user_question` 问卷都通过现有服务或注册表连接。
+  - **为长会话设计**：事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存，
+    避免渲染成本和内存随会话无限增长。
+
+## 界面预览
+
+![首屏：像素鲸鱼顶栏](screenshots/splash.png)
+
+![工作状态行 + 上下文进度条](screenshots/working-line.png)
+
+## 快速开始
+
+前置条件：可用的终端 TTY、官方 `dsh` CLI，以及 `pnpm` 10+。运行模型还需要
+`DEEPSEEK_API_KEY`。
+
+```sh
+# 1. 全局安装 CLI + 本插件（本插件自带 dsh-tui 直达命令）
+npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
+
+# 2. 启动（首次运行会自动初始化 dsh-tui profile，需 pnpm）
+dsh-tui
+```
+
+备选——手工安装 profile（仓库根目录 `install.sh` 已封装，含 pnpm 预检）：
+
+```sh
+sh install.sh
+# 或：dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui
+# 之后 dsh-tui 与 dsh --profile dsh-tui 等价
+```
+
+`dsh-tui --resume` 恢复上次会话；Windows 也可用仓库里的 `dsh-tui.cmd`（等价）。
+
+TUI 启动后会在后台检查 npm 是否有新版本；发现更新时会提示，输入 `/update`
+即可自动更新并重启恢复当前会话。
+
+旧版 `dsh-cc-tui` / `cc-tui` profile 的迁移命令与兼容数据说明见
+[安装与快速开始](docs/getting-started.md#从旧包迁移)。
+
+安装流程、profile 叠加机制、源码构建与常见问题见
+[安装与快速开始](docs/getting-started.md)。
+
+## 快捷键
+
+| 键 | 功能 |
+|---|---|
+| `Enter` | 发送（`Shift+Enter` 换行）；命令菜单打开时执行选中项 |
+| `Ctrl+C` | 中断当前回合；空闲时连按两次退出 |
+| `Esc` | 关闭命令/文件菜单；空闲双击清空输入；**空输入双击 = 时间回溯** |
+| `Ctrl+O` | 展开/收起详情（思考全文、工具参数与输出） |
+| `Ctrl+R` | 历史消息搜索 |
+| `/` | 会话内全文搜索（`n`/`N` 跳转） |
+| `Tab` / `Enter` | 命令 / `@` 文件补全（目录可继续深入） |
+| `Ctrl+V` | 粘贴：文本直接插入光标处；**Explorer 复制的文件/图片 → 插入文件路径** |
+| `?` | 快捷键菜单 |
+| `Shift+↑` | 消息选择模式（Enter 展开单条） |
+
+**鼠标（`fullscreen: true` 全屏模式；默认关，profile 补丁层覆盖开启）**
+
+| 操作 | 功能 |
+|---|---|
+| 拖拽选择 | 应用内文本选区，**松开即复制**（OSC 52 + `wl-copy`/`xclip`/`xsel` 原生兜底；tmux 内走 `load-buffer -w`），复制后自动取消选区并弹出「已复制 N 个字符」提示 |
+| 双击 / 三击 | 选词 / 选行，同样即选即复制 |
+| 滚轮 | 滚动消息列表 |
+| `Esc` | 拖拽进行中取消选区（不复制） |
+
+**问卷（模型发起 `ask_user_question` 时）**
+
+| 键 | 功能 |
+|---|---|
+| `↑/↓` | 选择选项 |
+| `Space` | 多选题勾选/取消 |
+| `Tab` | 切到自定义回答（不选选项直接打字） |
+| `Enter` | 提交当前选择 |
+| `Esc` | 中断提问（模型收到 ASK_ABORTED，可继续对话） |
+
+**本地命令（CC 指令全集复刻，均走 DSH 官方链路）**
+
+| 分组 | 命令 |
+|---|---|
+| 会话 | `/new` 新会话 · `/resume` 恢复 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown |
+| 状态 | `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md |
+| 模型 | `/model` 选择器 · `/thinking` 思考显示 · `/tokens` token 明细 · `/theme` 主题选择器 · `/lang` 中英界面切换 |
+| 账号/策略 | `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` · `/memory` |
+| 技能 | `/audit` 代码审计 · `/bug` bug 报告 · `/review` 代码评审 · `/practice` 编程练习 · `/pr_comments` PR 评论 · `/release-notes` 发布说明 · `/vuln-check` 漏洞检查 |
+| 其它 | `/agents` 子代理列表 · `/update` 自动更新并重启 · `/vim` · `/terminal-setup` · `/connect` · `/help` · `/exit` |
+| 注册表 | `/plan` `/goal`（DSH 命令注册表插件，随插件自动并入 `/` 菜单） |
+
+## 文档
+
+| 主题 | 内容 |
+| --- | --- |
+| [安装与快速开始](docs/getting-started.md) | 前置条件、安装、启动、profile 生命周期、源码开发 |
+| [配置参考](docs/configuration.md) | Cordis 覆盖、配置字段、Agent preset、MCP、环境变量 |
+| [主题系统](docs/themes.md) | 内置主题、自动检测、自定义 JSON 主题与校验规则 |
+| [交互与命令](docs/interaction.md) | 快捷键、鼠标、问卷、slash command 与会话工作流 |
+| [架构与限制](docs/architecture.md) | 运行链路、渲染与持久化设计、安全边界、已知限制 |
+| [贡献与开发约定](docs/contributing.md) | 贡献流程、仓库地图、构建产物、验证矩阵与修改规则 |
+
+完整的中英文索引见 [`docs/README.md`](docs/README.md)。
+
+## 配置与扩展
+
+- **Agent preset**：四种官方 Agent 模式（`standard` / `code` / `minimal` / `cordis`），
+  `/preset` 切换；已产生对话的会话不可切换，空白会话立即生效。默认 preset 持久化
+  在 `~/.dsh-cc/agent-preset.json`；`/model` 的选择持久化在 `~/.dsh-cc/model.json`。
+  详见[配置参考](docs/configuration.md#agent-preset)。
+- **自定义主题**：`/theme` 选择器（内置 `light` / `dark` / `dark-ansi`），也支持
+  `~/.dsh-cc/themes/<名字>.json` 自定义主题，选中即热切换并持久化；
+  `CC_TUI_THEME` 环境变量 > 持久化选择 > OSC 11 终端背景自动检测。
+  详见[主题系统](docs/themes.md)。
+- **MCP**：通过 `@deepseek-ai/dsh-mcp-client` 挂载服务器，工具以
+  `mcp__<服务器>__<工具>` 注册；`/mcp` 查看连接状态。
+  详见[配置参考](docs/configuration.md#mcp)。
+
+## 工作方式
+
+```text
+dsh profile
+  -> dsh-base
+  -> dsh-TUI Cordis patch
+  -> Agent preset + DSH services
+  -> session/event
+  -> Channel projection
+  -> React components
+  -> ported Ink/Yoga renderer
+  -> terminal
+```
+
+TUI 只负责交互与呈现。会话日志是对话真源，模型调用、工具执行、fork/resume、
+compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与性能设计见
+[架构文档](docs/architecture.md)。
+
+## 技术要点
+
+- **Gentle Mist Blue 配色**：雾蓝只承担品牌、焦点、交互与高亮，正文保持中性灰；
+  启动时查询终端背景色（OSC 11）自动选浅色/深色调色板，终端不响应时回退深色。
+- **事件驱动渲染**：`session/event` 事件流 → 增量差分渲染，滚动状态独立维护。
+- **布局级虚拟化**：长会话的每帧成本从 O(全会话) 降到 O(可视窗口)——屏幕外的
+  消息行渲染为"量高占位符"，其子树完全不参与布局。
+- **上下文进度条**：参考 pi-nano-context 算法（最大余数法分段着色 + 多级缩略读数）。
+- **TPS 仪表**：参考 pi-tps-meter——流式 1/8 格 gauge、历史 min-max sparkline、
+  速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
+- **working-activity 生态**：工作状态行消费
+  [dsh-working-activity](https://github.com/ccch1mneyyy/dsh-working-activity)
+  的 log-only `activity/status` 事件（与 Web UI 同一数据源）。
+- **终端粘贴**：raw 模式下 Ctrl+V 由应用接管——PowerShell `Get-Clipboard` 读取，
+  Explorer 复制的文件/图片插入文件路径，纯文本原样插入光标处。
+
+## 已知限制
+
+- 注入上下文（plugin source 内容）未做独立展示，随系统提示词并入进度条统计。
+- `/model` 实时切换走"会话 fork 续聊"（DSH 无原位换模型 API）：历史原样保留，
+  新会话路由到新模型，旧会话仍留在 `/resume` 列表里；选择写入
+  `~/.dsh-cc/model.json`，重启与 `/new` 均沿用。
+- `Ctrl+V` 读剪贴板依赖 PowerShell `Get-Clipboard`：剪贴板被其他进程短暂锁定
+  时自动重试，持续锁定时静默放弃。
+- 退出时以进程退出收尾，不等待 agent 异步落盘（持久化由 persistence 插件兜底）。
+- DSH 的 `/permission`（沙箱模式切换）未适配：需要 approval 服务 + 审批 UI，
+  当前 TUI 不消费审批流，刻意不挂。
+- `/vim` `/connect` `/hooks` `/memory` 为 CC 同名占位：对应能力在 DSH 侧无等价
+  机制，命令会给出明确说明而非静默。
+
+完整已知限制与安全边界见[架构与限制](docs/architecture.md)。
+
+## 开发
+
+CI 使用 Node 24 与 pnpm 11；包声明支持 Node `^22.19 || >=24`。
+
+```sh
+pnpm install --frozen-lockfile
+pnpm build
+pnpm smoke
+```
+
+`pnpm build` 会把 `src/` 编译到已提交的 `lib/types/`。修改源码时必须同步生成产物；
+渲染、问卷和工具卡还需运行对应回归脚本。
+
+## 权限与安全边界
+
+`dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与
+approval 策略。仓库提供的 profile 在非 Windows 平台默认采用工作区约束与审批；
+Windows 当前没有对应的沙箱后端，组合会退回到 `danger-full-access` 且不弹审批。
+在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
+
+详见[权限边界与已知限制](docs/architecture.md#权限与安全边界)。
+
+### 友情链接
+
+朋友们开发的[社区、相关项目与周边工具](docs/links.md)
+
+
+## License
+
+[MIT](LICENSE)

package/bin/dsh-tui.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * dsh-tui — dsh-tui profile 的一键直达启动器。
+ *
+ * 全局安装 @deepseek-harness-tui/dsh-tui 后获得 `dsh-tui` 命令，免去手工
+ * 输入 `dsh --profile dsh-tui`：
+ *
+ *   1. 检测 dsh CLI（缺失时提示安装 @deepseek-ai/dsh）；
+ *   2. 检测 $DSH_HOME/profiles/dsh-tui 是否已初始化，未初始化则自动执行
+ *      `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@<本包版本>`
+ *      自举——版本号与本包对齐，避免 pnpm store 缓存带来的旧版漂移；
+ *   3. 透传全部参数启动 `dsh --profile dsh-tui`。
+ *
+ * `--resume` 由本启动器拦截：读取 TUI 保留的兼容路径 ~/.dsh-cc/resume.txt，
+ * 以 DSH_CC_RESUME_SESSION 环境变量喂回（见 src/sessionHistory.ts 的
+ * 启动器契约），该 flag 本身不再传给 dsh。
+ */
+import { spawn, spawnSync } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = fileURLToPath(new URL('.', import.meta.url))
+const ownVersion = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8')).version
+const PACKAGE = '@deepseek-harness-tui/dsh-tui'
+const PROFILE = 'dsh-tui'
+
+// React 开发构建会把每次渲染的 performance.measure() 堆进无界缓冲区导致
+// 长会话 OOM——与仓库根 dsh-tui.cmd 保持一致，强制 production。
+process.env.NODE_ENV ??= 'production'
+
+const isWin = process.platform === 'win32'
+// Windows 上 .cmd shim 必须经 shell 启动（Node ≥18.20.2 的安全限制）；
+// 其余平台直接 spawn 无后缀的 dsh。
+const shellOpt = isWin ? { shell: true } : {}
+
+// --- 1. dsh CLI 预检 ---------------------------------------------------------
+const probe = spawnSync('dsh', ['--version'], { stdio: 'pipe', ...shellOpt })
+if (probe.error || probe.status !== 0) {
+  console.error('[dsh-tui] 未检测到 dsh CLI。请先安装官方客户端：')
+  console.error('  npm install -g @deepseek-ai/dsh')
+  process.exit(1)
+}
+
+// --- 2. profile 自举 ----------------------------------------------------------
+const dshHome = process.env.DSH_HOME || join(homedir(), '.dsh')
+const profileDir = join(dshHome, 'profiles', PROFILE)
+if (!existsSync(join(profileDir, 'node_modules', '@deepseek-harness-tui', 'dsh-tui'))) {
+  const pnpmProbe = spawnSync('pnpm', ['--version'], { stdio: 'pipe', ...shellOpt })
+  if (pnpmProbe.error || pnpmProbe.status !== 0) {
+    console.error('[dsh-tui] 首次安装需要 pnpm（dsh plugin 会把安装转发给它）：')
+    console.error('  npm install -g pnpm   （或启用 corepack：corepack enable pnpm）')
+    process.exit(1)
+  }
+  console.log(`[dsh-tui] 首次运行，正在初始化 ${PROFILE} profile（${PACKAGE}@${ownVersion}）…`)
+  const add = spawnSync('dsh', ['plugin', '--profile', PROFILE, 'add', `${PACKAGE}@${ownVersion}`], { stdio: 'inherit', ...shellOpt })
+  if (add.status !== 0) {
+    console.error('[dsh-tui] 插件安装失败。可稍后手工重试：')
+    console.error(`  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${ownVersion}`)
+    process.exit(add.status ?? 1)
+  }
+}
+
+// --- 3. --resume 拦截 ---------------------------------------------------------
+const args = []
+for (const a of process.argv.slice(2)) {
+  if (a === '--resume') {
+    try {
+      process.env.DSH_CC_RESUME_SESSION = readFileSync(join(homedir(), '.dsh-cc', 'resume.txt'), 'utf8').trim()
+    } catch {
+      // 没有历史会话可恢复——静默忽略，正常冷启动。
+    }
+  } else {
+    args.push(a)
+  }
+}
+
+// --- 4. 启动 ------------------------------------------------------------------
+const child = spawn('dsh', ['--profile', PROFILE, ...args], {
+  stdio: 'inherit',
+  env: process.env,
+  ...shellOpt,
+})
+child.on('error', (err) => {
+  console.error(`[dsh-tui] 启动失败：${err.message}`)
+  process.exit(1)
+})
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal)
+  } else {
+    process.exit(code ?? 0)
+  }
+})

package/cordis.patch.yml

@@ -0,0 +1,218 @@
+# The dsh-tui bundle patch: the interactive terminal front door over the
+# dsh-base layer. Applied after dsh-base's insert; rows here override base
+# rows by id, with the profile's own cordis.patch.yml and any --patch
+# overlays still to come.
+#
+# A patch replaces the targeted row's whole `config`, so each row below
+# restates every key it owns (see the dsh-base patch for the shared
+# defaults). The dsh-base core rows that need no dsh-tui value — tools,
+# sandbox/approval policy, skills, goal, plan mode, workspace context,
+# telemetry — are inherited unchanged.
+
+# ── surface-specific values over the dsh-base layer ─────────────────────────
+
+# The dsh-tui deployment persona; CC_TUI_PERSONA overrides the coding-agent
+# default (the base persona is empty).
+- id: system-prompt
+  config:
+    persona: !!js process.env.CC_TUI_PERSONA ?? 'You are a coding agent.'
+
+# The native DeepSeek adapter, pinned to the harness defaults: full thinking
+# at max effort, key and base URL from the launching environment. The base
+# entry defers both to the `llm-deepseek:` settings section; the settings
+# document still overrides these entries per request when it carries one.
+# rc.6 schema key is `apiKeyEnv` (credential-ref env var NAME, default
+# DEEPSEEK_API_KEY); the old snapshot's `apiKey` key no longer exists.
+- id: llm-deepseek
+  config:
+    apiKeyEnv: 'DEEPSEEK_API_KEY'
+    baseURL: !!js process.env.DEEPSEEK_BASE_URL
+    thinking: enabled
+    reasoningEffort: max
+
+# The TUI creates (or resumes) its agent at runtime through the agent
+# factory; no declarative agents are started at boot, and the configured
+# agent list stays the base's empty default.
+- id: agent-loop
+  config:
+    agents: []
+
+# ── agent presets (issue #8) ────────────────────────────────────────────────
+#
+# The model-facing plugin set moves INTO the agent-presets roster: every
+# session composes its tools/prompt sections from one preset directory
+# (standard/code/minimal/cordis) instead of the host rows below. The dsh CLI's
+# profile-boot sees this composition's `agent-presets` row and overlays the
+# shipped `config/agent-presets/` root onto it automatically, so the row here
+# carries no roots; `$DSH_HOME/.agent-presets` (user-authored presets) is
+# appended by the roster itself (`includeUserRoot` default). Mirroring the
+# official dsh-web-app patch: every dsh-base row a preset now owns is
+# disabled here, so a minimal agent does not leak host-layer tools (an agent's
+# registry view resolves agent → preset → global).
+
+- id: agent-instructions
+  disabled: true
+
+- id: command-compact
+  disabled: true
+
+# compaction lives in the preset's own isolate realm (standard/code/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.
+- id: compaction-basic
+  disabled: true
+
+- id: plan-mode
+  disabled: true
+
+- id: skill-filesystem
+  disabled: true
+
+- id: tool-bash
+  disabled: true
+
+- id: tool-fs
+  disabled: true
+
+- id: tool-fs-search
+  disabled: true
+
+- id: tool-goal
+  disabled: true
+
+- id: tool-jobs
+  disabled: true
+
+- id: tool-pwsh
+  disabled: true
+
+- id: tool-ralph
+  disabled: true
+
+- id: tool-result-pruner
+  disabled: true
+
+- id: tool-skill
+  disabled: true
+
+- id: tool-str-replace-editor
+  disabled: true
+
+# Delegation tools (subagent spawn/fork, controls, workflows) are preset rows
+# now; the preset's `delegation` group re-adds them with package defaults, so
+# the former TUI's depth-1 cap no longer applies.
+- id: tool-subagent
+  disabled: true
+
+- id: tool-subagent-control
+  disabled: true
+
+- id: tool-subagent-fork
+  disabled: true
+
+- id: tool-subagent-list-agents
+  disabled: true
+
+- id: tool-todo
+  disabled: true
+
+- id: tool-web
+  disabled: true
+
+- id: tool-workflow
+  disabled: true
+
+- id: workflow-worker-thread
+  disabled: true
+
+# Windows has no sandbox confinement backend yet (sandbox-local's win32
+# chain is empty); use danger-full-access on Windows so bash commands can
+# run. Other platforms keep the base workspace-write default.
+- id: sandbox-policy
+  config:
+    mode: !!js "process.platform === 'win32' ? 'danger-full-access' : (process.env.DSH_PERMISSION_MODE ?? 'workspace-write')"
+    workspaceRoot: !!js process.cwd()
+
+# On Windows, skip approval prompts (no sandbox = the user's terminal trust
+# model, matching every other terminal coding agent).
+- id: approval
+  config:
+    policy: !!js "process.platform === 'win32' ? 'never' : ((process.env.DSH_PERMISSION_MODE ?? 'workspace-write') === 'danger-full-access' ? 'never' : 'ask')"
+
+# Sessions live in the shared JSONL store (~/.dsh/sessions) — the same
+# backend dsh web writes — so /resume here and the web session list see each
+# other (#24). The row itself comes from the dsh-base layer; this override
+# only re-points the root when DSH_CC_SESSION_ROOT is set (test isolation).
+- id: session-persistence-jsonl
+  config:
+    root: !!js process.env.DSH_CC_SESSION_ROOT ?? dshHomePath('sessions')
+
+# ── dsh-tui rows ────────────────────────────────────────────────────────────
+
+# The `user-interaction` service row comes from the dsh-base bundle layer
+# (mounted before this layer); do not insert it again — the include patch
+# semantics would create a duplicate row. dsh-tui defensively creates the
+# service on its own context when no composition provides it (bare
+# `dsh --config cordis.yml` boots), then mounts the model-facing
+# ask_user_question tool and registers the questionnaire provider on
+# `ctx.userQuestions`.
+
+- insert:
+    # The agent-preset roster (issue #8): `ctx.agentPresets`, the service the
+    # TUI composes every session's model-facing world from. No `roots` here —
+    # the dsh CLI's profile-boot overlays its shipped `config/agent-presets/`
+    # directory (standard/code/minimal/cordis, system trust) onto this row
+    # whenever a composition carries it, and the roster itself appends the
+    # user-authored `$DSH_HOME/.agent-presets` root. A boot that never reached
+    # profile-boot (bare `dsh --config cordis.yml`) leaves the roster empty;
+    # the TUI then keeps its pre-presets behavior (see presets.ts).
+    - id: agent-presets
+      name: '@deepseek-ai/dsh-agent-presets'
+      config:
+        default: standard
+
+    # Host-plane services the `cordis` preset's plugin-experimentation tool
+    # waits on (dynamicCordisRunner/cordisInspect); dsh-base carries no such
+    # row — the official web app inserts it the same way.
+    - id: cordis-host-runner
+      name: '@deepseek-ai/dsh-cordis-host-runner'
+
+    # 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.cmd --resume`
+    # feeds the session id through DSH_CC_RESUME_SESSION.
+    - id: dsh-tui
+      name: '@deepseek-harness-tui/dsh-tui'
+      config:
+        provider: deepseek-official
+        # Alt-screen fullscreen（CC 同款）：应用内鼠标选区（选择即复制, OSC 52 +
+        # wl-copy/xclip/xsel 兜底）、滚轮滚动、双击选词/三击选行。默认关闭——
+        # inline 模式下由终端原生选择/复制/scrollback 接管；想用 fullscreen 在
+        # profile 用户层 cordis.patch.yml 同 id 覆盖整行 config（fullscreen: true）。
+        fullscreen: false
+        # 每个请求实际生效的推理强度，按当前路由的 adapter 档位校验
+        # （deepseek: off/high/max）——不在档位表里的值被忽略，回落 adapter
+        # 默认值。优先于持久化的 Shift+Tab 选择（~/.dsh-cc/effort.json）；
+        # 同时作为顶栏/状态栏的启动显示，首个请求头回来后以实际值为准。
+        effort: max
+        # Static preset choice (CC_TUI_PRESET overrides): wins over the
+        # persisted `/preset` preference (~/.dsh-cc/agent-preset.json), which
+        # wins over the roster default (standard).
+        preset: !!js process.env.CC_TUI_PRESET ?? undefined
+        sessionId: !!js process.env.DSH_CC_RESUME_SESSION ?? undefined
+
+    # Live working-line data source (thinking copy / running tool / turn
+    # summary). Mounted through @deepseek-harness-tui/dsh-tui's own
+    # `./working-activity` re-export, NOT the bare `dsh-working-activity`
+    # name: the dsh Loader resolves row names from the profile directory,
+    # and pnpm's isolated node_modules layout never links a transitive
+    # dependency into the profile root (npm's flat layout hid this), so the
+    # bare name died with ERR_MODULE_NOT_FOUND and disposed the whole app at
+    # boot (#60).
+    # publishIntervalMs 500 keeps the status-line timers ticking smoothly
+    # (default 2000ms).
+    - id: working-activity
+      name: '@deepseek-harness-tui/dsh-tui/working-activity'
+      config:
+        publishIntervalMs: 500