@deepseek-harness-tui/dsh-tui 0.14.1 → 0.16.0

package/guide/dsh-tui-guide/interaction.md

@@ -60,8 +60,9 @@
 - 富状态最多三行，只能用宿主的 `Box`、`Text`、`Image` 与终端尺寸。
 - 点击/悬停/拖动只在 fullscreen 下生效，不会取得键盘。
 - `Image` 接收已解码 RGBA，另有同尺寸字符回退。
-- 探测到 Kitty graphics 时，按终端报告的单元格像素比例等比居中。
-- 像素比例不可用时用保守默认值；必要时透明留边并降采样。
+- 探测到 Kitty graphics 时，按终端报告的单元格像素将图像等比放大或缩小到预留格子盒，并居中留透明边。
+- 像素比例不可用时用保守默认值；超出像素预算时降采样。
+- 整帧 16 MiB 预算同时约束原图与放大后的栅格；超限图片显示文字回退。
 - 否则自动显示回退内容（inline、辅助功能、多路复用器同样如此）。
 
 同一动作的键盘路径由插件另提供 slash 命令，或注册 `tuiShortcuts`。
@@ -74,12 +75,11 @@
 启动**落地页**与**首次引导向导**各自独占键盘；两者都只把结果交回对话页，不新增行为。
 
 - **落地页**：可打印字符接进输入框（行首 `/` 时前缀由 `❯` 变 `⌘`），`Backspace`/`Delete`/`←`/`→`/`Home`/`End` 编辑；
-- **落地页**：可打印字符接进输入框（行首 `/` 时前缀由 `❯` 变 `⌘`），`Backspace`/`Delete`/`←`/`→`/`Home`/`End` 编辑；
-  输入光标是**压在当前字符身上的反显块**（对那一个字符 inverse，行尾是反显空格；主题声明了 `cursor`
-  键时改用该填充色的实色块配对比字形，见[主题系统](themes.md)），闪烁是纯样式切换
-  （inverse ↔ 常规，约 550ms 一相位），绝不另起一格、绝不吃掉字符；`Alt+R` 继续最近一条会话
+  输入使用**终端原生光标**，形状、颜色、闪烁及已启用的动画或拖尾继承终端设置；
+  光标移动不增删字符。静态呈现保留[主题绘制的光标回退](themes.md)；`Alt+R` 继续最近一条会话
   （= 入口行第一格「继续「…」」，仅此屏生效，无可继续会话时无动作，键位可在 `/settings` 改）；
-  **执行**选中命令，`Esc` 只收面板、草稿不动）；面板没收时 `Enter` 直接**发送**这一行（行首 `/` 的命令——含
+  行首 `/` 弹出**命令补全面板**（数据与组件与聊天页同源：`↑`/`↓` 移选中，`Tab` **补全**选中命令到输入框、光标移到末尾，
+  `Enter`/点击**执行**并清空输入，`Esc` 只收面板、草稿不动）；面板收起后 `Enter` 直接**发送**这一行（行首 `/` 的命令——含
   插件/registry 命令——按对话页同一条合并命令表判定，是命令就不发模型）；
   `↑`/`↓`/`Tab` 沿焦点环走（输入框 → 框下参数行四段 → 快捷入口行 → Tips 行），`Enter` 激活焦点上的那一条
   （焦点在 Tips 行上 `Enter` = 切下一条 Tip），在入口/参数段上敲字会把焦点收回输入框；有字时 `Esc` 只清空，
@@ -105,11 +105,13 @@
   还会**自动轮换**（约 10s 一换，手动切换后计时重置），切换只改文本、行高与居中位置不变。
 - **双角铭牌**：左下角工作目录**可点**——点开既有的 `/workspace` 菜单
   （盖在落地页之上、`Esc` 回落地页），键盘路径 = 焦点环末格 + `Enter`，悬停/焦点 =
-  文字高亮；右下角第一行是 `dsh-tui v<TUI>`，其下两个内核各占一行：
-  `▸ DSH · dsh-core v<内核>` / `Claude · claude-code v<CLI>`。`▸` 标出当前内核，其余行暗色；
-  不可用的内核在版本后写原因（如「未安装」「未登录」），读不到版本时只写名字，检测期间显示
-  「检测中…」。整块可点，打开同一个内核选择器（键盘路径 = 焦点环 + `Enter`）。
-  各行右对齐，左下目录铭牌与第一行顶对齐，窄屏按既有 truncate-middle 截断。
+  文字高亮；右下角第一行是 `dsh-tui v<TUI>`，其下**每个已注册后端各占一行**：
+  `▸ DSH · dsh-core v<内核>` / `Claude · claude-code v<CLI>`（还有 `Codex · codex-cli v<CLI>`，
+  装了插件后端就再往后排）。名字取该后端 manifest 的短品牌名，`▸` 标出当前内核，其余行暗色；
+  不可用的内核在版本后写原因（如「未安装」「版本过旧 · 需升级」），读不到版本时只写名字，检测期间显示
+  「检测中…」；**登录状态不进铭牌**——要切内核时在选择器里看（未登录行可选，副标题标注「未登录」）。
+  整块可点，打开同一个内核选择器（键盘路径 = 焦点环 + `Enter`）。
+  各行右端贴齐同一条右边界，左下目录铭牌与第一行顶对齐，窄屏按既有 truncate-middle 截断。
 - **引导向导**：`←`/`→` 换步骤（例外：第三步的强度区、以及已钻进去的模型列表，横向键归子控件，不换步骤）、
   `Tab` 在「语言 / 主题」与「模型 / 强度 / 工作区」两组面板间切、`↑`/`↓` 移动选择；
   `Enter` 执行这一步（第一步 = 重新检查连通性，第三步 = 钻进 provider / 换模型 / 打开工作区选择器——**强度不走 Enter**，只用 `←`/`→` 调且移动即生效）；
