czon 0.5.6 → 0.6.0

package/README.md

@@ -5,7 +5,7 @@
 - **C**: **C**ontent oriented | 内容为王，专注内容
 - **Z**: **Z**ero Configuration | 零配置写作，减少打扰
 - **O**: **O**rganic AI-Native | 有机的 AI 原生，深度集成 AI
-- **N**: **N**-shape Energy Curve | N 型能量曲线，介入创作-分发-反馈的各个环节
+- **N**: **N**-shaped Energy Curve | N 型能量曲线，介入创作-分发-反馈的各个环节
 
 [> Website Demo](https://czon.zccz14.com/)
 
@@ -26,9 +26,9 @@ AI 时代下，作为网站内容创作者，我们可以有更智能的内容
 ## 基本功能
 
 1. 🌍 **自动多语言翻译**：使用 AI 进行增量翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的。
-1. 💭 **自动摘要提取**：使用 AI 对原始文本进行内容分析和提取。
-1. 🏷️ **自动标签分类**：使用 AI 对内容进行标签和分类的提取和管理。
-1. 🧭 **智能分类导航**：使用 AI 生成站点地图和导航，源文件的位置不敏感。
+2. 💭 **自动摘要提取**：使用 AI 对原始文本进行内容分析和提取。
+3. 🏷️ **自动标签分类**：使用 AI 对内容进行标签和分类的提取和管理。
+4. 🧭 **智能分类导航**：使用 AI 生成站点地图和导航，源文件的位置不敏感。
 
 ## 静态站点生成 (SSG)
 

package/dist/build/pipeline.js

@@ -73,24 +73,35 @@ async function buildPipeline(options) {
     // 清理输出目录
     await fs.rm(paths_1.CZON_DIST_DIR, { recursive: true, force: true });
     // 确保 .czon/.gitignore 文件
-    await (0, writeFile_1.writeFile)(path.join(paths_1.CZON_DIR, '.gitignore'), 'dist\n');
+    await (0, writeFile_1.writeFile)(path.join(paths_1.CZON_DIR, '.gitignore'), [
+        'dist',
+        'tmp',
+        // 忽略所有非 md 文件: 先忽略所有文件，再排除 Markdown 文件不忽略
+        'src/**/*.*',
+        '!src/**/*.md',
+    ].join('\n'));
     // 扫描源文件
     await (0, scanSourceFiles_1.scanSourceFiles)();
-    // 写入 .raw 目录用于存储原始文件 (非翻译文件)
+    // 链接资源文件 (非翻译文件)
     for (const file of metadata_1.MetaData.files) {
-        try {
-            if (!file.hash)
-                throw new Error(`Missing hash`);
-            const ext = path.extname(file.path);
-            const targetPath = path.join(paths_1.CZON_DIST_RAW_CONTENT_DIR, file.hash + ext);
+        if (file.path.endsWith('.md'))
+            continue; // 仅处理非 Markdown 文件
+        for (const lang of metadata_1.MetaData.options.langs || []) {
+            // 创建硬链接以节省磁盘空间
+            const targetPath = path.join(paths_1.CZON_SRC_DIR, lang, file.path);
             const sourcePath = path.join(paths_1.INPUT_DIR, file.path);
-            console.info(`💾 Writing raw content for file ${file.path} to ${targetPath} ...`);
-            const content = await fs.readFile(sourcePath);
-            await (0, writeFile_1.writeFile)(targetPath, content);
-        }
-        catch (error) {
-            console.warn(`⚠️ Failed to write raw content for file ${file.path}:`, error);
+            console.info(`🔗 Linking file ${file.path} to ${targetPath} ...`);
+            // 确保 link 成功
+            await fs.mkdir(path.dirname(targetPath), { recursive: true });
+            await fs.rm(targetPath, { force: true });
+            await fs.link(sourcePath, targetPath);
         }
+        // 拷贝一份到 __raw__ 目录以供 dist 使用
+        const rawTargetPath = path.join(paths_1.CZON_DIST_RAW_CONTENT_DIR, file.path);
+        const rawSourcePath = path.join(paths_1.INPUT_DIR, file.path);
+        console.info(`📄 Copying raw file ${file.path} to ${rawTargetPath} ...`);
+        await fs.mkdir(path.dirname(rawTargetPath), { recursive: true });
+        await fs.copyFile(rawSourcePath, rawTargetPath);
     }
     // 运行 AI 元数据提取
     await (0, extractMetadataByAI_1.extractMetadataByAI)();

package/dist/build/robots.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateRobotsTxt = void 0;
 const path = __importStar(require("path"));
+const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
 const writeFile_1 = require("../utils/writeFile");
 const generateRobotsTxt = async () => {
@@ -106,7 +107,7 @@ Disallow:
 
 Content-Signal: ai-train=yes, search=yes, ai-input=yes
 
-Sitemap: /sitemap.xml
+${metadata_1.MetaData.options.baseUrl ? `Sitemap: ${path.join(metadata_1.MetaData.options.baseUrl, 'sitemap.xml')}` : ''}
 `;
     const robotsPath = path.join(paths_1.CZON_DIST_DIR, 'robots.txt');
     await (0, writeFile_1.writeFile)(robotsPath, robotsTxtContent);

package/dist/process/category.js

@@ -6,7 +6,6 @@ const openai_1 = require("../services/openai");
 const formatFileForCategoryExtraction = (file) => {
     return [
         //
-        `Hash: ${file.hash}`,
         `Path: ${file.path}`,
         `Metadata: ${JSON.stringify(file.metadata)}`,
     ].join('\n');
@@ -19,14 +18,11 @@ const processExtractCategory = async () => {
         console.info('ℹ️ All files already have categories, skipping category extraction.');
         return;
     }
-    // 这意味着，只要有一个新文件，就需要重新生成所有类别标签
-    // 这倒也合理，因为类别标签是整体相关的
-    // 如果是内容改动导致的呢？
     const markdownFiles = metadata_1.MetaData.files.filter(f => f.path.endsWith('.md') && f.metadata);
     if (verbose) {
         console.info(`📂 Extracting categories for ${markdownFiles.length} markdown files...`);
         for (const file of markdownFiles) {
-            console.info(`   - File: ${file.path} (hash: ${file.hash})`);
+            console.info(`   - File: ${file.path}`);
         }
     }
     // 提取类别标签列表
@@ -46,7 +42,7 @@ const processExtractCategory = async () => {
                 '请优先考虑尚未被分类的文件。',
                 '请以 JSON 格式返回类别标签列表。',
                 '示例输出格式：',
-                '{ "mappings": { "hash1": "tag1", "hash2": "tag2" } }',
+                '{ "mappings": { "path1": "tag1", "path2": "tag2" } }',
             ].join('\n'),
         },
         {
@@ -66,9 +62,9 @@ const processExtractCategory = async () => {
     const json = categories.choices[0].message.content;
     const parsed = JSON.parse(json);
     for (const file of metadata_1.MetaData.files) {
-        const hash = file.hash;
-        if (parsed.mappings[hash]) {
-            file.category = parsed.mappings[hash];
+        const path = file.path;
+        if (parsed.mappings[path]) {
+            file.category = parsed.mappings[path];
         }
     }
     console.info('✅ Extracted categories:', categories.choices[0].message.content);

package/dist/process/enhanceMarkdownSource.js

@@ -10,25 +10,6 @@ const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
 const frontmatter_1 = require("../utils/frontmatter");
 const writeFile_1 = require("../utils/writeFile");
-const replaceInnerLinks = (file, markdownContent) => {
-    let content = markdownContent;
-    for (const link of file.links) {
-        if (URL.canParse(link))
-            continue; // 跳过绝对 URL
-        const targetPath = path_1.default.resolve('/', path_1.default.dirname(file.path), link).slice(1);
-        const targetFile = metadata_1.MetaData.files.find(f => f.path === targetPath);
-        if (!targetFile) {
-            console.warn(`⚠️ Link target not found for ${link} in file ${file.path}`);
-            continue;
-        }
-        // 替换链接 (使用相对链接)
-        const targetLink = `czon://${targetFile.hash}`;
-        // 全局替换链接
-        const linksRegex = new RegExp(`\\]\\(${link.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\)`, 'g');
-        content = content.replace(linksRegex, `](${targetLink})`);
-    }
-    return content;
-};
 /**
  * 存储母语文件到 .czon/src
  */
@@ -41,11 +22,9 @@ async function storeNativeFiles() {
             continue;
         }
         try {
-            if (!file.hash)
-                throw new Error(`Missing hash`);
             if (!file.metadata?.inferred_lang)
                 throw new Error(`Missing inferred language`);
-            const filePath = path_1.default.join(paths_1.CZON_SRC_DIR, file.metadata.inferred_lang, file.hash + '.md');
+            const filePath = path_1.default.join(paths_1.CZON_SRC_DIR, file.metadata.inferred_lang, file.path);
             const originalContent = await (0, promises_1.readFile)(path_1.default.join(paths_1.INPUT_DIR, file.path), 'utf-8');
             // 增强 YAML Frontmatter
             const enhancedContent = (0, frontmatter_1.updateFrontmatter)(originalContent, {
@@ -55,8 +34,8 @@ async function storeNativeFiles() {
                 date: file.metadata.inferred_date,
             });
             // 进行内链接替换, 将相对链接替换为基于 czon://hash 的链接
-            const replacedContent = replaceInnerLinks(file, enhancedContent);
-            await (0, writeFile_1.writeFile)(filePath, replacedContent);
+            // const replacedContent = replaceInnerLinks(file, enhancedContent);
+            await (0, writeFile_1.writeFile)(filePath, enhancedContent);
         }
         catch (error) {
             console.warn(`⚠️ Failed to store native file ${file.path}:`, error);

package/dist/process/processTranslations.js

@@ -45,18 +45,46 @@ 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`);
+    const taskId = crypto.randomUUID();
+    const COMMENT_FILE = (0, path_1.join)(paths_1.CZON_DIR, 'tmp', `comment-${taskId}.txt`);
+    // 清理旧的评论文件
+    await (0, writeFile_1.writeFile)(COMMENT_FILE, '');
+    // 任务定义：每个任务包含提示、代理名称和描述
+    const tasks = [
+        {
+            description: '翻译任务',
+            prompt: `将 ${sourcePath} 翻译成 ${langName} (${targetLang}) 并保存为 ${targetPath}。阅读 ${COMMENT_FILE} (如果存在) 以了解改进建议。`,
+            model: 'deepseek/deepseek-chat',
+        },
+        {
+            description: '翻译质量评估任务',
+            prompt: `请判断 ${targetPath} 是否是 ${sourcePath} 的优秀翻译。评估标准包括准确性、流畅性、术语一致性、文化适应性。输出评估结果和分数（0-10分）。将评审意见保存到 ${COMMENT_FILE} 文件中。如果通过评估，请写入 "Result: Passed"。否则写入 "Result: Failed" 并附上改进建议。`,
+            model: 'deepseek/deepseek-chat',
+        },
+    ];
+    for (let it = 0; it < 10; it++) {
+        for (let i = 0; i < tasks.length; i++) {
+            const task = tasks[i];
+            console.log(`\n=== 任务 ${i + 1}: ${task.description} ===`);
+            console.log(`提示: ${task.prompt}`);
+            await (0, opencode_1.runOpenCode)(task.prompt, { model: task.model });
+            console.log(`✅ 任务 ${i + 1} 完成`);
+        }
+        const reviewFileContent = await (0, promises_1.readFile)(COMMENT_FILE, 'utf-8').catch(() => '');
+        // 检查评审结果是否通过
+        if (reviewFileContent.includes('Result: Passed') &&
+            !reviewFileContent.includes('Result: Failed')) {
+            console.log('\n=== 翻译质量评估通过，所有任务完成 ===');
+            return;
+        }
     }
-    return (0, promises_1.readFile)(targetPath, 'utf-8');
 }
+const translateWithLLMCall = async (sourcePath, targetPath, lang) => {
+    const content = await (0, promises_1.readFile)(sourcePath, 'utf-8');
+    const translatedResponse = await (0, translateMarkdown_1.translateMarkdown)(sourcePath, content, lang);
+    const translatedContent = translatedResponse.choices?.[0].message.content?.trim() || '';
+    await (0, writeFile_1.writeFile)(targetPath, translatedContent);
+};
 /**
  * 处理翻译
  */
@@ -69,7 +97,6 @@ async function processTranslations() {
             return;
         }
         return Promise.all(langs.map(async (lang) => {
-            var _a;
             if (verbose)
                 console.info(`📄 Processing file for translation: ${file.path}`);
             if (!file.metadata) {
@@ -79,8 +106,8 @@ async function processTranslations() {
             if (verbose)
                 console.log(`🌐 Translating to ${lang}...`);
             // 存储翻译文件到 .czon/src/{lang}
-            const sourcePath = path_1.default.join(paths_1.CZON_SRC_DIR, file.metadata.inferred_lang, file.hash + '.md'); // 使用已经加强的母语文件路径
-            const targetPath = path_1.default.join(paths_1.CZON_SRC_DIR, lang, file.hash + '.md');
+            const sourcePath = path_1.default.join(paths_1.CZON_SRC_DIR, file.metadata.inferred_lang, file.path); // 使用已经加强的母语文件路径
+            const targetPath = path_1.default.join(paths_1.CZON_SRC_DIR, lang, file.path);
             try {
                 const content = await (0, promises_1.readFile)(sourcePath, 'utf-8');
                 if (file.metadata.inferred_lang === lang) {
@@ -95,12 +122,11 @@ 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 translationMeta = ((_a = (file.translations ?? (file.translations = {})))[lang] ?? (_a[lang] = {}));
-                translationMeta.content_length = translatedContent.length; // 记录翻译后内容长度
-                translationMeta.token_used = translatedResponse.usage; // 记录 token 使用情况
-                await (0, writeFile_1.writeFile)(targetPath, translatedContent);
+                await translateWithLLMCall(sourcePath, targetPath, lang);
+                // await translateWithOpenCode(sourcePath, targetPath, lang);
+                // const translationMeta = ((file.translations ??= {})[lang] ??= {});
+                // translationMeta.content_length = translatedContent.length; // 记录翻译后内容长度
+                // translationMeta.token_used = translatedResponse.usage; // 记录 token 使用情况
                 // 存储已增强内容的哈希值
                 file.nativeMarkdownHash = hash;
                 if (verbose)

package/dist/process/scanSourceFiles.js

@@ -30,7 +30,7 @@ async function scanSourceFiles() {
     for (const filePath of markdownFiles) {
         queue.push(filePath);
     }
-    const hashes = new Set();
+    const paths = new Set();
     while (queue.length > 0) {
         const relativePath = queue.shift();
         const fullPath = path_1.default.join(paths_1.INPUT_DIR, relativePath);
@@ -51,12 +51,15 @@ async function scanSourceFiles() {
         }
         const contentBuffer = await (0, promises_1.readFile)(fullPath);
         const hash = (0, sha256_1.sha256)(contentBuffer);
-        hashes.add(hash);
-        let meta = metadata_1.MetaData.files.find(f => f.hash === hash);
+        paths.add(relativePath);
+        let meta = metadata_1.MetaData.files.find(f => f.path === relativePath);
         if (!meta) {
             meta = { hash, path: relativePath, links: [] };
             metadata_1.MetaData.files.push(meta);
         }
+        else {
+            meta.hash = hash;
+        }
         // 处理 Markdown 文件
         if (fullPath.endsWith('.md')) {
             const content = contentBuffer.toString('utf-8');
@@ -76,7 +79,7 @@ async function scanSourceFiles() {
         }
     }
     // 移除不再存在的文件元数据
-    metadata_1.MetaData.files = metadata_1.MetaData.files.filter(f => hashes.has(f.hash));
+    metadata_1.MetaData.files = metadata_1.MetaData.files.filter(f => paths.has(f.path));
     // 按路径降序排序 (通常外层目录优先)
     metadata_1.MetaData.files.sort((a, b) => 
     // 第一级按目录排序

package/dist/process/template.js

@@ -56,17 +56,17 @@ const spiderStaticSiteGenerator = async () => {
     }
     const isVisited = new Set();
     const contents = [];
-    // 预加载所有 Markdown 内容
+    // 预加载所有 Markdown 内容，因为 React 内部异步渲染比较麻烦
     for (const file of metadata_1.MetaData.files) {
         if (!file.path.endsWith('.md'))
             continue;
         for (const lang of metadata_1.MetaData.options.langs || []) {
-            const markdown = await fs.readFile(path.join(paths_1.CZON_SRC_DIR, lang, file.hash + '.md'), 'utf-8');
+            const markdown = await fs.readFile(path.join(paths_1.CZON_SRC_DIR, lang, file.path), 'utf-8');
             const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(markdown);
-            const markdownHtml = (0, convertMarkdownToHtml_1.convertMarkdownToHtml)(body);
+            const markdownHtml = (0, convertMarkdownToHtml_1.convertMarkdownToHtml)(file.path, lang, body);
             contents.push({
                 lang,
-                hash: file.hash,
+                file,
                 body: markdownHtml,
                 frontmatter,
             });
@@ -83,42 +83,6 @@ const spiderStaticSiteGenerator = async () => {
                 site: metadata_1.MetaData,
                 contents,
             });
-        // 内部链接: czon://hash 格式的链接替换为 /{lang}/{slug}.html
-        html = html.replace(/href="([^"]+)"/g, (match, link) => {
-            console.info(`🕷️ Processing link: ${link} in path: ${currentPath}`);
-            if (link.startsWith('czon://')) {
-                const hash = link.replace('czon://', '');
-                console.info(`   🔗 Replacing internal link for hash: ${hash}`);
-                const file = metadata_1.MetaData.files.find(f => f.hash === hash);
-                if (!file || !file.metadata) {
-                    console.warn(`⚠️ Link target not found for hash ${hash} in path ${currentPath}`);
-                    return match;
-                }
-                const slug = file.metadata.slug;
-                const targetPath = path.resolve('/', path.dirname(currentPath), `${slug}.html`);
-                const href = path.relative(path.dirname(currentPath), targetPath);
-                return `href="${href}"`;
-            }
-            return match;
-        });
-        // 替换 src 中的 czon://hash 链接
-        html = html.replace(/src="([^"]+)"/g, (match, link) => {
-            console.info(`🕷️ Processing src link: ${link} in path: ${currentPath}`);
-            if (link.startsWith('czon://')) {
-                const hash = link.replace('czon://', '');
-                console.info(`   🔗 Replacing internal src link for hash: ${hash}`);
-                const file = metadata_1.MetaData.files.find(f => f.hash === hash);
-                if (!file) {
-                    console.warn(`⚠️ Src link target not found for hash ${hash} in path ${currentPath}`);
-                    return match;
-                }
-                const ext = path.extname(file.path);
-                const targetPath = path.join(paths_1.CZON_DIST_RAW_CONTENT_DIR, file.hash + ext);
-                const href = path.relative(path.join(paths_1.CZON_DIST_DIR, path.dirname(currentPath)), targetPath);
-                return `src="${href}"`;
-            }
-            return match;
-        });
         console.info(`🕷️ Crawled ${currentPath}`);
         // 收集 URL 用于 sitemap
         const urlMatch = currentPath.match(/^\/([^/]+)\/(.+)\.html$/);
@@ -143,7 +107,11 @@ const spiderStaticSiteGenerator = async () => {
             const link = match[1];
             if (URL.canParse(link))
                 continue; // 跳过绝对 URL
+            if (link.startsWith('#'))
+                continue; // 跳过页面内锚点链接
             const resolvedPath = path.resolve('/', path.dirname(currentPath), link);
+            if (resolvedPath.startsWith('/__raw__/'))
+                continue; // 跳过原始内容目录
             console.info(`   ➕ Found link: ${link} -> ${resolvedPath} (${isVisited.has(resolvedPath) ? 'visited' : 'new'})`);
             if (!isVisited.has(resolvedPath)) {
                 queue.push(resolvedPath);

package/dist/services/opencode.js

@@ -1,86 +1,125 @@
 "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");
+function parseModelString(model) {
+    const parts = model.split('/');
+    if (parts.length === 2) {
+        return { providerID: parts[0], modelID: parts[1] };
+    }
+    // Default provider if no slash
+    return { providerID: 'opencode', modelID: model };
+}
 /**
- * Run OpenCode CLI to generate AI response for a given prompt.
+ * Run OpenCode 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.
+ * This function uses the OpenCode SDK to connect to a running OpenCode server.
+ * Assumes an OpenCode server is already running externally.
  *
  * @param prompt - The prompt to send to OpenCode
  * @param options - Optional configuration
- * @returns Promise resolving to the raw AI response string
+ * @returns Promise that resolves when the operation completes
  *
  * @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}` }
- * ]);
+ * The AI response is handled internally by OpenCode. This function does not
+ * return the response content. Any output files or results are managed by
+ * the OpenCode agent or session directly.
  */
 const runOpenCode = (prompt, options) => {
     const model = options?.model ?? 'opencode/gpt-5-nano';
     const signal = options?.signal;
-    const cwd = options?.cwd;
+    const cwd = options?.cwd || process.cwd();
+    const agent = options?.agent;
     const verbose = metadata_1.MetaData.options.verbose;
     if (verbose) {
-        console.info(`🛠️  Running OpenCode with model: ${model}, prompt: ${prompt}`);
+        console.info(`🛠️  Running OpenCode with model: ${model}, agent: ${agent || 'none'}, 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', 'inherit'],
-            cwd,
-            env: Object.assign({
-                OPENCODE_PERMISSION: JSON.stringify({ bash: 'allow', read: 'allow', write: 'allow' }),
-            }, process.env),
-        });
-        let output = '';
-        proc.stdout.on('data', data => {
-            const chunk = data.toString();
-            output += chunk;
-            if (verbose) {
-                console.info('OpenCode stdout chunk:', chunk);
-            }
-        });
-        proc.on('error', err => {
-            reject(new Error(`Failed to start OpenCode process: ${err.message}`));
-        });
-        proc.on('close', code => {
-            if (code === 0) {
-                resolve(output.trim());
+    return new Promise(async (resolve, reject) => {
+        const agentInfo = agent ? ` with agent ${agent}` : '';
+        console.info(`🚀 Running OpenCode with model ${model}${agentInfo}`);
+        let cancelled = false;
+        const cleanup = () => {
+            if (signal) {
+                signal.removeEventListener('abort', onAbort);
             }
-            else {
-                reject(new Error(`OpenCode process exited with code ${code}`));
-            }
-        });
+        };
+        const onAbort = () => {
+            cancelled = true;
+            cleanup();
+            reject(new Error('OpenCode execution was aborted'));
+        };
         if (signal) {
-            signal.addEventListener('abort', () => {
-                proc.kill('SIGTERM');
-                reject(new Error('OpenCode execution was aborted'));
+            signal.addEventListener('abort', onAbort);
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+        }
+        try {
+            const { createOpencodeClient } = await import('@opencode-ai/sdk');
+            const baseUrl = 'http://localhost:4096';
+            const client = createOpencodeClient({
+                baseUrl: baseUrl,
+                directory: cwd,
             });
+            const modelObj = parseModelString(model);
+            const session = await client.session.create();
+            if (!session.data?.id)
+                throw new Error('Failed to create OpenCode session', { cause: session.error });
+            options?.signal?.addEventListener('abort', () => {
+                console.info(`🛑 Aborting OpenCode session ${session.data.id}...`);
+                client.session.abort({
+                    path: {
+                        id: session.data.id,
+                    },
+                });
+            });
+            const directoryBase64 = Buffer.from(session.data.directory).toString('base64');
+            const url = `${baseUrl}/${directoryBase64}/session/${session.data.id}`;
+            console.info('OpenCode Session Created', url);
+            const response = await client.session.prompt({
+                path: {
+                    id: session.data.id,
+                },
+                body: {
+                    model: modelObj,
+                    agent,
+                    parts: [
+                        {
+                            type: 'text',
+                            text: prompt,
+                        },
+                    ],
+                },
+                query: {
+                    directory: cwd,
+                },
+                signal,
+            });
+            if (cancelled) {
+                throw new Error('Cancelled');
+            }
+            if (response.error) {
+                throw new Error(`OpenCode API error: ${JSON.stringify(response.error)}`);
+            }
+            // await client.session.delete({
+            //   path: {
+            //     id: session.data.id,
+            //   },
+            // });
+            cleanup();
+            resolve();
+        }
+        catch (err) {
+            if (cancelled) {
+                return;
+            }
+            cleanup();
+            reject(new Error(`OpenCode SDK error: ${err instanceof Error ? err.message : String(err)}. Make sure an OpenCode server is running.`));
         }
     });
 };

package/dist/ssg/ContentPage.js

@@ -21,7 +21,7 @@ const ContentPage = props => {
     const date = frontmatter.date || '--';
     const tags = frontmatter.tags || [];
     const category = props.file.category;
-    const relatedContents = props.ctx.site.files.filter(f => f.category === category && f.hash !== props.file.hash);
+    const relatedContents = props.ctx.site.files.filter(f => f.category === category && f.path !== props.file.path);
     // 查找指向当前文章的其他文章
     const thisPath = (0, node_path_1.resolve)('/', props.file.path);
     const referencedFiles = props.ctx.site.files.filter(f => f.links.some(link => (0, node_path_1.resolve)('/', (0, node_path_1.dirname)(f.path), link) === thisPath));
@@ -56,15 +56,15 @@ const ContentPage = props => {
                         relatedContents.length > 0 && (react_1.default.createElement(react_1.default.Fragment, null,
                             react_1.default.createElement("h2", null, "See Also"),
                             react_1.default.createElement("ul", null, relatedContents.map(f => {
-                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.hash === f.hash);
-                                return (react_1.default.createElement("li", { key: f.hash },
+                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === f);
+                                return (react_1.default.createElement("li", { key: f.path },
                                     react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theContent?.frontmatter.title)));
                             })))),
                         referencedFiles.length > 0 && (react_1.default.createElement(react_1.default.Fragment, null,
                             react_1.default.createElement("h2", null, "Referenced By"),
                             react_1.default.createElement("ul", null, referencedFiles.map(f => {
-                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.hash === f.hash);
-                                return (react_1.default.createElement("li", { key: f.hash },
+                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === f);
+                                return (react_1.default.createElement("li", { key: f.path },
                                     react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theContent?.frontmatter.title)));
                             }))))),
                     react_1.default.createElement("footer", { className: "footer" },

package/dist/ssg/IndexPage.js

@@ -64,8 +64,7 @@ const IndexPage = props => {
                                 ")"))));
                         }))),
                     react_1.default.createElement("div", null, contents.map(file => {
-                        const metadata = file.metadata;
-                        return (react_1.default.createElement("div", { className: "mb-6", key: file.hash },
+                        return (react_1.default.createElement("div", { className: "mb-6", key: file.path },
                             react_1.default.createElement(ContentMeta_1.ContentMeta, { ctx: props.ctx, file: file, lang: props.lang })));
                     })),
                     react_1.default.createElement("footer", null,

package/dist/ssg/app.js

@@ -28,7 +28,7 @@ const App = (props) => {
         // 渲染文章页面
         for (const file of props.site.files) {
             if (props.path === `/${lang}/${file.metadata?.slug}.html`) {
-                const theContent = props.contents.find(c => c.lang === lang && c.hash === file.hash);
+                const theContent = props.contents.find(c => c.lang === lang && c.file === file);
                 if (!theContent)
                     return react_1.default.createElement(RedirectPage_1.RedirectPage, { from: props.path, to: `/index.html` });
                 return react_1.default.createElement(ContentPage_1.ContentPage, { ctx: props, file: file, lang: lang, content: theContent });

package/dist/ssg/components/ContentMeta.js

@@ -7,7 +7,7 @@ exports.ContentMeta = void 0;
 const react_1 = __importDefault(require("react"));
 const TagList_1 = require("./TagList");
 const ContentMeta = props => {
-    const content = props.ctx.contents.find(c => c.hash === props.file.hash && c.lang === props.lang);
+    const content = props.ctx.contents.find(c => c.file === props.file && c.lang === props.lang);
     const frontmatter = content?.frontmatter || {};
     const title = frontmatter.title;
     const summary = frontmatter.summary;

package/dist/ssg/components/Navigator.js

@@ -22,10 +22,10 @@ const Navigator = props => {
             react_1.default.createElement("li", { className: "nav-item font-bold", key: categoryKey }, category || '--'),
             filesInCategory.map(file => {
                 const link = file.metadata.slug + '.html';
-                const isActive = props.file.hash === file.hash;
-                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.hash === file.hash);
+                const isActive = props.file === file;
+                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === file);
                 const theTitle = theContent?.frontmatter?.title || file.metadata.title || '(no title)';
-                return (react_1.default.createElement("li", { className: "nav-item", key: file.hash },
+                return (react_1.default.createElement("li", { className: "nav-item", key: file.path },
                     react_1.default.createElement("a", { href: link, className: `nav-link ${isActive ? 'active' : ''}` },
                         theTitle,
                         " ",

package/dist/utils/convertMarkdownToHtml.js

@@ -8,6 +8,8 @@ const highlight_js_1 = __importDefault(require("highlight.js"));
 const marked_1 = require("marked");
 const marked_katex_extension_1 = __importDefault(require("marked-katex-extension"));
 const marked_footnote_1 = __importDefault(require("marked-footnote"));
+const metadata_1 = require("../metadata");
+const path_1 = require("path");
 // 辅助函数：转义 HTML 特殊字符
 function escapeHtml(unsafe) {
     return unsafe
@@ -24,10 +26,67 @@ marked_1.marked.use((0, marked_footnote_1.default)());
  * @param mdContent Markdown 内容字符串
  * @returns 转换后的 HTML 字符串
  */
-const convertMarkdownToHtml = (mdContent) => {
+const convertMarkdownToHtml = (path, lang, mdContent) => {
+    const sourceFileMeta = metadata_1.MetaData.files.find(f => f.path === path);
     // 创建自定义渲染器
     const renderer = new marked_1.marked.Renderer();
     const originalCodeRenderer = renderer.code;
+    const originalLinkRenderer = renderer.link;
+    renderer.link = function (link) {
+        console.info(`🔗 #### Processing link in Markdown: ${link.href} in file: ${path}`);
+        if (URL.canParse(link.href)) {
+            // 保持原有链接渲染行为
+            return originalLinkRenderer.call(this, link);
+        }
+        if (!sourceFileMeta?.metadata?.slug) {
+            console.warn(`⚠️ Source file metadata slug not found for path ${path}`);
+            return originalLinkRenderer.call(this, link);
+        }
+        const sourceFileHtmlPath = (0, path_1.resolve)('/', lang, `${sourceFileMeta.metadata.slug}.html`);
+        const resolvedPath = (0, path_1.join)((0, path_1.dirname)(path), link.href);
+        const file = metadata_1.MetaData.files.find(f => f.path === resolvedPath);
+        if (!file) {
+            console.warn(`⚠️ Link target not found for path ${resolvedPath} in file ${path}`);
+            return originalLinkRenderer.call(this, link);
+        }
+        if (link.href.endsWith('.md')) {
+            if (!file.metadata?.slug) {
+                console.warn(`⚠️ Missing slug metadata for file ${file.path}`);
+                return originalLinkRenderer.call(this, link);
+            }
+            const slug = file.metadata.slug;
+            const targetPath = (0, path_1.resolve)('/', lang, `${slug}.html`);
+            // 将 .md 链接转换为对应的 HTML 文件链接
+            const href = (0, path_1.relative)((0, path_1.dirname)(sourceFileHtmlPath), targetPath);
+            const modifiedLink = {
+                ...link,
+                href,
+            };
+            return originalLinkRenderer.call(this, modifiedLink);
+        }
+        else {
+            console.info(` 🔗 #### Processing resource link in Markdown: ${link.href} in file: ${path}`);
+            // 其他资源链接到 __raw__ 目录
+            const resourcePath = (0, path_1.resolve)('/', (0, path_1.dirname)(path), link.href);
+            const href = (0, path_1.relative)((0, path_1.dirname)(sourceFileHtmlPath), (0, path_1.join)('/', '__raw__', resourcePath));
+            console.info(`     ➡️ Converted resource link to: ${href}`);
+            const modifiedLink = {
+                ...link,
+                href: href,
+            };
+            return originalLinkRenderer.call(this, modifiedLink);
+        }
+    };
+    const originalImageRenderer = renderer.image;
+    renderer.image = function (image) {
+        console.info(`🖼️ #### Processing image in Markdown: ${image.href} in file: ${path}`);
+        if (URL.canParse(image.href)) {
+            // 保持原有图片渲染行为
+            return originalImageRenderer.call(this, image);
+        }
+        const imagePath = (0, path_1.join)((0, path_1.dirname)(path), image.href);
+        return `<img src="${(0, path_1.join)('..', '__raw__', imagePath)}" alt="${image.text}" />`;
+    };
     // 重写代码块渲染器以支持 Mermaid - 使用 any 类型绕过类型检查
     renderer.code = function (code, language, isEscaped) {
         // 在 marked 17+ 中，code 参数是一个对象，包含 text 和 lang 属性

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "czon",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "CZone - AI enhanced Markdown content engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,6 +51,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@opencode-ai/sdk": "^1.1.34",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "chokidar": "^5.0.0",

package/tsconfig.json

@@ -2,8 +2,9 @@
   "compilerOptions": {
     "jsx": "react",
     "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2020", "ESNext"],
     "outDir": "./dist",
     "rootDir": "./src",
     "strict": true,