这是供任意本机应用接入的 Agent 会话协议。Cindy 管理供应商、凭据、模型路由和 Claude Code / Codex / Pi 执行；客户端管理自己的界面、记录、上下文、工具实现及业务权限，用户也可按应用开启 Cindy 内的可见任务记录。HHH 是首个客户端，不是协议的应用类型或授权白名单。
实现入口：main/local-agent/。协议扩展保持 v1，旧客户端可忽略新增能力字段；不要把兼容的本机 API 当成 OpenAI 或 Anthropic 模型 API，也不提供跨机访问。
维护者于 2026-10-22 明确裁决：保留 Cindy 身份、现有提示词与装配语义。应用接入的是 Cindy；通用化针对 API、授权和应用隔离。调用方应按公开事件消费 Cindy 现有风格的文本与输出格式，不以移除身份、产品指引或回答呈现规则为集成前提。客户端的 instructions 仍通过既有调用方指令位置追加，不替换 Cindy 提示词。
scripts/examples/local-agent-client.mjs 只使用 Node 22+ 标准库、发现文件和 HTTP，没有 Cindy / HHH 源码依赖。先启动本任务或已包含该 API 的 Cindy，再指定目标 profile 的发现文件：
node scripts/examples/local-agent-client.mjs --discovery "<profile>/local-agent/discovery.json" --list-models
node scripts/examples/local-agent-client.mjs --discovery "<profile>/local-agent/discovery.json" --provider "<provider-id>" --engine pi --model "<opaque-model-id>" --cwd "<absolute-folder>"每次在 Cindy 的主题确认弹窗允许该应用。第二条命令运行一个只做文本回显的 client_echo 工具，再接收模型回答。可用 --client-id org.example.notes --client-name Notes 和另一组身份同时启动两份示例；两者可使用相同会话编号。--prompt 自定输入，--native-tools 显式启用原生执行。模型调用会消费所选供应商额度。
示例令牌只在进程内存中，退出时关闭自己的会话并撤销自己的授权，不打印、保存或复用令牌。需要长期连接的产品自行通过 OS 凭据库保存此应用令牌；不得复制供应商登录。命令行参数不接收秘密。--list-models 不调用模型生成。
开发构建在 设置 → 远程连接 → 本机应用连接 → 开发连接 提供“复制连接码”。正式构建隐藏这一行。Main 只从本进程当前持有租约、owner 仍有效的 ready server 内存生成码，不读取其他实例的发现文件；启动中、未登录/未进入本地模式、HOST_IN_USE、启动失败或已停止均不能复制。复制时重新查询当前状态。
规范文本为 cindy-local:v1:<port>:<instance>：ASCII、总长60–64字符，port 为无前导零的十进制整数1..65535，instance 为已有API nonce（32字节随机值的43位无padding base64url）。原始输入最多256字符，只允许trim首尾空白，之后严格匹配上述格式；不接受内部空白、URL、host、path、query或额外字段。v1 对应RPC protocol=1；其他版本返回 CONNECTION_CODE_UNSUPPORTED，非法输入返回 CONNECTION_CODE_INVALID。
连接码是本机端点定位信息，不是grant/token，不包含账号、凭据、profile、源码目录、PID或稳定实例账本。没有短码服务、持久映射、公共实例目录、进程/端口扫描、TTL心跳或实例间通信。原API自己的 per-profile discovery、host.lock、owner-scoped grants和恢复记录继续保留；不是“整个API零文件”。
node scripts/examples/local-agent-client.mjs --connection-code "cindy-local:v1:<port>:<instance>" --list-models独立Node示例保留 --discovery 旧入口，两个入口必须二选一。接码后只向 http://127.0.0.1:<port>/rpc 发无Bearer的 capabilities，携带码中nonce，拒绝重定向；握手超时750ms、响应上限32KiB。先核对protocol和instance，再核对 features.instanceMetadata:true 和 instanceInfo:{kind,region}；开发入口必须为 kind:"development"，region只能是global/cn/dev。缺元数据报 INSTANCE_METADATA_UNSUPPORTED，类型不符报 INSTANCE_METADATA_MISMATCH，端点代次不符报 INSTANCE_CHANGED，网络/超时/非法JSON不能验证时为 CONNECTION_UNAVAILABLE。只有握手通过后才按原 connect/start / Cindy 确认 / connect/poll 申请授权；拒绝、取消和超时保持原协议，不自动批准。
instanceInfo 是可选的两字段构建自述，版本继续使用capabilities顶层 version。只有实际packaged、非已验证个人构建且region非dev才是installed；unpackaged、CindyDev或个人构建均为development，不能按版本号或profile路径猜。region来自既有构建区域，默认global规则不变。元数据用于避免错连，不是对同OS用户恶意程序的发行认证。
日常正式连接继续读取调用方原先绑定的正式profile的 local-agent/discovery.json，然后无token核对nonce、kind:"installed"及预期region。共profile的开发实例若持有原host.lock，正式API仍会 HOST_IN_USE，该路径的discovery可能指向development；必须明确拒绝把它当正式版，不能自动改接另一实例。不同profile仍可独立连接；不新增锁接管、路由或实例协调。
旧v1端点缺身份元数据时，显式旧 --discovery 接入仍兼容、grants无需重建；但无法证明其正式身份，新的正式自动连接应显示legacy/unknown并提示经官方更新入口升级，不把缺字段默认当installed。没有本机API的旧安装版不可连接，不侧载或替换安装版。
每个客户端对象固定端点、nonce及自己的授权，能力查询永不带Bearer。重启/owner或API换代后码失效，重新从目标Cindy复制并握手；旧执行不迁移，消息、工具副作用和控制请求不自动重放。调用方负责临时开发覆盖及恢复正式配置，不转用其他目标token。此码仅用于同一电脑上的应用，不扩展SSH/device-link/Mobile协议。
目标 profile 根目录的 local-agent/discovery.json：
{"protocol":1,"port":12345,"instance":"<opaque-instance>"}端口随机分配，只监听 127.0.0.1。发现文件不含令牌。正式 profile 与开发沙箱完全独立；示例不扫描或默认借用其他 profile。Windows 正式目录为 %APPDATA%/CindyGlobal 或中国大陆版 %APPDATA%/Cindy，macOS 在 ~/Library/Application Support/，Linux 在 $XDG_CONFIG_HOME（缺省 ~/.config）；沙箱位置以启动器输出为准。
POST http://127.0.0.1:<port>/rpc，Content-Type: application/json：
{"version":1,"instance":"<opaque-instance>","id":"550e8400-e29b-41d4-a716-446655440000:1","method":"capabilities","params":{}}成功为 {"result":...}，失败为 {"error":{"code":"...","message":"..."}}；错误的 code 用于程序判断，message 用于展示。RPC 不使用 JSON-RPC 的 jsonrpc 字段。Host 必须为发现的 loopback 地址，任何带 Origin 的请求都拒绝；这是供本机进程使用的接口，不开放浏览器 CORS。
capabilities 无需授权，返回 protocol、Cindy version、instance、可用 methods 和 features。当前通用扩展声明 clientIdentity、isolatedSessions、individualRevocation、toolPolicy 为 true，nativeReadOnly 为 false。未声明的能力不得假定支持。instance 保持可选以兼容早期 v1 客户端，新客户端应始终携带；实例改变后重新发现，不自动重放旧操作。
有副作用的请求编号必须是 <process-nonce>:<counter>，nonce 为 8–64 位 [A-Za-z0-9_-]，counter 从 1 单调递增、最多 15 位。去重按授权 + 完整请求编号计算，同编号不同 payload 拒绝；每个进程保留最近 256 个编号的窗口，已过期请求拒绝执行，不重新提交。重启后用新 nonce，不依赖旧实例的去重记录。每个授权最多同时保留 32 个进程 nonce（全部授权合计 128 个）；名额用满时，空闲超过 10 分钟的 nonce 会被回收，之后再用该 nonce 的请求返回 REQUEST_EXPIRED 且不执行，仍无可回收名额时返回 CLIENT_LIMIT。网络超时表示结果可能未知；任何消息、工具副作用或控制请求都不能用新编号自动重试。
-
connect/start：{"client":{"id":"org.example.notes","name":"Notes","version":"1.0"}}，返回{id,claim,url}。id 最多 128 字符，只含字母、数字、点、下划线、连字符且以字母或数字开头；名称最多 80 字符，version 可省略、最多 64 字符。名称/版本不接受控制或双向覆盖字符。 -
Cindy 在本机显示应用自报名称、编号及能力说明，由用户允许或取消。客户端无需打开返回的兼容网页才能触发弹窗。允许连接和撤销连接复用 Cindy 的主题确认组件及确认队列，默认焦点在取消，支持 Esc、Tab 焦点约束；不会弹出操作系统消息框。
-
connect/poll：{id,claim}，返回{state:"waiting"|"denied"|"approved",token?}；通过后才有 token。申请两分钟过期。connect/cancel用同一组 id/claim 取消并撤销该申请已经签发的授权。 确认请求由 Main 生成不可复用的编号，只投递到当前可信主窗口；回包必须来自同一窗口的顶层 Cindy 页面。窗口关闭、崩溃、导航（含页内导航）、账号换代、宿主关闭、请求取消或超时都会取消待确认项，迟到回包不能批准。Renderer 只提供用户选择，Main 在执行前再次核对 owner generation 与请求归属；HTTP 客户端不能提交确认回包。并发请求沿用 Cindy 的确认队列，各自独立结算。 -
后续请求带
Authorization: Bearer <token>。connect/revoke无参数，只撤销当前令牌自己的授权。
应用名称、id、version 都是申请方自报的展示资料，不能证明安装包或发布者身份。相同 app id / 名称不会得到已有授权或会话；每次经用户允许产生独立、不可猜测的 bearer 凭据。名字不是认证依据，不按品牌自动批准。
设置 → 远程连接 → 本机应用连接逐条显示应用和自报编号，每条可单独撤销。撤销同时失效令牌、恢复绑定、工具桥接与事件轮询，并关闭该授权的执行会话；其他授权保持可用。旧设置调用不带编号的“全部撤销”仍兼容。账号切换和退出会关闭本机 API；数据仍按 Cindy 的账号 owner 隔离。
每个已连接应用有独立的「在 Cindy 中创建可见任务」开关，默认关闭；未设置的旧授权同样保持关闭。只有 Cindy 本机的受信设置界面能更改此偏好，应用不能通过 RPC 开启。该偏好仅影响之后的 session/open，不改变已打开的执行会话；关闭或撤销授权不会删除已有任务和消息。
开启后，每次 session/open 都创建新的普通可见任务，并沿用现有任务的消息持久化、实时事件与列表刷新。返回值可选追加 cindySessionId，是可用于 cindy://session/<id> 的任务编号，区别于应用自定的 sessionId 和不透明恢复句柄 id。传入 resume 仍按旧协议恢复本授权自己的原生执行，但不会查找、续接或改写之前的 Cindy 任务；之前的可见记录保留。应用不能指定 Cindy 任务编号，也不会取得由用户接管的运行时。
原问题、回复和工具活动保存在当前账号的任务历史中；图片先进入媒体总仓，临时输入回收后仍可查看。应用消息复用发送方元数据 sourcePlugin 的保留前缀 local-app:<client-id>，桌面、手机和交接文本均显示实际的本机应用来源，不提供插件详情跳转。来源名称仍是应用自报资料，不是认证依据。来源说明只追加到当次模型输入，不混入保存的正文，不增加 system 提示词。
可见任务仍沿用该应用原有的工具策略、授权隔离和独立原生历史，不装载私人记忆，也不使应用取得其他任务的访问权。仅查看任务不接管；用户在 Cindy 中发送、插话或修改运行设置前，宿主先拒绝该外部执行的新输入，关闭旧执行并完成持久上下文交接，再以普通 Cindy 任务继续。交接失败时阻止此次操作并保留重试，不回退到外部实例。外部执行正常关闭同样完成交接；应用的恢复句柄只保留接管前的原生历史，无法观察、控制或恢复接管后的 Cindy 运行时。此设置不提供未安装唤起、安装后重试或未登录期间的入站队列。
| method | params | result / 语义 |
|---|---|---|
models |
{} |
{models:[{id,label,provider,providerLabel?,engine,model,efforts,defaultEffort?,images,isDefault}]} |
session/open |
{sessionId,cwd,model,toolPolicy,tools,effort?,instructions?,resume?} |
{sessionId,id,resumed}；id 是供恢复使用的不透明句柄，不是原生线程 ID |
send |
{sessionId,parts,effort?} |
{} 表示接收发送请求，轮次结果随后由 events 返回 |
steer |
{sessionId,parts} |
向正在运行的轮次插话；未运行返回 NOT_RUNNING |
interrupt |
{sessionId} |
请求实际引擎停止；最终状态看 events |
instructions |
{sessionId,instructions} |
更新追加说明，下一轮按原生恢复边界应用 |
events |
{sessionId,cursor} |
{events:[{seq,event}],cursor}；无新事件最多等待 20 秒 |
tool/reply |
{sessionId,callId,text,isError?} |
回传该会话的一次客户端工具结果；重复或过期回传拒绝 |
session/close |
{sessionId} |
关闭当前执行会话并释放等待工具，保留属于此授权的恢复绑定 |
models[].id 唯一标识供应商 + 引擎 + 模型组合，客户端将其视为不透明值。provider 是稳定分组编号，providerLabel 是可选显示名，不从 label 解析路由；同名模型的不同来源不合并。目录来自当前已连接且可选的对话来源，不导出路由地址和凭据。空目录正常返回空数组，不悄悄更换来源。
目录包含本机、允许远程调用的同账号在线电脑，以及当前有效的供应商分享；按来源、供应商、引擎和模型区分身份。远程供应商显示电脑名，分享供应商显示分享者；XD Gateway 的内置显示名称与 Cindy 选择器一致为 Cindy AI。远程目录使用现有授权投影与模型可见性，单个不可达来源不阻塞其他来源；账号切换后丢弃迟到结果。来源 ID 和路由只保留在 Main，不进入公共模型 JSON。
选中远程来源后，Agent 通过既有 device-link 在该来源运行，客户端工具仍回到调用应用；不要求本机装有对应引擎，不回落到本机同名供应商。远端（包括供应商组的实际执行端）须声明 localApplication: true，否则返回 REMOTE_AGENT_PEER_TOO_OLD 并提示更新。旧端仍可能出现在目录中，其在线和已授权不代表支持外部应用执行。client-only 不收集本机项目/个人配置，反向入口拒绝文件与命令执行；Codex 原生存储按控制端、分享中转身份和应用授权分目录。Pi、Claude 沿用各自原生适配器的记录目录，应用间的恢复授权由 API 的 owner/grant 绑定约束，不承诺所有引擎都有应用级物理目录。分享凭据访问仍需主人确认，当前 API 无交互回执时明确拒绝。
本机供应商有组时，首次打开复用本机组路由器及 localTask 分配规则；同账号远程来源有组时复用 provider-group:remote 选机。两者都直连选中的组员（可为本机或分享来源），携带既有 groupAssigned 标记防止再次分组；组不可用或查询失败不直接落到组所在电脑。实际路由随原生线程封装在既有 owner/grant 恢复绑定中，修改指令及重新打开都回原组员，不重新选机；旧的裸线程绑定仍回原来源。启动失败向调用方报告，本 API 暂不自动重选成员：启动超时不代表远端没有创建执行，换机需要确认前一次清理并区分原生恢复，不能直接重放 open。该封装仅在 Main 存储，应用仍只收到不透明恢复句柄。目录与 Cindy 选择器共用组成员收起规则；组来源不可用时，其他可用成员恢复单独显示。实现见 local-agent/groupRoute.ts，回归见 runtime.integration.test.ts 与 remote-agent/__tests__/roundtrip.test.ts。
应用会话的运行负载纳入既有供应商组统计：本机执行（包括组选回调用端本机）计入本机目录的 runningTurns；经远程组分配的会话保留组所在电脑和成员键，与普通任务合并为同一份 lease 快照，沿用 60 秒心跳和结束释放。注册表按账号隔离，账号切换后旧回调不进入新账号报告，恢复绑定保留原组归属。实现见 local-agent/load.ts，回归见 local-agent/__tests__/load.test.ts 与 provider-group/__tests__/runtime.test.ts。
sessionId 是客户端自定的非空字符串，最多 128 字符；编号按授权隔离。cwd 为当前电脑上的现存绝对目录。tools 为至多 256 个 {name,description,parameters}，parameters 为 JSON Schema 对象；name 最多 64 字符，只含 [A-Za-z0-9_-] 且会话内唯一。新协议使用 toolPolicy：
client-only：仅调用该会话登记的客户端工具。它不代表工具本身只读，客户端仍负责业务确认和工具权限。native：同时保留所选引擎的原生执行能力，能按当前系统用户权限读写文件、执行命令；cwd 不是操作系统沙箱。
旧 v1 的 access:"none"|"full" 分别映射上述两种模式，仍可使用；同时传两者时必须一致。原生只读尚未声明，不能用提示词或 client-only 推断存在只读文件沙箱。
parts 是 1–64 个 {type:"text",text} 或 {type:"image",mimeType,data}；图片 data 是 base64，只接受模型声明支持的 PNG/JPEG/WebP/GIF，单张解码最多 10 MiB。client-only 将以 / 开头的文本转义为字面消息，路径等普通内容仍可发送，不执行原生命令；native 保留既有引擎命令行为。模型、来源或引擎切换必须重新 open；相同模型可用原句柄恢复，不同模型返回新句柄和 resumed:false，客户端自行提供上下文交接，不重放旧工具或付费消息。
本机组只收起已由本机目录实际提供的同引擎、同模型成员选项。本机连接不可用、引擎未安装或模型不可选时，对应远程／分享成员仍单独显示，避免仅有组配置却没有可选组入口时把可用来源全部隐藏。
每个会话只安排一个有序事件消费者，初始 cursor 为 0，下一次请求使用已完整处理批次的返回 cursor。发送该 cursor 同时确认其之前事件可回收。事件有严格递增 seq；失去响应时可用最后已处理的 cursor 重新读取，不随意推进。不要并行提交相互矛盾的确认游标。
| event.type | event.data |
|---|---|
text / thinking |
增量字符串，不重复发最终全文快照 |
host_tool |
{id,name,arguments}；id 是 callId，客户端执行自己的注册工具后回传 |
tool_started |
{id,name,arguments}；引擎自带活动的投影，不要求客户端再执行 |
tool_finished |
{id,output,isError} |
usage |
{input,cached,output}；input 包括缓存读取和写入，按引擎的当轮用量或请求增量投影，不由客户端猜计费金额 |
turn_end |
`{status:"completed" |
每个运行会话都有服务端生成的内部 MCP URL 和独立令牌，不由客户端提交，不会通过公共 RPC 返回。三个引擎使用通用 client 命名空间，桥接只列出该会话登记的工具；host_tool 已代表该调用，不再从原生活动重复执行。其他授权的 MCP token、工具 callId、恢复句柄或 sessionId 都不能取得此会话的调用权。
当前协议不转发原生人机确认：原生提问/计划批准会产生明确失败，不能替用户答应；需要交互的客户端应提供自己的交互工具。
远程执行不要求本机安装引擎的规则也适用于应用的可见任务：Maker.createSession 保留持久化、发送和关闭生命周期，缺少本机引擎时从远程句柄提供应用所需能力；本机执行仍须有本机引擎。回归见 packages/maker-core/src/maker.test.ts。
默认使用 Maker.startLocalAgentSession 复用三种引擎及既有内存 Session，由同一套发送、原生续段、终态归属、工具循环与关闭生命周期管理执行；不建立第二个 Agent 循环，也不写入 Cindy 的私人任务数据库或装载私人记忆。用户为应用开启可见任务后，改走既有 Maker.createSession 和 Desktop 消息记录管线，工具策略仍由原本机能力约束。原生带 continuation claim 的 done 只是 SDK 段落边界，不能提前宣布客户端执行完成或接受下一轮发送。原生 cancelled 投影为 interrupted。
Claude client-only 关闭原生 tools/settings/skills；Pi 仅开启客户端网关；Codex 使用独立模型工具目录、app-server 与原生历史配置，保留所选模型的窗口配置。client-only 不合入 Cindy 的其他 MCP。Cindy 固定身份、回答呈现、host system prompt 及既有动态段装配保持原样；插件花名册仍由原回调按工作目录、启用状态和账号可见性产生，通讯录说明沿用各引擎现有可用性判断。花名册与提示词不是工具授权；连接未注册的私人 MCP 仍不可调用，也不因此取得私人任务、记忆或供应商凭据。静态指引可能提及本连接未开放的能力，调用方须按本连接实际登记的工具与公开事件处理，不能仅凭文字假定能力已获授权。Codex native 排除自动继承的私有 MCP 连接与 Apps 账号连接（包括原生插件自带的 MCP 服务，它们可能携带账号凭据），同时保留工作目录的原生技能、原生插件与执行能力，不复用 Review 的全量技能禁用策略。native 模式仍可读取工作目录和引擎原生配置；其文件访问受本机系统用户权限支配，API 隔离不是对同一系统用户下恶意程序的 OS 沙箱。
关闭、撤销授权及晚到的启动结果以 account-boundary 原因关闭内存 Session，连同其持有的原生子执行收尾。无法确认进程退出时返回 RUNTIME_CLOSE_UNCONFIRMED，保留清理对象供宿主关闭重试；令牌及工具入口仍立即失效，不将不确定的停止报告为已经结束。
持久授权存放在 owner-scoped local-agent/grants.json：只含令牌 SHA-256、账号范围、服务端授权 id、自报身份及归属此授权的恢复绑定。它不存令牌明文、供应商凭据或消息正文。写入及异常恢复复用 Main 的 atomicWriteFileSync / readAtomicFileSync，不另造 Windows 替换协议。profile 根 local-agent/host.lock 复用既有跨进程锁：同一 profile 只有一个发现端点和授权快照写入者，共库预览实例不能覆盖撤销结果；Maker 替换等待旧端点释放。账号持久范围与运行期的 owner generation 分开，切走再切回同一账号也不会复活旧的在途确认。
新授权的临时输入和 Codex 运行历史配置位于 local-agent/clients/<grant-hash>/；Codex 的可重建模型工具目录仍在 local-agent/codex-catalogs/。其他引擎的原生转录由其原有适配器管理，API 只保存自己签发的恢复绑定，不暴露跨应用列举接口。
授权文件由 schema 1 升到 2：校验旧文件后保留令牌哈希、授权 id、账号和绑定；首次写入前以独占创建保留 grants.json.v1.bak，新格式经临时文件原子替换。存量 v1 授权保留历史 hhh MCP 名称和旧原生存储定位，仅用于已存授权的恢复兼容；所有新连接都使用通用 namespace。旧字符串形式的 client 也保持支持，并按通用名称生成自报身份，不再限制品牌。
不认识的版本或损坏文件拒绝加载并保留原文件，不清空重建。schema 1 的旧二进制不能读 schema 2；降级不能直接覆盖现有文件，应使用独立 profile。旧版备份只反映升级时状态，不包含之后新增/撤销的授权；不要将它当成无损降级或在撤销后自动恢复备份。
会话上限 16，授权上限 32，申请上限 8；这些是当前实例的资源预算，不是按品牌分配。请求最大 16 MiB，单会话事件队列最大 8 MiB，事件每批通常不超过 1 MiB（单个大事件可独占一批），空闲会话三分钟回收，单会话最多 64 个待回传工具。超限会返回明确错误或收尾该会话，不转发到另一个供应商。协议不自动重试模型和工具操作。
常见可判断错误：UNAUTHORIZED（重新授权）、INSTANCE_CHANGED（重新发现）、MODEL_UNAVAILABLE（重新选择有效来源）、RESUME_UNAVAILABLE（新会话并交接上下文）、SESSION_UNAVAILABLE（原会话已关闭或不属于此授权）、UNSUPPORTED_ACCESS（策略不支持/矛盾）、ID_REUSED / REQUEST_EXPIRED（未重复执行）、CLIENT_LIMIT（同时运行的客户端进程过多，稍后重试）、GRANT_STORE_INVALID（保留原文件并检查版本/存储）。
错误 code 保持稳定，展示文案、Cindy 确认及兼容结果页通过 Cindy 当前语言的五语资源提供。设置 IPC 复用受信顶层窗口校验与统一 IPC 错误协议；等待 Cindy 确认后再次校验发起窗口及 owner generation，不向 Renderer 返回原始存储异常。
此入口只管理当前电脑的本机应用，不执行 SSH 工作区任务，不加入 device-link 的通用 invoke/push 白名单，也未新增 Mobile 入口。远程管理此类授权需要另行定义目标电脑的 Cindy 确认和授权范围，不能把本机 handler 隐式开放给远端。
-
apps/desktop/src/main/local-agent/__tests__/server.integration.test.ts：真实 loopback、独立示例进程、同编号并行、越权拒绝、单项撤销、重启恢复及旧存储迁移；模型执行可注入，不能把它说成真实供应商验收。 -
runtime.test.ts：目录和事件不重复投影，通用及历史 namespace。 -
maker-core对应适配器：Claude SDK 隔离选项；Pi 真二进制 + 本机模型响应夹具；Codex 真 app-server（需CINDY_CODEX_TEST_BINARY）。 -
apps/desktop/scripts/fixtures/local-agent/：真实设置组件，多应用单项撤销、取消、失败、手机宽度、五种语言与深浅主题；宿主接口由场景提供，不替代真实授权与 IPC 验收。 -
service.test.ts：真实 service/确认桥接/可信 IPC handler 联动，批准、取消、abort、超时、导航/关闭、账号换代、伪造回包和并发撤销隔离。 -
apps/desktop/scripts/fixtures/local-agent-confirmation/：生产确认 Host 与共用 ConfirmDialog，五语言、双主题、320px、默认取消焦点、Tab/Esc、队列取消；主进程与实际授权另由隔离 Desktop 验证。