docs(project): 调整中文模块文档位置

docs/前端实现文档/0.前端模块总览.md

@@ -0,0 +1,27 @@
+# 前端模块总览
+
+## 1. 当前原型入口
+
+Studio 原型页面位于 `frontend/src/pages/studio/`，路由集中在 `frontend/src/router/index.ts`，模拟数据位于 `frontend/src/data/studioMock.ts`。
+
+## 2. 页面与模块映射
+
+| 页面 | 模块 |
+|------|------|
+| `StudioDashboardPage.vue` | 工作台与发布就绪 |
+| `KnowledgeWorkspacePage.vue` | 知识资产 |
+| `IngestionPipelinePage.vue` | 文件解析管道 |
+| `ModelWorkspacePage.vue` | 模型与路由 |
+| `WorkflowBuilderPage.vue` | Workflow 编排 |
+| `AgentWorkspacePage.vue` | Agent 对话调试 |
+| `McpImportPage.vue` | MCP 能力接入 |
+| `SkillWorkspacePage.vue` | Skill 编辑 |
+| `ObservabilityPage.vue` | 运行观测 |
+
+## 3. 前端实现原则
+
+- 页面使用聚合 ViewModel，避免页面直接拼多个低层接口。
+- 已落地旧接口保持兼容，新 Studio 接口以聚合资源为主。
+- Long ID 继续按字符串处理，避免 JS 精度问题。
+- 枚举值按整型协议处理，页面展示通过枚举字典或常量映射。
+- 管理后台保持信息密度、稳定布局和清晰状态提示。

docs/前端实现文档/1.系统基础模块前端实现.md

@@ -0,0 +1,28 @@
+# 系统基础模块前端实现
+
+## 1. 页面范围
+
+系统基础前端能力主要体现为枚举字典、上传控件和统一请求处理。当前已有系统枚举管理页，后续 Studio 页面继续复用这些能力。
+
+## 2. API 使用
+
+| 能力 | 接口 |
+|------|------|
+| 枚举管理查询 | `POST /api/sys-enum/queryForManagement` |
+| 枚举详情 | `GET /api/sys-enum/detail` |
+| 枚举保存 | `POST /api/sys-enum/save` |
+| 枚举删除 | `POST /api/sys-enum/delete` |
+| 附件上传 | `POST /api/attachments/upload` |
+
+## 3. 实现约定
+
+- API 层继续使用 `frontend/src/api/request.ts` 解包 `RequestResult<T>`。
+- Long ID 继续通过 `json-bigint` 安全解析。
+- 枚举展示通过字典或本地常量映射，不直接依赖数据库展示顺序。
+- 上传失败时展示后端错误摘要，不吞掉异常。
+
+## 4. Studio 复用点
+
+- 文件解析管道复用附件上传能力。
+- 知识资产、模型路由、Workflow、Agent 等页面复用枚举字典。
+- 运行观测页面复用统一状态颜色和错误提示格式。

docs/前端实现文档/2.知识资产与文件解析模块前端实现.md

@@ -0,0 +1,45 @@
+# 知识资产与文件解析模块前端实现
+
+## 1. 页面
+
+| 页面 | 职责 |
+|------|------|
+| `KnowledgeWorkspacePage.vue` | 展示知识库列表、配置、文档状态和发布影响 |
+| `IngestionPipelinePage.vue` | 展示上传、解析、切片、向量化和任务日志 |
+| 旧 `RagStoresPage.vue` | 保留知识库 CRUD 联调参考 |
+| 旧 `RagDocumentsPage.vue` | 保留知识文档 CRUD 联调参考 |
+
+## 2. 聚合 ViewModel
+
+知识工作台建议使用 `KnowledgeWorkspaceView`：
+
+- 当前知识库基础信息。
+- 文档健康度。
+- Embedding 模型和维度。
+- 检索配置。
+- 文档列表摘要。
+- 待处理任务。
+- 发布影响说明。
+
+文件解析管道建议使用 `IngestionRunView`：
+
+- 上传文件列表。
+- 管道阶段状态。
+- 解析文本预览。
+- 切片预览。
+- 任务日志。
+
+## 3. 接口草案
+
+- `GET /api/knowledge/workspaces/{storeId}`
+- `POST /api/knowledge/ingestion-runs`
+- `GET /api/knowledge/ingestion-runs/{runId}`
+- `POST /api/rag/documents/parse`
+- `POST /api/rag/documents/chunk`
+
+## 4. 交互状态
+
+- 解析失败显示可重试状态。
+- 索引中显示进行中状态，不允许误标为可检索。
+- 切片参数变更后提示需要重建索引。
+- Embedding 模型变更后提示会影响当前知识库向量空间。

docs/前端实现文档/3.模型与路由模块前端实现.md

@@ -0,0 +1,30 @@
+# 模型与路由模块前端实现
+
+## 1. 页面
+
+`ModelWorkspacePage.vue` 当前展示任务路由规则，保留 `model_provider`、`model_config`、`model_route_rule` 语义。
+
+## 2. ViewModel
+
+`ModelRoutingView` 建议包含：
+
+- 服务商健康概览。
+- 模型配置列表。
+- 任务路由规则。
+- Fallback 关系。
+- 最近模型调用失败摘要。
+
+## 3. 接口草案
+
+- `POST /api/model-providers/query`
+- `POST /api/model-configs/query`
+- `POST /api/model-route-rules/query`
+- `POST /api/model-route-rules/save`
+- `GET /api/model-call-logs/query`
+
+## 4. 交互规则
+
+- 禁用服务商时提示关联模型和路由受影响。
+- Embedding 模型维度变更时提示知识库需要重建索引。
+- 草稿路由不得用于生产发布就绪校验。
+- Fallback 模型为空时在发布检查中提示风险。

