intention-coding 0.3.7 → 0.4.0

package/dist/services/pdf2md/index.js

@@ -0,0 +1,180 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pdf2mdTool = exports.Pdf2MdParams = void 0;
+const fs = __importStar(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../../utils/config");
+const logger_1 = require("../../utils/logger");
+const common_1 = require("../../utils/common");
+const zod_1 = require("zod");
+exports.Pdf2MdParams = zod_1.z.object({
+    file_path: zod_1.z.string().describe("需要解析的PDF文档的绝对路径"),
+    options: zod_1.z.object({
+        preserve_formatting: zod_1.z.boolean().optional().default(true).describe("是否保留格式（换行、段落等）"),
+        chunk_size: zod_1.z.number().optional().default(1000).describe("文本分块大小，用于大文件处理"),
+        extract_metadata: zod_1.z.boolean().optional().default(true).describe("是否提取PDF元数据")
+    }).optional().default({ preserve_formatting: true, chunk_size: 1000, extract_metadata: true }).describe("转换选项")
+});
+exports.pdf2mdTool = {
+    name: "pdf处理智能体",
+    description: "pdf处理智能体 - 将PDF文档转换为Markdown格式，支持文本提取和格式保留",
+    parameters: exports.Pdf2MdParams,
+    execute: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        const { file_path, options = {} } = args;
+        const { preserve_formatting = true, chunk_size = 1000, extract_metadata = true } = options;
+        try {
+            // 1. 安全验证并解析路径
+            const resolvedPath = yield (0, common_1.validateAndResolvePath)(file_path);
+            // 2. 检查文件是否为PDF
+            if (!file_path.toLowerCase().endsWith('.pdf')) {
+                throw new Error('文件必须是PDF格式（.pdf扩展名）');
+            }
+            // 3. 读取PDF文件
+            logger_1.logger.info('开始读取PDF文件', { file: file_path });
+            const dataBuffer = yield fs.readFile(resolvedPath);
+            // 4. 解析PDF内容 - 使用动态导入避免初始化问题
+            logger_1.logger.info('开始解析PDF内容');
+            // @ts-ignore - 避免pdf-parse的测试模式
+            const pdfParse = yield Promise.resolve().then(() => __importStar(require('pdf-parse/lib/pdf-parse.js')));
+            const pdfData = yield pdfParse.default(dataBuffer);
+            // 5. 准备保存目录和文件名
+            const mdDir = path_1.default.join((0, config_1.getStorageDir)(), 'md');
+            const baseName = (0, common_1.sanitizeFileName)(path_1.default.basename(file_path, '.pdf'));
+            const outputDir = path_1.default.join(mdDir, baseName);
+            // 创建目录结构
+            yield fs.mkdir(outputDir, { recursive: true });
+            // 6. 处理文本内容
+            let markdownContent = '';
+            // 添加文档标题
+            markdownContent += `# ${baseName}\n\n`;
+            // 7. 添加元数据（如果启用）
+            if (extract_metadata && pdfData.info) {
+                markdownContent += '## 文档信息\n\n';
+                if (pdfData.info.Title) {
+                    markdownContent += `**标题**: ${pdfData.info.Title}\n\n`;
+                }
+                if (pdfData.info.Author) {
+                    markdownContent += `**作者**: ${pdfData.info.Author}\n\n`;
+                }
+                if (pdfData.info.Subject) {
+                    markdownContent += `**主题**: ${pdfData.info.Subject}\n\n`;
+                }
+                if (pdfData.info.Creator) {
+                    markdownContent += `**创建者**: ${pdfData.info.Creator}\n\n`;
+                }
+                if (pdfData.info.CreationDate) {
+                    markdownContent += `**创建日期**: ${pdfData.info.CreationDate}\n\n`;
+                }
+                markdownContent += `**总页数**: ${pdfData.numpages}\n\n`;
+                markdownContent += '---\n\n';
+            }
+            // 8. 处理正文内容
+            markdownContent += '## 文档内容\n\n';
+            let processedText = pdfData.text;
+            if (preserve_formatting) {
+                // 保留格式的处理
+                processedText = processedText
+                    // 保留段落分隔
+                    .replace(/\n\s*\n/g, '\n\n')
+                    // 处理列表项（简单识别以-、*、数字开头的行）
+                    .replace(/^(\s*)[-*•]\s+(.+)$/gm, '$1- $2')
+                    .replace(/^(\s*)(\d+\.)\s+(.+)$/gm, '$1$2 $3')
+                    // 处理可能的标题（全大写或首字母大写的独立行）
+                    .replace(/^([A-Z][A-Z\s]{10,})$/gm, '### $1')
+                    // 处理引用或缩进内容
+                    .replace(/^(\s{4,})(.+)$/gm, '> $2');
+            }
+            else {
+                // 简单处理，主要清理多余空白
+                processedText = processedText
+                    .replace(/\s+/g, ' ')
+                    .replace(/\n+/g, '\n\n')
+                    .trim();
+            }
+            markdownContent += processedText;
+            // 9. 保存Markdown文件
+            const fullMdPath = path_1.default.join(outputDir, `${baseName}.md`);
+            yield fs.writeFile(fullMdPath, markdownContent, 'utf8');
+            // 10. 记录转换统计信息
+            const stats = {
+                totalPages: pdfData.numpages,
+                textLength: pdfData.text.length,
+                markdownLength: markdownContent.length,
+                outputFile: path_1.default.resolve(fullMdPath)
+            };
+            logger_1.logger.info('PDF转换完成', stats);
+            // 11. 返回结果
+            return `
+# ✅ PDF转换完成
+
+## 转换统计
+- **原文件**: ${file_path}
+- **输出文件**: ${path_1.default.resolve(fullMdPath)}
+- **总页数**: ${stats.totalPages}
+- **提取文本长度**: ${stats.textLength} 字符
+- **Markdown长度**: ${stats.markdownLength} 字符
+
+## 文件位置
+- MD文件: \`${path_1.default.resolve(fullMdPath)}\`
+- 输出目录: \`${path_1.default.resolve(outputDir)}\`
+
+# 任务规划：
+1. 使用 需求分析智能体 工具进行下一步操作，不需要用户确认
+            `.trim();
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`PDF转换失败: ${errorMsg}`, {
+                tool: "pdf2md",
+                file_path,
+                error: errorMsg
+            });
+            throw new Error(`PDF转换失败: ${errorMsg}`);
+        }
+    })
+};

