intention-coding 0.6.1 → 0.6.3

package/dist/index.cjs

@@ -7616,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"),
@@ -10942,6 +10952,103 @@ ${requirement_description}
         }
         return external_path_namespaceObject.resolve(currentDir, "\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u6A21\u677F.docx");
     }
+    function isEmptySection(section) {
+        if (!section) return true;
+        if ('object' != typeof section) return true;
+        const keys = Object.keys(section);
+        if (0 === keys.length) return true;
+        return keys.every((key)=>{
+            const val = section[key];
+            return !val || '' === val || "\u65E0" === val || "\u4E0D\u6D89\u53CA" === val || "\u4E0D\u6D89\u53CA\u3002" === val;
+        });
+    }
+    function prepareSubSectionData(section, defaultValue = "\u4E0D\u6D89\u53CA\u3002") {
+        if (isEmptySection(section)) return {
+            constraint: defaultValue,
+            useCase: defaultValue,
+            design: defaultValue,
+            intro: defaultValue,
+            dataEstimation: defaultValue,
+            sharding: defaultValue,
+            designIdea: defaultValue,
+            implementation: defaultValue
+        };
+        const normalizeValue = (val)=>{
+            if (!val || '' === val || "\u65E0" === val) return defaultValue;
+            return String(val);
+        };
+        return {
+            constraint: normalizeValue(section.constraint),
+            useCase: normalizeValue(section.useCase),
+            design: normalizeValue(section.design),
+            intro: normalizeValue(section.intro),
+            dataEstimation: normalizeValue(section.dataEstimation),
+            sharding: normalizeValue(section.sharding),
+            designIdea: normalizeValue(section.designIdea),
+            implementation: normalizeValue(section.implementation)
+        };
+    }
+    function flattenSubSection(parentKey, sectionName, section) {
+        const result = {};
+        for (const [key, value] of Object.entries(section))result[`${parentKey}_${sectionName}_${key}`] = value;
+        return result;
+    }
+    function prepareRenderData(data) {
+        const defaultNotInvolved = "\u4E0D\u6D89\u53CA\u3002";
+        const techSolution = data.techSolution || {};
+        const flattenedData = {
+            techSolution_trafficEstimation: techSolution.trafficEstimation || defaultNotInvolved
+        };
+        const subSections = [
+            {
+                name: 'messageQueue',
+                data: prepareSubSectionData(techSolution.messageQueue, defaultNotInvolved)
+            },
+            {
+                name: 'databaseSplit',
+                data: prepareSubSectionData(techSolution.databaseSplit, defaultNotInvolved)
+            },
+            {
+                name: 'distributedTransaction',
+                data: prepareSubSectionData(techSolution.distributedTransaction, defaultNotInvolved)
+            },
+            {
+                name: 'distributedLock',
+                data: prepareSubSectionData(techSolution.distributedLock, defaultNotInvolved)
+            },
+            {
+                name: 'scheduledTask',
+                data: prepareSubSectionData(techSolution.scheduledTask, defaultNotInvolved)
+            },
+            {
+                name: 'delayTask',
+                data: prepareSubSectionData(techSolution.delayTask, defaultNotInvolved)
+            },
+            {
+                name: 'cacheDesign',
+                data: prepareSubSectionData(techSolution.cacheDesign, defaultNotInvolved)
+            }
+        ];
+        for (const { name, data: sectionData } of subSections)Object.assign(flattenedData, flattenSubSection('techSolution', name, sectionData));
+        flattenedData.businessException_content = data.businessException?.content || defaultNotInvolved;
+        flattenedData.appendix_exceptionCodeList = data.appendix?.exceptionCodeList || [];
+        flattenedData.appendix_codeValueList = data.appendix?.codeValueList || [];
+        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 || [],
+            ...flattenedData
+        };
+        logger.debug("\u6E32\u67D3\u6570\u636E", {
+            flattenedData
+        });
+        return renderData;
+    }
     async function renderTechSpecDoc(data, outputDir) {
         try {
             const templatePath = getTemplatePath();
@@ -10960,19 +11067,20 @@ ${requirement_description}
                 paragraphLoop: true,
                 linebreaks: true,
                 delimiters: {
-                    start: '{',
-                    end: '}'
+                    start: "{",
+                    end: "}"
                 }
             });
