291 行
5.7 KiB
Markdown
291 行
5.7 KiB
Markdown
# 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 的建议。
|
||
```
|