czon 0.5.1 → 0.5.3

package/.opencode/skills/article-summarizer/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: article-summarizer
+description: 'Guide for generating multi-style article summaries from Markdown files in a repository. Use when user requests article summarization, multi-perspective analysis, or content summarization with different writing styles. Triggers on keywords: article summary, markdown summary, multi-style summary, SUMMARY directory, git ls-files, 7 styles.'
+---
+
+# 文章总结器
+
+## 概述
+
+本skill指导代理从仓库中的Markdown文章生成全面的多风格摘要。它提供一个结构化工作流程：清空SUMMARY目录、通过git命令识别目标Markdown文件、读取所有.md文件（排除.czon）、并以7种不同写作风格生成摘要，附带正确的引用规则。
+
+## 工作流程
+
+### 1. 准备SUMMARY目录
+
+首先，确保SUMMARY目录存在并清空之前的内容：
+
+```bash
+mkdir -p SUMMARY
+rm -rf SUMMARY/*
+```
+
+### 2. 识别目标Markdown文件
+
+使用以下git命令列出仓库中的所有Markdown文件（已跟踪和未跟踪），排除.czon目录中的文件：
+
+```bash
+git ls-files --others --cached --exclude-standard -z -x ".czon" | tr '\0' '\n' | grep -v ".czon" | grep ".md$"
+```
+
+将输出捕获为文件路径列表。验证每个文件存在且可读。
+
+### 3. 读取和处理Markdown内容
+
+对于每个Markdown文件：
+
+- 使用`Read`工具读取完整内容
+- 提取元数据：标题（第一个H1）、修改日期（git log）、字数统计
+- 解析结构：标题、链接、代码块
+- 注意指向其他Markdown文件的内部链接
+
+### 4. 生成多风格摘要
+
+在`SUMMARY/`目录中为7种风格创建单独的摘要文件。每个摘要必须严格基于Markdown文件的事实内容，不得虚构。
+
+**风格指南：**
+
+1. **客观中立风格**（基于事实，保持简洁，就像名片和履历一样）
+   - 呈现关键事实、日期、角色、成就
+   - 避免主观语言；坚持可验证的信息
+   - 格式：项目符号或简短段落
+
+2. **客观批判风格**（基于事实的批判，反思视角）
+   - 基于证据识别优势和劣势
+   - 提出改进领域或替代方法
+   - 保持专业语气；避免人身攻击
+
+3. **赞扬鼓励风格**（基于事实的积极强化）
+   - 突出成功、创新元素、有价值的贡献
+   - 以建设性的方式构建为"哪些做得好以及为什么"
+   - 为未来工作提供激励视角
+
+4. **幽默调侃风格**（轻松愉快，面向普通受众）
+   - 用通俗语言解释复杂概念（"说人话"）
+   - 使用温和的幽默、类比、相关例子
+   - 跳过过于技术性或敏感、可能被误解的内容
+   - 目标：引发会心一笑，而非嘲笑
+
+5. **文艺感性风格**（叙事性，引发共鸣，故事驱动）
+   - 创造生动的意象，情感共鸣
+   - 将事实编织成引人入胜的叙事弧线
+   - 旨在激发共情和连接
+
+6. **心理分析风格**（例如，基于证据的MBTI分析）
+   - 分配心理特质（如INTJ、ENFP），并提供明确推理
+   - 为每个特质维度提供内容中的具体例子
+   - 确保分析基于可观察的模式
+
+7. **历史时间跨度风格**（按时间发展视角）
+   - 沿时间线组织内容
+   - 展示演变、转折点、随时间趋势
+   - 在更广泛的历史或项目叙事中情境化
+
+### 5. 输出格式规则
+
+- **文件命名**: `SUMMARY/neutral.md`, `SUMMARY/critical.md`, `SUMMARY/praise.md`, `SUMMARY/humorous.md`, `SUMMARY/literary.md`, `SUMMARY/psychological.md`, `SUMMARY/historical.md`
+- **头部**: 每个文件必须以以下内容开头：
+  ```
+  # [风格名称] 摘要
+  *由AI生成于YYYY-MM-DD HH:MM UTC*
+  *内容为AI生成，仅供参考*
+  ```
+- **引用链接**: 当引用源Markdown文件时：
+  - 使用相对路径链接到具体文件：`../path/to/file.md`
+  - 锚文本应该是文章的标题（第一个H1），而不是文件名
+  - 确保链接有效（如有需要，使用`Read`工具测试）
+  - 永远不要链接到目录——始终链接到具体的.md文件
+- **权重分配**: 给予最近修改的文章更高的权重（使用git时间戳）
+- **事实核查**: 跨文件交叉引用以确保一致性
+
+### 6. 质量保证
+
+生成所有摘要后：
+
+- 验证没有摘要与事实源材料相矛盾
+- 检查所有内部链接是否正确解析
+- 确保每种风格保持其独特的语调
+- 确认SUMMARY目录恰好包含7个文件
+
+## 常见陷阱
+
+- **虚构**: 绝不添加源Markdown文件中不存在的信息
+- **链接错误**: 从SUMMARY目录链接时始终使用`../`前缀
+- **风格混杂**: 保持每个摘要严格在其指定的语调范围内
+- **新近度偏差**: 虽然近期文章获得更高权重，但不要忽略较旧的有价值内容
+- **过度解读**: 在心理分析中，仅基于明确的证据得出结论
+
+## 示例用户请求
+
+- "以7种不同风格总结所有Markdown文章"
+- "生成我们文档的多视角分析"
+- "为我们的知识库创建文章摘要"
+- "生成我们内容的幽默和严肃版本"

