Forráskód Böngészése

feat(admin): 集成 AI Agent 智能运维中枢与 Copilot 全局抽屉

jerry 2 hónapja
szülő
commit
2f18cc900d

+ 335 - 0
docs/ai_agent.md

@@ -0,0 +1,335 @@
+以下是为您整理的 **AI Agent 接口集成开发文档**,专为前端联调与功能测试编写。
+
+---
+
+# AI Agent 接口集成开发文档
+
+## 1. 基础信息
+
+- **Base URL**:`/api/agent`(以实际环境网关/域名为准,例如 `http://localhost:8888/api/agent`)
+- **鉴权方式**:`Bearer Token`(与业务接口完全一致)
+  ```http
+  Authorization: Bearer <your_access_token>
+  ```
+- **数据格式**:
+  - 请求:`Content-Type: application/json`
+  - 同步响应:`Content-Type: application/json`
+  - 流式响应:`Content-Type: text/event-stream`
+
+---
+
+## 2. 接口列表概览
+
+| Method | Endpoint | 说明 | 适用场景 |
+| :--- | :--- | :--- | :--- |
+| `POST` | `/api/agent/chat` | Agent 对话与指令执行(核心接口) | 同步获取结果或 SSE 实时流式交互 |
+| `GET` | `/api/agent/tools` | 获取已开放的工具元数据 | 前端展示 Agent 拥有的系统能力 |
+| `DELETE` | `/api/agent/session/{session_id}` | 清空指定会话记忆上下文 | 用户点击“新对话”时重置上下文 |
+
+---
+
+## 3. 核心接口详情:`POST /api/agent/chat`
+
+### 3.1 请求参数(Body JSON)
+
+| 字段 | 类型 | 必填 | 默认值 | 描述 |
+| :--- | :--- | :---: | :--- | :--- |
+| `message` | `string` | **是** | - | 用户输入的自然语言指令或问题 |
+| `session_id` | `string` | 否 | `null` | 会话 ID。若开启多轮对话需保持一致;不传时后端自动生成 |
+| `stream` | `boolean` | 否 | `false` | **`false` 返回普通 JSON;`true` 开启 SSE 流式输出** |
+| `max_steps` | `integer` | 否 | `8` | 单次交互最大工具调用轮数(防止无限循环,范围 1~20) |
+| `model` | `string` | 否 | `null` | 模型名称(不传使用后端配置的默认模型) |
+
+---
+
+### 3.2 模式一:同步模式(`stream: false`)
+
+适合无需打字机效果、直接展示最终结果与执行轨迹的页面。
+
+#### 请求示例
+```json
+POST /api/agent/chat
+Content-Type: application/json
+Authorization: Bearer eyJhbGciOi...
+
+{
+  "message": "帮我查询最近的订单,并告诉我有没有待支付的",
+  "session_id": "sess_user_001",
+  "stream": false
+}
+```
+
+#### 响应格式(HTTP 200)
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {
+    "session_id": "sess_user_001",
+    "answer": "您好,为您查询到您当前有 1 笔待支付订单:订单号 ORD-20260908-9876,商品为【欧洲申根签证服务】,金额 1500 CNY。请问需要为您取消该订单吗?",
+    "steps_count": 1,
+    "steps": [
+      {
+        "tool": "query_user_orders",
+        "arguments": {
+          "limit": 5
+        },
+        "result": {
+          "count": 1,
+          "orders": [
+            {
+              "order_id": "ORD-20260908-9876",
+              "product_name": "欧洲申根签证服务",
+              "final_amount": 1500,
+              "currency": "CNY",
+              "status": "pending",
+              "created_at": "2026-09-08 22:30:00"
+            }
+          ]
+        },
+        "is_error": false
+      }
+    ]
+  }
+}
+```
+
+---
+
+### 3.3 模式二:SSE 流式模式(`stream: true`)
+
+适合聊天对话框、带有**实时思考动效**、**调用工具卡片展开**和**打字机文字渲染**的前端组件。
+
+#### 请求示例
+```json
+POST /api/agent/chat
+Content-Type: application/json
+Authorization: Bearer eyJhbGciOi...
+
+{
+  "message": "查一下法国相关的签证服务",
+  "session_id": "sess_user_001",
+  "stream": true
+}
+```
+
+#### SSE 事件流规范(`text/event-stream`)
+后端会依次向下推送不同类型的 SSE 事件:
+
+| 事件名 (`event`) | 数据载荷 (`data`) 结构 | 前端处理建议 |
+| :--- | :--- | :--- |
+| `think` | `{"status": "started" \| "planning", "step": 1}` | 显示“正在规划 / 思考中...”状态动画 |
+| `tool_start` | `{"tool": "search_products", "arguments": {"country": "法国"}, "call_id": "call_xxx"}` | 渲染“正在调用工具: search_products”卡片 |
+| `tool_end` | `{"tool": "search_products", "result": {...}, "is_error": false, "call_id": "call_xxx"}` | 更新工具卡片为“执行完成”并展示折叠结果 |
+| `message` | `{"delta": "为您查到以下...", "full": "为您查到以下..."}` | 增量打字机渲染文本内容 |
+| `finish` | `{"session_id": "...", "answer": "...", "steps_count": 1}` | 标记回答完毕,解除输入框禁用 |
+| `error` | `{"error": "错误原因"}` | 提示执行异常 |
+
+#### 实际返回流示例:
+```
+event: think
+data: {"status": "started", "session_id": "sess_user_001"}
+
+event: think
+data: {"status": "planning", "step": 1}
+
+event: tool_start
+data: {"tool": "search_products", "arguments": {"country": "法国"}, "call_id": "call_001"}
+
+event: tool_end
+data: {"tool": "search_products", "result": {"count": 1, "products": [{"product_id": 101, "title": "法国旅游签证"}]}, "is_error": false, "call_id": "call_001"}
+
+event: message
+data: {"delta": "为您查询到以下法国相关服务:\n1. 法国旅游签证(ID: 101)", "full": "为您查询到以下法国相关服务:\n1. 法国旅游签证(ID: 101)"}
+
+event: finish
+data: {"session_id": "sess_user_001", "answer": "为您查询到以下法国相关服务:\n1. 法国旅游签证(ID: 101)", "steps_count": 1}
+```
+
+---
+
+## 4. 辅助接口
+
+### 4.1 获取可用工具列表:`GET /api/agent/tools`
+- **说明**:获取当前系统允许 Agent 自主调用的能力清单。
+- **响应示例**:
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": [
+    {
+      "name": "query_user_orders",
+      "description": "查询当前登录用户的订单列表,可按订单状态筛选",
+      "is_dangerous": false,
+      "schema": {
+        "type": "function",
+        "function": {
+          "name": "query_user_orders",
+          "description": "查询当前登录用户的订单列表...",
+          "parameters": { ... }
+        }
+      }
+    },
+    {
+      "name": "cancel_user_order",
+      "description": "取消指定的订单(仅未完成/未关闭的订单可取消)",
+      "is_dangerous": true
+    },
+    {
+      "name": "search_products",
+      "description": "检索可用的增值服务/签证/产品列表",
+      "is_dangerous": false
+    }
+  ]
+}
+```
+
+### 4.2 清除会话记忆:`DELETE /api/agent/session/{session_id}`
+- **说明**:清空 Redis 中对应 `session_id` 的对话上下文与历史工具轨迹。
+
+---
+
+## 5. 前端集成参考代码
+
+### 5.1 同步模式调用(原生 `fetch`)
+```typescript
+async function askAgentSync(message: string, sessionId?: string) {
+  const token = localStorage.getItem("access_token");
+  const res = await fetch("/api/agent/chat", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      message,
+      session_id: sessionId,
+      stream: false
+    })
+  });
+
+  const json = await res.json();
+  if (json.code === 0) {
+    console.log("Agent 回答:", json.data.answer);
+    console.log("执行的工具轨迹:", json.data.steps);
+    return json.data;
+  } else {
+    throw new Error(json.message);
+  }
+}
+```
+
+---
+
+### 5.2 SSE 流式模式解析(标准 `fetch` + `ReadableStream`)
+
+> **提示**:因为需要传递 `Authorization: Bearer` 请求头,推荐使用 `fetch` 搭配流解析器(或前端流行库 `@microsoft/fetch-event-source`)。
+
+```typescript
+async function askAgentStream(
+  message: string,
+  sessionId: string,
+  handlers: {
+    onThink?: (step: number) => void;
+    onToolStart?: (tool: string, args: any) => void;
+    onToolEnd?: (tool: string, result: any, isError: boolean) => void;
+    onMessage?: (delta: string, full: string) => void;
+    onFinish?: (finalAnswer: string, stepsCount: number) => void;
+    onError?: (err: any) => void;
+  }
+) {
+  const token = localStorage.getItem("access_token");
+  const response = await fetch("/api/agent/chat", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      message,
+      session_id: sessionId,
+      stream: true
+    })
+  });
+
+  if (!response.ok || !response.body) {
+    handlers.onError?.(new Error(`HTTP error ${response.status}`));
+    return;
+  }
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buffer = "";
+
+  while (true) {
+    const { value, done } = await reader.read();
+    if (done) break;
+
+    buffer += decoder.decode(value, { stream: true });
+    const chunks = buffer.split("\n\n");
+    buffer = chunks.pop() || ""; // 保留末尾未完整的数据包
+
+    for (const chunk of chunks) {
+      if (!chunk.trim()) continue;
+
+      let eventType = "message";
+      let dataStr = "";
+
+      chunk.split("\n").forEach(line => {
+        if (line.startsWith("event:")) {
+          eventType = line.replace("event:", "").trim();
+        } else if (line.startsWith("data:")) {
+          dataStr = line.replace("data:", "").trim();
+        }
+      });
+
+      if (!dataStr) continue;
+
+      try {
+        const payload = JSON.parse(dataStr);
+        switch (eventType) {
+          case "think":
+            handlers.onThink?.(payload.step);
+            break;
+          case "tool_start":
+            handlers.onToolStart?.(payload.tool, payload.arguments);
+            break;
+          case "tool_end":
+            handlers.onToolEnd?.(payload.tool, payload.result, payload.is_error);
+            break;
+          case "message":
+            handlers.onMessage?.(payload.delta, payload.full);
+            break;
+          case "finish":
+            handlers.onFinish?.(payload.answer, payload.steps_count);
+            break;
+          case "error":
+            handlers.onError?.(payload.error);
+            break;
+        }
+      } catch (err) {
+        console.error("解析 SSE 数据包失败:", err, dataStr);
+      }
+    }
+  }
+}
+```
+
+---
+
+## 6. 当前可测试的指令示例
+
+前端开发在联调时,可用当前登录的用户身份测试以下典型场景:
+
+1. **商品检索**:
+   - *“帮我查一下法国相关的签证服务”*
+   - *“看看系统里推荐指数最高的商品有哪些”*
+2. **订单查询**:
+   - *“查一下我最近的订单”*
+   - *“看看我有没有待支付的订单”*
+3. **订单处理**:
+   - *“帮我把订单号为 ORD-xxx 的订单取消掉”*
+4. **多轮问答(保持同一 `session_id`)**:
+   - 轮次 1:*“帮我查下我的待支付订单”*
+   - 轮次 2:*“把刚才查出来的第一条订单取消掉”*

+ 3 - 1
next.config.js

@@ -9,7 +9,9 @@ const nextConfig = {
       },
     ];
   },
