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

98 lines
3.1 KiB
Markdown

# 架构对齐确认与本轮修复范围
> 落盘日期: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. 旧执行页源码文件已经从前端仓库移除