7.9 KiB
7.9 KiB
智慧神殿（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 |
执行清单 |
推荐阅读顺序
- 先读
README.md（本文） - 再读
phase-0-current-state.md - 再按顺序阅读 phase 1 ~ 3
- 参考
checklist.md进行任务追踪
当前总体状态（2026-04-08）
| Phase | 当前状态 | 说明 |
|---|---|---|
| Phase 0 | 已完成 | 现状梳理完毕，本文档 |
| Phase 1 | 待开始 | 后端 Tools API 开发 |
| Phase 2 | 待开始 | 前端 Tools Tab 实现 |
| Phase 3 | 待开始 | Skills Tab 复用集成 |
总体升级原则
- Tools 只读不做编辑 - 系统内置工具不允许手动修改，防止配置破坏
- Skills 以 DB 为 source of truth - UI 操作 DB，后端自动生成
.md文件，用户不直接碰代码 - 复用现有 Skills 页面 - 已有完整 CRUD，改动成本最低
- MCP 暂不纳入 - 当前仅为概念性能力包，后期独立需求
- 样式沿用现有体系 - 复用
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 天 |