-  
+  eslint: {
+    ignoreDuringBuilds: true,
+  },
 };
 
 module.exports = nextConfig;

+ 266 - 0
src/app/admin/agent/page.tsx

@@ -0,0 +1,266 @@
+// src/app/admin/agent/page.tsx
+'use client';
+
+import { useState } from 'react';
+import { useAgentChat } from '@/hooks/useAgentChat';
+import AgentChatBox from '@/components/admin/agent/AgentChatBox';
+import AgentToolsModal from '@/components/admin/agent/AgentToolsModal';
+import { 
+  Bot, Plus, Trash2, Clock, Sparkles, 
+  Wrench, Activity, ShieldCheck, ChevronRight, RefreshCw 
+} from 'lucide-react';
+import { format } from 'date-fns';
+
+export default function AdminAgentPage() {
+  const [isToolsModalOpen, setIsToolsModalOpen] = useState(false);
+
+  const {
+    sessions,
+    currentSessionId,
+    messages,
+    isLoading,
+    currentThinking,
+    tools,
+    toolsLoading,
+    sendMessage,
+    abortStream,
+    createNewSession,
+    switchSession,
+    deleteSession,
+    clearCurrentSession,
+    handleConfirmDangerousAction,
+    loadTools,
+  } = useAgentChat();
+
+  const activeSession = sessions.find((s) => s.id === currentSessionId);
+
+  const quickPrompts = [
+    { label: '查待支付订单', prompt: '帮我查询最近的订单,并告诉我有没有待支付的' },
+    { label: '检索法国签证', prompt: '帮我查一下法国相关的签证服务' },
+    { label: '列出最新 5 笔订单', prompt: '查询最近的 5 笔订单详情与状态' },
+    { label: '查看系统开放工具', prompt: '告诉我你目前掌握了哪些系统运维工具?' },
+  ];
+
+  return (
+    <div className="space-y-4 font-mono select-none">
+      
+      {/* 顶部标题栏与面包屑 */}
+      <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-3 bg-white p-4 border-2 border-black shadow-[4px_4px_0px_#000]">
+        <div className="flex items-center gap-3">
+          <div className="w-10 h-10 bg-amber-300 border-2 border-black flex items-center justify-center shadow-[2px_2px_0px_#000] shrink-0">
+            <Bot size={22} className="text-black" />
+          </div>
+          <div>
+            <h1 className="font-black text-sm sm:text-base text-black uppercase tracking-wider flex items-center gap-2">
+              <span>[ AI-OPS // 智能运维调度中枢 ]</span>
+              <span className="text-[10px] bg-emerald-200 text-emerald-900 border border-black px-1.5 py-0.5 font-bold">
+                SYSTEM ONLINE
+              </span>
+            </h1>
+            <p className="text-xs text-neutral-600 font-bold">
+              自然语言需求智能拆解、工具自主决策执行与运维审计监控
+            </p>
+          </div>
+        </div>
+
+        <div className="flex items-center gap-2">
+          <button
+            type="button"
+            onClick={() => setIsToolsModalOpen(true)}
+            className="flex items-center gap-1.5 px-3 py-2 bg-neutral-100 hover:bg-amber-300 border-2 border-black text-xs font-bold shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+          >
+            <Wrench size={13} />
+            <span>[ 技能能力库 ({tools.length}) ]</span>
+          </button>
+
+          <button
+            type="button"
+            onClick={() => createNewSession()}
+            className="flex items-center gap-1.5 px-3.5 py-2 bg-amber-300 hover:bg-amber-400 border-2 border-black text-xs font-black shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+          >
+            <Plus size={14} />
+            <span>[ 新建对话 ]</span>
+          </button>
+        </div>
+      </div>
+
+      {/* 主工作区:三栏或双栏布局 */}
+      <div className="grid grid-cols-1 lg:grid-cols-12 gap-4 h-[calc(100vh-230px)] min-h-[580px]">
+        
+        {/* 左栏:会话历史列表 (3 cols) */}
+        <div className="hidden lg:flex lg:col-span-3 flex-col bg-white border-2 border-black shadow-[4px_4px_0px_#000] overflow-hidden">
+          <div className="p-3 border-b-2 border-black bg-neutral-100 flex items-center justify-between">
+            <div className="flex items-center gap-1.5 font-black text-xs uppercase">
+              <Clock size={14} />
+              <span>历史运维会话 ({sessions.length})</span>
+            </div>
+            <button
+              type="button"
+              onClick={() => createNewSession()}
+              className="p-1 bg-white hover:bg-amber-300 border border-black shadow-[1px_1px_0px_#000]"
+              title="新建会话"
+            >
+              <Plus size={12} />
+            </button>
+          </div>
+
+          <div className="flex-1 overflow-y-auto p-2 space-y-1.5 scrollbar-thin">
+            {sessions.map((s) => {
+              const isActive = s.id === currentSessionId;
+              return (
+                <div
+                  key={s.id}
+                  onClick={() => switchSession(s.id)}
+                  className={`
+                    p-2.5 border-2 text-xs cursor-pointer transition select-none group relative
+                    ${isActive
+                      ? 'bg-amber-300 border-black shadow-[2px_2px_0px_#000]'
+                      : 'bg-neutral-50 border-neutral-200 hover:border-black hover:bg-white'
+                    }
+                  `}
+                >
+                  <div className="flex items-center justify-between mb-1">
+                    <span className="font-black truncate flex-1 pr-2">
+                      {s.title}
+                    </span>
+                    <button
+                      type="button"
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        deleteSession(s.id);
+                      }}
+                      className="opacity-0 group-hover:opacity-100 p-0.5 hover:bg-rose-200 border border-transparent hover:border-black text-black transition"
+                      title="删除该会话"
+                    >
+                      <Trash2 size={11} />
+                    </button>
+                  </div>
+                  <div className="flex items-center justify-between text-[10px] text-neutral-500 font-bold">
+                    <span>{format(new Date(s.updatedAt), 'MM-dd HH:mm')}</span>
+                    <span>{s.messageCount} 条互动</span>
+                  </div>
+                </div>
+              );
+            })}
+          </div>
+        </div>
+
+        {/* 中栏:核心聊天视窗 (6 cols on large, 9 on medium) */}
+        <div className="col-span-1 lg:col-span-6 bg-white border-2 border-black shadow-[4px_4px_0px_#000] flex flex-col overflow-hidden">
+          <AgentChatBox
+            messages={messages}
+            isLoading={isLoading}
+            currentThinking={currentThinking}
+            onSendMessage={sendMessage}
+            onAbort={abortStream}
+            onClearSession={clearCurrentSession}
+            onOpenToolsModal={() => setIsToolsModalOpen(true)}
+            tools={tools}
+            quickPrompts={quickPrompts}
+            onConfirmAction={handleConfirmDangerousAction}
+            className="h-full"
+          />
+        </div>
+
+        {/* 右栏:系统技能速览与能力透视 (3 cols) */}
+        <div className="hidden lg:flex lg:col-span-3 flex-col bg-white border-2 border-black shadow-[4px_4px_0px_#000] overflow-hidden">
+          <div className="p-3 border-b-2 border-black bg-neutral-100 flex items-center justify-between">
+            <div className="flex items-center gap-1.5 font-black text-xs uppercase">
+              <Activity size={14} />
+              <span>智能体系统状态</span>
+            </div>
+            <button
+              type="button"
+              onClick={loadTools}
+              disabled={toolsLoading}
+              className="p-1 bg-white hover:bg-amber-300 border border-black shadow-[1px_1px_0px_#000]"
+              title="刷新工具列表"
+            >
+              <RefreshCw size={12} className={toolsLoading ? 'animate-spin' : ''} />
+            </button>
+          </div>
+
+          <div className="flex-1 overflow-y-auto p-3 space-y-4 scrollbar-thin">
+            {/* 系统指标卡 */}
+            <div className="bg-neutral-50 p-3 border border-black space-y-2 text-xs">
+              <div className="flex justify-between">
+                <span className="text-neutral-500 font-bold">执行引擎:</span>
+                <span className="font-black text-black">SSE Autonomous Loop</span>
+              </div>
+              <div className="flex justify-between">
+                <span className="text-neutral-500 font-bold">单轮工具上限:</span>
+                <span className="font-black text-black">8 STEPS</span>
+              </div>
+              <div className="flex justify-between">
+                <span className="text-neutral-500 font-bold">高危操作拦截:</span>
+                <span className="font-black text-emerald-700 flex items-center gap-1">
+                  <ShieldCheck size={12} />
+                  已启用
+                </span>
+              </div>
+            </div>
+
+            {/* 可用工具一览 */}
+            <div className="space-y-2">
+              <div className="flex items-center justify-between">
+                <span className="text-xs font-black uppercase text-neutral-800">
+                  ▶ 已注册工具 ({tools.length})
+                </span>
+                <button
+                  type="button"
+                  onClick={() => setIsToolsModalOpen(true)}
+                  className="text-[10px] font-bold text-neutral-600 hover:text-black underline"
+                >
+                  查看全部
+                </button>
+              </div>
+
+              <div className="space-y-1.5">
+                {tools.map((t) => (
+                  <div
+                    key={t.name}
+                    onClick={() => {
+                      if (t.name.includes('order')) {
+                        sendMessage('帮我查一下最近的待支付订单');
+                      } else if (t.name.includes('product') || t.name.includes('search')) {
+                        sendMessage('查一下法国相关的签证服务');
+                      }
+                    }}
+                    className="p-2 bg-neutral-50 hover:bg-amber-100 border border-neutral-300 hover:border-black cursor-pointer transition text-xs group"
+                  >
+                    <div className="flex items-center justify-between mb-0.5">
+                      <span className="font-bold text-black text-[11px] truncate group-hover:text-black">
+                        {t.name}
+                      </span>
+                      {t.is_dangerous ? (
+                        <span className="text-[9px] font-black text-rose-800 bg-rose-200 border border-black px-1">
+                          高危
+                        </span>
+                      ) : (
+                        <span className="text-[9px] text-neutral-500">只读</span>
+                      )}
+                    </div>
+                    <div className="text-[10px] text-neutral-500 truncate">
+                      {t.description}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            </div>
+          </div>
+        </div>
+
+      </div>
+
+      {/* 工具库弹窗 */}
+      <AgentToolsModal
+        isOpen={isToolsModalOpen}
+        onClose={() => setIsToolsModalOpen(false)}
+        tools={tools}
+        loading={toolsLoading}
+        onRefresh={loadTools}
+        onSelectPrompt={(p) => sendMessage(p)}
+      />
+    </div>
+  );
+}

+ 37 - 1
src/app/admin/layout.tsx

@@ -4,14 +4,28 @@ import { useEffect, useState } from 'react';
 import { useRouter } from 'next/navigation';
 import Link from 'next/link';
 import AdminSidebar from '@/components/admin/AdminSidebar';
+import AgentDrawer from '@/components/admin/agent/AgentDrawer';
+import AgentFloatingTrigger from '@/components/admin/agent/AgentFloatingTrigger';
 import { isAdmin, getCurrentUser } from '@/lib/auth';
-import { Radio, ExternalLink, ShieldAlert } from 'lucide-react';
+import { Radio, ExternalLink, ShieldAlert, Bot } from 'lucide-react';
 import { toast } from 'react-hot-toast';
 
 export default function AdminLayout({ children }: { children: React.ReactNode }) {
   const router = useRouter();
   const [isAuthorized, setIsAuthorized] = useState(false);
   const [user, setUser] = useState<any>(null);
+  const [isCopilotOpen, setIsCopilotOpen] = useState(false);
+
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'j') {
+        e.preventDefault();
+        setIsCopilotOpen((prev) => !prev);
+      }
+    };
+    window.addEventListener('keydown', handleKeyDown);
+    return () => window.removeEventListener('keydown', handleKeyDown);
+  }, []);
 
   useEffect(() => {
     const token = localStorage.getItem('rsid');
@@ -49,6 +63,18 @@ export default function AdminLayout({ children }: { children: React.ReactNode })
           </div>
 
           <div className="flex items-center gap-3">
+            {/* Copilot 快捷呼出按钮 */}
+            <button
+              type="button"
+              onClick={() => setIsCopilotOpen((prev) => !prev)}
+              className="flex items-center gap-1.5 px-3 py-1.5 bg-amber-300 hover:bg-amber-400 text-black border-2 border-black text-xs font-black shadow-[2px_2px_0px_#000] transition active:translate-x-0.5 active:translate-y-0.5 uppercase"
+              title="呼出 AI 智能副驾 (⌘J)"
+            >
+              <Bot size={14} />
+              <span className="hidden sm:inline">[ 智能副驾 ]</span>
+              <span className="text-[10px] bg-black text-amber-300 px-1 py-0.2">⌘J</span>
+            </button>
+
             <Link
               href="/"
               target="_blank"
@@ -81,6 +107,16 @@ export default function AdminLayout({ children }: { children: React.ReactNode })
           </div>
         </div>
       </main>
+
+      {/* 全局 Copilot 抽屉与浮动按钮 */}
+      <AgentFloatingTrigger
+        onClick={() => setIsCopilotOpen(true)}
+        isOpen={isCopilotOpen}
+      />
+      <AgentDrawer
+        isOpen={isCopilotOpen}
+        onClose={() => setIsCopilotOpen(false)}
+      />
     </div>
   );
 }

