7.1 KiB
7.1 KiB
Phase 0:智慧神殿现状与目标
日期:2026-04-08 状态:已完成
1. 本阶段目的
本文件用于统一背景认知,明确:
- Temple 页面当前处于什么状态
- 主要短板是什么
- 为什么要升级
- 升级后的目标形态是什么
2. 当前 Temple 页面状态
2.1 现有实现
frontend/src/pages/temple/index.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:
<!-- 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. 本阶段产出要求
- 团队对 Temple 当前状态和目标方向达成一致
- Tools 系统两套并存的现状已梳理清楚
- Skills 系统现有架构已梳理清楚
- 后续 phase 文档能够在这个认知基础上展开