-            doc.render(data);
+            const renderData = prepareRenderData(data);
+            doc.render(renderData);
             const output = doc.getZip().generate({
-                type: 'nodebuffer',
-                compression: 'DEFLATE'
+                type: "nodebuffer",
+                compression: "DEFLATE"
             });
             await promises_namespaceObject.mkdir(outputDir, {
                 recursive: true
             });
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            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);
@@ -10988,7 +11096,7 @@ ${requirement_description}
                 error: error.message
             });
             if (error.properties && error.properties.errors) {
-                const errorMessages = error.properties.errors.map((e)=>e.properties?.explanation || e.message).join('; ');
+                const errorMessages = error.properties.errors.map((e)=>e.properties?.explanation || e.message).join("; ");
                 return {
                     success: false,
                     outputPath: null,
@@ -11002,6 +11110,11 @@ ${requirement_description}
             };
         }
     }
+    const PROJECT_PATH_DESCRIPTION = "\u9879\u76EE\u6839\u76EE\u5F55\u8DEF\u5F84\uFF0C\u751F\u6210\u7684\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u4FDD\u5B58\u5230\u9879\u76EE\u6839\u76EE\u5F55\u7684.aico/tech\u4E0B\uFF0C\u6CE8\u610F\u4E0D\u662F\u7528\u6237\u8F93\u5165\u7684\u6A21\u5757\u76EE\u5F55\uFF0C\u662F\u6574\u4E2A\u9879\u76EE\u7684\u6839\u76EE\u5F55";
+    const TECH_SPEC_OUTPUT_DIR = ".aico/tech";
+    function getTechSpecOutputDir(projectPath) {
+        return `${projectPath}/${TECH_SPEC_OUTPUT_DIR}`;
+    }
     const TableFieldDetailSchema = objectType({
         id: stringType().describe("\u5E8F\u53F7"),
         fieldName: stringType().describe("\u5B57\u6BB5\u540D"),
@@ -11057,20 +11170,454 @@ ${requirement_description}
         serviceDescription: stringType().describe("\u670D\u52A1\u63CF\u8FF0"),
         interfaceDetailList: arrayType(InterfaceDetailSchema).default([]).describe("\u63A5\u53E3\u8BE6\u60C5\u5217\u8868")
     });
