Files
pj0235-eai_agentplatform/docs/02_Architecture/AR07_Architecture_Alignment_Audit.md
T
eaiadminandClaude Code fa6c26ea41 docs: 工作台设计稿收入 docs 体系,routes.go 更名 ai_routes.go
7 份散落在 frontend/src/views/workbench/ 的设计稿按现有编号体系收入 docs/,
源码目录现在只剩 12 个 .vue 页面:

  PlatformArchitectureRethink       -> docs/01_System_Overall/SY24
  WorkbenchArchitectureContract     -> docs/02_Architecture/AR05
  SkillPackagingSpecification       -> docs/02_Architecture/AR06
  ArchitectureAlignmentAudit        -> docs/02_Architecture/AR07
  RoleInteractionDesign             -> docs/02_Architecture/AR08
  YunQuParityRoadmap_OfficePlatform -> docs/06_Product_Lines/PL04
  WorkBuddySkillRpaLearning         -> docs/09_Research/RS01

14 处交叉引用同步更新(含 SY20/SY21 里指向旧源码路径的两处);三份 README 索引
补齐 SY20-SY24 与 AR05-AR08、PL04;README 顶部「本目录全是历史快照」的说法改精确
(AR05-AR08、PL04 不属于 V1.1 / V1 快照)。

AR08 文首补注「采纳与废弃」,避免它被当成现行设计照做:
- 已采纳:对象不跳页 / 不做独立工具页 / + 菜单挂载 / 切换对象=更新任务上下文
- 已废弃:「数字技术员」第三类对象(SY21 §2.2 已废除 tool 命名)、
  「通用助手 = 默认专员」、§14「与本稿冲突以本稿为准」的自我授权

backend-go: internal/api/routes.go -> ai_routes.go。该文件管的是 AI 模型路由
(LLM provider 列表),与 router.go 的 URL 路由注册同包同名易混,加文件头注释钉死。

验证:go build ./... 通过;go vet ./internal/api/ 无告警;npm run build 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 19:26:26 +08:00

3.1 KiB

架构对齐确认与本轮修复范围

落盘日期:2026-09-16 状态:本轮生效 关联文档:

  • AR05_Workbench_Architecture_Contract.md
  • ../01_System_Overall/SY24_Platform_Architecture_Rethink.md
  • AR06_Skill_Packaging_Specification.md

1. 本轮确认结论

当前前端已经出现两套并行模型:

  1. workerRuntime 开始把 currentSpecialistKey / currentSkillKey 收进任务上下文
  2. 路由和多个入口仍在继续使用 /apps/*、/tools/* 当执行页

这两套模型继续并存,会持续制造以下问题:

  • 同一个对象,既像“挂在任务上的对象”,又像“跳去一个页面”
  • 输入区已经开始对象化,但对象 chip 和首页卡片还在按旧路由跳转
  • 兼容路径不只是兼容,而是在继续承载真实业务

所以本轮先不扩技能复刻,先回到我们自己的架构,确认并修复这一层。


2. 已确认的主要偏差

2.1 执行入口没有收敛到 /home

当前代码中仍存在:

  • /apps/:key 专员执行页
  • /tools/:key 工具执行页
  • /report-gen 这类独立工具页

这与“只保留一个 Workbench 执行面”的架构合同冲突。

2.2 启动对象的入口行为不一致

当前不同入口对“打开专员 / 工具”的处理不一致:

  • + 菜单一部分已经开始写任务上下文
  • 首页卡片仍直接 router.push(app.pageRoute) 或使用业务对象旧入口字段
  • 市场页“打开工作区”仍直接进入旧路由
  • 当前对象 chip 仍会把工具跳到旧工具页

这会导致用户在不同入口触发同一对象时,落点完全不同。

2.3 旧执行路由仍残留在产品结构里

根据架构合同,/apps/*、/tools/* 应该退出执行结构。

此前前端中它们曾直接挂载为执行页:

  • BusinessAppPage.vue
  • DocumentTranslatePage.vue
  • CopyProofreadingPage.vue
  • ContractReviewPage.vue
  • AudioTranscribePage.vue
  • BatchExtractPage.vue

以上旧执行页现已全部从前端仓库移除。

这会继续放大旧页面模型。


3. 本轮修复范围

本轮只修第一优先级:

  1. 所有“打开专员 / 工具”的行为,统一回到 /home
  2. /apps/*、/tools/*、/report-gen 从路由中直接移除
  3. 所有对象启动动作只认新的工作台入口和任务上下文

4. 本轮暂不处理

以下问题已确认存在,但不在本轮一起动:

  1. 后端 task -> specialist_key 仍未升级为更完整的 mounted objects 结构
  2. 后端专员数据结构命名已升级为 object_entry_route,并与普通页面导航 page_route 分离;旧 route / entry_route 已收缩为启动阶段的一次性数据库迁移逻辑,不再驻留在日常模型与接口中

5. 本轮达成标准

修完后,系统应满足:

  1. 用户从 + 菜单、首页、市场页进入时,都会回到同一个 /home
  2. 当前专员 / 当前工具由任务上下文决定,而不是由页面路由决定
  3. /apps/*、/tools/*、/report-gen 不再作为前端执行入口存在
  4. 旧执行页源码文件已经从前端仓库移除