tianxincode 1.0.0

package/dist/modules/ai/openai.provider.d.ts

@@ -0,0 +1,138 @@
+/**
+ * OpenAI Provider 模块
+ *
+ * 本模块负责与 OpenAI API (及兼容 API) 进行交互
+ *
+ * 核心功能：
+ * 1. chat() - 发送聊天请求，获取完整响应
+ * 2. chatStream() - 流式聊天，逐块获取响应
+ * 3. Tool Calls - 支持 AI 调用工具 (Function Calling)
+ *
+ * 支持的 AI 提供商：
+ * - OpenAI (GPT-4, GPT-3.5)
+ * - 兼容 OpenAI API 的其他提供商 (如 Anthropic Claude 通过适配器)
+ * - 自定义 API 端点 (通过 baseUrl 配置)
+ *
+ * 使用方式：
+ *   const provider = new OpenAIProvider({
+ *     apiKey: 'your-api-key',
+ *     baseUrl: 'https://api.openai.com/v1',
+ *     defaultModel: 'gpt-4'
+ *   });
+ *
+ *   const response = await provider.chat([
+ *     { role: 'user', content: '你好' }
+ *   ]);
+ */
+import { ChatMessage, ChatOptions, ChatResponse } from './ai.types.js';
+/**
+ * OpenAI Provider 配置参数
+ */
+export interface OpenAIConfig {
+    /** API 密钥 */
+    apiKey: string;
+    /** API 基础 URL (可选，默认 OpenAI) */
+    baseUrl?: string;
+    /** 默认模型名称 (可选，默认 gpt-4) */
+    defaultModel?: string;
+}
+/**
+ * OpenAIProvider 类
+ *
+ * 封装与 OpenAI API 的所有交互逻辑
+ * 使用原生 fetch API 发送请求
+ *
+ * API 端点：
+ * - POST /chat/completions - 聊天完成
+ *
+ * 请求格式：
+ * - model: 模型名称
+ * - messages: 消息数组
+ * - temperature: 温度参数 (0-2)
+ * - max_tokens: 最大 Token 数
+ * - tools: 工具定义数组 (可选)
+ * - tool_choice: 工具选择策略 (可选)
+ * - stream: 是否流式响应 (可选)
+ */
+export declare class OpenAIProvider {
+    /** API 密钥 */
+    private apiKey;
+    /** API 基础 URL */
+    private baseUrl;
+    /** 默认模型名称 */
+    private defaultModel;
+    /**
+     * 构造函数
+     *
+     * @param config - 配置对象
+     *
+     * baseUrl 默认值说明：
+     * - OpenAI: https://api.openai.com/v1
+     * - 本地部署: http://localhost:11434/v1 (Ollama)
+     * - 自定义: 用户配置的任意兼容 API 地址
+     */
+    constructor(config: OpenAIConfig);
+    /**
+     * 发送聊天请求 (非流式)
+     *
+     * 将消息数组发送给 AI，获取完整的响应
+     * 支持 Tool Calls 功能
+     *
+     * 执行流程：
+     * 1. 构建请求体 (model, messages, temperature 等)
+     * 2. 如果有工具定义，添加到请求体
+     * 3. 发送 POST 请求到 /chat/completions
+     * 4. 解析响应，返回 ChatResponse
+     *
+     * @param messages - 消息数组，包含角色和内容
+     * @param options - 可选配置 (temperature, maxTokens, model, tools)
+     * @returns {Promise<ChatResponse>} AI 响应对象
+     *
+     * @example
+     * const response = await provider.chat([
+     *   { role: 'system', content: '你是一个助手' },
+     *   { role: 'user', content: '你好' }
+     * ]);
+     *
+     * console.log(response.content);  // AI 的回复
+     * console.log(response.usage);    // Token 使用量
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * 流式聊天
+     *
+     * 使用 Server-Sent Events (SSE) 流式获取 AI 响应
+     * 适用于需要实时展示 AI 回复的场景
+     *
+     * 实现原理：
+     * 1. 发送请求时设置 stream: true
+     * 2. 逐块读取响应体
+     * 3. 解析每个 SSE 消息块
+     * 4. yield 每个内容块给调用者
+     * 5. 直到收到 [DONE] 标记结束
+     *
+     * @param messages - 消息数组
+     * @param options - 可选配置
+     * @returns {AsyncGenerator<string>} 异步生成器，逐块返回内容
+     */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<string, void, unknown>;
+    /**
+     * 格式化消息
+     *
+     * 将内部 ChatMessage 格式转换为 OpenAI API 格式
+     *
+     * @param message - 内部消息格式
+     * @returns {Record<string, any>} OpenAPI API 消息格式
+     */
+    private formatMessage;
+    /**
+     * 解析 API 响应
+     *
+     * 将 OpenAI API 响应转换为内部 ChatResponse 格式
+     *
+     * @param data - OpenAI API 响应数据
+     * @returns {ChatResponse} 内部响应格式
+     */
+    private parseResponse;
+}
+//# sourceMappingURL=openai.provider.d.ts.map

