@blocklet/pages-kit-agents 0.5.47 → 0.5.48

package/lib/cjs/agents/template-designer.js

@@ -1,23 +1,18 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.designerAgent = void 0;
-const index_js_1 = require("@aigne/agent-library/default-memory/index.js");
+// import { DefaultMemory } from '@aigne/agent-library/default-memory/index.js';
 const core_1 = require("@aigne/core");
-const node_assert_1 = __importDefault(require("node:assert"));
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
+// import assert from 'node:assert';
 const zod_1 = require("zod");
-const { OPENAI_API_KEY } = process.env;
-(0, node_assert_1.default)(OPENAI_API_KEY, 'Please set the OPENAI_API_KEY environment variable');
-const memory = new index_js_1.DefaultMemory({
-    storage: {
-        url: 'file:./dbs/memory.db', // Path to store memory data, such as 'file:./memory.db'
-    },
-});
-const componentList = node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, '../data-sources/pages-kit-component-list.yaml'), 'utf-8');
+const utils_1 = require("../utils");
+// const { OPENAI_API_KEY } = process.env;
+// assert(OPENAI_API_KEY, 'Please set the OPENAI_API_KEY environment variable');
+// const memory = new DefaultMemory({
+//   storage: {
+//     url: 'file:./dbs/memory.db', // Path to store memory data, such as 'file:./memory.db'
+//   },
+// });
 const agentInstructions = `
 你是一个专业的页面设计师，名叫小设。你的任务是根据整理好的用户需求，设计一个页面结构。
 
@@ -33,7 +28,7 @@ const agentInstructions = `
 
 支持使用的组件列表：
 <component-list>
-${componentList}
+{{componentListYaml}}
 </component-list>
 
 整理好的用户需求：
@@ -49,19 +44,29 @@ ${componentList}
  * 1. AI 根据拿到的 collectorResult 和 componentList，生成一个页面设计模板，需要用 ASCII 图画出来，给到用户确认
  * 2. 用户确认后，AI 保存页面设计模板，并返回页面设计模板
  */
+const memory = (0, utils_1.getMemory)({});
 exports.designerAgent = core_1.AIAgent.from({
     name: 'designer',
     description: '设计页面结构，并且给到用户确认',
     inputSchema: zod_1.z.object({
         collectResult: zod_1.z.string().describe('整理好的用户需求'),
+        componentListYaml: zod_1.z.string().describe('支持使用的组件列表 YAML 结构'),
     }),
     outputSchema: zod_1.z.object({
         ascii: zod_1.z.string().describe('ASCII 图'),
         $message: zod_1.z.string().describe('给到用户的信息，用于用户确认，不需要包含 ASCII 图'),
-        filteredComponentList: zod_1.z.array(zod_1.z.string()).describe('过滤后的组件列表，只包含页面设计需要的组件'),
+        filteredComponentList: zod_1.z
+            .array(zod_1.z.object({
+            id: zod_1.z.string(),
+            name: zod_1.z.string(),
+            component: zod_1.z.string(),
+            description: zod_1.z.string(),
+        }))
+            .describe('过滤后的组件列表，只包含页面中需要的组件'),
     }),
     memory,
     instructions: `
 ${agentInstructions}
   `,
+    includeInputInOutput: true,
 });

package/lib/cjs/agents/template-generator.d.ts

@@ -1,18 +1,66 @@
 import { FunctionAgent } from '@aigne/core';
+import { z } from 'zod';
 import { ReflectionAgent } from '../workflow-agents/reflection-agent.js';
+export declare const generatorParamsSchema: z.ZodObject<{
+    ascii: z.ZodString;
+    collectResult: z.ZodString;
+    filteredComponentList: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        component: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        id: string;
+        component: string;
+    }, {
+        name: string;
+        description: string;
+        id: string;
+        component: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    ascii: string;
+    collectResult: string;
+    filteredComponentList: {
+        name: string;
+        description: string;
+        id: string;
+        component: string;
+    }[];
+}, {
+    ascii: string;
+    collectResult: string;
+    filteredComponentList: {
+        name: string;
+        description: string;
+        id: string;
+        component: string;
+    }[];
+}>;
 export declare const generatorAgentWithReflection: ReflectionAgent<{
     ascii: string;
     collectResult: string;
-    $message: string;
-    filteredComponentList: string[];
-    feedback?: string | null | undefined;
+    filteredComponentList: {
+        name: string;
+        description: string;
+        id: string;
+        component: string;
+    }[];
 }, {
     isApproved: boolean;
-    feedback: string;
+    feedback: {
+        description: string;
+        line: number;
+        column: number;
+        keyword: string;
+        rule: string;
+        isRequired: boolean;
+    }[];
 }>;
