- 修复可确认的问题,保持最小完整改动;避免过度设计、审查和测试。用户要求的多轮独立评审按任务范围执行。
- 主 Agent 协调实施与独立验证,明确并行任务的文件归属。验证失败先修复再复验;未通过的范围如实列出。
- 保留工作树中已有改动。实际服务、账户及已安装客户端的变更按用户任务范围执行。
- 当前为开发版本。结构冲突直接调整开发数据库,使用当前契约;不增加历史兼容分支或迁移脚本。
- 产品代码统一使用 strict TypeScript;Swift 只负责 macOS 壳与系统权限 UI。运行、构建和开发命令以根
package.json为准。 - 修改模块职责或执行流程前读 架构;安装与打包改动读 部署,浏览器改动读 浏览器客户端。
- 根目录保留项目入口与工具约定配置;协作说明归
.github/,文档及品牌源归docs/,测试目标和工具配置归tools/。 - 可运行产品归
apps/,共享包归packages/;运行依赖归所属应用,根目录只声明开发工具。跨 workspace 使用具名 exports,执行npm run architecture:check核对依赖职责。 - 共享能力、消息和工具契约只维护在
packages/protocol/src/。外部输入在入口解析,使用明确类型,不用any掩盖不匹配。 - App 提供 screen/input/shell/files;扩展仅提供 browser,并直接连接 Server。两者独立安装、注册和授权,App 不转发浏览器请求。
- 操作按 operation_id 去重;未知写操作不重放。暂停、撤销和能力关闭优先,自动重连不解除它们;会话资源分别清理。
- Server 只依赖服务端运行环境。桌面 SDK 在设备端显式按需加载,以同进程模式运行;设备凭据保持私有权限、原子写入和服务地址绑定,日志不含秘密。
- 版本单源为根
package.json;构建时生成各分发产物与扩展版本,保持生成文件可再现。