czon 0.4.4 → 0.5.0

package/agents/czon-markdown-translator.md

@@ -0,0 +1,90 @@
+---
+description: >-
+  Use this agent when you need to translate markdown files from one language to
+  another while preserving the markdown formatting structure. Examples:
+
+
+  - <example>
+      Context: User wants to translate documentation files from English to Chinese.
+      user: "Translate the README.md file to Japanese, preserving all headers, links, and code blocks"
+      assistant: "I'll use the czon-markdown-translator agent to handle this translation task"
+      <commentary>
+      Since the user explicitly asked to translate a markdown file (README.md) while preserving formatting, the czon-markdown-translator agent is the appropriate choice.
+      </commentary>
+    </example>
+  - <example>
+      Context: User needs to localize technical documentation for a new market.
+      user: "Please translate all .md files in the docs/ directory to German"
+      assistant: "The czon-markdown-translator agent can read and translate the markdown files while maintaining proper structure"
+      <commentary>
+      When the user mentions translating multiple markdown files, this agent should be used to ensure consistent formatting preservation.
+      </commentary>
+    </example>
+  - <example>
+      Context: User wants to translate a markdown blog post.
+      user: "Convert this markdown article to Spanish, keeping all formatting intact"
+      assistant: "Let me invoke the czon-markdown-translator agent to handle the translation while preserving markdown syntax"
+      <commentary>
+      When the user emphasizes preserving formatting during translation, this specialized agent is ideal.
+      </commentary>
+    </example>
+mode: all
+---
+
+You are a specialized Markdown Translator with expertise in technical documentation localization. Your primary responsibility is to accurately translate markdown files while meticulously preserving their structural integrity.
+
+## Core Responsibilities
+
+1. **Read and Parse Files**: Load markdown files from specified paths, understanding their full structure including frontmatter, headers, lists, code blocks, tables, links, images, and inline formatting.
+
+2. **Translate Content**: Translate the textual content to the target language while:
+   - Preserving all markdown syntax (headings with #, bold \*_, italic _, code blocks with ```, etc.)
+   - Maintaining links, image references, and their alt text
+   - Keeping tables intact and translating only cell content
+   - Preserving code examples, file paths, and command snippets untranslated
+   - Handling frontmatter metadata appropriately (translate values only, keep keys)
+
+3. **Handle Special Content**:
+   - **Code blocks**: Never translate content inside triple-backtick blocks
+   - **Inline code**: Keep backtick-enclosed text untranslated
+   - **Links**: Translate link text but preserve URLs
+   - **Images**: Translate alt text but preserve image paths
+   - **URLs and paths**: Keep untranslated (e.g., `/api/users`, `https://example.com`)
+   - **Frontmatter**: Translate string values, preserve boolean/numeric values and keys
+
+4. **Output Management**: Write translated content to the specified output file, maintaining UTF-8 encoding and original line endings where possible.
+
+## Translation Quality Standards
+
+- Maintain consistent terminology throughout the document
+- Preserve the original tone (technical, casual, formal, etc.)
+- Ensure translations are natural and idiomatic in the target language
+- Keep headings and subheadings properly nested and meaningful
+- For list items, ensure parallel structure is maintained
+
+## Workflow
+
+1. Confirm the source file path and target language with the user if unclear
+2. Read and parse the complete markdown file
+3. Create a translation strategy (identify sections, special content types)
+4. Translate section by section, marking translated content
+5. Verify markdown syntax integrity after translation
+6. Write to output file or return translated content as requested
+
+## Error Handling
+
+- If a file doesn't exist or cannot be read, report the error clearly
+- If the target language is ambiguous, ask for clarification
+- If encoding issues are detected, attempt to resolve or report
+- If markdown parsing fails, identify the problematic section
+
+## Output Format
+
+When completing the task:
+
+- Confirm the file was translated successfully
+- Report the character/word count if relevant
+- Note any sections that were preserved (code blocks, etc.)
+- Suggest any follow-up actions if needed (proofreading, formatting review)
+
+Remember: Your goal is to produce a translated markdown file that looks like it was originally written in the target language, with all formatting intact and functional.

package/dist/build/pipeline.js

@@ -44,6 +44,7 @@ const extractMetadataByAI_1 = require("../process/extractMetadataByAI");
 const processTranslations_1 = require("../process/processTranslations");
 const scanSourceFiles_1 = require("../process/scanSourceFiles");
 const template_1 = require("../process/template");
+const opencode_1 = require("../services/opencode");
 const writeFile_1 = require("../utils/writeFile");
 const robots_1 = require("./robots");
 const sitemap_1 = require("./sitemap");
@@ -65,6 +66,8 @@ async function validateConfig(options) {
  * 构建管道（函数组合）
  */
 async function buildPipeline(options) {
+    // 安装 OpenCode 代理到全局目录
+    await (0, opencode_1.installAgentsToGlobal)();
     // 验证配置
     await validateConfig(options);
     // 清理输出目录

package/dist/findEntries.js

@@ -24,7 +24,7 @@ const findMarkdownEntries = async (dirPath) => {
         const files = stdout
             .split('\0') // 按空字符分割文件名
             .filter(line => line.trim() !== '') // 移除空行
-            .filter(file => !file.startsWith('.czon')) // 过滤掉.czon目录下的文件
+            .filter(file => !file.startsWith('.')) // 过滤掉隐藏目录下的文件
             .filter(file => file.endsWith('.md')); // 只保留.md文件
         return files;
     }

package/dist/paths.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CZON_META_PATH = exports.CZON_SRC_DIR = exports.CZON_DIST_RAW_CONTENT_DIR = exports.CZON_DIST_DIR = exports.CZON_DIR = exports.INPUT_DIR = void 0;
+exports.LOCAL_OPENCODE_AGENT_DIR = exports.GLOBAL_OPENCODE_AGENT_DIR = exports.CZON_META_PATH = exports.CZON_SRC_DIR = exports.CZON_DIST_RAW_CONTENT_DIR = exports.CZON_DIST_DIR = exports.CZON_DIR = exports.INPUT_DIR = void 0;
+const os_1 = require("os");
 const path_1 = require("path");
 exports.INPUT_DIR = process.cwd();
 exports.CZON_DIR = (0, path_1.join)(process.cwd(), '.czon');
@@ -8,4 +9,9 @@ exports.CZON_DIST_DIR = (0, path_1.join)(exports.CZON_DIR, 'dist');
 exports.CZON_DIST_RAW_CONTENT_DIR = (0, path_1.join)(exports.CZON_DIST_DIR, '__raw__');
 exports.CZON_SRC_DIR = (0, path_1.join)(exports.CZON_DIR, 'src');
 exports.CZON_META_PATH = (0, path_1.join)(exports.CZON_DIR, 'meta.json');
+/**
+ * ~/.config/opencode/agents/
+ */
+exports.GLOBAL_OPENCODE_AGENT_DIR = (0, path_1.join)((0, os_1.homedir)(), '.config', 'opencode', 'agents');
+exports.LOCAL_OPENCODE_AGENT_DIR = (0, path_1.join)(__dirname, '..', 'agents');
 //# sourceMappingURL=paths.js.map

package/dist/process/processTranslations.js

@@ -1,16 +1,61 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processTranslations = processTranslations;
 const promises_1 = require("fs/promises");
-const path_1 = __importDefault(require("path"));
-const translateMarkdown_1 = require("../ai/translateMarkdown");
+const path_1 = __importStar(require("path"));
+const languages_1 = require("../languages");
 const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
+const opencode_1 = require("../services/opencode");
 const sha256_1 = require("../utils/sha256");
 const writeFile_1 = require("../utils/writeFile");
+async function translateWithOpenCode(sourcePath, targetPath, targetLang, options) {
+    const langName = languages_1.LANGUAGE_NAMES[targetLang];
+    const prompt = `将 ${sourcePath} 翻译成 ${langName} (${targetLang}) 并保存到 ${targetPath}。`;
+    await (0, opencode_1.runOpenCode)(prompt, {
+        ...options,
+        cwd: (0, path_1.dirname)(sourcePath),
+        agent: 'czon-markdown-translator',
+    });
+    const exists = await (0, promises_1.access)(targetPath).then(() => true, () => false);
+    if (!exists) {
+        throw new Error(`OpenCode translation failed: ${targetPath} was not created`);
+    }
+    return (0, promises_1.readFile)(targetPath, 'utf-8');
+}
 /**
  * 处理翻译
  */
@@ -49,11 +94,9 @@ async function processTranslations() {
                         console.info(`ℹ️ Content unchanged for ${file.path}, skipping translation.`);
                     return;
                 }
-                const translatedResponse = await (0, translateMarkdown_1.translateMarkdown)(sourcePath, content, lang);
-                const translatedContent = translatedResponse.choices?.[0].message.content?.trim() || '';
+                const translatedContent = await translateWithOpenCode(sourcePath, targetPath, lang);
                 const translationMeta = ((_a = (file.translations ?? (file.translations = {})))[lang] ?? (_a[lang] = {}));
-                translationMeta.content_length = translatedContent.length; // 记录翻译后内容长度
-                translationMeta.token_used = translatedResponse.usage; // 记录 token 使用情况
+                translationMeta.content_length = translatedContent.length;
                 await (0, writeFile_1.writeFile)(targetPath, translatedContent);
                 // 存储已增强内容的哈希值
                 file.nativeMarkdownHash = hash;

package/dist/services/opencode.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installAgentsToGlobal = exports.runOpenCode = void 0;
+const child_process_1 = require("child_process");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const metadata_1 = require("../metadata");
+const paths_1 = require("../paths");
+const writeFile_1 = require("../utils/writeFile");
+/**
+ * Run OpenCode CLI to generate AI response for a given prompt.
+ *
+ * This function spawns the OpenCode CLI process and captures its output.
+ * It serves as a fallback when OpenAI API is not available.
+ *
+ * @param prompt - The prompt to send to OpenCode
+ * @param options - Optional configuration
+ * @returns Promise resolving to the raw AI response string
+ *
+ * @important
+ * The returned string has **no guaranteed format**. It may be plain text, JSON,
+ * Markdown, or any other format depending on the model and context.
+ * Do NOT parse or assume a specific structure. Treat it as raw content to be
+ * processed by downstream AI components (e.g., pass to another LLM call,
+ * write to a temp file for a Supervisor Agent, etc.).
+ *
+ * @example
+ * const response = await runOpenCode('Explain closures in JavaScript');
+ * // response format is unpredictable - pass it to another AI for processing
+ * const analyzed = await completeMessages([
+ *   { role: 'user', content: `Analyze this AI output:\n${response}` }
+ * ]);
+ */
+const runOpenCode = (prompt, options) => {
+    const model = options?.model ?? 'opencode/minimax-m2.1-free';
+    const signal = options?.signal;
+    const cwd = options?.cwd;
+    const verbose = metadata_1.MetaData.options.verbose;
+    if (verbose) {
+        console.info(`🛠️  Running OpenCode with model: ${model}, prompt: ${prompt}`);
+    }
+    return new Promise((resolve, reject) => {
+        console.info(`🚀 Running OpenCode with model ${model}`);
+        const proc = (0, child_process_1.spawn)('npx', [
+            'opencode-ai',
+            'run',
+            prompt,
+            '--model',
+            model,
+            ...(options?.agent ? ['--agent', options.agent] : []),
+            '--format',
+            'json',
+        ], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            cwd,
+        });
+        let output = '';
+        proc.stdout.on('data', data => {
+            const chunk = data.toString();
+            output += chunk;
+            if (verbose) {
+                console.info('OpenCode stdout chunk:', chunk);
+            }
+        });
+        proc.stderr.on('data', data => {
+            console.error('OpenCode stderr:', data.toString());
+        });
+        proc.on('error', err => {
+            reject(new Error(`Failed to start OpenCode process: ${err.message}`));
+        });
+        proc.on('close', code => {
+            if (code === 0) {
+                resolve(output.trim());
+            }
+            else {
+                reject(new Error(`OpenCode process exited with code ${code}`));
+            }
+        });
+        if (signal) {
+            signal.addEventListener('abort', () => {
+                proc.kill('SIGTERM');
+                reject(new Error('OpenCode execution was aborted'));
+            });
+        }
+    });
+};
+exports.runOpenCode = runOpenCode;
+const installAgentsToGlobal = async () => {
+    const { verbose } = metadata_1.MetaData.options;
+    const installedAgents = await (0, promises_1.readdir)(paths_1.LOCAL_OPENCODE_AGENT_DIR)
+        .then(files => files.filter(f => f.startsWith('czon-')))
+        .catch(() => []);
+    // 3. Copy local agents from .opencode/agent to global directory
+    for (const agentFile of installedAgents) {
+        if (verbose) {
+            console.log(`📁 Installing OpenCode agent: ${agentFile} to global directory...`);
+        }
+        await (0, writeFile_1.writeFile)((0, path_1.join)(paths_1.GLOBAL_OPENCODE_AGENT_DIR, agentFile), await (0, promises_1.readFile)((0, path_1.join)(paths_1.LOCAL_OPENCODE_AGENT_DIR, agentFile)));
+    }
+    if (verbose) {
+        console.log(`✅ Installed ${installedAgents.length} OpenCode agents to global directory.`);
+    }
+};
+exports.installAgentsToGlobal = installAgentsToGlobal;
+//# sourceMappingURL=opencode.js.map

package/dist/services/opencode.test.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const opencode_1 = require("./opencode");
+(0, node_test_1.describe)('runOpenCode', () => {
+    (0, node_test_1.it)('should return response from OpenCode', async () => {
+        const result = await (0, opencode_1.runOpenCode)('hello');
+        node_assert_1.default.ok(result.length > 0, 'Should return non-empty response');
+    });
+    (0, node_test_1.it)('should use default model when not specified', async () => {
+        const result = await (0, opencode_1.runOpenCode)('test prompt');
+        node_assert_1.default.ok(typeof result === 'string');
+    });
+    (0, node_test_1.it)('should accept custom model in options', async () => {
+        const options = { model: 'opencode/glm-4.7-free' };
+        const result = await (0, opencode_1.runOpenCode)('test', options);
+        node_assert_1.default.ok(typeof result === 'string');
+    });
+    (0, node_test_1.it)('should handle abort signal', async () => {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), 10);
+        await node_assert_1.default.rejects(async () => await (0, opencode_1.runOpenCode)('long running prompt', { signal: controller.signal }), /OpenCode execution was aborted/);
+    });
+    (0, node_test_1.it)('should accept cwd option', async () => {
+        const options = { cwd: '/tmp' };
+        const result = await (0, opencode_1.runOpenCode)('test', options);
+        node_assert_1.default.ok(typeof result === 'string');
+    });
+});
+//# sourceMappingURL=opencode.test.js.map