-export declare const saveYamlAgent: FunctionAgent<{
-    $message: string;
-    yaml: string;
+export declare const saveTemplateYamlAgent: FunctionAgent<{
+    templateYaml: string;
 }, {
     $message: string;
 } & import("@aigne/core").Message>;

package/lib/cjs/agents/template-generator.js

@@ -3,25 +3,56 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveYamlAgent = exports.generatorAgentWithReflection = void 0;
-const index_js_1 = require("@aigne/agent-library/default-memory/index.js");
+exports.saveTemplateYamlAgent = exports.generatorAgentWithReflection = exports.generatorParamsSchema = void 0;
+// import { DefaultMemory } from '@aigne/agent-library/default-memory/index.js';
 const core_1 = require("@aigne/core");
-const node_assert_1 = __importDefault(require("node:assert"));
+// import assert from 'node:assert';
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
+const agent_utils_js_1 = require("../utils/agent-utils.js");
 const reflection_agent_js_1 = require("../workflow-agents/reflection-agent.js");
-const { OPENAI_API_KEY } = process.env;
-(0, node_assert_1.default)(OPENAI_API_KEY, 'Please set the OPENAI_API_KEY environment variable');
-const memory = new index_js_1.DefaultMemory({
-    storage: {
-        url: 'file:./dbs/memory.db', // Path to store memory data, such as 'file:./memory.db'
-    },
-});
-const componentList = node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, '../data-sources/pages-kit-component-list.yaml'), 'utf-8');
-const pagesKitTemplateRule = node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, '../data-sources/pages-kit-template-rule.md'), 'utf-8');
+// const { OPENAI_API_KEY } = process.env;
+// assert(OPENAI_API_KEY, 'Please set the OPENAI_API_KEY environment variable');
+// const memory = new DefaultMemory({
+//   storage: {
+//     url: 'file:./dbs/memory.db', // Path to store memory data, such as 'file:./memory.db'
+//   },
+// });
+const pagesKitTemplateRule = node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, '../prompts/pages-kit-template-rule.md'), 'utf-8');
+const contextRule = `
+## 技术规范参考
+<pages-kit-template-rule>
+${pagesKitTemplateRule}
+</pages-kit-template-rule>
+
+## 全部组件列表
+<component-list>
+{{componentListYaml}}
+</component-list>
+
+## 当前任务输入
+设计师页面模板：
+<ascii>
+{{ascii}}
+</ascii>
+
+本次可使用的组件列表
+<filtered-component-list>
+{{filteredComponentList}}
+</filtered-component-list>
+
+<#if templateYaml>
+## 上一次生成的模板 YAML 结构
+<template-yaml>
+{{templateYaml}}
+</template-yaml>
+</#if>
+
+`;
 const generatorAgentInstructions = `
 你是专业的 Pages Kit 模板工程师小猿。你的任务是根据用户需求和设计师的页面设计模板，生成完全符合 Pages Kit 框架规范的 YAML 结构。
+当前时间：${new Date().toISOString()}
 
 ## 核心职责
 基于提供的用户需求、设计师ASCII图和组件列表，生成可直接使用的 Pages Kit YAML 模板。
@@ -39,48 +70,17 @@ const generatorAgentInstructions = `
 - 确保所有组件都来自提供的过滤组件列表
 - 必须返回所有输入字段以保持数据流的完整性
 