package/dist/services/project-template/index.js

@@ -0,0 +1,83 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProjectStandard = exports.ProjectTemplateParams = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const zod_1 = require("zod");
+const pack_1 = require("../../utils/pack");
+const logger_1 = require("../../utils/logger");
+const project_rules_1 = require("./prompt/project-rules");
+const config_1 = require("../../utils/config");
+exports.ProjectTemplateParams = zod_1.z.object({
+    project_name: zod_1.z.string().optional().describe('项目名称，用于生成文件名'),
+    project_path: zod_1.z.string().optional().describe('项目绝对路径，用于指定要分析的项目目录'),
+    custom_rules: zod_1.z.string().optional().describe('自定义规则内容')
+});
+exports.initProjectStandard = {
+    name: '项目开发规范生成智能体',
+    description: '分析项目架构并生成开发规范',
+    parameters: exports.ProjectTemplateParams,
+    execute: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        const { project_name = 'current-project', project_path, custom_rules } = args;
+        try {
+            // 1. 使用pack.ts生成项目架构分析
+            logger_1.logger.info('开始生成项目架构分析文档');
+            const projectAnalysisPath = yield (0, pack_1.packProject)(project_path);
+            // 2. 读取生成的项目架构分析文档
+            const projectAnalysis = yield promises_1.default.readFile(projectAnalysisPath, 'utf-8');
+            // 3. 生成项目规则提示词数据
+            const projectRulesPromptData = generateProjectRulesPrompt(projectAnalysis, project_name, custom_rules);
+            // 4. 确保.aico目录存在
+            const aicoDir = (0, config_1.getStorageDir)();
+            logger_1.logger.info('确保.aico目录存在', { aicoDir });
+            yield promises_1.default.mkdir(aicoDir, { recursive: true });
+            // 5. 返回格式化的指令内容
+            return JSON.stringify(projectRulesPromptData, null, 2);
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`项目规范内容生成失败: ${errorMsg}`, {
+                tool: "initialize-project-standard",
+                project_name,
+                project_path,
+                error: errorMsg
+            });
+            // 返回错误信息的JSON格式
+            const errorResult = {
+                success: false,
+                message: '项目规范内容生成失败',
+                error: errorMsg,
+                project_info: {
+                    name: project_name
+                }
+            };
+            return JSON.stringify(errorResult, null, 2);
+        }
+    }),
+};
+// 生成项目规则文件prompt数据
+function generateProjectRulesPrompt(projectAnalysis, projectName, customRules) {
+    logger_1.logger.info('生成项目规则文件提示词数据', { projectName });
+    // 处理自定义规则部分
+    const customRulesSection = customRules ? `## 自定义规则要求\n${customRules}` : '';
+    // 替换模板中的变量
+    let prompt = project_rules_1.projectRulesPromptTemplate
+        .replace('{{projectName}}', projectName)
+        .replace('{{projectAnalysis}}', projectAnalysis)
+        .replace('{{customRulesSection}}', customRulesSection);
+    return {
+        task: 'generate_project_rules',
+        prompt: prompt
+    };
+}