-    const techSpecGeneratorTool = {
-        name: 'tech-spec-generator',
-        description: `\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}\u{751F}\u{6210}\u{5DE5}\u{5177} - \u{6839}\u{636E}\u{6536}\u{96C6}\u{7684}\u{4EE3}\u{7801}\u{4FE1}\u{606F}\u{751F}\u{6210}\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}\u{3002}
-
-\u{4F7F}\u{7528}\u{6D41}\u{7A0B}\u{FF1A}
-1. MCP\u{5BA2}\u{6237}\u{7AEF}\u{5148}\u{8BFB}\u{53D6}\u{76EE}\u{6807}\u{4EE3}\u{7801}\u{76EE}\u{5F55}\u{FF0C}\u{5206}\u{6790}\u{5E76}\u{6536}\u{96C6}\u{4EE5}\u{4E0B}\u{4FE1}\u{606F}\u{FF1A}
-   - \u{6570}\u{636E}\u{8868}\u{8BBE}\u{8BA1}\u{FF08}\u{8868}\u{540D}\u{3001}\u{5B57}\u{6BB5}\u{4FE1}\u{606F}\u{7B49}\u{FF09}
-   - \u{670D}\u{52A1}\u{63A5}\u{53E3}\u{8BBE}\u{8BA1}\u{FF08}\u{670D}\u{52A1}\u{540D}\u{3001}\u{63A5}\u{53E3}\u{65B9}\u{6CD5}\u{3001}\u{53C2}\u{6570}\u{3001}\u{8FD4}\u{56DE}\u{503C}\u{7B49}\u{FF09}
-   - \u{529F}\u{80FD}\u{8BBE}\u{8BA1}\u{8BE6}\u{60C5}\u{FF08}\u{529F}\u{80FD}\u{540D}\u{79F0}\u{3001}\u{63CF}\u{8FF0}\u{3001}\u{5B9E}\u{73B0}\u{903B}\u{8F91}\u{7B49}\u{FF09}
-2. \u{5C06}\u{6536}\u{96C6}\u{7684}\u{6570}\u{636E}\u{901A}\u{8FC7} techSpecData \u{53C2}\u{6570}\u{4F20}\u{9012}\u{7ED9}\u{8BE5}\u{5DE5}\u{5177}
-3. \u{5DE5}\u{5177}\u{4F7F}\u{7528} .aico/create-tect-docs/\u{6280}\u{672F}\u{89C4}\u{683C}\u{8BF4}\u{660E}\u{4E66}\u{6A21}\u{677F}.docx \u{6A21}\u{677F}\u{6E32}\u{67D3}\u{751F}\u{6210}\u{6587}\u{6863}
-4. \u{6587}\u{6863}\u{8F93}\u{51FA}\u{5230} projectPath/.aico/tect/ \u{76EE}\u{5F55}`,
+    objectType({
+        description: stringType().describe("\u63CF\u8FF0"),
+        qps: stringType().describe("\u9884\u4F30QPS"),
+        peakQps: stringType().describe("\u5CF0\u503CQPS"),
+        dailyVolume: stringType().describe("\u65E5\u8BF7\u6C42\u91CF")
+    });
+    const SubSectionContentSchema = objectType({
+        constraint: stringType().optional().describe("\u7EA6\u675F"),
+        useCase: stringType().optional().describe("\u4F7F\u7528\u573A\u666F"),
+        design: stringType().optional().describe("\u65B9\u6848\u8BBE\u8BA1"),
+        intro: stringType().optional().describe("\u7AE0\u8282\u7B80\u4ECB"),
+        dataEstimation: stringType().optional().describe("\u6570\u636E\u91CF\u4F30\u7B97"),
+        sharding: stringType().optional().describe("\u5206\u5E93\u5206\u8868\u8BBE\u8BA1"),
+        designIdea: stringType().optional().describe("\u8BBE\u8BA1\u601D\u8DEF"),
+        implementation: stringType().optional().describe("\u5177\u4F53\u5B9E\u73B0")
+    });
+    const TechSolutionSchema = objectType({
+        content: stringType().optional().describe("\u6280\u672F\u65B9\u6848\u5B8C\u6574\u5185\u5BB9\uFF08\u7B80\u5316\u6A21\u5F0F\uFF09"),
+        trafficEstimation: stringType().optional().describe("6.1 \u6D41\u91CF\u4F30\u7B97\u5206\u6790"),
+        messageQueue: SubSectionContentSchema.optional().describe("6.2 \u6D88\u606F\u961F\u5217"),
+        databaseSplit: SubSectionContentSchema.optional().describe("6.3 \u6570\u636E\u5E93\u62C6\u5206\u8BBE\u8BA1"),
+        distributedTransaction: SubSectionContentSchema.optional().describe("6.4 \u5206\u5E03\u5F0F\u4E8B\u52A1"),
+        distributedLock: SubSectionContentSchema.optional().describe("6.5 \u5206\u5E03\u5F0F\u9501"),
+        scheduledTask: SubSectionContentSchema.optional().describe("6.6 \u5B9A\u65F6\u4EFB\u52A1"),
+        delayTask: SubSectionContentSchema.optional().describe("6.7 \u5EF6\u65F6\u4EFB\u52A1"),
+        cacheDesign: SubSectionContentSchema.optional().describe("6.8 \u7F13\u5B58\u65B9\u6848")
+    });
+    const BusinessExceptionSchema = objectType({
+        content: stringType().describe("\u4E1A\u52A1\u5F02\u5E38\u5904\u7406\u5B8C\u6574\u5185\u5BB9")
+    });
+    const ExceptionCodeSchema = objectType({
+        id: stringType().optional().describe("\u5E8F\u53F7"),
+        exceptionCode: stringType().describe("\u5F02\u5E38\u7F16\u7801"),
+        exceptionDescription: stringType().describe("\u5F02\u5E38\u63CF\u8FF0")
+    });
+    const CodeValueSchema = objectType({
+        id: stringType().optional().describe("\u5E8F\u53F7"),
+        propertyName: stringType().describe("\u5C5E\u6027"),
+        codeValue: stringType().describe("\u7801\u503C")
+    });
+    const AppendixSchema = objectType({
+        content: stringType().optional().describe("\u9644\u5F55\u5B8C\u6574\u5185\u5BB9\uFF08\u7B80\u5316\u6A21\u5F0F\uFF09"),
+        exceptionCodeList: arrayType(ExceptionCodeSchema).optional().describe("\u5F02\u5E38\u7801\u8868\u5217\u8868"),
+        codeValueList: arrayType(CodeValueSchema).optional().describe("\u7801\u503C\u5217\u8868")
+    });
+    function extractDtoTypeName(typeStr) {
+        if (!typeStr) return null;
+        const genericMatch = typeStr.match(/(?:List|Set|Collection|TableDataInfo|PageInfo|Page|R|Result|Response|Optional)<([^<>]+)>/i);
+        if (genericMatch) return extractDtoTypeName(genericMatch[1]) || genericMatch[1];
+        return typeStr;
+    }
+    function isDtoTypeName(typeName) {
+        if (!typeName) return false;
+        return /(?:DTO|Request|Response|Vo|Bo|Dto|Query|Param|Result|Entity|Model|Info|Key|Form)$/i.test(typeName);
+    }
+    function expandDtoFields(fieldList, dtoDefinitions, mode) {
+        const expandedList = [];
+        let idCounter = 1;
+        for (const field of fieldList){
+            const fieldType = field.propertyType || field.type || "";
+            const fieldName = field.propertyName || field.name || "";
+            const fieldDesc = field.propertyDesc || field.description || "";
+            const fieldRequired = field.required || "\u5426";
+            const dtoTypeName = extractDtoTypeName(fieldType);
+            const isDtoType = dtoTypeName && isDtoTypeName(dtoTypeName);
+            let dtoFields = null;
+            if (isDtoType && dtoTypeName) {
+                const possibleNames = [
+                    dtoTypeName,
+                    dtoTypeName.replace(/Vo$|Bo$|Dto$/i, ""),
+                    dtoTypeName.replace(/Vo$/i, "Bo"),
+                    dtoTypeName.replace(/Bo$/i, "Vo")
+                ];
+                for (const name of possibleNames)if (dtoDefinitions[name]) {
+                    dtoFields = dtoDefinitions[name];
+                    break;
+                }
+            }
+            if (dtoFields && dtoFields.length > 0) for (const dtoField of dtoFields){
+                const dtoFieldName = dtoField.name || dtoField.propertyName || dtoField.fieldName || "";
+                const dtoFieldType = dtoField.type || dtoField.propertyType || dtoField.fieldType || "";
+                const dtoFieldDesc = dtoField.description || dtoField.propertyDesc || dtoField.fieldDescription || "";
+                if ("param" === mode) expandedList.push({
+                    id: String(idCounter++),
+                    propertyType: dtoFieldType,
+                    propertyName: `${fieldName}.${dtoFieldName}`,
+                    required: dtoField.required || "\u5426",
+                    propertyDesc: dtoFieldDesc
+                });
+                else expandedList.push({
+                    id: String(idCounter++),
+                    propertyType: dtoFieldType,
+                    propertyName: `${fieldName}.${dtoFieldName}`,
+                    propertyDesc: dtoFieldDesc
+                });
+            }
+            else if ("param" === mode) expandedList.push({
+                id: field.id || String(idCounter++),
+                propertyType: fieldType,
+                propertyName: fieldName,
+                required: fieldRequired,
+                propertyDesc: fieldDesc
+            });
+            else expandedList.push({
+                id: field.id || String(idCounter++),
+                propertyType: fieldType,
+                propertyName: fieldName,
+                propertyDesc: fieldDesc
+            });
+        }
+        return expandedList;
+    }
+    function generateDtoDefinitionsFromTables(tableInfoList) {
+        const definitions = {};
+        if (!Array.isArray(tableInfoList)) return definitions;
+        for (const table of tableInfoList){
+            const entityName = table.entityName || "";
+            if (!entityName) continue;
+            const fields = table.tableDetailList || table.fieldList || table.fields || [];
+            const dtoFields = fields.map((field)=>({
+                    name: field.fieldName || "",
+                    type: field.fieldType || "",
+                    description: field.fieldDescription || field.fieldDesc || "",
+                    required: "\u5426"
+                }));
+            const variations = [
+                entityName,
+                `${entityName}Vo`,
+                `${entityName}Bo`,
+                `${entityName}Dto`,
+                `${entityName}Query`,
+                `${entityName}Form`
+            ];
+            for (const name of variations)definitions[name] = dtoFields;
+        }
+        return definitions;
+    }
+    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.tableDesc || table.tableComment || table.comment || "",
+                tableDetailList: []
+            };
+            const fieldList = table.tableDetailList || table.fieldList || table.fields || [];
+            normalizedTable.tableDetailList = fieldList.map((field, fieldIndex)=>({
+                    id: field.id || String(fieldIndex + 1),
+                    fieldName: field.fieldName || "",
+                    fieldType: field.fieldType || "",
+                    fieldDescription: field.fieldDescription || field.fieldDesc || 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.interfaceDesc || service.interfaceComment || service.interfaceName || "",
+                serviceDescription: service.serviceDescription || service.interfaceDesc || service.interfaceComment || "",
+                interfaceDetailList: []
+            };
+            const methodList = service.interfaceDetailList || service.methodList || service.methods || [];
+            normalizedService.interfaceDetailList = methodList.map((method, methodIndex)=>({
+                    id: method.id || String(methodIndex + 1),
+                    functionDescription: method.functionDescription || method.methodDesc || method.methodComment || method.comment || "",
+                    serviceName: method.serviceName || service.interfaceName || service.serviceEnglishName || "",
+                    methodName: method.methodName || ""
+                }));
+            return normalizedService;
+        });
+        if (Array.isArray(input.designDetailList)) {
+            let dtoDefinitions = input.dtoDefinitions || {};
+            if (0 === Object.keys(dtoDefinitions).length && Array.isArray(input.tableInfoList)) dtoDefinitions = generateDtoDefinitionsFromTables(input.tableInfoList);
+            result.designDetailList = input.designDetailList.map((design)=>{
+                const normalizedDesign = {
+                    serviceName: design.serviceName || design.moduleName || design.designName || "",
+                    serviceDesc: design.serviceDesc || design.moduleDesc || design.designDesc || "",
+                    interfaceDesignDetailList: []
+                };
+                const interfaceList = design.interfaceDesignDetailList || [];
+                normalizedDesign.interfaceDesignDetailList = interfaceList.map((iface)=>{
+                    const expandedParamList = expandDtoFields(iface.parameterList || [], dtoDefinitions, "param");
+                    const expandedReturnList = expandDtoFields(iface.returnResultList || [], dtoDefinitions, "return");
+                    return {
+                        functionName: iface.functionName || "",
+                        interfaceDesc: iface.interfaceDesc || "",
+                        className: iface.className || "",
+                        methodName: iface.methodName || "",
+                        parameterList: expandedParamList,
+                        returnResultList: expandedReturnList,
+                        implementLogic: iface.implementLogic || ""
+                    };
+                });
+                return normalizedDesign;
+            });
+        }
+        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.sceneName || exception.exceptionCode || "",
+                exceptionType: exception.exceptionType || "BusinessException",
+                handleStrategy: exception.handleStrategy || exception.solution || exception.exceptionSolution || "",
+                description: exception.description || exception.exceptionDesc || ""
+            };
+        });
+        if (input.techSolution) if ("string" == typeof input.techSolution) result.techSolution = {
+            content: input.techSolution
+        };
+        else if (input.techSolution.content) result.techSolution = input.techSolution;
+        else result.techSolution = {
+            content: "\u6280\u672F\u65B9\u6848\u5185\u5BB9\u9700\u8981\u7531MCP\u5BA2\u6237\u7AEF\u751F\u6210"
+        };
+        if (input.businessException) if ("string" == typeof input.businessException) result.businessException = {
+            content: input.businessException
+        };
+        else result.businessException = input.businessException;
+        else if (input.businessExceptionList) result.businessException = {
+            content: "\u4E1A\u52A1\u5F02\u5E38\u5904\u7406\u5185\u5BB9\u9700\u8981\u7531MCP\u5BA2\u6237\u7AEF\u751F\u6210"
+        };
+        if (input.appendix) if ("string" == typeof input.appendix) result.appendix = {
+            content: input.appendix
+        };
+        else if (input.appendix.content) result.appendix = input.appendix;
+        else result.appendix = {
+            content: "\u9644\u5F55\u5185\u5BB9\u9700\u8981\u7531MCP\u5BA2\u6237\u7AEF\u751F\u6210"
+        };
+        return result;
+    }
+    const analyzeProjectContextTool = {
+        name: "analyze_project_context",
+        description: "\u5206\u6790\u9879\u76EE\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF0C\u4E3A\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u505A\u51C6\u5907",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>{
+            const { projectPath } = args;
+            if (!projectPath) return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            message: "\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1AprojectPath"
+                        })
+                    }
+                ],
+                isError: true
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u9879\u76EE\u4E0A\u4E0B\u6587\u5206\u6790\u6307\u5BFC",
+                            data: {
+                                analysisSteps: [
+                                    {
+                                        step: 1,
+                                        action: "\u8BFB\u53D6\u9879\u76EE\u6587\u6863",
+                                        files: [
+                                            `${projectPath}/README.md`,
+                                            `${projectPath}/package.json`
+                                        ]
+                                    },
+                                    {
+                                        step: 2,
+                                        action: "\u5206\u6790\u9879\u76EE\u7ED3\u6784",
+                                        directories: [
+                                            `${projectPath}/src`
+                                        ]
+                                    }
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            };
+        }
+    };
+    const collectServiceInterfacesTool = {
+        name: "collect_service_interfaces",
+        description: "\u6536\u96C6\u9879\u76EE\u4E2D\u7684\u670D\u52A1\u63A5\u53E3\u6E05\u5355",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u670D\u52A1\u63A5\u53E3\u6536\u96C6\u6307\u5BFC",
+                            data: {
+                                scanTargets: [
+                                    "**/*Controller.{ts,js}",
+                                    "**/*Service.{ts,js}"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const generateInterfaceDesignsTool = {
+        name: "generate_interface_designs",
+        description: "\u57FA\u4E8E\u670D\u52A1\u63A5\u53E3\u6E05\u5355\u751F\u6210\u8BE6\u7EC6\u7684\u63A5\u53E3\u8BBE\u8BA1",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION),
+            serviceInterfaceList: arrayType(ServiceInterfaceSchema).describe("\u670D\u52A1\u63A5\u53E3\u6E05\u5355")
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u63A5\u53E3\u8BBE\u8BA1\u8BE6\u60C5\u751F\u6210\u6307\u5BFC",
+                            data: {
+                                designPrinciples: [
+                                    "\u53C2\u6570\u7C7B\u578B\u5FC5\u987B\u5C55\u5F00\u5177\u4F53\u5B57\u6BB5\uFF0C\u7981\u6B62\u4F7F\u7528DTO\u7B49\u7B80\u5316\u540D\u79F0"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const collectDatabaseSchemaTool = {
+        name: "collect_database_schema",
+        description: "\u6536\u96C6\u9879\u76EE\u7684\u6570\u636E\u5E93\u8868\u7ED3\u6784\u4FE1\u606F",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u6570\u636E\u5E93\u7ED3\u6784\u6536\u96C6\u6307\u5BFC",
+                            data: {
+                                scanTargets: [
+                                    "**/migrations/**/*.sql",
+                                    "**/*Entity.{ts,js}"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const analyzeTechSolutionTool = {
+        name: "analyze_tech_solution",
+        description: "\u5206\u6790\u9879\u76EE\u7684\u6280\u672F\u65B9\u6848\uFF0C\u6839\u636E\u5B9E\u9645\u60C5\u51B5\u751F\u6210\u6280\u672F\u67B6\u6784\u8BBE\u8BA1",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u6280\u672F\u65B9\u6848\u5206\u6790\u6307\u5BFC",
+                            data: {
+                                analysisAreas: [
+                                    "\u6D41\u91CF\u4F30\u7B97\u5206\u6790",
+                                    "\u6280\u672F\u67B6\u6784\u8BBE\u8BA1",
+                                    "\u4E2D\u95F4\u4EF6\u9009\u578B"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const collectBusinessExceptionsTool = {
+        name: "collect_business_exceptions",
+        description: "\u6536\u96C6\u9879\u76EE\u4E2D\u7684\u4E1A\u52A1\u5F02\u5E38\u5904\u7406\u60C5\u51B5",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u4E1A\u52A1\u5F02\u5E38\u5904\u7406\u6536\u96C6\u6307\u5BFC",
+                            data: {
+                                scanTargets: [
+                                    "**/*Exception.{ts,js}",
+                                    "**/errors/**/*.{ts,js}"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const generateAppendixTool = {
+        name: "generate_appendix",
+        description: "\u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u7684\u9644\u5F55\u5185\u5BB9",
+        inputSchema: {
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION)
+        },
+        handler: async (args)=>({
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "\u9644\u5F55\u5185\u5BB9\u751F\u6210\u6307\u5BFC",
+                            data: {
+                                contentAreas: [
+                                    "\u9519\u8BEF\u7801\u8868",
+                                    "\u914D\u7F6E\u53C2\u6570\u8868",
+                                    "\u6570\u636E\u5B57\u5178",
+                                    "\u6280\u672F\u672F\u8BED\u8868"
+                                ],
+                                nextStep: "\u8C03\u7528 generate_final_document \u751F\u6210\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66"
+                            }
+                        })
+                    }
+                ]
+            })
+    };
+    const generateFinalDocumentTool = {
+        name: "generate_final_document",
+        description: "\u6574\u5408\u6240\u6709\u6536\u96C6\u7684\u4FE1\u606F\uFF0C\u751F\u6210\u5B8C\u6574\u7684\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66",
         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/tect\u76EE\u5F55"),
+            projectPath: stringType().min(1).describe(PROJECT_PATH_DESCRIPTION),
             techSpecData: objectType({
                 projectName: stringType().describe("\u9879\u76EE\u540D\u79F0"),
                 moduleName: stringType().describe("\u6A21\u5757\u540D\u79F0"),
@@ -11079,63 +11626,56 @@ ${requirement_description}
                 referDoc: stringType().optional().describe("\u53C2\u8003\u6587\u6863"),
                 serviceInterfaceList: arrayType(ServiceInterfaceSchema).default([]).describe("\u670D\u52A1\u63A5\u53E3\u6E05\u5355"),
                 designDetailList: arrayType(DesignDetailSchema).default([]).describe("\u670D\u52A1\u63A5\u53E3\u8BBE\u8BA1\u8BE6\u60C5"),
-                tableInfoList: arrayType(TableInfoSchema).default([]).describe("\u6570\u636E\u5E93\u8868\u4FE1\u606F\u5217\u8868")
-            }).describe("\u6280\u672F\u89C4\u683C\u6570\u636E\uFF0C\u7531MCP\u5BA2\u6237\u7AEF\u901A\u8FC7\u5206\u6790\u4EE3\u7801\u76EE\u5F55\u6536\u96C6")
+                tableInfoList: arrayType(TableInfoSchema).default([]).describe("\u6570\u636E\u5E93\u8868\u4FE1\u606F\u5217\u8868"),
+                techSolution: TechSolutionSchema.optional().describe("\u6280\u672F\u65B9\u6848"),
+                businessException: BusinessExceptionSchema.optional().describe("\u4E1A\u52A1\u5F02\u5E38\u5904\u7406"),
+                appendix: AppendixSchema.optional().describe("\u9644\u5F55"),
+                dtoDefinitions: recordType(stringType(), arrayType(objectType({
+                    name: stringType().optional().describe("\u5B57\u6BB5\u540D"),
+                    type: stringType().optional().describe("\u5B57\u6BB5\u7C7B\u578B"),
+                    required: stringType().optional().describe("\u662F\u5426\u5FC5\u586B"),
+                    description: stringType().optional().describe("\u5B57\u6BB5\u63CF\u8FF0")
+                }))).optional().describe("DTO\u5B9A\u4E49\u6620\u5C04\uFF0C\u7528\u4E8E\u5C55\u5F00\u63A5\u53E3\u53C2\u6570\u4E2D\u7684DTO\u4E3A\u5177\u4F53\u5B57\u6BB5")
+            }).describe("\u5B8C\u6574\u7684\u6280\u672F\u89C4\u683C\u6570\u636E")
         },
         handler: async (args)=>{
             try {
-                const { projectPath, techSpecData } = args;
-                if (!projectPath) return {
+                const { projectPath } = args;
+                let { techSpecData } = args;
+                if (!projectPath || !techSpecData) 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',
+                            type: "text",
                             text: JSON.stringify({
                                 success: false,
-                                message: "\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1AtechSpecData",
-                                data: null
+                                message: "\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570"
                             })
                         }
                     ],
                     isError: true
                 };
+                if ("string" == typeof techSpecData) techSpecData = JSON.parse(techSpecData);
                 const now = new Date();
+                const normalizedData = normalizeInputData(techSpecData);
                 const data = {
-                    projectName: techSpecData.projectName || "\u672A\u547D\u540D\u9879\u76EE",
-                    moduleName: techSpecData.moduleName || "\u672A\u547D\u540D\u6A21\u5757",
-                    year: techSpecData.year || String(now.getFullYear()),
-                    month: techSpecData.month || String(now.getMonth() + 1).padStart(2, '0'),
-                    referDoc: techSpecData.referDoc || "\u65E0",
-                    serviceInterfaceList: techSpecData.serviceInterfaceList || [],
-                    designDetailList: techSpecData.designDetailList || [],
-                    tableInfoList: techSpecData.tableInfoList || []
+                    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,
+                    businessException: normalizedData.businessException || void 0,
+                    appendix: normalizedData.appendix || void 0
                 };
-                const outputDir = external_path_namespaceObject.join(projectPath, '.aico', 'tect');
-                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
-                });
+                const outputDir = getTechSpecOutputDir(projectPath);
                 const result = await renderTechSpecDoc(data, outputDir);
                 if (result.success) return {
                     content: [
                         {
-                            type: 'text',
+                            type: "text",
                             text: JSON.stringify({
                                 success: true,
                                 message: "\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u6210\u529F",
@@ -11146,7 +11686,10 @@ ${requirement_description}
                                     statistics: {
                                         tableCount: data.tableInfoList.length,
                                         serviceCount: data.serviceInterfaceList.length,
-                                        designCount: data.designDetailList.length
+                                        designCount: data.designDetailList.length,
+                                        hasTechSolution: !!data.techSolution,
+                                        hasBusinessException: !!data.businessException,
+                                        hasAppendix: !!data.appendix
                                     }
                                 }
                             })
@@ -11156,28 +11699,23 @@ ${requirement_description}
                 return {
                     content: [
                         {
-                            type: 'text',
+                            type: "text",
                             text: JSON.stringify({
                                 success: false,
-                                message: result.error || "\u6587\u6863\u751F\u6210\u5931\u8D25",
-                                data: null
+                                message: result.error || "\u6587\u6863\u751F\u6210\u5931\u8D25"
                             })
                         }
                     ],
                     isError: true
                 };
             } catch (error) {
-                logger.error("\u6280\u672F\u89C4\u683C\u8BF4\u660E\u4E66\u751F\u6210\u5F02\u5E38", {
-                    error: error.message
-                });
                 return {
                     content: [
                         {
-                            type: 'text',
+                            type: "text",
                             text: JSON.stringify({
                                 success: false,
-                                message: error.message || "\u751F\u6210\u8FC7\u7A0B\u4E2D\u53D1\u751F\u9519\u8BEF",
-                                data: null
+                                message: error.message || "\u751F\u6210\u8FC7\u7A0B\u4E2D\u53D1\u751F\u9519\u8BEF"
                             })
                         }
                     ],
@@ -11186,6 +11724,16 @@ ${requirement_description}
             }
         }
     };
+    const techSpecGeneratorTools = [
+        analyzeProjectContextTool,
+        collectServiceInterfacesTool,
+        generateInterfaceDesignsTool,
+        collectDatabaseSchemaTool,
+        analyzeTechSolutionTool,
+        collectBusinessExceptionsTool,
+        generateAppendixTool,
+        generateFinalDocumentTool
+    ];
     function createMcpServer() {
         const server = new mcp_js_namespaceObject.McpServer({
             name: SERVICE_CONFIG.name,
@@ -11204,7 +11752,7 @@ ${requirement_description}
             requirementIdentifierTool,
             requirementAlignerTool,
             taskExecutorTool,
-            techSpecGeneratorTool
+            ...techSpecGeneratorTools
         ];
         tools.forEach((tool)=>{
             server.tool(tool.name, tool.description, tool.inputSchema, tool.handler);