Skip to content

[基线] 仓库盘点与多线推进计划(2026-08-22 接手) #1838

Description

@DeliciousBuding

目的

2026-08-22 仓库接手盘点:固化当前基线事实,登记多线并行 track,作为后续推进的锚点。第一轮(整理)已完成,见文末日志。

基线快照(master @ 619119f,2026-08-22)

CI / 分支 / issue

测试基线(实测)

  • Go:hub+edge+pkg 共 331 个 _test.go、3583 个 Test;-short 本机全绿(edge 33 包 / hub 43 包)。集成 lane 仅 hub(133 Test,-tags integration,与 dev 栈共库是已知风险)。
  • 前端:3911 个 vitest 全绿、0 skipped;覆盖率 shared 76.43% / workbench 83.67% / web 64.69% / desktop 49.29% / mobile 34.51%(scripts/verify/coverage-baseline.json 棘轮)。
  • lint 债:hub 17 条 complexity 基线([P2] hub-server 存量 17 条 complexity 债务清偿(14 gocognit + 3 gocyclo) #1812);edge 18 条无棘轮(CI advisory,review_by 2026-10-01)——治理不对称,Track D 补。
  • 性能:33 个 Benchmark;perf 门禁仅 workflow_dispatch 手动触发,不拦 PR。

前端真实 E2E 缺口(本轮重点结论)

  • CI 内零真实浏览器行为测试frontend-* PR job 只跑 vitest;e2e-smoke 仅 3 个静态页检查且手动触发。
  • 无真实 OIDC 浏览器登录测试app/e2e/chat-real.spec.ts 用 dev secret 自签 JWT 绕过登录;oidc-login.spec.ts 全 mock。
  • 真实聊天/审批浏览器流缺失(chat-real 浏览器段是 waitForTimeout 弱断言)。
  • 基建已就位:Playwright 三端配置、app/web/playwright.real.config.ts(never in CI)、证据等级门禁(verify-real-e2e-contract.py 9 级)、tests/artifacts/ L3 证据契约、本机全栈脚本(~/agenthub-dev/start.sh:ID :3000 在跑,hub/edge/web 未起)。
  • 结论:补真实 E2E 的合规路径 = workflow_dispatch 真栈 lane + 远程 devserver 证据,L3 不进 PR 门禁(AGENTS §5.5);PR 门禁内的补强 = stubbed-hub Playwright lane 提为路径触发 job。→ Track B。

文档 / 治理

  • 文档机器门禁健全(44 verifier + 行数上限 + 链接门禁);欠账在归档收尾与少量漂移:local-memory-pointer.md 归档状态自相矛盾(H1)、component-acceptance 范本过期(M1)、06-auth-identity 把 web 文件列进 Desktop(M2)、verifier-map 未标 advisory(M3)、AGENTS §13 与 renovate major PR 口径漂移(M4)。→ Track E。

多线推进计划

Track 内容 载体 优先级
A master CI 修复:desktop shard2 flake(#1836 自动展开 × 测试竞态),要求确定性修复、不许削弱断言 本 issue 下 PR P0 阻塞
B 前端真实 E2E 建设:真 OIDC 登录 + 聊天 + 审批浏览器流(测试账号供给、app/e2e 扩展、workflow_dispatch lane、evidence manifest);stubbed-hub Playwright 提为路径触发 PR job #1839 P0
C 前端质量债收尾:#1821 app-shell-states lane、#1823 剩余、#1816 审批模式 UI、#1822 快捷键、#1824 mobile、#1819 动线、#1825/#1826/#1820/#1827 设计/i18n 各 issue P1
D 后端:#1812 hub complexity、edge lint 棘轮 #1840#1743 ACP item2/3、集成测试库隔离 各 issue P1/P2
E 文档治理:H1/M1-M4/L1-L6 修复;#1762 待外部归档仓就位 PR P2

并行规则:每 track 一个 worktree + 一个短分支(AGENTS §6);checks.yml 只允许 Track B 改;合并排队,不互相 rebase 对方的活。

第一轮整理日志(2026-08-22)

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1High priority

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions