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>
This commit is contained in:
eaiadmin
2026-09-17 19:26:26 +08:00
co-authored by Claude Code
parent 24cac4de6e
commit fa6c26ea41
16 changed files with 5735 additions and 55 deletions
@@ -0,0 +1,97 @@
# 架构对齐确认与本轮修复范围
> 落盘日期: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. 旧执行页源码文件已经从前端仓库移除