@aigne/doc-smith 0.2.11 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.3.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.3.0...v0.3.1) (2025-08-19)
+
+
+### Bug Fixes
+
+* polish load sources pattern ([#48](https://github.com/AIGNE-io/aigne-doc-smith/issues/48)) ([5f83b91](https://github.com/AIGNE-io/aigne-doc-smith/commit/5f83b917ea6779ba79418e3ff2490eb692c3e48a))
+
+## [0.3.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.11...v0.3.0) (2025-08-19)
+
+
+### Features
+
+* **core:** polish generation context collecting workflow ([#46](https://github.com/AIGNE-io/aigne-doc-smith/issues/46)) ([687d06a](https://github.com/AIGNE-io/aigne-doc-smith/commit/687d06afd648e0e697d25e85dcc841b17c3c311c))
+
+
+### Bug Fixes
+
+* optimizing help copy for running a self-hosted discuss kit ([#45](https://github.com/AIGNE-io/aigne-doc-smith/issues/45)) ([6841de8](https://github.com/AIGNE-io/aigne-doc-smith/commit/6841de817408d85ac8d993860ab431f7b8816aef))
+
 ## [0.2.11](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.10...v0.2.11) (2025-08-15)
 
 

package/agents/batch-docs-detail-generator.yaml

@@ -1,5 +1,5 @@
 type: team
-name: batchDocsDetailGenerator
+name: batchDocsDetailGenerate
 description: 批量生成文档详情
 skills:
   - ./check-detail.mjs

package/agents/batch-translate.yaml

@@ -3,6 +3,8 @@ name: batchTranslate
 description: 批量翻译文档到多个语言
 skills:
   - type: team
+    task_render_mode: collapse
+    name: translate
     skills:
       - ./translate.yaml
       - type: transform
@@ -14,7 +16,7 @@ skills:
     reflection:
       reviewer: ./check-detail-result.mjs
       is_approved: isApproved
-      max_iterations: 3
+      max_iterations: 5
       return_last_on_max_iterations: true
     task_title: Translate '{{ title }}' to '{{ language }}'
 input_schema:

package/agents/check-structure-plan.mjs

@@ -71,7 +71,7 @@ export default async function checkStructurePlan(
     };
   }
 
-  const panningAgent = options.context.agents["reflectiveStructurePlanner"];
+  const panningAgent = options.context.agents["structurePlanning"];
 
   const result = await options.context.invoke(panningAgent, {
     feedback: finalFeedback || "",

package/agents/detail-generator-and-translate.yaml

@@ -4,6 +4,8 @@ description: 生成文档详情并翻译
 skills:
   - ./transform-detail-datasources.mjs
   - type: team
+    task_render_mode: collapse
+    name: detailGenerate
     skills:
       - ./content-detail-generator.yaml
       - type: transform
@@ -19,6 +21,7 @@ skills:
       return_last_on_max_iterations: true
     task_title: Generate detail for '{{ title }}'
   - type: transform
+    task_render_mode: hide
     jsonata: |
       $merge([
         $,

package/agents/detail-regenerator.yaml

@@ -10,6 +10,7 @@ skills:
   - ./load-config.mjs
   - ./load-sources.mjs
   - type: transform
+    task_render_mode: hide
     jsonata: |
       $merge([
         $,
@@ -33,14 +34,10 @@ skills:
 input_schema:
   type: object
   properties:
-    # config:
-    #   type: string
-    #   description: Path to the config file
-    #   default: ./.aigne/doc-smith/config.yaml
     glossary:
       type: string
-      description: Glossary of terms for consistent terminology
-    doc-path:
+      description: Glossary of terms for consistent terminology, use @<file> to read from a file
+    docPath:
       type: string
       description: Document path to regenerate
     feedback:

package/agents/docs-generator.yaml

@@ -19,6 +19,7 @@ skills:
       fileName: structure-plan.json
   - type: transform
     name: transformData
+    task_render_mode: hide
     jsonata: |
       $merge([
         $,
@@ -41,13 +42,9 @@ skills:
 input_schema:
   type: object
   properties:
-    # config:
-    #   type: string
-    #   description: Path to the config file
-    #   default: ./.aigne/doc-smith/config.yaml
     glossary:
       type: string
-      description: Glossary of terms for consistent terminology
+      description: Glossary of terms for consistent terminology, use @<file> to read from a file
     feedback:
       type: string
       description: Feedback for structure planning adjustments

package/agents/find-item-by-path.mjs

@@ -8,7 +8,7 @@ function getActionText(isTranslate, baseText) {
 }
 
 export default async function findItemByPath(
-  { "doc-path": docPath, structurePlanResult, boardId, docsDir, isTranslate, feedback },
+  { docPath, structurePlanResult, boardId, docsDir, isTranslate, feedback },
   options,
 ) {
   let foundItem = null;

package/agents/format-structure-plan.mjs

@@ -21,3 +21,5 @@ export default async function formatStructurePlan({ structurePlan }) {
     structurePlan,
   };
 }
+
+formatStructurePlan.task_render_mode = "hide";

package/agents/input-generator.mjs

@@ -1,8 +1,22 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import chalk from "chalk";
-import { DOCUMENT_STYLES, SUPPORTED_LANGUAGES, TARGET_AUDIENCES } from "../utils/constants.mjs";
-import { getAvailablePaths, getProjectInfo, validatePath } from "../utils/utils.mjs";
+import {
+  DOCUMENT_STYLES,
+  SUPPORTED_LANGUAGES,
+  TARGET_AUDIENCES,
+  READER_KNOWLEDGE_LEVELS,
+  DOCUMENTATION_DEPTH,
+  PURPOSE_TO_KNOWLEDGE_MAPPING,
+  DEPTH_RECOMMENDATION_LOGIC,
+} from "../utils/constants.mjs";
+import {
+  getAvailablePaths,
+  getProjectInfo,
+  validatePath,
+  detectSystemLanguage,
+} from "../utils/utils.mjs";
+import { validateSelection, getFilteredOptions } from "../utils/conflict-detector.mjs";
 
 // UI constants
 const _PRESS_ENTER_TO_FINISH = "Press Enter to finish";
@@ -31,72 +45,172 @@ export default async function init(
   // Collect user information
   const input = {};
 
-  // 1. Document generation rules with style selection
-  // Let user select a document style
-  const styleChoice = await options.prompts.select({
-    message: "📝 Step 1/6: Choose your documentation style:",
-    choices: Object.entries(DOCUMENT_STYLES).map(([key, style]) => ({
-      name: `${style.name} - ${style.rules}`,
-      value: key,
-    })),
+  // 1. Primary purpose - what's the main outcome you want readers to achieve?
+  const purposeChoices = await options.prompts.checkbox({
+    message:
+      "📝 Step 1/8: What's the main outcome you want readers to achieve? (Select all that apply)",
+    choices: Object.entries(DOCUMENT_STYLES)
+      .filter(([key]) => key !== "custom") // Remove custom option for multiselect
+      .map(([key, style]) => ({
+        name: `${style.name}`,
+        description: style.description,
+        value: key,
+      })),
+    validate: (input) => {
+      if (input.length === 0) {
+        return "Please select at least one purpose.";
+      }
+      return validateSelection("documentPurpose", input);
+    },
   });
 
-  let rules;
-  if (styleChoice === "custom") {
-    // User wants to input custom rules
-    rules = await options.prompts.input({
-      message: "Enter your custom documentation rules:",
+  // Follow-up logic: If ONLY mixedPurpose selected, ask for priority ranking
+  let prioritizedPurposes = purposeChoices;
+  if (purposeChoices.length === 1 && purposeChoices.includes("mixedPurpose")) {
+    const topPriorities = await options.prompts.checkbox({
+      message: "🎯 Which is most important? (Select top 2 priorities)",
+      choices: Object.entries(DOCUMENT_STYLES)
+        .filter(([key]) => key !== "custom" && key !== "mixedPurpose") // Filter out custom and mixedPurpose
+        .map(([key, style]) => ({
+          name: `${style.name}`,
+          description: style.description,
+          value: key,
+        })),
+      validate: (input) => {
+        if (input.length === 0) {
+          return "Please select at least one priority.";
+        }
+        if (input.length > 2) {
+          return "Please select maximum 2 priorities.";
+        }
+        return true;
+      },
     });
-  } else {
-    // Use predefined style directly
-    rules = DOCUMENT_STYLES[styleChoice].rules;
+
+    // Replace mixedPurpose with selected priorities
+    prioritizedPurposes = topPriorities;
   }
 
-  input.rules = rules.trim();
+  // Save document purpose choices as keys
+  input.documentPurpose = prioritizedPurposes;
+
+  // 2. Target audience - who will be reading this most often?
+  const audienceChoices = await options.prompts.checkbox({
+    message: "👥 Step 2/8: Who will be reading this most often? (Select all that apply)",
+    choices: Object.entries(TARGET_AUDIENCES)
+      .filter(([key]) => key !== "custom") // Remove custom option for multiselect
+      .map(([key, audience]) => ({
+        name: `${audience.name}`,
+        description: audience.description,
+        value: key,
+      })),
+    validate: (input) => {
+      if (input.length === 0) {
+        return "Please select at least one audience.";
+      }
+      return validateSelection("targetAudienceTypes", input);
+    },
+  });
+
+  // Save target audience choices as keys
+  input.targetAudienceTypes = audienceChoices;
 
-  // 2. Target audience selection
-  // Let user select target audience
-  const audienceChoice = await options.prompts.select({
-    message: "👥 Step 2/6: Who is your target audience?",
-    choices: Object.entries(TARGET_AUDIENCES).map(([key, audience]) => ({
-      name: audience,
+  // 3. Reader knowledge level - what do readers typically know when they arrive?
+  // Determine default based on selected purposes using mapping
+  const mappedPurpose = prioritizedPurposes.find(
+    (purpose) => PURPOSE_TO_KNOWLEDGE_MAPPING[purpose],
+  );
+  const defaultKnowledge = mappedPurpose ? PURPOSE_TO_KNOWLEDGE_MAPPING[mappedPurpose] : null;
+
+  // Filter knowledge level options based on previous selections
+  const { filteredOptions: filteredKnowledgeOptions } = getFilteredOptions(
+    "readerKnowledgeLevel",
+    { documentPurpose: prioritizedPurposes, targetAudienceTypes: audienceChoices },
+    READER_KNOWLEDGE_LEVELS,
+  );
+
+  const knowledgeChoice = await options.prompts.select({
+    message: "🧠 Step 3/8: What do readers typically know when they arrive?",
+    choices: Object.entries(filteredKnowledgeOptions).map(([key, level]) => ({
+      name: `${level.name}`,
+      description: level.description,
       value: key,
     })),
+    default: defaultKnowledge,
   });
 
-  let targetAudience;
-  if (audienceChoice === "custom") {
-    // User wants to input custom audience
-    targetAudience = await options.prompts.input({
-      message: "Enter your custom target audience:",
-    });
-  } else {
-    // Use predefined audience directly
-    targetAudience = TARGET_AUDIENCES[audienceChoice];
-  }
+  // Save reader knowledge level choice as key
+  input.readerKnowledgeLevel = knowledgeChoice;
+
+  // 4. Documentation depth - how comprehensive should the documentation be?
+  // Determine default based on priority: Purpose > Audience > Knowledge Level
+  const getDepthDefault = () => {
+    // Check priority order: purposes -> audiences -> knowledgeLevels
+    const checks = [
+      () => {
+        const purpose = prioritizedPurposes.find((p) => DEPTH_RECOMMENDATION_LOGIC.purposes[p]);
+        return purpose ? DEPTH_RECOMMENDATION_LOGIC.purposes[purpose] : null;
+      },
+      () => {
+        const audience = audienceChoices.find((a) => DEPTH_RECOMMENDATION_LOGIC.audiences[a]);
+        return audience ? DEPTH_RECOMMENDATION_LOGIC.audiences[audience] : null;
+      },
+      () => DEPTH_RECOMMENDATION_LOGIC.knowledgeLevels[knowledgeChoice] || null,
+    ];
+
+    return checks.find((check) => check())?.() || null;
+  };
+
+  const defaultDepth = getDepthDefault();
+
+  // Filter documentation depth options based on all previous selections
+  const { filteredOptions: filteredDepthOptions } = getFilteredOptions(
+    "documentationDepth",
+    {
+      documentPurpose: prioritizedPurposes,
+      targetAudienceTypes: audienceChoices,
+      readerKnowledgeLevel: knowledgeChoice,
+    },
+    DOCUMENTATION_DEPTH,
+  );
+
+  const depthChoice = await options.prompts.select({
+    message: "📊 Step 4/8: How comprehensive should the documentation be?",
+    choices: Object.entries(filteredDepthOptions).map(([key, depth]) => ({
+      name: `${depth.name}`,
+      description: depth.description,
+      value: key,
+    })),
+    default: defaultDepth,
+  });
+
+  // Save documentation depth choice as key
+  input.documentationDepth = depthChoice;
 
-  input.targetAudience = targetAudience.trim();
+  // 5. Language settings
+  // Detect system language and use as default
+  const systemLanguage = detectSystemLanguage();
 
-  // 3. Language settings
   // Let user select primary language from supported list
   const primaryLanguageChoice = await options.prompts.select({
-    message: "🌐 Step 3/6: Choose primary documentation language:",
+    message: "🌐 Step 5/8: Choose primary documentation language:",
     choices: SUPPORTED_LANGUAGES.map((lang) => ({
       name: `${lang.label} - ${lang.sample}`,
       value: lang.code,
     })),
+    default: systemLanguage,
   });
 
   input.locale = primaryLanguageChoice;
 
-  // 4. Translation languages
+  // 6. Translation languages
   // Filter out the primary language from available choices
   const availableTranslationLanguages = SUPPORTED_LANGUAGES.filter(
     (lang) => lang.code !== primaryLanguageChoice,
   );
 
   const translateLanguageChoices = await options.prompts.checkbox({
-    message: "🔄 Step 4/6: Select translation languages:",
+    message: "🔄 Step 6/8: Select translation languages:",
     choices: availableTranslationLanguages.map((lang) => ({
       name: `${lang.label} - ${lang.sample}`,
       value: lang.code,
@@ -105,15 +219,15 @@ export default async function init(
 
   input.translateLanguages = translateLanguageChoices;
 
-  // 5. Documentation directory
+  // 7. Documentation directory
   const docsDirInput = await options.prompts.input({
-    message: `📁 Step 5/6: Where to save generated docs:`,
+    message: `📁 Step 7/8: Where to save generated docs:`,
     default: `${outputPath}/docs`,
   });
   input.docsDir = docsDirInput.trim() || `${outputPath}/docs`;
 
-  // 6. Source code paths
-  console.log("\n🔍 Step 6/6: Source Code Paths");
+  // 8. Source code paths
+  console.log("\n🔍 Step 8/8: Source Code Paths");
   console.log("Enter paths to analyze for documentation (e.g., ./src, ./lib)");
   console.log("💡 If no paths are configured, './' will be used as default");
 
@@ -221,16 +335,70 @@ function generateYAML(input) {
   yaml += `projectLogo: ${input.projectLogo || ""}\n`;
   yaml += `\n`;
 
-  // Add rules (required field)
-  yaml += `rules: |\n`;
-  if (input.rules?.trim()) {
-    yaml += `  ${input.rules.split("\n").join("\n  ")}\n\n`;
-  } else {
-    yaml += `  \n\n`;
+  // Add documentation configuration choices with all available options
+  yaml += `# =============================================================================\n`;
+  yaml += `# Documentation Configuration\n`;
+  yaml += `# =============================================================================\n\n`;
+
+  // Document Purpose with all available options
+  yaml += `# Purpose: What's the main outcome you want readers to achieve?\n`;
+  yaml += `# Available options (uncomment and modify as needed):\n`;
+  Object.entries(DOCUMENT_STYLES).forEach(([key, style]) => {
+    if (key !== "custom") {
+      yaml += `#   ${key.padEnd(16)} - ${style.name}: ${style.description}\n`;
+    }
+  });
+  yaml += `documentPurpose:\n`;
+  if (input.documentPurpose && input.documentPurpose.length > 0) {
+    input.documentPurpose.forEach((purpose) => {
+      yaml += `  - ${purpose}\n`;
+    });
   }
+  yaml += `\n`;
+
+  // Target Audience Types with all available options
+  yaml += `# Target Audience: Who will be reading this most often?\n`;
+  yaml += `# Available options (uncomment and modify as needed):\n`;
+  Object.entries(TARGET_AUDIENCES).forEach(([key, audience]) => {
+    if (key !== "custom") {
+      yaml += `#   ${key.padEnd(16)} - ${audience.name}: ${audience.description}\n`;
+    }
+  });
+  yaml += `targetAudienceTypes:\n`;
+  if (input.targetAudienceTypes && input.targetAudienceTypes.length > 0) {
+    input.targetAudienceTypes.forEach((audience) => {
+      yaml += `  - ${audience}\n`;
+    });
+  }
+  yaml += `\n`;
+
+  // Reader Knowledge Level with all available options
+  yaml += `# Reader Knowledge Level: What do readers typically know when they arrive?\n`;
+  yaml += `# Available options (uncomment and modify as needed):\n`;
+  Object.entries(READER_KNOWLEDGE_LEVELS).forEach(([key, level]) => {
+    yaml += `#   ${key.padEnd(20)} - ${level.name}: ${level.description}\n`;
+  });
+  yaml += `readerKnowledgeLevel: ${input.readerKnowledgeLevel || ""}\n`;
+  yaml += `\n`;
+
+  // Documentation Depth with all available options
+  yaml += `# Documentation Depth: How comprehensive should the documentation be?\n`;
+  yaml += `# Available options (uncomment and modify as needed):\n`;
+  Object.entries(DOCUMENTATION_DEPTH).forEach(([key, depth]) => {
+    yaml += `#   ${key.padEnd(18)} - ${depth.name}: ${depth.description}\n`;
+  });
+  yaml += `documentationDepth: ${input.documentationDepth || ""}\n`;
+  yaml += `\n`;
+
+  // Custom Documentation Rules and Requirements
+  yaml += `# Custom Rules: Define specific documentation generation rules and requirements\n`;
+  yaml += `rules: |\n`;
+  yaml += `  \n\n`;
 
-  // Add target audience
-  yaml += `targetAudience: ${input.targetAudience}\n`;
+  // Target Audience Description
+  yaml += `# Target Audience: Describe your specific target audience and their characteristics\n`;
+  yaml += `targetAudience: |\n`;
+  yaml += `  \n\n`;
 
   // Add language settings
   yaml += `locale: ${input.locale}\n`;

package/agents/load-config.mjs

@@ -1,6 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { parse } from "yaml";
+import { processConfigFields } from "../utils/utils.mjs";
 
 export default async function loadConfig({ config, appUrl }) {
   const configPath = path.join(process.cwd(), config);
@@ -20,9 +21,12 @@ export default async function loadConfig({ config, appUrl }) {
     const parsedConfig = parse(configContent);
 
     if (appUrl) {
-      parsedConfig.appUrl = appUrl;
+      parsedConfig.appUrl = appUrl.includes("://") ? appUrl : `https://${appUrl}`;
     }
 
+    // Parse new configuration fields and convert keys to actual content
+    const processedConfig = processConfigFields(parsedConfig);
+
     return {
       nodeName: "Section",
       locale: "en",
@@ -31,6 +35,7 @@ export default async function loadConfig({ config, appUrl }) {
       outputDir: "./.aigne/doc-smith/output",
       lastGitHead: parsedConfig.lastGitHead || "",
       ...parsedConfig,
+      ...processedConfig,
     };
   } catch (error) {
     console.error(`Error parsing config file: ${error.message}`);
@@ -51,3 +56,5 @@ loadConfig.input_schema = {
     },
   },
 };
+
+loadConfig.task_render_mode = "hide";

package/agents/load-sources.mjs

@@ -259,3 +259,5 @@ loadSources.output_schema = {
     },
   },
 };
+
+loadSources.task_render_mode = "hide";

package/agents/publish-docs.mjs

@@ -2,6 +2,8 @@ import { basename, join } from "node:path";
 import { publishDocs as publishDocsFn } from "@aigne/publish-docs";
 import { getAccessToken } from "../utils/auth-utils.mjs";
 import { loadConfigFromFile, saveValueToConfig } from "../utils/utils.mjs";
+import chalk from "chalk";
+import { DISCUSS_KIT_STORE_URL } from "../utils/constants.mjs";
 
 const DEFAULT_APP_URL = "https://docsmith.aigne.io";
 
@@ -39,6 +41,10 @@ export default async function publishDocs(
     });
 
     if (choice === "custom") {
+      console.log(
+        `${chalk.bold("\n💡 Tips")}\n\n` +
+          `Start here to run your own website:\n${chalk.cyan(DISCUSS_KIT_STORE_URL)}\n`,
+      );
       const userInput = await options.prompts.input({
         message: "Please enter your Discuss Kit platform URL:",
         validate: (input) => {
@@ -98,12 +104,13 @@ export default async function publishDocs(
           "⚠️ Warning: boardId is auto-generated by system, please do not edit manually",
         );
       }
+      const message = `✅ Documentation Published Successfully!`;
+      return {
+        message,
+      };
     }
 
-    const message = `✅ Documentation Published Successfully!`;
-    return {
-      message,
-    };
+    return {};
   } catch (error) {
     return {
       message: `❌ Failed to publish docs: ${error.message}`,

package/agents/reflective-structure-planner.yaml

@@ -1,9 +1,10 @@
 type: team
-name: reflectiveStructurePlanner
+name: structurePlanning
 description: A team of agents that plan the structure of the documentation.
 skills:
   - structure-planning.yaml
 task_title: Plan the structure of the documentation
+task_render_mode: collapse
 reflection:
   reviewer: check-structure-planning-result.yaml
   is_approved: isValid

package/agents/save-output.mjs

@@ -22,3 +22,5 @@ export default async function saveOutput({ savePath, fileName, saveKey, ...rest
     saveOutputPath: filePath,
   };
 }
+
+saveOutput.task_render_mode = "hide";

package/agents/save-single-doc.mjs

@@ -37,3 +37,5 @@ export default async function saveSingleDoc({
 
   return {};
 }
+
+saveSingleDoc.task_render_mode = "hide";

package/agents/structure-planning.yaml

@@ -1,4 +1,4 @@
-name: structurePlanning
+name: structurePlanGenerator
 description: 通用结构规划生成器，支持网站、文档、书籍、演示文稿等多种场景
 instructions:
   url: ../prompts/structure-planning.md

package/agents/transform-detail-datasources.mjs

@@ -23,3 +23,5 @@ export default function transformDetailDatasources({ sourceIds, datasourcesList
 
   return { detailDataSources: contents.join("") };
 }
+
+transformDetailDatasources.task_render_mode = "hide";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doc-smith",
-  "version": "0.2.11",
+  "version": "0.3.1",
   "description": "",
   "publishConfig": {
     "access": "public"
@@ -12,12 +12,12 @@
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
   "license": "MIT",
   "dependencies": {
-    "@aigne/aigne-hub": "^0.4.9",
-    "@aigne/anthropic": "^0.11.0",
-    "@aigne/cli": "^1.34.0",
-    "@aigne/core": "^1.49.0",
-    "@aigne/gemini": "^0.9.0",
-    "@aigne/openai": "^0.11.0",
+    "@aigne/aigne-hub": "^0.6.4",
+    "@aigne/anthropic": "^0.11.4",
+    "@aigne/cli": "^1.37.0",
+    "@aigne/core": "^1.51.0",
+    "@aigne/gemini": "^0.9.4",
+    "@aigne/openai": "^0.11.4",
     "@aigne/publish-docs": "^0.5.4",
     "chalk": "^5.5.0",
     "dompurify": "^3.2.6",

package/prompts/content-detail-generator.md

@@ -52,6 +52,8 @@ parentId: {{parentId}}
 
 <user_rules>
 {{ rules }}
+
+** 使用 {{ locale }} 语言输出内容 **
 </user_rules>
 
 <rules>
@@ -96,5 +98,5 @@ parentId: {{parentId}}
 
 1. 输内容为{{nodeName}}的详细文本。
 2. 直接输出{{nodeName}}内容，不要包含其他信息.
-3. 以用户语言 {{locale}} 输出
+3. 仅参考示例中的风格，**以语言 {{locale}} 输出内容 **
    </output_schema>