@blocklet/pages-kit-agents 0.5.15 → 0.5.17

package/lib/cjs/utils/agent-utils.js

@@ -5,10 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getModel = getModel;
 const claude_chat_model_js_1 = require("@aigne/core/models/claude-chat-model.js");
+const deepseek_chat_model_js_1 = require("@aigne/core/models/deepseek-chat-model.js");
 const gemini_chat_model_js_1 = require("@aigne/core/models/gemini-chat-model.js");
 const openai_chat_model_js_1 = require("@aigne/core/models/openai-chat-model.js");
+const xai_chat_model_js_1 = require("@aigne/core/models/xai-chat-model.js");
 const node_assert_1 = __importDefault(require("node:assert"));
-const { OPENAI_API_KEY, GEMINI_API_KEY, CLAUDE_API_KEY } = process.env;
+const { OPENAI_API_KEY, GEMINI_API_KEY, CLAUDE_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY } = process.env;
 function getModel(modelName = 'openai') {
     if (modelName?.includes('gpt')) {
         (0, node_assert_1.default)(OPENAI_API_KEY, 'Please set the OPENAI_API_KEY environment variable');
@@ -40,5 +42,21 @@ function getModel(modelName = 'openai') {
         });
         return model;
     }
+    if (modelName?.includes('grok')) {
+        (0, node_assert_1.default)(XAI_API_KEY, 'Please set the XAI_API_KEY environment variable');
+        const grok = new xai_chat_model_js_1.XAIChatModel({
+            apiKey: XAI_API_KEY,
+            model: modelName,
+        });
+        return grok;
+    }
+    if (modelName?.includes('deepseek')) {
+        (0, node_assert_1.default)(DEEPSEEK_API_KEY, 'Please set the DEEPSEEK_API_KEY environment variable');
+        const deepseek = new deepseek_chat_model_js_1.DeepSeekChatModel({
+            apiKey: DEEPSEEK_API_KEY,
+            model: modelName,
+        });
+        return deepseek;
+    }
     return undefined;
 }

package/lib/cjs/utils/file-utils.js

