5.7 KiB
5.7 KiB
01|Codex 实施任务清单:双 AstrBot 与本机助手
配套文档:
01_桌面客户端双实例陪伴与本机运维系统.md
执行原则
- 每个批次必须能独立运行和测试。
- 不允许先实现任意 Shell 再补安全限制。
- 所有服务端事件必须在 Rust 连接层绑定
profile_id。 - 所有本机写操作必须经过 LocalPolicyEngine。
- 未通过高风险 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 执行口令
请先阅读:
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 的建议。