flashclaw 1.5.0 → 1.6.1

package/dist/utils/network.js

@@ -0,0 +1,129 @@
+/**
+ * FlashClaw 网络工具函数
+ * IP 检测、URL 提取、文本截断等
+ */
+import { isIP } from 'net';
+// ==================== URL 提取 ====================
+const WEB_FETCH_URL_RE = /https?:\/\/[^\s<>()]+/i;
+const WEB_FETCH_DOMAIN_RE = /(?:^|[^A-Za-z0-9.-])((?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,})(:\d{2,5})?(\/[^\s<>()]*)?/i;
+const TRAILING_PUNCT_RE = /[)\],.。，;；!！?？]+$/;
+/**
+ * 从文本中提取第一个 URL
+ * 支持完整 URL 和裸域名（自动添加 https://）
+ */
+export function extractFirstUrl(text) {
+    const match = text.match(WEB_FETCH_URL_RE);
+    if (match) {
+        return match[0].replace(TRAILING_PUNCT_RE, '');
+    }
+    const domainMatch = text.match(WEB_FETCH_DOMAIN_RE);
+    if (!domainMatch)
+        return null;
+    const host = domainMatch[1];
+    const port = domainMatch[2] ?? '';
+    const urlPath = domainMatch[3] ?? '';
+    const candidate = `https://${host}${port}${urlPath}`;
+    return candidate.replace(TRAILING_PUNCT_RE, '');
+}
+// ==================== IP 安全检测 ====================
+/**
+ * 检测 IPv4 是否为私有地址
+ */
+export function isPrivateIpv4(ip) {
+    const parts = ip.split('.').map((part) => Number(part));
+    if (parts.length !== 4 || parts.some((part) => Number.isNaN(part)))
+        return false;
+    const [a, b] = parts;
+    if (a === 0)
+        return true;
+    if (a === 10)
+        return true;
+    if (a === 127)
+        return true;
+    if (a === 169 && b === 254)
+        return true;
+    if (a === 172 && b >= 16 && b <= 31)
+        return true;
+    if (a === 192 && b === 168)
+        return true;
+    if (a === 100 && b >= 64 && b <= 127)
+        return true;
+    return false;
+}
+/**
+ * 检测 IPv6 是否为私有地址
+ */
+export function isPrivateIpv6(ip) {
+    const normalized = ip.toLowerCase();
+    if (normalized === '::' || normalized === '::1')
+        return true;
+    if (normalized.startsWith('fe80:'))
+        return true;
+    if (normalized.startsWith('fec0:'))
+        return true;
+    if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+        return true;
+    if (normalized.includes('::ffff:')) {
+        const ipv4Part = normalized.split('::ffff:')[1];
+        if (ipv4Part && isPrivateIpv4(ipv4Part))
+            return true;
+    }
+    return false;
+}
+/**
+ * 检测 IP 是否为私有地址（自动判断 IPv4/IPv6）
+ */
+export function isPrivateIp(ip) {
+    const family = isIP(ip);
+    if (family === 4)
+        return isPrivateIpv4(ip);
+    if (family === 6)
+        return isPrivateIpv6(ip);
+    return false;
+}
+/**
+ * 检测主机名是否为被阻止的内部地址
+ */
+export function isBlockedHostname(hostname) {
+    const normalized = hostname.trim().toLowerCase();
+    if (normalized === 'localhost')
+        return true;
+    return (normalized.endsWith('.localhost') ||
+        normalized.endsWith('.local') ||
+        normalized.endsWith('.internal'));
+}
+// ==================== 文本工具 ====================
+/**
+ * 估算 base64 编码内容的原始字节数
+ */
+export function estimateBase64Bytes(content) {
+    if (!content)
+        return null;
+    const raw = content.startsWith('data:') ? content.split(',')[1] ?? '' : content;
+    const normalized = raw.replace(/\s+/g, '');
+    if (!normalized)
+        return 0;
+    const padding = normalized.endsWith('==') ? 2 : normalized.endsWith('=') ? 1 : 0;
+    return Math.max(0, Math.floor((normalized.length * 3) / 4) - padding);
+}
+/**
+ * 截断文本到指定长度
+ */
+export function truncateText(text, maxLength) {
+    if (text.length <= maxLength) {
+        return { text, truncated: false };
+    }
+    return { text: `${text.slice(0, maxLength)}\n\n...（内容已截断）`, truncated: true };
+}
+/**
+ * XML 转义（用于消息构建）
+ */
+export function escapeXml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=network.js.map

