diff --git a/AGENTS.md b/AGENTS.md index c251bff..ed0f7bd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,1209 +1,166 @@ # Repository Guide for Agents -## Android coherent transitions (Issue #8, 2026-11-12) +定义编码 Agent 在本仓库工作的边界、结构、门禁、架构不变量、测试与文档规范。 -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...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-.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/渐变提升到 `` 且其子树写完整样式。 -含 `foreignObject` 的图(journey)只走全屏查看:Modal 中 `javaScriptEnabled={false}` 的 -WebView 以 `` 显示原始 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`。 +- **版本与依赖**:不硬编码版本或构建号,以根及各包 `package.json`、`dsh-plugin.json`、`apps/android/app.json` 与 `pnpm-lock.yaml` 为准。 +- **兼容与待办**:兼容基线见 [compatibility.zh.md](docs/compatibility.zh.md)([EN](docs/compatibility.md));待办与限制见 [TODO.md](docs/TODO.md)。 +- **协议权威**:线协议以 [protocol.md](docs/protocol.md)、`packages/protocol` 与 `fixtures/` 为准。 ## Repository Boundary -当前仓库实现: +### 已实现 +- `packages/plugin`:DeepSeek Harness Plugin(Remote Host、本地工作区入口、Remote Agent Tools、`ds-harness-remote` CLI;无可见 Client 模式)。 +- `packages/tui` & `packages/tui-plugin`: + - `packages/tui` 为同版本独立发布的 `ds-harness-remote-tui` Host 组合包(装配官方 API 并调 `applyTuiHost`)。 + - `packages/tui-plugin` 为未发布开发与契约校验包。 +- `apps/android`:Expo SDK 57 客户端(官方 Typert、`codex.app.*`、`agent.acp.*`、`plugin.route.call`、9 语言;见 [Android Guide](apps/android/AGENTS.md))。 +- `apps/vscode`:VS Code 扩展 Client。 +- `apps/browser`:Chrome/Edge MV3 启动器(换独立凭据开同源 Remote Web,无登录/传输/会话 UI)。 +- `packages/{protocol,crypto,webrtc,client-core}` & `fixtures/`:共享协议/加密/传输/客户端库与一致性向量。 +- `apps/server`:最小自部署 Server(单账号环境变量、JSON 凭据与 refresh 恢复、Noise/Control 盲转发、可选 WebRTC/TURN、密文 Relay、Web 登录/状态页、Docker/Compose)。 +- `examples/mock-host`:冻结的旧协议互操作工具,不加新功能。 -- 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 会话 UI、Admin 前后端、数据库/migration/队列、K8s/Terraform,及 `apps/server-web`、`apps/web` 或空 Web/UI 目录。 +- 禁把 [server.md](docs/server.md) 完整站点设计写为 `apps/server` 已实现能力(须保留该文档与 `protocol.md`)。 -当前仓库禁止实现: - -- 完整多账号 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 +## Project Structure & Packaging Boundaries ```text -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 设计与互操作契约、自部署版本范围入口 +apps/ android/ browser/ server/ vscode/ +packages/ plugin/ tui/ tui-plugin/ protocol/ crypto/ webrtc/ client-core/ +examples/ mock-host/ +fixtures/ crypto/ pairing/ protocol/ +scripts/ install.sh、bundle/WebRTC/场景/基准校验 +docs/ README.md、protocol.md、compatibility*.md、TODO.md、CHANGELOG.md、design/ ``` -仓库根包同时是 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` 是需要提交的发布入口。 +- **同名包过滤**:`packages/tui`(无 `scripts`)与 `packages/tui-plugin`(`test` 跑 `packages/tui-plugin/scripts/verify-bundle.mjs` 校验 16 个 `@deepseek-ai/*` 固定版本与 `inject` 契约)同名 `ds-harness-remote-tui`,`pnpm --filter` 须用 `./packages/tui` 或 `./packages/tui-plugin`。 +- **根包边界**: + - 根 `package.json` 与 `dsh-plugin.json` 为 DSH Desktop GitHub 安装边界,须留 `dsh.bundle.patch`、Host/Client `exports`、CLI `bin` 与根 `cordis.patch.yml`。 + - **根 `package.json` 严禁设 `scripts`、`private: true` 或 `repository.directory`**。 +- **npm 发布**:仅由 Release 在 `packages/plugin` 执行(校验五处版本及 `versionCode === buildNumber` 一致),禁根目录 `npm publish`。 +- **提交产物**: + - Git 仅允许提交 `packages/plugin/dist/{index,client.github}.js`(另留 `index.js`、`packages/plugin/bin/ds-harness-remote.js`;`client.js` 忽略但 `verify-dsh-plugin.mjs` 会校验)。 + - `locale/README.*.md` 与 `packages/plugin/locale/README.*.md` 须保持字节一致。 +- **Host 内联闭包**: + - 内联全部运行时依赖(`ws`、`qrcode`、`schemastery`、`werift`;`werift` 置 `devDependencies`,ESM banner 用局部 `createRequire` 禁改全局)。 + - 裸 import 仅留 `@deepseek-ai/dsh-client-connection`(及可选 `@roamhq/wrtc`)。 + - esbuild 统一模块路径标签;改插件或共享包后必过 [verify-dsh-plugin.mjs](scripts/verify-dsh-plugin.mjs)、[verify-packed-webrtc.mjs](scripts/verify-packed-webrtc.mjs) 与 `git diff --exit-code`。 -根包不标记 `private: true`,兼容仅读取根清单、遇到 private 就跳过 npm 查询的插件索引。 -根包与 npm 包保持相同 name/version,但安装入口布局不同;npm 发布仍只能由 release -workflow 在 `packages/plugin` 执行,不在仓库根目录运行 `npm publish`。 -实际发布包通过标准 `repository.directory: "packages/plugin"` 标明源码位置, -根包的 repository 不带 directory,以保持 GitHub 安装入口语义。 +## Development & Verification -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。 +环境:Node.js `>=24.9`、`pnpm@9.15.4`(Android 原生另需 JDK 17 与 Android SDK)。 ```bash -pnpm install +pnpm install --frozen-lockfile 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 +node scripts/verify-packed-webrtc.mjs +git diff --exit-code -- packages/plugin/dist/index.js packages/plugin/dist/client.github.js ``` -全仓 build 必须使用 `--workspace-concurrency=1`:Android prebuild 会再次编译共享包, -并发执行可能让 Plugin bundler 读到正在重写的 dist 文件。 +- Fresh clone 先建 `./packages/**`;全仓生产构建必加 `--workspace-concurrency=1`(防 Android prebuild 与 Plugin 打包并发竞争)。 +- `apps/server` 独立验证前先建 `@dsh-remote/protocol`,禁交 `apps/server/data/` 与 `.env`。 +- `apps/android` 的 `check`/`test` 会执行 `build:renderers` 写忽略目录 `src/generated/`。 +- 安装入口仅维护 [install.sh](scripts/install.sh)(无 Windows 或自动卸载脚本): + - macOS 非 root 复用 Desktop launcher 或 CLI,不装服务。 + - Linux 需 root,管 `/opt/ds-harness-remote` 与 `ds-harness-remote-.service`;遇运行/启用中的旧归属服务拒绝继续,不碰未知服务与系统 Node/PATH,且须明示终端具备 root 权限。 -先构建 `packages/**`,确保 workspace package 从 fresh clone 开始也能解析 `dist` 类型。根 `package.json` 刻意不声明 `scripts`,避免 pnpm 将 DSH Desktop 的 GitHub 安装误判为需要执行构建脚本。 +## Architecture & Implementation Rules -常用命令: +### 1. 线协议、加密与信任边界 +- 线协议以 [protocol.md](docs/protocol.md) 为权威,变更同步 schema、`fixtures/` 与消费端。 +- 业务仅经 `Noise_IK_25519_ChaChaPoly_SHA256` 加密通道(`SecureMessageCodec` 48 KiB 分片 / 4 MiB 上限)传输。 +- 明文、未知 `connection`、错 target、重放与 identity 不匹配均 fail-closed;Server membership 与 Host 本地 trusted peer 须同时成立。 +- `apps/server` 只盲转发(零解密): + - 按配置返回 `transport.{lan,p2p,turn,relay}` 交集,每连接 ≤256 ICE,建链后忽略迟到信令。 + - `DSH_SERVER_TURN_URLS` 与 `DSH_SERVER_TURN_SECRET` 须成对配置并签短期 coturn HMAC 凭据。 + - refresh 丢响应恢复以旧 bearer 作 HMAC 密钥派生后继 pair,磁盘仅存摘要与元数据;再次轮换拒祖先且不撤现凭据,损坏返 `503`。 +- `AdaptiveTransport` 仅重试 Server 精确 `4001 / CONNECTION_FAILED` 并重握 Noise。 +- Client GET 遇 `401` 至多刷新重试一次,禁重放 mutation、审批或终端输入。 +- Token、私钥、配对码、二维码、Prompt、源码、隐私路径与工具/终端输出禁写日志。 -```bash -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 -``` +### 2. 网络监听、Loopback 控制与本机自升级 +- Plugin 不监听公网,仅两处受限监听例外: + - Desktop Client 监听 `127.0.0.1` 随机端口承载 `loopback.ports` 预览(Host 只出站连 `127.0.0.1` 白名单,禁公网/任意目标/CONNECT/通用 TCP 转发)。 + - Host `workspace.upload.lan.v1` 仅在本机非回环 RFC1918 IPv4 临时监听,凭 10s 一次性票据升级并绑定 connection/device key/session/upload。 + - LAN 上传 Client 锁死 RTC 选中 IPv4(禁 DNS/公网/loopback),父连接关/替即销毁监听器与临时文件。 +- Host 控制路由限 loopback `/ds-harness-remote`(Web SSE 用相对路径保代理前缀)。 +- `client.authorization.status` 纯只读不刷新不联网;loopback 错误须保留 `details.remoteCode` 与 `code`。 +- `settings/update|replace|mutate` 禁远程改 `ds-harness-remote`/`dsh-remote`;启动仅自动禁用自有 `@dsh-remote/plugin`,严禁误禁他人 `dsh-remote`。 +- 本机版本检查与升级: + - 启用且有 `connection` 时每 24h 并发竞速 `npmjs.org` 与 `npmmirror`。 + - `plugin.update` 仅在 `listBundles` 标 `update: 'registry'`(仅缺 `update` 时兼容 `updatable: true`;禁按 npm source 推断,`'git'` 手动)时,以确认的 `latest` 调 `pluginManager.updateBundle`。 + - 断响应靠轮询 `status`(≤60s / 存活 Host 连续 3 次旧版即停)结算;**加密远程通道严禁停用、卸载或更新 Remote 自身及所属 bundle**。 +- 外部原生 WebRTC 探测必带 `ELECTRON_RUN_AS_NODE=1`,加载前拒绝 Electron。 -Android 不能使用 Expo Go,因为 `react-native-webrtc` 依赖原生模块。 +### 3. 凭据迁移、V2 刷新锁与 DSH-Go 配对 +- 默认凭据根为 `$DSH_HOME/ds-harness-remote`(日志前缀统一 `ds-harness-remote`;自定义 `IdentityStore.directory` 保持原路径)。 +- 目录外 `.ds-harness-remote-migration/` 闸门串行迁移与刷新: + - 迁移前只读全验旧 `remote` 白名单、公私钥、指纹与 scope 哈希。 + - 容忍 `trusted-peers.json...tmp` 及普通 `.DS_Store`/`desktop.ini`/`Thumbs.db`,拒 `._*`、软硬链接与未知文件。 + - rename 失败写 `legacy-root.json` 固定原 `dev/inode` 沿用,禁合并覆盖或另建身份。 +- 刷新用 V2 硬链接 marker + `.holder--` 队列锁(限 Linux 单机 ext4/XFS,不含 NFS/SMB;升/降级前停全部 Harness,见 [plugin-integration.md](docs/plugin-integration.md)),不按时间抢锁。 +- `4003` 映射 `CONNECTION_REPLACED` 并停止抢占。 +- DSH-Go 配对([device-pairing-v1.md](docs/device-pairing-v1.md))限 Host 本地扫码与单次 AES-GCM 提交,持久化 `pairing-host-only.json`(`inbound-only`),禁建 Client 角色。 -开源自部署 Server 的独立验证命令: +### 4. Harness Carrier、路由白名单、受限写入与异步压缩 +- Harness 仅用官方 `TypertGateway` carrier(`0.1.1-rc.2` ApiProxy 已删;共享旧类型仅供独立 VS Code,禁在 Host/Android 重开或另建协议)。 +- 激活备共享 fallback owner Peer,每条已认证连接独占释放独立 owner Peer。 +- `RemoteSnapshotStream` 延后断线错至重连取消点;`RemoteTypertGateway` 为旧 `ui-theme` 补默认字体。 +- `harness.transport.describe` 向 `session/list` 发 `{ args: { __remoteCapabilityProbe: true } }`: + - **仅认 `gateway/arguments-invalid`**(零调用、5s 预算,禁换合法空请求扫库;余错或意外成功均 fail-closed)。 +- `session/list` 超 2,048 行时 Host 只留最新根会话并提升 `projections.values.title`,Client 先过滤再截断。 +- Harness v1 审批限 `allow_once | deny`(禁 `allow_session`);问答限 `userQuestions/answer|attachWait`(断线释 claim)。 +- `packages/plugin/src/plugin-route-bridge.ts` 仅放行 `api/session/uploadFileBinary` 与 `packages/plugin/tests/fixtures/ds-bot-v0.3.6-endpoints.json` 161 端点 + `btw`/`btw-cancel`/`room-continue`: + - 保持 30s 预算与不重放 mutation。 + - 管理/凭据/电脑控制/审批 `choice` 交认证后 DS-Bot handler 校验。 +- 仅五类受限写入例外(禁通用 fs 写或远程桌面 RPC): + 1. `workspace.upload(.lan).v1` 写会话验证根(排他 tmp+`fsync`+原子不覆盖;直连 1 GiB / 中继 20 MiB 动态复检 `channel.mode`;LAN 限 `>=1 MiB`,发 `open` 后禁换通道重放)。 + 2. 官方 `workspace/create` 递归建非根无 NUL 绝对目录。 + 3. AGY 私有 `tmp` 图缓(PNG/JPEG/WebP/GIF,≤4×8 MiB / 总 512 MiB / 24h 清理)。 + 4. OpenCode v1 `--help` 确认后经私有 `127.0.0.1` 认证 HTTP 调 `PATCH time.archived`(纯 stdio/v2 返 `OPENCODE_ARCHIVE_UNAVAILABLE`)。 + 5. Remote Tools `remote_download_file` 写本机独立 `Downloads/dsh-remote-*`(≤50 MiB),操作仅内存去重,`unknown` 禁重发。 +- `remote.history.compact.v1` 按连接配置且不改源记录(`compact-bot-round.ts` 保 `replies` 并标 `truncated: true`,128 Ki 字符预算)。 +- `/compact` 走 `packages/plugin/src/remote-compaction-operations.ts`: + - `(deviceId, sessionId, requestId)` 幂等、同会话单活 `AGENT_BUSY`、全局 ≤32 `RATE_LIMITED`、30m 预算。 + - 取消/超时查 `session/events` 确认,`succeeded` 优先,`unconfirmed` 禁 Client 重提。 -```bash -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。联网历史与原生权限仍是执行依据。 +### 5. CodeX、ACP 多后端与共享远程终端 +- CodeX(`packages/plugin/src/codex/`,`codex.app.*`)与 ACP(`agent.acp.*`:`cursor`/`antigravity`/`pi`/`opencode`/`claude`/`hermes`,见 [acp-remote.md](docs/acp-remote.md)、[codex-remote.md](docs/codex-remote.md))保持独立数据面。 +- UI 仅内存投影(`packages/plugin/src/acp/virtual-harness.ts` 禁 Node/FS 依赖),**禁写 DSH `SessionStore`、Workspace 库或 Harness 日志**。 +- CodeX authority 取 `project/list`(回退 `thread/list` 绝对 `cwd`),`project/create` 仅注册已存在目录(`realpath`)。 +- ACP 边界: + - 强制 `:cwd:` 与 Host `realpath`/catalog 校验,不猜 adapter 不降级。 + - Claude 禁图片;批量 `prewarm=false`。 + - Cursor/Pi 每会话独立进程(≤30 活+1 history,历史 ≤8 MiB/10k 更新);模型/思考用上游确认值禁回复中切。 + - ACP 审批按 `options.kind` 映单次 `optionId`(允许/拒绝/取消),禁 `allow-always`。 +- 共享终端 `packages/plugin/src/remote-terminal-controller.ts` 受 `terminal.enabled` 控制: + - 仅运行验证候选 shell,维护 1,000 行 / ≤256 KiB xterm 快照与 1 MiB 队列(≤8/会话、≤256/域)。 + - 绑设备归属与当前 follower 输入权,2h 明确 idle 回收,重配等清理完再重开。 ## 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 重置和失败诊断已烟测,合并前后的场景断言体保持一致。未修改业务代码。 +- 预算仅限: + - 协议编解码与 schema; + - 身份、加密、篡改与重放; + - 鉴权、配对、锁与迁移; + - RPC 关联、fail-closed、allowlist 与异步压缩; + - 传输切换与重连核心状态机。 +- 纯展示 UI、文案、图标、配色、排版、静态说明与源码字符串匹配不写单测(靠 `check` 与烟测)。 +- 共享实现仅在所属包测一次;Node 不计 Android 原生验证。 +- 多变体合并为隔离命名场景矩阵(如 [test-scenarios.mjs](scripts/test-scenarios.mjs)),失败报具体场景并续跑同组;禁 `skip`/`exclude` 藏测。 ## 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 实机验证。 +- 根目录留 `README.md`(默认英文,不另建独立英文副本)、`README.zh.md`、`README.ja.md`、`AGENTS.md` 与根清单。 +- 专题集中于 [docs/](docs/README.md),设计位于 `docs/design/`(旧归档目录已移除);自部署 Server 实际能力见 [apps/server/README.zh.md](apps/server/README.zh.md)。 +- `docs/TODO.md` 只记待办与已知限制(保留 Metro `@noble/hashes/crypto.js` fallback 待办,未修禁删)。 +- `docs/CHANGELOG.md` 与 Release Notes 只写用户可感知变化与贡献者,不写测试数、构建命令或未验收表。 +- 临时验收、评审、地址、日志、构建哈希、采样与调试/验收截图录屏**禁新增提交入库或堆入 `AGENTS.md`/`docs/`**: + - 复现步骤留测试或 [transport-bench](scripts/transport-bench/README.md);现场结果放 Issue/PR 附件或已忽略 `artifacts/`、`docs/screenshots/`。 + - README 展示图 `docs/images/` 与应用运行资源保留。