docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
@@ -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”
|
||||
Reference in New Issue
Block a user