czon 0.9.0 → 0.9.1

package/dist/commands/ls-files.js

@@ -9,10 +9,13 @@ class LsFilesCommand extends clipanion_1.Command {
         this.aigc = clipanion_1.Option.Boolean('--aigc', false, {
             description: 'Include files under .czon/AIGC directory',
         });
+        this.allTypes = clipanion_1.Option.Boolean('--all-types', false, {
+            description: 'List all file types, not just Markdown files',
+        });
     }
     async execute() {
         try {
-            const files = await (0, findEntries_1.findMarkdownEntries)(process.cwd(), { aigc: this.aigc });
+            const files = await (0, findEntries_1.findEntries)(process.cwd(), { aigc: this.aigc, allTypes: this.allTypes });
             if (files.length === 0) {
                 this.context.stdout.write('No markdown files found.\n');
             }
@@ -35,10 +38,12 @@ 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.
+      It uses the same logic as the internal findEntries function.
+      Use --all-types to list all file types, not just Markdown.
 
       Examples:
         $ czon ls-files
+        $ czon ls-files --all-types
     `,
 });
 //# sourceMappingURL=ls-files.js.map

package/dist/findEntries.js

@@ -1,23 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findMarkdownEntries = void 0;
+exports.findEntries = void 0;
 const child_process_1 = require("child_process");
 const path_1 = require("path");
 const util_1 = require("util");
 const isExists_1 = require("./utils/isExists");
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
 /**
- * 使用git命令查找所有Markdown文件
+ * 使用git命令查找项目中的文件
  * 使用git ls-files --others --cached --exclude-standard获取所有文件
- * 然后过滤掉.czon目录和只保留.md文件
+ * 然后过滤掉.czon目录，默认只保留.md文件
  *
  * @param dirPath 要扫描的目录路径
  * @param options 可选参数
  * @param options.aigc 是否包含 .czon/AIGC 目录下的文件
- * @returns Promise<string[]> 返回Markdown文件的相对路径数组
+ * @param options.allTypes 是否返回所有类型的文件（默认 false，仅返回 .md 文件）
+ * @returns Promise<string[]> 返回文件的相对路径数组
  */
-const findMarkdownEntries = async (dirPath, options) => {
+const findEntries = async (dirPath, options) => {
     const aigc = options?.aigc ?? false;
+    const allTypes = options?.allTypes ?? false;
     // 获取git仓库的根目录
     const gitRoot = (await execAsync('git rev-parse --show-toplevel', { cwd: dirPath })).stdout.trim();
     // 使用git命令获取所有文件（包括已跟踪和未跟踪的文件）
@@ -31,7 +33,7 @@ const findMarkdownEntries = async (dirPath, options) => {
         .split('\0') // 按空字符分割文件名
         .filter(line => line.trim() !== '') // 移除空行
         .filter(file => !file.startsWith('.') || (aigc && file.startsWith('.czon/AIGC/'))) // 过滤掉隐藏目录下的文件（aigc 模式下保留 .czon/AIGC/）
-        .filter(file => file.endsWith('.md')); // 只保留.md文件
+        .filter(file => allTypes || file.endsWith('.md')); // allTypes 时返回所有文件，否则只保留 .md 文件
     // 排除文件系统中不存在的文件
     const existingFiles = [];
     for (const file of files) {
@@ -41,5 +43,5 @@ const findMarkdownEntries = async (dirPath, options) => {
     }
     return existingFiles;
 };
-exports.findMarkdownEntries = findMarkdownEntries;
+exports.findEntries = findEntries;
 //# sourceMappingURL=findEntries.js.map

package/dist/process/checkLinks.js

@@ -103,11 +103,22 @@ function extractLinksWithLineNumbers(content) {
  */
 async function checkLinks() {
     console.log('🔍 正在扫描 Markdown 文件...');
-    const markdownFiles = await (0, findEntries_1.findMarkdownEntries)(paths_1.INPUT_DIR, { aigc: true });
+    const markdownFiles = await (0, findEntries_1.findEntries)(paths_1.INPUT_DIR, { aigc: true });
+    const allFiles = await (0, findEntries_1.findEntries)(paths_1.INPUT_DIR, { allTypes: true });
     const issues = [];
     // 构建已知文件集合，用于死链接检测
     const knownFiles = new Set(markdownFiles);
-    console.log(`📄 发现 ${markdownFiles.length} 个 Markdown 文件\n`);
+    // 构建全部文件集合，用于建议生成
+    const allFilesSet = new Set(allFiles);
+    // 构建 basename -> 相对路径列表 的索引，用于模糊匹配
+    const basenameIndex = new Map();
+    for (const file of allFiles) {
+        const base = path_1.default.basename(file);
+        const list = basenameIndex.get(base) ?? [];
+        list.push(file);
+        basenameIndex.set(base, list);
+    }
+    console.log(`📄 发现 ${markdownFiles.length} 个 Markdown 文件，${allFiles.length} 个总文件\n`);
     for (const filePath of markdownFiles) {
         const fullPath = path_1.default.join(paths_1.INPUT_DIR, filePath);
         const content = await (0, promises_1.readFile)(fullPath, 'utf-8');
@@ -125,6 +136,13 @@ async function checkLinks() {
                 continue;
             // 检查 1: 路径格式规范 — 不应使用 / 开头的绝对路径
             if (hrefWithoutHash.startsWith('/')) {
+                // 尝试生成建议：去掉开头的 /，看是否能在已知文件中找到
+                const suggestions = [];
+                const targetRelative = hrefWithoutHash.slice(1); // 去掉开头的 /
+                if (allFilesSet.has(targetRelative)) {
+                    const suggested = path_1.default.relative(path_1.default.dirname(filePath), targetRelative);
+                    suggestions.push(suggested);
+                }
                 issues.push({
                     file: filePath,
                     line: link.line,
@@ -132,6 +150,7 @@ async function checkLinks() {
                     href: link.href,
                     type: 'absolute-path',
                     message: '不应使用 / 开头的绝对路径，请使用相对路径',
+                    suggestions,
                 });
                 // 绝对路径无法正确解析，跳过死链接检测
                 continue;
@@ -147,6 +166,22 @@ async function checkLinks() {
                     href: link.href,
                     type: 'dead-link',
                     message: '链接指向项目目录之外',
+                    suggestions: [],
+                });
+                continue;
+            }
+            // 检查 2: .czon/src 边界隔离 — 外部文件不能引用 .czon/src 内部的文件
+            const sourceIsInternal = filePath.startsWith('.czon/src/');
+            const targetIsInternal = resolvedRelative.startsWith('.czon/src/');
+            if (!sourceIsInternal && targetIsInternal) {
+                issues.push({
+                    file: filePath,
+                    line: link.line,
+                    raw: link.raw,
+                    href: link.href,
+                    type: 'cross-boundary',
+                    message: '不能引用 .czon/src 内部的文件',
+                    suggestions: [],
                 });
                 continue;
             }
@@ -158,6 +193,16 @@ async function checkLinks() {
             // 再检查文件系统
             const resolvedFullPath = path_1.default.join(paths_1.INPUT_DIR, resolvedRelative);
             if (!(await (0, isExists_1.isExists)(resolvedFullPath))) {
+                // 通过 basename 模糊匹配，生成候选建议（最多 3 个）
+                const suggestions = [];
+                const targetBasename = path_1.default.basename(hrefWithoutHash);
+                const candidates = basenameIndex.get(targetBasename) ?? [];
+                for (const candidate of candidates) {
+                    if (suggestions.length >= 3)
+                        break;
+                    const suggested = path_1.default.relative(path_1.default.dirname(filePath), candidate);
+                    suggestions.push(suggested);
+                }
                 issues.push({
                     file: filePath,
                     line: link.line,
@@ -165,6 +210,7 @@ async function checkLinks() {
                     href: link.href,
                     type: 'dead-link',
                     message: '目标文件不存在',
+                    suggestions,
                 });
             }
         }
@@ -189,19 +235,25 @@ function formatCheckResults(issues) {
     for (const [file, fileIssues] of grouped) {
         lines.push(file);
         for (const issue of fileIssues) {
-            const icon = issue.type === 'dead-link' ? '✖' : '⚠';
+            const icon = issue.type === 'dead-link' ? '✖' : issue.type === 'cross-boundary' ? '⊘' : '⚠';
             lines.push(`  line ${issue.line}: ${icon} ${issue.raw}`);
             lines.push(`    ${issue.message}`);
+            for (const suggestion of issue.suggestions) {
+                lines.push(`    建议: ${suggestion}`);
+            }
         }
         lines.push('');
     }
     const deadCount = issues.filter(i => i.type === 'dead-link').length;
     const formatCount = issues.filter(i => i.type === 'absolute-path').length;
+    const boundaryCount = issues.filter(i => i.type === 'cross-boundary').length;
     const parts = [];
     if (deadCount > 0)
         parts.push(`${deadCount} 个死链接`);
     if (formatCount > 0)
         parts.push(`${formatCount} 个路径格式问题`);
+    if (boundaryCount > 0)
+        parts.push(`${boundaryCount} 个跨边界引用`);
     lines.push(`发现 ${issues.length} 个问题（${parts.join('，')}），涉及 ${grouped.size} 个文件。`);
     return lines.join('\n');
 }

package/dist/process/scanSourceFiles.js

@@ -25,7 +25,7 @@ async function scanSourceFiles() {
     console.log(`🔍 Scanning source directory...`);
     const queue = [];
     const isVisited = new Set();
-    const markdownFiles = await (0, findEntries_1.findMarkdownEntries)(paths_1.INPUT_DIR, { aigc: true });
+    const markdownFiles = await (0, findEntries_1.findEntries)(paths_1.INPUT_DIR, { aigc: true });
     for (const filePath of markdownFiles) {
         queue.push(filePath);
     }

package/package.json

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

package/prompts/summary-base.md

@@ -115,20 +115,20 @@
 - 引用原文链接时，保证链接有效
 - **永远链接到具体的 Markdown 文件**，不要链接目录
 - **链接文本应当是对应的标题**，而不是文件名
-- 由于生成到 SUMMARY 目录，引用时使用 `../` 开头的相对路径
+- 由于生成到 `.czon/AIGC/SUMMARY/` 目录，引用时使用 `../../../` 开头的相对路径
 
 **正确示例**：
 
 ```markdown
-[资本持久战：个人投资者跨越阶级的战略](../INSIGHTS/6.md)
-[从创作到分发——构建AI-Native内容引擎](../INSIGHTS/4.md)
+[资本持久战：个人投资者跨越阶级的战略](../../../INSIGHTS/6.md)
+[从创作到分发——构建AI-Native内容引擎](../../../INSIGHTS/4.md)
 ```
 
 **错误示例**：
 
 ```markdown
-[INSIGHTS/6.md](../INSIGHTS/6.md) ← 使用了文件名而非标题
-[资本持久战](../INSIGHTS/) ← 链接到了目录
+[INSIGHTS/6.md](../../../INSIGHTS/6.md) ← 使用了文件名而非标题
+[资本持久战](../../../INSIGHTS/) ← 链接到了目录
 ```
 
 ### 3. 头部格式