@@ -322,6 +324,7 @@ Bracketed paste（右键或终端原生粘贴）保留普通文本与换行。
 四条命令和输入框行首的 `⌸` 按钮打开的是**同一个界面**。
 
 - 左边是工作区（durable registry）栏，右边是所选工作区里的会话列表。
+- 默认聚焦当前工作区最近使用的会话，`Enter` 直接进入；没有历史时聚焦“新建会话”卡片。
 - 每行带该会话的实时状态。
 - 原来是三个各自演化的实现（会话浏览器 / 会话总览 / 工作区首页）。
 - 同一个会话会被三个界面各自列出、各自定义"打开"的含义。
@@ -343,7 +346,7 @@ Bracketed paste（右键或终端原生粘贴）保留普通文本与换行。
 
 | 按键 | 作用 |
 | --- | --- |
-| `←` `→` | 切换键盘所在栏（工作区栏 / 会话栏），屏幕上永远只有一个 `❯` |
+| `←` `→` | 切换键盘所在栏（工作区栏 / 会话栏），同一工作区保留会话选择，屏幕上永远只有一个 `❯` |
 | `↑` `↓` / `PgUp` `PgDn` / 滚轮 | 在工作区栏移动工作区；在会话栏移动会话（第 0 行是"新建会话"卡片） |
 | 直接输入 | 实时筛选当前工作区下的会话（标题、目录、分支、模型） |
 | `Enter` | 会话栏：进入光标所在行（第 0 行 = 在该工作区新建会话）；工作区栏：打开该工作区的操作菜单 |
@@ -365,6 +368,10 @@ Bracketed paste（右键或终端原生粘贴）保留普通文本与换行。
 - 外部标签下 `Ctrl+N`、`Ctrl+X`、固定不生效；`Ctrl+L` 改为重新扫描该来源。
 - 导入与 `/migrate` 用同一套解析和确定性 id，两个入口导入同一条会话得到的是同一个 DSH 会话。
 
+每个工作区默认选中当前可见的最新会话，没有匹配会话时落在“新建会话”卡片。左右切栏或鼠标移入列表不会重置选择；换工作区时选中该工作区最新会话，返回之前的工作区时也重新选最新会话，不记忆各工作区的旧选择。尚未主动选择列表行时，首批结果、完整读取和后续刷新都会跟随最新可见会话；主动选择会话行或“新建会话”后，刷新保持该选择。
+
+原生光标与模型选择器一样跟随最后操作的区域：导航工作区时停在工作区行，导航会话时停在会话行或“新建会话”卡片，输入或点击筛选框时移到文本光标。行光标停稳 0.5 秒后隐藏，搜索光标保持可见；动画与拖尾沿用终端设置。窄屏隐藏工作区栏后，光标会回落到可见位置。筛选期间方向键与 Enter 的作用保持一致。
+
 工作区栏的菜单有四项：
 
 - **编辑**：选中该工作区，右侧列出它的会话。
@@ -454,6 +461,13 @@ Windows `dsh-tui.cmd --resume` 使用 `~/.dsh-tui/resume.txt` 中最后选择的
 - **不进会话历史**：问答不写入 session log，也不会出现在主上下文与 token 计数里（关闭面板即消失）。
 - **不打断主回合**：模型正在流式输出时也可以触发，主任务继续运行。
 - 面板内 `↑`/`↓` 滚动，`Space`/`Enter`/`Esc` 关闭，`c` 复制答案；等待答案时 `Esc` 取消。
+- 侧栏面板形态（面板列展开时）分两层：默认**阅读层**——`←`/`→` 切面板、`↑`/`↓` 在轮之间移动**选中**、`PgUp`/`PgDn` 翻页、`n` 新话题、`s` 把**选中轮**的答案送进主输入框（再按一次 `s` = 撤回）、`c` 复制选中轮的答案；`Enter`/`Tab`（或点击输入框）进**编辑层**（`Esc` 逐层退出：先退编辑、草稿保留），编辑层里 `←`/`→` 先移光标，光标贴到行首/行尾后再按同一个键就交回宿主切面板，`↑` 则直接回到标题（列表）。
+- 侧栏那行底栏提示**按层换**（面板自己广告、宿主只拼）：光标在**列表**里说 `↑/↓ 选择 · s 送聊天 · c 复制`（已附加的那一轮说 `s 撤回`），光标在**输入框**里则不说 s/c（那里 `s` 只是打字），改说 `↑ 选择`；空线程没有可选的轮，这一段不画。输入框里只留一句 `Enter 提问` 占位。
+- 选中的标记只有两点：标题**文字**反色（不铺满整行），以及终端光标停在那一行（所以按 `↑`/`↓` 时原生光标的拖尾是在标题之间上下走）。光标在主输入框或侧栏输入框里时两者都不显示——它表示的是「列表正拿着键盘」。**点标题行**也能把选中挪到那一轮。
+- 滚动只在必要时发生：目标标题已经在视口里就一行都不滚；走出视口才滚，而且只滚到**恰好露出**这一行（往上走贴视口顶、往下走贴视口底）。
+- **送聊天之后焦点自动回主输入框**：chip 就在眼前、可以直接接着打字，`Esc` 也立刻能把它撤掉（在面板里按 `Esc` 是退出面板，不是撤 chip）。
+- 点**消息区**（问题/答案正文）跟点面板其它地方一样，只把列焦点交给面板，不会注入任何东西——注入只有 `s` 一个入口。
+- `⤢` 全屏场景与侧栏面板同一套键位与选中态（线程 store 共享），区别只是送完聊天后整屏场景让位、回到主输入框。
 - 再次触发 `/btw` 会中止上一个侧问。
 
 ### 轨迹场景（/trace / Ctrl+T）