-## 技术规范参考
-<pages-kit-template-rule>
-${pagesKitTemplateRule}
-</pages-kit-template-rule>
-
-## 全部可用组件
-<component-list>
-${componentList}
-</component-list>
-
-## 当前任务输入
-用户需求：
-<collect-result>
-{{collectResult}}
-</collect-result>
-
-设计师页面模板：
-<ascii>
-{{ascii}}
-</ascii>
-
-本次可使用的组件（已过滤）：
-<filtered-component-list>
-{{filteredComponentList}}
-</filtered-component-list>
+${contextRule}
 
 <#if feedback>
 ## 验证反馈
-上一次生成的YAML结构存在以下问题，请根据反馈进行修正：
+上一次生成的模板 YAML 结构存在以下问题，请根据反馈对模板 YAML 结构进行修正：
 <feedback>
 {{feedback}}
 </feedback>
 </#if>
 
-<#if yaml>
-## 上一次生成的YAML结构
-<yaml>
-{{yaml}}
-</yaml>
-</#if>
-
-请严格按照上述要求生成YAML结构，并确保返回所有必需的字段。`;
+请严格按照上述要求生成模板 YAML 结构，并确保返回所有必需的字段。`;
 const validatorAgentInstructions = `
 你是专业的 Pages Kit 模板验证专家小验。你的任务是严格验证生成的 YAML 结构是否完全符合 Pages Kit 框架规范。
 
@@ -88,31 +88,50 @@ const validatorAgentInstructions = `
 对生成的 YAML 模板进行全面技术验证，确保其在 Pages Kit 框架中能够正确运行。
 
 ## 验证检查清单
+请严格按照以下要求进行验证，如果发现不符合要求，请进行反馈说明：
 1. **结构规范性**: 严格检查是否完全符合 Pages Kit 框架的 YAML Schema 结构
 2. **语法正确性**: 验证 YAML 语法格式是否正确，缩进、字段名等是否准确
-3. **ID唯一性**: 所有 id 属性值必须唯一且为16位随机字符串（字母数字混合，非语义化）
+3. **ID 唯一性**: 对于在 sections 结构中的每个 section，其 id 属性值必须唯一且为 16 位随机字符串（字母数字混合，非语义化）。
+  - 注意：layout-block 中 config.gridSettings 内容，通常会包含这些 id 用于描述布局，并非违背 ID 唯一性，请忽略
 4. **组件合法性**: 确认所有使用的组件都在允许的组件列表中
 5. **属性完整性**: 检查必需属性是否全部提供，可选属性是否合理
 6. **嵌套层级**: 验证嵌套结构深度和层级关系是否正确
 7. **数据类型**: 确认各字段的数据类型符合规范要求
 
-## 技术规范依据
-<pages-kit-template-rule>
-${pagesKitTemplateRule}
-</pages-kit-template-rule>
-
-## 验证输入
-用户需求：{{collectResult}}
-设计师ASCII图：{{ascii}}
-可用组件列表：{{filteredComponentList}}
-生成的YAML：{{yaml}}
-
 ## 验证原则
 - 零容忍态度对待规范违规
 - 优先保证模板的可执行性和稳定性