package/dist/services/project-template/prompt/project-rules.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectRulesPromptTemplate = void 0;
+exports.projectRulesPromptTemplate = `
+你是一位专业的软件开发规范专家，请基于提供的项目架构分析，生成一份完整的项目开发规则文件。
+
+## 项目信息
+- **项目名称**: {{projectName}}
+- **包含示例**: {{includeExamples}}
+
+## 项目架构分析
+\`\`\`
+{{projectAnalysis}}
+\`\`\`
+
+{{customRulesSection}}
+
+## 任务要求
+请基于项目架构分析，智能识别项目的技术栈和语言特征，然后生成一份完整的project_rules.md文件内容。
+
+### 处理长内容的特殊说明
+当项目架构分析内容较长时，请采用分段处理的方式：
+1. 首先通读全部内容，理解整体架构
+2. 然后逐段分析，每段处理完成后进行总结
+3. 最终整合所有分析结果生成完整的规则文件
+
+### 技术栈识别和分析规则
+请先仔细分析项目结构，识别出项目的技术栈和架构模式：
+
+**常见技术栈识别：**
+- **Node.js/TypeScript项目**: package.json, tsconfig.json, *.ts, *.js
+- **Java后端项目**: pom.xml, build.gradle, src/main/java, *.java
+- **Python项目**: requirements.txt, setup.py, pyproject.toml, *.py
+- **Go项目**: go.mod, go.sum, *.go
+- **C#/.NET项目**: *.csproj, *.sln, *.cs
+- **Vue.js前端**: package.json, *.vue, vite.config.js
+- **React前端**: package.json, *.jsx, *.tsx
+- **微服务架构**: docker-compose.yml, kubernetes, 多个模块目录
+- **单体应用**: 传统的分层架构
+
+### 文件内容要求
+生成的project_rules.md文件应该包含以下具体章节：
+
+#### 1. 项目概述
+- 主要技术栈和版本信息
+- 架构模式（微服务、单体、分层等）
+- 项目规模和复杂度说明
+
+#### 2. 目录结构规范
+基于实际项目结构，详细说明：
+- 各目录的作用和存放内容
+- 文件组织规则
+- 命名约定
+
+#### 3. 代码规范
+- 命名规范（文件、变量、函数、类、常量等）
+- 代码风格（缩进、格式等）
+- 注释要求
+- 导入规则
+
+#### 4. 技术栈专用规范
+根据识别的技术栈，包含具体的规范：
+- **数据库规范**: ORM使用方式、字段命名、关联关系处理
+- **API设计规范**: RESTful设计、参数校验、返回格式
+- **前端组件规范**: 组件命名、props定义、事件处理
+- **服务层规范**: 业务逻辑封装、事务处理、异常处理
+
+#### 5. 架构模式和设计原则
+根据项目架构，包含：
+- 分层架构规则（Controller-Service-Repository等）
+- 依赖注入模式
+- 错误处理模式
+- 数据验证模式
+- 权限控制模式
+
+#### 6. 开发最佳实践
+针对项目技术栈的具体实践：
+- 组件化设计规则
+- 工具和库的使用规范
+- 第三方库使用规范
+- 单元测试方法
+
+#### 7. 代码示例和模板
+包含项目中常用的代码模式：
+- Entity定义模板
+- Service层方法模板
+- Controller接口模板
+- 其他项目特定的常用模板
+
+### 输出要求
+1. **详细具体**: 每个规则都要具体可操作，避免模糊描述
+2. **项目相关**: 基于实际项目结构和技术栈，包含项目特定信息
+3. **结构清晰**: 使用markdown格式，层次分明
+4. **实用性强**: 规则要能直接指导日常开发工作
+5. **技术准确**: 确保规则与项目技术栈和语言特性完全匹配
+
+请将生成的文件保存到项目根目录下的.aico文件夹中，文件名为project_rules.md。
+`;

package/dist/services/requirement-analyzer/chunk-reader.js