docs/前端实现文档/4.Workflow编排模块前端实现.md

@@ -0,0 +1,31 @@
+# Workflow 编排模块前端实现
+
+## 1. 页面
+
+`WorkflowBuilderPage.vue` 提供节点库、画布、运行 Trace 抽屉和节点 Inspector。
+
+## 2. ViewModel
+
+`WorkflowBuilderView` 建议包含：
+
+- Workflow 基本信息。
+- 当前草稿版本。
+- 节点列表。
+- 边列表。
+- 当前选中节点配置。
+- 最近测试运行 Trace。
+
+## 3. 接口草案
+
+- `GET /api/workflows/{workflowId}`
+- `POST /api/workflows/save-draft`
+- `POST /api/workflows/{workflowId}/publish`
+- `POST /api/workflows/{workflowId}/runs`
+- `GET /api/workflows/runs/{runId}`
+
+## 4. 交互规则
+
+- 保存草稿只更新草稿版本。
+- 运行测试生成 `workflow_run` 和 `workflow_run_step`。
+- 发布前调用发布就绪检查。
+- 节点 Inspector 只编辑当前节点配置，不直接改其他节点。

docs/前端实现文档/5.Agent会话模块前端实现.md

@@ -0,0 +1,33 @@
+# Agent 会话模块前端实现
+
+## 1. 页面
+
+`AgentWorkspacePage.vue` 当前展示 Agent 对话调试、引用切片、运行追踪和成本延迟指标。
+
+## 2. ViewModel
+
+`AgentWorkspaceView` 建议包含：
+
+- 当前 Agent 基本信息。
+- 当前会话消息列表。
+- 输入框状态。
+- 引用切片列表。
+- 模型请求 ID。
+- 运行追踪步骤。
+- 成本、延迟和 Token 统计。
+
+## 3. 接口草案
+
+- `POST /api/agents/{agentId}/runs`
+- `GET /api/agents/{agentId}/sessions`
+- `GET /api/agent-sessions/{sessionId}`
+- `POST /api/agent-sessions/{sessionId}/messages`
+
+现有 `POST /api/agents/{agentId}/chat` 保留为兼容调试入口。
+
+## 4. 交互规则
+
+- RAG 开关关闭时不展示引用切片。
+- 未召回知识切片时给出明确提示。
+- 模型调用失败时展示 `request_id` 和错误摘要。
+- 会话保存失败不得清空用户输入。

docs/前端实现文档/6.MCP能力接入模块前端实现.md

@@ -0,0 +1,19 @@
+# MCP 能力接入模块前端实现
+
+## 1. 页面
+
+`McpImportPage.vue` 展示导入方式、Manifest 预览和能力预览。
+
+## 2. 接口草案
+
+- `POST /api/mcp/import`
+- `GET /api/mcp/servers/{serverCode}/capabilities`
+- `POST /api/mcp/servers/query`
+- `POST /api/mcp/capabilities/save`
+
+## 3. 交互规则
+
+- 导入前校验地址或 Manifest 格式。
+- 能力预览成功后才允许保存。
+- 未授权能力显示待授权状态。
+- 已停用 Server 的能力不可被 Workflow 新增选择。

docs/前端实现文档/7.Skill编辑模块前端实现.md

@@ -0,0 +1,19 @@
+# Skill 编辑模块前端实现
+
+## 1. 页面
+
+`SkillWorkspacePage.vue` 提供 Prompt、Code、Config 编辑区，测试面板和版本列表。
+
+## 2. 接口草案
+
+- `GET /api/skills/{skillCode}`
+- `PUT /api/skills/{skillCode}/draft`
+- `POST /api/skills/{skillCode}/test`
+- `POST /api/skills/{skillCode}/publish`
+
+## 3. 交互规则
+
+- 发布版本只读。
+- 草稿变更后提示未发布。
+- 测试结果保存到版本草稿。
+- Workflow 只能选择发布版本或明确选择草稿测试。

docs/前端实现文档/8.运行观测模块前端实现.md

@@ -0,0 +1,28 @@
+# 运行观测模块前端实现
+
+## 1. 页面
+
+`ObservabilityPage.vue` 展示运行记录和步骤日志。
+
+## 2. ViewModel
+
+`ObservabilityView` 建议包含：
+
+- 运行列表。
+- 当前运行详情。
+- 步骤日志。
+- 模型调用摘要。
+- 成本和延迟统计。
+
+## 3. 接口草案
+
+- `GET /api/observability/runs`
+- `GET /api/observability/runs/{requestId}`
+- `GET /api/observability/model-calls`
+- `GET /api/observability/runs/{requestId}/export`
+
+## 4. 交互规则
+
+- 异常运行高亮展示。
+- 步骤日志按执行时间排序。
+- 导出日志不包含密钥或完整敏感请求体。