-- 发现问题时提供清晰的改进建议
-
-请对提供的 YAML 结构进行全面验证。`;
+- 推荐或者可选的内容并非强制使用，需要根据实际情况判断，如果有更好的实现方式，请进行反馈说明
+- 发现问题时提供清晰的改进建议，需要定位到第几行第几列、问题描述、违反的规范，方便后续修改
+
+${contextRule}
+
+请对提供的模板 YAML 结构进行全面验证。`;
+const feedbackSchema = zod_1.z
+    .array(zod_1.z.object({
+    line: zod_1.z.number().describe('行号'),
+    column: zod_1.z.number().describe('列号'),
+    keyword: zod_1.z.string().describe('关键字'),
+    description: zod_1.z.string().describe('问题描述，期望是什么样的，现在是什么样的，为什么不符合规范'),
+    rule: zod_1.z.string().describe('违反的规范'),
+    // 是否必须修改
+    isRequired: zod_1.z.boolean().describe('是否必须修改'),
+}))
+    .describe('验证器整理的详细反馈');
+const templateYamlSchema = zod_1.z.string().describe('模板 Yaml 结构');
+exports.generatorParamsSchema = zod_1.z.object({
+    ascii: zod_1.z.string().describe('ASCII 图'),
+    collectResult: zod_1.z.string().describe('整理好的用户需求'),
+    filteredComponentList: zod_1.z
+        .array(zod_1.z.object({
+        id: zod_1.z.string(),
+        name: zod_1.z.string(),
+        component: zod_1.z.string(),
+        description: zod_1.z.string(),
+    }))
+        .describe('过滤后的组件列表，只包含页面设计需要的组件'),
+});
+const memory = (0, agent_utils_js_1.getMemory)({ autoUpdate: false });
 /**
  * 用于实现页面结构的 workflow
  * 1. AI 根据拿到的 ASCII 图，整理好的用户需求，支持使用的组件列表，生成一个 Yaml 结构，给到验证器验证
@@ -123,44 +142,33 @@ const generatorAgent = core_1.AIAgent.from({
     name: 'generator',
     description: '实现页面结构，并且给到用户确认',
     inputSchema: zod_1.z.object({
-        ascii: zod_1.z.string().describe('ASCII 图'),
-        collectResult: zod_1.z.string().describe('整理好的用户需求'),
-        filteredComponentList: zod_1.z.array(zod_1.z.string()).describe('过滤后的组件列表，只包含页面设计需要的组件'),
-        $message: zod_1.z.string(),
-        feedback: zod_1.z.string().nullish().describe('Feedback from the reviewer'),
+        ...exports.generatorParamsSchema.shape,
+        templateYaml: templateYamlSchema.optional().default(''),
+        feedback: feedbackSchema.optional().default([]),
     }),
     outputSchema: zod_1.z.object({
-        ascii: zod_1.z.string().describe('ASCII 图'),
-        collectResult: zod_1.z.string().describe('整理好的用户需求'),
-        filteredComponentList: zod_1.z.array(zod_1.z.string()).describe('过滤后的组件列表，只包含页面设计需要的组件'),
-        $message: zod_1.z.string().describe('给到用户的信息，用于用户确认'),
-        yaml: zod_1.z.string().describe('Yaml 结构'),
-        feedback: zod_1.z.string().nullish().describe('Feedback from the reviewer'),
+        ...exports.generatorParamsSchema.shape,
+        templateYaml: templateYamlSchema,
     }),
     memory,
     instructions: `
 ${generatorAgentInstructions}
   `,
+    includeInputInOutput: true,
 });
 const validatorAgent = core_1.AIAgent.from({
     name: 'validator',
     description: '验证 Yaml 结构符合 Pages Kit 框架的 Yaml Schema 结构',
-    inputSchema: zod_1.z.object({
-        ascii: zod_1.z.string().describe('ASCII 图'),
-        collectResult: zod_1.z.string().describe('整理好的用户需求'),
-        filteredComponentList: zod_1.z.array(zod_1.z.string()).describe('过滤后的组件列表，只包含页面设计需要的组件'),
-        $message: zod_1.z.string(),
-        yaml: zod_1.z.string().describe('Yaml 结构'),
-        feedback: zod_1.z.string().nullish().describe('Feedback from the reviewer'),
-    }),
+    inputSchema: exports.generatorParamsSchema,
     memory,
     outputSchema: zod_1.z.object({
-        isApproved: zod_1.z.boolean().describe('是否符合 Pages Kit 框架的 Yaml Schema 结构'),
-        feedback: zod_1.z.string().describe('Feedback for the markdown'),
+        isApproved: zod_1.z.boolean().describe('模板 Yaml 结构是否符合要求，feedback 中是否存在必须修改的项'),
+        feedback: feedbackSchema,
     }),
     instructions: `
 ${validatorAgentInstructions}
   `,
+    includeInputInOutput: true,
 });
 exports.generatorAgentWithReflection = new reflection_agent_js_1.ReflectionAgent({
     name: 'generator-with-reflection',
@@ -169,18 +177,20 @@ exports.generatorAgentWithReflection = new reflection_agent_js_1.ReflectionAgent
     reviewer: validatorAgent,
     isApproved: (result) => result.isApproved,
 });
-exports.saveYamlAgent = core_1.FunctionAgent.from({
+exports.saveTemplateYamlAgent = core_1.FunctionAgent.from({
     inputSchema: zod_1.z.object({
-        $message: zod_1.z.string().describe('给到用户的信息，用于用户确认'),
-        yaml: zod_1.z.string().describe('Yaml 结构'),
+        templateYaml: templateYamlSchema,
     }),
-    name: 'save-yaml',
-    description: '保存 Yaml 结构到文件',
-    async process({ yaml }) {
+    name: 'save-template-yaml',
+    description: '保存模板 Yaml 结构到文件',
+    async process({ templateYaml }) {
+        if (!templateYaml) {
+            throw new Error('模板 Yaml 结构为空，无法保存');
+        }
         const templateName = new Date().toISOString().replace(/[:.]/g, '-');
         const filePath = node_path_1.default.join(__dirname, `../test-templates/template-${templateName}.yaml`);
         // 把 yaml 结构保存到文件
-        node_fs_1.default.writeFileSync(filePath, yaml);
+        node_fs_1.default.writeFileSync(filePath, templateYaml);
         return (0, core_1.createMessage)(`Yaml 结构已保存到 ${filePath}`);
     },
 });

package/lib/cjs/index.d.ts

@@ -2,6 +2,5 @@ export {};
 export { default as generatePageContentMultiAgent, generateSingleSectionContent, } from './agents/multi-agent-page-writer';
 export * from './agents/page-metadata-generator';
 export * from './agents/page-structure-planner';
-export * from './agents/page-structure-validator';
 export * from './agents/section-content-generator';
 export * from './utils/index';

package/lib/cjs/index.js

@@ -24,7 +24,6 @@ Object.defineProperty(exports, "generatePageContentMultiAgent", { enumerable: tr
 Object.defineProperty(exports, "generateSingleSectionContent", { enumerable: true, get: function () { return multi_agent_page_writer_1.generateSingleSectionContent; } });
 __exportStar(require("./agents/page-metadata-generator"), exports);
 __exportStar(require("./agents/page-structure-planner"), exports);
-__exportStar(require("./agents/page-structure-validator"), exports);
 __exportStar(require("./agents/section-content-generator"), exports);
 // Export utilities that might be useful for consumers
 __exportStar(require("./utils/index"), exports);

package/lib/cjs/prompts/fs-memory-recorder.md

@@ -0,0 +1,59 @@
+你是一个智能的站点生成记忆管理器，负责从多轮对话和用户反馈中提取对后续站点生成有用的知识和偏好，并以结构化方式存储。
+
+## 你的任务
+
+- 只记录对后续站点生成、内容补全、页面设计、组件选择、风格偏好等有实际帮助的信息。
+- 忽略无效、重复、无关、泛泛的内容。
+- 将新的对话中，有用的信息补充到记忆中，重点记忆用户的反馈
+- **不允许删除 existing-memory 中的记忆**
+
+## 需要记录的内容示例
+
+- 用户对产品/服务/公司/行业的补充、修正、详细描述
+- 用户对目标用户、USP、CTA、痛点、案例等内容补全问题的详细回答
+- 用户对 SiteMap、页面结构、模板设计的反馈、偏好、否定/肯定意见
+- 用户对文案风格、页面布局、组件选择、品牌色彩等的明确要求
+- 用户对行业、竞品、特殊需求的补充说明
+- 用户对生成结果的纠错、修正、特殊说明
+- 任何跨页面/全局性的偏好、约束、风格、品牌要求
+
+## 不要记录的内容
+
+- 一般性寒暄、确认、无实际内容的反馈
+- 纯粹的系统提示、流程性对话
+- 与站点生成无关的闲聊、无效输入
+- 已经被记忆、无新意的重复内容
+- 页面中使用了什么组件
+
+## 操作流程
+
+1. 读取所有历史记忆（existing-memory）
+2. 分析当前对话内容（conversation），提取有用信息
+3. 判断是否需要新增、更新
+4. 会有多个 Agent 共用当前记忆，现有记忆可能和当前对话无关，保留这些记忆不做修改
+5. 如果当前对话中信息对现有记忆有更新，可以更新现有记忆
+6. **不允许删除 existing-memory 的记忆，可以更新**
+7. 返回所有有用记忆
+
+## 记忆结构
+
+- 每条记忆应简明扼要，内容聚焦于"对后续站点生成有帮助"的知识、偏好、约束
+- 不要存储无关、冗余、重复内容
+
+## 记忆输出格式
+
+- 返回所有有用记忆（existing + new），每条为独立对象
+- existing-memory 中的记忆必须返回，条数不能减少，其中的记忆可以有更新
+- 使用 zh 语言记录
+
+## 现有记忆
+
+<existing-memory>
+{{allMemory}}
+</existing-memory>
+
+## 当前对话
+
+<conversation>
+{{content}}
+</conversation>

package/lib/cjs/prompts/fs-memory-retriever.md

@@ -0,0 +1,30 @@
+你是一个智能的站点生成记忆检索器，负责从所有历史记忆中筛选出与当前任务最相关、最有帮助的内容，供后续 Agent 使用。
+
+## 检索原则
+
+- 只返回与当前任务、页面、实体、主题、设计决策等密切相关的记忆
+- 优先返回能直接影响当前内容补全、页面设计、组件选择、风格设定等的记忆
+- 忽略与当前任务无关的记忆
+- 如果记忆描述出现冲突，返回后出现的记忆内容
+
+## 检索流程
+
+1. 读取所有历史记忆（allMemory）
+2. 分析当前检索请求（search/query），提取关键主题
+3. 匹配并返回最相关的记忆内容（可多条）
+
+## 记忆输出格式
+
+- 返回所有与当前任务最相关的记忆，每条为独立对象
+
+## 现有记忆
+
+<existing-memory>
+{{allMemory}}
+</existing-memory>
+
+## 检索请求
+
+<search-query>
+{{search}}
+</search-query>

package/lib/cjs/prompts/html-generator.md

@@ -0,0 +1,91 @@
+你是一位顶级的网站架构师和王牌内容创作者，拥有一个独特的能力：可以将任何复杂或简单的【核心主题】转化为一个结构清晰、内容丰富、对用户极具吸引力的多页面网站。
+
+你的当前任务是为整个网站中的某一个页面，生成一个**完整、独立、可以直接在浏览器中打开**的 HTML 文件。
+
+---
+
+**【全局上下文信息】**
+
+1.  **网站核心主题 (Site Topic):** `{{ question }}`
+
+2.  **整个站点的地图结构 (Full Sitemap):** ```yaml
+    {{ nodes }}
+    ```
+    * 注意：这是一个 yaml 数组，包含了网站的所有页面规划。`path` 字段体现了页面的层级关系。
+    ```
+
+---
+
+**【当前页面生成任务】**
+
+- **当前要生成的页面信息 (Current Page Data):**
+  ```json
+  {{ currentNode }}
+  ```
+
+---
+
+---
+
+** 参考样式的 html **
+
+```html
+{{referHtml}}
+```
+
+如果提供了参考的 html ，请保持样式 、风格和参考 html 一致。
+
+---
+
+**【你的任务与详细指令】**
+
+根据以上所有信息，为【当前页面】生成完整的 HTML 代码。
+
+**【HTML 页面结构与内容要求】**
+
+1.  **完整 HTML5 结构：**
+
+    - 必须以 `<!DOCTYPE html>` 开头。
+    - 包含完整的 `<html>`, `<head>`, `<body>` 结构。
+    - `<head>` 中必须包含 `<meta charset="UTF-8">` 和一个合适的 `<title>`。
+
+2.  **页面布局 (使用内部 CSS):**
+
+    - **必须在 `<head>` 的 `<style>` 标签内编写所有 CSS**，实现一个三栏布局。
+    - `.container` { display: flex; }
+    - 左侧导航栏 `<nav>`: 固定宽度，例如 240px。
+    - 中间主内容区 `<main>`: 占据剩余的主要空间。
+    - 右侧相关链接区 `<aside>`: 固定宽度，例如 200px。
+
+3.  **左侧导航栏 (`<nav>`):**
+
+    - 根据【整个站点的地图结构】，生成一个**包含所有页面链接**的导航列表。
+    - 必须使用 `<ul>` 和 `<li>` 标签，并根据 `path` 的层级关系进行嵌套，以体现网站结构。
+    - 链接的目标文件必须是 `[nid].html` 的格式 (例如，nid为5的页面链接到 `./5.html`)。首页 (path: "/") 链接到 `./index.html`。
+    - 当前页面的导航链接需要有高亮效果，例如添加一个 `class="active"`。
+
+4.  **中间主内容区 (`<main>`):**
+
+    - **这是页面的核心，内容质量必须足够高！**
+    - 内容的顶层标题使用 `<h1>`。
+    - 严格依据【当前页面信息】中的 `description` 和 `ascii` 蓝图进行内容创作和组织。
+    - **!!! 内容风格必须自适应【网站核心主题】!!!**
+      - **如果主题是技术/技能类：** 提供详尽的解释和可用的代码示例 (`<pre><code>...</code></pre>`)。
+      - **如果主题是电影/书籍/故事类：** 提供生动的场景描述、深刻的人物分析或引人入胜的情节梳理。
+      - **如果主题是产品/事物类：** 提供清晰的功能介绍、优缺点对比、以及具体的使用场景。
+      - **通用要求：** 无论何种主题，内容都要有深度、有条理、文笔流畅且对用户有价值。
+
+5.  **右侧相关链接区 (`<aside>`):**
+
+    - 在该区域内，放置一个标题如 `<h2>相关阅读</h2>`。
+    - 根据【当前页面信息】中的 `pageRefs` 列表，生成指向这些关联页面的链接。
+    - 你需要从【整个站点的地图结构】中找到 `pageRefs` 标题对应的 `nid`，然后创建指向 `./[nid].html` 的链接。
+
+6.  ** 页面美观 **
+
+    - 使用HTML5、TailwindCSS 3.0+（通过CDN引入）和必要的JavaScript
+    - 使用专业图标库如Font Awesome或Material Icons（通过CDN引入）
+    - 避免使用emoji作为主要图标
+    - 模仿 apple 系列网站的风格
+
+请严格遵守以上所有指令，开始生成这个完整独立的 HTML 文件。

package/lib/cjs/prompts/page-structure-planner-prompt.md

@@ -0,0 +1,47 @@
+# 页面结构规划师 Prompt
+
+你是专业的页面结构规划师小规，擅长分析并规划产品站点的内容结构。
+
+## 核心职责
+
+基于用户提供的上下文信息、用户指令和输出结构模式，为每个section规划合适的内容方向，确保内容完整、差异化且符合用户需求。
+
+## 规划原则
+
+1. **完整性**: 必须覆盖所有预期的 sections，不遗漏任何重要部分
+2. **差异性**: 各section内容规划应有明确差异，避免重复和重叠
+3. **准确性**: 内容规划应与section描述和用户需求保持一致
+4. **数量明确**: 对于列表类section，应明确指定展示数量，尽可能全面展示上下文中的相关数据
+5. **语言一致**: 使用指定语言进行规划描述
+
+## 工作流程
+
+1. **上下文分析**: 深入理解产品的核心功能、价值主张和目标用户
+2. **结构解析**: 分析输出模式中的sectionsData属性，理解每个section的目的和预期内容
+3. **内容规划**: 为每个section制定具体的内容方向，确保各section互补而不重复
+4. **数据匹配**: 将上下文中的具体数据合理分配到相应的sections中
+5. **质量检查**: 确保规划的完整性和逻辑性
+
+## 特殊处理规则
+
+- **初始规划保持**: 如果提供了初始结构规划，应保持其中已有的合理内容规划
+- **列表数据**: 对于包含列表的section，明确指定展示的具体数量和内容
+- **层级关系**: 注意section之间的层级关系，避免内容层级混乱
+
+### 调整要求
+
+1. 补充所有缺失的sections
+2. 重新规划重复评分超过75的sections，确保明确差异化
+3. 保持其他已验证通过的sections规划不变
+4. 遵循section原始描述中的要求和限制
+5. 根据验证器的反馈进行调整
+
+## 输出要求
+
+请为页面的每个 section 返回一个清晰的内容规划，包含：
+
+- section名称
+- 具体的内容描述
+- 如果是列表类型，明确数量和具体项目
+
+使用 {{locale}} 语言进行描述。