166 lines
7.9 KiB
Markdown
166 lines
7.9 KiB
Markdown
# 智慧神殿（Temple）升级计划索引
|
||
|
||
本目录用于存放智慧神殿（Temple）页面的升级规划文档。
|
||
|
||
## 文档说明
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `README.md` | 总览、阶段关系、实施顺序、当前状态 |
|
||
| `phase-0-current-state.md` | 当前现状、问题、目标架构 |
|
||
| `phase-1-tools-api.md` | 后端 Tools API 开发 |
|
||
| `phase-2-tools-frontend.md` | Tools Tab 前端实现 |
|
||
| `phase-3-skills-integration.md` | Skills Tab 复用集成 |
|
||
| `checklist.md` | 执行清单 |
|
||
|
||
## 推荐阅读顺序
|
||
|
||
1. 先读 `README.md`（本文）
|
||
2. 再读 `phase-0-current-state.md`
|
||
3. 再按顺序阅读 phase 1 ~ 3
|
||
4. 参考 `checklist.md` 进行任务追踪
|
||
|
||
---
|
||
|
||
## 当前总体状态（2026-04-08）
|
||
|
||
| Phase | 当前状态 | 说明 |
|
||
|------|------|------|
|
||
| Phase 0 | 已完成 | 现状梳理完毕，本文档 |
|
||
| Phase 1 | 待开始 | 后端 Tools API 开发 |
|
||
| Phase 2 | 待开始 | 前端 Tools Tab 实现 |
|
||
| Phase 3 | 待开始 | Skills Tab 复用集成 |
|
||
|
||
---
|
||
|
||
## 总体升级原则
|
||
|
||
1. **Tools 只读不做编辑** - 系统内置工具不允许手动修改，防止配置破坏
|
||
2. **Skills 以 DB 为 source of truth** - UI 操作 DB，后端自动生成 `.md` 文件，用户不直接碰代码
|
||
3. **复用现有 Skills 页面** - 已有完整 CRUD，改动成本最低
|
||
4. **MCP 暂不纳入** - 当前仅为概念性能力包，后期独立需求
|
||
5. **样式沿用现有体系** - 复用 `chatPage.css` 的深色终端风格 + `jarvis-*` CSS 变量
|
||
|
||
---
|
||
|
||
## 阶段关系图
|
||
|
||
```
|
||
Phase 0 ──────────────────────────────────────────────────────────────┐
|
||
│ 现状与目标 │
|
||
│ - Temple 页面现状分析 │
|
||
│ - Tools 系统梳理 │
|
||
│ - Skills 系统梳理 │
|
||
│ - 设计决策 │
|
||
│ 状态：已完成 │
|
||
└────────────────────────────────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
Phase 1 ──────────────────────────────────────────────────────────────┐
|
||
│ 后端 Tools API │
|
||
│ - GET /api/tools 接口开发 │
|
||
│ - ToolRegistry 聚合所有工具 │
|
||
│ - 聚合两套工具体系元数据 │
|
||
│ │
|
||
│ 核心文件: app/routers/tools.py │
|
||
│ 依赖: 无 │
|
||
│ 工作量: 1 天 │
|
||
└────────────────────────────────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
Phase 2 ──────────────────────────────────────────────────────────────┐
|
||
│ 前端 Tools Tab │
|
||
│ - useTemple.ts composable │
|
||
│ - Tools 分类树实现 │
|
||
│ - 工具详情面板 │
|
||
│ - Metrics Strip 统计行 │
|
||
│ │
|
||
│ 核心文件: frontend/src/pages/temple/ │
|
||
│ 依赖: Phase 1 │
|
||
│ 工作量: 2 天 │
|
||
└────────────────────────────────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
Phase 3 ──────────────────────────────────────────────────────────────┐
|
||
│ Skills Tab 复用集成 │
|
||
│ - 确认现有 Skills 页面功能完整 │
|
||
│ - 与 Temple 页面 Tab 切换联动 │
|
||
│ - 样式一致性检查 │
|
||
│ │
|
||
│ 核心文件: frontend/src/pages/temple/, frontend/src/pages/skills/ │
|
||
│ 依赖: Phase 2 │
|
||
│ 工作量: 0.5 天 │
|
||
└────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 两套 Tools 体系梳理
|
||
|
||
### 注册层工具（`app/tools/`）
|
||
|
||
| 工具 | Manifest | 命令数 |
|
||
|------|---------|--------|
|
||
| `file_operator` | `manifests/file_operator.yaml` | 4 |
|
||
| `task_manager` | `manifests/task_manager.yaml` | 5 |
|
||
| `web_fetch` | `manifests/web_fetch.yaml` | 2 |
|
||
| `web_search` | `manifests/web_search.yaml` | 2 |
|
||
|
||
### Agent 内置层工具（`app/agents/tools/`）
|
||
|
||
| 类别 | 工具数 | 来源文件 |
|
||
|------|--------|---------|
|
||
| 文件操作 | 4 | `builtins/file_tools.py` |
|
||
| 系统命令 | 2 | `builtins/system_tools.py` |
|
||
| 开发工具 | 2 | `builtins/dev_tools.py` |
|
||
| 协作工具 | 2 | `builtins/collaboration_tools.py` |
|
||
| 知识检索 | 5 | `search.py` |
|
||
| 日程管理 | 5 | `schedule.py` |
|
||
| 任务管理 | 3 | `task.py` |
|
||
| 论坛功能 | 3 | `forum.py` |
|
||
| 时间推理 | 1 | `time_reasoning.py` |
|
||
|
||
**合计约 34 个工具命令**
|
||
|
||
---
|
||
|
||
## 设计决策记录
|
||
|
||
| 决策 | 原因 |
|
||
|------|------|
|
||
| Tools 只读不做编辑 | 系统内置工具不允许用户手动修改，防止配置破坏 |
|
||
| 不引入 MCP 管理 | 当前 MCP 仅为概念性能力包，无实际 server 连接需求，后期独立需求 |
|
||
| Skills 以 DB 为 source of truth | UI 操作 DB，后端同步生成 .md 文件，用户不直接碰代码 |
|
||
| 复用现有 Skills 页面 | 已有完整 CRUD，改动成本最低 |
|
||
| 按工具来源分类 | 与代码结构对应，用户可追溯工具定义位置 |
|
||
|
||
---
|
||
|
||
## 文件变更追踪
|
||
|
||
| Phase | 新增文件 | 修改文件 |
|
||
|-------|---------|---------|
|
||
| Phase 1 | `app/routers/tools.py`, `app/schemas/tools.py` | `app/main.py`（注册路由） |
|
||
| Phase 2 | `frontend/src/pages/temple/index.vue`, `templePage.css`, `composables/useTemple.ts`, `frontend/src/api/tools.ts` | `frontend/src/pages/temple/index.vue`（重写占位页） |
|
||
| Phase 3 | 无 | `frontend/src/pages/temple/index.vue`（Tab 切换逻辑） |
|
||
|
||
---
|
||
|
||
## 与其他 Phase 的关系
|
||
|
||
| 相关模块 | 协作内容 |
|
||
|---------|---------|
|
||
| Skills Registry (agent-update Phase 9) | Skills 的 DB 层由 `/api/skills` 提供，文件层由 SkillRegistry 管理 |
|
||
| Tool System (tool-update T.1-T.4) | Temple 展示的 Tools 元数据来自 tool-update 建立的 manifest 系统 |
|
||
|
||
---
|
||
|
||
## 总工作量
|
||
|
||
| Phase | 工作量 |
|
||
|-------|--------|
|
||
| Phase 1 | 1 天 |
|
||
| Phase 2 | 2 天 |
|
||
| Phase 3 | 0.5 天 |
|
||
| **总计** | **3.5 天** |
|