客户端适配与历史草案

官方 daemon-client-adapters 目录同时保留早期 draft 与当前 Web Shell 说明。开发适配器时应先确认当前实现，再参考草案的目标，不能把 Proposed Entry Point 当作已发布命令。

各路径现状

路径	当前文档明确的边界
native TUI	仍有直接运行路径；CLI 中保留旧 DaemonTuiAdapter 实验代码
共享 transcript	位于 TypeScript SDK，可由多种宿主复用，Web Shell 已使用
IDE daemon transport	提供独立 sibling adapter；旧 ACP stdio 仍是主要路径
渠道与 Web BFF 草案	描述后端持有会话、凭据与游标的适配方式；不能仅凭草案保证命令已接线

旧 TUI 草案提出 experimental 标志和环境变量，IDE 草案提出一组设置名，渠道草案提出 channel/web-backend 入口。本页不把这些拟议字符串列为可执行安装步骤；实际 API 见IDE adapter和Web Shell 嵌入。

适配器需要保存什么

传输端负责 daemon URL、token、工作区、sessionId 和 SSE 游标。界面端消费经过规范化的事件，再将 prompt、cancel、model 和审批操作交给 session client。

渠道还要将平台发送者与 thread 绑定到明确会话。旧草案因为当时仅有 single scope，要求独立 daemon 或单用户演示；当前DaemonClient已有按 capability 判断的 thread 创建路径，不能继续把早期限制描述为全部现行能力，也不能在缺少能力时由客户端悄悄模拟隔离。

事件与界面行为

文本、思考、工具更新、审批请求、模型变化和会话断开应有对应状态；未知事件要安全降级或记录诊断。某种 transport 尚未提供的编辑器回调和界面能力，应显式显示为不支持，不伪装成功。

新的 renderer 优先复用共享 UI及迁移测试。旧 TUI reducer 的局部 update union 不应作为新跨客户端协议。

本地性要可见

daemon 的 workspace、MCP、Skills 和模型凭据来自 daemon 主机及进程环境。用户打开本地浏览器或 IDE，不会自动把本机浏览器 profile、localhost 服务或 SSH/kube 凭据转交给远端。

Web BFF 和 IDE extension host 应持有自己的连接秘密，再向前端发送必要的应用事件。当前同源 Web Shell 可以直接连接；早期草案的全面禁止浏览器直连表述，不能覆盖后来明确支持的同源部署。