czon 0.5.2 → 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/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/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.2",
+  "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