package/dist/ai/extractMetadataFromMarkdown.js

@@ -1,13 +1,59 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractMetadataFromMarkdown = extractMetadataFromMarkdown;
+const metadata_1 = require("../metadata");
 const openai_1 = require("../services/openai");
 /**
- * 从 markdown 内容中提取 metadata
- * @returns Promise<AIMetadata> 提取的元数据，失败时抛出错误
+ * AI Metadata 提取模块
+ *
+ * 优化策略说明：
+ * 1. 从 MetaData 全局状态读取已有 slug，不作为参数传递
+ * 2. 如果已有 slug，条件化 prompt - 完全不提及 slug 相关指令
+ * 3. trade-off: 优先提升 AI 质量（减少无关任务干扰），可能降低 context 缓存命中率
  */
 async function extractMetadataFromMarkdown(filePath, content) {
-    const prompt = buildMetadataPrompt(content);
+    const existingSlug = metadata_1.MetaData.files.find(f => f.path === filePath)?.metadata?.slug;
+    const hasExistingSlug = !!existingSlug;
+    const fields = [
+        'title: 文档的标题（简洁明了，不超过 30 个字）',
+        'tags: 关键词列表（3-8 个关键词，使用中文或英文）',
+        'description: 文档的简短描述，微摘要（用一句话概括本文核心价值，不超过 100 字符），用于 SEO meta description，社交卡片短描述',
+        'summary: 文档中型摘要（用一段话总结文章，包含关键论点和结论，控制在 300 字以内），用于 邮件推送内容，newsletter 介绍',
+        'inferred_date: 文档中隐含的创建日期（如果有的话，格式：YYYY-MM-DD，没有就留空字符串）',
+        'inferred_lang: 文档使用的语言代码（例如：zh-Hans 表示简体中文，en-US 表示美式英语）',
+        'key_points: 文章的关键要点列表（5-10 个要点，简洁明了）',
+        'audience: 目标读者描述（简短描述，50 字以内）',
+        'short_summary: 文档的超短摘要（用 2-3 句话概括文章主要内容，突出核心观点），用于文章列表页摘要，RSS feed 描述',
+        ...(hasExistingSlug
+            ? []
+            : ['slug: URL 友好别名（使用小写字母、数字和连字符，仅包含英文和数字）']),
+    ];
+    const jsonFields = [
+        '{',
+        '  "title": "文档标题",',
+        '  "description": "用一句话概括本文核心价值，不超过 100 字符",',
+        '  "summary": "中型摘要，用一段话总结文章，包含关键论点和结论",',
+        '  "short_summary": "超短摘要，用 2-3 句话概括文章主要内容，突出核心观点",',
+        '  "tags": ["关键词1", "关键词2", "关键词3"],',
+        '  "inferred_date": "2023-01-01",',
+        '  "inferred_lang": "zh-Hans",',
+        '  "key_points": ["要点1", "要点2", "要点3"],',
+        ...(hasExistingSlug ? [] : ['  "slug": "URL 友好别名",']),
+        '  "audience": "目标读者描述"',
+        '}',
+    ];
+    const prompt = `请分析以下文档内容，提取以下信息并返回 JSON 格式：
+
+ 文档内容：
+ """
+ ${content}
+ """
+
+ 请提取：
+${fields.join('\n')}
+
+ 请严格按照以下 JSON 格式返回，不要包含任何其他文本：
+${jsonFields.join('\n')}`;
     const messages = [
         {
             role: 'system',
@@ -22,85 +68,28 @@ async function extractMetadataFromMarkdown(filePath, content) {
         response_format: { type: 'json_object' },
         task_id: `extract-metadata:${filePath}`,
     });
-    const metadata = parseMetadataResponse(response.choices[0].message.content);
-    // 添加 tokens 使用情况
-    metadata.tokens_used = {
-        prompt: response.usage.prompt_tokens,
-        completion: response.usage.completion_tokens,
-        total: response.usage.total_tokens,
+    const metadata = JSON.parse(response.choices[0].message.content);
+    const result = {
+        title: metadata.title?.trim() || '',
+        description: metadata.description?.trim() || '',
+        short_summary: metadata.short_summary?.trim() || '',
+        audience: metadata.audience?.trim() || '',
+        key_points: Array.isArray(metadata.key_points)
+            ? metadata.key_points.map((point) => point.trim()).filter(Boolean)
+            : [],
+        summary: metadata.summary?.trim() || '',
+        slug: metadata.slug?.trim() || existingSlug || '',
+        tags: Array.isArray(metadata.tags)
+            ? metadata.tags.map((tag) => tag.trim()).filter(Boolean)
+            : [],
+        inferred_date: metadata.inferred_date?.trim() || undefined,
+        inferred_lang: metadata.inferred_lang?.trim() || undefined,
+        tokens_used: {
+            prompt: response.usage.prompt_tokens,
+            completion: response.usage.completion_tokens,
+            total: response.usage.total_tokens,
+        },
     };
-    return metadata;
-}
-/**
- * 构建提取 metadata 的 prompt
- */
-function buildMetadataPrompt(content) {
-    // 限制内容长度以避免 token 超限
-    const maxContentLength = Infinity; // 可根据需要调整长度限制
-    const truncatedContent = content.length > maxContentLength
-        ? content.substring(0, maxContentLength) + '... [内容已截断]'
-        : content;
-    return `请分析以下文档内容，提取以下信息并返回 JSON 格式：
-
-文档内容：
-"""
-${truncatedContent}
-"""
-
-请提取：
-1. title: 文档的标题（简洁明了，不超过 30 个字）
-2. slug: URL 友好别名（使用小写字母、数字和连字符，仅包含英文和数字）
-3. tags: 关键词列表（3-8 个关键词，使用中文或英文）
-4. description: 文档的简短描述，微摘要（用一句话概括本文核心价值，不超过 100 字符），用于 SEO meta description，社交卡片短描述
-5. summary: 文档中型摘要（用一段话总结文章，包含关键论点和结论，控制在 300 字以内），用于 邮件推送内容，newsletter 介绍
-6. inferred_date: 文档中隐含的创建日期（如果有的话，格式：YYYY-MM-DD，没有就留空字符串）
-7. inferred_lang: 文档使用的语言代码（例如：zh-Hans 表示简体中文，en-US 表示美式英语）
-8. key_points: 文章的关键要点列表（5-10 个要点，简洁明了）
-9. audience: 目标读者描述（简短描述，50 字以内）
-10. short_summary: 文档的超短摘要（用 2-3 句话概括文章主要内容，突出核心观点），用于文章列表页摘要，RSS feed 描述
-
-
-请严格按照以下 JSON 格式返回，不要包含任何其他文本：
-{
-  "title": "文档标题",
-  "description": "用一句话概括本文核心价值，不超过 100 字符",
-  "summary": "中型摘要，用一段话总结文章，包含关键论点和结论",
-  "short_summary": "超短摘要，用 2-3 句话概括文章主要内容，突出核心观点",
-  "slug": "URL 友好别名",
-  "tags": ["关键词1", "关键词2", "关键词3"],
-  "inferred_date": "2023-01-01",
-  "inferred_lang": "zh-Hans",
-  "key_points": ["要点1", "要点2", "要点3"],
-  "audience": "目标读者描述"
-}`;
-}
-/**
- * 解析 AI 返回的 metadata
- */
-function parseMetadataResponse(responseContent) {
-    try {
-        const metadata = JSON.parse(responseContent);
-        // 验证和清理数据
-        return {
-            title: metadata.title?.trim() || '未命名文档',
-            description: metadata.description?.trim() || '',
-            short_summary: metadata.short_summary?.trim() || '',
-            audience: metadata.audience?.trim() || '',
-            key_points: Array.isArray(metadata.key_points)
-                ? metadata.key_points.map((point) => point.trim()).filter(Boolean)
-                : [],
-            summary: metadata.summary?.trim() || '',
-            slug: metadata.slug?.trim() || '',
-            tags: Array.isArray(metadata.tags)
-                ? metadata.tags.map((tag) => tag.trim()).filter(Boolean)
-                : [],
-            inferred_date: metadata.inferred_date?.trim() || undefined,
-            inferred_lang: metadata.inferred_lang?.trim() || 'zh-Hans',
-        };
-    }
-    catch (error) {
-        console.error('❌ Failed to parse AI response:', error, 'Response:', responseContent);
-        throw error;
-    }
+    return result;
 }
 //# sourceMappingURL=extractMetadataFromMarkdown.js.map

package/dist/cli.js

@@ -5,8 +5,41 @@ const clipanion_1 = require("clipanion");
 const dotenv_1 = require("dotenv");
 const pipeline_1 = require("./build/pipeline");
 const version_1 = require("./version");
+const findEntries_1 = require("./findEntries");
 // 加载 .env 文件中的环境变量
 (0, dotenv_1.config)();
+// LsFiles 命令
+class LsFilesCommand extends clipanion_1.Command {
+    async execute() {
+        try {
+            const files = await (0, findEntries_1.findMarkdownEntries)(process.cwd());
+            if (files.length === 0) {
+                this.context.stdout.write('No markdown files found.\n');
+            }
+            else {
+                files.forEach(file => {
+                    this.context.stdout.write(`${file}\n`);
+                });
+            }
+            return 0;
+        }
+        catch (error) {
+            this.context.stderr.write(`❌ Failed to list files: ${error}\n`);
+            return 1;
+        }
+    }
+}
+LsFilesCommand.paths = [['ls-files']];
+LsFilesCommand.usage = clipanion_1.Command.Usage({
+    description: 'List all markdown files in the current directory',
+    details: `
+      This command lists all markdown files in the current directory using git.
+      It uses the same logic as the internal findMarkdownEntries function.
+
+      Examples:
+        $ czon ls-files
+    `,
+});
 // Build 命令
 class BuildCommand extends clipanion_1.Command {
     constructor() {
@@ -55,6 +88,7 @@ const cli = new clipanion_1.Cli({
 });
 // 注册命令
 cli.register(BuildCommand);
+cli.register(LsFilesCommand);
 // 运行 CLI
 cli.runExit(process.argv.slice(2), {
     ...clipanion_1.Cli.defaultContext,

package/dist/process/processTranslations.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.processTranslations = processTranslations;
 const promises_1 = require("fs/promises");
 const path_1 = __importStar(require("path"));
+const translateMarkdown_1 = require("../ai/translateMarkdown");
 const languages_1 = require("../languages");
 const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
@@ -94,9 +95,11 @@ async function processTranslations() {
                         console.info(`ℹ️ Content unchanged for ${file.path}, skipping translation.`);
                     return;
                 }
-                const translatedContent = await translateWithOpenCode(sourcePath, targetPath, lang);
+                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.content_length = translatedContent.length; // 记录翻译后内容长度
+                translationMeta.token_used = translatedResponse.usage; // 记录 token 使用情况
                 await (0, writeFile_1.writeFile)(targetPath, translatedContent);
                 // 存储已增强内容的哈希值
                 file.nativeMarkdownHash = hash;

package/dist/services/opencode.js

@@ -32,7 +32,7 @@ const writeFile_1 = require("../utils/writeFile");
  * ]);
  */
 const runOpenCode = (prompt, options) => {
-    const model = options?.model ?? 'opencode/minimax-m2.1-free';
+    const model = options?.model ?? 'opencode/gpt-5-nano';
     const signal = options?.signal;
     const cwd = options?.cwd;
     const verbose = metadata_1.MetaData.options.verbose;

package/dist/ssg/ContentPage.js

@@ -12,6 +12,7 @@ const CZONHeader_1 = require("./components/CZONHeader");
 const LanguageSwitcher_1 = require("./components/LanguageSwitcher");
 const Navigator_1 = require("./components/Navigator");
 const PageLayout_1 = require("./layouts/PageLayout");
+const resourceMap_1 = require("./resourceMap");
 const style_1 = require("./style");
 const ContentPage = props => {
     const frontmatter = props.content.frontmatter || {};
@@ -30,7 +31,7 @@ const ContentPage = props => {
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("title", null, title),
             react_1.default.createElement("meta", { name: "description", content: `tags: ${tags.join(', ')}` }),
-            react_1.default.createElement("script", { src: (0, node_path_1.relative)(props.ctx.path, '/assets/tailwindcss.js'), defer: true }),
+            react_1.default.createElement("script", { src: (0, resourceMap_1.getResourceUrlFrom)(props.ctx.path, 'tailwindcss.js'), defer: true }),
             react_1.default.createElement("style", null, style_1.style),
             react_1.default.createElement("script", { dangerouslySetInnerHTML: {
                     __html: `

package/dist/ssg/IndexPage.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IndexPage = void 0;
-const node_path_1 = require("node:path");
 const react_1 = __importDefault(require("react"));
 const sortBy_1 = require("../utils/sortBy");
 const ContentMeta_1 = require("./components/ContentMeta");
@@ -12,6 +11,7 @@ const CZONFooter_1 = require("./components/CZONFooter");
 const CZONHeader_1 = require("./components/CZONHeader");
 const LanguageSwitcher_1 = require("./components/LanguageSwitcher");
 const PageLayout_1 = require("./layouts/PageLayout");
+const resourceMap_1 = require("./resourceMap");
 const style_1 = require("./style");
 const IndexPage = props => {
     const contents = (0, sortBy_1.toSortedBy)(props.ctx.site.files.filter(f => f.metadata && (!props.category || f.category === props.category)), [
@@ -50,7 +50,18 @@ const IndexPage = props => {
                             const title = category || 'All';
                             const link = category ? `categories_${category}.html` : 'index.html';
                             const isActive = category === props.category;
-                            return (react_1.default.createElement("span", { key: title }, isActive ? (react_1.default.createElement("span", { className: "font-bold" }, title)) : (react_1.default.createElement("a", { href: link }, title))));
+                            const articlesCount = category
+                                ? props.ctx.site.files.filter(f => f.category === category).length
+                                : props.ctx.site.files.length;
+                            return (react_1.default.createElement("span", { key: title }, isActive ? (react_1.default.createElement("span", { className: "font-bold" },
+                                title,
+                                " (",
+                                articlesCount,
+                                ")")) : (react_1.default.createElement("a", { href: link },
+                                title,
+                                " (",
+                                articlesCount,
+                                ")"))));
                         }))),
                     react_1.default.createElement("div", null, contents.map(file => {
                         const metadata = file.metadata;
@@ -60,7 +71,7 @@ const IndexPage = props => {
                     react_1.default.createElement("footer", null,
                         react_1.default.createElement(LanguageSwitcher_1.LanguageSwitcher, { ctx: props.ctx, lang: props.lang }),
                         react_1.default.createElement(CZONFooter_1.CZONFooter, null))), footer: null }),
-            react_1.default.createElement("script", { src: (0, node_path_1.relative)(props.ctx.path, '/assets/tailwindcss.js'), defer: true }))));
+            react_1.default.createElement("script", { src: (0, resourceMap_1.getResourceUrlFrom)(props.ctx.path, 'tailwindcss.js'), defer: true }))));
     // TODO: 渲染多语言首页列表
     // return (
     //   <div>

package/dist/ssg/resourceMap.js

@@ -1,10 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXTERNAL_RESOURCES = void 0;
+exports.getResourceUrlFrom = exports.EXTERNAL_RESOURCES = void 0;
+const path_1 = require("path");
 exports.EXTERNAL_RESOURCES = [
     {
         name: 'tailwindcss.js',
         url: 'https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4',
     },
 ];
+/**
+ * 获取资源的相对引用 URL
+ * @param path - 当前文件路径 (e.g. `/en-US/index.html`)
+ * @param name - 资源名称 (e.g. `tailwindcss.js`)
+ */
+const getResourceUrlFrom = (path, name) => {
+    const resource = exports.EXTERNAL_RESOURCES.find(r => r.name === name);
+    if (!resource)
+        throw new Error(`Resource ${name} not found`);
+    return (0, path_1.relative)((0, path_1.dirname)(path), `/assets/${resource.name}`);
+};
+exports.getResourceUrlFrom = getResourceUrlFrom;
 //# sourceMappingURL=resourceMap.js.map

package/package.json

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

package/dist/services/opencode.test.js

@@ -1,34 +0,0 @@
-"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