docs: 重构仓库文档目录并迁移训练素材

按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
eaiadmin
2026-09-22 23:23:16 +08:00
parent 9288f0215a
commit 90031b75f3
9046 changed files with 23786 additions and 3483 deletions
@@ -0,0 +1,36 @@
# FE11 — 对象目录总览
> 状态:当前有效
> 代码依据:`frontend/src/views/workbench/ObjectCatalogPage.vue`
> 最后更新:2026-09-21
## 1. 当前定位
对象目录负责呈现平台的一等对象:
- specialist
- skill
- xapp
- connector
## 2. 当前路由
- `/catalog/specialists`
- `/catalog/skills`
- `/catalog/xapps`
- `/catalog/connectors`
## 3. 当前职责
对象目录承担三类职责:
1. 看对象定义
2. 看对象摘要和能力说明
3. 触发打开动作,进入 Workbench 或 xapp
## 4. 当前判断
- 对象目录是“对象中心”的前端入口
- 它和 xapp 运行壳不是同一个层
- 目录页展示的是对象定义,不等于对象已经进入执行态
- 正式对象定义目录当前位于 `docs/05_Object_Catalog`
@@ -0,0 +1,44 @@
# FE12 — specialist / skill / xapp / connector 前端对象
> 状态:当前有效
> 最后更新:2026-09-21
## 1. specialist
specialist 是当前前端最重要的人格对象。
它主要负责:
- 作为任务执行人格出现
- 在对象目录中展示能力摘要
- 在 Workbench 中承接任务上下文
## 2. skill
skill 是可挂载能力对象。
它主要负责:
- 作为对象目录中的能力单元展示
- 通过运行时状态挂载到当前任务
- 为 specialist 或 xapp 提供具体执行能力
## 3. xapp
xapp 当前有两种前端形态:
1. 对象入口型 xapp
从目录打开后进入 Workbench 并挂载上下文
2. 独立壳型 xapp
直接进入独立路由,例如内部培训和内部考试
## 4. connector
connector 是连接外部系统或外部数据能力的对象入口。
它主要承担:
- 在目录中暴露可用连接器
- 在对象详情中呈现连接器能力
- 在运行时作为 action 或能力调用的外部边界
@@ -0,0 +1,36 @@
# FE13 — XApp 对象打开协议
> 状态:当前有效
> 代码依据:`frontend/src/xapps/store/xappCatalog.js`
> 最后更新:2026-09-21
## 1. 当前两类打开方式
xapp 当前存在两类打开方式:
1. 进入独立 xapp 路由
2. 打开 Workbench 并挂载 xapp 上下文
## 2. 独立路由型
这类 xapp 直接打开独立壳,例如:
- `/xapps/internal-training/*`
- `/xapps/internal-exam/*`
## 3. Workbench 挂载型
这类 xapp 打开后,会把:
- `xapp_key`
- `specialist_key`
- `skill_key`
- 默认 prompt 或初始上下文
挂载到 `/home` 的当前运行时。
## 4. 当前判断
- xapp 目录中的对象数量大于当前独立壳数量
- 独立壳只是 xapp 的一种运行形态
- 不能把“当前只有两个独立壳”误写成“系统只有两个 xapp”