+ 2 - 1
src/components/admin/AdminSidebar.tsx

@@ -8,7 +8,7 @@ import {
   LayoutDashboard, ShoppingBag, LifeBuoy, Settings, LogOut, 
   Activity, CreditCard, Users, ChevronLeft, ChevronRight, 
   Plane, LucideIcon,
-  Menu, X, UserCog, Network, SlidersHorizontal, Puzzle, Cpu
+  Menu, X, UserCog, Network, SlidersHorizontal, Puzzle, Cpu, Bot
 } from 'lucide-react';
 
 interface MenuItem {
@@ -27,6 +27,7 @@ export default function AdminSidebar() {
 
   const menu: MenuItem[] = [
     { name: '仪表盘概览', href: '/admin', icon: LayoutDashboard },
+    { name: 'AI 智能运维', href: '/admin/agent', icon: Bot },
     { name: '用户与权限', href: '/admin/users', icon: Users },
     { name: '工单客服处理', href: '/admin/tickets', icon: LifeBuoy },
     { name: '全站订单管理', href: '/admin/orders', icon: ShoppingBag },

+ 99 - 0
src/components/admin/agent/AgentActionConfirmCard.tsx

@@ -0,0 +1,99 @@
+// src/components/admin/agent/AgentActionConfirmCard.tsx
+'use client';
+
+import { useState } from 'react';
+import { AgentDangerousAction } from '@/types/agent';
+import { ShieldAlert, Check, X, AlertTriangle } from 'lucide-react';
+
+interface AgentActionConfirmCardProps {
+  action: AgentDangerousAction;
+  onConfirm: (action: AgentDangerousAction) => void;
+  onCancel?: () => void;
+}
+
+export default function AgentActionConfirmCard({
+  action,
+  onConfirm,
+  onCancel,
+}: AgentActionConfirmCardProps) {
+  const [handled, setHandled] = useState<'confirmed' | 'cancelled' | null>(
+    action.confirmed ? 'confirmed' : action.cancelled ? 'cancelled' : null
+  );
+
+  const handleConfirm = () => {
+    setHandled('confirmed');
+    onConfirm(action);
+  };
+
+  const handleCancel = () => {
+    setHandled('cancelled');
+    onCancel?.();
+  };
+
+  return (
+    <div className="my-3 p-3 bg-amber-50 border-2 border-dashed border-amber-600 shadow-[3px_3px_0px_#000] font-mono text-xs text-black">
+      <div className="flex items-center gap-2 mb-2 pb-1.5 border-b border-amber-300">
+        <div className="p-1 bg-amber-400 border border-black shrink-0">
+          <ShieldAlert size={14} className="text-black" />
+        </div>
+        <span className="font-black text-xs uppercase tracking-tight text-amber-950">
+          [ ⚠️ 高危写操作确认 // HUMAN-IN-THE-LOOP ]
+        </span>
+      </div>
+
+      <div className="text-neutral-700 text-xs mb-2 leading-relaxed">
+        Agent 准备执行具有写操作或破坏性影响的工具调用:
+        <span className="font-bold text-black bg-amber-200 px-1 mx-1 border border-black">
+          {action.tool}
+        </span>
+        {action.description && (
+          <span className="text-neutral-500 block text-[11px] mt-0.5">
+            (说明: {action.description})
+          </span>
+        )}
+      </div>
+
+      <div className="mb-3 bg-white p-2 border border-neutral-300 text-[11px]">
+        <span className="font-bold text-neutral-600 block mb-1">执行参数:</span>
+        <pre className="text-black overflow-x-auto whitespace-pre-wrap break-all">
+          {JSON.stringify(action.arguments, null, 2)}
+        </pre>
+      </div>
+
+      {handled === null ? (
+        <div className="flex items-center gap-2">
+          <button
+            type="button"
+            onClick={handleConfirm}
+            className="flex items-center gap-1.5 px-3 py-1.5 bg-amber-400 hover:bg-amber-300 border-2 border-black font-black text-xs shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+          >
+            <Check size={13} />
+            <span>[ 确认执行 ]</span>
+          </button>
+          <button
+            type="button"
+            onClick={handleCancel}
+            className="flex items-center gap-1 px-3 py-1.5 bg-white hover:bg-rose-100 border-2 border-black font-bold text-xs shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+          >
+            <X size={13} />
+            <span>[ 终止放弃 ]</span>
+          </button>
+        </div>
+      ) : (
+        <div className="flex items-center gap-1.5 font-bold text-xs py-1">
+          {handled === 'confirmed' ? (
+            <span className="text-emerald-800 bg-emerald-100 border border-emerald-500 px-2 py-0.5 flex items-center gap-1">
+              <Check size={12} />
+              管理员已确认执行下发
+            </span>
+          ) : (
+            <span className="text-rose-800 bg-rose-100 border border-rose-500 px-2 py-0.5 flex items-center gap-1">
+              <X size={12} />
+              管理员已终止该操作
+            </span>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}

+ 386 - 0
src/components/admin/agent/AgentChatBox.tsx

@@ -0,0 +1,386 @@
+// src/components/admin/agent/AgentChatBox.tsx
+'use client';
+
+import { useState, useRef, useEffect } from 'react';
+import { AgentMessage, AgentToolMetadata, ToolStep, AgentDangerousAction } from '@/types/agent';
+import AgentToolStepCard from './AgentToolStepCard';
+import AgentActionConfirmCard from './AgentActionConfirmCard';
+import { 
+  Send, Square, Sparkles, Bot, User, Trash2, 
+  Wrench, ArrowUpRight, Copy, Check, Terminal, Loader2 
+} from 'lucide-react';
+import { toast } from 'react-hot-toast';
+import Link from 'next/link';
+
+interface QuickPrompt {
+  label: string;
+  prompt: string;
+}
+
+interface AgentChatBoxProps {
+  messages: AgentMessage[];
+  isLoading: boolean;
+  currentThinking: { status: string; step?: number } | null;
+  onSendMessage: (text: string) => void;
+  onAbort: () => void;
+  onClearSession: () => void;
+  onOpenToolsModal?: () => void;
+  tools?: AgentToolMetadata[];
+  quickPrompts?: QuickPrompt[];
+  onConfirmAction?: (action: AgentDangerousAction) => void;
+  className?: string;
+  compact?: boolean;
+}
+
+// 辅助渲染:高亮单号 ORD-xxxx 与商品并转换为操作超链接或可复制徽标
+function FormattedMessageContent({ content }: { content: string }) {
+  if (!content) return null;
+
+  // 分行与基础 Markdown 表格、加粗、单号正则匹配
+  const lines = content.split('\n');
+
+  return (
+    <div className="space-y-1.5 text-xs text-black leading-relaxed select-text">
+      {lines.map((line, idx) => {
+        const trimmed = line.trim();
+
+        // 识别表格行
+        if (trimmed.startsWith('|') && trimmed.endsWith('|')) {
+          const cells = trimmed.split('|').slice(1, -1);
+          const isHeaderDivider = cells.every((c) => c.trim().match(/^:?-+:?$/));
+          if (isHeaderDivider) {
+            return <hr key={idx} className="border-t border-black my-1" />;
+          }
+          return (
+            <div key={idx} className="flex gap-2 py-0.5 border-b border-neutral-200 overflow-x-auto text-[11px] font-mono">
+              {cells.map((c, i) => (
+                <div key={i} className="min-w-[70px] flex-1 font-medium truncate">
+                  {c.trim()}
+                </div>
+              ))}
+            </div>
+          );
+        }
+
+        // 识别代码块标识 ```
+        if (trimmed.startsWith('```')) {
+          return null;
+        }
+
+        // 识别列表行
+        const isBullet = trimmed.startsWith('- ') || trimmed.startsWith('* ') || /^\d+\.\s/.test(trimmed);
+
+        // 正则替换订单号为高亮标签
+        const orderRegex = /(ORD-[A-Za-z0-9-]+)/g;
+        const parts = line.split(orderRegex);
+
+        return (
+          <div key={idx} className={`${isBullet ? 'pl-2 border-l-2 border-amber-400 my-0.5' : ''}`}>
+            {parts.map((part, pIdx) => {
+              if (orderRegex.test(part)) {
+                return (
+                  <span
+                    key={pIdx}
+                    className="inline-flex items-center gap-1 mx-1 px-1.5 py-0.2 bg-amber-200 border border-black font-black text-black group relative"
+                  >
+                    <span>{part}</span>
+                    <Link
+                      href={`/admin/orders?keyword=${encodeURIComponent(part)}`}
+                      className="text-neutral-700 hover:text-black hover:scale-110 transition"
+                      title="在后台订单列表过滤该订单"
+                      target="_blank"
+                    >
+                      <ArrowUpRight size={10} />
+                    </Link>
+                  </span>
+                );
+              }
+              // 加粗转换 **xxx**
+              const boldRegex = /\*\*(.*?)\*\*/g;
+              if (boldRegex.test(part)) {
+                const subParts = part.split(boldRegex);
+                return (
+                  <span key={pIdx}>
+                    {subParts.map((sp, sIdx) =>
+                      sIdx % 2 === 1 ? <strong key={sIdx} className="font-black text-black">{sp}</strong> : sp
+                    )}
+                  </span>
+                );
+              }
+              return <span key={pIdx}>{part}</span>;
+            })}
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+
+export default function AgentChatBox({
+  messages,
+  isLoading,
+  currentThinking,
+  onSendMessage,
+  onAbort,
+  onClearSession,
+  onOpenToolsModal,
+  tools = [],
+  quickPrompts = [],
+  onConfirmAction,
+  className = '',
+  compact = false,
+}: AgentChatBoxProps) {
+  const [inputText, setInputText] = useState('');
+  const messagesEndRef = useRef<HTMLDivElement | null>(null);
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+
+  // 滚动到底部
+  useEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  }, [messages, currentThinking, isLoading]);
+
+  const handleSend = () => {
+    if (!inputText.trim() || isLoading) return;
+    onSendMessage(inputText.trim());
+    setInputText('');
+    if (textareaRef.current) {
+      textareaRef.current.style.height = 'auto';
+    }
+  };
+
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      handleSend();
+    }
+  };
+
+  const handleTextareaChange = (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+    setInputText(e.target.value);
+    e.target.style.height = 'auto';
+    e.target.style.height = `${Math.min(e.target.scrollHeight, 120)}px`;
+  };
+
+  return (
+    <div className={`flex flex-col h-full bg-neutral-100 font-mono text-black select-none ${className}`}>
+      
+      {/* 顶部工具栏 */}
+      <div className="h-10 bg-white border-b-2 border-black px-3 flex items-center justify-between shrink-0">
+        <div className="flex items-center gap-2">
+          <div className="w-2.5 h-2.5 bg-amber-400 border border-black animate-pulse" />
+          <span className="font-black text-xs uppercase tracking-wider text-black">
+            [ AGENT-TERMINAL // 需求调度台 ]
+          </span>
+        </div>
+
+        <div className="flex items-center gap-1.5">
+          {onOpenToolsModal && (
+            <button
+              type="button"
+              onClick={onOpenToolsModal}
+              className="flex items-center gap-1 px-2 py-1 bg-neutral-50 hover:bg-amber-300 border border-black text-[11px] font-bold shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+              title="查看系统开放的工具技能库"
+            >
+              <Wrench size={11} />
+              <span className="hidden sm:inline">技能库 ({tools.length})</span>
+            </button>
+          )}
+
+          <button
+            type="button"
+            onClick={onClearSession}
+            disabled={isLoading || messages.length === 0}
+            className="flex items-center gap-1 px-2 py-1 bg-white hover:bg-rose-100 disabled:opacity-40 disabled:hover:bg-white border border-black text-[11px] font-bold shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+            title="清空对话记忆并重置会话"
+          >
+            <Trash2 size={11} />
+            <span className="hidden sm:inline">清空重置</span>
+          </button>
+        </div>
+      </div>
+
+      {/* 消息滚动主区域 */}
+      <div className="flex-1 overflow-y-auto p-4 space-y-4 scrollbar-thin bg-neutral-100 select-text">
+        {messages.length === 0 ? (
+          <div className="h-full flex flex-col items-center justify-center text-center p-6 space-y-4 select-none">
+            <div className="w-14 h-14 bg-amber-300 border-2 border-black flex items-center justify-center shadow-[4px_4px_0px_#000]">
+              <Bot size={28} className="text-black" />
+            </div>
+            <div className="space-y-1">
+              <div className="font-black text-sm uppercase text-black">
+                [ 智能运维助理就绪 // STANDBY ]
+              </div>
+              <p className="text-xs text-neutral-600 max-w-sm leading-relaxed">
+                无需复杂的表单操作,直接以自然语言告知您的管理意图。AI Agent 会自主规划步骤、调用后台系统工具并完成操作汇报。
+              </p>
+            </div>
+
+            {/* 初始场景快捷推荐 */}
+            {quickPrompts.length > 0 && (
+              <div className="w-full max-w-md pt-2 space-y-1.5">
+                <div className="text-[11px] font-black text-neutral-500 uppercase tracking-widest text-left">
+                  ▶ 场景常用指令:
+                </div>
+                <div className="flex flex-wrap gap-2">
+                  {quickPrompts.map((item, idx) => (
+                    <button
+                      key={idx}
+                      type="button"
+                      onClick={() => onSendMessage(item.prompt)}
+                      className="px-2.5 py-1.5 bg-white hover:bg-amber-300 border-2 border-black font-bold text-xs text-left shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+                    >
+                      {item.label}
+                    </button>
+                  ))}
+                </div>
+              </div>
+            )}
+          </div>
+        ) : (
+          messages.map((msg) => {
+            const isUser = msg.role === 'user';
+            return (
+              <div
+                key={msg.id}
+                className={`flex gap-2.5 ${isUser ? 'justify-end' : 'justify-start'}`}
+              >
+                {!isUser && (
+                  <div className="w-8 h-8 bg-amber-300 border-2 border-black flex items-center justify-center shrink-0 shadow-[2px_2px_0px_#000] mt-0.5">
+                    <Bot size={16} className="text-black" />
+                  </div>
+                )}
+
+                <div
+                  className={`
+                    max-w-[85%] sm:max-w-[78%] p-3 border-2 border-black
+                    ${isUser
+                      ? 'bg-amber-300 shadow-[3px_3px_0px_#000] text-black font-bold'
+                      : 'bg-white shadow-[3px_3px_0px_#000] text-black'
+                    }
+                  `}
+                >
+                  <div className="flex items-center justify-between pb-1.5 mb-1.5 border-b border-black/20 text-[10px] uppercase font-bold text-neutral-600 select-none">
+                    <span>{isUser ? 'HUMAN // 管理员' : 'AGENT // 运维助理'}</span>
+                    <span>
+                      {new Date(msg.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}
+                    </span>
+                  </div>
+
+                  {/* 工具调用轨迹步骤 */}
+                  {msg.steps && msg.steps.length > 0 && (
+                    <div className="mb-2">
+                      <div className="text-[10px] font-black text-neutral-500 uppercase tracking-widest mb-1 select-none flex items-center gap-1">
+                        <Terminal size={11} />
+                        <span>工具调用轨迹 ({msg.steps.length} STEPS):</span>
+                      </div>
+                      {msg.steps.map((step, sIdx) => (
+                        <AgentToolStepCard key={sIdx} step={step} />
+                      ))}
+                    </div>
+                  )}
+
+                  {/* 高危操作确认卡片 */}
+                  {msg.dangerousAction && onConfirmAction && (
+                    <AgentActionConfirmCard
+                      action={msg.dangerousAction}
+                      onConfirm={onConfirmAction}
+                    />
+                  )}
+
+                  {/* 正文或流式文字 */}
+                  <FormattedMessageContent content={msg.content} />
+
+                  {/* 异常错误提示 */}
+                  {msg.error && (
+                    <div className="mt-2 p-2 bg-rose-100 border border-rose-500 text-rose-800 text-xs font-bold">
+                      [异常报错]: {msg.error}
+                    </div>
+                  )}
+                </div>
+
+                {isUser && (
+                  <div className="w-8 h-8 bg-neutral-900 border-2 border-black flex items-center justify-center shrink-0 shadow-[2px_2px_0px_#000] mt-0.5">
+                    <User size={16} className="text-white" />
+                  </div>
+                )}
+              </div>
+            );
+          })
+        )}
+
+        {/* 思考中动效状态 */}
+        {isLoading && currentThinking && (
+          <div className="flex items-center gap-2 p-2 bg-amber-50 border-2 border-dashed border-black text-xs font-mono select-none">
+            <Loader2 size={14} className="animate-spin text-amber-700" />
+            <span className="font-black text-black">
+              [ AI 思考规划中: 步骤 {currentThinking.step || 1} - 意图识别与工具决策... ]
+            </span>
+          </div>
+        )}
+
+        <div ref={messagesEndRef} />
+      </div>
+
+      {/* 底部快捷 Prompt 气泡(在有消息时继续保留便利入口) */}
+      {quickPrompts.length > 0 && messages.length > 0 && (
+        <div className="px-3 py-1.5 bg-neutral-200 border-t-2 border-black flex items-center gap-1.5 overflow-x-auto scrollbar-none select-none">
+          <span className="text-[10px] font-black uppercase text-neutral-600 shrink-0">快捷需求:</span>
+          {quickPrompts.map((item, idx) => (
+            <button
+              key={idx}
+              type="button"
+              disabled={isLoading}
+              onClick={() => onSendMessage(item.prompt)}
+              className="px-2 py-0.5 bg-white hover:bg-amber-300 disabled:opacity-50 border border-black text-[11px] font-bold shrink-0 transition"
+            >
+              {item.label}
+            </button>
+          ))}
+        </div>
+      )}
+
+      {/* 输入与操作底栏 */}
+      <div className="p-3 bg-white border-t-2 border-black select-none">
+        <div className="flex gap-2">
+          <div className="flex-1 relative">
+            <textarea
+              ref={textareaRef}
+              rows={1}
+              value={inputText}
+              onChange={handleTextareaChange}
+              onKeyDown={handleKeyDown}
+              disabled={isLoading}
+              placeholder="用自然语言描述需求,例如:'查一下待支付订单' 或 '帮我把订单 ORD-xxx 取消掉'..."
+              className="w-full bg-neutral-50 border-2 border-black p-2 text-xs font-mono text-black resize-none focus:outline-none focus:bg-white focus:shadow-[2px_2px_0px_#000] disabled:bg-neutral-200 placeholder:text-neutral-400 select-text"
+            />
+            <span className="absolute right-2 bottom-2 text-[10px] text-neutral-400 hidden sm:inline select-none">
+              Enter 发送 / Shift+Enter 换行
+            </span>
+          </div>
+
+          {isLoading ? (
+            <button
+              type="button"
+              onClick={onAbort}
+              className="px-4 bg-rose-500 hover:bg-rose-600 text-white border-2 border-black font-black text-xs flex items-center gap-1.5 shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase shrink-0"
+              title="终止当前 Agent 执行"
+            >
+              <Square size={13} />
+              <span>[ 终止 ]</span>
+            </button>
+          ) : (
+            <button
+              type="button"
+              onClick={handleSend}
+              disabled={!inputText.trim()}
+              className="px-4 bg-amber-300 hover:bg-amber-400 disabled:opacity-40 disabled:hover:bg-amber-300 text-black border-2 border-black font-black text-xs flex items-center gap-1.5 shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase shrink-0"
+            >
+              <Send size={13} />
+              <span>[ 发送 ]</span>
+            </button>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}

+ 240 - 0
src/components/admin/agent/AgentDrawer.tsx

@@ -0,0 +1,240 @@
+// src/components/admin/agent/AgentDrawer.tsx
+'use client';
+
+import { useState, useEffect, useMemo } from 'react';
+import { usePathname } from 'next/navigation';
+import { useAgentChat } from '@/hooks/useAgentChat';
+import AgentChatBox from './AgentChatBox';
+import AgentToolsModal from './AgentToolsModal';
+import { 
+  Bot, X, Maximize2, Minimize2, Plus, 
+  Clock, Sparkles, ChevronDown 
+} from 'lucide-react';
+
+interface AgentDrawerProps {
+  isOpen: boolean;
+  onClose: () => void;
+}
+
+export default function AgentDrawer({ isOpen, onClose }: AgentDrawerProps) {
+  const pathname = usePathname();
+  const [isExpanded, setIsExpanded] = useState(false);
+  const [isToolsOpen, setIsToolsOpen] = useState(false);
+  const [showSessionMenu, setShowSessionMenu] = useState(false);
+
+  const {
+    sessions,
+    currentSessionId,
+    messages,
+    isLoading,
+    currentThinking,
+    tools,
+    toolsLoading,
+    sendMessage,
+    abortStream,
+    createNewSession,
+    switchSession,
+    deleteSession,
+    clearCurrentSession,
+    handleConfirmDangerousAction,
+    loadTools,
+  } = useAgentChat();
+
+  // 快捷键 Cmd+J / Ctrl+J 或 Escape
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape' && isOpen) {
+        onClose();
+      }
+    };
+    window.addEventListener('keydown', handleKeyDown);
+    return () => window.removeEventListener('keydown', handleKeyDown);
+  }, [isOpen, onClose]);
+
+  // 根据当前路由生成场景化快捷推荐
+  const routeQuickPrompts = useMemo(() => {
+    if (pathname.includes('/admin/orders')) {
+      return [
+        { label: '查待支付订单', prompt: '帮我查询最近的订单,并告诉我有没有待支付的' },
+        { label: '查最新订单列表', prompt: '查询最新的 5 笔订单及当前状态' },
+        { label: '法国签证订单', prompt: '帮我检索包含法国签证服务的订单' },
+      ];
+    }
+    if (pathname.includes('/admin/products')) {
+      return [
+        { label: '检索法国签证', prompt: '帮我查一下法国相关的签证服务' },
+        { label: '查看所有签证服务', prompt: '检索当前系统上架的所有签证服务与价格' },
+      ];
+    }
+    if (pathname.includes('/admin/users')) {
+      return [
+        { label: '查询最近注册用户', prompt: '查一下最近的用户信息与权限' },
+        { label: '待支付用户订单', prompt: '查询当前有待支付订单的用户' },
+      ];
+    }
+    return [
+      { label: '查待支付订单', prompt: '帮我查询最近的订单,并告诉我有没有待支付的' },
+      { label: '查法国签证', prompt: '查一下法国相关的签证服务' },
+      { label: '订单状态梳理', prompt: '查询最新 5 笔订单并汇报状态' },
+    ];
+  }, [pathname]);
+
+  const activeSession = sessions.find((s) => s.id === currentSessionId);
+
+  const handleSendWithContext = (text: string) => {
+    const context = `路由: ${pathname}`;
+    sendMessage(text, context);
+  };
+
+  if (!isOpen) return null;
+
+  return (
+    <>
+      {/* 遮罩背景 */}
+      <div 
+        className="fixed inset-0 bg-black/40 z-40 backdrop-grayscale transition-opacity"
+        onClick={onClose}
+      />
+
+      {/* 抽屉侧边栏 */}
+      <aside 
+        className={`
+          fixed top-0 right-0 bottom-0 z-50 bg-white border-l-2 border-black flex flex-col font-mono text-black shadow-[-8px_0px_0px_#000] transition-all duration-200
+          ${isExpanded ? 'w-full md:w-[760px]' : 'w-full md:w-[480px]'}
+        `}
+      >
+        {/* 抽屉顶部 Bar */}
+        <div className="h-14 bg-amber-300 border-b-2 border-black px-4 flex items-center justify-between shrink-0 select-none">
+          <div className="flex items-center gap-2">
+            <div className="w-7 h-7 bg-white border-2 border-black flex items-center justify-center shadow-[2px_2px_0px_#000]">
+              <Bot size={16} className="text-black" />
+            </div>
+            <div>
+              <div className="font-black text-xs uppercase tracking-tight flex items-center gap-1.5">
+                <span>[ COPILOT // 智能运维副驾 ]</span>
+                <span className="text-[10px] bg-black text-amber-300 px-1 font-mono">
+                  ⌘J
+                </span>
+              </div>
+              <div className="text-[10px] text-neutral-800 font-bold">
+                PAGE: {pathname}
+              </div>
+            </div>
+          </div>
+
+          <div className="flex items-center gap-1.5">
+            {/* 会话切换下拉 */}
+            <div className="relative">
+              <button
+                type="button"
+                onClick={() => setShowSessionMenu(!showSessionMenu)}
+                className="flex items-center gap-1 px-2 py-1 bg-white hover:bg-neutral-100 border border-black text-[11px] font-bold shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5"
+                title="切换历史会话"
+              >
+                <Clock size={12} />
+                <span className="max-w-[70px] truncate">{activeSession?.title || '会话'}</span>
+                <ChevronDown size={12} />
+              </button>
+
+              {showSessionMenu && (
+                <div className="absolute right-0 mt-1 w-56 bg-white border-2 border-black shadow-[4px_4px_0px_#000] z-50 p-1 space-y-1">
+                  <div className="flex items-center justify-between px-2 py-1 border-b border-neutral-200">
+                    <span className="text-[10px] font-black uppercase text-neutral-500">历史运维会话</span>
+                    <button
+                      type="button"
+                      onClick={() => {
+                        createNewSession();
+                        setShowSessionMenu(false);
+                      }}
+                      className="text-[10px] font-bold text-black flex items-center gap-0.5 hover:underline"
+                    >
+                      <Plus size={10} />
+                      <span>新建</span>
+                    </button>
+                  </div>
+                  <div className="max-h-48 overflow-y-auto space-y-0.5 scrollbar-thin">
+                    {sessions.map((s) => (
+                      <div
+                        key={s.id}
+                        onClick={() => {
+                          switchSession(s.id);
+                          setShowSessionMenu(false);
+                        }}
+                        className={`
+                          flex items-center justify-between px-2 py-1.5 text-xs font-bold cursor-pointer transition
+                          ${s.id === currentSessionId ? 'bg-amber-300' : 'hover:bg-neutral-100'}
+                        `}
+                      >
+                        <span className="truncate flex-1">{s.title}</span>
+                        <span className="text-[9px] text-neutral-500 ml-1 shrink-0">
+                          {s.messageCount}条
+                        </span>
+                      </div>
+                    ))}
+                  </div>
+                </div>
+              )}
+            </div>
+
+            {/* 新建会话 */}
+            <button
+              type="button"
+              onClick={() => createNewSession()}
+              className="p-1.5 bg-white hover:bg-neutral-100 border border-black shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+              title="开启新对话"
+            >
+              <Plus size={14} />
+            </button>
+
+            {/* 展开/缩小宽屏 */}
+            <button
+              type="button"
+              onClick={() => setIsExpanded(!isExpanded)}
+              className="hidden md:flex p-1.5 bg-white hover:bg-neutral-100 border border-black shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+              title={isExpanded ? '缩小抽屉' : '宽屏展示'}
+            >
+              {isExpanded ? <Minimize2 size={14} /> : <Maximize2 size={14} />}
+            </button>
+
+            {/* 关闭按钮 */}
+            <button
+              type="button"
+              onClick={onClose}
+              className="p-1.5 bg-white hover:bg-rose-200 border border-black shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+              title="关闭 Copilot"
+            >
+              <X size={14} />
+            </button>
+          </div>
+        </div>
+
+        {/* 聊天核心工作区 */}
+        <div className="flex-1 min-h-0">
+          <AgentChatBox
+            messages={messages}
+            isLoading={isLoading}
+            currentThinking={currentThinking}
+            onSendMessage={handleSendWithContext}
+            onAbort={abortStream}
+            onClearSession={clearCurrentSession}
+            onOpenToolsModal={() => setIsToolsOpen(true)}
+            tools={tools}
+            quickPrompts={routeQuickPrompts}
+            onConfirmAction={handleConfirmDangerousAction}
+            compact={!isExpanded}
+          />
+        </div>
+
+        {/* 工具库弹窗 */}
+        <AgentToolsModal
+          isOpen={isToolsOpen}
+          onClose={() => setIsToolsOpen(false)}
+          tools={tools}
+          loading={toolsLoading}
+          onRefresh={loadTools}
+          onSelectPrompt={(p) => handleSendWithContext(p)}
+        />
+      </aside>
+    </>
+  );
+}

+ 38 - 0
src/components/admin/agent/AgentFloatingTrigger.tsx

@@ -0,0 +1,38 @@
+// src/components/admin/agent/AgentFloatingTrigger.tsx
+'use client';
+
+import { Bot, Sparkles } from 'lucide-react';
+
+interface AgentFloatingTriggerProps {
+  onClick: () => void;
+  isOpen: boolean;
+}
+
+export default function AgentFloatingTrigger({ onClick, isOpen }: AgentFloatingTriggerProps) {
+  if (isOpen) return null;
+
+  return (
+    <div className="fixed bottom-6 right-6 z-30 font-mono select-none">
+      <button
+        type="button"
+        onClick={onClick}
+        className="group relative flex items-center gap-2 px-3.5 py-2.5 bg-amber-300 hover:bg-amber-400 text-black border-2 border-black font-black text-xs shadow-[4px_4px_0px_#000] active:translate-x-1 active:translate-y-1 active:shadow-[1px_1px_0px_#000] transition-all"
+        title="唤醒 AI 运维副驾 (⌘J)"
+      >
+        <span className="relative flex h-2.5 w-2.5">
+          <span className="animate-ping absolute inline-flex h-full w-full rounded-none bg-black opacity-75"></span>
+          <span className="relative inline-flex rounded-none h-2.5 w-2.5 bg-black"></span>
+        </span>
+
+        <div className="flex items-center gap-1.5">
+          <Bot size={16} className="text-black group-hover:rotate-12 transition-transform" />
+          <span className="uppercase tracking-wider">[ COPILOT // 智能运维 ]</span>
+        </div>
+
+        <span className="hidden sm:inline-block text-[9px] bg-black text-amber-300 px-1 py-0.5 font-bold">
+          ⌘J
+        </span>
+      </button>
+    </div>
+  );
+}

+ 128 - 0
src/components/admin/agent/AgentToolStepCard.tsx

@@ -0,0 +1,128 @@
+// src/components/admin/agent/AgentToolStepCard.tsx
+'use client';
+
+import { useState } from 'react';
+import { ToolStep } from '@/types/agent';
+import { 
+  Terminal, ChevronDown, ChevronRight, CheckCircle2, 
+  AlertTriangle, Loader2, Copy, Check 
+} from 'lucide-react';
+import { toast } from 'react-hot-toast';
+
+interface AgentToolStepCardProps {
+  step: ToolStep;
+}
+
+export default function AgentToolStepCard({ step }: AgentToolStepCardProps) {
+  const [isOpen, setIsOpen] = useState(false);
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = (e: React.MouseEvent) => {
+    e.stopPropagation();
+    const payload = JSON.stringify(
+      { arguments: step.arguments, result: step.result },
+      null,
+      2
+    );
+    navigator.clipboard.writeText(payload);
+    setCopied(true);
+    toast.success('工具调用数据已复制');
+    setTimeout(() => setCopied(false), 2000);
+  };
+
+  const isRunning = step.status === 'running';
+  const isFailed = step.status === 'failed' || step.is_error;
+  const isCompleted = step.status === 'completed' && !step.is_error;
+
+  return (
+    <div className="my-2 border-2 border-black bg-neutral-50 shadow-[2px_2px_0px_#000] text-xs font-mono select-text transition-all">
+      {/* 头部标题与状态栏 */}
+      <div 
+        onClick={() => setIsOpen(!isOpen)}
+        className={`
+          flex items-center justify-between px-3 py-2 cursor-pointer select-none transition
+          ${isOpen ? 'border-b-2 border-black bg-neutral-100' : 'hover:bg-neutral-100'}
+        `}
+      >
+        <div className="flex items-center gap-2 overflow-hidden">
+          <div className="p-1 bg-amber-300 border border-black shrink-0">
+            <Terminal size={12} className="text-black" />
+          </div>
+          <span className="font-bold text-black uppercase tracking-tight truncate">
+            TOOL: {step.tool}
+          </span>
+          {step.call_id && (
+            <span className="hidden sm:inline-block text-[10px] text-neutral-500 truncate">
+              ({step.call_id})
+            </span>
+          )}
+        </div>
+
+        <div className="flex items-center gap-2 shrink-0">
+          {isRunning && (
+            <span className="flex items-center gap-1 text-[11px] font-bold text-amber-700 bg-amber-200 border border-black px-1.5 py-0.5">
+              <Loader2 size={10} className="animate-spin" />
+              <span>[ 调度中... ]</span>
+            </span>
+          )}
+          {isCompleted && (
+            <span className="flex items-center gap-1 text-[11px] font-bold text-emerald-800 bg-emerald-200 border border-black px-1.5 py-0.5">
+              <CheckCircle2 size={10} />
+              <span>[ 执行完毕 ]</span>
+            </span>
+          )}
+          {isFailed && (
+            <span className="flex items-center gap-1 text-[11px] font-bold text-rose-800 bg-rose-200 border border-black px-1.5 py-0.5">
+              <AlertTriangle size={10} />
+              <span>[ 执行异常 ]</span>
+            </span>
+          )}
+
+          <button 
+            type="button"
+            className="p-0.5 text-black hover:bg-neutral-200 transition"
+          >
+            {isOpen ? <ChevronDown size={14} /> : <ChevronRight size={14} />}
+          </button>
+        </div>
+      </div>
+
+      {/* 展开的入参与响应报文 JSON 详情 */}
+      {isOpen && (
+        <div className="p-3 bg-white space-y-2 border-t-0">
+          <div className="flex items-center justify-between">
+            <span className="text-[10px] text-neutral-500 font-bold uppercase tracking-wider">
+              PAYLOAD & EXECUTION TRACE:
+            </span>
+            <button
+              onClick={handleCopy}
+              className="flex items-center gap-1 px-1.5 py-0.5 bg-neutral-100 hover:bg-amber-300 border border-black text-[10px] font-bold transition shadow-[1px_1px_0px_#000]"
+              title="复制参数与结果 JSON"
+            >
+              {copied ? <Check size={10} className="text-emerald-700" /> : <Copy size={10} />}
+              <span>{copied ? '已复制' : '复制数据'}</span>
+            </button>
+          </div>
+
+          <div className="space-y-1.5">
+            <div>
+              <div className="text-[10px] font-bold text-neutral-600 mb-0.5">▶ 入参 Arguments:</div>
+              <pre className="bg-neutral-900 text-neutral-100 p-2 text-[11px] overflow-x-auto rounded-none border border-black scrollbar-thin">
+                {JSON.stringify(step.arguments, null, 2)}
+              </pre>
+            </div>
+
+            {step.result !== undefined && (
+              <div>
+                <div className="text-[10px] font-bold text-neutral-600 mb-0.5">◀ 结果 Result:</div>
+                <pre className="bg-neutral-900 text-emerald-300 p-2 text-[11px] overflow-x-auto rounded-none border border-black scrollbar-thin max-h-48">
+                  {JSON.stringify(step.result, null, 2)}
+                </pre>
+              </div>
+            )}
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

+ 200 - 0
src/components/admin/agent/AgentToolsModal.tsx

@@ -0,0 +1,200 @@
+// src/components/admin/agent/AgentToolsModal.tsx
+'use client';
+
+import { useState } from 'react';
+import { AgentToolMetadata } from '@/types/agent';
+import { 
+  Wrench, X, ShieldAlert, CheckCircle2, ChevronRight, 
+  Code2, Sparkles, RefreshCw 
+} from 'lucide-react';
+
+interface AgentToolsModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  tools: AgentToolMetadata[];
+  loading?: boolean;
+  onRefresh?: () => void;
+  onSelectPrompt?: (prompt: string) => void;
+}
+
+export default function AgentToolsModal({
+  isOpen,
+  onClose,
+  tools,
+  loading = false,
+  onRefresh,
+  onSelectPrompt,
+}: AgentToolsModalProps) {
+  const [selectedTool, setSelectedTool] = useState<AgentToolMetadata | null>(null);
+
+  if (!isOpen) return null;
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-black/70 backdrop-blur-xs font-mono text-black">
+      <div className="bg-white border-2 border-black w-full max-w-3xl max-h-[85vh] flex flex-col shadow-[8px_8px_0px_#000] animate-in fade-in zoom-in-95 duration-150">
+        
+        {/* 标题栏 */}
+        <div className="h-12 bg-neutral-100 border-b-2 border-black px-4 flex items-center justify-between select-none shrink-0">
+          <div className="flex items-center gap-2">
+            <div className="w-6 h-6 bg-amber-300 border border-black flex items-center justify-center shadow-[1px_1px_0px_#000]">
+              <Wrench size={14} className="text-black" />
+            </div>
+            <h3 className="font-black text-xs sm:text-sm uppercase tracking-wider">
+              [ AGENT-TOOLS // 开放工具能力库 ]
+            </h3>
+            <span className="text-[10px] bg-neutral-200 border border-black px-1.5 py-0.5 font-bold">
+              {tools.length} 技能在线
+            </span>
+          </div>
+
+          <div className="flex items-center gap-2">
+            {onRefresh && (
+              <button
+                type="button"
+                onClick={onRefresh}
+                disabled={loading}
+                className="p-1.5 bg-white hover:bg-amber-300 border border-black shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+                title="重新加载工具列表"
+              >
+                <RefreshCw size={14} className={loading ? 'animate-spin' : ''} />
+              </button>
+            )}
+            <button
+              type="button"
+              onClick={onClose}
+              className="p-1.5 bg-white hover:bg-rose-200 border border-black shadow-[1px_1px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition"
+            >
+              <X size={14} />
+            </button>
+          </div>
+        </div>
+
+        {/* 内容分栏展示 */}
+        <div className="flex-1 min-h-0 flex flex-col md:flex-row overflow-hidden">
+          
+          {/* 左侧:工具能力卡片列表 */}
+          <div className="w-full md:w-1/2 border-r-0 md:border-r-2 border-b-2 md:border-b-0 border-black overflow-y-auto p-3 space-y-2 bg-neutral-50 scrollbar-thin">
+            {tools.length === 0 ? (
+              <div className="text-center py-10 text-neutral-400 text-xs">
+                暂无注册的系统工具
+              </div>
+            ) : (
+              tools.map((t) => {
+                const isSelected = selectedTool?.name === t.name;
+                return (
+                  <div
+                    key={t.name}
+                    onClick={() => setSelectedTool(t)}
+                    className={`
+                      p-3 border-2 text-xs cursor-pointer transition select-none
+                      ${isSelected 
+                        ? 'bg-amber-300 border-black shadow-[3px_3px_0px_#000] translate-x-0.5' 
+                        : 'bg-white border-neutral-300 hover:border-black hover:bg-neutral-50'
+                      }
+                    `}
+                  >
+                    <div className="flex items-center justify-between mb-1">
+                      <span className="font-black text-xs uppercase tracking-tight text-black truncate">
+                        {t.name}
+                      </span>
+                      {t.is_dangerous ? (
+                        <span className="text-[10px] font-black text-rose-800 bg-rose-200 border border-black px-1 py-0.2 shrink-0">
+                          高危写操作
+                        </span>
+                      ) : (
+                        <span className="text-[10px] font-bold text-neutral-600 bg-neutral-100 border border-neutral-400 px-1 py-0.2 shrink-0">
+                          只读查询
+                        </span>
+                      )}
+                    </div>
+                    <div className="text-[11px] text-neutral-600 line-clamp-2 leading-relaxed">
+                      {t.description || '暂无工具详细描述'}
+                    </div>
+                  </div>
+                );
+              })
+            )}
+          </div>
+
+          {/* 右侧:所选工具的 Schema 与示例 */}
+          <div className="flex-1 overflow-y-auto p-4 bg-white flex flex-col justify-between scrollbar-thin">
+            {selectedTool ? (
+              <div className="space-y-4">
+                <div>
+                  <div className="flex items-center gap-2 mb-1">
+                    <span className="font-black text-sm text-black uppercase">
+                      {selectedTool.name}
+                    </span>
+                    {selectedTool.is_dangerous && (
+                      <span className="text-[10px] font-black text-rose-700 bg-rose-100 border border-rose-400 px-1.5 py-0.5">
+                        [ DANGEROUS ]
+                      </span>
+                    )}
+                  </div>
+                  <p className="text-xs text-neutral-700 leading-relaxed bg-neutral-50 p-2.5 border border-black">
+                    {selectedTool.description}
+                  </p>
+                </div>
+
+                {/* 参数结构 Schema */}
+                <div>
+                  <div className="text-xs font-black text-black uppercase mb-1.5 flex items-center gap-1.5">
+                    <Code2 size={14} />
+                    <span>FUNCTION SCHEMA & PARAMETERS:</span>
+                  </div>
+                  <pre className="bg-neutral-900 text-neutral-100 p-3 text-[11px] border border-black overflow-x-auto max-h-56 scrollbar-thin">
+                    {JSON.stringify(
+                      selectedTool.schema?.function?.parameters || selectedTool.schema || { note: '无额外复杂入参' },
+                      null,
+                      2
+                    )}
+                  </pre>
+                </div>
+
+                {/* 试一试 Prompt */}
+                {onSelectPrompt && (
+                  <div className="pt-2">
+                    <button
+                      type="button"
+                      onClick={() => {
+                        let sample = `使用 ${selectedTool.name} 处理我的需求`;
+                        if (selectedTool.name.includes('order')) {
+                          sample = '帮我查询最近的待支付订单';
+                        } else if (selectedTool.name.includes('product') || selectedTool.name.includes('search')) {
+                          sample = '查一下法国相关的签证服务';
+                        }
+                        onSelectPrompt(sample);
+                        onClose();
+                      }}
+                      className="w-full flex items-center justify-center gap-1.5 px-3 py-2 bg-amber-300 hover:bg-amber-400 border-2 border-black font-black text-xs shadow-[2px_2px_0px_#000] active:translate-x-0.5 active:translate-y-0.5 transition uppercase"
+                    >
+                      <Sparkles size={13} />
+                      <span>[ 填入体验该能力示例指令 ]</span>
+                    </button>
+                  </div>
+                )}
+              </div>
+            ) : (
+              <div className="h-full flex flex-col items-center justify-center text-center text-neutral-400 p-6">
+                <ChevronRight size={32} className="mb-2 stroke-1" />
+                <span className="text-xs font-bold">请点击左侧工具查看详细元数据与入参模式</span>
+              </div>
+            )}
+          </div>
+        </div>
+
+        {/* 底部信息 */}
+        <div className="h-10 bg-neutral-100 border-t-2 border-black px-4 flex items-center justify-between text-[11px] text-neutral-600 font-bold shrink-0 select-none">
+          <span>* 工具由后端 AI 核心根据管理员意图自主识别并调用</span>
+          <button
+            type="button"
+            onClick={onClose}
+            className="px-3 py-1 bg-white border border-black hover:bg-neutral-200 transition"
+          >
+            [ 关闭 ]
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}

+ 434 - 0
src/hooks/useAgentChat.ts

@@ -0,0 +1,434 @@
+// src/hooks/useAgentChat.ts
+'use client';
+
+import { useState, useEffect, useRef, useCallback } from 'react';
+import {
+  AgentMessage,
+  AgentSession,
+  AgentToolMetadata,
+  ToolStep,
+  AgentDangerousAction,
+} from '@/types/agent';
+import { agentService } from '@/lib/services/agentService';
+import { toast } from 'react-hot-toast';
+
+const SESSIONS_STORAGE_KEY = 'agent_sessions_list_v1';
+const ACTIVE_SESSION_STORAGE_KEY = 'agent_active_session_id';
+const MESSAGES_PREFIX = 'agent_messages_';
+
+const generateSessionId = () => {
+  return `sess_admin_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+};
+
+export function useAgentChat() {
+  const [sessions, setSessions] = useState<AgentSession[]>([]);
+  const [currentSessionId, setCurrentSessionId] = useState<string>('');
+  const [messages, setMessages] = useState<AgentMessage[]>([]);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+  const [currentThinking, setCurrentThinking] = useState<{ status: string; step?: number } | null>(null);
+  const [tools, setTools] = useState<AgentToolMetadata[]>([]);
+  const [toolsLoading, setToolsLoading] = useState<boolean>(false);
+
+  const abortControllerRef = useRef<AbortController | null>(null);
+
+  // 加载系统可用工具列表
+  const loadTools = useCallback(async () => {
+    setToolsLoading(true);
+    try {
+      const data = await agentService.getTools();
+      setTools(data);
+    } catch (err) {
+      console.error('加载 Agent 工具失败:', err);
+    } finally {
+      setToolsLoading(false);
+    }
+  }, []);
+
+  // 1. 初始化会话列表与当前会话
+  useEffect(() => {
+    loadTools();
+
+    try {
+      const savedSessionsStr = localStorage.getItem(SESSIONS_STORAGE_KEY);
+      const savedActiveId = localStorage.getItem(ACTIVE_SESSION_STORAGE_KEY);
+
+      let loadedSessions: AgentSession[] = [];
+      if (savedSessionsStr) {
+        loadedSessions = JSON.parse(savedSessionsStr);
+      }
+
+      if (loadedSessions.length === 0) {
+        const newId = generateSessionId();
+        const initialSession: AgentSession = {
+          id: newId,
+          title: '新建运维对话',
+          createdAt: Date.now(),
+          updatedAt: Date.now(),
+          messageCount: 0,
+        };
+        loadedSessions = [initialSession];
+        localStorage.setItem(SESSIONS_STORAGE_KEY, JSON.stringify(loadedSessions));
+        localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, newId);
+        setSessions(loadedSessions);
+        setCurrentSessionId(newId);
+      } else {
+        setSessions(loadedSessions);
+        const activeId = savedActiveId && loadedSessions.some((s) => s.id === savedActiveId)
+          ? savedActiveId
+          : loadedSessions[0].id;
+        setCurrentSessionId(activeId);
+        localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, activeId);
+      }
+    } catch (err) {
+      console.error('初始化会话失败:', err);
+    }
+  }, [loadTools]);
+
+  // 2. 当切换 currentSessionId 时加载消息
+  useEffect(() => {
+    if (!currentSessionId) return;
+    try {
+      const savedMessagesStr = localStorage.getItem(`${MESSAGES_PREFIX}${currentSessionId}`);
+      if (savedMessagesStr) {
+        setMessages(JSON.parse(savedMessagesStr));
+      } else {
+        setMessages([]);
+      }
+    } catch (err) {
+      console.error('读取会话消息失败:', err);
+      setMessages([]);
+    }
+  }, [currentSessionId]);
+
+  // 3. 持久化当前会话消息
+  const saveMessages = useCallback(
+    (sessionId: string, newMessages: AgentMessage[]) => {
+      setMessages(newMessages);
+      try {
+        localStorage.setItem(`${MESSAGES_PREFIX}${sessionId}`, JSON.stringify(newMessages));
+
+        // 同时更新 sessions 列表中的元数据 (最后一条消息摘要与更新时间)
+        setSessions((prevSessions) => {
+          const lastMsg = newMessages[newMessages.length - 1];
+          const snippet = lastMsg ? lastMsg.content.slice(0, 36) : '';
+          const updated = prevSessions.map((s) => {
+            if (s.id === sessionId) {
+              return {
+                ...s,
+                updatedAt: Date.now(),
+                messageCount: newMessages.length,
+                lastMessageSnippet: snippet,
+                title: s.title === '新建运维对话' && lastMsg?.role === 'user'
+                  ? lastMsg.content.slice(0, 16) || '运维指令会话'
+                  : s.title,
+              };
+            }
+            return s;
+          });
+          localStorage.setItem(SESSIONS_STORAGE_KEY, JSON.stringify(updated));
+          return updated;
+        });
+      } catch (err) {
+        console.error('保存会话消息失败:', err);
+      }
+    },
+    []
+  );
+
+  // 新建会话
+  const createNewSession = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    const newId = generateSessionId();
+    const newSession: AgentSession = {
+      id: newId,
+      title: '新建运维对话',
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      messageCount: 0,
+    };
+    const updated = [newSession, ...sessions];
+    setSessions(updated);
+    setCurrentSessionId(newId);
+    setMessages([]);
+    localStorage.setItem(SESSIONS_STORAGE_KEY, JSON.stringify(updated));
+    localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, newId);
+    toast.success('已开启新运维对话');
+    return newId;
+  }, [sessions]);
+
+  // 切换会话
+  const switchSession = useCallback((sessionId: string) => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    setCurrentSessionId(sessionId);
+    localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, sessionId);
+  }, []);
+
+  // 删除会话
+  const deleteSession = useCallback(
+    async (sessionId: string) => {
+      // 远程清除 Redis 记忆
+      agentService.deleteSession(sessionId).catch(() => {});
+
+      localStorage.removeItem(`${MESSAGES_PREFIX}${sessionId}`);
+      const remaining = sessions.filter((s) => s.id !== sessionId);
+
+      if (remaining.length === 0) {
+        const newId = generateSessionId();
+        const initialSession: AgentSession = {
+          id: newId,
+          title: '新建运维对话',
+          createdAt: Date.now(),
+          updatedAt: Date.now(),
+          messageCount: 0,
+        };
+        const resetSessions = [initialSession];
+        setSessions(resetSessions);
+        setCurrentSessionId(newId);
+        setMessages([]);
+        localStorage.setItem(SESSIONS_STORAGE_KEY, JSON.stringify(resetSessions));
+        localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, newId);
+      } else {
+        setSessions(remaining);
+        localStorage.setItem(SESSIONS_STORAGE_KEY, JSON.stringify(remaining));
+        if (currentSessionId === sessionId) {
+          setCurrentSessionId(remaining[0].id);
+          localStorage.setItem(ACTIVE_SESSION_STORAGE_KEY, remaining[0].id);
+        }
+      }
+      toast.success('会话已清除');
+    },
+    [sessions, currentSessionId]
+  );
+
+  // 清空当前会话消息与记忆
+  const clearCurrentSession = useCallback(async () => {
+    if (!currentSessionId) return;
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    await agentService.deleteSession(currentSessionId).catch(() => {});
+    localStorage.removeItem(`${MESSAGES_PREFIX}${currentSessionId}`);
+    setMessages([]);
+    setCurrentThinking(null);
+    setIsLoading(false);
+    toast.success('会话历史与上下文已重置');
+  }, [currentSessionId]);
+
+  // 中断当前流式生成
+  const abortStream = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+      setIsLoading(false);
+      setCurrentThinking(null);
+      toast('已终止 Agent 执行');
+    }
+  }, []);
+
+  // 发送指令/需求
+  const sendMessage = useCallback(
+    async (text: string, contextHint?: string) => {
+      if (!text.trim() || isLoading) return;
+
+      const userMsgId = `msg_user_${Date.now()}`;
+      const assistantMsgId = `msg_ai_${Date.now()}`;
+
+      // 若有上下文(如当前处于某个管理路由),自动附加提示
+      const effectiveMessage = contextHint
+        ? `[系统上下文: ${contextHint}]\n${text}`
+        : text;
+
+      const userMessage: AgentMessage = {
+        id: userMsgId,
+        role: 'user',
+        content: text,
+        timestamp: Date.now(),
+      };
+
+      const initialAssistantMessage: AgentMessage = {
+        id: assistantMsgId,
+        role: 'assistant',
+        content: '',
+        timestamp: Date.now(),
+        isStreaming: true,
+        steps: [],
+        thinking: { status: 'started' },
+      };
+
+      const updatedHistory = [...messages, userMessage, initialAssistantMessage];
+      setMessages(updatedHistory);
+      setIsLoading(true);
+      setCurrentThinking({ status: 'started' });
+
+      abortControllerRef.current = new AbortController();
+
+      let currentAssistantContent = '';
+      const currentSteps: ToolStep[] = [];
+
+      try {
+        await agentService.chatStream(
+          {
+            message: effectiveMessage,
+            session_id: currentSessionId,
+            stream: true,
+          },
+          {
+            onThink: (step, status) => {
+              setCurrentThinking({ status: status || 'planning', step });
+              setMessages((prev) =>
+                prev.map((msg) =>
+                  msg.id === assistantMsgId
+                    ? { ...msg, thinking: { status: (status as any) || 'planning', step } }
+                    : msg
+                )
+              );
+            },
+            onToolStart: (tool, args, callId) => {
+              const newStep: ToolStep = {
+                tool,
+                arguments: args,
+                call_id: callId,
+                status: 'running',
+                startedAt: Date.now(),
+              };
+              currentSteps.push(newStep);
+
+              // 检查工具是否属于危险/写操作
+              const matchedTool = tools.find((t) => t.name === tool);
+              let dangerousAction: AgentDangerousAction | undefined = undefined;
+              if (matchedTool?.is_dangerous || tool.includes('cancel') || tool.includes('delete')) {
+                dangerousAction = {
+                  tool,
+                  arguments: args,
+                  call_id: callId,
+                  description: matchedTool?.description || '执行写操作',
+                };
+              }
+
+              setMessages((prev) =>
+                prev.map((msg) =>
+                  msg.id === assistantMsgId
+                    ? {
+                        ...msg,
+                        steps: [...currentSteps],
+                        dangerousAction: dangerousAction || msg.dangerousAction,
+                      }
+                    : msg
+                )
+              );
+            },
+            onToolEnd: (tool, result, isError, callId) => {
+              const target = currentSteps.find(
+                (s) => (callId && s.call_id === callId) || (!callId && s.tool === tool)
+              );
+              if (target) {
+                target.result = result;
+                target.is_error = isError;
+                target.status = isError ? 'failed' : 'completed';
+                target.completedAt = Date.now();
+              }
+              setMessages((prev) =>
+                prev.map((msg) =>
+                  msg.id === assistantMsgId
+                    ? {
+                        ...msg,
+                        steps: [...currentSteps],
+                      }
+                    : msg
+                )
+              );
+            },
+            onMessage: (delta, full) => {
+              currentAssistantContent = full || currentAssistantContent + delta;
+              setMessages((prev) =>
+                prev.map((msg) =>
+                  msg.id === assistantMsgId
+                    ? {
+                        ...msg,
+                        content: currentAssistantContent,
+                      }
+                    : msg
+                )
+              );
+            },
+            onFinish: (finalAnswer, stepsCount, resSessionId) => {
+              const finalContent = finalAnswer || currentAssistantContent;
+              const finalMessage: AgentMessage = {
+                id: assistantMsgId,
+                role: 'assistant',
+                content: finalContent,
+                timestamp: Date.now(),
+                isStreaming: false,
+                steps: [...currentSteps],
+                thinking: undefined,
+              };
+
+              const finalMessages = [
+                ...updatedHistory.slice(0, -1),
+                finalMessage,
+              ];
+              saveMessages(currentSessionId, finalMessages);
+              setIsLoading(false);
+              setCurrentThinking(null);
+            },
+            onError: (err: any) => {
+              const errMsg = typeof err === 'string' ? err : err?.message || '请求发生未知错误';
+              setMessages((prev) =>
+                prev.map((msg) =>
+                  msg.id === assistantMsgId
+                    ? {
+                        ...msg,
+                        isStreaming: false,
+                        error: errMsg,
+                        content: msg.content || `⚠️ [Agent 异常] ${errMsg}`,
+                      }
+                    : msg
+                )
+              );
+              setIsLoading(false);
+              setCurrentThinking(null);
+              toast.error(`Agent 异常: ${errMsg}`);
+            },
+          },
+          abortControllerRef.current.signal
+        );
+      } catch (err: any) {
+        console.error('Agent chat error:', err);
+        setIsLoading(false);
+        setCurrentThinking(null);
+      }
+    },
+    [currentSessionId, isLoading, messages, tools, saveMessages]
+  );
+
+  // 确认并下发高危操作二次确认
+  const handleConfirmDangerousAction = useCallback(
+    (action: AgentDangerousAction) => {
+      const confirmPrompt = `确认执行操作:【${action.tool}】,参数为:${JSON.stringify(action.arguments)}。请继续处理。`;
+      sendMessage(confirmPrompt);
+    },
+    [sendMessage]
+  );
+
+  return {
+    sessions,
+    currentSessionId,
+    messages,
+    isLoading,
+    currentThinking,
+    tools,
+    toolsLoading,
+    sendMessage,
+    abortStream,
+    createNewSession,
+    switchSession,
+    deleteSession,
+    clearCurrentSession,
+    handleConfirmDangerousAction,
+    loadTools,
+  };
+}

+ 248 - 0
src/lib/services/agentService.ts

@@ -0,0 +1,248 @@
+// src/lib/services/agentService.ts
+
+import api from '@/lib/api';
+import { AgentChatParams, AgentToolMetadata, SSEStreamHandlers } from '@/types/agent';
+
+const getBaseUrl = (): string => {
+  return process.env.NEXT_PUBLIC_API_URL || 'https://api.text.skin';
+};
+
+const getAuthToken = (): string => {
+  if (typeof window === 'undefined') return '';
+  return localStorage.getItem('rsid') || localStorage.getItem('access_token') || '';
+};
+
+export const agentService = {
+  /**
+   * 获取系统开放的 Agent 工具列表与元数据
+   */
+  async getTools(): Promise<AgentToolMetadata[]> {
+    try {
+      const res = await api.get('/api/agent/tools');
+      if (res.data && res.data.code === 0 && Array.isArray(res.data.data)) {
+        return res.data.data;
+      }
+      if (Array.isArray(res.data)) {
+        return res.data;
+      }
+      return [];
+    } catch (err) {
+      console.warn('获取 Agent 工具列表失败或接口暂未开放,返回默认工具集:', err);
+      // 降级兜底预置工具集(与文档一致)
+      return [
+        {
+          name: 'query_user_orders',
+          description: '查询订单列表,支持根据订单状态、关键词及数量筛选',
+          is_dangerous: false,
+          schema: {
+            type: 'function',
+            function: {
+              name: 'query_user_orders',
+              description: '查询订单列表',
+              parameters: {
+                type: 'object',
+                properties: {
+                  limit: { type: 'number', description: '获取条数' },
+                  status: { type: 'string', description: '订单状态 (pending, paid, cancelled)' }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: 'cancel_user_order',
+          description: '取消指定的订单(仅未完成/未关闭的订单可取消)',
+          is_dangerous: true,
+          schema: {
+            type: 'function',
+            function: {
+              name: 'cancel_user_order',
+              description: '取消指定订单',
+              parameters: {
+                type: 'object',
+                required: ['order_id'],
+                properties: {
+                  order_id: { type: 'string', description: '订单号,例如 ORD-20260908-9876' },
+                  reason: { type: 'string', description: '取消原因' }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: 'search_products',
+          description: '检索可用的增值服务/签证/产品列表与价格',
+          is_dangerous: false,
+          schema: {
+            type: 'function',
+            function: {
+              name: 'search_products',
+              description: '检索产品列表',
+              parameters: {
+                type: 'object',
+                properties: {
+                  country: { type: 'string', description: '目标国家/地区' },
+                  keyword: { type: 'string', description: '关键词' }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: 'query_user_info',
+          description: '查询注册用户详情与账户状态',
+          is_dangerous: false,
+        }
+      ];
+    }
+  },
+
+  /**
+   * 清除指定 session_id 的对话记忆与历史上下文
+   */
+  async deleteSession(sessionId: string): Promise<boolean> {
+    try {
+      const res = await api.delete(`/api/agent/session/${encodeURIComponent(sessionId)}`);
+      return res.data?.code === 0;
+    } catch (err) {
+      console.error('清除 Agent 会话记忆失败:', err);
+      return false;
+    }
+  },
+
+  /**
+   * 同步模式对话
+   */
+  async chatSync(params: AgentChatParams) {
+    const res = await api.post('/api/agent/chat', {
+      ...params,
+      stream: false,
+    });
+    return res.data;
+  },
+
+  /**
+   * SSE 流式模式对话(原生 fetch + ReadableStream 处理 text/event-stream)
+   */
+  async chatStream(
+    params: AgentChatParams,
+    handlers: SSEStreamHandlers,
+    signal?: AbortSignal
+  ): Promise<void> {
+    const token = getAuthToken();
+    const baseUrl = getBaseUrl();
+    const endpoint = `${baseUrl.replace(/\/$/, '')}/api/agent/chat`;
+
+    let response: Response;
+    try {
+      response = await fetch(endpoint, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          ...(token ? { Authorization: `Bearer ${token}` } : {}),
+        },
+        body: JSON.stringify({
+          message: params.message,
+          session_id: params.session_id || null,
+          stream: true,
+          max_steps: params.max_steps || 8,
+          model: params.model || null,
+        }),
+        signal,
+      });
+    } catch (err: any) {
+      if (err.name === 'AbortError') {
+        console.log('Agent 流式请求已主动终止');
+        return;
+      }
+      handlers.onError?.(err);
+      return;
+    }
+
+    if (!response.ok || !response.body) {
+      const errorMsg = `HTTP Error ${response.status}: ${response.statusText}`;
+      handlers.onError?.(new Error(errorMsg));
+      return;
+    }
+
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder('utf-8');
+    let buffer = '';
+
+    try {
+      while (true) {
+        const { value, done } = await reader.read();
+        if (done) break;
+
+        buffer += decoder.decode(value, { stream: true });
+        const chunks = buffer.split('\n\n');
+        buffer = chunks.pop() || ''; // 保留最后一个尚未完整的片段
+
+        for (const chunk of chunks) {
+          const trimmed = chunk.trim();
+          if (!trimmed) continue;
+
+          let eventType = 'message';
+          let dataStr = '';
+
+          const lines = trimmed.split('\n');
+          for (const line of lines) {
+            if (line.startsWith('event:')) {
+              eventType = line.replace('event:', '').trim();
+            } else if (line.startsWith('data:')) {
+              // 兼容 data: 后面带有空格或直接接 JSON
+              dataStr = line.slice(5).trim();
+            }
+          }
+
+          if (!dataStr) continue;
+
+          try {
+            const payload = JSON.parse(dataStr);
+            switch (eventType) {
+              case 'think':
+                handlers.onThink?.(payload.step || 1, payload.status);
+                break;
+              case 'tool_start':
+                handlers.onToolStart?.(payload.tool, payload.arguments || {}, payload.call_id);
+                break;
+              case 'tool_end':
+                handlers.onToolEnd?.(
+                  payload.tool,
+                  payload.result,
+                  Boolean(payload.is_error),
+                  payload.call_id
+                );
+                break;
+              case 'message':
+                handlers.onMessage?.(payload.delta || '', payload.full || '');
+                break;
+              case 'finish':
+                handlers.onFinish?.(payload.answer || '', payload.steps_count || 0, payload.session_id);
+                break;
+              case 'error':
+                handlers.onError?.(payload.error || 'Agent 执行异常');
+                break;
+              default:
+                // 未知事件类型,若包含 delta 则作为 message 兼容
+                if (payload.delta) {
+                  handlers.onMessage?.(payload.delta, payload.full || '');
+                }
+                break;
+            }
+          } catch (jsonErr) {
+            console.error('解析 SSE 数据包失败:', jsonErr, dataStr);
+          }
+        }
+      }
+    } catch (err: any) {
+      if (err.name === 'AbortError') {
+        console.log('Agent 流式传输已中断');
+      } else {
+        handlers.onError?.(err);
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  },
+};

+ 78 - 0
src/types/agent.ts

@@ -0,0 +1,78 @@
+// src/types/agent.ts
+
+export interface ToolStep {
+  tool: string;
+  arguments: Record<string, any>;
+  call_id?: string;
+  result?: any;
+  is_error?: boolean;
+  status: 'running' | 'completed' | 'failed';
+  startedAt?: number;
+  completedAt?: number;
+}
+
+export interface AgentToolFunction {
+  name: string;
+  description: string;
+  parameters?: Record<string, any>;
+}
+
+export interface AgentToolMetadata {
+  name: string;
+  description: string;
+  is_dangerous?: boolean;
+  schema?: {
+    type?: string;
+    function?: AgentToolFunction;
+  };
+}
+
+export interface AgentDangerousAction {
+  tool: string;
+  arguments: Record<string, any>;
+  call_id?: string;
+  description?: string;
+  confirmed?: boolean;
+  cancelled?: boolean;
+}
+
+export interface AgentMessage {
+  id: string;
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  timestamp: number;
+  steps?: ToolStep[];
+  thinking?: {
+    status: 'started' | 'planning' | 'executing' | 'idle';
+    step?: number;
+  };
+  isStreaming?: boolean;
+  error?: string;
+  dangerousAction?: AgentDangerousAction;
+}
+
+export interface AgentSession {
+  id: string;
+  title: string;
+  createdAt: number;
+  updatedAt: number;
+  messageCount: number;
+  lastMessageSnippet?: string;
+}
+
+export interface AgentChatParams {
+  message: string;
+  session_id?: string;
+  stream?: boolean;
+  max_steps?: number;
+  model?: string;
+}
+
+export interface SSEStreamHandlers {
+  onThink?: (step: number, status?: string) => void;
+  onToolStart?: (tool: string, args: Record<string, any>, callId?: string) => void;
+  onToolEnd?: (tool: string, result: any, isError: boolean, callId?: string) => void;
+  onMessage?: (delta: string, full: string) => void;
+  onFinish?: (finalAnswer: string, stepsCount: number, sessionId?: string) => void;
+  onError?: (err: any) => void;
+}

+ 1 - 0
src/types/index.ts

@@ -13,3 +13,4 @@ export * from './slot';
 export * from './card';
 export * from './plugin';
 export * from './node_config';
+export * from './agent';