dsh-expert-group
Expert Group
DSH 专家子代理、Expert Group 任务侧边栏与设置页（双面 bundle）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:NTOIOTN/dsh-expert-group#8808a0a0485f3bdc15dd15748a92dc7ed13d211f
dsh-expert-group
DSH 专家子代理、Expert Group 任务侧边栏与设置页（双面 bundle）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:NTOIOTN/dsh-expert-group#8808a0a0485f3bdc15dd15748a92dc7ed13d211f
Expert Group 以 dsh-expert-group 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
settings 命名空间
dsh-expert-group保存全局 provider、defaults和通知偏好；会话覆盖与子代理快照属于插件自己的dsh_expert_groupstorage domain。
一个可安装到 DSH（DeepSeek Harness）的外部 dual-face Cordis bundle，其专家分工、 按角色路由模型与思考深度、后台并行委派纪律等设计思路借鉴自开源项目 oh-my-opencode-slim （https://github.com/alvinunreal/oh-my-opencode-slim ，MIT）， 把「按角色区分模型与思考深度」的专家子代理能力引入 DSH，并在 Web 界面的“dsh-expert-group”设置页维护全局模型、思考深度与通知偏好。 同时把 oh-my-opencode-slim 的主代理 orchestrator 设计移植过来：根会话负责拆解、委派、整合和验证，专家子代理保持叶子 worker 约束。
explorer — 只读代码库侦察（文件定位、符号/模式梳理）librarian — 只读外部文档 / 库 API 调研oracle — 只读架构决策 / 疑难调试 / 代码审查designer — UI/UX 与视觉实现（可写）fixer — 已定方案的实现、重复修改、迁移与测试补齐，含单文件的大量工作（可写）observer：只读视觉分析专家，负责 Host 提供的真实 durable 图片附件的解读，包括截图、UI 稿、图表和已呈现为图片的 PDF 页面；不接受任意本地路径。裸 Config 默认关闭；当前 cordis.patch.yml 显式把 bundle override 设为开启。图片路由会把 Host 创建的 image/png durable attachment ContentBlock 直接交给 Observer；自动图片入口只派发有界的纯视觉任务，用户原始任务仍由主代理持有并综合视觉报告。explorer、librarian 等），注册在当前 DSH 的 ctx.tools；
主代理不得把 Harness 外层 subagent_<role>、PTC 的 run_code 或通用 subagent 入口当作插件委派替代。run_in_background: false 仅为兼容输入，与省略或 true 一样采用非阻塞 admission，不等待最终结果（异常/空返回仍按「自动恢复」处理）。llm.listProviders/listModels + resolveCallConfig 校验，只接受设置中已添加的模型。@deepseek-ai/dsh-settings，package 也不声明该 peer，因此默认安装不会额外下载 settings 包。目标运行时为 0.2.0-rc.2；插件通过宿主 settings 服务的 describe/update/mutate 面读写 profile 条目，并由 DEG 自有的 settings-commit 端点完成语义校验与 revision 冲突检测（宿主不再提供 owner validate 钩子）。reasoningEffort 通过子代理 agent/request waterfall 注入，绕开 dsh-tool-subagent
AgentOptions 尚未公开该字段的限制。本插件发布到 npm 公共源，用 DSH 官方 dsh plugin CLI 按包名安装（--profile 为必填参数，一般填 web）：
dsh plugin --profile web add dsh-expert-group
前置条件：DSH Web 可正常运行（dsh web）、Node.js ≥ 22，且 PATH 上有 pnpm。安装后重启 dsh web 使插件生效。
桌面版（Electron 客户端）的 desktop profile 由客户端独占管理，PATH 上的 dsh CLI 改不动它：先打开 Desktop 完成初始化再完全退出，用安装目录自带的 CLI 执行同一命令。
& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add dsh-expert-group
安装后重新打开 Desktop 使插件生效。本插件不内置角色默认模型：先在 DSH「设置 → 模型」配置模型，再到「设置 → dsh-expert-group」为各角色选择模型并保存。
DEG 在 DSH Web 界面上的可见面只有三处，彼此独立、互不重叠：
| 界面 | 位置 | 能做什么 | 详细说明 |
|---|---|---|---|
| dsh-expert-group 设置页 | 设置 → dsh-expert-group | 维护全局 provider、六类专家的默认模型与思考深度，以及通知偏好、Observer优先、任务管理 与单个角色并发上限 | 设置页功能详解 |
| Expert Group 任务侧边栏 | 右侧栏（原生右栏，或装有 better-sidebar 时的独立页） | 查看当前根会话的任务树与运行状态；用 >> / << 在右栏打开或关闭某个子代理会话；取消 / 重试 fan-out 任务 | Expert Group 任务侧边栏 |
| 运行状态行与系统通知 | 主视图左下角 / Windows 桌面右下角 | 运行中显示 Orchestrator running、Explorer running 等运行词；任务进入终态时由 Windows Toast 提醒 | Web 状态提示 |
DEG 没有模型可调用的通知工具，也不在会话标题栏或右侧栏放模型配置入口：全局专家配置只在设置页维护，会话内的主模型覆盖仍由 DSH Host 自己管理。
下文的界面截图取自 DSH 桌面版，存放在仓库的
docs/assets/下。npm 安装包按package.json的files白名单发布、不包含docs/，因此从 npm 安装的副本里这些图片链接不会显示；在仓库中阅读一切正常。
设置页是 DEG 通过 settings.section 注册的独立分区（label 为 dsh-expert-group），并用 ctx.settings.configure({ auto: false }) 关掉了宿主自动生成的配置页——页面上出现的每个控件都由 DEG 自己渲染。
整页采用延迟保存：所有下拉、复选框、数字框只改草稿，只有点页脚「保存」才落盘；唯一的例外是「模型配置」区块里的 provider 卡片，它们各自持有草稿与独立的「应用 / 取消」。设置 namespace 不可写时整页保持只读。
下面按从上到下的渲染顺序逐个说明功能；实现细节与边界（数据流、revision 栅栏、七档写入规则等）见后文「模型配置」一节。
为便于公开发布，本文档中的所有界面截图都做过遮蔽处理：provider 路由名、模型名、Base URL 与凭据引用名显示为灰条。
dsh-expert-group，副标题「专家模型使用 DSH 当前已配置的 provider 和模型目录。」title 与 aria-label 都是 API Key 已配置）；右侧是 删除 与 编辑。编辑 展开卡片；删除 删除该 provider 及其配置。这是整页唯一带二次确认的操作，确认文案为 确定删除 provider「<显示名>」及其配置吗？，取消则不写盘。type=password，只写不读，保存后不回显明文。输入框有三态占位符：已配置（留空表示不修改）、粘贴 API Key 后点应用、当前凭据只读。凭据引用：<REF>（API Key 只写入 credentials 服务，保存后不回显明文）；没有引用时显示 未设置凭据引用。REF 由 provider 路由 id 推导——转大写、非字母数字换成 _、末尾加 _API_KEY，例如路由 my-gateway 得到 MY_GATEWAY_API_KEY；profile 里显式写了 apiKeyEnv 时以它为准。留空表示使用适配器默认端点；留空即删除该字段、回落到适配器默认端点。卡片内只判断空 / 非空，不做格式校验（格式强校验在「添加自定义提供方」卡片里）。适配器默认，选中它即删除 api 字段；其余选项由宿主 namespace schema 里 providers.<route>.api 的联合类型动态读出——具体有哪些协议由 DSH 当前版本决定，插件不硬编码词表。模型 右侧的标签有两种状态：适配器默认（首次编辑时写入用户覆盖） 与 已按用户覆盖。没有用户覆盖时只读展示适配器默认目录；第一次真正编辑才写入一份用户覆盖。恢复默认：对用户层 models 提交 unset，也就是删除用户覆盖，不是写空数组。获取模型：用草稿里（尚未保存）的 Base URL、协议与 API Key 去端点拉取候选模型；空结果时提示 该端点没有返回任何模型。候选列表可以全选 / 取消全选，采纳所选 时已存在的行不会被覆盖。没有模型：留空表示沿用适配器内置目录。每条模型包含两行字段：
模型 ID 与 显示名。ID 必填且不能重复（校验文案 模型 ID 不能为空 / 模型 ID 重复（<id>））；完全空白的行不会被写进用户覆盖。继承适配器默认，支持 500K / 128K 这类写法（K = 1000，M = 1000000），留空即继承；非正整数会被拦下（上下文窗口必须是正整数 / 最大输出 token 必须是正整数）。off / minimal / low / medium / high / xhigh / max，顺序与 DSH 的 pi-ai 档位词表一致，无论当前目录是否声明支持都始终显示。写入时 off 记空字符串、其余档位记同名小写字符串；七档全不勾选且没有未知键时删除 reasoningEfforts 字段。已有模型按 reasoningEfforts 恢复勾选，新增模型七档全不勾选。text 与 image 两个复选框，至少保留一个——只剩一个勾选时该项被锁定，不能再取消。这一行还带两条跨区域约束：
defaults.<role>.reasoningEffort 是角色单选。若一次保存会删除或取消某个正被角色默认使用的档位，保存被阻止并列出受影响角色，提示逐字为「无法保存：将删除的思考档位 <档位> 正被以下专家角色使用：<角色（档位）>。请先在这些角色的配置中改用其它档位，本页不会自动改写角色配置。」displayName、apiKeyEnv、baseURL、api、models）；transport、retryPolicy、compat 等隐藏高级字段既不显示、也不会被重建或删除。添加模型：追加一条空模型行（七档全不勾选、无输入类型）。✕ 按钮，无障碍名是 删除模型 N；没有二次确认。取消：丢弃本卡片草稿，回到已保存状态。应用（进行中显示 应用中…）：本地 schema 先校验 → 写 settings namespace → 成功后再写 API Key → 重新读取 provider 目录与凭据状态（上方角色表的可用档位随之刷新）。校验失败的提示逐字为 设置校验未通过，已拒绝写入：<原因>。配置冲突：本卡片的修改未提交。 与 重新打开（加载最新配置）；本地复核与宿主拒绝两条路径都有明确文案，不会静默覆盖别人的修改。添加提供方：从宿主已有适配器里选一个路由加进 profile；没有可添加项时按钮禁用。添加自定义提供方：打开自定义卡片，字段顺序是路由 ID → 显示名 → Base URL → 协议 → API Key → 模型。
/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/，并拒绝与现有 provider 重名或撞同一个凭据引用。Base URL 只支持 http:// 或 https://、Base URL 必须包含主机名。provider 配置已保存，但 API Key 写入失败：<原因>，并且只允许重试凭据写入。重新读取 provider 目录（进行中显示 读取中…）：重新拉取 provider 目录、凭据状态与模型目录；这是目录异常或外部改动后的手动恢复入口。当前宿主没有可配置的 provider。| 控件 | 默认值 | 取值 | 保存字段 |
|---|---|---|---|
| 通知弹窗（复选框） | 开启 | 开 / 关 | dsh-expert-group.notificationEnabled |
| 弹窗停留时间（下拉） | 5s | 5s / 10s / 30s / 60s / 5min / 10min / 永久 | dsh-expert-group.notificationHoldMs |
| 通知音量（滑杆 + 数字框） | 100 | 0 – 100，步进 1 | dsh-expert-group.notificationVolume |
100 表示不做任何衰减，只受 Windows 主音量影响；滑杆与数字框同值双向绑定。5s，音量 → 100）。无，首项 无 表示不统一。无：只清空顶层的统一选择，不会删除任何角色已有的 provider。无）。六行固定顺序：Explorer、Librarian、Oracle、Designer、Fixer、Observer。四列含义如下：
| 列 | 可选值来源 | 未选择时的占位 |
|---|---|---|
| 专家 | 角色标签按钮，点击进入该角色的提示词编辑器 | — |
| 供应商 | DSH 模型目录里的 provider | 未选择供应商 |
| 模型选择 | 按所选 provider 过滤后的模型 | 先选择供应商 / 未选择模型 |
| 思考深度 | 按所选模型的 reasoning 能力给出 模型默认 + 该模型声明的档位 | 先选择模型 / 模型无思考深度 |
<provider>（不可用） / <model>（不可用） 保留可见，方便发现失效配置。defaultEffort；把思考深度选回 模型默认（空值）会删除该角色的 reasoningEffort 字段。dsh-expert-group.defaults.<role>.provider / .model / .reasoningEffort。| 控件 | 默认值 | 保存字段 | 说明 |
|---|---|---|---|
Observer优先 | 关闭 | observerPreferred | 开启后图片提交改为 Observer 优先路由，并要求 Observer 模型明确支持 image，否则给出 已开启 Observer优先，但 Observer 模型未明确支持 image；原始输入已保留。；主代理提示词也切换到 Observer 优先段落 |
任务管理 | 开启 | taskManagementEnabled | 控制 DEG 是否把 Expert Group 注册到侧边栏：关闭并保存后调用当前 install 返回的 disposer 释放注册（原生右栏与 better-sidebar 的默认侧栏保持不变），重新开启并保存后重新注册；字段缺失或读取失败一律按开启处理 |
单个角色并发上限 | 10 | roleConcurrencyLimit | 取值范围 1–64 的整数。不是即时生效，点保存后才应用；非法值由 Host 拒绝（设置 roleConcurrencyLimit 无效） |
有未保存的修改、已保存、空。保存（保存中显示 保存中…）与 放弃修改。保存失败的错误文本显示在页脚上方，不弹独立对话框。| 维度 | DSH 内置模型页 | DEG「模型配置」区域 |
|---|---|---|
| 可见字段 | 含隐藏高级 YAML 字段（transport、retryPolicy、compat 等） | 只有卡片上看得见的字段；隐藏字段不显示、不重建、不删除 |
| 保存粒度 | 整页提交 | 每张 provider 卡片独立「应用 / 取消」，区域没有保存按钮 |
| 写入路径 | 宿主通用 settings 写面 | 同样走宿主 settings.mutate，模型目录这一层不做 DEG 语义校验 |
| 角色配置 | — | 由 DEG 自有 settings-commit 端点写入并做语义校验与 revision 冲突检测 |
enableOrchestrator 默认开启：根会话获得上游 orchestrator 的 workflow manager 提示词，负责拆解任务、选择专家、整合结果和验证；子代理不会继承该主代理 section。cordis.patch.yml 中的 enableOrchestrator 改为 false 并重启 DSH；这只关闭主代理提示词，不影响 插件角色工具本身。provider / model，主模型和 UI model override 继续由 DSH Host 管理。面向使用者的逐控件说明与截图见前面的「设置页功能详解」；本节只记录实现细节与边界。
Observer优先 与 任务管理 都会持久化到插件 settings namespace。transport、retryPolicy、compat 等）：卡片只写自己看得见的字段，这些字段既不被显示也不被重建。off / minimal / low / medium / high / xhigh / max 七个复选框，顺序与 DSH 的 pi-ai 档位词表一致，且无论当前目录是否声明支持都始终显示。已有模型按 reasoningEfforts 映射恢复勾选；新模型七档全部不勾选。保存时 off 写空字符串值、其余档位写同名小写字符串，只增删这七个可见键并保留未展示的未知键；七档全不勾选且没有未知键时删除 reasoningEfforts 字段。unset），绝不把默认值固化成冗余覆盖。dsh-expert-group.defaults.<role>.reasoningEffort 仍是角色单选。若一次保存会删除/取消某个正被角色默认使用的档位，保存被阻止并列出受影响角色，插件不会自动改写角色配置。client-model-config.js（装配期与 freshness 一样先于 descriptor 执行的浏览器安全 IIFE）；scripts/assemble-client.mjs 负责把它拼进发布 bundle，请勿手工编辑 client-bundle.js。provider / model / reasoningEffort 快照仍写入插件自有 dsh_expert_group storage domain 的 child_models 表（上限 300 条自动淘汰最旧记录）；这是运行数据，不是 settings 配置。Observer优先 默认关闭并持久化在该 settings namespace。根会话 Composer 的图片提交先经客户端公开 ConversationController.sendSession 接缝上传到 Host；Host 对全部图片严格校验，使用真实转码器将 JPEG/WebP/GIF 转为 PNG，并通过公开 ctx.attachments.saveImage 创建新的 PNG durable ref。PNG 字节也会先验签再保存，绝不只改文件名后缀。副本保持 durable，随 session/attachment 引用存活，由 Host 的 retention/GC 回收不可达对象；插件不修改原始 durable attachment ref。能力判定优先读取最新的 model/selection 与 request/header 事件证据，模型切换后立即发图不会把旧 header 当作当前模型；旧宿主缺少事件面时才保守回退兼容路径。Expert Group 是 DEG 注册在右侧栏的任务视图：它把当前会话所属根会话的任务树完整画出来——主代理是根节点，普通专家、fan-out 分片与实时运行状态都在它下面。它是只读视图，唯一会写状态的操作是 fan-out 的取消与重试。
注册方式取决于宿主：未安装 dsh-better-sidebar 时注册 DSH 原生右栏页面，并为每个根会话首次自动打开；安装后只向 ctx.betterSidebar 注册一个独立的 expert-group 页面。用户在 better-sidebar 里禁用该页后，DEG 既不自动打开，也不会回退注册第二种页面。
| 节点 | 第一行标题 | 什么时候出现 |
|---|---|---|
| 主代理（根节点） | 固定中文 主代理 | 恒有；不显示 root 的 taskName / session id |
| 普通专家 | 最新一次派发的短描述 | 每次专家委派生成一个节点 |
| fan-out 聚合分支 | <角色> · <N> shards · running｜ready | 一次 fan-out 提交生成一个父节点，分片是它的子节点 |
| 空闲子代理分组 | 空闲子代理（N） | 存在空闲（ready）的普通专家时出现，可折叠 |
除 fan-out 分片外，每个代理节点固定三行，行内容与折叠状态无关：
主代理；专家节点是最新派发描述；fan-out 分片行是 分片代号 任务名称（分片行按内容换行，不做单行省略）。完整文本同时是悬浮提示与无障碍标签。角色 · provider · model · 思考深度（本文档截图中的 provider 与模型名已遮蔽）。缺失时使用稳定占位 未知供应商 / 未知模型 / 默认。标题 · 可继续｜一次性 · 正在运行｜当前未运行，例如 修复 DSH 运行状态文字 Animations · 正在运行、你是 oracle 子代理。任务内容 · 可继续 · 当前未运行。根节点只保留动态标题与活动状态，不显示续接模式。可继续；未知一律按不可续接降级，绝不把未知说成可继续。primitives.StateDot（running / ready）；官方组件缺失时退化为静态圆点。aria-expanded，标题为 折叠 / 展开），不导航。>> / <<：只影响右侧栏，见下一节。取消父任务（未完成 N 个分片）；分片行在活动态提供 取消分片、在可重试态提供 重试分片。破坏性操作先弹宿主确认（例如 确认取消父任务？未完成 N 个分片。）；插件拿不到确认能力时整条操作不执行，绝不静默执行。sessionStorage，后续状态变化不会覆盖用户选择。Expert Group；快照读取失败时标题栏显示 快照读取失败 与 重试 按钮；首屏无缓存时显示骨架，空树显示 暂无 Expert Group 任务。<角色> · <N> shards · running｜ready，圆点按整棵 fan-out 的规范运行状态取色。分片代号 任务名称，下面同样跟随模型元数据与状态摘要。aria-busy，重复点击不会发出第二次请求。运行中的专家留在主列表，空闲（ready）的普通专家会被收进可折叠分组 空闲子代理（N），避免长任务树被历史节点淹没。分组头是容器而不是代理，它的圆点恒为 ready；组内成员各自按自己的实际状态取色。
>> 与 <<：在右栏打开 / 关闭子代理会话每个任务名后面有一个 30×20px 的箭头按钮，同一枚按钮有两种形态：
| 形态 | 含义 | 颜色 | 无障碍 |
|---|---|---|---|
>> | 在右侧栏打开这一行的子代理会话 | 琥珀（state-warning-primary，缺 token 时 #f59e0b） | title / aria-label 为 在侧边栏打开 <任务名>；具备 toggle 能力时 aria-pressed=false、data-open=false |
<< | 关闭这一行已在右栏打开的会话 | 青色（state-business-primary，缺 token 时 #22d3ee） | aria-label 为 在侧边栏关闭 <任务名>；aria-pressed=true、data-open=true |
>>（打开）
sidebarRight.openResource、这一行的地址能解析成子代理会话地址、具名箭头图标可用。任一条不满足就不渲染按钮——空按钮或拿警告图标冒充箭头都算误导。preventDefault + stopPropagation 同时拦下鼠标冒泡与键盘 Enter / Space，所以点箭头不会顺带导航到该子代理会话。split()，用返回的 paneId 显式定位资源；旧宿主没有 split() 时才退回 preferNewPane: true。已有子代理 pane 时显式传 paneId 并关闭 preferNewPane，避免多个子代理错误地与 Expert Group 共用左侧 pane。<<（关闭）
close 可用 + active() 或公开 openTabs inventory 能提供打开证据 + 具名左箭头图标可用」三件能力齐备，并且已经用证据记录过这一行的精确 tabId 时才变成 <<；缺任何一件都退回静态 >>，绝不显示一个点了不会关的假 toggle。openTabs 做最佳努力观察：只有连续两次确认目标消失，才把箭头复位成 >>。面板切换、焦点变化、DOM 读不到等不确定态既不会被猜成「已关闭」，也不会被猜成「仍打开」。右栏宽度
provider/modelrouteClaimrandomUUIDsession.promptimage-route-validateroute-changedroute-claim-invalidsession.promptsessionIdwritten:false），Host 都会立即删除该 claim（连同暂存的 durable refs），因此不会留下客户端永远无法消费的 pending claim。target=observer 时 image-route 只完成 PNG 规范化、能力判定与 claim 签发，并把 Host 创建的 durable PNG refs 暂存在 claim 条目里（只存 ref、不存字节、不存用户文本），绝不启动 child。客户端随后执行 image-route-validate（对 observer claim 只验证不消费，可安全重复复核）→ image-route-observer-commit（Host 复核当前路由 → Observer admission → 一次性消费 claim 并丢弃暂存 refs）。commit 失败（路由变化/claim 失效/重复提交/取消/跨代际）一律不启动 child；若 admission 已被接受而后续检测失败，Host 会用公开 subagents.interrupt(childId, { kind: "ancestor", agent }) 尽力中断该 child。claim 条目带 issued/committing 状态：并发或重复 commit 返回 409 route-commit-in-progress（成功后变为 route-claim-invalid），进入 commit 前取消请求会顺带删除 claim，claim 表始终有界。cleanupToken（randomUUID，绑定 {sessionId, exact root generation, childId}，不含 provider/model/text；独立表同样容量上限 64 + 5 分钟 TTL + 卸载清理，且只淘汰过期项）。客户端在提交 root prompt 之后按结果二选一：失败/取消路径（prompt 非成功返回、抛错、被取消、retirement 非 observed、插件在等待期间被卸载）尽力调用 image-route-observer-cancel 让 Host 中断刚创建的 child；成功 observed 路径调用 image-route-observer-release 只释放凭据、绝不 interrupt，否则 token 会一直占到 TTL，连续成功提交填满容量后新的 Observer commit 会被 503 拒绝。两个动作都是严格 action/sessionId/childId/cleanupToken（Connection/legacy 都要求图片专用标记），不复用调用方可能已取消的信号，失败只尽力而为且不改变原始 prompt 结果；token 在全部校验通过后立即消费（不可重放），伪造/跨会话/串 child/重复消费统一返回 404 route-cleanup-invalid（不泄露是哪一项校验失败）。已签发 + 已预占 < 上限，检查与自增之间无 await，因此并发 commit 不可能超发）；容量已满时拒绝本次 commit 并返回 503 observer-cleanup-capacity、删除 routeClaim、不创建 child —— 绝不为新 child 淘汰仍可能活跃的旧 token（那会让旧 child 失去客户端补偿通道而孤儿化）。admission 或后置检查失败会释放预占，签发成功则把预占转成 token。所有 image-route 成功响应都做交付判定（传输层报告 written:false 的 socket 竞态不算交付）：commit 响应未交付时立即撤销刚签发的 token 并 interrupt 该 child；image-route-validate 未交付时删除仍处于"只验证不消费"的 observer claim（连同暂存 durable refs），使客户端既无法继续 commit 也不占用容量（main 的 validate 成功即消费语义不变）。routeClaim 的旧 Host 上保持既有提交行为（不发校验请求、不静默假设校验通过）；target=observer 的响应没有 routeClaim 时客户端必须 fail-closed（abandon、不调用 session.prompt，提示"Host 不支持安全的 Observer 图片提交，请升级插件/Host"），因为旧 Host 会在 image-route 阶段就启动 child，无法保证"能力判定模型 == 实际 prompt 模型"，也无法在提交失败时避免孤儿 child。image/png durable attachment ContentBlock；Observer admission 固定为有界的纯视觉子任务（正文由 prompt-contracts.js 的固定契约与"无用户文字上下文"说明组成），禁止读取主任务上下文、执行主任务步骤、修改文件或调用委派/goal/finalize 工具。自动图片入口不向 Observer 传递任何用户原始文本（含路径、秘密与注入载荷；buildObserverVisualTask() 不接受参数）；主代理仍通过 root prompt 持有原始 text，客户端提交文字通知说明视觉报告会经既有 child feedback 返回、原始任务仍由主代理持有。需要携带用户问题的视觉任务只能走 role tool 的手工调用路径。主模型直达时，Host 返回的也必须是实际 PNG encoded image。llm.resolveModelInfo 等异步边界抛出的 AbortError/ABORT_ERR（或请求 signal 已取消）一律不被能力兜底吞掉，图片路由的 normalize 后、能力查询前后、claim 校验/commit 前后与 Observer admission 前后都做 fail-fast，由同一个 mapRpcError 映射为 gateway/cancelled（499）；只有真正的非取消失败才按 unknown → main-first 继续。取消的 commit 不会 admission，也不会留下 pending claim；已 admission 但随后取消时会尽力中断 child。ConversationController.sendSession 接缝覆盖 Composer 根会话图片提交，并在 Session.beginSubmission/prompt 上保留原生回显、模式、requestId、退休和失败收尾语义；它不能拦截其他调用方绕过 Composer 直接调用的原生 Session.prompt。因此该边界不是对 DSH 核心的修改或承诺全局拦截；image-routing.js 和 Observer role tool 仍提供可独立测试的 PNG 规范化与三态路由。unknown 能力始终保持 main-first，不静默切换。