@@ -504,10 +518,15 @@ Windows `dsh-tui.cmd --resume` 使用 `~/.dsh-tui/resume.txt` 中最后选择的
 
 ### Model 与 preset
 
-`/model` 通过在当前历史末尾 fork 会话来切换模型，因为 DSH 没有原位换模型 API。
+`/model` 在同一页展示模型列表与当前高亮模型的推理等级。DSH 额外显示提供商标签，首个为「最近使用」；打开时将当前模型记为最近一次使用并去重置顶，目录中仍可选的当前模型排在第一项并默认高亮。
+Codex 与 Claude 直接展示完整模型目录，不显示提供商或最近使用标签；目录加载后默认高亮当前模型。
+DSH 中 `Tab` 切到下一个提供商，`Shift+Tab` 切到上一个，首尾循环；所有后端均用 `↑/↓` 选择模型、`←/→` 调整推理等级。
+终端原生光标跟随**最后操作的区域**：`Tab`/`Shift+Tab` 移到提供商标签，`↑/↓` 移到聚焦模型的 `❯`，`←/→` 移到推理档位。移动时显示终端原本的光标形状、闪烁及已启用的动画或拖尾；停稳 **0.5 秒后隐藏**，再次移动时重新显示并计时。普通重绘不延长显示时间，输入框光标继续常显；无障碍模式保留可见焦点锚点。标签被裁剪或档位区不可见时回落到模型行。反色标签与 `❯` 始终保留，静态呈现也沿用这些焦点标记。
+确认时仅提交用户显式调整的推理草稿；只换模型时由后端沿用或校验保存的推理偏好，候选模型的默认档位不会写成新的偏好。模型选择器打开时，`Ctrl+B` 与 `Alt+Z` 仍控制侧栏，其余选择器按键由模型选择器消费。
+`Enter` 确认模型与等级，`Esc` 取消草稿。操作提示放在标题下，推理区在模型列表下独立显示标题与档位，`←/→` 提示紧贴推理标题；可选档位使用正文色，当前档位高亮。DSH、Claude、Codex 均沿用终端背景，并遮住底层文字。
+鼠标点击标签、模型和档位后，可点击标题下的「选择」应用或「取消」退出；滚轮在模型列表中移动。输入框上方空间不足时，省略导航提示、隐藏模型描述及邻项、合并推理区为一行，并把「选择 / 取消」保留在底部；仅剩两行时再隐藏推理行，保留聚焦模型与操作入口。
 
-- 旧会话仍保留在 `/resume` 中。
-- 还没有人说过话的会话不记分支：此时换模型得到的是一个不写 `parentSession` 的独立会话（继承同一份会话脚手架前缀），这样你随后打的第一个真实 prompt 仍能触发自动生成会话标题；已经对话过的会话照旧记血缘。
+`/model` 通过 DSH 的请求路由选择机制在同一会话内切换模型，保留 session ID、历史和标题。运行中的回合不能切换。下一次请求会记录实际使用的模型与模型变化提示；停放中的 agent 保留所选路由，返回该会话时也会保留；退出进程后，尚未发出请求的选择仅作为全局默认保存，从磁盘恢复仍按最后一次实际请求的路由解析。DSH 低于 `0.1.2-alpha.3` 时拒绝切换并提示升级，避免旧版子代理继续使用原模型。
 
 `/preset` 只允许空白会话原地切换。
 
