# Phase 0：智慧神殿现状与目标

日期：2026-04-08
状态：已完成

---

## 1. 本阶段目的

本文件用于统一背景认知，明确：

- Temple 页面当前处于什么状态
- 主要短板是什么
- 为什么要升级
- 升级后的目标形态是什么

---

## 2. 当前 Temple 页面状态

### 2.1 现有实现

`frontend/src/pages/temple/index.vue` 是一个**空白占位页**：

```vue
<script setup lang="ts">
// 智慧神殿 - Temple of Wisdom
</script>

<template>
  <div class="temple-page">
    <div class="page-header">
      <h1>⛩️ 智慧神殿</h1>
      <p class="subtitle">深邃智慧，永恒传承</p>
    </div>
    <div class="page-content">
      <div class="placeholder-content">
        <div class="temple-icon">🏛️</div>
        <p>智慧神殿 - 敬请期待</p>
      </div>
    </div>
  </div>
</template>
```

### 2.2 触发入口

聊天输入框上方三个按钮之一（`◈`），跳转到 `/temple`：

```html
<!-- frontend/src/pages/chat/index.vue -->
<div class="top-buttons-row">
  <button class="top-action-btn" @click="$router.push('/temple')" title="Temple">
    <span class="btn-icon temple-icon">◈</span>
  </button>
  <button class="top-action-btn" @click="$router.push('/knowledge')" title="Knowledge">
    <span class="btn-icon knowledge-icon">◉</span>
  </button>
  <button class="top-action-btn" @click="$router.push('/war-room')" title="War Room">
    <span class="btn-icon war-icon">⬡</span>
  </button>
</div>
```

---

## 3. 当前系统现状

### 3.1 Tools 系统（两套并存）

#### A. 工具注册层（`app/tools/`）

已建立 manifest 驱动的工具注册体系：

```
app/tools/
├── manifests/              # YAML manifest 定义
│   ├── file_operator.yaml  # 4 commands: read_file, write_file, list_directory, search_files
│   ├── task_manager.yaml   # 5 commands: create_task, list_tasks, get_task, complete_task, fail_task
│   ├── web_fetch.yaml     # 2 commands: fetch, screenshot
│   └── web_search.yaml     # 2 commands: search, deep_search
├── registry.py             # ToolRegistry 动态注册中心
├── implementations/       # 工具 Python 实现
├── permissions.py         # 权限控制
├── hooks/                 # Hook 系统（审计日志、安全扫描、危险确认）
└── schemas/               # Pydantic Schema
```

#### B. Agent 工具层（`app/agents/tools/`）

LangChain `@tool` 装饰器定义的 Agent 可用工具：

| 类别 | 工具 | 源文件 |
|------|------|--------|
| 文件操作 | `glob`, `grep`, `read_file`, `write_file` | `builtins/file_tools.py` |
| 系统命令 | `bash`, `powershell` | `builtins/system_tools.py` |
| 开发工具 | `git`, `lsp_tools` | `builtins/dev_tools.py` |
| 协作工具 | `team_agent`, `task_broadcast` | `builtins/collaboration_tools.py` |
| 知识检索 | `search_knowledge`, `get_knowledge_graph_context`, `build_knowledge_graph`, `hybrid_search`, `web_search` | `search.py` |
| 日程管理 | `get_schedule_day`, `create_todo`, `create_schedule_task`, `create_reminder`, `create_goal` | `schedule.py` |
| 任务管理 | `get_tasks`, `create_task`, `update_task_status` | `task.py` |
| 论坛功能 | `get_forum_posts`, `create_forum_post`, `scan_forum_for_instructions` | `forum.py` |
| 时间推理 | `resolve_time_expression` | `time_reasoning.py` |

### 3.2 Skills 系统

#### A. DB 层

已有完整 CRUD：

- 路由：`/api/skills`
- 字段：`name`, `description`, `instructions`, `agent_type`, `tools`, `visibility`, `is_builtin`, `is_active`
- Agent types：`general`, `schedule_planner`, `executor`, `librarian`, `analyst`
- Visibility：`private`, `team`, `market`

#### B. 文件层

`SkillRegistry` 加载 `.md` 文件供 Agent 运行时使用。

加载器：
- `MCPSkillLoader` - MCP 能力包加载
- `LocalSkillLoader` - 本地 `.md` 文件加载
- `PluginLoader` - 插件式加载

### 3.3 当前问题

| 问题 | 影响 |
|------|------|
| Temple 页面是空白占位页 | 三个按钮入口之一完全无功能 |
| Tools 无统一展示入口 | 用户无法看到系统有哪些可用工具 |
| Tools 散落在两套体系 | manifest 层 + agent 层，用户无感知 |
| Skills 页面独立在 `/skills` | 工具和技能没有统一管理入口 |

---

## 4. 目标架构

```
┌─────────────────────────────────────────────────────────────┐
│                     /temple                                  │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  [◈ 智慧神殿]           [Tools] [Skills]              │   │
│  └──────────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  TOTAL: 30  ACTIVE: 28  AGENTS: 5        (Metrics)   │   │
│  └──────────────────────────────────────────────────────┘   │
│                                                              │
│  ┌────────────────┐  ┌─────────────────────────────────┐   │
│  │ [分类树]       │  │ [工具详情]                       │   │
│  │                │  │                                  │   │
│  │ ▼ 注册层      │  │ file_operator                    │   │
│  │   文件操作    │  │ 描述: 强大的文件系统操作工具     │   │
│  │   任务管理    │  │ 命令: 4 个                      │   │
│  │ ▼ Agent层     │  │ 调用: 1,234 次  错误率: 0.2%   │   │
│  │   知识检索    │  │                                  │   │
│  │   日程管理    │  │ [Commands]                       │   │
│  │   任务管理    │  │ • read_file                     │   │
│  │   论坛功能    │  │ • write_file                    │   │
│  │   时间推理    │  │ • list_directory                │   │
│  └────────────────┘  └─────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
```

---

## 5. 本阶段产出要求

- [x] 团队对 Temple 当前状态和目标方向达成一致
- [x] Tools 系统两套并存的现状已梳理清楚
- [x] Skills 系统现有架构已梳理清楚
- [x] 后续 phase 文档能够在这个认知基础上展开