AstrBot-Desktop/docs/02_Codex_Implementation_Tasks.md

5.7 KiB

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 执行口令

请先阅读:
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 的建议。