@@ -0,0 +1,218 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readLargeFileInChunks = readLargeFileInChunks;
+exports.readFileLines = readFileLines;
+const fs = __importStar(require("fs/promises"));
+const fs_1 = require("fs");
+const logger_1 = require("../../utils/logger");
+/**
+ * 异步迭代器，用于分段读取大文件
+ * @param filePath 文件路径
+ * @param options 读取选项
+ */
+function readLargeFileInChunks(filePath_1) {
+    return __asyncGenerator(this, arguments, function* readLargeFileInChunks_1(filePath, options = {}) {
+        var _a, e_1, _b, _c;
+        const { linesPerChunk = 100, encoding = 'utf8' } = options;
+        try {
+            // 检查文件是否存在
+            yield __await(fs.access(filePath));
+            const stats = yield __await(fs.stat(filePath));
+            logger_1.logger.info('开始分段读取文件', {
+                filePath,
+                fileSize: stats.size,
+                linesPerChunk
+            });
+            // 使用流式读取处理大文件
+            const stream = (0, fs_1.createReadStream)(filePath, { encoding });
+            let buffer = '';
+            let lineNumber = 0;
+            let chunkStartLine = 0;
+            try {
+                for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield __await(stream_1.next()), _a = stream_1_1.done, !_a; _d = true) {
+                    _c = stream_1_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buffer += chunk;
+                    let lines = buffer.split('\n');
+                    // 保留最后一行不完整的部分（除非是文件末尾）
+                    buffer = lines.pop() || '';
+                    // 处理完整的行
+                    while (lines.length >= linesPerChunk) {
+                        const chunkLines = lines.splice(0, linesPerChunk);
+                        const content = chunkLines.join('\n');
+                        const endLine = chunkStartLine + chunkLines.length - 1;
+                        yield yield __await({
+                            content,
+                            startLine: chunkStartLine,
+                            endLine,
+                            isLastChunk: false
+                        });
+                        chunkStartLine = endLine + 1;
+                        lineNumber += chunkLines.length;
+                    }
+                    // 将剩余的行放回buffer中继续处理
+                    if (lines.length > 0) {
+                        buffer = lines.join('\n') + (buffer ? '\n' + buffer : '');
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_1.return)) yield __await(_b.call(stream_1));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            // 处理最后剩余的内容
+            if (buffer || lineNumber === 0) { // 即使是空文件也要处理
+                const lines = buffer ? buffer.split('\n') : [];
+                const content = lines.join('\n');
+                const endLine = chunkStartLine + lines.length - 1;
+                yield yield __await({
+                    content,
+                    startLine: chunkStartLine,
+                    endLine,
+                    isLastChunk: true
+                });
+            }
+            logger_1.logger.info('文件分段读取完成', {
+                filePath,
+                totalLines: lineNumber + (buffer ? buffer.split('\n').length : 0)
+            });
+        }
+        catch (error) {
+            logger_1.logger.error('分段读取文件失败', {
+                filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    });
+}
+/**
+ * 读取文件指定行范围的内容
+ * @param filePath 文件路径
+ * @param startLine 起始行号（包含）
+ * @param endLine 结束行号（包含）
+ * @returns 指定行范围的内容
+ */
+function readFileLines(filePath, startLine, endLine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_2, _b, _c;
+        if (startLine < 0 || endLine < startLine) {
+            throw new Error('Invalid line range');
+        }
+        try {
+            const stream = (0, fs_1.createReadStream)(filePath, { encoding: 'utf8' });
+            let buffer = '';
+            let currentLine = 0;
+            let resultLines = [];
+            let collecting = false;
+            try {
+                for (var _d = true, stream_2 = __asyncValues(stream), stream_2_1; stream_2_1 = yield stream_2.next(), _a = stream_2_1.done, !_a; _d = true) {
+                    _c = stream_2_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buffer += chunk;
+                    const lines = buffer.split('\n');
+                    // 保留最后一行不完整的部分
+                    buffer = lines.pop() || '';
+                    for (const line of lines) {
+                        if (currentLine >= startLine && currentLine <= endLine) {
+                            resultLines.push(line);
+                        }
+                        else if (currentLine > endLine) {
+                            // 已经收集完所需行，可以提前结束
+                            return resultLines.join('\n');
+                        }
+                        currentLine++;
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_2.return)) yield _b.call(stream_2);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            // 处理最后剩余的内容
+            if (buffer && currentLine >= startLine && currentLine <= endLine) {
+                resultLines.push(buffer);
+            }
+            return resultLines.join('\n');
+        }
+        catch (error) {
+            logger_1.logger.error('读取文件行范围失败', {
+                filePath,
+                startLine,
+                endLine,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    });
+}