intention-coding 0.6.0 → 0.6.2

package/dist/index.cjs

@@ -1,4 +1,7 @@
 "use strict";
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return 'undefined' == typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
 var __webpack_modules__ = {
     "fs/promises": function(module) {
         module.exports = import("fs/promises").then(function(module) {
@@ -6372,9 +6375,9 @@ Scenario Outline: \u{7528}\u{6237}\u{901A}\u{8FC7}API\u{67E5}\u{8BE2}\u{8BA2}\u{
             }
             return null;
         }
-        saveToCache(cacheKey, document) {
+        saveToCache(cacheKey, document1) {
             DocumentGenerator.cache.set(cacheKey, {
-                document,
+                document: document1,
                 timestamp: Date.now()
             });
             logger.info("\u6587\u6863\u5DF2\u4FDD\u5B58\u5230\u7F13\u5B58", {
@@ -6608,19 +6611,19 @@ ${combinedFeatureContent}
         async generateDocument(content, title, requirementType, projectInfo, customPrompt, outputPath) {
             try {
                 const cacheKey = this.generateCacheKey(content, requirementType, customPrompt);
-                let document = this.getCachedDocument(cacheKey);
-                if (document) {
+                let document1 = this.getCachedDocument(cacheKey);
+                if (document1) {
                     logger.info("\u4F7F\u7528\u7F13\u5B58\u7684\u6587\u6863", {
                         title,
                         requirementType
                     });
-                    return document;
+                    return document1;
                 }
                 const template = this.templateSelector.selectTemplate(requirementType);
                 this.templateSelector.validateTemplate(template, requirementType);
                 const fullPrompt = this.buildDocumentPrompt(template, content, title, projectInfo, customPrompt, requirementType);
                 if (outputPath) try {
-                    document = await this.generateDocumentStream(fullPrompt, outputPath, title, "", {
+                    document1 = await this.generateDocumentStream(fullPrompt, outputPath, title, "", {
                         realTimeMode: true
                     });
                 } catch (streamError) {
@@ -6628,18 +6631,18 @@ ${combinedFeatureContent}
                         error: streamError,
                         requirementType
                     });
-                    document = await openAIService.generateText({
+                    document1 = await openAIService.generateText({
                         prompt: fullPrompt,
                         system_prompt: "\u4F60\u662F\u4E00\u4F4D\u4E13\u4E1A\u7684\u6280\u672F\u6587\u6863\u7F16\u5199\u4E13\u5BB6\uFF0C\u8BF7\u751F\u6210\u5B8C\u6574\u3001\u8BE6\u7EC6\u7684\u6280\u672F\u9700\u6C42\u6587\u6863\u3002"
                     });
                 }
-                else document = await openAIService.generateText({
+                else document1 = await openAIService.generateText({
                     prompt: fullPrompt,
                     system_prompt: "\u4F60\u662F\u4E00\u4F4D\u4E13\u4E1A\u7684\u6280\u672F\u6587\u6863\u7F16\u5199\u4E13\u5BB6\uFF0C\u8BF7\u751F\u6210\u5B8C\u6574\u3001\u8BE6\u7EC6\u7684\u6280\u672F\u9700\u6C42\u6587\u6863\u3002"
                 });
-                this.validateGeneratedDocument(document, title);
-                this.saveToCache(cacheKey, document);
-                return document;
+                this.validateGeneratedDocument(document1, title);
+                this.saveToCache(cacheKey, document1);
+                return document1;
             } catch (error) {
                 logger.error("\u6280\u672F\u6587\u6863\u751F\u6210\u5931\u8D25", {
                     error,
@@ -6927,9 +6930,9 @@ ${existingContent}
 
 \u{8BF7}\u{7EE7}\u{7EED}\u{751F}\u{6210}\u{FF1A}`;
         }
-        isDocumentComplete(document) {
-            const hasEnding = document.includes("## \u66F4\u65B0\u65E5\u5FD7") || document.includes("---\n\n**") || document.trim().endsWith("---") || document.trim().endsWith("\u3002") || document.trim().endsWith("\uFF09");
-            const hasReasonableLength = document.length >= 1000;
+        isDocumentComplete(document1) {
+            const hasEnding = document1.includes("## \u66F4\u65B0\u65E5\u5FD7") || document1.includes("---\n\n**") || document1.trim().endsWith("---") || document1.trim().endsWith("\u3002") || document1.trim().endsWith("\uFF09");
+            const hasReasonableLength = document1.length >= 1000;
             return hasEnding && hasReasonableLength;
         }
         async continueDocumentGeneration(originalPrompt, existingContent, outputPath) {
@@ -7124,15 +7127,15 @@ ${customPrompt}` : ""}
                 });
             }
         }
-        validateGeneratedDocument(document, title) {
-            if (!document || document.trim().length < 100) throw new RequirementAnalysisError("\u751F\u6210\u7684\u6280\u672F\u6587\u6863\u5185\u5BB9\u8FC7\u77ED\uFF0C\u53EF\u80FD\u5B58\u5728\u95EE\u9898", types_ErrorCodes.DOCUMENT_GENERATION_FAILED, {
+        validateGeneratedDocument(document1, title) {
+            if (!document1 || document1.trim().length < 100) throw new RequirementAnalysisError("\u751F\u6210\u7684\u6280\u672F\u6587\u6863\u5185\u5BB9\u8FC7\u77ED\uFF0C\u53EF\u80FD\u5B58\u5728\u95EE\u9898", types_ErrorCodes.DOCUMENT_GENERATION_FAILED, {
                 title,
-                documentLength: document?.length || 0
+                documentLength: document1?.length || 0
             });
-            if (!document.includes(title)) logger.warn("\u751F\u6210\u7684\u6587\u6863\u53EF\u80FD\u4E0E\u9700\u6C42\u6807\u9898\u4E0D\u5339\u914D", {
+            if (!document1.includes(title)) logger.warn("\u751F\u6210\u7684\u6587\u6863\u53EF\u80FD\u4E0E\u9700\u6C42\u6807\u9898\u4E0D\u5339\u914D", {
                 title
             });
-            if (document.includes("## 3.1 ER\u903B\u8F91\u56FE\u8BBE\u8BA1") && !document.includes("erDiagram") && !document.includes("entity")) logger.warn("\u751F\u6210\u7684\u6587\u6863\u53EF\u80FD\u7F3A\u5C11ER\u56FE\u5185\u5BB9", {
+            if (document1.includes("## 3.1 ER\u903B\u8F91\u56FE\u8BBE\u8BA1") && !document1.includes("erDiagram") && !document1.includes("entity")) logger.warn("\u751F\u6210\u7684\u6587\u6863\u53EF\u80FD\u7F3A\u5C11ER\u56FE\u5185\u5BB9", {
                 title
             });
         }
@@ -7531,6 +7534,7 @@ ${generationTasks?.map((task, i)=>`
         }
     }
     const apiLimiter = new ConcurrencyLimiter(18);
+    const EXECUTION_TIMEOUT_MS = 40000;
     async function generateApiSection(sectionDef, templateVariables) {
         return apiLimiter.run(async ()=>{
             try {
@@ -7612,8 +7616,18 @@ ${pageStyle}
         return cleanHtml.trim();
     }
     const requirementAnalyzerTool = {
-        name: "requirement-analyzer-report",
-        description: `\u{667A}\u{80FD}\u{5206}\u{6790}\u{9700}\u{6C42}\u{5E76}\u{751F}\u{6210}API\u{6587}\u{6863}\u{548C}HTML\u{9875}\u{9762}\u{8BBE}\u{8BA1}\u{6587}\u{6863}\u{3002}\u{652F}\u{6301}PC\u{7AEF}\u{3001}\u{79FB}\u{52A8}\u{7AEF}\u{7B49}\u{591A}\u{79CD}\u{9875}\u{9762}\u{7C7B}\u{578B}\u{3002}`,
+        name: "generate_design_doc",
+        description: `\u{6839}\u{636E}\u{9700}\u{6C42}\u{5206}\u{6790}\u{7ED3}\u{679C}\u{FF0C}\u{751F}\u{6210} API \u{6280}\u{672F}\u{8BBE}\u{8BA1}\u{6587}\u{6863}\u{548C}\u{53EF}\u{4EA4}\u{4E92} HTML \u{9875}\u{9762}\u{539F}\u{578B}\u{3002}
+
+\u{89E6}\u{53D1}\u{8BCD}: \u{751F}\u{6210}\u{8BBE}\u{8BA1}\u{6587}\u{6863}\u{3001}\u{751F}\u{6210}API\u{6587}\u{6863}\u{3001}\u{9700}\u{6C42}\u{8F6C}\u{8BBE}\u{8BA1}\u{3001}\u{751F}\u{6210}\u{6280}\u{672F}\u{65B9}\u{6848}\u{3001}\u{751F}\u{6210}\u{9875}\u{9762}\u{539F}\u{578B}
+
+\u{4F7F}\u{7528}\u{6D41}\u{7A0B}:
+1. \u{5148}\u{8C03}\u{7528} requirement_identifier \u{5206}\u{6790}\u{539F}\u{59CB}\u{9700}\u{6C42}
+2. \u{5C06}\u{5206}\u{6790}\u{7ED3}\u{679C}\u{4F20}\u{5165}\u{672C}\u{5DE5}\u{5177}\u{751F}\u{6210}\u{8BBE}\u{8BA1}\u{6587}\u{6863}
+
+\u{8F93}\u{51FA}:
+- API \u{6280}\u{672F}\u{9700}\u{6C42}\u{6587}\u{6863} (Markdown)
+- \u{53EF}\u{4EA4}\u{4E92} HTML \u{9875}\u{9762}\u{539F}\u{578B}`,
         inputSchema: {
             requirement_analysis: stringType().describe("requirement-identifier\u751F\u6210\u7684\u9700\u6C42\u5206\u6790\u7ED3\u679C\uFF08\u5305\u542B\u5F53\u524D\u9700\u6C42\u4E0E\u9879\u76EE\u60C5\u51B5\u7684\u5B8C\u6574\u5206\u6790\uFF09"),
             current_project_path: stringType().describe("\u5F53\u524D\u9879\u76EE\u8DEF\u5F84\uFF08\u5FC5\u586B\uFF09\uFF0C\u9700\u6C42\u62A5\u544A\u5C06\u751F\u6210\u5230\u8BE5\u8DEF\u5F84\u4E0B\u7684.aico/design\u76EE\u5F55"),
@@ -7663,11 +7677,28 @@ ${pageStyle}
                     ],
                     isError: true
                 };
-                logger.info(`\u{5F00}\u{59CB}\u{5B8C}\u{5168}\u{5E76}\u{884C}\u{751F}\u{6210} ${generationTasks.length} \u{4EFD}\u{6587}\u{6863}...`);
+                logger.info(`\u{5F00}\u{59CB}\u{5B8C}\u{5168}\u{5E76}\u{884C}\u{751F}\u{6210} ${generationTasks.length} \u{4EFD}\u{6587}\u{6863}\u{FF08}\u{8D85}\u{65F6}: ${EXECUTION_TIMEOUT_MS}ms\u{FF09}...`);
                 const startTime = Date.now();
                 const apiTask = generationTasks.find((t)=>"API" === t.requirementType);
                 const htmlTask = generationTasks.find((t)=>"HTML" === t.requirementType);
-                const results = [];
+                const taskStatus = new Map();
+                if (apiTask) taskStatus.set("API", {
+                    type: "API",
+                    content: "",
+                    outputPath: apiTask.outputPath,
+                    success: false,
+                    completed: false
+                });
+                if (htmlTask) {
+                    const htmlOutputPath = htmlTask.outputPath.replace(/\.md$/, ".html");
+                    taskStatus.set("HTML", {
+                        type: "HTML",
+                        content: "",
+                        outputPath: htmlOutputPath,
+                        success: false,
+                        completed: false
+                    });
+                }
                 const parallelTasks = [];
                 if (apiTask) {
                     const apiPromise = (async ()=>{
@@ -7683,28 +7714,30 @@ ${pageStyle}
 ---
 
 `;
-                            const document = header + successSections.map((s)=>s.content).join("\n\n---\n\n");
+                            const document1 = header + successSections.map((s)=>s.content).join("\n\n---\n\n");
                             const outputDir = external_path_default().dirname(apiTask.outputPath);
                             await promises_namespaceObject.mkdir(outputDir, {
                                 recursive: true
                             });
-                            await promises_namespaceObject.writeFile(apiTask.outputPath, document, "utf-8");
-                            results.push({
+                            await promises_namespaceObject.writeFile(apiTask.outputPath, document1, "utf-8");
+                            taskStatus.set("API", {
                                 type: "API",
-                                content: document,
+                                content: document1,
                                 outputPath: apiTask.outputPath,
-                                success: true
+                                success: true,
+                                completed: true
                             });
                             logger.info(`API\u{6587}\u{6863}\u{751F}\u{6210}\u{5B8C}\u{6210}`, {
-                                length: document.length
+                                length: document1.length
                             });
                         } catch (error) {
-                            results.push({
+                            taskStatus.set("API", {
                                 type: "API",
                                 content: "",
                                 outputPath: apiTask.outputPath,
                                 success: false,
-                                error: error.message
+                                error: error.message,
+                                completed: true
                             });
                         }
                     })();
@@ -7721,44 +7754,128 @@ ${pageStyle}
                                 recursive: true
                             });
                             await promises_namespaceObject.writeFile(htmlOutputPath, htmlContent, "utf-8");
-                            results.push({
+                            taskStatus.set("HTML", {
                                 type: "HTML",
                                 content: htmlContent,
                                 outputPath: htmlOutputPath,
-                                success: true
+                                success: true,
+                                completed: true
                             });
                             logger.info(`HTML\u{9875}\u{9762}\u{751F}\u{6210}\u{5B8C}\u{6210}`, {
                                 length: htmlContent.length
                             });
                         } catch (error) {
-                            results.push({
+                            taskStatus.set("HTML", {
                                 type: "HTML",
                                 content: "",
-                                outputPath: htmlTask.outputPath,
+                                outputPath: htmlTask.outputPath.replace(/\.md$/, ".html"),
                                 success: false,
-                                error: error.message
+                                error: error.message,
+                                completed: true
                             });
                         }
                     })();
                     parallelTasks.push(htmlPromise);
                 }
-                await Promise.all(parallelTasks);
+                const timeoutPromise = new Promise((resolve)=>{
+                    setTimeout(()=>resolve("timeout"), EXECUTION_TIMEOUT_MS);
+                });
+                const raceResult = await Promise.race([
+                    Promise.all(parallelTasks).then(()=>"completed"),
+                    timeoutPromise
+                ]);
                 const totalDuration = Date.now() - startTime;
-                const successCount = results.filter((r)=>r.success).length;
-                const failedCount = results.filter((r)=>!r.success).length;
-                const generatedFiles = results.filter((r)=>r.success).map((r)=>r.outputPath);
-                logger.info(`\u{5E76}\u{884C}\u{751F}\u{6210}\u{5B8C}\u{6210}`, {
+                const isTimeout = "timeout" === raceResult;
+                const results = Array.from(taskStatus.values());
+                const completedResults = results.filter((r)=>r.completed);
+                const pendingResults = results.filter((r)=>!r.completed);
+                const successCount = completedResults.filter((r)=>r.success).length;
+                const failedCount = completedResults.filter((r)=>!r.success && r.completed).length;
+                const generatedFiles = completedResults.filter((r)=>r.success).map((r)=>r.outputPath);
+                logger.info(`\u{5E76}\u{884C}\u{751F}\u{6210}${isTimeout ? "\u8D85\u65F6" : "\u5B8C\u6210"}`, {
                     total: results.length,
+                    completed: completedResults.length,
+                    pending: pendingResults.length,
                     success: successCount,
                     failed: failedCount,
-                    totalDuration: `${totalDuration}ms`
+                    totalDuration: `${totalDuration}ms`,
+                    isTimeout
                 });
+                if (isTimeout && pendingResults.length > 0) {
+                    const pendingPrompts = pendingResults.map((task)=>{
+                        if ("API" === task.type && apiTask) return {
+                            type: "API",
+                            outputPath: task.outputPath,
+                            prompt: `\u{8BF7}\u{4E3A}"${apiTask.templateVariables.featureName}"\u{751F}\u{6210}API\u{6280}\u{672F}\u{9700}\u{6C42}\u{6587}\u{6863}\u{FF0C}\u{5305}\u{542B}\u{4EE5}\u{4E0B}\u{7AE0}\u{8282}\u{FF1A}
+1. \u{6587}\u{6863}\u{5934}\u{90E8}\u{FF08}\u{6807}\u{9898}\u{3001}\u{751F}\u{6210}\u{65F6}\u{95F4}\u{3001}\u{4E1A}\u{52A1}\u{9886}\u{57DF}\u{FF09}
+2. \u{9700}\u{6C42}\u{80CC}\u{666F}\u{FF08}\u{9700}\u{6C42}\u{80CC}\u{666F}\u{3001}\u{5173}\u{952E}\u{529F}\u{80FD}\u{3001}\u{6D89}\u{53CA}\u{89D2}\u{8272}\u{FF09}
+3. \u{529F}\u{80FD}\u{8BBE}\u{8BA1}\u{8BF4}\u{660E}\u{FF08}\u{6D41}\u{7A0B}\u{7F16}\u{53F7}\u{3001}\u{524D}\u{7F6E}\u{6761}\u{4EF6}\u{3001}\u{89D2}\u{8272}\u{7B49}\u{8868}\u{683C}\u{FF09}
+4. \u{6570}\u{636E}\u{5EFA}\u{6A21}\u{FF08}ER\u{903B}\u{8F91}\u{56FE}mermaid erDiagram + \u{6570}\u{636E}\u{8868}\u{5B9E}\u{4F53}\u{8BBE}\u{8BA1}\u{FF09}
+5. API\u{63A5}\u{53E3}\u{8BBE}\u{8BA1}\u{FF08}\u{63A5}\u{53E3}\u{5217}\u{8868}\u{3001}\u{8BF7}\u{6C42}\u{53C2}\u{6570}\u{3001}\u{54CD}\u{5E94}\u{53C2}\u{6570}\u{3001}\u{9519}\u{8BEF}\u{7801}\u{FF09}
+6. \u{4E1A}\u{52A1}\u{65F6}\u{5E8F}\u{56FE}\u{FF08}mermaid sequenceDiagram\u{FF09}
+7. \u{4E1A}\u{52A1}\u{72B6}\u{6001}\u{FF08}\u{72B6}\u{6001}\u{63CF}\u{8FF0}\u{8868}\u{683C}\u{FF09}
+8. \u{4F2A}\u{4EE3}\u{7801}\u{793A}\u{4F8B}\u{FF08}\u{6838}\u{5FC3}\u{4E1A}\u{52A1}\u{903B}\u{8F91}\u{FF09}
+
+\u{4E1A}\u{52A1}\u{9886}\u{57DF}: ${apiTask.templateVariables.businessDomain}
+\u{9700}\u{6C42}\u{8BE6}\u{60C5}: ${apiTask.templateVariables.inputContent?.substring(0, 500) || ''}
+
+\u{8BF7}\u{751F}\u{6210}\u{5B8C}\u{6574}\u{7684}Markdown\u{6587}\u{6863}\u{5E76}\u{4FDD}\u{5B58}\u{5230}: ${task.outputPath}`
+                        };
+                        if ("HTML" === task.type && htmlTask) return {
+                            type: "HTML",
+                            outputPath: task.outputPath,
+                            prompt: `\u{8BF7}\u{4E3A}"${htmlTask.templateVariables.featureName}"\u{751F}\u{6210}\u{53EF}\u{4EA4}\u{4E92}\u{7684}HTML\u{9875}\u{9762}\u{FF1A}
+
+\u{6280}\u{672F}\u{8981}\u{6C42}\u{FF1A}
+1. \u{5B8C}\u{6574}HTML\u{6587}\u{4EF6}\u{FF08}<!DOCTYPE html>\u{3001}<html>\u{3001}<head>\u{3001}<body>\u{FF09}
+2. \u{4F7F}\u{7528}TailwindCSS\u{FF08}CDN\u{5F15}\u{5165}\u{FF09}\u{8FDB}\u{884C}\u{6837}\u{5F0F}\u{8BBE}\u{8BA1}
+3. \u{9875}\u{9762}\u{7C7B}\u{578B}: ${htmlTask.templateVariables.pageType || 'responsive'}\u{5E03}\u{5C40}
+4. \u{5305}\u{542B}\u{8868}\u{5355}\u{9A8C}\u{8BC1}\u{548C}\u{4EA4}\u{4E92}\u{903B}\u{8F91}\u{FF08}\u{539F}\u{751F}JavaScript\u{FF09}
+5. \u{5305}\u{542B}\u{52A0}\u{8F7D}\u{72B6}\u{6001}\u{3001}\u{6210}\u{529F}/\u{5931}\u{8D25}\u{63D0}\u{793A}
+6. \u{6240}\u{6709}\u{6587}\u{672C}\u{4F7F}\u{7528}\u{4E2D}\u{6587}
+
+\u{9875}\u{9762}\u{98CE}\u{683C}\u{FF1A}
+${htmlTask.templateVariables.pageStyle || DEFAULT_PAGE_STYLE}
+
+\u{9700}\u{6C42}\u{8BE6}\u{60C5}: ${htmlTask.templateVariables.inputContent?.substring(0, 500) || ''}
+
+\u{8BF7}\u{751F}\u{6210}\u{5B8C}\u{6574}\u{7684}HTML\u{4EE3}\u{7801}\u{5E76}\u{4FDD}\u{5B58}\u{5230}: ${task.outputPath}`
+                        };
+                        return null;
+                    }).filter(Boolean);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    success: successCount > 0,
+                                    timeout: true,
+                                    message: `\u{6267}\u{884C}\u{8D85}\u{65F6}(${EXECUTION_TIMEOUT_MS}ms)\u{FF1A}${successCount} \u{5B8C}\u{6210}\u{FF0C}${pendingResults.length} \u{5F85}\u{6267}\u{884C}\u{FF0C}\u{8BF7}\u{7EE7}\u{7EED}\u{6267}\u{884C}\u{4EE5}\u{4E0B}\u{4EFB}\u{52A1}`,
+                                    data: {
+                                        outputPath: serviceResult.outputPath,
+                                        generatedFiles,
+                                        analysisInfo: serviceResult.analysisInfo || {},
+                                        completedResults: completedResults.map((r)=>({
+                                                type: r.type,
+                                                outputPath: r.outputPath,
+                                                success: r.success,
+                                                error: r.error,
+                                                contentLength: r.content?.length || 0
+                                            })),
+                                        pendingTasks: pendingPrompts
+                                    }
+                                })
+                            }
+                        ]
+                    };
+                }
                 return {
                     content: [
                         {
                             type: "text",
                             text: JSON.stringify({
                                 success: successCount > 0,
+                                timeout: false,
                                 message: `\u{6587}\u{6863}\u{751F}\u{6210}\u{5B8C}\u{6210}\u{FF1A}${successCount} \u{6210}\u{529F}\u{FF0C}${failedCount} \u{5931}\u{8D25}\u{FF0C}\u{603B}\u{8017}\u{65F6} ${totalDuration}ms`,
                                 data: {
                                     outputPath: serviceResult.outputPath,
@@ -10821,6 +10938,503 @@ ${requirement_description}
             }
         }
     };
+    const external_url_namespaceObject = require("url");
+    const external_docxtemplater_namespaceObject = require("docxtemplater");
+    var external_docxtemplater_default = /*#__PURE__*/ __webpack_require__.n(external_docxtemplater_namespaceObject);
+    const external_pizzip_namespaceObject = require("pizzip");
+    var external_pizzip_default = /*#__PURE__*/ __webpack_require__.n(external_pizzip_namespaceObject);
+    function getTemplatePath() {
+        let currentDir;
+        try {
+            currentDir = external_path_namespaceObject.dirname((0, external_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+        } catch  {
+            currentDir = __dirname;
+        }
+        return external_path_namespaceObject.resolve(currentDir, "\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u6A21\u677F.docx");
+    }
+    function prepareRenderData(data) {
+        const renderData = {
+            projectName: data.projectName,
+            moduleName: data.moduleName,
+            year: data.year,
+            month: data.month,
+            referDoc: data.referDoc,
+            serviceInterfaceList: data.serviceInterfaceList || [],
+            designDetailList: data.designDetailList || [],
+            tableInfoList: data.tableInfoList || [],
+            techSolution: data.techSolution || null,
+            businessExceptionList: data.businessExceptionList || [],
+            appendix: data.appendix || null
+        };
+        if (data.techSolution) {
+            const ts = data.techSolution;
+            renderData.trafficEstimation = ts.trafficEstimation || null;
+            renderData.messageQueueList = ts.messageQueueList || [];
+            renderData.databaseSplitList = ts.databaseSplitList || [];
+            renderData.distributedTransactionList = ts.distributedTransactionList || [];
+            renderData.distributedLockList = ts.distributedLockList || [];
+            renderData.scheduledTaskList = ts.scheduledTaskList || [];
+            renderData.delayTaskList = ts.delayTaskList || [];
+            renderData.cacheDesign = ts.cacheDesign || null;
+            if (ts.cacheDesign) {
+                renderData.cacheConstraint = ts.cacheDesign.constraint || "\u4E0D\u6D89\u53CA\u3002";
+                renderData.cacheScenarioList = ts.cacheDesign.cacheScenarioList || [];
+                renderData.cacheDesignDescription = ts.cacheDesign.designDescription || "\u4E0D\u6D89\u53CA\u3002";
+            }
+        }
+        renderData.exceptionCodeList = data.appendix?.exceptionCodeList || [];
+        renderData.codeValueList = data.appendix?.codeValueList || [];
+        return renderData;
+    }
+    async function renderTechSpecDoc(data, outputDir) {
+        try {
+            const templatePath = getTemplatePath();
+            try {
+                await promises_namespaceObject.access(templatePath);
+            } catch  {
+                return {
+                    success: false,
+                    outputPath: null,
+                    error: `\u{6A21}\u{677F}\u{6587}\u{4EF6}\u{4E0D}\u{5B58}\u{5728}: ${templatePath}`
+                };
+            }
+            const templateContent = await promises_namespaceObject.readFile(templatePath);
+            const zip = new (external_pizzip_default())(templateContent);
+            const doc = new (external_docxtemplater_default())(zip, {
+                paragraphLoop: true,
+                linebreaks: true,
+                delimiters: {
+                    start: '{',
+                    end: '}'
+                }
+            });
+            const renderData = prepareRenderData(data);
+            doc.render(renderData);
+            const output = doc.getZip().generate({
+                type: 'nodebuffer',
+                compression: 'DEFLATE'
+            });
+            await promises_namespaceObject.mkdir(outputDir, {
+                recursive: true
+            });
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            const outputFileName = `\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}_${data.projectName}_${data.moduleName}_${timestamp}.docx`;
+            const outputPath = external_path_namespaceObject.join(outputDir, outputFileName);
+            await promises_namespaceObject.writeFile(outputPath, output);
+            logger.info("\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u6210\u529F", {
+                outputPath
+            });
+            return {
+                success: true,
+                outputPath
+            };
+        } catch (error) {
+            logger.error("\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u5931\u8D25", {
+                error: error.message
+            });
+            if (error.properties && error.properties.errors) {
+                const errorMessages = error.properties.errors.map((e)=>e.properties?.explanation || e.message).join('; ');
+                return {
+                    success: false,
+                    outputPath: null,
+                    error: `\u{6A21}\u{677F}\u{6E32}\u{67D3}\u{9519}\u{8BEF}: ${errorMessages}`
+                };
+            }
+            return {
+                success: false,
+                outputPath: null,
+                error: error.message || "\u672A\u77E5\u9519\u8BEF"
+            };
+        }
+    }
+    const TableFieldDetailSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        fieldName: stringType().describe("\u5B57\u6BB5\u540D"),
+        fieldType: stringType().describe("\u5B57\u6BB5\u7C7B\u578B"),
+        fieldDescription: stringType().describe("\u5B57\u6BB5\u63CF\u8FF0"),
+        fieldLength: stringType().describe("\u5B57\u6BB5\u957F\u5EA6")
+    });
+    objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        tableName: stringType().describe("\u8868\u540D\u79F0"),
+        entityName: stringType().describe("\u5BF9\u5E94\u5B9E\u4F53\u540D\u79F0"),
+        tableDescription: stringType().describe("\u63CF\u8FF0"),
+        tableDetailList: arrayType(TableFieldDetailSchema).default([]).describe("\u8868\u5B57\u6BB5\u8BE6\u60C5\u5217\u8868")
+    });
+    const ParameterInfoSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        propertyType: stringType().describe("\u7C7B\u578B"),
+        propertyName: stringType().describe("\u5C5E\u6027\u540D"),
+        required: stringType().describe("\u662F\u5426\u5FC5\u586B"),
+        propertyDesc: stringType().describe("\u63CF\u8FF0")
+    });
+    const ReturnResultInfoSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        propertyType: stringType().describe("\u7C7B\u578B"),
+        propertyName: stringType().describe("\u5C5E\u6027\u540D"),
+        propertyDesc: stringType().describe("\u63CF\u8FF0")
+    });
+    const InterfaceDesignDetailSchema = objectType({
+        functionName: stringType().describe("\u529F\u80FD\u540D\u79F0"),
+        interfaceDesc: stringType().describe("\u63A5\u53E3\u63CF\u8FF0"),
+        className: stringType().describe("\u63A5\u53E3\u7C7B\u540D"),
+        methodName: stringType().describe("\u65B9\u6CD5\u540D"),
+        parameterList: arrayType(ParameterInfoSchema).default([]).describe("\u53C2\u6570\u5217\u8868"),
+        returnResultList: arrayType(ReturnResultInfoSchema).default([]).describe("\u8FD4\u56DE\u7ED3\u679C\u5217\u8868"),
+        implementLogic: stringType().describe("\u5B9E\u73B0\u903B\u8F91")
+    });
+    objectType({
+        serviceName: stringType().describe("\u670D\u52A1\u540D\u79F0"),
+        serviceDesc: stringType().describe("\u529F\u80FD\u63CF\u8FF0"),
+        interfaceDesignDetailList: arrayType(InterfaceDesignDetailSchema).default([]).describe("\u63A5\u53E3\u8BBE\u8BA1\u8BE6\u60C5\u5217\u8868")
+    });
+    const InterfaceDetailSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        functionDescription: stringType().describe("\u529F\u80FD\u63CF\u8FF0"),
+        serviceName: stringType().describe("\u670D\u52A1\u540D"),
+        methodName: stringType().describe("\u65B9\u6CD5\u540D")
+    });
+    objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        serviceType: stringType().describe("\u670D\u52A1\u7C7B\u578B"),
+        serviceEnglishName: stringType().describe("\u670D\u52A1\u82F1\u6587\u540D\u79F0"),
+        serviceChineseName: stringType().describe("\u670D\u52A1\u4E2D\u6587\u540D\u79F0"),
+        serviceDescription: stringType().describe("\u670D\u52A1\u63CF\u8FF0"),
+        interfaceDetailList: arrayType(InterfaceDetailSchema).default([]).describe("\u63A5\u53E3\u8BE6\u60C5\u5217\u8868")
+    });
+    const TrafficEstimationSchema = objectType({
+        description: stringType().describe("\u63CF\u8FF0"),
+        qps: stringType().describe("\u9884\u4F30QPS"),
+        peakQps: stringType().describe("\u5CF0\u503CQPS"),
+        dailyVolume: stringType().describe("\u65E5\u8BF7\u6C42\u91CF")
+    });
+    const MessageQueueDesignSchema = objectType({
+        topicName: stringType().describe("Topic\u540D\u79F0"),
+        description: stringType().describe("\u63CF\u8FF0"),
+        producer: stringType().describe("\u751F\u4EA7\u8005"),
+        consumer: stringType().describe("\u6D88\u8D39\u8005"),
+        messageType: stringType().describe("\u6D88\u606F\u7C7B\u578B")
+    });
+    const DatabaseSplitDesignSchema = objectType({
+        tableName: stringType().describe("\u8868\u540D"),
+        splitStrategy: stringType().describe("\u62C6\u5206\u7B56\u7565"),
+        splitKey: stringType().describe("\u62C6\u5206\u952E"),
+        description: stringType().describe("\u63CF\u8FF0")
+    });
+    const DistributedTransactionDesignSchema = objectType({
+        sceneName: stringType().describe("\u573A\u666F\u540D\u79F0"),
+        transactionType: stringType().describe("\u4E8B\u52A1\u7C7B\u578B(TCC/SAGA/2PC\u7B49)"),
+        participants: stringType().describe("\u53C2\u4E0E\u65B9"),
+        description: stringType().describe("\u63CF\u8FF0")
+    });
+    const DistributedLockDesignSchema = objectType({
+        lockName: stringType().describe("\u9501\u540D\u79F0"),
+        lockType: stringType().describe("\u9501\u7C7B\u578B"),
+        timeout: stringType().describe("\u8D85\u65F6\u65F6\u95F4"),
+        description: stringType().describe("\u63CF\u8FF0")
+    });
+    const ScheduledTaskDesignSchema = objectType({
+        taskName: stringType().describe("\u4EFB\u52A1\u540D\u79F0"),
+        cronExpression: stringType().describe("Cron\u8868\u8FBE\u5F0F"),
+        description: stringType().describe("\u63CF\u8FF0"),
+        executorClass: stringType().describe("\u6267\u884C\u7C7B")
+    });
+    const DelayTaskDesignSchema = objectType({
+        taskName: stringType().describe("\u4EFB\u52A1\u540D\u79F0"),
+        delayTime: stringType().describe("\u5EF6\u65F6\u65F6\u95F4"),
+        description: stringType().describe("\u63CF\u8FF0"),
+        triggerCondition: stringType().describe("\u89E6\u53D1\u6761\u4EF6")
+    });
+    const CacheScenarioSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        sceneName: stringType().describe("\u573A\u666F\u540D\u79F0"),
+        cacheKey: stringType().describe("\u7F13\u5B58Key"),
+        expireTime: stringType().describe("\u8FC7\u671F\u65F6\u95F4"),
+        description: stringType().describe("\u63CF\u8FF0")
+    });
+    const CacheDesignSchema = objectType({
+        constraint: stringType().describe("\u7EA6\u675F"),
+        cacheScenarioList: arrayType(CacheScenarioSchema).default([]).describe("\u4F7F\u7528\u573A\u666F\u5217\u8868"),
+        designDescription: stringType().describe("\u65B9\u6848\u8BBE\u8BA1\u63CF\u8FF0")
+    });
+    objectType({
+        trafficEstimation: TrafficEstimationSchema.nullable().optional().describe("6.1 \u6D41\u91CF\u4F30\u7B97\u5206\u6790"),
+        messageQueueList: arrayType(MessageQueueDesignSchema).default([]).describe("6.2 \u6D88\u606F\u961F\u5217"),
+        databaseSplitList: arrayType(DatabaseSplitDesignSchema).default([]).describe("6.3 \u6570\u636E\u5E93\u62C6\u5206\u8BBE\u8BA1"),
+        distributedTransactionList: arrayType(DistributedTransactionDesignSchema).default([]).describe("6.4 \u5206\u5E03\u5F0F\u4E8B\u52A1"),
+        distributedLockList: arrayType(DistributedLockDesignSchema).default([]).describe("6.5 \u5206\u5E03\u5F0F\u9501"),
+        scheduledTaskList: arrayType(ScheduledTaskDesignSchema).default([]).describe("6.6 \u5B9A\u65F6\u4EFB\u52A1"),
+        delayTaskList: arrayType(DelayTaskDesignSchema).default([]).describe("6.7 \u5EF6\u65F6\u4EFB\u52A1"),
+        cacheDesign: CacheDesignSchema.nullable().optional().describe("6.8 \u7F13\u5B58\u65B9\u6848")
+    });
+    objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        sceneName: stringType().describe("\u5F02\u5E38\u573A\u666F"),
+        exceptionType: stringType().describe("\u5F02\u5E38\u7C7B\u578B"),
+        handleStrategy: stringType().describe("\u5904\u7406\u7B56\u7565"),
+        description: stringType().describe("\u63CF\u8FF0")
+    });
+    const ExceptionCodeSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        exceptionCode: stringType().describe("\u5F02\u5E38\u7F16\u7801"),
+        exceptionDescription: stringType().describe("\u5F02\u5E38\u63CF\u8FF0")
+    });
+    const CodeValueSchema = objectType({
+        id: stringType().describe("\u5E8F\u53F7"),
+        propertyName: stringType().describe("\u5C5E\u6027"),
+        codeValue: stringType().describe("\u7801\u503C")
+    });
+    objectType({
+        exceptionCodeList: arrayType(ExceptionCodeSchema).default([]).describe("8.1 \u5F02\u5E38\u7801\u8868"),
+        codeValueList: arrayType(CodeValueSchema).default([]).describe("8.2 \u7801\u503C")
+    });
+    function normalizeInputData(input) {
+        const result = {
+            ...input
+        };
+        if (Array.isArray(input.tableInfoList)) result.tableInfoList = input.tableInfoList.map((table, tableIndex)=>{
+            const normalizedTable = {
+                id: table.id || String(tableIndex + 1),
+                tableName: table.tableName || '',
+                entityName: table.entityName || table.tableName || '',
+                tableDescription: table.tableDescription || table.tableComment || table.comment || '',
+                tableDetailList: []
+            };
+            const fieldList = table.tableDetailList || table.fieldList || [];
+            normalizedTable.tableDetailList = fieldList.map((field, fieldIndex)=>({
+                    id: field.id || String(fieldIndex + 1),
+                    fieldName: field.fieldName || '',
+                    fieldType: field.fieldType || '',
+                    fieldDescription: field.fieldDescription || field.fieldComment || field.comment || '',
+                    fieldLength: field.fieldLength || '-'
+                }));
+            return normalizedTable;
+        });
+        if (Array.isArray(input.serviceInterfaceList)) result.serviceInterfaceList = input.serviceInterfaceList.map((service, serviceIndex)=>{
+            if (void 0 !== service.serviceEnglishName) return service;
+            const normalizedService = {
+                id: service.id || String(serviceIndex + 1),
+                serviceType: service.serviceType || 'REST',
+                serviceEnglishName: service.interfaceName || service.serviceEnglishName || '',
+                serviceChineseName: service.serviceChineseName || service.interfaceComment || service.interfaceName || '',
+                serviceDescription: service.serviceDescription || service.interfaceComment || '',
+                interfaceDetailList: []
+            };
+            const methodList = service.interfaceDetailList || service.methodList || [];
+            normalizedService.interfaceDetailList = methodList.map((method, methodIndex)=>({
+                    id: method.id || String(methodIndex + 1),
+                    functionDescription: method.functionDescription || method.methodComment || method.comment || '',
+                    serviceName: method.serviceName || service.interfaceName || service.serviceEnglishName || '',
+                    methodName: method.methodName || ''
+                }));
+            return normalizedService;
+        });
+        if (Array.isArray(input.designDetailList)) result.designDetailList = input.designDetailList.map((design)=>{
+            if (void 0 !== design.serviceName && void 0 !== design.interfaceDesignDetailList) return design;
+            return {
+                serviceName: design.designName || design.serviceName || '',
+                serviceDesc: design.designDesc || design.serviceDesc || '',
+                interfaceDesignDetailList: design.interfaceDesignDetailList || []
+            };
+        });
+        if (Array.isArray(input.businessExceptionList)) result.businessExceptionList = input.businessExceptionList.map((exception, index)=>{
+            if (void 0 !== exception.sceneName) return exception;
+            return {
+                id: exception.id || String(index + 1),
+                sceneName: exception.exceptionCode || exception.sceneName || '',
+                exceptionType: exception.exceptionType || 'BusinessException',
+                handleStrategy: exception.exceptionSolution || exception.handleStrategy || '',
+                description: exception.exceptionDesc || exception.description || ''
+            };
+        });
+        if ('string' == typeof input.techSolution) result.techSolution = {
+            trafficEstimation: null,
+            messageQueueList: [],
+            databaseSplitList: [],
+            distributedTransactionList: [],
+            distributedLockList: [],
+            scheduledTaskList: [],
+            delayTaskList: [],
+            cacheDesign: {
+                constraint: input.techSolution,
+                cacheScenarioList: [],
+                designDescription: input.techSolution
+            }
+        };
+        return result;
+    }
+    const techSpecGeneratorTool = {
+        name: "generate_tech_spec",
+        description: `\u{6839}\u{636E}\u{4EE3}\u{7801}\u{5206}\u{6790}\u{7ED3}\u{679C}\u{751F}\u{6210}\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}(Word\u{6587}\u{6863})\u{3002}
+
+\u{89E6}\u{53D1}\u{8BCD}: \u{751F}\u{6210}\u{6280}\u{672F}\u{89C4}\u{683C}\u{3001}\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}\u{3001}\u{751F}\u{6210}\u{6280}\u{672F}\u{6587}\u{6863}\u{3001}\u{6280}\u{672F}spec\u{3001}\u{4EE3}\u{7801}\u{6587}\u{6863}\u{5316}\u{3001}\u{751F}\u{6210}\u{89C4}\u{683C}\u{4E66}\u{3001}\u{6280}\u{672F}\u{8BF4}\u{660E}\u{4E66}
+
+\u{9002}\u{7528}\u{573A}\u{666F}:
+- \u{9700}\u{8981}\u{4E3A}\u{9879}\u{76EE}/\u{6A21}\u{5757}\u{751F}\u{6210}\u{6B63}\u{5F0F}\u{7684}\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}
+- \u{9700}\u{8981}\u{5C06}\u{4EE3}\u{7801}\u{7ED3}\u{6784}\u{6587}\u{6863}\u{5316}\u{4E3A}Word\u{683C}\u{5F0F}
+- \u{9879}\u{76EE}\u{4EA4}\u{4ED8}\u{9700}\u{8981}\u{6280}\u{672F}\u{6587}\u{6863}
+
+\u{8F93}\u{5165}\u{8981}\u{6C42}: \u{9700}\u{8981}\u{5148}\u{5206}\u{6790}\u{4EE3}\u{7801}\u{76EE}\u{5F55}\u{FF0C}\u{6536}\u{96C6}\u{6570}\u{636E}\u{8868}\u{8BBE}\u{8BA1}\u{3001}\u{670D}\u{52A1}\u{63A5}\u{53E3}\u{3001}\u{529F}\u{80FD}\u{8BBE}\u{8BA1}\u{7B49}\u{4FE1}\u{606F}
+\u{8F93}\u{51FA}: Word\u{683C}\u{5F0F}\u{7684}\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}(.docx)\u{FF0C}\u{4FDD}\u{5B58}\u{5230} .aico/tech/ \u{76EE}\u{5F55}`,
+        inputSchema: {
+            projectPath: stringType().min(1).describe("\u5F53\u524D\u9879\u76EE\u8DEF\u5F84\uFF0C\u751F\u6210\u7684\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u4FDD\u5B58\u5230\u8BE5\u8DEF\u5F84\u4E0B\u7684.aico/tech\u76EE\u5F55"),
+            techSpecData: unionType([
+                stringType(),
+                objectType({
+                    projectName: stringType().describe("\u9879\u76EE\u540D\u79F0"),
+                    moduleName: stringType().describe("\u6A21\u5757\u540D\u79F0"),
+                    year: stringType().optional().describe("\u5E74\u4EFD\uFF0C\u9ED8\u8BA4\u5F53\u524D\u5E74\u4EFD"),
+                    month: stringType().optional().describe("\u6708\u4EFD\uFF0C\u9ED8\u8BA4\u5F53\u524D\u6708\u4EFD"),
+                    referDoc: stringType().optional().describe("\u53C2\u8003\u6587\u6863"),
+                    serviceInterfaceList: arrayType(anyType()).default([]).describe("\u670D\u52A1\u63A5\u53E3\u6E05\u5355"),
+                    designDetailList: arrayType(anyType()).default([]).describe("\u670D\u52A1\u63A5\u53E3\u8BBE\u8BA1\u8BE6\u60C5"),
+                    tableInfoList: arrayType(anyType()).default([]).describe("\u6570\u636E\u5E93\u8868\u4FE1\u606F\u5217\u8868"),
+                    techSolution: anyType().optional().describe("\u7B2C6\u7AE0-\u6280\u672F\u65B9\u6848"),
+                    businessExceptionList: arrayType(anyType()).default([]).describe("\u7B2C7\u7AE0-\u4E1A\u52A1\u5F02\u5E38\u5904\u7406\u5217\u8868"),
+                    appendix: anyType().optional().describe("\u7B2C8\u7AE0-\u9644\u5F55")
+                }).passthrough()
+            ]).describe("\u6280\u672F\u89C4\u683C\u6570\u636E(JSON\u5BF9\u8C61\u6216JSON\u5B57\u7B26\u4E32)\uFF0C\u5305\u542B: projectName(\u9879\u76EE\u540D), moduleName(\u6A21\u5757\u540D), tableInfoList(\u6570\u636E\u8868), serviceInterfaceList(\u670D\u52A1\u63A5\u53E3), designDetailList(\u8BBE\u8BA1\u8BE6\u60C5)")
+        },
+        handler: async (args)=>{
+            try {
+                const { projectPath } = args;
+                let { techSpecData } = args;
+                if (!projectPath) return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                message: "\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1AprojectPath",
+                                data: null
+                            })
+                        }
+                    ],
+                    isError: true
+                };
+                if (!techSpecData) return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                message: "\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1AtechSpecData",
+                                data: null
+                            })
+                        }
+                    ],
+                    isError: true
+                };
+                logger.info("\u63A5\u6536\u5230\u7684 techSpecData \u7C7B\u578B", {
+                    type: typeof techSpecData
+                });
+                logger.info("\u63A5\u6536\u5230\u7684 techSpecData \u5185\u5BB9", {
+                    data: JSON.stringify(techSpecData).substring(0, 500)
+                });
+                if ("string" == typeof techSpecData) try {
+                    techSpecData = JSON.parse(techSpecData);
+                    logger.info("techSpecData \u4ECE\u5B57\u7B26\u4E32\u89E3\u6790\u4E3A\u5BF9\u8C61");
+                } catch (parseError) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    success: false,
+                                    message: "techSpecData \u53C2\u6570\u683C\u5F0F\u9519\u8BEF\uFF0C\u5E94\u4E3A JSON \u5BF9\u8C61",
+                                    data: null
+                                })
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+                const now = new Date();
+                const normalizedData = normalizeInputData(techSpecData);
+                const data = {
+                    projectName: normalizedData.projectName || "\u672A\u547D\u540D\u9879\u76EE",
+                    moduleName: normalizedData.moduleName || "\u672A\u547D\u540D\u6A21\u5757",
+                    year: normalizedData.year || String(now.getFullYear()),
+                    month: normalizedData.month || String(now.getMonth() + 1).padStart(2, "0"),
+                    referDoc: normalizedData.referDoc || "\u65E0",
+                    serviceInterfaceList: normalizedData.serviceInterfaceList || [],
+                    designDetailList: normalizedData.designDetailList || [],
+                    tableInfoList: normalizedData.tableInfoList || [],
+                    techSolution: normalizedData.techSolution || void 0,
+                    businessExceptionList: normalizedData.businessExceptionList || [],
+                    appendix: normalizedData.appendix || void 0
+                };
+                const outputDir = external_path_namespaceObject.join(projectPath, ".aico", "tech");
+                logger.info("\u5F00\u59CB\u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66", {
+                    projectPath,
+                    outputDir,
+                    projectName: data.projectName,
+                    moduleName: data.moduleName,
+                    tableCount: data.tableInfoList.length,
+                    serviceCount: data.serviceInterfaceList.length,
+                    hasTechSolution: !!data.techSolution,
+                    businessExceptionCount: data.businessExceptionList?.length || 0,
+                    hasAppendix: !!data.appendix
+                });
+                const result = await renderTechSpecDoc(data, outputDir);
+                if (result.success) return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                message: "\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u6210\u529F",
+                                data: {
+                                    outputPath: result.outputPath,
+                                    projectName: data.projectName,
+                                    moduleName: data.moduleName,
+                                    statistics: {
+                                        tableCount: data.tableInfoList.length,
+                                        serviceCount: data.serviceInterfaceList.length,
+                                        designCount: data.designDetailList.length,
+                                        hasTechSolution: !!data.techSolution,
+                                        businessExceptionCount: data.businessExceptionList?.length || 0,
+                                        exceptionCodeCount: data.appendix?.exceptionCodeList?.length || 0,
+                                        codeValueCount: data.appendix?.codeValueList?.length || 0
+                                    }
+                                }
+                            })
+                        }
+                    ]
+                };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                message: result.error || "\u6587\u6863\u751F\u6210\u5931\u8D25",
+                                data: null
+                            })
+                        }
+                    ],
+                    isError: true
+                };
+            } catch (error) {
+                logger.error("\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u5F02\u5E38", {
+                    error: error.message
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                message: error.message || "\u751F\u6210\u8FC7\u7A0B\u4E2D\u53D1\u751F\u9519\u8BEF",
+                                data: null
+                            })
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        }
+    };
     function createMcpServer() {
         const server = new mcp_js_namespaceObject.McpServer({
             name: SERVICE_CONFIG.name,
@@ -10838,7 +11452,8 @@ ${requirement_description}
             exportExcelTool,
             requirementIdentifierTool,
             requirementAlignerTool,
-            taskExecutorTool
+            taskExecutorTool,
+            techSpecGeneratorTool
         ];
         tools.forEach((tool)=>{
             server.tool(tool.name, tool.description, tool.inputSchema, tool.handler);

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBpE,wBAAgB,eAAe,cAgC9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,wBAAgB,eAAe,cAiC9B"}

package/dist/services/requirement-analyzer/core/types.d.ts

@@ -65,6 +65,8 @@ export interface GenerationTask {
         businessDomain: string;
         generateSequenceDiagram: string;
         customPrompt?: string;
+        pageType?: "pc" | "mobile" | "responsive";
+        pageStyle?: string;
     };
     existingContent?: string;
 }

package/dist/services/requirement-analyzer/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/requirement-analyzer/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/requirement-analyzer/core/types.ts"],"names":[],"mappings":"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"}

package/dist/services/requirement-analyzer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/requirement-analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuKxB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;oBA+BZ,GAAG;;;;;;;;;;;;;CA4M1B,CAAC;AAGF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/requirement-analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0KxB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;oBAyCZ,GAAG;;;;;;;;;;;;;CAwU1B,CAAC;AAGF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/services/tech-spec-generator/doc-renderer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 文档渲染服务
+ * 使用 docxtemplater 将数据渲染到技术规格说明书模板
+ */
+import { TechSpecData, DocGenerationResult } from './types';
+/**
+ * 渲染技术规格说明书文档
+ * @param data 技术规格数据
+ * @param outputDir 输出目录
+ * @returns 生成结果
+ */
+export declare function renderTechSpecDoc(data: TechSpecData, outputDir: string): Promise<DocGenerationResult>;
+//# sourceMappingURL=doc-renderer.d.ts.map

package/dist/services/tech-spec-generator/doc-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-renderer.d.ts","sourceRoot":"","sources":["../../../src/services/tech-spec-generator/doc-renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAiD,MAAM,SAAS,CAAC;AA0E3G;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAiF9B"}

package/dist/services/tech-spec-generator/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 技术规格说明书生成工具
+ *
+ * 该工具用于根据代码目录生成技术规格说明书
+ * 工作流程：
+ * 1. MCP客户端读取代码目录，收集技术规格数据
+ * 2. 将收集的数据传递给该工具
+ * 3. 工具使用模板渲染生成技术规格说明书
+ */
+import { z } from "zod";
+/**
+ * 技术规格说明书生成工具
+ */
+export declare const techSpecGeneratorTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        projectPath: z.ZodString;
+        techSpecData: z.ZodUnion<[z.ZodString, z.ZodObject<{
+            projectName: z.ZodString;
+            moduleName: z.ZodString;
+            year: z.ZodOptional<z.ZodString>;
+            month: z.ZodOptional<z.ZodString>;
+            referDoc: z.ZodOptional<z.ZodString>;
+            serviceInterfaceList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            designDetailList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            tableInfoList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            techSolution: z.ZodOptional<z.ZodAny>;
+            businessExceptionList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            appendix: z.ZodOptional<z.ZodAny>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            projectName: z.ZodString;
+            moduleName: z.ZodString;
+            year: z.ZodOptional<z.ZodString>;
+            month: z.ZodOptional<z.ZodString>;
+            referDoc: z.ZodOptional<z.ZodString>;
+            serviceInterfaceList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            designDetailList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            tableInfoList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            techSolution: z.ZodOptional<z.ZodAny>;
+            businessExceptionList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            appendix: z.ZodOptional<z.ZodAny>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            projectName: z.ZodString;
+            moduleName: z.ZodString;
+            year: z.ZodOptional<z.ZodString>;
+            month: z.ZodOptional<z.ZodString>;
+            referDoc: z.ZodOptional<z.ZodString>;
+            serviceInterfaceList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            designDetailList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            tableInfoList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            techSolution: z.ZodOptional<z.ZodAny>;
+            businessExceptionList: z.ZodDefault<z.ZodArray<z.ZodAny, "many">>;
+            appendix: z.ZodOptional<z.ZodAny>;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    };
+    handler: (args: any) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/tech-spec-generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/tech-spec-generator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgZxB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0CV,GAAG;;;;;;;;;;;;;CAsK1B,CAAC;AAGF,cAAc,SAAS,CAAC"}

package/dist/services/tech-spec-generator/types.d.ts

@@ -0,0 +1,256 @@
+/**
+ * 技术规格说明书数据类型定义
+ * 基于 .aico/create-tect-docs/技术规格说明书模板.docx 中的占位符
+ */
+/**
+ * 表字段详情 - 用于 tableDetailList 循环
+ */
+export interface TableFieldDetail {
+    id: string;
+    fieldName: string;
+    fieldType: string;
+    fieldDescription: string;
+    fieldLength: string;
+}
+/**
+ * 数据表信息 - 用于 tableInfoList 循环
+ */
+export interface TableInfo {
+    id: string;
+    tableName: string;
+    entityName: string;
+    tableDescription: string;
+    tableDetailList: TableFieldDetail[];
+}
+/**
+ * 接口参数信息 - 用于 parameterList 循环
+ */
+export interface ParameterInfo {
+    id: string;
+    propertyType: string;
+    propertyName: string;
+    required: string;
+    propertyDesc: string;
+}
+/**
+ * 返回结果信息 - 用于 returnResultList 循环
+ */
+export interface ReturnResultInfo {
+    id: string;
+    propertyType: string;
+    propertyName: string;
+    propertyDesc: string;
+}
+/**
+ * 接口设计详情 - 用于 interfaceDesignDetailList 循环
+ */
+export interface InterfaceDesignDetail {
+    functionName: string;
+    interfaceDesc: string;
+    className: string;
+    methodName: string;
+    parameterList: ParameterInfo[];
+    returnResultList: ReturnResultInfo[];
+    implementLogic: string;
+}
+/**
+ * 设计详情 - 用于 designDetailList 循环
+ */
+export interface DesignDetail {
+    serviceName: string;
+    serviceDesc: string;
+    interfaceDesignDetailList: InterfaceDesignDetail[];
+}
+/**
+ * 接口详情 - 用于 interfaceDetailList 循环
+ */
+export interface InterfaceDetail {
+    id: string;
+    functionDescription: string;
+    serviceName: string;
+    methodName: string;
+}
+/**
+ * 服务接口信息 - 用于 serviceInterfaceList 循环
+ */
+export interface ServiceInterface {
+    id: string;
+    serviceType: string;
+    serviceEnglishName: string;
+    serviceChineseName: string;
+    serviceDescription: string;
+    interfaceDetailList: InterfaceDetail[];
+}
+/**
+ * 流量估算分析
+ */
+export interface TrafficEstimation {
+    description: string;
+    qps: string;
+    peakQps: string;
+    dailyVolume: string;
+}
+/**
+ * 消息队列设计
+ */
+export interface MessageQueueDesign {
+    topicName: string;
+    description: string;
+    producer: string;
+    consumer: string;
+    messageType: string;
+}
+/**
+ * 数据库拆分设计
+ */
+export interface DatabaseSplitDesign {
+    tableName: string;
+    splitStrategy: string;
+    splitKey: string;
+    description: string;
+}
+/**
+ * 分布式事务设计
+ */
+export interface DistributedTransactionDesign {
+    sceneName: string;
+    transactionType: string;
+    participants: string;
+    description: string;
+}
+/**
+ * 分布式锁设计
+ */
+export interface DistributedLockDesign {
+    lockName: string;
+    lockType: string;
+    timeout: string;
+    description: string;
+}
+/**
+ * 定时任务设计
+ */
+export interface ScheduledTaskDesign {
+    taskName: string;
+    cronExpression: string;
+    description: string;
+    executorClass: string;
+}
+/**
+ * 延时任务设计
+ */
+export interface DelayTaskDesign {
+    taskName: string;
+    delayTime: string;
+    description: string;
+    triggerCondition: string;
+}
+/**
+ * 缓存使用场景
+ */
+export interface CacheScenario {
+    id: string;
+    sceneName: string;
+    cacheKey: string;
+    expireTime: string;
+    description: string;
+}
+/**
+ * 缓存方案设计
+ */
+export interface CacheDesign {
+    constraint: string;
+    cacheScenarioList: CacheScenario[];
+    designDescription: string;
+}
+/**
+ * 技术方案 - 第6章
+ */
+export interface TechSolution {
+    trafficEstimation: TrafficEstimation | null;
+    messageQueueList: MessageQueueDesign[];
+    databaseSplitList: DatabaseSplitDesign[];
+    distributedTransactionList: DistributedTransactionDesign[];
+    distributedLockList: DistributedLockDesign[];
+    scheduledTaskList: ScheduledTaskDesign[];
+    delayTaskList: DelayTaskDesign[];
+    cacheDesign: CacheDesign | null;
+}
+/**
+ * 业务异常处理项
+ */
+export interface BusinessExceptionItem {
+    id: string;
+    sceneName: string;
+    exceptionType: string;
+    handleStrategy: string;
+    description: string;
+}
+/**
+ * 异常码信息 - 用于 exceptionCodeList 循环
+ */
+export interface ExceptionCode {
+    id: string;
+    exceptionCode: string;
+    exceptionDescription: string;
+}
+/**
+ * 码值信息 - 用于 codeValueList 循环
+ */
+export interface CodeValue {
+    id: string;
+    propertyName: string;
+    codeValue: string;
+}
+/**
+ * 附录 - 第8章
+ */
+export interface Appendix {
+    exceptionCodeList: ExceptionCode[];
+    codeValueList: CodeValue[];
+}
+/**
+ * 技术规格说明书完整数据结构
+ * 模板占位符对应关系:
+ * - {projectName} - 项目名称
+ * - {moduleName} - 模块名称
+ * - {year} - 年份
+ * - {month} - 月份
+ * - {referDoc} - 参考文档
+ * - {#serviceInterfaceList}...{/serviceInterfaceList} - 服务接口列表循环
+ * - {#designDetailList}...{/designDetailList} - 设计详情列表循环
+ * - {#tableInfoList}...{/tableInfoList} - 数据表信息列表循环
+ * - {#techSolution}...{/techSolution} - 技术方案相关
+ * - {#businessExceptionList}...{/businessExceptionList} - 业务异常处理列表
+ * - {#appendix}...{/appendix} - 附录相关
+ */
+export interface TechSpecData {
+    projectName: string;
+    moduleName: string;
+    year: string;
+    month: string;
+    referDoc: string;
+    serviceInterfaceList: ServiceInterface[];
+    designDetailList: DesignDetail[];
+    tableInfoList: TableInfo[];
+    techSolution?: TechSolution;
+    businessExceptionList?: BusinessExceptionItem[];
+    appendix?: Appendix;
+}
+/**
+ * 代码分析结果
+ */
+export interface CodeAnalysisResult {
+    success: boolean;
+    data: TechSpecData | null;
+    error?: string;
+}
+/**
+ * 文档生成结果
+ */
+export interface DocGenerationResult {
+    success: boolean;
+    outputPath: string | null;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/tech-spec-generator/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/tech-spec-generator/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intention-coding",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "软件工程化的需求分析，功能设计，代码编写，测试运行和发布部署",
   "type": "module",
   "packageManager": "pnpm@10.11.0",
@@ -34,11 +34,13 @@
     "@modelcontextprotocol/sdk": "^1.17.5",
     "aico-pack": "2.1.0",
     "axios": "^1.10.0",
+    "docxtemplater": "^3.67.6",
     "html-to-md": "^0.8.8",
     "jimp": "^1.6.0",
     "lru-cache": "^11.1.0",
     "mammoth": "^1.9.1",
     "pdf-parse": "^1.1.1",
+    "pizzip": "^3.2.0",
     "sharp": "^0.34.3",
     "uuid": "^11.1.0",
     "winston": "^3.17.0",
@@ -57,6 +59,7 @@
     "@types/lodash": "^4.17.16",
     "@types/node": "^24.0.0",
     "@types/pdf-parse": "^1.1.5",
+    "@types/pizzip": "^3.0.5",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",