@@ -619,7 +638,7 @@ dsh-tui 不修改 `~/.claude/settings.json`；会话启动时若其中的 `ANTHR
   - 浮层打开时不穿透滚动背后转录。
   - 轨迹场景移动光标（时间线一格 ±3 行、热点 ±1 行、详情展开时滚详情）。
   - 设置屏移动焦点行。
-- **拖拽**：选择文本，松开后立即复制并清除选区，弹出「已复制 N 字符」提示。
+- **拖拽**：选择文本，松开后立即复制并保留选区，弹出「已复制 N 字符」提示；重新拖选会替换现有选区。
   - `dsh-tui.scrollGutter: scrollbar` 时，右缘滚动条是拖拽目标。
   - 未修饰左键按住拖动，按轨道位置连续滚动（与点击轨道同一映射：拖到哪滚到哪）。
   - `Shift`/`Alt`/`Ctrl`+拖动仍是选字（拖拽协议只对无修饰左键开启）。
@@ -792,7 +811,7 @@ Claude 后端的审批来自 CLI：CLI 给出建议时多一个「始终允许
 
 - `/provider`、`/login`、`/logout`、`/permission`、`/add-dir`、`/hooks`、`/mcp`。
 - `/auth login deepseek-account` 或 `/provider` 完成 DeepSeek 登录后，若 Platform 返回尚未展示的登录赠金，鲸鱼女仆娘弹窗会显示“鲸鱼券”的金额与到期时间；按 Enter/Esc 关闭。
-- `/plugins`：`check <路径>` 校验插件清单。
+- `/plugin`：`list` 简洁列出你装的额外插件（不含安装自带）；`install <spec>` 把插件装进当前 profile（装前提醒 + 信任确认，嫡系包按随包清单免确认；`esc` 收起面板，安装中尝试取消并等待写操作结束，来不及时等待安装完成，已登记的版本豁免保留；构建脚本被拦时在面板里批准，版本不兼容可登记精确版本豁免）；`remove <bundle>` / `enable <名称|id>` / `disable <名称|id>` 是生命周期动作（bundle 名优先于行身份，模块名匹配多行时须改用具体行 ID；门禁 2 对提供本应用的 bundle、宿主层 `dsh-base` 与本包自己的行硬拒并给原因，任何启用与卸载都要确认（已装包来源无法验证）；**没有取消**——`esc` 只关面板，写入继续，卸载不删你自己的数据）；`check <路径>` 校验插件清单、`info <id>` 查已装条目或待装 spec、`registries` 列安装源；无参 `/plugin` 给完整诊断。
 
 **Skills**
 
@@ -802,11 +821,14 @@ Claude 后端的审批来自 CLI：CLI 给出建议时多一个「始终允许
 **其他**
 
 - `/update`、`/vim`（vim 编辑模式开关，见「输入编辑」）、`/terminal-setup`、`/connect`、`/help`。
-- `/kernel`：打开内核选择器（当前内核打勾，每行带版本与一句说明），在 DSH 与 Claude 会话里都可用。
+- `/kernel`：打开内核选择器（当前内核打勾，每行带版本与一句说明），在 DSH、Codex 与 Claude 会话里都可用。
   选中另一个内核会记住选择并重启进入它，在新内核里开新会话；原会话仍可在 `/resume` 找到，新会话
   启动失败时回到原会话。回合进行中不能切换。启动页的「内核」入口与右下角内核区打开的是同一个
   选择器。用 `--backend` 或配置行指定了内核时，本次按选择重启，之后直接启动仍按参数。全新启动
   不论记住的是哪个内核都先到启动页，带恢复目标的启动直接进入会话。
+- `/dsh`、`/codex`、`/claude`：直接选择对应内核，沿用 `/kernel` 的检查与重启流程。
+  选择当前内核只提示「已经是当前内核」；回合运行中不能切换。未安装 Claude 时打开安装向导；
+  Codex 未安装或版本过旧时显示安装/升级提示。启动尚未就绪时也可使用这三个命令。
 - `/exit`（别名 `/quit`、`/q`）。
 
 **注册表**
@@ -839,6 +861,14 @@ dsh-TUI 不预装通用技能；技能内容与发现规则由 DSH 及当前组
   - registry 服务缺失时 TUI 使用三项 legacy 兼容名册。
   - 服务已挂载但损坏、为空或不一致时标记 unavailable 并 fail closed。
   - 退出计划模式先恢复进入前的 sandbox/approval，再还原进入前所在的权限预设（registry 仍提供时）。
+  - DSH 的 `/permission` 选择以同样方式存进 `~/.dsh-tui/permission.json`：任何一次持久的预设切换
+    （选择器、手敲命令、Shift+Tab 静态模式、官方命令自行完成的切换）都会更新它；从未自定义过
+    权限面的会话按记住的预设启动，走同一条官方切换路径。这里的"从未自定义"以**用户是否动过**为准：
+    合成层自己会在每个新会话创建时写入默认预设（`dsh-permission-presets` 的 `session/created` →
+    `pinInitialPermission`），那三个事件不算用户选择——只有跑过回合、或身份不是合成默认预设的
+    会话才保有自己的权限面。计划模式的临时切换不记入（进入计划保持计划前的记忆、退出还原后再次
+    记入）；`DSH_PERMISSION_MODE` 是本次启动的初始权限面，显式设置时优先于该文件；名册已不提供
+    的身份会被跳过。
   - 非 DSH 后端（如 Claude）声明原生权限模式时，`/permission` 列的是该后端的模式：
     `default`（逐个询问）、`acceptEdits`（自动接受编辑）、`plan`（只读规划）、
     `bypassPermissions`（跳过全部权限确认），模型支持时还有 `auto`，每行带一句解释。

package/guide/dsh-tui-guide/plugins.en.md

@@ -26,9 +26,13 @@ live in the admission & development guide.
 
 ## Seam stability reference
 
-An **informal** maturity grading to help plugin authors gauge investment;
-the authoritative status and compatibility agreement live in the
-[admission & development guide](../tui-profile/docs/plugin-admission-and-development.md):
+A maturity grading to help plugin authors gauge investment; the authoritative
+status and compatibility agreement live in the
+[admission & development guide](../tui-profile/docs/plugin-admission-and-development.md).
+**The "stable candidate" tier is part of the frozen public surface as of the first
+published apiVersion (`tui.dsh/v1alpha1`)** — the four commitments are in
+`tui-profile/CHANGELOG.md`'s freeze entry; the other two tiers stay a **maturity
+reference**, not a promise:
 
 | Tier | Seams |
 | --- | --- |
@@ -39,6 +43,10 @@ the authoritative status and compatibility agreement live in the
 Also an experimental public surface:
 
 - `@deepseek-harness-tui/dsh-tui/api` (types-only entry).
+- **Rows inside a preset (experimental, seam VII)**: a bundle changes the `config` of a row
+  inside a preset dsh-TUI registers (for example, turning off `standard`'s
+  `compaction-basic` auto-compaction) with a `@deepseek-harness-tui/dsh-tui/preset-patch` row;
+  see seam VII of the [admission and development guide](../tui-profile/docs/plugin-admission-and-development.md).
 - **Side panels (experimental, §18)**: `ctx.tuiPanels.register({ apiVersion:
   1, id, title, icon?, component | compact })` registers a right-sidebar
   panel (the host prefixes `<pluginId>:`; ≤4 panels per plugin, ≤32 globally;
@@ -52,6 +60,71 @@ Also an experimental public surface:
 - The `@deepseek-harness-tui/dsh-tui/test-utils` subpath and
   `ctx.tuiPluginHost.grants.corrupt` were removed in the adapter layering
   refactor (#705).
+- **The backend contribution family (`tui.dsh/v1alpha1` `Backend`, seam XIV) has its
+  public surface frozen with the first published apiVersion**: the type surface
+  (`BackendSpec`, `validateBackendSpec`, `backendAdmission`) and conformance
+  (`TUI-BACKEND-001`) are usable, and **both the admission chain (manifest →
+  registry → descriptor) and the install chain are wired**: the boot scans the
+  bundles the profile declares (`dsh.profile.bundles`, written by `/plugin install`
+  and by `dsh plugin add` alike), reads `dsh-plugin.json` from the package root
+  nearest the actual ESM entry, and registers what the validator and the admission
+  accept — so "install a third-party backend, restart, see it in the picker" holds.
+  Three boundaries: that scan runs **before** backend-choice registry membership
+  is checked (the Config schema checks syntax only, and the standalone entry's
+  full/light composition follows the final, assembled kernel); a backend's
+  implementation is read from its entry module's `backend` export
+  (`backendExport` is an in-tree private field, so a declaration cannot name another
+  export) and that module is imported only when the backend is actually selected;
+  and installing **without restarting** still does not put it in the picker — that
+  is not a promise.
+  Each bundle currently binds one `Backend` declaration. Its manifest must pass
+  canonical projection, including unique contribution identities, and the handler
+  id must match the declaration. Entries awaiting authorization stay registered
+  but are neither probed nor loaded; explicitly selecting one at startup fails too.
+- **Installing a package is available in the terminal itself (C-4)**: `/plugin
+  install <spec>` goes through the host's `ctx.pluginManager` — a pre-install
+  notice, a trust confirmation decided by provenance of the package (the judge is
+  the packaged `tui-profile/feed/first-party.json`, decided offline; anything it
+  cannot vouch for falls back to the confirmation), and `esc` to close the pane.
+  During an install, it attempts cancellation and waits for profile writes to
+  settle: the service rolls the profile back on cancellation, or finishes the
+  install if applying has already made cancellation too late. Blocked build
+  scripts can be approved in the pane, and an incompatible version can receive
+  an **exact-version exemption**. Cancelling during exemption registration waits
+  for the current write and stops subsequent grants and the retry; exemptions
+  already written remain. **Known gaps**:
+  provenance is only a one-vote-to-veto seam with no online check at all (the
+  host service exposes no such API), and with no service the transcript reports
+  the CLI command and the reason instead of **running `dsh plugin` on the user's
+  behalf** (no pane opens: there is no flow to drive).
+- **Lifecycle actions are available in the terminal itself (C-5)**: `/plugin remove
+  <bundle>`, `/plugin enable <name|id>` and `/plugin disable <name|id>` go through the
+  same host service. **A bundle and a row are two levels**: a bundle is a composition
+  layer (the profile manifest's `dsh.profile.bundles`), a row is one patch entry's
+  `disabled`. The argument resolves against one snapshot, a bundle name first and
+  exactly, then `entryId` → `patchId` → module name; nothing that matches is reported
+  with what is addressable rather than guessed at. A module name matching multiple rows
+  is refused with their row IDs; use a specific ID. **Gate 2** (this application may not
+  switch itself off) refuses three kinds of target hard — the bundle providing this app,
+  the host layer `@deepseek-ai/dsh-base`, and this application's own rows (those loading
+  a module of this package, **or inserted by its own patch**: measured, that patch inserts
+  17 rows and 8 of them load a first-party `@deepseek-ai/*` module, of which the host locks
+  exactly one) — with a reason line and **no service call at all**, and it does so whether or not hot
+  reload is live (the host's own `stop-profile` guard only fires without HMR, and this
+  profile runs `patchReload: live`). `enable` is never refused by gate 2: it is the
+  repair action, and refusing it would seal off the only in-UI way back from a profile
+  somebody edited by hand. The host's own lock (`management-required` / `unaddressable`)
+  refuses both directions and its reason is quoted as given. **Every `enable` and `remove` requires confirmation** (a removal lists the
+  rows and overrides it drops), while `disable` asks only about a row the host layer
+  owns (switching one off unloads services this app injects). The host does not attest
+  installed package sources: local and Git packages can claim the same name and version,
+  so an exact feed match cannot waive confirmation when enabling. These actions have **no
+  cancellation**: the service offers none, so `esc` only closes the pane while the write
+  finishes and reports itself into the transcript (same session). **Known gaps**: a
+  removal deletes no user data — `~/.dsh-tui/backends/<id>/`, grants and storage
+  namespaces are **reported once** and left for the person to delete; when a package's
+  declaration cannot be read, the flow says it could not judge rather than claiming the
+  removal was clean.
 - `grants` is now the narrower `HostGrantFacade`; see that PR for migration
   details.
 - On `TuiSceneProps.channel` (`ChannelUi`), `minimal` / `setMinimal()` were
@@ -68,6 +141,27 @@ Also an experimental public surface:
   callers means both aliases and the `'setMinimal': 'mutate'` row in
   `ui-policy.ts` are deleted in v0.13; any remaining caller is migrated within
   that same release rather than postponing the removal again.
+- **The DSH kernel in the package's own entry** (the default since the
+  standalone host, [configuration](configuration.en.md)): the screen mounts
+  before the profile composes, so plugin rows activate *after* the first
+  frame and every `ctx.tui*` registration reaches an already-mounted screen
+  (themes, panels, status views and the rest join live). A runtime theme the
+  user had chosen is applied once its plugin registers it; until then the
+  first frames use the auto-detected palette. The root-capability guard is
+  the same as under `dsh --profile`: a row activating after the first TUI row
+  cannot use `ctx.root` capabilities (`root.plugin`, `root.effect`,
+  `root.on`, …) in its apply. A plugin that waits for something in its apply
+  holds the composition: start long work detached, not awaited. On a scene's
+  `TuiSceneProps.channel`, `ready` is `false` (and `status` `'starting'`)
+  while no session stands behind the channel, e.g. after the startup session
+  failed to open (`startupFailure`).
+- **Claude and Codex kernels** (light profile; accepted on Claude, not yet on
+  Codex, which takes the same composition path): the entry composes this
+  package's rows and the third-party bundles the profile declares, without
+  `@deepseek-ai/dsh-base`, after the first frame, on the same terms as above.
+  A row whose `inject` names a service only DSH's core provides (`agents`,
+  `llm`, `tools`, `sessionPersistence`, …) stays pending on these kernels;
+  the `tui*` services are all there.
 
 - The core repository remains independent; community plugins live in their own
   repos.

package/guide/dsh-tui-guide/plugins.md

@@ -24,8 +24,10 @@
 
 ## 接缝稳定性参考
 
-按当前实现成熟度给出的**非正式**分级，帮助插件作者评估投入；正式
-状态与兼容性协定以[准入与开发指南](../tui-profile/docs/plugin-admission-and-development.md)为准：
+按当前实现成熟度给出的分级，帮助插件作者评估投入；正式
+状态与兼容性协定以[准入与开发指南](../tui-profile/docs/plugin-admission-and-development.md)为准。
+**「稳定候选」那一档已随第一版 apiVersion（`tui.dsh/v1alpha1`）纳入冻结的公开面承诺**
+（四条承诺见 `tui-profile/CHANGELOG.md` 的冻结条目）；其余两档仍是**成熟度参考**，不构成承诺：
 
 | 分级 | 接缝 |
 | --- | --- |
@@ -36,6 +38,9 @@
 另：
 
 - `@deepseek-harness-tui/dsh-tui/api`（纯类型入口）为实验性公开面。
+- **preset 内的行（实验性，接缝七）**：bundle 用 `@deepseek-harness-tui/dsh-tui/preset-patch`
+  行改 dsh-TUI 注册的 preset 里某一行的 `config`（例如关掉 `standard` 的
+  `compaction-basic` 自动压缩），写法见[准入与开发指南](../tui-profile/docs/plugin-admission-and-development.md)接缝七。
 - **侧栏 Panel（实验性，§18）**：`ctx.tuiPanels.register({ apiVersion: 1,
   id, title, icon?, component | compact })` 向右侧栏注册面板（宿主自动加
   `<pluginId>:` 前缀；每插件 ≤4 个、全局 ≤32 个；`open()` 限速每 5s 一次；
@@ -46,6 +51,42 @@
   `@deepseek-harness-tui/dsh-tui/panels` 与 `./api`。
 - `@deepseek-harness-tui/dsh-tui/test-utils` 子路径与
   `ctx.tuiPluginHost.grants.corrupt` 已随 adapter 分层重构（#705）移除。
+- **后端贡献族（`tui.dsh/v1alpha1` `Backend`，接缝十四）的公开面已随第一版 apiVersion 冻结**：类型面
+  （`BackendSpec`、`validateBackendSpec`、`backendAdmission`）与 conformance
+  （`TUI-BACKEND-001`）已可用，**准入链路（清单 → registry → descriptor）与装链路都已接线**：
+  启动时扫 profile 声明的已装 bundle（`dsh.profile.bundles`——`/plugin install` 与 `dsh plugin add`
+  都写它），按**实际 ESM 入口最近的包根**读 `dsh-plugin.json`，校验 + 准入后注册，于是
+  「装一个第三方后端、重启后出现在 picker 里」成立。三条边界：这份扫描**早于**后端选择的注册表成员判定
+  （Config Schema 只校验语法，独立入口的完整/轻量组合由装配后的最终内核决定）；后端实现从包入口模块的 `backend` 导出取
+  （`backendExport` 是 in-tree 私有项，声明里写不了别的导出名），模块只在真的选中时才 import；
+  装完**不重启**仍然不会出现在 picker 里——那不是承诺。
+  当前每个 bundle 只接一个 `Backend` 声明；清单须通过规范投影（含贡献身份唯一性），handler 的 id 必须与声明一致。
+  等待授权的条目仍注册身份，但不探测、不加载；启动参数或配置显式指定它也会报错。
+- **装包本身已在终端里可用（C-4）**：`/plugin install <spec>` 走宿主
+  `ctx.pluginManager`，装前给提醒、按来源决定要不要确认信任（嫡系判据是随包发布的
+  `tui-profile/feed/first-party.json`，离线可判；验不过一律 fail closed 退回确认），
+  `esc` 收起面板；安装进行中会尝试取消，面板等写操作结束后才关闭。取消成功由服务回滚 profile，
+  已进入应用阶段而来不及时则等待安装完成。构建脚本被拦时在面板里批准，
+  版本不兼容可登记 **精确版本豁免**；登记期间取消会等待当前写入、停止后续登记和重试，
+  已写入的豁免保留。**已知缺口**：provenance 只留了「一票否决」的缝、
+  没有任何在线校验（宿主服务不暴露这类 API）；服务缺席时由转录给出 CLI 命令与原因
+  （不弹面板：没有可驱动的流程），**不在 TUI 内代跑 `dsh plugin`**。
+- **生命周期动作已在终端里可用（C-5）**：`/plugin remove <bundle>`、`/plugin enable
+  <名称|id>`、`/plugin disable <名称|id>` 走同一套宿主服务。**bundle 与行是两级语义**：
+  bundle 是组合层（写 profile 清单的 `dsh.profile.bundles`），行是 patch 的 `disabled`；
+  解析顺序是 bundle 名精确匹配优先，其次 `entryId` → `patchId` → 模块名，都不中就给可寻址
+  清单、不猜；模块名匹配多行时，列出行 ID 并拒绝写入，须改用具体 ID。**门禁 2**（不能自己杀自己）在 TUI 侧硬拒三类目标——提供本应用的 bundle、
+  宿主层 `@deepseek-ai/dsh-base`、本应用自己的行（加载本包模块的行，**或由本包 patch
+  插入的行**：实测本包的 patch 插入 17 行，其中 8 行加载的是首方 `@deepseek-ai/*` 模块，
+  上游只锁住其中一个）——拒绝时给一行原因且**不发起任何服务调用**，与 HMR 是否生效无关（上游 `stop-profile` 守卫只在没有 HMR 时生效，本 profile 是
+  `patchReload: live`，所以那道守卫靠不住）。`enable` 不因门禁 2 被拒：它是复原动作，把手工
+  改坏的 profile 关在门外等于封死唯一的 UI 退路；上游自己的锁（`management-required` /
+  `unaddressable`）则两个方向都拒，并原样转述上游的理由。**任何 `enable` 与 `remove` 都要确认**（卸载列出它会动的行数与覆盖数），
+  `disable` 只对宿主层自己的行问一句（关掉它会卸载本应用注入的服务）。宿主不提供
+  已装包的来源证明，本地或 Git 包也能声明嫡系的名称与版本，因此即使命中 feed 也不能免确认。这些动作**没有取消面**：
+  服务不提供，Esc 只关面板，写入照旧跑完并（在同一会话里）把结果写进转录。**已知缺口**：
+  卸载不删用户数据——`~/.dsh-tui/backends/<id>/`、grants、存储命名空间只**报告一次**，由
+  用户自己决定删不删；包内声明读不到时明说「判断不了」，不制造「已清理」的假象。
 - `grants` 收窄为 `HostGrantFacade`，迁移细节见该 PR。
 - `TuiSceneProps.channel`（`ChannelUi`）上的 `minimal` / `setMinimal()` 已更名为
   `minimalUi` / `setMinimalUi()`；旧名保留为 **deprecated 别名**，读写同一个
@@ -57,6 +98,18 @@
   `TuiSceneProps.channel` 取用该端口的插件）做一次 `.minimal` / `.setMinimal(`
   扫描：零调用方即在 v0.13 删除这两个别名与 `ui-policy.ts` 里的
   `'setMinimal': 'mutate'` 行；仍有调用方则在同一版本内完成迁移，不再顺延。
+- **DSH 内核在本包入口进程内**（独立宿主起的默认，见[配置](configuration.md)）：
+  界面先挂、profile 后组合，插件行在首帧**之后**激活，所有 `ctx.tui*` 注册都落到
+  已挂载的界面上（主题、面板、状态视图等实时加入）。用户选定的运行时主题在其插件
+  注册后生效，此前的首帧用自动检测的配色。根能力守卫与 `dsh --profile` 一致：在首个
+  TUI 行之后激活的行，apply 里不能用 `ctx.root` 的能力（`root.plugin`、
+  `root.effect`、`root.on` 等）。apply 里等待会拖住组合：耗时工作脱离 apply 启动、
+  不要 await。场景的 `TuiSceneProps.channel` 在没有会话撑着时（例如启动会话打开失败，
+  见 `startupFailure`）`ready` 为 `false`、`status` 为 `'starting'`。
+- **Claude 与 Codex 内核**（轻量 profile；Claude 已验收，Codex 走同一条组合路径但尚未验收）：入口在首帧之后组合本包的行与 profile 声明的
+  第三方 bundle，不含 `@deepseek-ai/dsh-base`，规则同上条。`inject` 里有只由 DSH 核心
+  提供的服务（`agents`、`llm`、`tools`、`sessionPersistence` 等）的行在这两个内核下保持
+  pending；`tui*` 服务都在。
 
 核心仓库保持独立，社区插件各居其位。
 生态组织只维护收录与准入规则——不对社区插件的功能、质量或安全性

package/guide/dsh-tui-guide/themes.en.md

@@ -4,22 +4,30 @@
 
 ## Built-in themes
 
-dsh-TUI provides three Gentle Mist Blue palettes, plus an `auto` pseudo-theme:
+dsh-TUI ships two palette families (six themes) plus an `auto` pseudo-theme:
 
-| Name | Purpose |
-| --- | --- |
-| `auto` | Pseudo-theme: follows the system/terminal background, resolving to `light` or `dark` |
-| `light` | White panels, ink body text, and mist-blue interaction color |
-| `dark` | Dark-terminal adaptation with warm-gray text and soft blue accents |
-| `dark-ansi` | Compatibility fallback using only the 16 ANSI colors (except the ignition pair) |
+| Name | Family | Purpose |
+| --- | --- | --- |
+| `auto` | — | Pseudo-theme: follows the system/terminal background, resolving to `light` or `dark` |
+| `light` | Mist Blue | White panels, ink body text, and mist-blue interaction color |
+| `dark` | Mist Blue | Dark-terminal adaptation with warm-gray text and soft blue accents |
+| `dark-ansi` | Mist Blue | 16-color ANSI fallback (except the ignition pair) |
+| `pink-day` | Sakura Pink | Light terminals: blush panels and sakura-pink interaction color |
+| `pink-night` | Sakura Pink | Dark terminals: warm surfaces and sakura-pink interaction color |
+| `pink-ansi` | Sakura Pink | 16-color ANSI fallback (except the ignition pair) |
+
+Both families keep the same role split (light / dark / ANSI fallback). `auto`
+resolves within the Mist Blue family only; the Sakura Pink family is selected
+explicitly.
 
 Without an explicit choice, the TUI queries the terminal background with OSC
 11 and selects `light` or `dark`. It falls back to `dark` when the terminal
 does not answer.
 
-Light-theme panels, tool cards, and image previews use white (`#FFFFFF`)
-surfaces by default; image previews use neutral borders. Dark palettes and
-accent colors are unchanged. This does not modify the terminal's own
+Light-theme panels and tool cards take their own family's surface colors (`light`
+uses white `#FFFFFF`; `pink-day` uses blush `#F9ECF1`), and their input fills are
+the warm `#F6F3ED` / `#FBF3F0`; image previews always use neutral borders. Dark
+palettes and accent colors are unchanged. This does not modify the terminal's own
 background or wallpaper.
 
 `auto` turns that one-shot startup detection into a standing choice:
@@ -131,13 +139,14 @@ A few keys carry behavior worth knowing:
   channels (`#rgb`, `#rrggbb`, `#rrggbbaa` with the alpha ignored, or `rgb(r,g,b)`); `ansi:*` /
   `ansi256(n)` — or a missing key — falls back **per key** to the built-in pair selected by the
   palette's lightness, so the other key is unaffected.
-- `cursor`: the caret fill in the main prompt, launchpad input and picker search boxes.
+- `cursor`: the painted caret fill in the main prompt, launchpad input and picker search boxes
+  during static rendering without a native cursor, plus image-token focus in the main prompt.
+  Ordinary TTY text editing uses the native cursor; shape, color, blinking and animation follow terminal settings.
   The glyph on it is whichever of `text` / `inverseText`
   contrasts better with that fill (a 16-color `ansi:*` fill, or a palette whose `text`/`inverseText`
   has no parseable channels, cannot be measured and keeps `inverseText`), so a light caret can still
-  carry dark ink. The built-ins leave it empty — empty
-  keeps the inverse-video caret for backwards compatibility; declare it only when the caret must
-  stop following the body text color.
+  carry dark ink. The built-ins leave it empty, giving the painted fallback an inverse-video block.
+  A custom fill affects these painted highlights only.
 - Transcript link text follows `accent`; an empty or unparseable accent keeps the old fixed blue.
 
 ## npm plugin themes

package/guide/dsh-tui-guide/themes.md

@@ -4,21 +4,27 @@
 
 ## 内置主题
 
-dsh-TUI 提供三套 Gentle Mist Blue 色板，外加一个 `auto` 伪主题：
+dsh-TUI 内置两个色板族共六套主题，外加一个 `auto` 伪主题：
 
-| 名称 | 用途 |
-| --- | --- |
-| `auto` | 伪主题：跟随系统/终端背景，自动解析为 `light` 或 `dark` |
-| `light` | 白色面板、墨色正文、雾蓝交互色 |
-| `dark` | 深色终端适配，暖灰正文与柔雾蓝强调色 |
-| `dark-ansi` | 只依赖 16 色 ANSI 的兼容回退（点火色对除外） |
+| 名称 | 族 | 用途 |
+| --- | --- | --- |
+| `auto` | — | 伪主题：跟随系统/终端背景，自动解析为 `light` 或 `dark` |
+| `light` | 雾蓝 | 白色面板、墨色正文、雾蓝交互色 |
+| `dark` | 雾蓝 | 深色终端适配，暖灰正文与柔雾蓝强调色 |
+| `dark-ansi` | 雾蓝 | 16 色 ANSI 兼容回退（点火色对除外） |
+| `pink-day` | 樱 | 浅色终端：淡粉面板、樱粉交互色 |
+| `pink-night` | 樱 | 深色终端：暖调面板、樱粉交互色 |
+| `pink-ansi` | 樱 | 16 色 ANSI 兼容回退（点火色对除外） |
+
+两族保持相同的角色划分（浅色 / 深色 / ANSI 回退）。`auto` 只在雾蓝族内解析，
+樱族需要显式选择。
 
 未明确指定主题时，TUI 通过 OSC 11 查询终端背景，
 在 `light` 与 `dark` 之间选择；终端不响应时回退到 `dark`。
 
-浅色主题的面板、工具卡和图片预览默认用纯白底色（`#FFFFFF`），
-图片预览用中性边框。深色主题及强调色保持原样。
-此设置不修改终端自身的背景色或壁纸。
+浅色主题的面板与工具卡各用本族的浅色表面色（雾蓝 `light` 为纯白 `#FFFFFF`，
+樱 `pink-day` 为淡粉 `#F9ECF1`；两族的输入框底色另有暖色 `#F6F3ED` / `#FBF3F0`），
+图片预览一律用中性边框。深色主题及强调色保持原样。此设置不修改终端自身的背景色或壁纸。
 
 `auto` 把这一次性启动检测变成常驻选择：
 
@@ -130,11 +136,12 @@ DSH_TUI_THEME
   出固定通道的形式（`#rgb`、`#rrggbb`、`#rrggbbaa`（alpha 会被忽略）或 `rgb(r,g,b)`）；
   写成 `ansi:*` / `ansi256(n)`（或整键缺失）时**逐键**回退到按主题明暗选定的内置点火色对，
   另一个键不受牵连。
-- `cursor`：主输入框、落地页输入框及选择器搜索框光标的填充色。
+- `cursor`：无原生光标的静态呈现中，主输入框、落地页输入框及选择器搜索框绘制光标的填充色，
+  也用于主输入框的图片标记焦点高亮。常规 TTY 文本输入使用原生光标，形状、颜色、闪烁与动画由终端配置控制。
   块上的字形取 `text` 与 `inverseText` 中对该填充对比度更高
   的一个（16 色的 `ansi:*` 填充，或 `text`/`inverseText` 解析不出通道的调色板，
   都量不出对比度，仍用 `inverseText`），所以浅色光标也能配深墨字形。
-  内置主题留空——空值表示沿用原来的反色块光标（向后兼容）；只有需要光标独立于正文色时才声明。
+  内置主题留空——绘制回退采用反色块；自定义填充只影响这些绘制高亮。
 - 正文链接的文字色跟随 `accent`；accent 为空或解析不出时回落到原来的固定蓝。
 
 ## npm 插件主题