Files
eaiadmin 90031b75f3 docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
2026-09-22 23:23:16 +08:00

3.1 KiB

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

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

  • AR05_工作台架构约定.md
  • ../01_System_Overall/History_And_Retrospectives/系统演进旧稿/SY24_平台架构重思考.md
  • AR06_技能封装规范.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. 旧执行页源码文件已经从前端仓库移除