package/dist/utils/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flashclaw",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "⚡ 闪电龙虾 - 快如闪电的 AI 助手，乐高式插件架构",
   "type": "module",
   "main": "dist/index.js",
@@ -62,22 +62,27 @@
     "dotenv": "^17.2.3",
     "hono": "^4.6.14",
     "jiti": "^2.6.1",
+    "openai": "^6.25.0",
     "p-limit": "^7.2.0",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0",
     "undici": "^7.20.0",
+    "ws": "^8.18.0",
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "playwright-core": "^1.58.1",
     "cheerio": "^1.2.0",
     "html-to-text": "^9.0.5",
+    "playwright-core": "^1.58.1",
     "turndown": "^7.2.2"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.10.0",
     "@types/ws": "^8.18.1",
+    "alpinejs": "^3.13.3",
+    "htmx.org": "^1.9.10",
+    "marked": "^15.0.4",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
     "vitest": "^4.0.18"

package/plugins/anthropic-provider/index.ts

@@ -0,0 +1,461 @@
+/**
+ * Anthropic AI Provider 插件
+ * 实现 AIProviderPlugin 接口，支持 Claude 等模型
+ */
+
+import Anthropic from '@anthropic-ai/sdk';
+import type {
+  AIProviderPlugin,
+  ChatMessage,
+  ChatOptions,
+  StreamEvent,
+  ToolExecutor,
+  HeartbeatCallback,
+  PluginConfig,
+  ImageBlock,
+  TextBlock,
+} from '../../src/plugins/types';
+
+// ==================== 内部状态 ====================
+
+let client: Anthropic | null = null;
+let model: string = 'claude-sonnet-4-20250514';
+
+// ==================== 内部常量和工具函数 ====================
+
+const MAX_TOOL_CALL_DEPTH = 20;
+const MAX_TOOL_RESULT_CHARS = 4000;
+const KEEP_RECENT_TOOL_ROUNDS = 2;
+
+function truncateToolResult(content: string, maxChars: number): string {
+  if (content.length <= maxChars) return content;
+  return content.slice(0, maxChars) + `\n...(内容已截断，原始 ${content.length} 字符)`;
+}
+
+function compressToolHistory(
+  messages: Anthropic.MessageParam[],
+  keepRecentRounds: number,
+): Anthropic.MessageParam[] {
+  const toolRoundIndices: number[] = [];
+  for (let i = 0; i < messages.length; i++) {
+    const msg = messages[i];
+    if (msg.role === 'assistant' && Array.isArray(msg.content)) {
+      const hasToolUse = (msg.content as Anthropic.ContentBlock[]).some(
+        (b) => b.type === 'tool_use'
+      );
+      if (hasToolUse) toolRoundIndices.push(i);
+    }
+  }
+
+  if (toolRoundIndices.length <= keepRecentRounds) return messages;
+
+  const compressCount = toolRoundIndices.length - keepRecentRounds;
+  const toCompress = new Set(toolRoundIndices.slice(0, compressCount));
+
+  const result: Anthropic.MessageParam[] = [];
+  for (let i = 0; i < messages.length; i++) {
+    const msg = messages[i];
+
+    if (toCompress.has(i) && msg.role === 'assistant' && Array.isArray(msg.content)) {
+      const summaryParts: string[] = [];
+      for (const block of msg.content as Anthropic.ContentBlock[]) {
+        if (block.type === 'tool_use') {
+          const inputStr = JSON.stringify(block.input);
+          const inputPreview = inputStr.length > 80 ? inputStr.slice(0, 80) + '...' : inputStr;
+          summaryParts.push(`[已执行工具 ${block.name}(${inputPreview})]`);
+        } else if (block.type === 'text' && (block as Anthropic.TextBlock).text) {
+          summaryParts.push((block as Anthropic.TextBlock).text);
+        }
+      }
+      result.push({ role: 'assistant', content: summaryParts.join('\n') || '[工具调用]' });
+
+      if (i + 1 < messages.length && messages[i + 1].role === 'user') {
+        const nextMsg = messages[i + 1];
+        if (Array.isArray(nextMsg.content)) {
+          const resultParts: string[] = [];
+          for (const block of nextMsg.content as Anthropic.ToolResultBlockParam[]) {
+            if (block.type === 'tool_result') {
+              const contentStr = typeof block.content === 'string' ? block.content : '';
+              const preview = contentStr.length > 100 ? contentStr.slice(0, 100) + '...' : contentStr;
+              resultParts.push(block.is_error ? `[失败: ${preview}]` : `[成功: ${preview}]`);
+            }
+          }
+          result.push({ role: 'user', content: resultParts.join('\n') || '[工具结果]' });
+          i++;
+        } else {
+          result.push(nextMsg);
+          i++;
+        }
+      }
+    } else {
+      result.push(msg);
+    }
+  }
+
+  return result;
+}
+
+function extractText(response: Anthropic.Message): string {
+  const textBlocks = response.content.filter(
+    (block): block is Anthropic.TextBlock => block.type === 'text'
+  );
+  return textBlocks.map(block => block.text).join('');
+}
+
+async function streamFollowUp(
+  messages: Anthropic.MessageParam[],
+  options?: ChatOptions,
+  heartbeat?: HeartbeatCallback
+): Promise<Anthropic.Message> {
+  if (!client) {
+    throw new Error('Provider not initialized. Call init() first.');
+  }
+
+  const params: Anthropic.MessageCreateParams = {
+    model: model,
+    max_tokens: options?.maxTokens ?? 4096,
+    messages,
+    stream: true,
+  };
+
+  if (options?.system) {
+    params.system = options.system;
+  }
+
+  if (options?.tools && options.tools.length > 0) {
+    params.tools = options.tools as unknown as Anthropic.Tool[];
+  }
+
+  const stream = await client.messages.create(params);
+
+  let finalMessage: Anthropic.Message | null = null;
+  const contentBlocks: Array<Anthropic.TextBlock | Anthropic.ToolUseBlock> = [];
+  const partialJsonParts = new Map<number, string[]>();
+
+  for await (const event of stream as AsyncIterable<Anthropic.MessageStreamEvent>) {
+    heartbeat?.();
+
+    if (event.type === 'message_start') {
+      finalMessage = event.message as Anthropic.Message;
+    } else if (event.type === 'content_block_start') {
+      const block = event.content_block;
+      if (block.type === 'text') {
+        contentBlocks[event.index] = { type: 'text' as const, text: '', citations: null };
+      } else if (block.type === 'tool_use') {
+        contentBlocks[event.index] = {
+          type: 'tool_use' as const,
+          id: block.id,
+          name: block.name,
+          input: {},
+        };
+        partialJsonParts.set(event.index, []);
+      }
+    } else if (event.type === 'content_block_delta') {
+      const delta = event.delta;
+      if ('text' in delta) {
+        const block = contentBlocks[event.index];
+        if (block?.type === 'text') {
+          block.text += delta.text;
+        }
+      } else if ('partial_json' in delta) {
+        const parts = partialJsonParts.get(event.index);
+        if (parts) {
+          parts.push(delta.partial_json);
+        }
+      }
+    } else if (event.type === 'content_block_stop') {
+      const block = contentBlocks[event.index];
+      if (block?.type === 'tool_use') {
+        const parts = partialJsonParts.get(event.index);
+        if (parts && parts.length > 0) {
+          try {
+            block.input = JSON.parse(parts.join(''));
+          } catch {
+            block.input = {};
+          }
+        }
+      }
+    } else if (event.type === 'message_delta') {
+      if (finalMessage) {
+        finalMessage.stop_reason = event.delta.stop_reason ?? finalMessage.stop_reason;
+        if (event.usage) {
+          finalMessage.usage.output_tokens = event.usage.output_tokens;
+        }
+      }
+    }
+  }
+
+  if (!finalMessage) {
+    throw new Error('工具链后续请求未收到响应');
+  }
+
+  finalMessage.content = contentBlocks.filter(
+    (block): block is Anthropic.TextBlock | Anthropic.ToolUseBlock => block != null
+  );
+
+  return finalMessage;
+}
+
+async function handleToolUseInternal(
+  response: Anthropic.Message,
+  messages: Anthropic.MessageParam[],
+  executeTool: ToolExecutor,
+  options?: ChatOptions,
+  depth: number = 0,
+  heartbeat?: HeartbeatCallback
+): Promise<string> {
+  if (depth >= MAX_TOOL_CALL_DEPTH) {
+    return extractText(response) || `[工具调用链过深（超过 ${MAX_TOOL_CALL_DEPTH} 轮），已强制终止]`;
+  }
+
+  const toolUseBlocks = response.content.filter(
+    (block): block is Anthropic.ToolUseBlock => block.type === 'tool_use'
+  );
+
+  if (toolUseBlocks.length === 0) {
+    return extractText(response);
+  }
+
+  let newMessages: Anthropic.MessageParam[] = [
+    ...messages,
+    {
+      role: 'assistant' as const,
+      content: response.content,
+    },
+  ];
+
+  const toolResults: Anthropic.ToolResultBlockParam[] = [];
+
+  for (const toolUse of toolUseBlocks) {
+    heartbeat?.();
+    try {
+      const result = await executeTool(toolUse.name, toolUse.input);
+      const content = typeof result === 'string' ? result : JSON.stringify(result);
+      toolResults.push({
+        type: 'tool_result',
+        tool_use_id: toolUse.id,
+        content: truncateToolResult(content, MAX_TOOL_RESULT_CHARS),
+      });
+    } catch (error) {
+      toolResults.push({
+        type: 'tool_result',
+        tool_use_id: toolUse.id,
+        content: `工具执行失败: ${(error as Error).message}`,
+        is_error: true,
+      });
+    }
+  }
+
+  heartbeat?.();
+
+  newMessages.push({
+    role: 'user',
+    content: toolResults,
+  });
+
+  if (depth >= KEEP_RECENT_TOOL_ROUNDS) {
+    newMessages = compressToolHistory(newMessages, KEEP_RECENT_TOOL_ROUNDS);
+  }
+
+  const nextResponse = await streamFollowUp(newMessages, options, heartbeat);
+
+  if (nextResponse.stop_reason === 'tool_use') {
+    return handleToolUseInternal(nextResponse, newMessages, executeTool, options, depth + 1, heartbeat);
+  }
+
+  return extractText(nextResponse);
+}
+
+// ==================== Provider 实现 ====================
+
+const anthropicProvider: AIProviderPlugin = {
+  name: 'anthropic-provider',
+  version: '1.0.0',
+  description: 'Anthropic AI Provider - 支持 Claude 等模型',
+
+  async init(config: PluginConfig): Promise<void> {
+    const apiKey = config.apiKey as string || process.env.ANTHROPIC_AUTH_TOKEN || process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+      throw new Error('Missing API key: ANTHROPIC_AUTH_TOKEN or ANTHROPIC_API_KEY');
+    }
+
+    client = new Anthropic({
+      apiKey,
+      baseURL: config.baseURL as string || process.env.ANTHROPIC_BASE_URL,
+      maxRetries: 0,
+      timeout: config.timeout ? Number(config.timeout) : 60000,
+    });
+
+    model = config.model as string || process.env.AI_MODEL || process.env.ANTHROPIC_MODEL || 'claude-sonnet-4-20250514';
+  },
+
+  async chat(
+    messages: ChatMessage[],
+    options?: ChatOptions
+  ): Promise<Anthropic.Message> {
+    if (!client) {
+      throw new Error('Provider not initialized. Call init() first.');
+    }
+
+    const params: Anthropic.MessageCreateParams = {
+      model: model,
+      max_tokens: options?.maxTokens ?? 4096,
+      messages: messages.map(msg => ({
+        role: msg.role,
+        content: msg.content,
+      })),
+    };
+
+    if (options?.system) {
+      params.system = options.system;
+    }
+
+    if (options?.tools && options.tools.length > 0) {
+      params.tools = options.tools as unknown as Anthropic.Tool[];
+    }
+
+    if (options?.temperature !== undefined) {
+      params.temperature = options.temperature;
+    }
+
+    if (options?.stopSequences && options.stopSequences.length > 0) {
+      params.stop_sequences = options.stopSequences;
+    }
+
+    return await client.messages.create(params);
+  },
+
+  async *chatStream(
+    messages: ChatMessage[],
+    options?: ChatOptions
+  ): AsyncGenerator<StreamEvent> {
+    if (!client) {
+      throw new Error('Provider not initialized. Call init() first.');
+    }
+
+    const params: Anthropic.MessageCreateParams = {
+      model: model,
+      max_tokens: options?.maxTokens ?? 4096,
+      messages: messages.map(msg => ({
+        role: msg.role,
+        content: msg.content,
+      })),
+      stream: true,
+    };
+
+    if (options?.system) {
+      params.system = options.system;
+    }
+
+    if (options?.tools && options.tools.length > 0) {
+      params.tools = options.tools as unknown as Anthropic.Tool[];
+    }
+
+    if (options?.temperature !== undefined) {
+      params.temperature = options.temperature;
+    }
+
+    const stream = await client.messages.create(params);
+
+    let finalMessage: Anthropic.Message | null = null;
+    const contentBlocks: Array<Anthropic.TextBlock | Anthropic.ToolUseBlock> = [];
+    const partialJsonParts = new Map<number, string[]>();
+
+    for await (const event of stream as AsyncIterable<Anthropic.MessageStreamEvent>) {
+      if (event.type === 'message_start') {
+        finalMessage = event.message as Anthropic.Message;
+      } else if (event.type === 'content_block_start') {
+        const block = event.content_block;
+        if (block.type === 'text') {
+          contentBlocks[event.index] = { type: 'text' as const, text: '', citations: null };
+        } else if (block.type === 'tool_use') {
+          contentBlocks[event.index] = {
+            type: 'tool_use' as const,
+            id: block.id,
+            name: block.name,
+            input: {},
+          };
+          partialJsonParts.set(event.index, []);
+        }
+      } else if (event.type === 'content_block_delta') {
+        const delta = event.delta;
+        if ('text' in delta) {
+          const block = contentBlocks[event.index];
+          if (block?.type === 'text') {
+            block.text += delta.text;
+          }
+          yield { type: 'text', text: delta.text };
+        } else if ('partial_json' in delta) {
+          const parts = partialJsonParts.get(event.index);
+          if (parts) {
+            parts.push(delta.partial_json);
+          }
+        }
+      } else if (event.type === 'content_block_stop') {
+        const block = contentBlocks[event.index];
+        if (block?.type === 'tool_use') {
+          const parts = partialJsonParts.get(event.index);
+          if (parts && parts.length > 0) {
+            try {
+              block.input = JSON.parse(parts.join(''));
+            } catch {
+              block.input = {};
+            }
+          }
+        }
+      } else if (event.type === 'message_delta') {
+        if (finalMessage) {
+          finalMessage.stop_reason = event.delta.stop_reason ?? finalMessage.stop_reason;
+          if (event.usage) {
+            finalMessage.usage.output_tokens = event.usage.output_tokens;
+          }
+        }
+      }
+    }
+
+    if (finalMessage) {
+      finalMessage.content = contentBlocks.filter(
+        (block): block is Anthropic.TextBlock | Anthropic.ToolUseBlock => block != null
+      );
+
+      for (const block of finalMessage.content) {
+        if (block.type === 'tool_use') {
+          yield {
+            type: 'tool_use',
+            id: block.id,
+            name: block.name,
+            input: block.input,
+          };
+        }
+      }
+
+      yield { type: 'done', message: finalMessage };
+    }
+  },
+
+  async handleToolUse(
+    response: unknown,
+    messages: ChatMessage[],
+    executeTool: ToolExecutor,
+    options?: ChatOptions,
+    heartbeat?: HeartbeatCallback
+  ): Promise<string> {
+    const anthropicResponse = response as Anthropic.Message;
+    const apiMessages: Anthropic.MessageParam[] = messages.map(msg => ({
+      role: msg.role as 'user' | 'assistant',
+      content: msg.content,
+    }));
+
+    return handleToolUseInternal(anthropicResponse, apiMessages, executeTool, options, 0, heartbeat);
+  },
+
+  getModel(): string {
+    return model;
+  },
+
+  setModel(newModel: string): void {
+    model = newModel;
+  },
+};
+
+export default anthropicProvider;

