docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# RN01 — 任务、项目、运行记录与交付物
|
||||
|
||||
> 状态:当前有效
|
||||
> 最后更新:2026-09-21
|
||||
|
||||
## 1. 当前运行容器
|
||||
|
||||
当前后端运行中心按以下关系理解:
|
||||
|
||||
`project -> task_record -> task_run -> task_artifact`
|
||||
|
||||
## 2. 当前对象职责
|
||||
|
||||
- `project`:任务容器
|
||||
- `task_record`:运行主记录
|
||||
- `task_run`:单次执行记录
|
||||
- `task_artifact`:交付结果
|
||||
|
||||
## 3. 当前执行关系
|
||||
|
||||
- task 当前仍以 `specialist_key` 为主要执行挂载点
|
||||
- project 为 task 提供分组和上下文容器
|
||||
- artifact 为运行结果提供持久化输出
|
||||
|
||||
## 4. 当前判断
|
||||
|
||||
- 运行中心是后端主轴之一
|
||||
- 它与对象中心并列,不从属于兼容业务域
|
||||
- 当前系统仍以 specialist-led task 为主要执行形态
|
||||
@@ -0,0 +1,44 @@
|
||||
# RN02 — 工作台对话、AI 执行与兼容入口
|
||||
|
||||
> 状态:当前有效
|
||||
> 代码依据:`backend-go/internal/api/chat_message.go`、`backend-go/internal/api/ai_chat.go`
|
||||
> 最后更新:2026-09-21
|
||||
|
||||
## 1. 当前主入口
|
||||
|
||||
当前 Workbench 主对话入口是:
|
||||
|
||||
- `POST /api/chat/message`
|
||||
|
||||
## 2. 当前作用
|
||||
|
||||
它负责:
|
||||
|
||||
- 接收用户消息
|
||||
- 解析 task 与 specialist 上下文
|
||||
- 选择 AI 路由
|
||||
- 发起模型调用
|
||||
- 写入 AI 审计记录
|
||||
|
||||
## 3. 当前挂载关系
|
||||
|
||||
当前对话支持两类挂载来源:
|
||||
|
||||
1. 通过 `task_id` 反查任务上的 specialist
|
||||
2. 直接通过 `specialist_key` 指定 specialist
|
||||
|
||||
## 4. 当前兼容入口
|
||||
|
||||
系统继续保留:
|
||||
|
||||
- `POST /api/ai-chat/message`
|
||||
- `GET /api/ai-chat/quick-actions`
|
||||
- `POST /api/ai-chat/quick-action`
|
||||
|
||||
这组接口属于兼容入口,继续服务旧前端与快捷动作能力。
|
||||
|
||||
## 5. 当前判断
|
||||
|
||||
- `/api/chat/message` 是当前运行中心的主入口
|
||||
- 工作台对话已经和 task / specialist 形成直接关系
|
||||
- 办公生成、审查、翻译、校对等能力围绕这条执行链继续扩展
|
||||
@@ -0,0 +1,16 @@
|
||||
# 03_运行中心 — 目录说明
|
||||
|
||||
本目录描述当前后端的运行容器和执行链路。
|
||||
|
||||
当前核心对象包括:
|
||||
|
||||
- `project`
|
||||
- `task_record`
|
||||
- `task_run`
|
||||
- `task_artifact`
|
||||
- `/api/chat/message`
|
||||
|
||||
建议阅读顺序:
|
||||
|
||||
1. `RN01_任务_项目_运行记录_交付物.md`
|
||||
2. `RN02_工作台对话_AI执行与兼容入口.md`
|
||||
Reference in New Issue
Block a user