package/dist/modules/ai/openai.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.provider.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/openai.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EAGb,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,aAAa;IACb,OAAO,CAAC,MAAM,CAAS;IACvB,iBAAiB;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,aAAa;IACb,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;;;;;OASG;gBACS,MAAM,EAAE,YAAY;IAMhC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC;IA0DxB;;;;;;;;;;;;;;;;OAgBG;IACI,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,WAAgB,GACxB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAqFxC;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CA+BtB"}

package/dist/modules/ai/openai.provider.js

@@ -0,0 +1,279 @@
+/**
+ * OpenAI Provider 模块
+ *
+ * 本模块负责与 OpenAI API (及兼容 API) 进行交互
+ *
+ * 核心功能：
+ * 1. chat() - 发送聊天请求，获取完整响应
+ * 2. chatStream() - 流式聊天，逐块获取响应
+ * 3. Tool Calls - 支持 AI 调用工具 (Function Calling)
+ *
+ * 支持的 AI 提供商：
+ * - OpenAI (GPT-4, GPT-3.5)
+ * - 兼容 OpenAI API 的其他提供商 (如 Anthropic Claude 通过适配器)
+ * - 自定义 API 端点 (通过 baseUrl 配置)
+ *
+ * 使用方式：
+ *   const provider = new OpenAIProvider({
+ *     apiKey: 'your-api-key',
+ *     baseUrl: 'https://api.openai.com/v1',
+ *     defaultModel: 'gpt-4'
+ *   });
+ *
+ *   const response = await provider.chat([
+ *     { role: 'user', content: '你好' }
+ *   ]);
+ */
+import { logger } from '../logger/index.js';
+/**
+ * OpenAIProvider 类
+ *
+ * 封装与 OpenAI API 的所有交互逻辑
+ * 使用原生 fetch API 发送请求
+ *
+ * API 端点：
+ * - POST /chat/completions - 聊天完成
+ *
+ * 请求格式：
+ * - model: 模型名称
+ * - messages: 消息数组
+ * - temperature: 温度参数 (0-2)
+ * - max_tokens: 最大 Token 数
+ * - tools: 工具定义数组 (可选)
+ * - tool_choice: 工具选择策略 (可选)
+ * - stream: 是否流式响应 (可选)
+ */
+export class OpenAIProvider {
+    /**
+     * 构造函数
+     *
+     * @param config - 配置对象
+     *
+     * baseUrl 默认值说明：
+     * - OpenAI: https://api.openai.com/v1
+     * - 本地部署: http://localhost:11434/v1 (Ollama)
+     * - 自定义: 用户配置的任意兼容 API 地址
+     */
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+        this.defaultModel = config.defaultModel || 'gpt-4';
+    }
+    /**
+     * 发送聊天请求 (非流式)
+     *
+     * 将消息数组发送给 AI，获取完整的响应
+     * 支持 Tool Calls 功能
+     *
+     * 执行流程：
+     * 1. 构建请求体 (model, messages, temperature 等)
+     * 2. 如果有工具定义，添加到请求体
+     * 3. 发送 POST 请求到 /chat/completions
+     * 4. 解析响应，返回 ChatResponse
+     *
+     * @param messages - 消息数组，包含角色和内容
+     * @param options - 可选配置 (temperature, maxTokens, model, tools)
+     * @returns {Promise<ChatResponse>} AI 响应对象
+     *
+     * @example
+     * const response = await provider.chat([
+     *   { role: 'system', content: '你是一个助手' },
+     *   { role: 'user', content: '你好' }
+     * ]);
+     *
+     * console.log(response.content);  // AI 的回复
+     * console.log(response.usage);    // Token 使用量
+     */
+    async chat(messages, options = {}) {
+        // ========== 提取配置参数 ==========
+        // 使用提供的值或默认值
+        const { temperature = 0.7, // 温度：控制生成随机性，0-2 之间
+        maxTokens = 2000, // 最大 Token 数
+        model = this.defaultModel, // 模型名称
+        tools, // 工具定义数组 (可选)
+         } = options;
+        // ========== 构建请求体 ==========
+        const requestBody = {
+            model,
+            messages: messages.map(m => this.formatMessage(m)), // 格式化每条消息
+            temperature,
+            max_tokens: maxTokens,
+        };
+        // ========== 添加工具定义 ==========
+        // 如果提供了工具，AI 可以选择调用工具
+        if (tools && tools.length > 0) {
+            requestBody.tools = tools;
+            requestBody.tool_choice = 'auto'; // 让 AI 自动决定是否调用工具
+        }
+        // ========== 发送请求 ==========
+        // 完整的 API 端点: {baseUrl}/chat/completions
+        const url = `${this.baseUrl}/chat/completions`;
+        // 记录请求日志 (调试用)
+        logger.logRequest(url, requestBody);
+        // 使用 fetch 发送 POST 请求
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`, // Bearer Token 认证
+            },
+            body: JSON.stringify(requestBody),
+        });
+        // ========== 错误处理 ==========
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${response.status} - ${error}`);
+        }
+        // ========== 解析响应 ==========
+        const data = (await response.json());
+        // 记录响应日志
+        logger.logResponse(url, data);
+        // 转换为内部格式并返回
+        return this.parseResponse(data);
+    }
+    /**
+     * 流式聊天
+     *
+     * 使用 Server-Sent Events (SSE) 流式获取 AI 响应
+     * 适用于需要实时展示 AI 回复的场景
+     *
+     * 实现原理：
+     * 1. 发送请求时设置 stream: true
+     * 2. 逐块读取响应体
+     * 3. 解析每个 SSE 消息块
+     * 4. yield 每个内容块给调用者
+     * 5. 直到收到 [DONE] 标记结束
+     *
+     * @param messages - 消息数组
+     * @param options - 可选配置
+     * @returns {AsyncGenerator<string>} 异步生成器，逐块返回内容
+     */
+    async *chatStream(messages, options = {}) {
+        const { temperature = 0.7, maxTokens = 2000, model = this.defaultModel, } = options;
+        // 构建请求体，设置 stream: true
+        const url = `${this.baseUrl}/chat/completions`;
+        const requestBody = {
+            model,
+            messages: messages.map(m => this.formatMessage(m)),
+            temperature,
+            max_tokens: maxTokens,
+            stream: true, // 关键：启用流式响应
+        };
+        logger.logRequest(url, requestBody);
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            throw new Error(`OpenAI API error: ${response.status}`);
+        }
+        // ========== 获取响应流 ==========
+        // response.body 是一个 ReadableStream
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error('No response body');
+        const decoder = new TextDecoder(); // 解码二进制数据
+        let buffer = ''; // 缓冲区，存储未处理的数据
+        const streamData = []; // 存储所有响应数据 (日志用)
+        // ========== 循环读取流数据 ==========
+        while (true) {
+            // 读取一块数据
+            const { done, value } = await reader.read();
+            if (done)
+                break; // 流已结束
+            // 解码并追加到缓冲区
+            buffer += decoder.decode(value, { stream: true });
+            // 按行分割
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // 保留最后一行 (可能不完整)
+            // ========== 处理每一行 ==========
+            for (const line of lines) {
+                const trimmed = line.trim();
+                // SSE 格式: data: {...}
+                if (trimmed.startsWith('data: ')) {
+                    const data = trimmed.slice(6); // 去掉 'data: ' 前缀
+                    streamData.push(data);
+                    // ========== 检查结束标记 ==========
+                    if (data === '[DONE]') {
+                        logger.logResponse(url, streamData);
+                        return; // 流式响应结束
+                    }
+                    // ========== 解析并 yield 内容 ==========
+                    try {
+                        const parsed = JSON.parse(data);
+                        // OpenAI 流式响应的格式: choices[0].delta.content
+                        const content = parsed.choices?.[0]?.delta?.content;
+                        if (content) {
+                            yield content; // 返回内容块
+                        }
+                    }
+                    catch { }
+                }
+            }
+        }
+        logger.logResponse(url, streamData);
+    }
+    /**
+     * 格式化消息
+     *
+     * 将内部 ChatMessage 格式转换为 OpenAI API 格式
+     *
+     * @param message - 内部消息格式
+     * @returns {Record<string, any>} OpenAPI API 消息格式
+     */
+    formatMessage(message) {
+        const formatted = {
+            role: message.role,
+            content: message.content,
+        };
+        // 添加可选字段
+        if (message.name)
+            formatted.name = message.name;
+        if (message.toolCallId)
+            formatted.tool_call_id = message.toolCallId;
+        if (message.toolCalls)
+            formatted.tool_calls = message.toolCalls;
+        return formatted;
+    }
+    /**
+     * 解析 API 响应
+     *
+     * 将 OpenAI API 响应转换为内部 ChatResponse 格式
+     *
+     * @param data - OpenAI API 响应数据
+     * @returns {ChatResponse} 内部响应格式
+     */
+    parseResponse(data) {
+        // 获取第一个 choice (通常只有一个)
+        const choice = data.choices[0];
+        const message = choice.message;
+        // 构建响应对象
+        const response = {
+            content: message.content || '', // AI 回复内容
+            finishReason: choice.finish_reason, // 结束原因
+            usage: data.usage ? {
+                promptTokens: data.usage.prompt_tokens,
+                completionTokens: data.usage.completion_tokens,
+                totalTokens: data.usage.total_tokens,
+            } : undefined,
+        };
+        // ========== 处理工具调用 ==========
+        // 如果 AI 调用了工具，解析工具调用信息
+        if (message.tool_calls && message.tool_calls.length > 0) {
+            response.toolCalls = message.tool_calls.map((tc) => ({
+                id: tc.id, // 工具调用 ID
+                type: 'function', // 调用类型
+                function: {
+                    name: tc.function.name, // 工具名称
+                    arguments: tc.function.arguments, // 工具参数 (JSON 字符串)
+                },
+            }));
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=openai.provider.js.map

package/dist/modules/ai/openai.provider.js.map

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

package/dist/modules/ai/react/index.d.ts

@@ -0,0 +1,5 @@
+export { reactParser } from './react.parser.js';
+export { buildReActPrompt } from './react.prompts.js';
+export { ReActParser } from './react.parser.js';
+export type { ToolDefinition, ReActStep, ReActResult, ParsedBlock, SkillInfo, ToolParameterProperty, ToolParameters } from './react.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/ai/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/ai/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,cAAc,EACf,MAAM,kBAAkB,CAAC"}

package/dist/modules/ai/react/index.js

@@ -0,0 +1,4 @@
+export { reactParser } from './react.parser.js';
+export { buildReActPrompt } from './react.prompts.js';
+export { ReActParser } from './react.parser.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/ai/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/ai/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/modules/ai/react/prompt/role.txt

@@ -0,0 +1,51 @@
+你是 txcode，一个帮助用户完成软件工程任务的交互式命令行工具。按照以下说明和可用工具来协助用户。
+
+如果用户寻求帮助或想提供反馈，请告知他们：
+/help：获取使用 txcode 的帮助
+如需提供反馈，请在 https://gitee.com/homecommunity/txcode 提交问题
+
+## 语气和风格
+你应该简洁、直接、切中要点。请记住，你的输出将显示在命令行界面上。你的回复可以使用 GitHub 风格的 markdown 进行格式化，并将使用 CommonMark 规范以等宽字体呈现。
+除非用户明确要求，否则不要使用表情符号。除非被要求，否则在所有交流中避免使用表情符号。
+重要：在保持帮助性、质量和准确性的前提下，你应该尽可能减少输出标记。仅处理当前的特定查询或任务，除非对完成请求至关重要，否则避免无关信息。如果你能用1-3句话或一个简短的段落回答，请这样做。
+重要：除非用户要求，否则你不应添加不必要的开场白或结束语（例如解释你的代码或总结你的操作）。
+重要：保持回复简短，因为它们将显示在命令行界面上。除非用户要求详细说明，否则你的回答必须简洁，少于4行文本（不包括工具使用或代码生成）。直接回答用户的问题，无需阐述、解释或细节。
+
+## 主动性
+你可以主动行事，但仅限于用户要求你这样做。你应该努力在以下两点之间取得平衡：
+1、在被要求时做正确的事，包括采取行动和后续行动
+2、不要未经询问就采取行动让用户感到意外
+例如，如果用户询问你如何处理某事，你应该首先尽力回答他们的问题，而不是立即采取行动。
+3、除非用户要求，否则不要添加额外的代码解释总结。处理完文件后，直接停止，不要解释你做了什么。
+
+## 遵循惯例
+在修改文件时，首先要了解文件的代码惯例。模仿代码风格，使用现有的库和实用程序，并遵循现有模式。
+·绝对不要假设某个库可用，即使它是众所周知的。每当你编写使用库或框架的代码时，首先要检查此代码库是否已使用该库。例如，你可以查看相邻文件，或检查 package.json（或 cargo.toml，等等，具体取决于语言）。
+·当你创建新组件时，首先查看现有组件以了解它们的编写方式；然后考虑框架选择、命名约定、类型和其他约定。
+·当你编辑一段代码时，首先查看代码的周围上下文（特别是其导入语句），以了解代码选择的框架和库。然后考虑如何以最符合惯用法的方式进行给定的更改。
+始终遵循安全最佳实践。切勿引入暴露或记录机密和密钥的代码。切勿将机密或密钥提交到代码库。
+
+## 代码风格
+重要：除非被要求，否则不要添加 任何 注释
+
+## 执行任务
+用户主要会要求你执行软件工程任务。这包括解决错误、添加新功能、重构代码、解释代码等等。对于这些任务，建议遵循以下步骤：
+·推荐检查AGENT.md了解项目（如果存在），然后使用查询记忆的工具查询有没有相关记忆，再根据SKILL有没有可用的SKILL
+·使用可用的搜索工具来理解代码库和用户的查询。建议广泛并行和串行地使用搜索工具。
+·使用你所有可用的工具来实现解决方案
+·如果可能，通过测试验证解决方案。绝对不要假设特定的测试框架或测试脚本。查看 README 或搜索代码库以确定测试方法。
+·非常重要：当你完成任务后，如果提供了 lint 和类型检查命令（例如 npm run lint、npm run typecheck、ruff 等），你必须使用 Bash 运行它们，以确保你的代码正确。如果你找不到正确的命令，请询问用户要运行的命令，如果他们提供了，主动建议将其写入 AGENTS.md，以便你下次知道要运行它。
+·除非用户明确要求，否则绝对不要提交更改。非常重要，仅在明确要求时才提交，否则用户会觉得你过于主动。
+
+## 工具使用策略
+你可以在单个响应中调用多个工具。当请求多个独立信息时，请将你的工具调用组合在一起以获得最佳性能。当进行多个 bash 工具调用时，你必须发送一条包含多个工具调用的消息以并行运行这些调用。例如，如果你需要运行“git status”和“git diff”，请发送一条包含两个工具调用的消息以并行运行这些调用。
+你必须简洁地回答，文本少于 4 行（不包括工具使用或代码生成），除非用户要求详细信息。
+重要：在开始工作之前，根据文件名和目录结构思考你要编辑的代码应该做什么。
+
+## 代码引用
+在引用特定函数或代码片段时，请包含 file_path:line_number 格式的模式，以便用户轻松导航到源代码位置。
+<example> 用户：客户端的错误在哪里处理？ 助手：客户端在 `src/services/process.ts:712` 的 `connectToServer` 函数中被标记为失败。 </example>
+
+## 运行环境
+- 操作系统: {platform}
+- 工作目录: {workdir}

package/dist/modules/ai/react/react.parser.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ReAct 响应解析器
+ *
+ * 本模块负责解析 AI 返回的文本内容
+ * AI 返回的是包含 Thought、Action、Observation 等字段的文本
+ * 需要从中提取出结构化的步骤信息
+ *
+ * 解析流程：
+ * 1. splitBlocks() - 按 "---" 分隔符分割文本为多个块
+ * 2. 识别每块的类型：
+ *    - content: 大文本内容 (用于占位符替换)
+ *    - step: 步骤块 (包含 thought, action, action_input, final_answer 等)
+ *    - observation: 观察结果块
+ * 3. replacePlaceholders() - 替换占位符 (如 $content:1)
+ * 4. 返回结构化的 steps 数组和 finalAnswer
+ *
+ * AI 输出格式示例（XML）：
+ * ```xml
+ * <react>
+ *   <thought>我需要读取文件</thought>
+ *   <action>readFile</action>
+ *   <action_input>
+ *     <path>/path/to/file</path>
+ *   </action_input>
+ *   <keep_context>true</keep_context>
+ * </react>
+ * ---
+ * <react>
+ *   <thought>需要创建一个组件</thought>
+ *   <action>write_file</action>
+ *   <action_input>
+ *     <path>src/Hello.tsx</path>
+ *     <content><![CDATA[import React from 'react';]]></content>
+ *   </action_input>
+ * </react>
+ * ---
+ * Tool Result:
+ * ---
+ * 观察结果
+ * ---
+ * ```
+ */
+import { ReActStep } from './react.types.js';
+/**
+ * ReActParser 类
+ *
+ * 将 AI 返回的文本解析为结构化的 ReActStep 数组
+ */
+export declare class ReActParser {
+    parse(content: string): {
+        steps: ReActStep[];
+        finalAnswer: string;
+    };
+    private splitBlocks;
+    /**
+     * 解析 XML 格式的块
+     */
+    private parseXMLBlock;
+    /**
+     * 解析 XML 参数节点
+     */
+    private parseXMLParams;
+    /**
+     * 从 XML 内容中提取纯文本，处理 CDATA
+     */
+    private extractCDATAOrText;
+    private replacePlaceholders;
+    private isEncodedContent;
+    private decodeContent;
+    hasFinalAnswer(steps: ReActStep[]): boolean;
+    formatObservation(observation: any): string;
+    buildObservationResponse(observation: any): string;
+}
+export declare const reactParser: ReActParser;
+//# sourceMappingURL=react.parser.d.ts.map

package/dist/modules/ai/react/react.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.parser.d.ts","sourceRoot":"","sources":["../../../../src/modules/ai/react/react.parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,SAAS,EAAe,MAAM,kBAAkB,CAAC;AAE1D;;;;GAIG;AACH,qBAAa,WAAW;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAwCnE,OAAO,CAAC,WAAW;IAsDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,aAAa;IAUrB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO;IAI3C,iBAAiB,CAAC,WAAW,EAAE,GAAG,GAAG,MAAM;IAO3C,wBAAwB,CAAC,WAAW,EAAE,GAAG,GAAG,MAAM;CAUnD;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}