@@ -37,6 +37,7 @@ const path_1 = __importDefault(require("path"));
 async function updateFileList() {
     const outputDir = path_1.default.join(process.cwd(), 'sample-output');
     const indexPath = path_1.default.join(outputDir, 'index.html');
+    const dataJsPath = path_1.default.join(outputDir, 'file-list-data.js');
     // 存储所有子文件夹及其HTML文件信息
     const fileList = [];
     try {
@@ -59,28 +60,71 @@ async function updateFileList() {
                 .filter((file) => file.isFile() && file.name.endsWith('.html'))
                 .map((file) => {
                 const fileName = file.name.replace(/\.html$/, '');
+                const jsonFileName = `${fileName}.json`;
+                const jsonFilePath = path_1.default.join(folderPath, jsonFileName);
+                const htmlFilePath = `${folderName}/${file.name}`;
+                const jsonFileRelativePath = `${folderName}/${jsonFileName}`;
                 return {
                     name: fileName,
-                    path: `${folderName}/${file.name}`,
+                    path: htmlFilePath,
+                    jsonPath: (0, fs_1.existsSync)(jsonFilePath) ? jsonFileRelativePath : undefined,
                     createdAt: new Date().toISOString(),
                 };
             });
+            // 读取每个HTML文件对应的JSON文件（如果存在）
+            for (const htmlFile of htmlFiles) {
+                if (htmlFile.jsonPath) {
+                    try {
+                        // eslint-disable-next-line no-await-in-loop
+                        const jsonContent = await fs.readFile(path_1.default.join(outputDir, htmlFile.jsonPath), 'utf8');
+                        const jsonData = JSON.parse(jsonContent);
+                        // 提取评分数据
+                        if (jsonData && jsonData.result) {
+                            htmlFile.scoreData = {
+                                total_score: jsonData.result.total_score,
+                                level: jsonData.result.level,
+                                suggestions: jsonData.result.suggestions,
+                                dimension_scores: jsonData.result.dimension_scores,
+                            };
+                        }
+                    }
+                    catch (jsonError) {
+                        console.error(`Error reading JSON file ${htmlFile.jsonPath}:`, jsonError);
+                    }
+                }
+            }
             // 将文件夹信息添加到列表
             fileList.push({
                 folder: folderName,
                 files: htmlFiles,
             });
         }
-        // 更新index.html，内联JSON数据
+        // 创建独立的JS文件
+        const jsonString = JSON.stringify(fileList, null, 2);
+        const jsContent = `/* eslint-disable prettier/prettier */
+/* eslint-disable @typescript-eslint/quotes */
+// 自动生成的文件列表数据 - 请勿手动修改
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const FILE_LIST_DATA = ${jsonString};
+`;
+        await fs.writeFile(dataJsPath, jsContent, 'utf8');
+        // 确保index.html引用了这个JS文件
         if ((0, fs_1.existsSync)(indexPath)) {
             let indexHtml = await fs.readFile(indexPath, 'utf8');
-            // 使用更简洁的替换方式
-            const fileListPlaceholder = /const FILE_LIST_DATA = .*?;/s;
-            if (fileListPlaceholder.test(indexHtml)) {
-                // 替换占位符为实际数据
-                const jsonString = JSON.stringify(fileList, null, 2);
-                indexHtml = indexHtml.replace(fileListPlaceholder, `const FILE_LIST_DATA = ${jsonString};`);
-                await fs.writeFile(indexPath, indexHtml, 'utf8');
+            // 检查index.html是否已经包含了对file-list-data.js的引用
+            const scriptIncludeRegex = /<script src=["']file-list-data\.js["']><\/script>/;
+            if (!scriptIncludeRegex.test(indexHtml)) {
+                // 如果没有引用，则替换原来的内联数据定义为引用外部JS文件
+                const fileListPlaceholder = /const FILE_LIST_DATA = .*?;/s;
+                if (fileListPlaceholder.test(indexHtml)) {
+                    // 替换内联数据为引用外部JS文件
+                    indexHtml = indexHtml.replace(fileListPlaceholder, `// 文件列表数据已移至外部JS文件
+// 以下行将在第一次更新时被删除
+const FILE_LIST_DATA = [];`);
+                    // 在</head>前添加script标签引用外部JS文件
+                    indexHtml = indexHtml.replace('</head>', '  <script src="file-list-data.js"></script>\n  </head>');
+                    await fs.writeFile(indexPath, indexHtml, 'utf8');
+                }
             }
         }
     }

package/lib/cjs/utils/template-utils.d.ts

@@ -26,3 +26,16 @@ export declare function saveHtmlContent({ htmlContent, outputFolder, outputFileN
     outputFolder: string;
     outputFileName: string;
 }): Promise<string>;
+/**
+ * 保存JSON内容到指定目录
+ * @param jsonContent 要保存的JSON数据
+ * @param outputFolder 输出文件夹路径
+ * @param outputFileName 输出JSON文件名称，不包含扩展名
+ * @returns 生成的JSON文件的完整路径
+ * @throws 如果无法创建输出目录或写入文件则抛出异常
+ */
+export declare function saveJsonContent({ jsonContent, outputFolder, outputFileName, }: {
+    jsonContent: Record<string, any> | string;
+    outputFolder: string;
+    outputFileName: string;
+}): Promise<string>;

package/lib/cjs/utils/template-utils.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateHtmlFromTemplate = generateHtmlFromTemplate;
 exports.saveHtmlContent = saveHtmlContent;
+exports.saveJsonContent = saveJsonContent;
 const node_fs_1 = __importDefault(require("node:fs"));
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
@@ -72,3 +73,32 @@ async function saveHtmlContent({ htmlContent, outputFolder, outputFileName, }) {
         throw new Error(`Failed to save HTML content: ${err.message}`);
     }
 }
+/**
+ * 保存JSON内容到指定目录
+ * @param jsonContent 要保存的JSON数据
+ * @param outputFolder 输出文件夹路径
+ * @param outputFileName 输出JSON文件名称，不包含扩展名
+ * @returns 生成的JSON文件的完整路径
+ * @throws 如果无法创建输出目录或写入文件则抛出异常
+ */
+async function saveJsonContent({ jsonContent, outputFolder, outputFileName, }) {
+    try {
+        // 创建输出目录
+        const outputDir = node_path_1.default.resolve(process.cwd(), 'sample-output', outputFolder);
+        // 确保输出目录存在
+        if (!node_fs_1.default.existsSync(outputDir)) {
+            node_fs_1.default.mkdirSync(outputDir, { recursive: true });
+        }
+        // 构建输出文件的完整路径
+        const outputFilePath = node_path_1.default.join(outputDir, `${outputFileName}.json`);
+        // 如果传入的是对象，转换为JSON字符串
+        const content = typeof jsonContent === 'string' ? jsonContent : JSON.stringify(jsonContent, null, 2);
+        // 写入JSON内容
+        node_fs_1.default.writeFileSync(outputFilePath, content, 'utf-8');
+        return outputFilePath;
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to save JSON content: ${err.message}`);
+    }
+}

package/lib/esm/agents/content-reviwer.d.ts

@@ -0,0 +1,19 @@
+import { AIAgent } from '@aigne/core';
+export declare const contentReviewerAgent: AIAgent<{
+    question: string;
+    locale: string;
+    dataSource: string;
+    content: string;
+}, {
+    result: {
+        total_score: number;
+        level: string;
+        suggestions: string[];
+        dimension_scores: {
+            name: string;
+            score: number;
+            maxScore: number;
+            comment: string;
+        }[];
+    };
+}>;

package/lib/esm/agents/content-reviwer.js

@@ -0,0 +1,151 @@
+import { AIAgent } from '@aigne/core';
+import { z } from 'zod';
+const prompt = `
+你是一个专业的网页文案评估专家，具备丰富的多行业文案分析经验。现在你将对一段网站文案进行全面评估，这些文案以结构化 JSON 格式提供，每一个字段对应网页中的一部分内容，主要字段包括：
+
+- title: 页面主标题
+- description: 页面描述
+- sectionsData: 页面内容部分，由多个模块（如 heroSection、featuresSection、faqSection 等）组成，每个模块有自己的标题、描述、详细内容等字段
+
+目标是：帮助创作者发现文案中的逻辑、表达、结构或营销短板，从而优化出更具影响力和传播力的内容。
+
+** 不要轻易给出高分**，除非你真的觉得提供的文案十分优秀。
+
+你可以参考提供原始数据来了解产品信息，帮助你判断文案中的信息是否准确、完整。
+
+---
+
+### 打分区间说明（满分 100 分）
+
+- **95-100 卓越级**：极具说服力与感染力，逻辑、节奏、表现力、SEO 全维度优秀，能直接用于投放或上线。
+- **90-94 优秀级**：表达清晰有力，有一定记忆点，结构严谨，整体完成度高，稍作优化即可达到专业发布水平。
+- **85-89 合格上乘**：表达准确、结构清楚，但较中规中矩，缺乏差异化或语言张力，建议提升亮点与传播力。
+- **80-84 可用但平庸**：内容基本清晰，但语言或结构平淡，缺乏吸引力或说服力，有明显可优化之处。
+- **70-79 结构与逻辑需优化**：存在信息遗漏、表达冗长或语言生硬等问题，可能影响理解或转化。
+- **<70 不达标**：表达混乱、价值不清、逻辑缺失，建议重写或从受众视角重新构思。
+
+---
+
+### 评估维度（共 7 项）
+
+** 每个维度的分数不能超过最大分数 **
+
+1. **信息完整性（15分）**  
+   - 是否明确传达核心价值或主张？
+   - 是否覆盖了“是什么、能做什么、为什么值得关注”？
+
+2. **结构与逻辑清晰度（15分）**  
+   - sectionsData 中的数据表示页面中的 Section ，页面结构是否完整清晰？
+   - 结构是否符合读者的阅读预期（如金字塔结构、FAB 模式等）？
+
+3. **语言表达质量（15分）**  
+   - 表达是否简练、自然、口语/书面语风格合适？
+   - 是否避免术语堆砌、空话套话？
+
+4. **吸引力与情绪感染力（15分）**  
+   - 是否有记忆点或引发兴趣？
+   - 是否有利益点、情绪驱动或视觉画面感？
+
+5. **品牌调性与目标受众匹配度（15分）**  
+   - 是否符合品牌语气？
+   - 是否贴合目标受众的心理与语境？
+
+6. **差异化与独特性（10分）**  
+   - 是否展现出区别于竞品的亮点或立场？
+   - 是否传递出“为什么选我”？
+
+7. **SEO 友好度（15分）**  
+   - 是否包含明确关键词？
+   - 是否具备良好的标题、副标题与语义层级？
+   - 是否利于搜索引擎抓取和用户点击？
+
+---
+
+### 输出格式要求：
+
+1. 每个维度请给出【分数（x/总分）】+ 简洁点评；
+2. 总结总体得分（满分 100）；
+3. 提供 3-5 条具体、可操作的优化建议，不能泛泛而谈；
+4. 如内容已接近满分，也需说明“进一步打磨”的方向。
+
+### 📦 输出格式要求（结构化）
+
+请使用以下结构输出评分结果：
+** 下面的 json 只是示例，只参考输出格式，不能影响评估结果**
+只返回 json 不要包含其他描述信息。
+
+\`\`\`json
+{
+  "total_score": xx,
+  "level": "xx",
+  "dimension_scores": [
+    {
+      "name": "信息完整性",
+      "score": xx,
+      "maxScore": xx,
+      "comment": "xxxxxx"
+    },
+    {
+      "name": "结构与逻辑清晰度",
+      "score": xx,
+      "maxScore": xx,
+      "comment": "xx"
+    },
+    {
+      "name": "语言表达质量",
+      "score": xx,
+      "maxScore": xx,
+      "comment": "xx"
+    },
+    ...
+  ],
+  "suggestions": [
+    "xxxx",
+    "xxxxxxx",
+    "xxxxxx。",
+    "xxxxxxxxxxx。"
+  ]
+}
+\`\`\`
+---
+
+### 📌 适用场景举例：
+
+- SEO 内容型页面（如博客、产品 landing page、产品介绍页）
+
+### 原始数据
+{{dataSource}}
+
+
+### 输入的营销文案
+{{ content }}
+
+### 其他要求
+{{ question }}
+
+### 语言
+请使用{{ locale }}语言输出
+  `;
+export const contentReviewerAgent = AIAgent.from({
+    name: 'Content Reviewer',
+    instructions: prompt,
+    inputSchema: z.object({
+        dataSource: z.string(),
+        content: z.string(),
+        question: z.string(),
+        locale: z.string(),
+    }),
+    outputSchema: z.object({
+        result: z.object({
+            total_score: z.number(),
+            level: z.string(),
+            dimension_scores: z.array(z.object({
+                name: z.string(),
+                score: z.number(),
+                maxScore: z.number(),
+                comment: z.string(),
+            })),
+            suggestions: z.array(z.string()),
+        }),
+    }),
+});

package/lib/esm/agents/multi-agent-page-writer.js

@@ -20,7 +20,7 @@ import { createSectionContentAgent } from './section-content-generator.js';
 export default async function generatePageContentMultiAgent(input) {
     const { context = '', question = '', locale = '', outputSchema, onProgress, checkConnection, sectionsRules, modelName = 'gpt-4o-mini', } = input;
     try {
-        logger.info('Starting multi-agent page content generation');
+        logger.info(`[${modelName}] Starting multi-agent page content generation`);
         // 检查客户端连接状态的辅助函数
         const isClientConnected = () => {
             // 如果没有提供检查函数，默认认为客户端仍连接
@@ -41,10 +41,10 @@ export default async function generatePageContentMultiAgent(input) {
             });
         }
         // 2. 初始页面结构规划
-        logger.info('Planning initial page structure');
+        logger.info(`[${modelName}] Planning initial page structure`);
         // 检查客户端是否仍然连接
         if (!isClientConnected()) {
-            logger.warn('Client disconnected during structure planning, aborting generation');
+            logger.warn(`[${modelName}] Client disconnected during structure planning, aborting generation`);
             throw new Error('Client disconnected');
         }
         let structurePlanMap = {};
@@ -54,7 +54,7 @@ export default async function generatePageContentMultiAgent(input) {
             model,
             agents: [pageStructurePlannerAgent, pageStructureValidatorAgent],
             limits: {
-                maxAgentInvokes: 20,
+                maxAgentInvokes: 30,
             },
         });
         await planningEngine.invoke(pageStructurePlannerAgent, {
@@ -70,8 +70,7 @@ export default async function generatePageContentMultiAgent(input) {
         });
         const structurePlanResult = await planningEngine.subscribe(UserOutputTopic);
         const { structurePlan } = structurePlanResult.message;
-        // const { structurePlan } = structurePlanResult;
-        logger.info('Initial structure plan generated', structurePlan);
+        logger.info(`[${modelName}] Initial structure plan generated`, structurePlan);
         await planningEngine.shutdown();
         // 触发页面结构生成成功事件
         if (onProgress) {
@@ -100,7 +99,7 @@ export default async function generatePageContentMultiAgent(input) {
                 logger.warn(`Client disconnected before generating section ${sectionName}, aborting generation`);
                 return null;
             }
-            logger.info(`Generating content for section: ${sectionName}`);
+            logger.info(`[${modelName}] Generating content for section: ${sectionName}`);
             // 通知当前正在处理的section
             if (onProgress) {
                 onProgress({
@@ -125,7 +124,7 @@ export default async function generatePageContentMultiAgent(input) {
             // eslint-disable-next-line no-await-in-loop
             const sectionContent = await engine.invoke(sectionContentAgent, sectionContentInput);
             sectionsData[sectionName] = sectionContent;
-            logger.info(`Content generated for section: ${sectionName}`);
+            logger.info(`[${modelName}] Content generated for section: ${sectionName}`);
             // 通知该section已生成完成
             if (onProgress) {
                 const sectionDataObj = {};
@@ -139,10 +138,10 @@ export default async function generatePageContentMultiAgent(input) {
             }
         }
         // 6. 生成页面元数据
-        logger.info('Generating page metadata');
+        logger.info(`[${modelName}] Generating page metadata`);
         // 检查客户端是否仍然连接
         if (!isClientConnected()) {
-            logger.warn('Client disconnected before generating metadata, aborting generation');
+            logger.warn(`[${modelName}] Client disconnected before generating metadata, aborting generation`);
             throw new Error('Client disconnected');
         }
         const metadata = await engine.invoke(generatePageMetadataAgent, {
@@ -157,11 +156,11 @@ export default async function generatePageContentMultiAgent(input) {
             description: metadata.description,
             sectionsData,
         };
-        logger.info('Multi-agent page content generation completed');
+        logger.info(`[${modelName}] Multi-agent page content generation completed`);
         return result;
     }
     catch (error) {
-        logger.error('Error in multi-agent page content generation:', error);
+        logger.error(`[${modelName}] Error in multi-agent page content generation:`, error);
         throw error;
     }
 }

package/lib/esm/agents/page-structure-planner.js

@@ -69,7 +69,6 @@ export const pageStructurePlannerAgent = AIAgent.from({
         logger.info('page structure planner output', JSON.stringify(output.structurePlan));
         return 'validation_request';
     },
-    // publishTopic: UserOutputTopic,
     instructions: prompt,
     inputSchema: z.object({
         context: z.string(),