feat: 完善 Server 层并添加 CLI 和 Web 前端

Server 层增强:
- 添加 Agent 适配层，支持动态加载 core 模块
- 实现 Token 认证机制，支持本地/远程模式
- WebSocket 集成 Agent 实时对话

CLI 模块 (packages/cli):
- serve 命令启动 HTTP Server
- attach 命令连接远程 Server
- API Client 封装

Web 前端 (packages/web):
- React 18 + Vite + Tailwind CSS
- 会话管理侧边栏
- WebSocket 实时聊天界面
- 流式消息显示

packages/web/src/hooks/useChat.ts

@@ -0,0 +1,165 @@
+/**
+ * Chat Hook
+ *
+ * 管理 WebSocket 连接和消息状态
+ */
+
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { createWebSocket, getMessages, type Message } from '../api/client';
+
+interface UseChatOptions {
+  sessionId: string;
+  onError?: (error: Error) => void;
+}
+
+interface ChatState {
+  messages: Message[];
+  isConnected: boolean;
+  isLoading: boolean;
+  streamingContent: string;
+}
+
+export function useChat({ sessionId, onError }: UseChatOptions) {
+  const [state, setState] = useState<ChatState>({
+    messages: [],
+    isConnected: false,
+    isLoading: false,
+    streamingContent: '',
+  });
+
+  const wsRef = useRef<WebSocket | null>(null);
+  const reconnectTimeoutRef = useRef<NodeJS.Timeout>();
+
+  // 加载历史消息
+  const loadMessages = useCallback(async () => {
+    try {
+      const { data } = await getMessages(sessionId);
+      setState((prev) => ({ ...prev, messages: data }));
+    } catch (error) {
+      onError?.(error instanceof Error ? error : new Error('Failed to load messages'));
+    }
+  }, [sessionId, onError]);
+
+  // 连接 WebSocket
+  const connect = useCallback(() => {
+    if (wsRef.current?.readyState === WebSocket.OPEN) return;
+
+    const ws = createWebSocket(sessionId);
+
+    ws.onopen = () => {
+      setState((prev) => ({ ...prev, isConnected: true }));
+    };
+
+    ws.onclose = () => {
+      setState((prev) => ({ ...prev, isConnected: false }));
+      // 自动重连
+      reconnectTimeoutRef.current = setTimeout(connect, 3000);
+    };
+
+    ws.onerror = () => {
+      onError?.(new Error('WebSocket connection error'));
+    };
+
+    ws.onmessage = (event) => {
+      try {
+        const message = JSON.parse(event.data);
+
+        switch (message.type) {
+          case 'chunk':
+            setState((prev) => ({
+              ...prev,
+              streamingContent: prev.streamingContent + (message.payload?.content || ''),
+            }));
+            break;
+
+          case 'done':
+            setState((prev) => {
+              const newMessage: Message = message.payload || {
+                id: Date.now().toString(),
+                role: 'assistant',
+                content: prev.streamingContent,
+                timestamp: new Date().toISOString(),
+              };
+              return {
+                ...prev,
+                messages: [...prev.messages, newMessage],
+                streamingContent: '',
+                isLoading: false,
+              };
+            });
+            break;
+
+          case 'message_received':
+            // 用户消息已确认
+            setState((prev) => ({
+              ...prev,
+              messages: [...prev.messages, message.payload],
+            }));
+            break;
+
+          case 'error':
+            onError?.(new Error(message.payload?.message || 'Unknown error'));
+            setState((prev) => ({ ...prev, isLoading: false, streamingContent: '' }));
+            break;
+        }
+      } catch {
+        // 忽略解析错误
+      }
+    };
+
+    wsRef.current = ws;
+  }, [sessionId, onError]);
+
+  // 发送消息
+  const sendMessage = useCallback(
+    (content: string) => {
+      if (!wsRef.current || wsRef.current.readyState !== WebSocket.OPEN) {
+        onError?.(new Error('WebSocket not connected'));
+        return;
+      }
+
+      setState((prev) => ({ ...prev, isLoading: true }));
+
+      wsRef.current.send(
+        JSON.stringify({
+          type: 'message',
+          sessionId,
+          payload: { content },
+        })
+      );
+    },
+    [sessionId, onError]
+  );
+
+  // 取消处理
+  const cancelProcessing = useCallback(() => {
+    if (!wsRef.current || wsRef.current.readyState !== WebSocket.OPEN) return;
+
+    wsRef.current.send(
+      JSON.stringify({
+        type: 'cancel',
+        sessionId,
+      })
+    );
+
+    setState((prev) => ({ ...prev, isLoading: false, streamingContent: '' }));
+  }, [sessionId]);
+
+  // 初始化
+  useEffect(() => {
+    loadMessages();
+    connect();
+
+    return () => {
+      clearTimeout(reconnectTimeoutRef.current);
+      wsRef.current?.close();
+    };
+  }, [loadMessages, connect]);
+
+  return {
+    ...state,
+    sendMessage,
+    cancelProcessing,
+    reload: loadMessages,
+  };
+}