简体中文 | English
ZCode Feiyu 是基于 zai-org/ZCode 的社区二次开发版本，保留桌面应用、Web 界面、终端 Agent 和共享运行时，增加本地顶层任务协作、标准／coordinator／swarm 编排、持久项目记忆与自动整理、受控主动工作、统一遥测控制、内置 fal 图片生成，以及用户自行部署的 RCS 远程访问能力。
本仓库由飞鱼同学维护，与官方发行版独立。界面和交互复用 ZCode 现有组件；应用内部名称及本地包名称仍为 ZCode / ZCode Preview。上游基线为 v3.14.3，提交 29628c9acdb81b703bbd4080c207a0e7ce5e276e。以下对比以该公开源码为准，不代表上游未来版本。
优化模型供应商的操作便捷性。
飞鱼版以已交付能力、用户反馈和自己的架构合同作为演进基线。上游设计逐项评估、按需吸收，保留本版的功能、默认开关和权限体验。
- ChatGPT 订阅模型按返回目录提供思考、上下文、输入与速度能力；速度滑块默认标准，只提供目录允许的 Fast / Ultrafast。单／双闪电表示所选速度，成功响应返回的实际档位单独显示。当前实测曾出现请求 Fast、服务端实际标准，不能将图标当作加速成功。
- Teamorouter Responses 支持每模型独立配置 Fast / Ultrafast，设置页显示账户余额与充值入口；推荐说明不代表合作关系。其他供应商沿原有模型与会话流程。
- 增加本机外部会话导入，保留导入来源、附件与历史后续对话边界；导入操作由本机 Desktop 完成。
- 修复订阅 ReadSessionContext 的可选参数适配，保留话题附件校验；未完成响应传递安全原因并保留已返回内容，桌面与 RCS 同步提示。
- 本地桌面新增 MCP Apps UI 插件宿主和 Gen UI：交互页面、内联/展开切换、状态恢复、Tweak、追问、工具/资源交互及取消。
- 改善动态工作流的留白补全、运行设置、进度与日志，增加从运行记录保存工作流；默认开启，用户仍可在设置中关闭或选择按需使用。
- 更新子代理定义与会话恢复衔接，保留标准/coordinator/swarm、顶层任务协作、记忆整理和无累计消费停工的行为。
- 自部署 RCS 继续使用桌面原 Host；Web 同步工作流操作与共享界面。原生页面沙箱仅支持本地桌面，Web/RCS 与远程工作区按平台能力回退。
上述变化属于当前源码；下面的已发布安装包不会自动包含后续源码更新。
2026-10-15 本次仅同步源码与 RCS 配套资源，不发布新 Releases。修复版已在本机保留数据安装，用户自行实测确认可用；本次源码推送不额外声称完成新的真实账号、Windows 安装或公网远控验收。
- 优化实验性电脑控制的多窗口预览、关闭联动与可靠性。
- 改善部分 UI / UX，并同步配套远程界面。
飞鱼版安装包请从 GitHub Releases 下载。本次版本为 v3.14.7-feiyu.1（预发布），应用版本 3.14.7，本次安装名称为 ZCode。安装包从该标签指向的生产提交构建；源码推送不会自动更新已安装应用。
| 平台 | 下载 | 验证与范围 |
|---|---|---|
| macOS Apple Silicon（arm64，macOS 14.4 及以上） | DMG 安装包 · ZIP 压缩包 | 本机原生构建；归档签名、内容及内置 Agent 校验；电脑控制仍为实验性能力。 |
| Windows x64 / arm64 | 本轮不发布 Windows 安装包。 旧版 3.14.4 保留下载。 | 当前源码保留 Windows 适配；完整包需要 Windows SDK/MSVC 构建原生 CUA，并验证凭据保护、记忆、Shell、工具和安装运行。旧包没有本次订阅登录、共享 UI 及后续运行时更新。 |
SHA256SUMS.txt 提供本版 Mac 安装包的 SHA-256。可用 shasum -a 256 <文件> 核对。
- Mac 安装：打开 DMG，将 ZCode 拖入 Applications 后启动；ZIP 用户先解压再复制应用。本版采用 ad-hoc 签名，没有 Apple Developer ID 或公证；如被系统拦截，核对来源和摘要后按照系统设置 → 隐私与安全性的提示处理。
- 旧 Preview 用户：本轮应用名为 ZCode，不会通过改名自动替换旧 ZCode Preview。保留原数据；原生应用目录中的 RCS/系统权限等配置需要在本次应用中检查，不将两种应用身份的凭据文件直接复制。
- 电脑控制授权：设置 → 电脑控制中开启，并授予 macOS 辅助功能与屏幕录制权限。更换本地签名构建后，系统可能要求重新授权。
- Windows 状态：本次没有 Windows 安装/运行实测；Mac 构建、模拟测试及旧包不代表本版 Windows 已验收。共享 UI、模型适配和 Windows 源码继续保留，不因未发安装包移除这些能力。
- 更新：退出应用后用新包覆盖相同应用，保留数据目录。本仓库没有飞鱼版自动更新服务；
git pull不会更新已安装应用。旧版本仍在 Releases 保留。
| 能力 | 官方基线 v3.14.3 | ZCode Feiyu |
|---|---|---|
| Desktop / Web / CLI、Agent 与 V4 | 已有 | 保留并复用 |
| ChatGPT 订阅模型供应 | 没有本版的订阅连接适配 | 官方登录、实时目录、系统保护凭据、刷新及 ZCode 本地工具续接；当前界面支持一个账号和切换登录。 |
| 实验性电脑控制（CUA） | 少量电脑控制布线 | 本机应用观察与操作、系统授权设置、内置插件及控制预览；本次发行包为 Mac arm64 |
| 当前线程编排 | 已有普通子 Agent | 标准模式、coordinator、swarm；请求边界动态切换 |
| 工作区记忆与整理 | 已有会话及上下文基础 | 身份隔离、相关召回、提取/整理、历史、差异及修订保护撤销 |
| 受控主动工作 | 已有任务运行时 | 应用许可加线程启用、事件/计时器准入、暂停及停止 |
| 消费累计执行限制 | 原有执行策略 | 移除累计消费停工；保留用量、压缩、权限与取消 |
| 本地顶层任务应用服务 | 已有底层会话操作，没有本版统一任务工具及服务入口 | 增加发现、创建、读取、发送、回执查询、等待及生命周期控制 |
| 顶层任务 A→B 自动发送 | 已有子代理消息等基础机制 | 同工作区顶层任务互发提示词，忙时优先 guide/steer |
| 自动消息来源提示 | 没有本版来源类型及文案 | 来源随消息持久化，显示“来自zcode其他任务自动发送” |
| 遥测统一设置 | 没有本版贯穿三个出口的总开关 | 统一控制 ARMS、ZCode 事件、桌面及 Agent OTLP 上报 |
| 安装版动态工作流 | Preview 强制开启，Production 受原有门控约束 | Production / Preview 安装版均注入 alwaysOn |
| 本地 Session Mailbox | 需要 ZCODE_MESSAGE_ENABLED=1/true |
默认开启，支持显式关闭 |
| 工作区搜索范围设置 | 页面存在，导航入口隐藏 | 开放入口，继续使用已有 .zcodeignore 能力 |
| fal 内置图片生成 | 没有本版设置、工具和图片作业链路 | 可配置 Key、生成模型和编辑模型，支持加载、保存、预览、恢复和取消 |
| 用户自托管 RCS | 原有手机远控与 SSH 基础 | 独立 Python 桥接、响应式完整共享 Web、现有 Host 附着、公共 API/SDK |
| 远程服务设置 | 原 SSH / 机器人入口 | 第三分组：RCS服务、SSH、移动聊天机器人，复用既有状态与组件 |
| 子代理图片费用控制 | 不适用 | 独立授权开关，默认关闭 |
| 图片参数 | 不适用 | 默认一张 PNG，按模型能力校验显式尺寸、数量和格式 |
这里的“App Server 能力”建立在 ZCode 自有 stdio / V4 / Agent 架构上。它没有内嵌 OpenAI Codex 服务，也不承诺兼容 Codex App Server 的外部协议。已有会话、输入顺序、恢复和图片 artifact 仍由原运行时管理，没有建立平行任务数据库。
打开设置 → 电脑控制，开启功能并完成系统授权。电脑控制作为默认系统插件显示，不能卸载；可在会话输入框使用电脑操作入口，由主 Agent 根据你的指令观察和操作本机应用，并显示控制预览。该能力为实验性功能，请检查实际操作结果；Windows 源码尚待对应系统的构建和实机验证。
输入框权限选择器右侧的编排菜单只控制当前线程，可随时切换：
| 模式 | 工作方式 |
|---|---|
| 标准模式（默认） | 主 Agent 正常使用工具，也可调用普通子 Agent。 |
coordinator |
主 Agent 分解、委派、观察和整合；直接工具限制为读取与任务管理，修改交由遵守原权限的子 Agent 执行。 |
swarm |
主 Agent 创建有名成员，通过 TeamTask 维护共享任务板，并用 SendMessage 向成员发送任务内消息。 |
运行中切换在下一次模型请求边界生效，当前请求保留原配置。成员消息属于这个团队；跨顶层任务仍使用下文的 App Server 任务工具。团队最多 8 名有名成员，任务板、消息大小、权限、取消及恢复都有独立边界。中英文菜单和触发按钮统一显示 coordinator / swarm。
当前代码已修复 swarm 工具 schema 的提供商兼容问题：提供商接收普通对象，执行端继续严格检查每个动作的字段和权限。预热新会话也不会在父会话创建之前写入模型选择或把合法空会话误报成丢失任务。
在设置的 Agent 能力页配置：
- 工作区记忆：新配置默认关闭；开启后按工作区身份隔离记忆，支持相关内容召回、只读查看、修改历史、差异及受修订保护的撤回。
- 自动提取：独立开关，新配置默认关闭；从完成的会话提取可复用信息。关闭总记忆许可同时阻止新的提取与整理。
- 自动整理：独立开关，新配置默认关闭；达到时间与候选会话门槛后整理已有记忆，也可手动“立即整理”。界面展示进度、实际范围、用量与取消结果；不会在每次发送后立即运行。
- 允许主动工作：默认关闭。开启应用许可后，还需在具体线程中启动主动工作；线程可暂停或停止，事件与定时唤醒沿用同一任务 admission。
- 记忆历史范围：选择当前会话、工作区或不读取历史。关闭记忆后已有文件和历史仍可只读查看。
macOS 的关窗后台执行取决于后台许可与可用的受管 Host；Cmd+Q 会退出应用及其受管进程。关窗后台不代表开机自动启动，也不保证合盖或系统休眠期间持续运行。
在 设置 → 模型 → ChatGPT订阅登录 → ChatGPT订阅 点击 Continue with ChatGPT，在系统浏览器完成官方登录和订阅用量授权。连接使用的登录页也提供 ChatGPT 订阅入口；无需输入 OpenAI API Key。
- 当前界面只维护一个登录账号，支持切换账号登录、重新连接、退出、移除本地连接和刷新模型。
- 自动发现该连接实际可用的模型。会话模型菜单选择模型和受支持的思考级别；最高档使用紫色提示。模型权限以实时目录和实际请求为准，不按套餐名称写死。
- ZCode 自有 Agent 继续执行本地工具、文件、Shell、MCP、子代理、记忆、压缩和任务协作。订阅权限不足、超限或连接失效时明确提示，保留历史，不自动改用另一条收费 API Key 路径。
- 模型使用可能消耗 ChatGPT 账户/应用的订阅用量，主代理、子代理和后台工作不拥有独立套餐额度。管理用量打开官方页面；本地统计不冒充官方剩余额度。
- 这是官方公开订阅接入的预览能力，不提供全部 ChatGPT 产品功能或全部 OpenAI 模型。fal.ai 图片生成继续使用自身配置及费用，本地电脑/浏览器控制仍使用 ZCode 执行器。
- 提示词、任务所需上下文和选定附件会发送到 OpenAI，本地工具在执行电脑运行。令牌保存在本机系统保护的私有存储，不进入会话导出或 RCS 桥接载荷。
- RCS 可使用桌面已连接的订阅供应来源；首次登录和账号管理在桌面完成，不将桌面回调交给手机处理。独立 SSH/Docker 执行端不复用桌面的私有订阅凭据。
当前版本移除了按累计 token、费用、请求次数、任务总时长和默认连续轮次强制终止任务的执行预算。主任务、子 Agent、目标任务和记忆维护不会因旧消费额度达到上限而自动暂停；旧预算设置在读取时兼容丢弃，历史用量保留。
用量仍可观察，缺少提供商 usage 时标记为估算。上下文容量与自动压缩、单次输出限制、并发背压、网络重试、工具超时、用户明确指定的 maxTurns、权限和取消仍有效。持续执行不等于免费或没有提供商额度限制；模型、子 Agent 和记忆维护仍由相应提供商收费。
在桌面端打开一个本地工作区，创建两个独立顶层任务，例如“实现”和“审查”。在其中一个任务中明确要求：
找到当前工作区名为“审查”的任务，向它发送：请检查刚才的修改，重点关注异常处理。随后等待它完成并汇总结果。
Agent 使用 ListWorkspaceTasks、SendTaskMessage 及任务读取/等待工具，以发现结果中的任务 ID 定位目标。服务还提供恢复、重命名、归档/取消归档、关闭、压缩、停止、取消输入和分叉等操作。
- B 空闲时开始执行；忙且当前轮允许导入时使用 guide/steer；不可导入时排队，并返回实际投递结果。
- 手动输入保留已有等待/导入交互；跨任务输入显示独立来源标记。
- 范围是同一本地工作区的顶层任务，不是任意跨工作区、跨机器控制接口。子代理和工作流子任务不获得顶层协作工具。
- 遥测：设置 → 常规 → 允许遥测上报。关闭会传播到活动本地 Host/Agent；旧待发事件不会在重新开启后补传。没有明确开启的配置按关闭处理。
- 动态工作流：安装版默认开放，在自动化界面使用工作流入口。源码开发时可显式设置
ZCODE_DYNAMIC_WORKFLOW_MODE=alwaysOn。 - Mailbox：默认启用。启动进程时设置
ZCODE_MESSAGE_ENABLED=0（或false/off/disabled）可关闭自动装配的本地 Mailbox。 - 搜索：设置 → 工作区搜索范围，编辑忽略规则或从
.gitignore同步，沿用.zcodeignore语义。
桥接项目：showjiangnan/zcode-rcs。后端使用 Python 3.12+，包含响应式共享 ZCode Web、部署文件、协议 JSON Schema、独立 JavaScript/TypeScript SDK 与接入示例。服务器只负责鉴权、目录查询和转发，本机 ZCode 仍负责模型、工具、会话、记忆和终端。
- 在自己的服务器部署桥接程序，配置独立 HTTPS 域名，生成并保存自己的桥接密钥；按桥接仓库 README 配置反向代理与持久卷。
- 在桌面 设置 → 远程服务 → RCS服务 输入该端点与密钥，选择允许公开的工作区，验证连接后保存并开启。密钥由 Electron safeStorage 保护，不回显；未选择的工作区不能附着。
- 在另一台电脑或手机浏览器打开同一桥接端点，输入同一密钥，选择在线设备、窗口和工作区，即可使用该桌面 Host 的共享会话界面。
- 会话、编排、任务间消息、记忆、图片、文件/Git 与终端继续沿用原运行时。浏览器刷新与断线恢复重新附着，Host 终端可按原 ID 续接；离线期间不自动提交草稿。桌面必须保持打开且电脑可联网。
- 同一设置分组中的 SSH 复用原生连接向导；移动聊天机器人 使用独立设置页面，已有记录保持原服务持久化，旧会话侧栏图标已移除。
Web 可管理允许的会话及模型设置；模型/API 凭据不会在读取或通知中回显，空输入保留已保存值。RCS 根配置、系统动作、SSH 新连接和机器人设备配置在桌面管理。原生内嵌浏览器与电脑控制权限不会因远控而扩大。
微信小程序/App 可使用同一 REST、WebSocket 和 SDK 合同自行实现客户端，无需微信登录；本仓库没有交付小程序或 App 成品。桥接与桌面使用版本协商和严格 workspace identity/Host generation；API 合同见桥接项目的 docs/API.md。
信任与部署边界：桥接服务可见转发的数据，采用 HTTPS/WSS 传输保护，当前不提供端到端加密。应部署在自己可信的服务器；没有开发者中心目录、默认管理员或远控后门。公开部署必须使用有效 TLS；明文 HTTP 只允许显式开启的本机 loopback 测试。关闭服务、撤销浏览器或更换密钥会关闭对应 attachment，不删除本地会话。
构建桌面与 Web 后，可同步桥接配套资源：
ZCODE_ENV=production pnpm --filter @zcode/web build
node scripts/build-rcs-assets.mjs ../zcode-rcs导出的 web/、sdk/ 和 protocol/ 是桥接仓库的交付资产，升级时应一起更新；云服务器无需 Node.js 或 Electron。
配套 RCS / SDK 1.1.2 使用 Web 3.14.7，桥接协议保持 1 / 1 / 3。导出前验证 Web 源码指纹，暂存校验完成后再替换资源，失败时回滚。web/build-info.json 记录配套版本及源码、产物摘要；生产升级应停服更新完整发布包，保留认证数据后重启。
平台入口：fal.ai · API Keys · 模型目录 · 官方文档。注册登录并配置可用额度；实际图片生成由 fal 及其模型提供商计费。
进入 设置 → Agent 能力 → 图片生成：
| 字段 | 填写方式 |
|---|---|
| API 地址 | 默认 https://queue.fal.run，不要填模型网页地址 |
| API Key | 在 fal 的 API Keys 页面创建并填写；保存后不回显，留空保留已存密钥 |
| 生成模型 | 点击“刷新模型”选择，或输入完整 endpoint ID，例如 fal-ai/flux/schnell |
| 编辑模型 ID | 可选；填写支持参考图的编辑 endpoint，以模型 API 页面为准 |
| 开启图片生成服务 | 保存配置并开启，然后创建新会话 |
| 允许 Subagents 使用图片生成 | 默认关闭；开启后子代理和工作流子任务也可能产生图片费用 |
先点击 验证连接（不生成图片）：读取模型 Schema 并验证凭据，不提交付费生成。自建网关必须实现本项目使用的 fal Queue、模型目录和鉴权协议，不能直接替换成任意 OpenAI Images 兼容接口。
新会话示例：
生成一张日本漫画风格的图片：小猫趴在草坪上，彩色蝴蝶停在头顶。1024×768，PNG。
生成两张 1024×1024 的产品概念图，WebP 格式。
默认 1 张 PNG。PNG/JPEG/WebP、宽高和数量在付费提交前按所选模型校验；应用最多允许单次 8 张，仍受模型更小的限制。不是所有模型都支持 WebP、精确像素或编辑；不支持的参数会明确报错。
生成过程中显示 loading，结果返回并保存原图后展示图片，可预览和保存。GenerateImage 发起生成；ManageImageGeneration 查询、恢复或取消已有作业。提交结果不确定时不自动重新付费提交；取消不能撤销提供商已产生的费用。关闭服务或清除 Key 不删除已保存的本地图片。
图片服务发送本次提示词和明确引用的图片，不会为了生成图片自动上传整个仓库。代码 Agent 的正常模型请求仍可能包含任务需要的代码、历史和工具结果。关闭遥测不等于关闭模型、插件、更新检查等所有网络请求。
准备 Git、Node.js 24.14.0、pnpm 10.33.2，以 mise.toml 为准。命令均从仓库根目录执行。
git clone https://github.com/showjiangnan/zcode-feiyu.git
cd zcode-feiyu
pnpm bootstrap
# 桌面开发：生产服务配置
pnpm dev:desktop
# 独立开发数据目录（macOS / Linux）
ZCODE_DATA_BASE_DIR="$HOME/.zcode-dev-home" pnpm dev:desktop:test
# Web 客户端 + 本地后端
pnpm dev:web
# CLI 源码入口
pnpm --filter @zcode/cli dev --helpbootstrap 安装依赖、准备本地桌面运行资源并构建。Agent 已包含在 apps/zcode-cli/，无需 Git 子模块。Web 开发默认访问 http://localhost:5173，后端默认 http://localhost:3030；可通过 ZCODE_SERVER_WORKSPACE=/path/to/project pnpm dev:web 指定工作区。
SSH/WSL 开发资源按需运行 pnpm bootstrap:with-remote，然后启动桌面，连接远程项目时选择“本地下载后上传”。远端能力仍遵循原有平台限制，顶层任务协作范围保持为本地工作区。
以 .env.example 为示例设置服务地址；本机覆盖放入不提交的 .env / .env.local。公开 OAuth client ID 不是 API Key。
| 配置 | 用途 |
|---|---|
ZCODE_DATA_BASE_DIR |
应用数据基目录，数据写入其下的 .zcode/ |
ZCODE_SERVER_WORKSPACE |
Web 后端工作区 |
ZCODE_BUILTIN_PROVIDER_CONFIG_FILE |
自定义 Provider 配置路径 |
ZCODE_DIST_BASE_URL |
CLI 发行包下载根地址 |
使用本版 ZCode 安装身份、生产服务配置，在打包阶段完成 ad-hoc 签名，使最终 DMG/ZIP 包含已签名的应用：
ZCODE_ENV=production \
ZCODE_SKIP_REMOTE_ASSETS=1 \
ZCODE_BOOTSTRAP_WITH_REMOTE=1 \
ZCODE_ENABLE_MAC_SIGN=1 \
CSC_NAME=- \
pnpm bundle:desktop -- --os mac --arch arm64输出在 packages/desktop/dist/，包含 mac-arm64/ZCode.app 和 DMG/ZIP。ZCODE_SKIP_REMOTE_ASSETS=1 跳过本次本地桌面构建无需准备的远端部署资产；需要远端发行资源时去掉该项并准备相应资产。
打包结束后验证签名，退出旧应用后复制新 .app 到“应用程序”覆盖同名应用：
codesign --verify --deep --strict \
"packages/desktop/dist/mac-arm64/ZCode.app"ad-hoc 签名不等于 Apple Developer ID 签名或公证。正式可信分发应配置自己的 Developer ID 和公证流程；只在构建后单独签名 .app 不会更新已生成的 DMG/ZIP。需要独立应用名时可显式设置 ZCODE_PREVIEW_IDENTITY=1，但不保证用户数据隔离；需要隔离时设置 ZCODE_DATA_BASE_DIR。
后续更新：保存本地修改，执行 git pull --ff-only，刷新依赖并重新构建，退出应用后覆盖同一 .app。源码变化不会自动进入已安装应用；更新时保留数据目录。本仓库没有提供飞鱼版自动更新下载服务，不应使用官方安装包覆盖自定义版本。确认新应用可运行后，可删除 packages/desktop/dist/ 中的安装包和打包副本。
较早 3.14.4 版本曾在 Apple Silicon Mac 完成以下 Windows x64 交叉打包；当前含原生 CUA 的完整版本需要在 Windows 构建，这段历史命令不代表本轮提供 Windows 安装包：
ZCODE_ENV=production \
ZCODE_PREVIEW_IDENTITY=1 \
ZCODE_SKIP_REMOTE_ASSETS=1 \
ZCODE_BOOTSTRAP_WITH_REMOTE=1 \
pnpm bundle:desktop -- --os win --arch x64工具链按需下载 Windows Electron、Wine 和 NSIS 资源，使用已有 Windows 预编译依赖。切换目标时必须完整准备对应运行时，不能复用另一平台的 native 资产。构建成功不等同于 Windows 实机验收；electron-builder 跨平台构建说明也明确区分了预编译依赖和必须在目标平台编译的依赖。其他参数见 pnpm bundle:desktop -- --help。
# 将占位地址换成自己的发行包托管地址
pnpm build:zcode --base-url https://downloads.example.com/zcode/dist/zcode/ 中生成版本运行包、校验摘要和安装脚本。安装后 zcode 默认进入 TUI；zcode --web --workspace /path/to/project --port 3030 --no-open 启动 Web。Web 默认监听本机，对外部署时配置认证和网络保护。
| 目录 | 内容 |
|---|---|
packages/desktop |
Electron Main、Host、Renderer 与打包 |
packages/web、packages/server |
Web 客户端与后端 |
packages/ui |
共享 React 组件、hooks 和 Zustand 状态 |
packages/services |
业务服务、任务/图片服务与持久化 |
packages/shared、packages/rpc、packages/client |
协议、类型、RPC、Agent SDK |
apps/zcode-cli |
Agent、CLI、TUI、工具及内置技能 |
scripts、config、patches、third-party |
构建脚本、配置、依赖补丁和许可材料 |
本仓库包含生产源码、可构建所需资产及中英文 README，不包含研发 spec 工程、测试用例/夹具、测试报告、本机凭据、会话和构建产物。保留的技能 Markdown、Browser Use 说明是程序读取的运行资产；原生搜索归档是构建所需第三方依赖。许可证、NOTICE 和第三方声明随源码保留。
RCS 已在 macOS arm64 的 3.14.4 安装版、本地 Python 服务与真实桌面 Host 上完成：浏览器端模型往返、standard/coordinator/swarm、刷新恢复、独立 SDK、同 commandId 对账、授权路径/凭据拒绝、HTTP Range 及同 PTY ID 续接；电脑/320/390/430px 浏览器交互已验收。这些是历史验收；当前版本的门禁与新增 CUA 验证范围见下文。测试使用本地模型 fixture，不代表所有第三方模型、真实云公网 TLS、实体手机软键盘、远端 SSH 主机或机器人平台均已验证。Docker 部署文件已提供，本轮未在 Docker 引擎上运行。
当前源码已通过根及 CLI 类型检查、Lint（0 errors / 0 warnings）和架构检查。macOS arm64 的 3.14.6 本地安装版（CUA 0.7.16）使用真实 GPT-6.1-Sol 验证同一工具调用的多张截图、文本写入与新鲜观察、多窗叠放，以及关闭一个/最后来源后的预览移除。发布归档独立校验签名、架构、内容和内置 Agent；本次没有重新执行真实 OAuth 或新的付费图片生成验收。Windows 共享 UI 的模拟组合测试不代表当前原生 helper、安装包或 Windows 实机通过；最小化实机、长期压力及所有第三方应用组合尚未完整验证。
macOS arm64 安装包与本机启动有实际验证；较早图片兼容修复还完成了真实 fal 的无付费连接验证。实际付费出图、真实 CDN 故障和 Windows 真机仍需独立验收。测试源码和测试记录按发布范围排除。
沿用 Apache License 2.0，保留上游及第三方版权，见 NOTICE.md 和 THIRD-PARTY-NOTICES.md。二开修改包括任务协作、记忆、编排、主动工作、执行策略、遥测控制、功能开放和 fal 图片能力，相应修改文件注明 ZCode Feiyu 来源。ZCode 名称和原有标识属于各自权利人，不代表官方背书。
感谢 ZCode 上游和各开源依赖维护者。问题反馈请提交到 本仓库 Issues。
补充检查 Desktop Main 独立 tsconfig 时仍有仓库既有类型错误；根规定的 typecheck 通过不代表每个独立 TypeScript 项目都已通过。