Skip to content

refactor(tasks): isolate approval lifecycle - #169

Merged
ZhaoJun233 merged 122 commits into
mainfrom
dev
Nov 11, 2026
Merged

ZhaoJun233 merged 122 commits into
mainfrom
dev

Conversation

@ZhaoJun233

Copy link
Copy Markdown
Owner

变更摘要

任务页面原先同时维护任务编排与审批状态。本次把审批队列读取、决定回执、恢复资格和登记投影集中到 useTaskApprovals;页面保留共同 ownership、权限 watcher、调度器和生命周期顺序,交互与请求语义保持不变。

TasksPage.vue
├─ 任务列表、提交、取消与页面生命周期
├─ useTaskResult:详情读取
└─ useTaskApprovals:审批队列、决定与人工恢复

前置特征测试已独立通过 #168 采用;本 PR 仅更改任务页面并新增审批模块。

验证命令与结果

命令 / 范围 重构前与最终候选
Headless Rebuild、Harness build、npm ci、typecheck 原生退出码均为 0
npm run test:unit 各 1092/1092,包含冻结的 31 条审批生命周期用例
三份任务 E2E,Chromium / Firefox / WebKit 各 45/45,每引擎 15 条,无跳过或重试
16 项固定命令矩阵 前后全部成功,测试身份、锁文件和 runner 一致

提取过程发现的响应式依赖回归已修复:只读取 client 时不再同时订阅权限字段,避免权限切换覆盖 Unknown 行的“已不在队列”证据。保留的合成探针在原候选 0/3,最终提交 3/3。该探针只验证模块与登记处,不代表挂载 UI 的完整测试。

本地结果限于 Windows 合成环境;本地矩阵未运行独立 ArchitectureProbe 或 rate-limit project,远端 CI 按仓库当前必需清单执行。无真实服务验收。

重构前后 harness 场景对比

场景 ID 重构前 重构后 差异说明
S54 111/111 111/111 同组断言身份与结果一致

断言改动声明:没有修改测试、夹具、断言、阈值、超时或重试设置。

回滚点

合并后可普通 revert 本 PR 的 squash 提交,保留前置结果读取和审批测试,再按同一矩阵验证。变更影响面为前端审批模块;没有数据迁移或 schema 变化,无需停写。本次仅同步代码分支,不创建 Release,不部署生产。

chore: 同步 main 最新进度至 dev
…oint

refactor: extract Core and Platforms checkpoint
把原先集中在 BotAgent.Headless 的领域与适配层按职责拆开:
- BotAgent.Core:领域模型、契约与端口
- BotAgent.Engine:回复管线、参与度、权限、插件、工具
- BotAgent.Storage:配置/会话/画像等持久化
- BotAgent.Platforms:OneBot、官方、飞书、本地渠道
- BotAgent.Model:模型传输、OpenAI 客户端、出站策略
- BotAgent.Panel:ZBA v1 面板端点与查询解析
- BotAgent.Mcp:MCP 工具源

Headless 只保留宿主装配与适配器;旧 Domain/* 目录随之删除。
同步更新探针与集成测试的引用,并补齐 CI 工作流与仓库根文件。

构建:dotnet build BotAgent.slnx -c Release → 0 错误。
新增 Vue 3 + Vite 的 ZBA 管理面板(src/web):认证门、概览、配置编辑、
能力目录/描述符/支持矩阵/动作回执,含组件、契约与端到端测试。

能力动作的生命周期按「一次操作一条记录」建模:
- 未知结果保留操作键,同键重发复用原 command 与 expectedDescriptorRevision,
  由服务端幂等回放,不会产生第二次副作用;
- 卡片预检失败不否定先前的未知提交,未终态记录不可关闭删除;
- 已有未知历史的操作,无回执的拒绝只记「仍然未知」,不降级为「确认没执行」;
- 离开视图/退出管理员/写能力失效推进所有权代数,往返切页不会补发旧确认;
- 核对无回执的失败不覆盖最后一次可信回执。

后端:游标编码改为 Base64URL(无填充)+ 签名,签发与读取共用长度上限,
ZbaQuery 的游标白名单与长度和签发侧对齐,真实宿主可翻到第二页。

验证:typecheck 0;unit 122/122;e2e 41/41;dist 独立构建逐字节一致。
此前 CI 只覆盖后端,S2 前端进入主干后没有任何自动化门禁:
typecheck、unit、build 与 Playwright e2e 都只在本地跑。

新增 web job(与 verify/integration 并列):
- npm ci(按 package-lock.json 缓存)
- npm run typecheck / test:unit / build
- 构建 Headless 宿主(e2e 的 webServer 需要真实后端)
- 安装 Chromium 并跑 npx playwright test
- 失败时上传 test-results 与 playwright-report

本地按同序执行:typecheck 0、unit 122/122、build 0、宿主 build 0 错误。
ci: 为 src/web 增加构建与浏览器测试门禁
- 新增任务页:提交(幂等键 + 结果未知态)、取消、审批结果呈现
- pending-intent:未决提交的本地留存与恢复,离页不补发
- event-scheduler + app-resources:事件重同步、断线后 stale 状态与轮询基线
- toUiError 对未知 HTTP 状态改用固定安全文案,不透传后端消息
- 补齐组件/单元/E2E 覆盖(任务页、事件调度、未决提交、会话归属)
feat(web): S5 界面美化(侧栏满高、刷新去重、保存条避让、长 ID 断行)
@ZhaoJun233
ZhaoJun233 merged commit afbda55 into main Nov 11, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant