JARVIS/development-doc/plan/temple-update/README.md

# 智慧神殿（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 天** |