# 01|Codex 实施任务清单:双 AstrBot 与本机助手 > 配套文档:`01_桌面客户端双实例陪伴与本机运维系统.md` --- ## 执行原则 1. 每个批次必须能独立运行和测试。 2. 不允许先实现任意 Shell 再补安全限制。 3. 所有服务端事件必须在 Rust 连接层绑定 `profile_id`。 4. 所有本机写操作必须经过 LocalPolicyEngine。 5. 未通过高风险 Spike 前,不进入完整 UI 开发。 --- ## Batch 0:技术 Spike ### 0.1 双 SSE 后台连接 目标: - Tauri 同时维护两个 SSE; - 主窗口隐藏后继续收事件; - 分别断线和重连; - 事件不串流。 验收: - Mock A 每秒发 A 事件; - Mock B 每秒发 B 事件; - 连续 30 分钟无串流; - 单独关闭任一服务不影响另一个。 ### 0.2 Windows Credential Manager 目标: - 写入、读取、删除测试凭据; - SQLite 只保存引用。 ### 0.3 UI Automation 与窗口截图 目标: - 读取标准 Windows 弹窗文字; - 读不到时选择窗口截图; - 不要求客户端常驻管理员权限。 ### 0.4 Windows Event Log 目标: - 按 Provider、时间范围和进程筛选; - 返回结构化摘要; - 不导出无关日志全文。 ### 0.5 NAS 文件事务 目标: - UNC 路径复制; - 中途断网; - 恢复复制; - SHA-256 校验; - 校验成功后再清理源。 --- ## Batch 1:工程骨架 - 创建 Tauri 2 + React + TypeScript; - 建立 workspace; - 建立 IPC 类型包; - 引入 SQLite 和迁移; - 实现日志脱敏基础库; - 实现托盘、单实例和退出流程; - 建立单元测试与 Playwright。 完成条件: - 应用可启动、隐藏到托盘并恢复; - SQLite 自动迁移; - Rust 与 TypeScript IPC 类型可校验。 --- ## Batch 2:Profile 与双连接槽位 实现: - ConnectionProfile CRUD; - Companion Slot; - Operations Slot; - 最多两个活动连接限制; - 自动连接配置校验; - Profile 切换保护; - server_instance_id 重复提示。 测试: - 保存 5 个 Profile; - 任意两个进入不同槽位; - 禁止同 Profile 同时占两个槽位; - 运维任务运行时禁止切换 Operations Profile。 --- ## Batch 3:REST + SSE GatewayClient 实现: - REST Client; - SSE Client; - Token 刷新; - Last-Event-ID; - 指数退避和抖动; - 事件去重; - 两个连接独立状态机; - MockGatewayAdapter。 测试: - A/B 流式消息同时输出; - 单连接断网恢复; - 重放相同 event_id 不产生重复消息; - Token 过期只影响对应 Profile。 --- ## Batch 4:双对话框 UI 实现: - Split 布局; - Single with Tabs; - Focus Companion; - Focus Operations; - 各自会话列表; - 未读数量; - 来源标签; - 通知跳转。 测试: - 两实例相同 conversation_id 不串数据; - 切换布局不丢流式内容; - 通知点击打开正确槽位。 --- ## Batch 5:本地策略引擎 实现: - LocalActionProposal; - 工具注册表; - L0-L3 风险等级; - Profile 角色检查; - Operations Slot 检查; - 服务器身份检查; - 请求过期; - 用户确认卡片; - 审计日志。 必须测试: - Companion Profile 的工具提案必定拒绝; - 未确认写操作不能执行; - 任意未知 tool_name 拒绝; - 任意路径字符串不能绕过路径授权。 --- ## Batch 6:只读诊断服务 实现: - ForegroundWindowInspector; - UIAutomationReader; - SelectedWindowCapture; - ProcessInspector; - EventLogReader; - PortInspector; - ServiceInspector; - NetworkInspector; - FileReader; - ConfigParser; - LogCollector; - DiagnosticBundleBuilder。 脱敏: - Token; - API Key; - Password; - Cookie; - Authorization; - PEM 私钥; - URL 凭据; - 数据库连接串。 测试: - 使用含假 Token 的 fixture; - 发送前输出不得包含原值; - 用户可以预览诊断包; - 截图默认诊断后删除。 --- ## Batch 7:NAS 与文件事务 实现: - NasTarget; - Credential Manager 凭据; - 用户文件选择; - sourcePathToken; - 元数据分类; - Dry Run; - 临时文件; - 校验; - 原子提交; - 冲突处理; - 网络中断暂停; - 事务恢复; - 源文件保留或回收站。 测试: - NAS 断网不删除源; - 哈希失败不提交; - 同名文件不覆盖; - 重启客户端后可以恢复未完成事务。 --- ## Batch 8:语音、游戏和主动消息 实现: - 按键说话; - 目标实例选择; - TTS 音频仲裁; - 游戏模式默认绑定 Companion Slot; - 游戏开始、结束和时长事件; - 主动消息来源区分。 --- ## Batch 9:稳定性与发布 - 自动更新; - Windows 签名; - 崩溃恢复; - 诊断包导出; - 日志滚动; - 数据迁移备份; - Defender 误报检查; - Beta 发布流程。 --- ## 首个 Codex 执行口令 ```text 请先阅读: 1. docs/01_桌面客户端双实例陪伴与本机运维系统.md 2. docs/01_Codex实施任务清单_双实例与本机助手.md 本次只执行 Batch 0,不开发正式业务 UI。 任务: 1. 创建最小 Tauri 2 Spike 工程; 2. 实现两个独立 SSE 客户端,分别连接 Mock A 和 Mock B; 3. 每个 SSE 事件在 Rust 层绑定固定 profile_id,不采用服务端传入的 profile_id; 4. 主窗口隐藏到托盘后保持连接; 5. 单独关闭 Mock A 或 Mock B,验证另一个连接不受影响; 6. 实现各自指数退避重连和 event_id 去重; 7. 输出测试记录和资源占用结果; 8. 不实现任意 Shell、文件操作、真实 AstrBot 接入或正式聊天页面。 交付: - Spike 源码; - README; - 自动化测试; - 测试结果; - 风险结论; - 是否可以进入 Batch 1 的建议。 ```