package/dist/ssg/IndexPage.js

@@ -23,9 +23,7 @@ const IndexPage = props => {
     return (react_1.default.createElement("html", null,
         react_1.default.createElement("head", null,
             react_1.default.createElement("meta", { charSet: "UTF-8" }),
-            react_1.default.createElement("title", null,
-                "Index of ",
-                props.lang),
+            react_1.default.createElement("title", null, `Index of ${props.lang.toString()}`),
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("meta", { name: "description", content: `Index page for language ${props.lang}` }),
             react_1.default.createElement("style", null, style_1.style),

package/dist/ssg/RootPage.js

@@ -24,7 +24,7 @@ const RootPage = props => {
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("title", null, "CZON Multilingual Site Navigator"),
             react_1.default.createElement("meta", { name: "description", content: "Select your preferred language to explore our content." }),
-            props.ctx.site.options.langs.map(lang => (react_1.default.createElement("link", { rel: "alternate", hrefLang: lang, href: `${lang}/index.html` }))),
+            props.ctx.site.options.langs.map(lang => (react_1.default.createElement("link", { key: lang, rel: "alternate", hrefLang: lang, href: `${lang}/index.html` }))),
             react_1.default.createElement("link", { rel: "alternate", hrefLang: "x-default", href: `${props.ctx.site.options.langs[0]}/index.html` }),
             react_1.default.createElement("script", { dangerouslySetInnerHTML: {
                     __html: `

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "czon",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "CZone - AI enhanced Markdown content engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",