package/plugins/anthropic-provider/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "anthropic-provider",
+  "version": "1.0.0",
+  "type": "provider",
+  "description": "Anthropic AI Provider - 支持 Claude 等模型",
+  "main": "index.ts"
+}

package/plugins/cli-channel/index.ts

@@ -0,0 +1,51 @@
+/**
+ * CLI 渠道插件 - 终端交互渠道
+ *
+ * 作为 FlashClaw 的内置终端渠道，
+ * 提供 CLI 命令客户端连接到服务
+ *
+ * 使用方式：
+ * 1. 启动服务: flashclaw start
+ * 2. 连接 CLI: flashclaw cli
+ */
+
+import type { ChannelPlugin, MessageHandler, PluginConfig, SendMessageResult } from '../../src/plugins/types.js';
+import { createLogger } from '../../src/logger.js';
+
+const logger = createLogger('CLI-Channel');
+
+const plugin: ChannelPlugin & {
+  group: string;
+} = {
+  name: 'cli-channel',
+  version: '1.0.0',
+  group: 'cli-default',
+
+  async init(_config: PluginConfig): Promise<void> {
+    // CLI 渠道不需要特殊配置
+  },
+
+  onMessage(_handler: MessageHandler): void {
+    // CLI 是客户端模式，由 flashclaw cli 命令连接
+    // 消息通过 HTTP API 传输
+  },
+
+  async start(): Promise<void> {
+    // CLI 渠道是客户端模式，不绑定终端
+    // 用户通过 flashclaw cli 命令连接
+    // 消息通过 web-ui 的 /api/chat 接口传输
+    logger.info('CLI 渠道已就绪，使用 flashclaw cli 连接服务');
+  },
+
+  async stop(): Promise<void> {
+    // 清理资源
+  },
+
+  async sendMessage(_chatId: string, content: string): Promise<SendMessageResult> {
+    // CLI 渠道的消息由 flashclaw cli 命令处理
+    // 这里不需要实现（消息通过 API 传输）
+    return { success: true };
+  }
+};
+
+export default plugin;