ds-harness-remote-fast/AGENTS.md

108 KiB
Raw Blame History

Repository Guide for Agents

Android coherent transitions (Issue #8, 2026-11-12)

Android 把“状态突变”改为同一界面的连续过渡,未改路由架构、协议、Host 或持久化。 新增 apps/android/src/ui/motion.ts:动效令牌(全屏 480ms、Sheet 380/260ms、指示器 420ms、 微位移 160ms、stagger 25ms、cubic-bezier(.32,.72,0,1))、resolveMotion 的 reduced-motion 降级(≤150ms、位移/缩放归零)、Sheet 相位机 nextSheetPhase、锚点/共享矩形/分段指示器几何。 ui/use-reduce-motion.ts 抽出原先在 connection-hero 与聊天回复点中各自复制的系统设置订阅。

新增 ui/sheet.tsx 的 SheetModal:animationType="none"、遮罩淡入、面板只做 translateY (保持不透明),关闭时先播完退出动画再卸载,退出期间沿用最后一次 children 快照。 chat/pickers.tsx、chat/session-info.tsx、chat/action-menu.tsx、workspace-modals.tsx、 host-switcher-sheet.tsx、设置页语言/字号/活动坞选择器改用该组件;“+”菜单按 composer 的 measureInWindow 锚点决定升起方向。chat/modal.tsx 的 ModalSurface 保持原签名,改为挂载时 播放同一入场曲线(Bot 等仍自带外层 Modal 的调用点沿用原生淡入)。

抽屉新增单一分段指示器(indicatorGeometry + 平移/拉伸,无 elevation 以免盖住标签文字)、 搜索行展开与排序浮窗入场;轨迹视图、全屏输入框、首页菜单与图片灯箱改为短位移+淡入。 未改 browse-memory、手势阈值、workspace-tree 纯函数、composer-gate、i18n 文案与 packages/plugin(dist 未重建)。

验证:新增纯函数回归 tests/motion.test.ts、tests/sheet-transition.test.ts;Android 65 文件 / 605 tests、pnpm --filter @dsh-remote/android check、/opt/dsh-autopilot/run-gate.sh(含全仓 build/check/bundle/664 Plugin tests)退出码 0。未构建 APK,未做真机、TalkBack、大字体、 横竖屏往返与真实跨设备人工验收。

Android offline composer drafts (Issue #7 / upstream #409, 2026-11-12)

Android 聊天输入框不再随连接状态禁用。新增 apps/android/src/screens/chat/composer-gate.ts (composerEditable / submitIntent)把「可编辑」与 connected 解耦:只有权限切换与 上传中才锁定输入。离线时 submit() 在 applyDraft('') 之前返回,草稿留在既有按会话 加密保存的 browse-memory 条目中;发送按钮保持禁用,并在输入框下方显示新增的 chat.offlineSendBlocked(七种语言)。sendMessage 在插入 local: 乐观行之前对非 connected 状态失败关闭并返回 'rejected',避免离线调用留下幽灵行,或让调用方把结果 当成禁止回填草稿的 'kept'。全屏输入框只在会话切换时收起,不再因 carrier 掉线重置。 未改 Host、协议、allowlist、Bot 模式(其草稿仍是组件本地状态、不落盘),未重打 Plugin bundle dist。

验证:Android check(renderer 生成 + 工作区数据面校验 + tsc --noEmit)、62 文件 / 581 tests 与 git diff --check 通过。未构建 APK,未做真机、后台/Doze、TalkBack 或跨设备验收。

Compact history keeps DS-Bot group rounds (Issue #4, 2026-11-11)

remote.history.compact.v1 之前把工具正文统一截成 512 字符,导致 DS-Bot 群聊轮次 {"replies":[...]} 在首条回复跨过截断点时整段消失,客户端 parseBotReplies 的整段解析 与完整条目摘取都返回空,会话只剩「已完成 · N 次工具调用」。

Host 新增 packages/plugin/src/compact-bot-round.ts:识别该形状后只保留 replies 条目的 原语字段、原始顺序,限制每条正文 2048、标识字段 256、条目 32、单条投影 8 KiB,发生裁剪时 追加顶层 truncated: true;无法解析、空数组、非该形状或超出扫描上限继续走 512 字符摘要。 compact-history.ts 另加 128 Ki 字符的文档级预算,并让被两个预览块上限挡住的群聊载荷仍可保留, 保证 session/follow snapshot(Android 不发 transferFrames,4 MiB 帧上限无兜底)不被推高。 输出仍是合法 {"replies":[...]},旧客户端无需改动;日志、原始记录、错误状态与 RPC 边界不变。

Android 侧把回复提取扩展为 parseBotReplyPayload(complete/truncated),parseBotReplies 保留为薄封装;仅当整段解析且未被 Host 裁剪时才把 group_relay 工具行从活动组移除, 否则同时显示已恢复正文与可展开的工具诊断(普通 Harness 会话与 Bot 模式一致)。未新增文案, 未改 locales。

验证:Plugin 新增 compact-bot-round.test.ts 与 compact-history.test.ts 群聊场景(页/snapshot、 失败结果、预览块越界、预算上限、空回复、幂等、__proto__),Android bot-replies.test.ts 覆盖 whole/Host 裁剪/摘取前缀/空回复与跨包一致 fixture;pnpm --filter './packages/**' -r build、 Plugin check/test、Android check、/opt/dsh-autopilot/run-gate.sh 通过,Plugin bundle 已重建。 未新增 iOS/DSH-Go 验证(该客户端不在本仓库),未做真机跨设备回归;运行时原始 group_relay 结果是否为空仍需日志确认,若为空则应转查 DS-Bot 生产端。

Credential refresh lock and migration scope (PR #384, 2026-11-10)

Plugin 使用 V2 Marker 和独立 Holder 文件串行刷新。默认目录迁移与刷新共用目录外闸门。 迁移清理确认死亡的 Holder,接受已识别的队列 .tmp 文件,拒绝活跃 Holder。 Linux 单机本地 ext4 和 XFS 为目标支持范围。WSL2 ext4.vhdx 用于开发测试。 NFS、SMB 共享凭据目录和跨主机锁不在范围内。Windows Host 尚未完成验收。 升级或降级前必须停止所有 Harness 进程。0.6.3 降级步骤见 docs/plugin-integration.md。 本地 ext4 Plugin 全套 594 tests、类型检查、构建和 bundle 校验通过。 CI 在 XFS 挂载上完成硬链接检查、凭据锁测试和迁移测试。

Interrupted trust-file migration recovery (2026-11-09)

迁移归属检查接受 atomic writer 生成的 trusted-peers.json.<pid>.<UUIDv7>.tmp,覆盖旧根目录及 Server Host/Client 目录;仍执行普通文件、链接数、大小与身份/凭据一致性校验。迁移只读保留残留,身份成功加载后清理,不用残留覆盖正式信任记录。未知或格式错误的临时文件仍拒绝迁移。

验证:identity-store 与跨进程锁共 25 tests、生产 bundle 构建与 DSH bundle 校验通过。完整构建的依赖布局差异未纳入提交,发布 bundle 仅同步本次逻辑。Plugin 类型检查受既有 acp/virtual-harness.ts:302 的 Claude backend 类型不匹配阻断。未做 Windows 真机验收。

Oversized session catalogues (2026-11-07)

Remote 的会话目录来自官方 session/list,覆盖整个账号,而客户端在 RemoteSessionTools.catalog() 里用 z.array(rowSchema).max(MAX_REMOTE_SESSIONS) 校验这份共享列表。 实测一台累计 5 431 行、其中 4 701 行是 subagent 会话的 Host 会让每个客户端在校验阶段抛 ZodError, 异常被 Remote tool 包装器吞成 REMOTE_SESSION_FAILED,表现为手机「已连接」但会话列表永远空白, Desktop 面板的 Agent 工具同样失败。

  • Client:先按 workspace 归属与 subagent 过滤,再对结果施加行上限;超限时截断,不再整包失败。
  • Host:session/list 仅在超过 2 048 行预算时降级——只保留可列出的根会话(无 parentSessionId 且 origin !== 'subagent'),仍超预算时按 updatedAt 保留最新 2 048 行;正常规模账号行为不变。
  • 兼容:Harness 0.2.2 的 SessionSummary 去掉了顶层 title,标题只保留在 projections.values.title;Host 在 session/list 响应里把它提升回行字段,否则 Remote 列表全是空标题。
  • 实测:该账号由 5 431 行 / 5.13 MB 降到 717 行 / 643 KB,Android 与 Desktop 恢复正常;测试覆盖 子会话超预算、根会话超预算、正常规模与 session/search 不受影响四种场景。

Self-hosted refresh response recovery (2026-11-06)

apps/server 对丢失成功响应的 refresh 请求返回同一直接后继 pair,支持重启和长时间 离线恢复;后继再次轮换后拒绝祖先 token,不撤销当前有效凭据。HMAC 以旧 bearer 为 密钥,nonce/设备/用途域分离;只持久化摘要与恢复元数据,不能从磁盘记录还原 bearer。 消耗旧 token 和签发后继一起提交,失败回滚内存。保持绝对到期时间、撤销及账号隔离; 旧版已消耗且无恢复元数据的 token 不能恢复,损坏的恢复记录返回可重试 503。

验证:Protocol build、Server check、58 个测试与 Server build 通过。真实本地 HTTP 丢响应/重启、并发重试,以及 Plugin ClientServerApi 即时重试/模拟两小时离线后无需 再次登录恢复通过;覆盖过期、撤销、旧数据、写入失败和容量边界。未部署生产 Server, 未进行跨机或长期真实断网验收。

Canonical Remote naming and credential migration (2026-11-06)

按用户要求移除旧 dsh-remote 设置命名空间的自动导入,不再注册旧 section;保留旧 Harness settings provider 接口。日志前缀与生命周期标签统一 ds-harness-remote。 共享包 @dsh-remote/* 与防止重复 Host 的旧 loader 禁用逻辑保留。

Linux 新安装默认使用 /opt/ds-harness-remote 与 ds-harness-remote-<profile>.service, 不自动迁移旧 runtime 或服务。安装器在改包前检测归属本项目的旧服务,若仍运行或启用则 拒绝继续,要求先停用;不停止、不删除未知服务。中英文安装指南同步。

凭据根改为 $DSH_HOME/ds-harness-remote(默认 ~/.dsh/ds-harness-remote)。安装器 处理凭据及升级后首次启动时自动整体迁移旧 remote 目录,先于凭据读写及身份创建。 迁移先只读校验整个旧目录:已知布局/文件白名单、公私钥配对、信任指纹、凭据 schema、 deviceId 与 Server scope 哈希;未知文件、混合数据、不一致记录、锁和符号链接均拒绝。 根目录外的跨进程锁序列化迁移;新旧根同时存在时不合并、不覆盖。升级需停止旧实例, 不能依赖空闲旧进程持锁检测。自定义 IdentityStore.directory 保持原路径。

已确认归属的旧目录 rename 遇权限/占用/只读/空间等错误时,复核同一原目录仍在且目标 不存在后回退旧根。在 .ds-harness-remote-migration/legacy-root.json 私有记录原目录的 设备号/inode,当前与后续新版进程都沿用旧根,避免活跃存储分裂;不自动重试移动已固定的 旧根。无法持久化回退记录、固定目录消失或被替换时停止,不创建替代身份。Host、安装器、 CLI 与默认 IdentityStore 均采用实际选定根;不重新生成密钥、不清除 Token/信任记录。

验证:Plugin 源码/test 类型检查、全量 73 文件 / 537 tests、生产构建、DSH bundle、安装 脚本语法与 diff check 通过。生产 CLI 在隔离目录验证成功自动迁移、未知目录拒绝、真实 父目录权限拒绝后仍有授权,以及权限恢复后另一个进程仍沿用旧根;凭据字节不变。安装器 真实 helper 在隔离 profile / 模拟 systemctl 中验证归属旧服务的 active/enabled 拦截, 以及停用服务/无关服务不被改写。本机 ~/.dsh/remote 只读归属检查通过,未打印私密内容 或执行真实迁移。Windows、Linux systemd 实装与跨设备未验收。

本机 hoisted 安装遗留的子包 bin wrapper 指向旧 isolated 路径,类型检查直接调用根 tsc。

Claude / Hermes direct workspace tools (2026-11-05)

Claude 与 Hermes 的 Desktop/Android 直接 Files/Terminal 已接入现有 ACP workspace tools。 Desktop 不再拦截文件调用及终端/文件变化流;Android 使用对应后端客户端与 session scope, 开放工具入口与 Markdown 文件链接。Host 继续以可信 cwd、连接归属、路径 containment、 终端 enabled 设置及设备/attachment 归属校验授权,不增加通用 exec 或文件写入端点。 Claude 图片输入仍未开放。Plugin/Android check、相关 33 tests、生产 Plugin bundle 与 Android Hermes export、DSH bundle 校验通过;文件监听测试复验时 Antigravity 场景 偶发超时,单独重跑通过。verify-packed-webrtc.mjs 在本机 isolated 安装下因 Schemastery 的 @standard-schema/spec closure 校验失败(既有边界);Host bundle 重建 存在本机依赖展开顺序差异。真实 Desktop/Android、APK 与跨设备 E2E 尚待验收。

Self-hosted WebRTC/TURN connection support (2026-11-05)

apps/server 从 Relay-only 扩展为可选的 WebRTC 四路协调:hello.ack 按 Client 声明与部署配置返回 transport.lan/p2p/turn/relay 交集;转发 signal.offer|answer|ice(按 connection/角色/阶段校验,每连接 ICE 上限 256,安全通道建立后忽略迟到信令;未声明 WebRTC 的 Host 不接收 offer,Client 自然超时回落 Relay),转发 transport.selected(含旧 Host 的 lan -> p2p 降级,并容忍 responder 侧 selection 而不丢 link),并新增 GET /api/v1/turn/credentials,仅向正在建立的连接双方按 coturn REST API 签发短期 STUN/TURN credential(DSH_SERVER_STUN_URLS / DSH_SERVER_TURN_URLS / DSH_SERVER_TURN_SECRET / DSH_SERVER_TURN_TTL_SECONDS)。TURN capability 仅在 URL 与 secret 同时配置时宣告,二者不齐全时启动失败;未配置 ICE 时保持原 Relay-only 行为。Server 仍只转发密文、不解密;未实现独立 Relay attach/resume、多账号、主机匹配码、OAuth/Browser 授权与 Admin。验证:Server check、新增 8 条 WebRTC/TURN 用例与全量 test 通过;容器镜像构建后经真实 REST/WS 冒烟验证 capability、signaling、selection 与 TURN HMAC;用户已在自建环境完成公网 P2P 实测。未做 coturn/TURN 跨机与长期连接验收。

Harness 0.2.2 compatibility (2026-11-05)

开发基线升级到 dsh-v0.2.2-rc.1,随附 Cordis 4.1.0、Loader 1.1.0、Include 1.1.0 与 @types/node 24;0.2.2 要求 Node.js >=24.9,CI 四个 job、scripts/install.sh 私有 runtime(含 x64/arm64 SHA-256)与安装文档同步到 Node.js 24.9.0。peer range 原本已接纳 0.2.2 预发布版,本轮不改范围。

适配内容:Android 的 session/attachment 改发完整 ImageAttachmentRef(从消息 content 保留 bytes,并校验返回引用);Host 桥按 harnessVersion 把完整引用降级为旧 Host 的 attachmentId,旧客户端对新 Host 无法补齐校验字段时由官方 Gateway 显式拒绝。CodeX/ACP 虚拟 control 帧同时发送旧 key/value 与新 changes,虚拟 session/page 补 cursor 并接受 session/events 别名;两边虚拟 session/attachment 同时接受 id 与完整引用。Remote allowlist 增加 toolResults/watch、schedule/edit|run|deleteInactive|deliveryLimits、 pluginManager/listVersions|readBundleDetail|updateBundle、session/events; pluginManager/updateBundle 复用 Remote 自有组合包保护,允许第三方组合包受信任更新。

0.2.2 的官方 Gateway 对每条本地 carrier 都读取调用 Peer(peer.signal/peer.principal/ peer.interactions),缺失时 $events 打开会抛 TypeError。插件激活时改为始终为本地 carrier 准备 owner Peer:优先官方 Peer/OperatorPeer 导出,缺失或构造失败时回退官方 Connection Host 服务的 createPeer,TypertGatewaySwitch.local() 在未显式传入 Peer 时 使用该共享 fallback;两者都不可用时报明确错误而不是让官方 Gateway 抛 TypeError。新增 owner-peer.test.ts 与 switch 回归覆盖该边界,并在独立 DSH 0.2.2-rc.1 上确认激活、 control/status 与远程工作区建立不受影响。

验证:全仓 pnpm --filter './packages/**' -r build、pnpm -r check、pnpm -r test、 pnpm install --frozen-lockfile、串行生产 build(含 Android Expo export)、 verify-dsh-plugin.mjs、verify-packed-webrtc.mjs 与 git diff --check 通过;其中 Plugin 73 文件 / 531 tests、Android 54 文件 / 520 tests。另在 独立 DSH 0.2.2-rc.1(Node 24.9.0、独立 DSH_HOME)安装本仓库构建产物,经本仓库开源自部署 Server 完成 Host 激活、Web UI 渲染、control/status 与 settings 读写、远程工作区建立烟测; 其中 account/watch 被 allowlist 拒绝属预期。同一构建另在独立 DSH 0.2.1-rc.5 Host(全新 profile 安装、复制既有凭据)上完成激活、control/status 与 0.2.2-rc.1 Client → 0.2.1 Host 的加密远程工作区打开,确认 owner Peer 修复同时覆盖上一版(两版 Peer/createPeer 契约 相同)。未做真实 Desktop/Android APK、原生真机、加密跨设备 E2E 或 0.2.2 新 UI 的人工验收;官方新增 ja/es/fr/de/ru/pt 界面语言的 Remote 文案仍 待补齐,$events 在缺少 @deepseek-ai/dsh-api-remotes 的 Host 组合上不可用(Desktop 客户端 会重连循环)也尚未在插件侧做降级提示。

Host bundle load fix and dsh-TUI deferral (2026-11-05)

packages/plugin/dist/index.js 曾以裸 ESM import 引用 ws(以及动态 import qrcode)。 在只携带 bundle 文件、未安装包运行时依赖的安装方式(本地路径 link、手工复制包、解包后的 GitHub/生成式安装等)中,DSH 加载 Host entry 会以 Cannot find package 'ws' 失败,插件无法 激活;内联 ws 后同类安装会继续在 @deepseek-ai/schemastery 上失败。构建脚本现把全部 运行时依赖(ws、qrcode、schemastery 及其闭包)内联进 Host bundle,仅保留 @deepseek-ai/dsh-client-connection(Host 组合必须提供的 peer 单例)与可选 @roamhq/wrtc 外部;verify-dsh-plugin.mjs 断言 Host bundle 的裸 import 只剩官方 Connection peer,阻止运行时 npm 依赖重新进入 bundle。

同一版本按用户要求移除 dsh-TUI 集成,下一版本单独提供:删除 src/tui-command.ts 与 index.ts 的 TUI 激活分支,Host 激活只要求官方 connection 服务;两个 cordis.patch.yml 只插入一个静态 Host entry(不再使用 !!js disabled 表达式与 ds-harness-remote-tui 行); dsh-plugin.json 不再声明 commands 契约、/remote 命令与 commands.invoke 权限; installer helper 只接受唯一静态 Remote entry;ds-harness-remote CLI 保留为无 Desktop/Web 时的账号入口,但不再提示 dsh-TUI。README(含 ja/zh)、兼容性、安装、设计文档与 docs/dsh-tui.md(已删除)同步;docs/TODO.md 记录后续版本恢复项。旧 profile 中已保存 的 ds-harness-remote-tui 行不会被自动启用,升级后由新 bundle patch 的单 entry 取代。

验证:Plugin check、build、verify-dsh-plugin.mjs 与 git diff --check 通过;Plugin 73 文件 / 529 tests(移除 2 条 dsh-TUI 生命周期测试)。同一构建在独立 DSH 0.2.2-rc.1 + Node 24.9 的三种安装形态上启动验证:pnpm tarball 安装、本地路径 link(插件目录没有任何 node_modules)、手工复制包到 profile node_modules(不带依赖)均能激活 Host;对照旧 bundle 在无依赖情形下以 Cannot find package 'ws' 失败。installer helper 的 preflight 逻辑以真实 --dump-config 树验证单静态 entry 校验通过。未做真实 Desktop/Android APK、跨设备或 install.sh 完整 token 注册验收;install.sh helper 直接 import 插件 entry 时仍依赖 profile 内可解析的官方 peer(既有行为,不受本次内联影响)。

Legacy loader ownership (2026-11-04, Issue #244)

启动迁移仅自动禁用项目自有的 @dsh-remote/plugin 旧名;不再按裸名 dsh-remote 禁用条目,该 npm 包属于另一发布者。旧本地别名没有可确认的来源时保持用户状态, 由用户核对后手动禁用。新增一条生命周期契约验证跨插件写入边界,以及自身、已禁用 条目和无关插件的状态保持,不新增 UI 或配置布局断言。

Windows Node 22.23.4 / pnpm 9.15.4:五个 packages 构建、Plugin check 和 8 条生命周期 测试通过;Host 发布 bundle 仅一行变化,Client bundle 无变化。Node 24.11.1 下四个 共享包 193 tests 通过;Plugin 全套 482 pass / 8 fail,另有一个依赖加载错误。 同环境原始基线加新测试为 481 pass / 9 fail,失败名称的唯一差异即本条回归; verify-dsh-plugin.mjs 的根 TUI patch 断言在原始基线也失败。冻结安装因 lockfile 缺失依赖记录失败,验证时只在本地修复安装并在安装后恢复原 lockfile 字节,不提交 依赖变化。未做真实 DSH profile、Desktop/Android 或跨设备验收。

Native subscription recovery (2026-11-03)

Remote transport loss must not become a terminal wire error for native Harness snapshot consumers: RemoteSnapshotStream stops consuming after such an error, so a later ctx.connection.reconnect() cannot restore workspace/session updates. The selected Harness gateway now defers transport-close failures until its caller is cancelled by the existing post-authentication carrier reset (or disposal). It does not reopen streams or replay RPCs. One-shot gateways and Host business failures retain their normal error behavior. native-stream-recovery.test.ts uses the native snapshot consumer to cover recovery, cancellation during open, permission refusal and queue overflow; client-reconnect.test.ts covers the runtime's cancellation boundary and fresh Host history reads.

Client reauthorization after disconnect

Surface terminal Client authorization failures separately from Host status and transient carrier loss. Reuse the existing Client sign-in dialog; keep Host selection and fail closed until the user reconnects. A protocol 401 rejecting a Client GET bearer can refresh and retry that read once. Do not retry mutations, refresh rejections or peer trust failures as business requests. The self-hosted Server consumes a refresh token before sending its successor: loss of that response can require a new account login.

werift 0.26.0 upgrade (2026-11-03, Issue #259)

按 #259 清单把 werift 从 0.24.4 升到 0.26.0(plugin 与 apps/vscode 同步升级,消除 hoisted node_modules 双版本),不再需要 patches/werift@0.24.4.patch(#245 的止血补丁,随分支基线 移除)。0.26 的 StreamTransport 重写移除了 end 后的静默自动重拨(#241 崩溃类的根源), 改为失败即 terminal,并内置连接超时(connectTimeoutMs,bundle 内可见 connect timed out after 标记)。插件使用的全部 ICE 配置键(iceUseIpv4/iceFilterCandidatePair 等)在 0.26 类型中保持不变。回归测试改为 0.26 语义(werift-turn-transport.test.ts):连接拒绝与连接中 RST 均不产生 unhandled rejection、无重拨代际、send() 对调用方 reject;bundle 守卫断言 0.26 标记存在且旧补丁守卫不存在。验证:plugin 481 tests、四共享包 186 tests、vscode check、 NODE_ENV=production 重建与 verify-dsh-plugin 通过;verify-packed-webrtc.mjs 在 main 上因 schemastery 新增 @standard-schema/spec 闭包失败(存量问题,未在本轮处理)。 orderIceServersForWerift 的 TURN TCP 优先排序本轮保持不变,待真机验证后再评估。

Android Mermaid rendering (2026-11-02, Issue #255)

Android 聊天 Markdown 的 ```mermaid 代码块改为图表。scripts/build-mermaid.mjs 将固定版本 mermaid@12.2.0 与 scripts/mermaid-renderer.js 打包为忽略的 src/generated/mermaid-html.ts (已加入 build:renderers);App 根部的单例隐藏 WebView 在首次出现 mermaid 块时才创建, 串行渲染并按「源码 + 主题」缓存(LRU 48),源码稳定 700ms 后才渲染以避开流式中间态。 页面 CSP 禁网络/worker,屏蔽 console、弹窗与跳转,securityLevel: 'strict'、htmlLabels: false、 look: 'classic';源码上限 20K 字符、SVG 上限 1 MiB、单图 20 秒超时,崩溃/超时重建页面。

内联图用 react-native-svg 原生绘制,但其 Android 渲染器遇到无法解析的属性值会抛异常并 使整个 App 闪退(实测 marker orient="auto-start-reverse"、AlignmentBaseline 未知值)。 因此内联 SVG 不得透传 mermaid 输出:渲染页按白名单重建元素与属性,逐值正则校验,计算样式 写为属性(仅写与父元素不同的值),marker/渐变提升到 <defs> 且其子树写完整样式。 含 foreignObject 的图(journey)只走全屏查看:Modal 中 javaScriptEnabled={false} 的 WebView 以 <img src="data:image/svg+xml"> 显示原始 SVG,支持双指缩放与复制源码。 图表与分类色板跟随亮/暗主题;7 种语言补齐 diagram 文案。不执行插件 JS,不改 Host/协议。

本轮验证:Android check、49 文件 / 447 tests、production Hermes export(bundle 29.6 MB, 其中 Mermaid 页面约 5.7 MB)与 diff check 通过;浏览器中 16 种图的白名单内联 SVG 均可解析, 与原图像素差 ≤2.2%。模拟器(Android 15,WebView 124)以临时本地样例页(未提交)人工检查 flowchart/sequence/class/state/ER/gantt/pie/mindmap/xychart 亮暗两色、journey 全屏与语法错误 回退。未在真实 Host 会话或真机验证,未测流式过程、TalkBack、大字体与抓包。

Startup plugin update check (2026-11-02)

启用状态且存在 Desktop/Web connection 服务时,插件启动时及此后每 24 小时对 npm dist-tags 端点做一次匿名查询:npmjs.org 与 npmmirror 并发竞速,首个有效应胜出(国内网络不再等 npmjs 超时)。结果 {currentVersion, latestVersion, checkedAt} 经 withUpdate 合并进 control status、host.reconnect 与 mode.set local,随既有 SSE 推送;失败仅记 debug 日志,不阻塞启动。无 connection 的 dsh-TUI Host 与 disabled 插件不发起请求。semver 比较在 client-safe 的 version-compare.ts(无法解析的版本比较为相等,不产生提示),host 与 client bundle 共用。不新增配置项与自动化测试(非核心展示功能,按测试政策)。

UI 展示:侧栏 Remote 入口(保持 0.6.0 的内容自适应几何)在本地版本落后时套用宿主 DesktopUpdateIndicator 的品牌色外观(8% 底 + 20% 描边),标准形态标签右侧追加 「⬆ {latest}」后缀,轨/紧凑形态为官方同款 6px 品牌色圆点;Remote 弹窗账号 footer 行内 追加「{latest} 可用」品牌色链接(title 为完整版本信息),点击直达 GitHub Releases; 主机列表与所选主机详情对 clientVersion 落后的远端主机追加「⬆ 可更新」文本标记。 不写「设置 → 插件」指引:官方一键更新仅覆盖 npm registry 安装,GitHub/本地安装无入口, 且第三方插件无法直达宿主设置分区(launcher 座位官方占用,openSettings() 无分区参数)。

客户端 statusFeed 订阅由「弹窗打开时」改为挂载即生效:此前侧栏入口只在挂载时拉一次 status,启动后的 registry 结果推送到不了按钮,直至打开弹窗才重放最新状态。

本轮验证:Plugin check/build(bundle 字节复现)、DSH bundle 校验、67 文件 / 469 tests、 checker 注入 fetch 冒烟与 compareVersions 语义 15 项(scratch,未提交)通过;以临时 0.5.90 演示构建经 tarball 安装到真实 Desktop profile,人工确认启动数秒内入口自动出现 更新态、弹窗 footer 链接与跳转正常。未做跨设备回归验收。

Remote popup portals (2026-11-01, Issue #222)

Workspace、连接线路、Host reference 和旧模式切换面板复用宿主 ReactDOM Portal, 挂到 document.body,避开 shell 祖先 filter/transform 的包含块与层叠上下文。 宿主未提供 Portal 或 body 不可用时保留原位渲染。遮罩、关闭行为和状态条插槽不变。 Plugin check、build、DSH bundle 与 diff check 通过,样式检测无发现;未在 Windows 壁纸插件环境做交互验收,body/html 自身的 filter 不在本次修复覆盖范围。

Self-hosted heartbeat recovery (2026-10-31)

AdaptiveTransport 将自部署 Server 的精确 close 4001 / CONNECTION_FAILED 视为可重试; 其余应用关闭原因不放宽,恢复沿用成员/固定公钥校验与新 Noise 握手,不重放业务请求。 回归覆盖八小时睡眠后的延迟 close、随后三十分钟离线的封顶退避与恢复;时间均为模拟。 全仓 check、985 tests、串行生产 build、DSH bundle 与 diff check 通过;既有 Metro noble/hashes exports fallback 警告保留。Desktop 0.6.0 仅回移该 classifier 的实测中, 冻结本机 SSH 转发三分钟,恢复后约 2.3 秒自动建立新连接并刷新原会话;Host 未重启。 这不是整机休眠/隔夜稳定性验收,未新增 Android 原生或其他平台的本轮验证。

ApiProxy retirement (2026-10-25)

Host 插件、随包 Remote 客户端和 Android 已移除 Harness 0.1.1-rc.2 ApiProxy 兼容。请使用提供官方 Typert Remote carrier 的 Host;仅提供 ApiProxy 或不支持能力发现的旧 Host 会被拒绝,不再降级。CodeX/ACP 保留独立数据面,Desktop 内存投影统一使用 Typert。本轮不改独立 VS Code Client 或独立 Remote Web 仓库。 旧日期的 rc.2 验证记录仅为历史,不代表当前兼容性。共享 protocol/client-core 保留 VS Code 使用的历史类型和检测分支,不能据此重新启用 Host 或 Android ApiProxy。

本轮验证:全仓 check 与串行生产 build(含 Android Hermes export)、Plugin 57 文件 / 397 tests、Android 35 文件 / 201 tests、DSH bundle 校验、根 GitHub 入口加载与 npm dry-run 检查通过;发布包不包含退役模块。未验证 APK、原生真机或本轮加密跨设备 E2E。Metro noble/hashes exports fallback 警告仍存在。

Android plugin management (2026-10-27)

Android 新增插件页(工作区标题栏拼图图标与会话侧栏「插件」),只调用 Host 已放行的官方 pluginManager list/setBundleEnabled/setPluginEnabled 与 settings/describe/mutate,不改 Host allowlist。 分组为「Remote 适配」(客户端原生渲染的插件,REMOTE_ADAPTED_PLUGINS,未安装也提示)、已安装、实验性; 基础/运行时 bundle 与缺失目录项不显示。设置 namespace 为 entry 的 patchId(非 include: entryId), 官方 settings 只暴露 Schemastery volatile 字段;表单按 schema 生成,保存带 expectedRevision, 「恢复默认」对用户覆盖字段执行 unset。deepseek-harness-intelligent-ui 同步将 Widget 策略字段改为 volatile(读取改为惰性 getter)并加 zh-CN 描述。插件只能在电脑安装:Remote 适配插件未安装或版本过旧(无可编辑设置)时,详情页给出可复制的 Desktop/CLI 安装命令;scripts/install.sh 支持 INTELLIGENT_UI=1 安装到同一 profile,README 增加推荐搭配说明。模拟器 + 真实 web profile Host 验证:列表/图标/分组、 保存并持久化、越界本地拦截、恢复默认、插件停用/启用(profile 恢复原状)。未验证真机、Desktop profile (其 intelligent-ui 为独立旧副本)与暗色模式人工烟测。

Android visual refresh (2026-10-29)

重做 Android 前端视觉,仅改前端样式与布局,不改 Host/Server、协议或状态逻辑。 色板改为 DeepSeek 黑 / 蓝 / 白(#4D6BFE),新增 grouped/elevated/inverse token 与 xl/xxl 圆角; TopBar 改为浮动圆钮 / 胶囊,新增 GroupCard/GroupRow/FilterChip,新增平滑 Toggle 组件(src/ui/toggle.tsx)全量替代 8 处旧 Switch 控件; Settings 改为分组列表、外观预览卡与底部红色高危操作行(退出登录/重置配置); 列表全面推行扁平设计:首页设备卡与最近访问使用半透明白色卡片及线性图标,工作区与侧边栏采用扁平文件夹列表(chevron、文件夹、名称、计数); 侧边栏改为大标题 + 图标导航 + 右下浮动「新建对话」黑色胶囊(清理了旧版标题下方的状态/版本行);聊天欢迎页突出蓝鲸 Logo 与大标题(不设上下文胶囊)。 新增文案仅 devices.summary,已补齐 7 种语言。详见 docs/design/DESIGN.md。

2026-10-30 配色调整:浅色画布与 splash 使用 #F0F4FD;卡片使用独立 card token, 浅色白色 60%、深色白色 5%,不设置容器整体 opacity。surface 继续用于不透明浮层和输入框。 设备滑动行使用卡片与画布的合成实色 cardOpaque,避免下方红色删除层透出;其他卡片直接使用 RGBA。 本轮共享包/Plugin build、Android renderer 构建(Intelligent UI 未安装,走安全 fallback)、 workspace data-plane 校验、tsc --noEmit、DSH bundle 与 diff check 通过。因宿主默认 pnpm 11 与仓库 pnpm 9 安装布局不一致,check 的各子步骤直接执行;未增加 UI 测试、构建 APK 或真机验收。

本轮验证:Android check(含 tsc)与 42 文件 / 271 tests 通过;模拟器(debug 包 + Metro)浅色/深色 逐页人工检查。未构建 APK,未验证真机、平板/横屏、大字体、TalkBack;未在会话中实际发送消息, 用户气泡、工具卡与审批卡新样式未经真实对话验收。

WebRTC runtime probe isolation (2026-10-25)

外部原生 WebRTC helper 的候选探测必须显式设置 ELECTRON_RUN_AS_NODE=1,不能删除该标记: 候选可能是 Desktop 的 Electron 可执行程序或其 launcher,否则连接触发探测时会误启动另一个 Desktop,探测超时关闭 stdout 后可能触发 write EPIPE。探测脚本仍须在加载原生 WebRTC 前 拒绝 Electron,最终 helper 使用独立 Node。核心回归使用真实子进程覆盖 Node 接受、Electron 拒绝及不进入 GUI 模式;旧探测行为会失败。Plugin check、相关 10 tests、build、DSH bundle 校验、真实安装版 Electron → Node → native WebRTC offer,以及 Web → 测试 Host 的 LAN 加密连接通过。未验证本次 Windows/Linux runtime 探测。

本文件面向在当前仓库工作的编码 Agent,记录仓库边界、项目结构、实现状态、验证命令和协作约束。用户产品说明与 Plugin 使用方式见 README.md。

Repository Boundary

当前仓库实现:

  • DeepSeek Harness Plugin(Remote Host + 本地 Remote 工作区入口;dsh-TUI 集成自 0.6.3 起移除,计划下一版本单独提供;无用户可见的 Client 模式)
  • Android Client(账号授权 + Adaptive transport + v0.1.2 alpha.1–rc.1 / v0.1.5 rc.1 与 v0.1.6 alpha.1 Session V3 Typert Remote + 可选 CodeX Remote)
  • VS Code Client(账号授权 + Host 信任固定 + rc.2 ApiProxy / v0.1.2 alpha.1–rc.1 / v0.1.5 rc.1 与 v0.1.6 alpha.1 Session V3 Typert Remote 会话/Prompt)
  • Protocol、Crypto、WebRTC、Client Core 等共享能力
  • 开源自部署 Server(apps/server):环境变量单账号、JSON 文件持久化设备凭据、Control/Noise handshake forwarding、WebRTC signaling/TURN credential 协调与 opaque Relay、Web 登录与设备状态页,以及 Dockerfile/Compose 部署入口
  • 依赖外部 Server 的 Mock Host/Smoke Client
  • Server 设计与跨仓库协议契约

当前仓库禁止实现:

  • 完整多账号 Server、Remote Web 会话界面、Admin backend/frontend
  • 完整 Server 的数据库、migration、queue 及 Kubernetes、Terraform 等部署基础设施
  • apps/server-web、apps/web 等完整 Server 站点源码

本仓库包含可独立部署的开源 Server,允许在 apps/server 内维护上述最小版本的 runtime、文件持久化、限流、Web 页面和 Docker 部署。完整多账号 Server、Remote Web 和 Admin 仍由独立 Server 仓库作为同一站点实现。本仓库必须保留 docs/server.md 和 docs/protocol.md;不得把完整 Server 的设计目标描述成开源自部署版本已实现的能力。

Project Structure

apps/
  android/             React Native / Expo Android Client(账号授权 + Typert/CodeX Remote tunnel)
  vscode/              VS Code Extension Client(Host 列表、加密连接与远程会话)
  browser/             Chrome/Edge MV3 入口(Web 授权换取独立凭证 + 在线 Host + 打开 Remote Web)
  server/              开源自部署 Server(单账号 WebRTC/Relay、登录/设备状态页、Docker 部署)
packages/
  plugin/              Host runtime、Remote 工作区入口与原生 API 代理
  protocol/            Remote/Control frame 类型和运行时校验
  crypto/              X25519、HKDF、ChaCha20-Poly1305 与 Noise IK
  webrtc/              Relay、WebRTC、LAN transport 抽象
  client-core/         RPC correlation 与 Remote event 分发
examples/
  mock-host/           外部 Server 互操作工具
docs/
  design/              产品与功能设计
  plugin-integration.md Host 账号登录、授权注册与凭证接入契约
  protocol.md          Host/Server/Client 权威线协议
  server.md            完整 Server 设计与互操作契约、自部署版本范围入口

仓库根包同时是 DSH Desktop 的 GitHub 安装边界:根 package.json 必须保留 dsh.bundle.patch、Host/Client exports、CLI bin 和 cordis.patch.yml;GitHub 默认禁用 构建脚本,所以根 index.js、packages/plugin/dist/index.js、client.github.js 与 packages/plugin/bin/ds-harness-remote.js 是需要提交的发布入口。

根包不标记 private: true,兼容仅读取根清单、遇到 private 就跳过 npm 查询的插件索引。 根包与 npm 包保持相同 name/version,但安装入口布局不同;npm 发布仍只能由 release workflow 在 packages/plugin 执行,不在仓库根目录运行 npm publish。 实际发布包通过标准 repository.directory: "packages/plugin" 标明源码位置, 根包的 repository 不带 directory,以保持 GitHub 安装入口语义。

Plugin bundle 构建统一 esbuild 的依赖模块路径标签,避免 pnpm isolated / hoisted 安装布局 造成已提交 JS 差异;保留 source map 的真实路径以便本地调试。CI 重建后必须同时检查 packages/plugin/dist/index.js 和 packages/plugin/dist/client.github.js 与提交版本一致。

空的 Web/UI 预留目录不应创建。Expo 生成的 .expo/web cache、.webp 图片格式和 packages/webrtc 不属于 Remote Web 项目。

Current Status

模块 状态 主要剩余工作
Plugin Host 账号密码/主机匹配码接入、GitHub/知乎二维码授权与可点击 URL、同账号 peer 校验、隔离身份/凭证、Relay/Noise IK、并发 Client 与按连接隔离的 v0.1.2 alpha.1–rc.1 Typert Remote allowlist bridge 已实现;v0.1.5 rc.1 Session V3 与 v0.1.6 alpha.1 支持已接入,并已在独立 dsh-v0.1.6-alpha.1 实例上验证 Web → Host 主链路;真实 Desktop 跨机 E2E 已验证;Host bundle 已内联运行时依赖,dsh-TUI 集成自 0.6.3 移除;无自定义 Harness 业务适配层 恢复 dsh-TUI 集成(下一版本)、v0.1.5/v0.1.6 跨机 E2E、legacy owner 恢复体验、allowlist 覆盖审计、跨平台 picker 边界
Plugin Remote Client 与 Host runtime 同时启动,无需 Client 模式;Remote 模态框支持 GitHub/知乎扫码与账号密码登录、本机过滤、主机/版本信息、已有 Harness/CodeX Workspace、远端目录浏览与 CodeX Project 注册、Typert 图片 Prompt/回显,以及配合 dsh-file-viewer 的受限只读文件预览,随后复用原生 Harness UI;加密通道 capability 探测拒绝 ApiProxy-only Host;Web → Host 主链路已在 v0.1.5 rc.1 与 v0.1.6 alpha.1 上验证 CodeX Project 新建跨设备 E2E、断线重连恢复、页面级导航接口、长期稳定性
Android 使用 v0.1.2+ Typert Remote 数据面,并直接接入可选 codex.app.*:账号登录注册、成员设备列表与 identity key 固定、Adaptive transport + Noise、capability 探测、Harness/CodeX Workspace 与 Session、远端目录选择与 CodeX Project 注册、工作区收藏与首页快捷链接(点击直达该工作区最近会话)、分页 History/live frame、模型/权限、文字/图片 Prompt、interrupt 与审批,以及跟随系统/英文/简体中文/日语/繁体中文/西语/德语/法语界面;启动时仅有一台设备且在线、已信任时自动进入其工作区列表,否则进入设备列表;会话链接与用户开启的上次会话恢复优先,返回设备列表不重复自动跳转;历史 rc.2/v0.1.2/CodeX 真机跨机 E2E、图片分块、重连和 WebRTC 已验证 CodeX Project 新建跨设备 E2E、协议 conformance fixtures、长期稳定性与跨设备回归
VS Code Extension 基础已实现:SecretStorage 身份/凭证、账号/扫码登录、Host 指纹固定、Adaptive transport + Noise、rc.2 ApiProxy / v0.1.2 Typert Remote Host→Workspace→Session 导航、Prompt、permission command 与编辑区会话面板 Extension Host 跨机 E2E、实时流式更新、question 界面与重连恢复
Browser Chrome/Edge MV3 轻量入口已实现:临时读取已登录 Web 的授权并换取隔离的 device credential,popup 展示在线 Host,点击后直接打开同源 Remote Web;不承载账号登录、Remote transport、ApiProxy 或会话 UI;unpacked 联调与 Web 授权跳转、独立 Server 合约联调已验证 随独立 Server 合约变化同步
Protocol Control/Relay 与 ApiProxy tunnel 基础已实现 完整 Zod schema、limits、golden vectors
Crypto 基础原语、标准 Noise IK 与确定性 golden vector 已实现 第三方实现审查、rekey、跨端执行 golden vector
Relay Transport Protocol v1 control/relay 已实现 心跳、限制协商、断线状态传播
WebRTC signaling、ICE、TURN、LAN/P2P/Relay 自适应路径基础已实现,Android 真机与 Host werift 互操作已验证 网络切换恢复和长期稳定性
Client Core ApiProxy tunnel RPC/Event 关联基础已实现 reconnect、pending call/stream 恢复
Codex Remote 领域 作为现有 Remote Plugin 内部可选领域:Host stdio App Server、默认开启且可在设置中关闭、固定 allowlist 与连接隔离已实现;Desktop 以 v0.1.2 Typert 内存载体复用 DSH 原生 UI,Android 直接消费同一 codex.app.* 并复用移动端 Workspace/Session/Chat;两端可通过受限 project/create 将 Host 上已存在的真实目录注册为 Project,并都只保留内存展示投影;既有 Desktop 与 Android 真机 E2E、大 History、断线恢复和多 Client 观察已验证 Project 新建跨设备 E2E、长期稳定性、跨版本回归和安全审查
Mock Host 旧 Android Remote RPC 联调工具,当前冻结 若恢复 Android 再迁移或替换
Desktop Host 设置、Remote 工作区模态框、远程 Header、连接链路与加密状态已接入 Harness Web UI,Host status 由 loopback SSE 推送(无固定间隔的 status 轮询),原生窗口跨机 E2E 已验证 多窗口、休眠/唤醒和代理网络回归
开源自部署 Server apps/server 已实现单账号授权、设备凭据持久化与刷新、Control/Noise 握手转发、WebRTC signaling 与短期 TURN credential 协调、加密 Relay、Web 登录与设备状态页;提供 Dockerfile/Compose;单进程,不提供 Remote Web 会话界面、独立 Relay attach/resume 或 Admin Docker 实际构建与启动验证、真实 coturn/WebRTC 与 Desktop/Android/VS Code 跨机 E2E、反向代理长期连接回归
完整 Server/Remote Web/Admin 独立 Server 仓库已有实现,REST、Control WebSocket、Relay、Signaling 与 conformance fixture 跨仓库联调已完成 完整站点 runtime 变更在独立 Server 仓库完成,并同步跨仓库契约

完整任务和优先级以 docs/TODO.md 为准。不得把 TODO 中的目标能力描述成已经完成。

Development

环境:Node.js 24.9、pnpm 9.15.4。Android 原生开发还需要 Android Studio、Android SDK 和 JDK。

pnpm install
pnpm --filter './packages/**' -r build
pnpm -r check
node scripts/verify-dsh-plugin.mjs
pnpm -r test
NODE_ENV=production pnpm --workspace-concurrency=1 -r build

全仓 build 必须使用 --workspace-concurrency=1:Android prebuild 会再次编译共享包, 并发执行可能让 Plugin bundler 读到正在重写的 dist 文件。

先构建 packages/**,确保 workspace package 从 fresh clone 开始也能解析 dist 类型。根 package.json 刻意不声明 scripts,避免 pnpm 将 DSH Desktop 的 GitHub 安装误判为需要执行构建脚本。

常用命令:

pnpm --filter ds-harness-remote build
pnpm --filter ds-harness-remote check
pnpm --filter @dsh-remote/android android
pnpm --filter @dsh-remote/android start
DSH_REMOTE_SERVER=ws://127.0.0.1:8080/ws/v1/connect pnpm --filter @dsh-remote/mock-host dev

Android 不能使用 Expo Go,因为 react-native-webrtc 依赖原生模块。

开源自部署 Server 的独立验证命令:

pnpm --filter @dsh-remote/protocol build
pnpm --filter @dsh-remote/server check
pnpm --filter @dsh-remote/server test
pnpm --filter @dsh-remote/server build

本地启动、环境变量与 Docker 部署见 apps/server/README.md 和 apps/server/README.zh.md。Server 设备凭据数据和 .env 不得提交。

安装相关入口仅保留 scripts/install.sh(macOS/Linux)。不提供 Windows、独立卸载或 Token 包装脚本; 构建/测试辅助脚本不在此清理范围内。按用户本轮明确授权,Linux 要求 root,缺少 DSH 时允许安装配套 Node.js、DSH 和私有 pnpm,支持一次性 Host 注册 Token,并配置、启用和启动 systemd 系统服务,无需 linger。 系统服务以 root 运行时必须明确提示其 Host/终端具有 root 权限。只操作归属匹配的安装器管理服务,不接管其他 DSH_HOME 或未知旧服务。已有 DSH 复用而不自动升级;不修改系统 Node.js、全局 PATH 或 npm 配置。 macOS 仍使用普通用户,优先复用 Desktop 官方 launcher,否则已有 CLI;两者都没有才报错,不安装 Desktop/DSH/Node.js 或创建后台服务。支持 DSH_COMMAND、DSH_PROFILE、REMOTE_VERSION,保留已有 DSH_HOME;独立 CLI 默认 web, Desktop 默认保留的 desktop profile,只能由其官方 launcher 管理。一次性 Token 复用官方身份/凭据与既有注册码接口, 不得记录或作为持久设备凭据使用。Windows 用户使用官方插件管理或已有 Harness 的官方命令。 卸载先按安装指南停用 Linux 系统服务,再通过官方插件管理或 dsh plugin remove 移除 Remote;不自动删除 runtime、 凭据或迁移旧 service。当前待发布版本为 0.6.3,Android versionCode / Expo iOS buildNumber 为 71;发版准备已将安装说明同步到 ds-harness-remote@0.6.3,Tag、npm 与 GitHub Release 的发布状态以实际发布结果为准。

Validation Baseline

以下为历史验收快照,不代表当前源码基线。最近构建结果见文末 Post-merge 0.5.20 rebuild (2026-10-27);当前兼容范围见 docs/compatibility.zh.md。

截至 2026-09-16:

  • workspace check 与 DSH bundle 校验通过
  • Plugin test:28 个测试文件、228 个测试;Android test 通过:14 个测试文件、163 个测试。本机 Windows 运行 tests/codex-domain.test.ts 有 3 个既有的路径分隔符/目录顺序平台假设失败, tests/werift-rtc.test.ts 的 lan 候选断言受本机 VPN/虚拟网卡候选池影响,两者均与 Remote status 推送改动无关;完整 workspace 数量以当前 CI 输出为准
  • workspace build 通过,包括 Android Hermes bundle
  • 真实设备验证已覆盖 Web → Host、Desktop/dsh-TUI 跨机、Android Harness/CodeX、WebRTC、CodeX Desktop/Android E2E 与独立 Server 跨仓库联调
  • 独立 dsh-v0.1.6-alpha.1 实例验证通过:Plugin 树加载、Host identity、Codex 域与 client bundle 下发正常,Web → Host 主链路可用;peer range 与构建/测试基线已升级到 @deepseek-ai/dsh-*@0.1.6-alpha.1
  • git diff --check 通过

已知构建警告:Metro 对 @noble/hashes/crypto.js 使用 package exports fallback。该问题记录在 docs/TODO.md,不得静默删除说明。

2026-09-20 开源自部署 Server 补充验证:check、11 个核心测试与生产 build 通过;构建产物本地启动后,健康检查、页面及静态资源、账号登录、Cookie 鉴权与未授权拒绝通过。Docker daemon 未运行,未验证镜像构建和容器启动;真实跨机与反向代理长期连接仍待验证。独立 Server 的既有联调结果不等于本版本已完成部署验收。

Implementation Rules

  1. docs/protocol.md 是线协议权威来源。代码与文档冲突时,先按协议实现;必要的协议澄清必须同步更新文档和共享类型。
  2. Plugin 不监听公网端口,只建立出站连接。
  3. Remote business message 只能进入已认证的加密 channel;明文、未知 connection、错误 target、重放和 identity mismatch 必须 fail closed。
  4. Server membership 与 Host 本地 trusted peer 必须同时成立。
  5. v1 permission decision 只允许 allow_once | deny,禁止恢复 allow_session。
  6. 按用户 2026-09-20 授权,支持官方原生文件树/只读预览、默认开启且可在详细 Remote 设置中关闭的 terminal.enabled 交互终端,以及 loopback.ports 明确授权的 HTTP/WebSocket 预览。文件通过官方 workspaceFiles/officeToPdf 或已有 dsh-file-viewer provider 读取,除下述 2026-10-18 workspace upload 与 2026-10-21 workspace/create 目录创建授权外,禁止新增直接 filesystem 写入、远程桌面或通用 Harness tool RPC。终端以 Host 用户权限运行,独立于 Agent 审批;按设备固定终端归属与连接输入权,断线不重放输入。loopback Host 只出站连接 127.0.0.1 白名单端口;Desktop Client 可监听随机本机端口承载独立预览 origin,禁止监听公网、任意目标、CONNECT 和通用 TCP 转发。
  7. Token、私钥、主机匹配码、prompt、源码和工具输出不得写日志。
  8. Harness v0.1.1 rc.2 ApiProxy 已移除;v0.1.2 alpha.1–rc.1 与 v0.1.5 rc.1 / v0.1.6 alpha.1 Session V3 业务层只使用官方 TypertGateway Remote carrier;原生侧栏使用官方 workspaceFiles / officeToPdf / terminal 固定 allowlist;保留 dsh-file-viewer provider 通道。除规则 10 规定的 CodeX 内存展示载体外,禁止增加 session/agent/workspace/permission adapter、另一套 Harness wire format 或通用文件系统协议。
  9. 不修改用户已有变更,不提交 node_modules、Expo cache、Android build 产物或个人 Agent 配置;唯一允许提交的 dist 是根 DSH GitHub Bundle 所需的 packages/plugin/dist/index.js 与 client.github.js,另需保留根 Host 入口 index.js。
  10. Codex 支持必须保留在现有 Remote Plugin 内,并作为 packages/plugin/src/codex/ 独立业务领域实现;默认开启且可在设置中关闭,使用独立 capability/RPC/event/state。允许 Client Plugin 以临时 Typert 载体复用 DSH 原生 UI,也允许 Android 直接消费同一 codex.app.* 并只在内存中投影其移动端 Workspace/Session/Chat;两者都禁止写入 DSH SessionStore、Workspace 数据库或 Harness 日志。远端只允许编译期固定 App Server allowlist;Workspace authority 优先来自 CodeX App Server 的 project/list,该接口不可用或无可用根目录时才可回退到 App Server 已通过 thread/list 返回的绝对 cwd。project/create 只可注册 Host 上已存在的单个绝对目录,Host 必须执行 realpath 并确认目标是目录,且上游返回的新 Project 才能扩展 authority。新 Thread 还可使用这些 authority 根内经过词法路径与 realpath 双重校验的真实子目录,禁止推测共同父目录或越界接受 Client 自报路径。

Android 的本机浏览状态可单独保存加密草稿、收藏、阅读位置与最近访问记录;不再持久化对话正文预览,按 Server/账号/Host identity 隔离;不保存审批句柄、待发送请求、权限或图片字节,不写 DSH SessionStore/Workspace。联网历史与原生权限仍是执行依据。

Test Policy

用户要求非核心功能不写 Test。测试预算只用于:

  • Protocol 编解码、版本和 schema
  • 身份、加密、篡改和重放
  • Account authorization、Host registration code、Control handshake、Relay authorization
  • RPC correlation、权限 fail-closed、ApiProxy/Typert Remote endpoint allowlist、事件顺序和恢复
  • Transport fallback/reconnect 等核心状态机

纯展示 UI、普通文案、静态说明、非关键脚本和样式调整不单独增加测试。

新增或保留测试应能说明所保护的核心协议、安全边界或状态转换。同一共享实现的同一输入 只在所属 package 测一次;Client 测试应覆盖其独有的接入与恢复行为,不复制共享包的完整 schema/fixture 用例。跨端 conformance 必须在真实目标 runtime 运行;在 Node 中重复运行 共享协议代码不计为 Android 原生验证。禁止用源码字符串、组件布局、图标、配色、文案或 自定义快捷提示的增删改断言扩充自动化测试;这些改动以类型检查和必要的人工烟测验证。 同一契约、同一状态转换的输入变体优先使用命名场景矩阵,避免每行单独注册测试。 场景之间必须复用原有 setup/teardown,保持 mock、计时器和临时资源隔离;失败需要报告 具体场景,并继续执行同组其他场景。测试数量指注册的契约测试数,不代表边界输入数。 不要为凑数量把互不相关的核心断言塞进一个测试,也不要通过 skip/exclude 隐藏测试。

2026-10-07 两轮测试清理:全仓从 95 文件 / 1082 用例减至 83 文件 / 811 用例;Android 从 29 文件 / 323 用例减至 18 文件 / 138 用例,Plugin 从 42 文件 / 378 用例减至 41 文件 / 342 用例。删除非核心 UI/普通展示与配置挂载测试、未触发的自动连接 helper 测试、mock 自身行为测试和 Android 在 Node 中重复运行的 86 个共享协议 fixtures。 Protocol 从 235 减至 187 用例:完整保留 86 个跨仓库 fixtures,删除已被它们覆盖的手写 断言,以及已有尺寸矩阵和常量精确值断言覆盖的重复测试;额外的安全边界、篡改、重放、 授权、权限隔离与恢复测试保留,RPC 两种超时参数分支也分别保留。清理前后全仓 test 均 通过,清理后全仓 check、共享包 build、DSH bundle 校验与 git diff --check 通过。移除已无引用的 React test renderer 开发依赖;未修改业务代码。

2026-10-07 第三轮契约合并:按用户要求,将上述 811 个注册测试合并为 506 个,仍为 83 个文件;Plugin 246、Android 86、Protocol 78、WebRTC 40、client-core 32、Server 9、 VS Code 7、Crypto 7、Browser 1。本轮不删除边界场景:同一 schema 的字段拒绝、同一后端 契约的版本变体、RPC 终止原因、权限确认和历史恢复改为命名场景矩阵;86 个共享协议 fixtures 全部保留,按操作及 Control frame 类型注册为 24 个契约测试。合并案例之间复用 原有 hooks,失败后汇总具体案例名称;原有 fragment magic 的预期失败测试独立保留。 全仓 check、506 个 test、DSH bundle 校验与 git diff --check 通过;场景执行器的继续 执行、fixture 重置和失败诊断已烟测,合并前后的场景断言体保持一致。未修改业务代码。

Documentation Rules

  • 调试、验收截图与录屏不提交到仓库;本地留档使用已忽略的 artifacts/ 或 docs/screenshots/。README 使用的 docs/images/ 展示图与应用运行所需图片资源保留。
  • 对外发布说明与新版本 Changelog 只写用户可感知的功能、修复、兼容性变化和贡献者;不附测试数量、构建命令、bundle 校验、未验收清单或构建警告等验证流水账。内部验证结果与边界保留在 AGENTS.md / TODO。
  • README.md:面向用户的默认英文入口,也是 GitHub 默认 README;写项目介绍、特性、安全边界、Plugin/Client 使用和开源 Server 自部署入口。
  • README.en.md:保留的英文入口,与默认 README.md 保持内容一致。
  • README.zh.md:保留的中文入口,与默认 README.md 保持功能和版本信息一致。
  • AGENTS.md:面向编码 Agent,写仓库结构、进度、命令和实现约束。
  • docs/TODO.md:未完成任务与优先级。
  • docs/CHANGELOG.md:版本更新记录。
  • docs/PRIVACY.md:隐私说明。
  • docs/design/PRODUCT.md、docs/design/DESIGN.md:产品定位与界面设计系统。
  • apps/server/README.md、apps/server/README.zh.md:开源自部署 Server 的实际能力、配置、运行方式和验证边界。
  • docs/server.md:完整 Server 项目的产品/功能设计,并说明本仓库自部署版本的范围。
  • docs/plugin-integration.md:Host Plugin 对接 Server 的账号认证、设备认证与凭证状态机,以及最小自部署版本支持的子集。
  • docs/protocol.md:跨仓库协议规范。
  • docs/archive/vibe-coding.md:原始需求背景,当前边界以 README.md、AGENTS.md 和 docs/README.md 为准。

文档发生范围变化时,应同时检查以上入口,避免 README、TODO、设计文档和实际目录互相冲突。

根目录保留中英文 README、AGENTS 和构建、发布所需配置与入口;其他说明文档集中在 docs/,产品设计集中在 docs/design/,原始需求归档到 docs/archive/。移动文档时同步更新相对链接和仓库路径引用。

Authorization recovery (Issue #70)

Plugin 凭据刷新使用跨进程目录锁,获得锁后重新读取凭据;握手被拒绝后最多刷新恢复一次。 4003 映射为 CONNECTION_REPLACED 并停止自动抢占,同机并行 Host 应分别设置 DSH_HOME。 锁不按时间强行抢占;SERVER_CREDENTIALS_BUSY 的异常退出恢复步骤见 README。 核心测试覆盖多进程刷新互斥与鉴权恢复状态机,Windows 双实例实机验证仍待完成。

Native sidebar and development preview (2026-09-20)

开发依赖升级到 Harness 0.2.0-rc.1(同时兼容 0.1.7-rc.1),运行时按能力检测同时支持 ≤0.1.6 的 settings 注册表路径与 0.1.7-rc.1 与 0.2.0-rc.1 的 Volatile entry 路径(typeof settings.register === 'function' 分流)。终端与 loopback 设置只能在 Host 本地修改,settings/update|replace|mutate 禁止远程修改 ds-harness-remote 和 dsh-remote。终端默认开启;loopback 默认无端口。「远程终端」开关切换即保存并立即更新运行时拦截,「保存访问设置」按钮只提交 Loopback 端口(位于端口输入框右侧);两者都无需重启 Host。预览入口位于 Remote Header「预览服务」,第一版限 Desktop / 连接本机 Harness 的浏览器;不把本机预览 URL 作为远程 Web 或 Android 可用地址。跨机、Windows 和真实网络热更新回归仍需另行验证。

Android native tools (2026-09-21)

Android Harness 会话已接入 Files/Terminal:官方 workspaceFiles 目录与分页文本只读预览, terminal 创建/list/follow/retain/write/resize/close;不对 CodeX 投影开放。终端使用本地打包 xterm + react-native-webview,需重新构建 APK。apps/android/scripts/build-terminal.mjs 生成 忽略的 src/generated/terminal-html.ts,prepare:workspace/check 和 CI APK 工作流负责生成。 权限控件兼容旧版 permissions.options 与新版仅 currentValue 的投影,后者调用官方 permissionPresets/catalog(已加入 Host 固定只读 allowlist);Host 插件需同步更新。 核心测试覆盖 catalog 合约与终端输入权/事件顺序/断线不重放。跨机和原生 UI 真机验证仍待完成。

2026-09-22 标题栏入口(Issue #72 PR1):Files/Terminal 入口移到会话标题栏图标,终端面板 标题栏「+」才新建终端(打开只列出现有终端),文件面板刷新与层级返回同样在标题栏;未改 公共 TopBar 契约。

本次本地验证:Android 类型检查与 16 个测试文件 / 174 个测试通过;Plugin 类型检查、 5 个 Host Remote bridge 核心测试及 DSH bundle 校验通过。Plugin 全量测试首次有 5 个超时, 相关 3 个文件串行重跑 42 个测试通过。Hermes 导出初次通过;最终原生 APK 预构建未完成, workspace 全量 check 在 Server web 类型检查处停滞,不作为通过记录。最终 APK 由 CI 构建, 原生键盘、TalkBack 和跨设备行为尚未验证。

Android 只读预览(Issue #72):workspace-file-preview.ts 复用官方 stat/readBytes 和 Office generation/render,校验文件版本、分块、大小和取消;图片上限 8 MiB、PDF 上限 16 MiB,Office 源文件上限 50 MiB。PDF.js 固定版本与 xterm 一起经 build:renderers 本地打包;prepare/check、 CI/release APK 均需生成忽略的 renderer 源文件。PDF 仅单页画布预览,无脚本、外链、导出、 明文文件缓存或文本选择;不增加 Host 端点或写权限。Office 单次调用使用更长客户端超时, Host 限额仍生效。原生真机与真实跨设备文件预览验收尚待完成。

该预览分支的全仓 check/生产 build、Android 197 测试、client-core 38 测试及本地 PDF 浏览器 烟测通过;全仓 test 仍有既有 codex-domain Windows 平台假设的 3 个失败。原生 APK 构建在 Expo CMake/Prefab 的 Windows 超长批处理路径处失败,不能视为已完成 APK 或真机验收。

AGY temporary image attachments (2026-10-07)

按用户 2026-10-07 明确授权,AGY 图片 Prompt 可例外写入 Host 用户 tmp 下的专用私有缓存, 不得写入项目目录或扩展为通用文件上传/写入 RPC。仅接受 PNG/JPEG/WebP/GIF,每张 8 MiB、 每次最多 4 张,缓存总量上限 512 MiB。目录和文件仅 Host 用户可读,随机文件名、按会话隔离, 拒绝路径越界及符号链接。图片保留 24 小时,在后续上传时清理;系统清理 tmp 后无法恢复图片。 AGY 1.3.0 stream-json 仅接受 text,图片通过固定缓存目录的 --add-dir 和 view_file 读取; Remote 历史只恢复该 AGY 会话 transcript 引用且仍有效的缓存图片,不能读任意 Host 文件。 Cursor 保持文字输入;不得把 AGY 图片缓存路径作为 Remote Workspace 展示。

ACP startup isolation (2026-10-07)

ACP 使用 config.acp 后端注册表;当前 gateway 仅实现 Cursor/Antigravity adapter,各自遵循 启用开关和 command/args/cwd,不按可执行文件名选择 adapter,不对明确选择的不可用后端降级。 ACP 后台启动不得阻塞 Harness Remote 注册或 Client 初始化;能力声明表示启用的协议支持, workspaceTypes.available 表示实际就绪。关闭时清理正在启动的进程,禁止迟到初始化重新注册。

ACP Web compatibility and API isolation (2026-10-07)

按用户要求,新增 AGY 工作区保持 Web 客户端兼容。ACP 的 RPC、stream、transfer 和事件 统一保留在独立 agent.acp.* 数据面;不得把 ACP 方法加入 Harness ApiProxy/Typert allowlist 或改变 Codex API。允许 Web/Desktop 用纯客户端内存投影复用原生 UI,不写入 DSH 持久化。 acp/virtual-harness.ts 必须可用于浏览器,禁止依赖 Node filesystem、AGY 数据库或本机 transcript fallback;工作区和历史只从 Host ACP 接口读取。新 AGY 工作区 ID 使用 antigravity:cwd:,ID 生成和 catalog 投影必须显式指定 backend,不得默认生成 Cursor ID。 不兼容旧 AGY 的 cursor:cwd: ID,也不接受无后端前缀的路径作为工作区 ID;Cursor 和 AGY 分别需独立 capability。按用户说明 ACP 尚未使用,不增加旧 ACP 配置或 ID 迁移。含图片历史走有界 ACP transfer。 独立 Remote Web runtime 仍在独立 Server 仓库,本仓库验证不等于跨站点或跨设备验收。

此前兼容边界验证:Plugin/client-core 类型检查、Plugin build、DSH bundle 校验、浏览器 platform bundle 与无 Node globals 的工作区/历史烟测通过;Plugin 相关 49 测试和 client-core 44 测试通过。Plugin 全量为 360/361,通过外的既有 transcript-loader 测试依赖本机数据库并 硬编码 Linux /var/lib/dsh/workspace/ds-harness-remote 路径,在本机 Mac 环境失败;未修改 该 loader 或测试,不将全量 test 记为通过。

0.5.0 审查更新(2026-10-07):上述本机数据库依赖测试已改为隔离 fixture;全仓 check、 test 和生产 build 通过,Plugin 42 文件 / 378 测试、Android 29 文件 / 323 测试、client-core 4 文件 / 52 测试,全仓共 1082 测试。最后的 Desktop 分组与 Android Prompt 订阅修复后, Plugin build / DSH bundle 校验、Android check / 全量 test / Hermes export 再次通过。 审查修复能力与就绪状态判断不一致、AGY 项目 URI 归属、transcript 越界与符号链接、 ACP 启动中关闭及迟到会话结果覆盖。浏览器无 Node globals 的 ACP 工作区 / 历史烟测、 npm 发布入口与 0.5.0 版本一致性校验通过;独立 Server 的 6 项 workspace type 契约测试 通过,Server 当前仍将 Cursor / AGY 标记为缺少 Web adapter。未验证本次 Windows、原生 APK / 真机或 AGY 加密跨设备 E2E。Metro 的 noble/hashes exports fallback 警告仍存在。

Android AGY workspaces (2026-10-07)

Android 从 Host 的 AGY catalog 加载工作区与每目录最近 100 个会话,内存投影不写 DSH SessionStore/Workspace。History 和图片 Prompt 使用有界 ACP transfer;重连恢复历史/stream, 完成回复后刷新标题。新建会话保持空白,不同 Host 的 ACP 内存状态不得互相复用。批量 catalog 请求使用 dsh/sessionList.prewarm=false 避免每个目录启动一个空闲 CLI;选中目录仍可预热。 Android check、286 测试、Hermes export 通过;真实 AGY CLI 的 in-process 恢复测试六项通过, 未验证加密传输、APK 或 Android 真机 UI(本机无设备/Java runtime)。

2026-10-07 Agent 后端设置:CodeX、Cursor、AGY 使用统一后端列表,Kimi 未实现并移除。后端开关保存后热更新对应进程与 capability,不重启 DSH 或关闭 Harness 加密连接;变化后端的流和待审批句柄失效,其他后端进程保留。Android 刷新工作区时重新探测后端就绪状态。

2026-10-07 合并后测试修复:antigravity-transcript-loader.test.ts 的本机数据库与 transcript 依赖已替换为隔离临时 fixtures,移除硬编码 Linux 项目路径及数据为空时跳过断言的行为。 Plugin 类型检查、42 个测试文件 / 372 个测试和 git diff --check 通过;此前记录的该 环境依赖测试失败已修复。此验证不代表 Windows 或真实 AGY 跨设备验收。

Design documentation sync (2026-10-08)

docs/design/ 按当前源码更新,不再使用早期 MVP 草案作为当前边界。CodeX 会话只读文件与终端由 codex-workspace-bridge.ts 基于 Host 验证的 Thread cwd 提供;ACP 只读文件与终端使用独立 dsh/toolCall / tool stream 和 session/backend scope。两者都遵循固定 allowlist、路径/realpath 校验和终端归属/输入权,不扩大 App Server 或 Harness 通用 RPC。上述源码能力不代表已完成 Windows、APK、真机或加密跨设备验收。旧日期的“不对 CodeX 投影开放”记录仅描述当时范围;当前线协议以 docs/protocol.md 为准。

界面设计 docs/design/DESIGN.md 引用 Android 当前 theme 和 App 导航;Files/Terminal 从输入栏「+」的工具访问进入,快捷提示词独立展示,轨迹另有标题栏入口。原始需求归档到 docs/archive/vibe-coding.md,不作为当前实现任务。

Harness 0.2.1 compatibility (2026-10-09)

按用户要求,开发依赖使用 0.2.1-alpha.1,保留上一版 0.2.0-rc.2 / rc.1 的 Typert Session V3;peer range 明确接受 0.2.1 与 0.2.2 预发布版。未来 0.2.2 RC 未发布,不能把范围接纳描述为已完成 runtime 验证。legacy ApiProxy 不再作为兼容维护目标,已有代码/历史类型暂保留;后续新增能力仅使用官方 Typert。

限时问答只使用固定 userQuestions/answer / attachWait 与既有 $events/result,根据官方投影恢复 continued 问题;断线释放 claim,不重放回答。可选 Mods 只开放官方 watchBand / pressBand。Web SSE 使用文档相对地址以保留代理前缀。真实跨设备、Android 原生 UI 与真实代理验收仍需另行验证。

本轮验证:全仓 check/test 与生产 build 通过,最终问答状态改动后 client-core 38、Android 88 个测试再次通过;Plugin 250 个测试与 DSH bundle 校验通过。官方 0.2.0-rc.2 / 0.2.1-alpha.1 Gateway 包的事件流、取消、目标切换和断线 fail-closed 烟测通过。该烟测不等于完整 Desktop / Android 跨设备 E2E。Metro noble/hashes exports fallback 警告仍存在。

CodeX / ACP terminal controller (2026-10-15)

按用户授权,CodeX / ACP 共用 remote-terminal-controller.ts,参考官方 TerminalController 的终端语义, 不创建 Harness Agent 或 SessionStore 记录。workspace-bridge.ts 仅负责可信 session/cwd 与只读文件 scope; 终端通过 remote-terminal-provider.ts 使用 Host subprocess 的默认 shell 探测、可执行文件验证、PTY、 可用的 shell activity 与进程范围清理。普通 shell 使用 -i、PowerShell 使用 -NoLogo,选定 shell 必须 来自验证后的候选列表;无 discovery 的旧本地 provider 只验证默认 shell。无 subprocess 的 pipe 兼容路径 不支持 PTY resize/job control,其清理只覆盖直接 shell;完整进程范围清理由 subprocess provider 负责。

Host xterm headless 保存屏幕并序列化重连快照:scrollback 1000 行,快照最多 256 KiB,可缩减历史行; follower JSON 队列最多 1 MiB,超限显式失败,重连恢复屏幕而不重放输入。每会话 8 个、每领域 256 个 保留/启动中终端;创建对活动 ID 幂等,关闭中取消迟到分配,已提交终端与请求超时/连接生命周期分离。 设备归属和 attachment 输入权保留,终端各 scope 必须一致;新 follower 或断开释放旧输入权。 无 hold/follower 且持续两小时明确 idle 才回收,busy/unknown 或观测间隔过长不累计 idle。 后端重配/Host 关闭等待进程清理,失败时保留关闭中的归属并重试;清理成功释放设备配额,迟到 RPC 不能释放新一代归属。终端输出与屏幕不写日志或持久化。

本轮 Plugin check、46 文件 / 296 个测试、build、DSH bundle 校验与根 GitHub 入口加载通过。 使用发布版 dsh-subprocess-local@0.2.1-alpha.1 的 macOS 真 PTY 烟测通过:zsh 交互启动、 创建请求取消后继续运行、resize、断开拒绝旧输入、重连屏幕恢复和等待清理;该本机烟测不等于 Desktop / Android 加密跨设备 E2E、Windows/Linux PTY 或真实两小时闲置验收。

2026-10-15 review 修复:分配提交后的请求取消仍返回创建成功,保留终端与设备 claim;输入/resize 同时校验当前 follower 属于调用连接,断开也撤销尚未完成的 follow。ACP 重配保留未完成清理状态, 终端清理失败仍尝试停止所有变化后端;再次保存相同设置可重试,清理成功前相关后端禁止 RPC/启动, 其余后端保持可用。Plugin check、46 文件 / 299 个测试与 build 通过;新增核心场景覆盖取消提交点、 attachment ID 跨连接复用、pending follow 断开,以及终端/后端清理失败后同配置重试。

Claude ACP Host 与单次工具审批(Issue #125)

claude 默认关闭,使用 claude-agent-acp、空参数;不发送 Cursor 专属认证。初始仅实现 Host 接入;2026-10-18 补齐客户端工作区/历史与模型投影,见下文。真实 @agentclientprotocol/claude-agent-acp@0.91.0 使用已有兼容端点、私有 credential command 和 gpt-6-sol 在隔离临时目录通过初始化、对话及 Gateway Write 工具审批;这不代表 Anthropic Claude 模型或加密跨设备验收。

ACP permission response 仅允许 allow-once | reject-once | cancel,禁止 allow-always 和任意 permission result。必须按请求 options.kind 的单次选项映射真实 optionId,Claude 拒绝 ID 为 reject,不能硬编码 reject-once。句柄绑定连接/session/backend/进程实例;无主/未知请求不广播,上游不能覆盖 Host scope,非法响应不消费合法句柄。真实 Gateway 已验证拒绝不写文件、允许一次成功、同会话下一工具重新审批,以及跨连接/持久授权/result 越权/重放拒绝。断线与重配边界另有核心自动化覆盖;跨设备仍待验收。

Claude Host 中断/history 补齐:标准无 ID 的 session/cancel,撤销对应 session/backend 审批并拒绝迟到请求,不影响其他会话。目录/会话通过上游 session/list + Host realpath authority 发现,显式 backend 的 load 不接受 Client cwd;Claude 活动回复中 load 拒绝,history 使用独立临时 adapter,不读取私有 transcript。最多 30 个 live/loading Session,一个 history reader;8 MiB / 10,000 更新超限显式失败,重复 load 不重放污染 live。真实 Gateway 验证待审批 Write cancel 后无文件/旧句柄失效、Bash 运行中 history 不打断工具而后 cancel 返回 cancelled,以及整个 Gateway/adapter 重启后 history/上下文继续对话。未知时间为 0、稳定投影 ID,不宣称无损恢复上游未提供的元数据。客户端工作区与历史展示、重连 UI、Windows/APK/真机/加密跨设备仍未完成。

Pi Agent ACP(Issue #97)

Pi 后端 ID 为 pi,默认自动检测并初始化,命令 pi-acp、参数 [];pi 自身 RPC 不是 ACP。 未安装或初始化失败时不可用,不影响其他后端;明确的 enabled: false 和 ACP 总开关优先。 使用独立 agent.acp.pi.v1、pi:cwd: 工作区和 pi: 内存会话投影。Host 通过标准 ACP session/list 获取目录 authority,load/history 使用 Host 验证的真实 cwd。每活动会话 独立 wrapper,history 临时 wrapper 不得打断当前回复。最多 30 个保留会话,另有 catalog 和一个 history 槽;历史限 8 MiB / 10,000 更新,超限显式失败。模型/Thinking 来自上游 models/modes/configOptions;仅使用固定 session/set_config_option(model/thought_level) 并以响应/通知确认状态,不乐观伪造。首版仅文本,Pi 工具以 Host 用户权限执行。

本机安装 Pi 1.3.0、pi-acp 0.0.34,使用已有 OpenAI 兼容配置验证 CLI 对话、真实 Gateway 流式工具回复、历史、重启恢复、模型/Thinking、工具执行期间断线继续和中断。全仓 check、 703 tests、生产 build、DSH bundle 校验及 diff check 通过;Plugin 48 文件 / 315 tests、 Android 19 文件 / 101 tests。仍未验证 Windows、Android APK/原生真机、独立 Remote Web 及加密跨设备 E2E。Metro noble/hashes exports fallback 警告保留。

Pi 审批/历史复核:Pi 默认不逐工具审批,Host 扩展的 tool_call + ctx.ui.confirm 才映射标准 session/request_permission。真实 Gateway + Pi + gpt-6-sol 工具调用验证拒绝 不执行、单次允许仅执行一次且两种决定均自然结束;跨连接抢答不消费句柄,断线不放行且 旧句柄不能重放。真实 Gateway → ACP Client transfer → Desktop 内存投影验证实时 read/bash 输出及 write diff、进程重启后的文本/工具历史、分页与继续对话。目录/历史错误不得伪装成功的空结果, 同会话并发历史读取合并;工具结果保留输出/错误与 diff,Pi bash 实时预览超限明确提示。 Android 保留 Pi terminal 增量输出、退出失败状态和审批详情,并验证 Host 历史接入恢复, 不代表原生 UI 或跨设备通过。pi-acp@0.0.34 load 不提供原始 thinking、工具输入、消息 ID/时间;使用稳定投影 ID 与未知时间 0,不宣称无损历史恢复。

ACP 恢复审查修复:Pi 初次 load 的文本/思考/tool 回放不得进入 live,只合并匹配会话的 模型/Thinking 配置;load 期间 callback 拒绝,成功提交后才启用 live/审批。Android Pi/AGY 新订阅隔离旧展示缓存,历史返回后保留本次 live 和完成 catch-up;无共同 cursor 时仅用 共享 ID/工具调用锚点做边界去重,不因相同短文本误删独立回复。Claude/Pi catalog 与缓存 cwd 校验捕获后端实例,在异步操作后验证其仍有效,重配/禁用/关闭后的迟到结果明确失败, 不可重建已清理的 authority。核心测试覆盖这些恢复/代际竞态;不新增真机或跨设备验收声明。

Harness 0.2.1 RC compatibility (2026-10-17)

开发依赖升级到 0.2.1-rc.1 与 Cordis 4.0.5,源码对照同级 Harness 仓库的 dsh-v0.2.1-rc.1 tag。已认证连接各自创建并释放官方 owner Peer,RPC/stream/事件回复与 Fetch 路由共用该连接的 Peer,不使用共享 browser Peer,固定 allowlist 增加只读 remoteAccess/follow。终端保持既有 Remote follow/write/resize 协议,在两端本地对接官方 attach 双向流,按 Host ack 确认,保留有界队列、设备归属与断线不重放。CodeX/ACP 保留独立 数据面;session/projections 返回各自历史/内存的 sequenced 投影,不进入 Harness 持久化。 RC.1 官方 Gateway/Peer 与核心终端回归、全仓 check/test、生产 build/Hermes 和 DSH bundle 校验通过;Plugin 最终 52 文件/349 测试。跨设备、Desktop UI、Android APK/原生真机与独立 Remote Web 尚未验收,详见 docs/compatibility.zh.md 与 docs/TODO.md。

2026-10-17 启动兼容修复(未发布):RemoteTypertGateway 为旧 Host 返回的 ui-theme 视图补齐 RC.1 所需的缺失字体默认值,避免官方 ThemeRuntime 在 undefined.split 处初始化 失败并阻塞界面。只处理 describe 和成功写入返回值;不修改 Host schema、revision、用户 配置或拒绝结果。已用安装版官方 RC.1 bundle 复现并验证初始化修复,Plugin check/build、 20 个相关 Gateway 测试与 bundle 校验通过;未增加纯展示测试,真实跨设备恢复仍待验收。

ACP model selection audit (2026-10-18)

Pi 显示名统一为 Pi,后端 ID 保留 pi。OpenCode 从真实 ACP session new/load 的 configOptions 或 legacy models 获取模型,按会话保存状态;固定 model/effort config key 或 legacy set_model 切换,禁止写死目录、全局 selectedModel 或吞掉上游失败。首次 load 不把历史回放注入 live,重复 load 不打断回复。Pi/AGY/OpenCode Desktop 投影仅提交 Host 确认的选择;Android 补齐 AGY 模型/思考强度并复用 ACP 模型解析。Cursor 的本地假模型 选项已移除;随后 Cursor/Claude 已接入同一模型契约。OpenCode 1.19.3 隔离 CLI 验证 读取 42 个模型并成功切换(未发送 Prompt);此验证不等于 APK/真机或加密跨设备验收。

Cursor/Claude 使用共享 session model state 读取现代 configOptions 或 legacy models, 只调用固定 model/effort key,拒绝回复中切换。Cursor 上游模型管理器为进程全局, 因此与 Pi 共用隔离 wrapper,每个会话独立进程(最多 30 个活动会话)。Claude 保持其 每会话状态及重复 load 去重;恢复 Prompt 前加载 catalog 确认的 cwd,准备期间取消与 重试按任务身份隔离。Desktop/Android 增加 Claude 工作区/历史/文字会话及模型入口, 显示名为 Claude,后端 ID 为 claude;不开通 Claude 图片;Claude/Hermes Files/Terminal 复用共享工作区桥接,不扩展 Harness/Codex RPC。

本轮真实 claude-agent-acp@0.93.0 模型烟测读取 5 个选项并确认切换(未发送 Prompt)。 Cursor 2026.10.16-e3cb207 在本机初始化超时,真实 CLI 模型切换未验收;不将模拟 契约测试等同于 Cursor 实机、APK/真机或加密跨设备验证。

本轮验证:全仓 check、Plugin 52 文件 / 353 测试(串行)、Android 23 文件 / 131 测试、 client-core 与 protocol 测试及 Android Hermes export 通过。Plugin 并发运行曾出现 Control 超时及文件监听时序失败,串行全量通过;Metro noble/hashes exports fallback 警告仍存在。上述检查不等于原生 APK 或跨设备验收。

OpenCode native archive (2026-10-18)

按用户明确要求,OpenCode 归档直接调用同一个 opencode acp 进程自带的认证 loopback HTTP API,仅允许经 Host catalog/realpath 验证会话的 GET 与 PATCH time.archived。 这是限定的原生会话元数据写入,不开放通用 HTTP、数据库写入、删除或文件写入 RPC。 强制 127.0.0.1、临时端口、关闭 mDNS 和每进程随机认证;关闭进程时中止请求。 独立 capability agent.acp.opencode.archive.v1、ACP 扩展 dsh/sessionArchive 及目录事件 agent.acp.catalog.changed 只服务 OpenCode。原生确认后客户端更新投影,状态由 OpenCode 持久保存,不建立 Host 归档索引;其他 ACP 后端不能返回本地伪归档成功。 归档与加载/Prompt/模型写入/审批互斥,历史读取不抢 owner;不提供恢复归档或已归档列表。 真实 v1.19.3 隔离临时目录验证了原生确认、跨连接、幂等、重启隐藏及历史读取;Windows、 APK/真机、跨设备和独立 Remote Web 尚未验收。详细边界见 docs/design/acp-session-archive.md。 本次 Plugin check/build、359 个测试、client-core 41 个测试、Protocol 78 个测试、Android check/132 个测试及 Hermes export、DSH bundle 校验通过;Metro 的 noble/hashes exports fallback 警告仍存在。

Android screen rotation (2026-10-18)

Android 不再锁定竖屏:apps/android/app.json 的 orientation 改为 default(Expo 对 Android 生成 android:screenOrientation="unspecified",跟随系统自动旋转;不引入 expo-screen-orientation 运行时锁定)。apps/android/src/ui/responsive.ts 统一提供 useResponsiveLayout()(landscape、compactHeight、contentMaxWidth、 sheetMaxHeight)与 modalSheetMaxHeight()。

布局适配:聊天消息、输入栏和轨迹页在宽窗口使用居中的 760 dp 可读列;底部弹层最大高度按 当前窗口计算(窗口高度低于 520 dp 时为约 92%,否则 70%),picker/侧栏列表的 flexShrink 与最大高度一起保证页脚按钮可见;「+」菜单、工作区新建/重命名/操作对话框、 设备重命名、Home 菜单和目录浏览器改为可滚动 body;横屏/短窗口压缩输入栏、隐藏隐私提示, IME inset 在窗口尺寸变化后重新读取 Keyboard.metrics(),避免沿用旧朝向的键盘坐标。 工具面板(Files/Terminal/PDF)与 xterm/PDF renderer 依赖 WebView 自身 resize 回调,未改协议。

验证:pnpm --filter @dsh-remote/android check(renderer 生成 + workspace data-plane 校验 + tsc --noEmit)、23 文件 / 132 测试、git diff --check 通过。使用本机 Android 15 (Mi MIX 3,1080×2340)安装 arm64 release APK 后真机烟测:设备列表、工作区、Chat 欢迎页、 「+」菜单、工作区选择器、会话信息、设备详情/重命名、Home 菜单、设置、会话侧栏、轨迹、Files 面板在竖屏与横屏往返切换后均可用;横屏 Gboard 走系统全屏输入编辑界面,未验证普通内联 IME 布局。未验证平板、折叠屏/分屏、大字体、TalkBack、Terminal/PDF 原生交互及 iOS 旋转布局 (该改动同时解除 iOS 方向锁定,需另行验收)。

Android QR sign-in (2026-10-18)

Android 登录页新增「扫码登录」点击入口:RemoteServerApi.oauthProviders() 使用 Server 返回的 /api/v1/auth/oauth/providers(404 时回退旧的 per-provider status 接口),只接受同源 /api/v1/auth/ 入口;只有用户点击入口后才请求 provider 并展示二维码,不在登录页加载时 自动创建会话。startOAuthQrLogin 校验 qrId、expiresIn 与同源 scanUrl, pollOAuthQrLogin 只接受 pending/expired/complete+token。手机与大屏都保留知乎/GitHub 浏览器 OAuth 与邮箱密码登录;大屏使用更大的二维码。二维码由 qrcode-generator 本地生成并通过 react-native-svg 渲染;离开扫码页停止轮询,切换服务地址会使旧会话失效;完成后用一次性 token 注册本机设备并复用现有 LoginFlow。领取到 complete 后立即停止轮询;注册与页面跳转不依赖会随 store/父组件渲染变化的 effect 依赖,避免已消费的一次性 token 被再次轮询判为过期后覆盖成功状态。 token 与二维码内容不写日志。

验证:Android check、24 文件 / 136 测试(含 QR provider/start/poll 同源与状态矩阵)、 tsc --noEmit 通过;真实 Server dsh.r2049.cn 的 providers、QR start 与 poll 合约已用 curl 核对。本轮未完成大屏真机 UI 扫码端到端验收。

Android tablet split view (2026-10-18)

聊天页在宽度 ≥760 dp 且(高度 ≥520 dp 或宽度 ≥1000 dp)时启用双栏:左侧复用 HostSessionsDrawer 的 inline 模式常驻会话列表(当前工作/工作区/其他对话分组、刷新与 分页),右侧保留聊天头部、消息列表与输入栏。左栏切换会话只更新右侧内容,不离开聊天; 左栏头部返回按钮回到工作区,右侧会话头部不显示返回箭头(轨迹视图也由右侧操作图标关闭)。 窄屏和横屏手机仍为单栏,HostSessionsDrawer 的 Modal 模式不变。 模拟 800×1280 dp 窗口的真机烟测通过:进入会话、左栏切换“新对话”、左栏返回工作区、 恢复窄屏后回到单栏;真实平板/折叠屏、分屏、大字体与 TalkBack 尚未验收。

OpenCode ACP CLI option compatibility (2026-10-18)

OpenCode 启动先读取同一配置命令的 --help,按参数能力分流,不按主版本号猜测。 同时支持 hostname/port/mdns 时保留强制 127.0.0.1、临时端口、关闭 mDNS 和随机认证; 三者均不支持时移除旧网络参数,以纯 stdio ACP 提供目录、历史和对话,原生归档明确返回 OPENCODE_ARCHIVE_UNAVAILABLE,不访问未启动的 HTTP listener。部分支持、检测失败或 输出超限时拒绝启动;检测有超时且后端关闭时立即取消,不记录 CLI 输出。

验证:Plugin check、53 文件 / 373 测试(串行)、共享包及 Plugin build、DSH bundle 校验、 git diff --check 通过。隔离进程契约覆盖两种 CLI、私有监听/认证、失败/超限与关闭清理; 真实官方 OpenCode 1.19.3 的初始化、新建、目录、原生归档、归档目录与独立历史读取通过, 未发送 Prompt。随后依据官方 https://opencode.ai/v2/docs 确认 v2 使用 @opencode/cli, 不是 v1 的 opencode-ai;补齐 v2 --help, -h 格式解析后,Plugin check/build、相关 9 个 核心测试和 bundle 校验再次通过。真实官方 @opencode/cli-darwin-arm64@2.0.32 已校验 npm integrity 并在临时目录通过初始化、新建、目录、42 个模型与模型切换、独立历史及重启 列表/加载;归档明确不可用。v2 ACP 内部私有服务不开放网络端口,不接入共享后台服务。 两版均未发送 Prompt,不代表 Windows、APK/真机或加密跨设备验收。修复尚未发布。

Web workspace upload (2026-10-18)

按用户本轮明确授权,新增独立 workspace.upload.v1:只允许将文件上传到当前会话的 Host 验证工作区根目录。四个固定 RPC 为 open/chunk/commit/abort;不接受 Client cwd/path, 不扩展通用文件系统、只读预览或后端业务 allowlist。Harness 通过官方 Session V3 Peer 解析 cwd,CodeX/ACP 使用各自可信 session authority;ACP 要求 peer/backend/owner 匹配。 分块与每连接限额、空闲过期、取消/断线清理、排他临时文件和原子无覆盖发布属于该领域。 聊天仍用普通文本路径引用,不新增消息 attachments。协议见 docs/protocol.md 对应章节。 该例外覆盖本文件此前的通用文件写入禁止;不代表发布、部署或跨设备验收完成。

Android foreground connection service audit (2026-10-19)

Android 在异步鉴权前启动连接服务;Expo config plugin 显式声明前台服务、通知与 WAKE_LOCK 权限,Android 13+ 在前台连接时请求通知权限(拒绝不禁止服务,但通知栏隐藏通知)。原生服务 绑定现有 ReactHost 的 Headless JS task,并仅在连接生命周期内持有 PARTIAL_WAKE_LOCK; 断开、启动失败、原生销毁和 React instance invalidate 时释放。原生启动通过 Promise 确认, 服务操作串行且按连接代次隔离,旧失败/关闭回调不能停止替换后的服务。任务等待按原生服务 lifetime 隔离;不重启已被杀死的进程或创建无连接的常驻服务。

回前台使用既有加密 harness.transport.describe 做最多五秒的健康检查;旧 Host 的 METHOD_NOT_FOUND 回包同样证明链路可用。半开或检查中关闭的链路走既有重连/会话恢复, 明确断开后的迟到检查不能恢复设备。需安装重新构建的 APK;该实现不绕过深度 Doze 或厂商 省电限制。验证结果与真机待验收项见 apps/android/README.md 和 docs/TODO.md。

本次 Android check、25 个测试文件 / 140 个测试、arm64 Release APK(含 Kotlin/Hermes)构建 与 git diff --check 通过;Metro noble/hashes exports fallback 警告仍存在。本机无已连接设备, 尚未验证通知授权 UI、后台/息屏心跳、Doze/厂商省电与真实跨设备恢复;未发布新版本。

Android background recovery follow-up (2026-10-19)

加密 Host 链路每 25 秒执行既有 harness.transport.describe(五秒超时);与回前台检查 共享进行中的请求。静默链路按既有 carrier close 转为 offline,后台也启用最多三次恢复。 恢复期间保留既有 FGS/Headless task/wake lock,避免后台重新启动服务受限;失败尝试 只清理 carrier,重试耗尽、初次连接失败、安全拒绝或主动断开才释放服务。通知同步 connecting/connected/reconnecting,不把服务运行等同于 Host 可达。旧连接检查/回调不得 关闭新连接,也不重放 Prompt/审批/终端输入。Android check、26 文件 / 149 tests 与 arm64 Release APK(Kotlin/Hermes)构建通过,Metro noble/hashes exports fallback 警告保留。 已连接小米手机的息屏快照出现 FGS 仍运行而 wake lock 为 DISABLED,厂商省电与长期 息屏恢复仍待验收;不得把该快照直接归因于标准 Doze,或宣称通知代表真实链路存活。

同日已在连接的小米手机覆盖安装;按用户要求保持现有省电设置。约四分钟息屏后 唤醒收到 control-error,约 2.3 秒后恢复新加密连接、connected 通知和聊天,同一进程 存活。息屏期间 wake lock 仍被系统禁用;该轮只验收本次唤醒恢复,不宣称持续联网、 长时间后台稳定性或 Doze/OEM 豁免通过。

后续小米系统日志已明确定位(同日 16:40):息屏约 5.7 秒后,greeze 禁用该 App wake lock,记录 Destroyed live tcp sockets for uids={10440} 与 frozen uid = 10440 reason=screen off,唤醒后才向 JS 投递 control-error。FGS/procState 4 仍被厂商冻结;JS 心跳/恢复不等于息屏持续保活,也不能阻止系统主动销毁 sockets。 用户明确要求保持现有省电设置,不修改白名单或厂商策略;厂商无限制策略的效果尚未验证。

0.5.14 release validation (2026-10-19)

版本统一为 0.5.14,Android versionCode 与 Expo iOS buildNumber 为 58。本地全仓 check、732 tests(Plugin 55 文件 / 393、Android 26 文件 / 149)、生产 build/Hermes、 DSH bundle 与版本一致性校验通过。此前本机测试的 Peer/createPeer 兼容错误来自旧 isolated 安装残留的 workspace node_modules 链接遮蔽当前 hoisted 依赖;移走旧链接并按锁文件安装后 恢复通过,未修改或跳过测试。用户确认本机 Desktop 退出/保存 Server 修复版本可用;新的 APK 与 npm/GitHub Release 发布以工作流实际结果为准,长期后台与跨设备边界仍见 TODO。

Harness workspace directory creation (2026-10-21)

按用户明确授权,已认证 Client 可通过现有官方 workspace/create 请求递归创建缺失的 Host 工作区目录,独立于终端开关,以 Host 用户权限执行。只接受绝对非根路径,拒绝空路径与 NUL;创建与官方注册使用完全相同的路径,不新增通用 filesystem RPC。若官方注册失败, 已创建目录保留,不递归删除。CodeX project/create 仍只注册已有真实目录。

Mobile compact history (2026-10-21)

移动端全局「会话精简模式」默认关闭,持久化并保留退出账号后的选择;清除本地数据恢复关闭。 每次打开会话前,仅对声明 remote.history.compact.v1 的 Host 发送 remote.history.configure { compact: boolean }。旧 Host 保持原有行为,不做手机本地精简。 Host 模式仅属于当前已认证连接,重连重新配置,不修改原始会话、Agent 上下文或其他客户端。 Harness 历史/首帧 snapshot、CodeX 与 ACP 历史(含 transfer)缩减工具参数、输出及展示投影, 保留正文、事件序号、分页、关联与错误状态;实时流和审批不变。切换后重新打开会话加载, 同时失效旧模式的历史分页缓存;CodeX 已有详情句柄继续可用。未进行本次原生真机或跨设备验收。

本次全仓 check、779 tests(Plugin 403、Android 184)、共享包/Plugin build、DSH bundle 校验、 Android production Hermes export 与 diff 检查通过;保留既有 Metro noble/hashes 警告说明。

Native automation task Remote support (2026-10-22)

内置自动化任务沿用官方 Typert carrier,固定放行 schedule/list、catalog、history、update、delete。 更新保留官方 expected record 冲突校验与 session/task 绑定,Remote 不实现第二套调度器或持久化。 schedule/changed 复用官方 $events;创建由会话中的 schedule_create 工具执行,不开放不存在的 schedule/create Remote 端点。该日期仅覆盖原生 Desktop/浏览器界面;2026-10-27 已合并 #176 的 Android 管理页,当前验收缺口见 docs/TODO.md。 本次共享包/Plugin build、Plugin check、三个 carrier/bridge 测试文件 39 tests、DSH bundle 校验和 git diff --check 通过;真实跨设备 UI 和多 Client 变更刷新验收仍待完成,未发布。

Official plugin management (2026-10-22)

按用户要求,Typert 固定 allowlist 增加官方 pluginManager 的 listBundles/listPlugins 与 setBundleEnabled/setPluginEnabled;配置复用既有 settings 通道。启停先核对 Host 官方 inventory,拒绝未知/只读目标及 Remote 自身;禁止 stream 绕过、安装、卸载和任意管理方法。 原生结果直接返回,不伪造热更新成功;此改动不代表跨设备 UI 验收或已发布。

Android DS Bot mode (2026-10-22)

Android 主机工作区「+」左侧进入 Bot;Bot 模式标题栏三点菜单左侧提供工作区切换图标,新建操作收在菜单内,本地导航不修改 Host UI 偏好。Bot 模式的 「+」创建 Bot/群聊。原生团队与专属对话复用官方 Harness 历史和 stream,发送及管理走 现有 plugin.route.call / api/bot 白名单。打开会话先从同 Host 的 Bot state 获取当前 Session ID,再用官方 Session catalog 核对,禁止构造持久化或虚拟 Bot Session。 BotRemoteClient 固定绑定创建时的加密 core/proxy;断线、替换连接和能力撤回均拒绝。 Mutation 不重试,后台停止团队/群聊进度轮询;UI 卡片纯原生声明式渲染,不运行模型代码。 记忆、连接器、凭据、浏览器与本机偏好仍不开放。真机/跨设备验收与其他语言文案见 TODO。

本次 Android 类型检查、32 文件 / 189 tests 与 arm64 Release APK/Hermes 构建通过。 测试保护 Bot operation allowlist、单次审批、当前 Session authority、错误/取消和连接 替换/能力撤回,不增加纯 UI 断言。原生工程重新按当前 0.5.15 / versionCode 59 生成。 后续 Xiaomi 2304FPN6DC 真机检查发现 React Native AbortSignal 不支持 throwIfAborted,已改为检查 aborted 并增加原生 polyfill 取消契约回归。类型检查、14 个 Bot/connection 测试及 arm64 Release 重构建通过,已重装并确认 DSH-046 Bot 列表与 Chief 既有历史加载正常;完整交互验收仍待完成。noble/hashes exports fallback 警告保留。

DS Bot 0.2.1 compatibility (2026-10-24)

固定 api/bot 白名单增加 btw、btw-cancel、room-continue。Android 在普通发送前识别 /btw,空问题/群聊/旧版不支持时拒绝,不退回普通 Prompt;旁问仅来自 state.btwCards 及 earlier.btw,不写入 Harness 历史或本机持久化。群聊继续由 Host 原生操作执行。 原生卡片复用固定版本的上游 schema/公式解释器(apps/android/src/vendor/ds-bot,Apache-2.0), 增加图表与本地计算输入;HTML 仅显示摘要,不执行模型 HTML/脚本。上游文件保持原样并保留 来源/许可证,升级时审查 schema 和解释器边界。真机/跨设备验收见 TODO,未发布。

验证:Android check 与 33 文件 / 195 tests、Plugin check 与 19 个 route 契约测试、共享包/Plugin build、DSH bundle 校验及 Android production Hermes export 通过。保留既有 noble/hashes exports fallback 警告;本机无连接设备,未验证本次 APK/真机、TalkBack 或加密跨设备交互。

0.5.19 release preparation (2026-10-26)

发布候选维持 0.5.19,Android versionCode / Expo iOS buildNumber 均为 64。 中英文发布说明补齐 Android 滚动/阅读密度、CodeX 权限继承、图片预览与 ApiProxy 退役等改动及贡献者;安装入口与 npm README 同步版本。CI/Release 扩展 ZIP 补齐 manifest 所需的 _locales,实际打包核验默认语言、消息键、入口与图标。

全仓 check 与 796 tests 通过(Plugin 57 文件 / 397,Android 36 文件 / 207), 串行生产 build(Android Hermes,包含 CI 固定哈希的 Intelligent UI renderer)、 版本一致性、DSH bundle、根 GitHub 入口加载、npm 实际打包与 diff check 通过。 两份已提交 Plugin bundle 重建无差异;npm 包不含退役 rc.2 模块。 未构建本轮 APK、未新增原生真机、Windows/Linux helper 或加密跨设备验收。 Metro noble/hashes exports fallback 警告仍存在;发布以 Tag 工作流实际结果为准。

Desktop generation install / packed WebRTC fallback (Issue #149)

基于 @Sandwich-git 的 #151 内联方向,将 werift 从 root/plugin 生产依赖移到 Plugin 开发依赖;Host ESM banner 使用模块局部 createRequire,为内联 CommonJS 的 Node builtin 加载提供 require,不修改全局对象。保留 0.5.19 / Android build 64 发布准备。

node scripts/verify-packed-webrtc.mjs 在仓库构建后分别 pack root GitHub 与 npm Plugin, 安装到临时生产 generation(禁用安装脚本、自动 peer 与原生 optional addon),Host peer 置于独立 installation closure。检查每个生产包的依赖解析路径,故意不放行 builtin id, 覆盖原 buffer 判定失败。此检查复现相关路径约束,不等同于运行真实 Desktop/app.asar 安装器,也不模拟其完整 peer 协商或更新/回滚事务。

子进程先加载未修改的包入口,再通过 Node loader 仅追加内部函数 export,调用同一 packed bundle 中真实 loadNodeRtcFactory / RtcDataChannelTransport;不替换其实现、不导入源码。 阻止外置 werift 和 native addon,验证延迟初始化、首次/并发/缓存加载、有序双向帧及关闭。 CI 在正常 Linux Node 22 环境运行原始脚本。旧 #151 bundle 在同一脚本下首次 fallback 返回 undefined,可检出未绑定 require 的回归。

本地 Node 24 容器禁止 os.networkInterfaces(ERR_SYSTEM_ERROR),但允许真实 loopback UDP;产物烟测以 scratch-only preload 提供 127.0.0.1 枚举 fixture,未 mock WebRTC/UDP。 最终两种 packed 边界通过(GitHub 35 / npm 37 个生产包)。一次 npm loopback 建连曾在 DataChannel 打开前报 RTC_FAILED,原样重跑两种边界均通过,仍需正常 CI 复核稳定性。 标准 Plugin 单测为 393/397:两项因网卡枚举失败,另两项 native/default backend 八秒 建连超时,不算全量通过,也不把后两项的具体根因当作已确认。 Plugin check、共享包/Plugin build、DSH bundle 校验、生产重建哈希一致性和 diff check 通过。真实 Desktop 更新/回滚、Windows/Electron 与跨设备 E2E 未新增验收。 旧 generation 的依赖树不会被新插件重写;恢复旧包仍需要宿主正确识别 builtin 或使用 官方插件管理恢复路径,不能宣称本修复覆盖所有历史回滚。

Desktop signed-out account recovery (2026-10-26)

Client 的 loopback control 错误必须保留 details.remoteCode(优先)及外层 code, 不能仅转成普通 Error 文案,否则未登录/授权失效会被当作临时网络失败,重新打开 Remote 仍展示空主机列表与退出账号,而不显示登录入口。保持 Host 设备发现的授权拦截。 既有核心授权矩阵补齐未登录/无归属,并贯通真实 control envelope 到 Client 解码。 共享包及 Plugin build、Plugin check、相关 26 tests、DSH bundle 与 diff check 通过。 本机当前窗口可显示登录页;未执行完整 Desktop 退出重启或重新登录的跨设备验收。

未登录的插件设置页提供「登录账号」,通过同一插件实例的回调打开已有 Remote 登录窗口; Server 地址未保存时提示先保存并禁用入口。0.5.20 Plugin check/build、DSH bundle 与 diff check 通过;隔离浏览器加载真实 client bundle 验证入口打开登录页及地址草稿的禁用/恢复。 纯 UI 不新增自动化测试,未完成真实账号重新登录或 Desktop 重启验收。

Post-merge 0.5.20 rebuild (2026-10-27)

合并 #172、#174、#175、#176,并保留本地 Desktop 登录修复后重新构建;版本维持 0.5.20,Android versionCode / Expo iOS buildNumber 为 65。共享包和 Plugin build、全仓 check、847 tests(Plugin 404、Android 250)、串行生产 build(包含 Android Hermes)通过。Android 使用 CI 固定提交及文件哈希的 Intelligent UI renderer。 两份已提交 Plugin bundle 重建无差异,普通与生产构建 SHA256 一致;DSH bundle、 根 GitHub 入口加载、npm 实际打包、浏览器扩展 ZIP 与 diff check 通过。

GitHub/npm packed WebRTC 的生产依赖闭包、原生不可用时的回退及双向 DataChannel 校验通过。macOS 默认临时目录 /var 与 realpath /private/var 的差异会触发既有 校验脚本的路径边界误判,本轮使用规范化的 TMPDIR=/private/tmp 运行原脚本通过。 产物与日志保留在忽略的 artifacts/rebuild-0.5.20/;未新增 APK、原生真机或跨设备 验收,未发布 npm/Tag/Release。Metro noble/hashes exports fallback 警告仍存在。

Remote Agent tools (2026-10-27)

从独立功能分支选择性恢复 Remote Tools 至 main;不引入 @ 主机补全、mention control endpoints、派发或自动导航。通过官方 tools 服务注册 Host/Workspace 发现及 Harness 会话 list/read/create/send/wait/interrupt/operation 工具,复用账户授权、identity 固定及加密 carrier;CodeX/ACP 仅发现工作区。UI 已连接同一 Host 时复用连接,否则使用查询生命周期内的临时连接,不改变 UI 选择。操作回执仅内存保存,未知投递不得自动重发。保留主线 ClientReconnect 状态机。

本轮 Plugin check、61 文件 / 417 tests、Plugin build、DSH bundle 校验与 git diff --check 通过。未进行本轮真实跨设备 E2E 或全仓构建。

Remote Tools 文件下载:remote_download_file 只读官方 workspaceFiles/stat/readBytes,先校验 Harness workspace/session 归属,拒绝绝对路径与父级越界。固定最大 50 MiB / 分块 256 KiB,校验版本、大小、offset/eof,取消/失败删除临时下载目录。本机 Downloads/dsh-remote-* 私有独立目录保存,不覆盖文件,不把内容放入工具返回。此本机下载写入按本轮用户明确要求实现,不增加 Host 写入权限。

Remote upload tool (2026-10-27):remote_upload_file 仅支持 Harness,先验证 Host/workspace/session 归属,再读取插件运行机器的绝对 localPath,拒绝最终路径符号链接和非普通文件。沿用 workspace.upload.open/chunk/commit/abort 专用上传协议、20 MiB / 64 KiB 上限与 Host 不覆盖发布规则。使用 operationId 内存回执去重,提交结果不确定返回 unknown,不自动重发。返回路径与元数据,不返回文件内容。不增加通用 Host filesystem RPC。

Remote Tools 大文件上传:实际 LAN / 直连 P2P 最大 1 GiB(1024³ bytes),TURN / Relay / unknown 保持 20 MiB;Host 从认证 channel.mode 的动态 getter 取得路径,open/chunk/commit 复查,回退中继后拒绝大文件并清理临时数据;Client 同步检查 getStats().mode。64 KiB 分块不变,工具总超时 1 小时。旧 Host 仍可能按 20 MiB 拒绝。下载限额未调整。

First-install Remote authorization view (2026-10-27)

Remote 窗口先通过 loopback client.authorization.status 只读检查本地 Client 凭据, 不刷新凭据、不注册设备、不发起 Server 请求。无凭据显示登录;有凭据再发现 Host, 成功后展示列表。首次检查期间保持未决状态;网络或本地读取失败展示错误并允许刷新, 保留已知列表,不将失败解释为退出登录;明确授权错误码才回登录。空主机文案仅用于 成功的空列表,不用于请求失败。Plugin check、client-runtime 17 个核心测试、build、 DSH bundle 与 diff check 通过;未新增 Windows 首次安装或跨设备验收。

DSH-Go pairing v1 (2026-11-08)

The local Remote settings support Host QR → phone confirmation → one local code submission. No phone code retrieval, CLI confirmation, model tool or tunnel route is added. The exact final request is encrypted with AES-GCM and retained for safe result recovery; retries cannot change its code or submission ID. New paired Hosts retain an inbound-only policy through refresh/logout/restart and cannot create a Client role. Existing credentials preserve their behavior. Strict legacy storage ownership validation now recognizes and validates the pairing records and Host-only policy rather than rejecting them as unknown files.

Validation: 75 plugin test files / 559 tests, source/test typecheck, production bundle build and verify-dsh-plugin passed. The actual C# API/Gateway integration (script scripts/check-device-pairing.ts) verified pairing, independent credentials, restart recovery, Host hello, encrypted Noise/Relay RPC and scoped revocation. The phone is simulated in Node: this is not Dart/Android acceptance. The actual React pairing component was checked in an isolated desktop/narrow preview; not a full Harness UI acceptance. Loopback/isTrusted cannot prove human presence against OS automation; a trusted native user-presence primitive would be required. Protocol and DSH-Go handoff are docs/device-pairing-v1.md and docs/dsh-go-pairing-integration.md. No production deployment/restart or real-user pairing approval was performed.

Pairing sign-in placement (2026-11-08)

DSH-Go pairing lives in the local settings Sign in tab list, alongside existing OAuth/password methods, rather than above general settings. Authorized Hosts retain a pairing shortcut. Provider-loading failures do not reset a manually selected pairing tab; switching/closing the panel does not cancel the Server session or reopen its single attempt.

更新后存储迁移与登录回退(2026-11-10)

本次修复来自用户更新后的 macOS 实际故障:Finder 的 .DS_Store 导致旧存储归属检查失败; 可选 OAuth 发现失败后,登录入口显示错误或隐藏默认密码表单。 归属检查与未配对 Client 自愈仅忽略 .DS_Store、desktop.ini、Thumbs.db 的普通文件, 保留链接数及大小限制,Windows 元文件匹配兼容大小写。目录、符号链接、硬链接、未知名称 及任意 ._* 名称保持原检查;idle 与锁规则保持原样。迁移保留元文件和身份数据。 两处登录入口在发现失败后保持密码表单与重试入口可见,保留已手选配对方式; 更换服务地址时清除旧配对能力。密码提交继续显示真实认证及网络错误。 API 超时与错误契约保持原样;该 UI 修复没有改变 CDN/TLS 连接行为。 验证记录以 PR 所列平台运行结果为准,避免将 macOS 文件名测试等同于 Windows 实机验证。