md-to-mowen 1.0.1 → 1.2.0

package/dist/cli/index.js

@@ -6,10 +6,14 @@ import { fileURLToPath } from 'url';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { homedir } from 'os';
 import { createInterface } from 'readline';
+import { lstat } from 'fs/promises';
 import { processFile } from '../publish/process-file.js';
+import { processDirectory } from '../publish/process-directory.js';
 import { MowenClient } from '../mowen/client.js';
 import { noteAtomToMast } from '../noteatom/to-mast.js';
 import { mastToMarkdown } from '../mast/to-markdown.js';
+import { findMetadataPath, readMetadata, writeMetadata, lookupNote, upsertNote } from '../shared/metadata.js';
+import { loadConfig } from '../shared/config.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 /** 按优先级搜索 .env 文件 */
 function searchEnvPaths() {
@@ -104,12 +108,14 @@ program
 program
     .command('publish')
     .description('发布 Markdown 文件为墨问笔记')
-    .requiredOption('-i, --input <file>', 'Markdown 文件路径')
+    .requiredOption('-i, --input <path>', 'Markdown 文件路径或目录')
     .option('--note-id <id>', '已有笔记 ID（编辑模式，全量替换）')
-    .option('--tags <tags>', '标签，逗号分隔（如 "tech,ai"）')
-    .option('--auto-publish', '自动发布（非草稿）', false)
+    .option('--tags <tags>', '标签，逗号分隔（如 "tech,ai"），覆盖配置文件 defaultTags')
+    .option('--auto-publish', '自动发布（非草稿），覆盖配置文件 autoPublish', false)
     .option('--dry-run', '走完流水线但不调用墨问 API，仅打印统计', false)
-    .option('--cache-dir <dir>', '保存各阶段产物的目录（调试用）', 'out/pipeline-cache')
+    .option('--cache-dir <dir>', '保存各阶段产物的目录（调试用）')
+    .option('--code-block-style <style>', '代码块样式：paragraph 或 codeblock')
+    .option('--no-recursive', '批量发布时不递归扫描子目录', false)
     .action(async (opts) => {
     const apiKey = getApiKey();
     if (!apiKey && !opts.dryRun) {
@@ -121,24 +127,96 @@ program
         console.error('获取方式：微信小程序"墨问" → 个人主页 → 开发者 → 我的 API Key');
         process.exit(1);
     }
+    // ── 加载配置 ────────────────────────────────────────────────────────────────
+    const absInput = resolve(opts.input);
+    const inputDir = dirname(absInput);
+    const cliOverrides = {};
+    // CLI 参数优先级最高，仅当明确提供时才覆盖配置
+    if (opts.tags !== undefined) {
+        cliOverrides.defaultTags = opts.tags;
+    }
+    if (opts.autoPublish) {
+        cliOverrides.autoPublish = true;
+    }
+    if (opts.cacheDir) {
+        cliOverrides.cacheDir = opts.cacheDir;
+    }
+    if (opts.codeBlockStyle) {
+        const style = opts.codeBlockStyle;
+        if (style === 'paragraph' || style === 'codeblock') {
+            cliOverrides.codeBlockStyle = style;
+        }
+        else {
+            console.error(`错误：--code-block-style="${style}" 无效，支持：paragraph, codeblock`);
+            process.exit(1);
+        }
+    }
+    const resolvedConfig = loadConfig(cliOverrides, inputDir);
     const client = new MowenClient(apiKey ?? 'dry-run-placeholder');
-    const tags = opts.tags ? opts.tags.split(',').map((t) => t.trim()) : undefined;
+    // 使用 resolvedConfig.defaultTags（可能来自配置文件），但 CLI --tags 覆盖时优先使用
+    const tagsStr = opts.tags !== undefined ? opts.tags : resolvedConfig.defaultTags;
+    const tags = tagsStr ? tagsStr.split(',').map((t) => t.trim()) : undefined;
+    // ── 检测 input 类型 ───────────────────────────────────────────────────────
     try {
-        const result = await processFile(opts.input, client, {
-            ...(opts.noteId ? { noteId: opts.noteId } : {}),
-            ...(tags ? { tags } : {}),
-            autoPublish: opts.autoPublish,
-            dryRun: opts.dryRun,
-            ...(opts.cacheDir ? { cacheDir: opts.cacheDir } : {}),
-        });
-        if (!result.dryRun) {
-            console.log(`\n✅ 发布成功`);
-            console.log(`   笔记 ID：${result.noteId}`);
-            console.log(`   访问地址：${result.noteUrl}\n`);
+        const inputStat = await lstat(absInput);
+        if (inputStat.isDirectory()) {
+            // 目录：批量处理
+            const result = await processDirectory(opts.input, client, {
+                ...(tags ? { tags } : {}),
+                autoPublish: resolvedConfig.autoPublish,
+                dryRun: opts.dryRun,
+                cacheDir: resolvedConfig.cacheDir,
+                recursive: !opts.noRecursive,
+            });
+            // 批量模式下，有失败则 exit 1
+            if (result.failed > 0) {
+                process.exit(1);
+            }
+        }
+        else if (inputStat.isFile()) {
+            // 单文件：现有逻辑
+            const metaPath = findMetadataPath();
+            const metaStore = readMetadata(metaPath);
+            let noteId = opts.noteId;
+            if (!noteId && !opts.dryRun) {
+                const existing = lookupNote(metaStore, absInput);
+                if (existing) {
+                    noteId = existing.noteId;
+                    console.log(`  找到已有笔记映射，进入编辑模式：${noteId}`);
+                }
+            }
+            try {
+                const result = await processFile(opts.input, client, {
+                    ...(noteId ? { noteId } : {}),
+                    ...(tags ? { tags } : {}),
+                    autoPublish: resolvedConfig.autoPublish,
+                    dryRun: opts.dryRun,
+                    cacheDir: resolvedConfig.cacheDir,
+                    codeBlockStyle: resolvedConfig.codeBlockStyle,
+                });
+                if (!result.dryRun && result.noteId) {
+                    upsertNote(metaStore, absInput, result.noteId);
+                    writeMetadata(metaPath, metaStore);
+                }
+                if (!result.dryRun) {
+                    console.log(`\n✅ 发布成功`);
+                    console.log(`   笔记 ID：${result.noteId}`);
+                    console.log(`   访问地址：${result.noteUrl}\n`);
+                }
+            }
+            catch (err) {
+                console.error('发布失败：', err instanceof Error ? err.message : err);
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(`错误：路径不存在 ${absInput}`);
+            process.exit(1);
         }
     }
     catch (err) {
-        console.error('发布失败：', err instanceof Error ? err.message : err);
+        // lstat 抛错（如路径不存在）
+        console.error('错误：', err instanceof Error ? err.message : err);
         process.exit(1);
     }
 });
@@ -172,4 +250,69 @@ program
         process.exit(1);
     }
 });
+// ── privacy ────────────────────────────────────────────────────────────────────
+program
+    .command('privacy')
+    .description('设置笔记的隐私状态')
+    .option('--note-id <id>', '笔记 ID')
+    .option('-i, --input <file>', 'Markdown 文件路径（需要元数据支持）')
+    .requiredOption('--visibility <visibility>', '隐私状态：public 或 private')
+    .option('--dry-run', '不调用 API，仅打印操作信息', false)
+    .action(async (opts) => {
+    if (!opts.noteId && !opts.input) {
+        console.error('错误：必须提供 --note-id 或 --input');
+        process.exit(1);
+    }
+    if (opts.noteId && opts.input) {
+        console.error('错误：--note-id 和 --input 不能同时使用');
+        process.exit(1);
+    }
+    const visibility = opts.visibility;
+    if (visibility !== 'public' && visibility !== 'private') {
+        console.error('错误：--visibility 必须是 public 或 private');
+        process.exit(1);
+    }
+    const apiKey = getApiKey();
+    if (!apiKey && !opts.dryRun) {
+        console.error('错误：未设置 MOWEN_API_KEY。');
+        console.error('');
+        console.error('请先运行以下命令配置 API Key：');
+        console.error('  md-to-mowen config');
+        console.error('');
+        console.error('获取方式：微信小程序"墨问" → 个人主页 → 开发者 → 我的 API Key');
+        process.exit(1);
+    }
+    let noteId;
+    if (opts.input) {
+        const absInput = resolve(opts.input);
+        const metaPath = findMetadataPath();
+        const metaStore = readMetadata(metaPath);
+        const existing = lookupNote(metaStore, absInput);
+        if (!existing) {
+            console.error('错误：未找到该文件的元数据记录，请使用 --note-id 指定笔记 ID');
+            process.exit(1);
+        }
+        noteId = existing.noteId;
+        console.log(`  从元数据找到笔记 ID：${noteId}`);
+    }
+    else {
+        noteId = opts.noteId;
+    }
+    if (opts.dryRun) {
+        console.log(`\n[dry-run] 将设置笔记 ${noteId} 隐私状态为 ${visibility}`);
+        return;
+    }
+    const client = new MowenClient(apiKey);
+    try {
+        await client.setPrivacy(noteId, visibility);
+        console.log(`\n✅ 隐私设置成功`);
+        console.log(`   笔记 ID：${noteId}`);
+        console.log(`   隐私状态：${visibility}`);
+        console.log(`   访问地址：https://mowen.cn/note/${noteId}\n`);
+    }
+    catch (err) {
+        console.error('设置失败：', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/mast/to-markdown.js

@@ -35,6 +35,8 @@ function serializeBlock(block, doc) {
             return serializeImage(block);
         case 'audio':
             return serializeAudio(block);
+        case 'codeblock':
+            return serializeCodeBlock(block);
     }
 }
 function serializeParagraph(block) {
@@ -64,6 +66,10 @@ function serializeAudio(block) {
     const src = block.uuid ? block.src : block.src;
     return `![audio: ${block.showNote}](${src})`;
 }
+function serializeCodeBlock(block) {
+    const lang = block.language || '';
+    return '```' + lang + '\n' + block.content + '\n```';
+}
 function serializeTextRun(run) {
     if (!run.marks)
         return run.text;

package/dist/mowen/client.js

@@ -61,6 +61,18 @@ export class MowenClient {
     async editNote(noteId, body) {
         await this.request('/api/open/api/v1/note/edit', { noteId, body });
     }
+    /** 设置笔记隐私状态 */
+    async setPrivacy(noteId, visibility) {
+        await this.request('/api/open/api/v1/note/settings', {
+            noteId,
+            section: 1,
+            settings: {
+                privacy: {
+                    type: visibility,
+                },
+            },
+        });
+    }
 }
 export class MowenApiError extends Error {
     code;

package/dist/noteatom/from-mast.js

@@ -24,6 +24,8 @@ function convertBlock(block, doc) {
             return [convertImage(block)];
         case 'audio':
             return [convertAudio(block)];
+        case 'codeblock':
+            return [convertCodeBlock(block)];
     }
 }
 function convertParagraph(block) {
@@ -79,6 +81,15 @@ function convertAudio(block) {
         },
     };
 }
+function convertCodeBlock(block) {
+    return {
+        type: 'codeblock',
+        attrs: {
+            language: block.language,
+        },
+        content: block.content,
+    };
+}
 // ── 行内节点转换 ───────────────────────────────────────────────────────────────
 function convertTextRun(run) {
     const node = { type: 'text', text: run.text };

package/dist/noteatom/to-mast.js

@@ -27,6 +27,8 @@ function convertNode(node, blocks) {
             return convertImage(node, blocks);
         case 'audio':
             return convertAudio(node, blocks);
+        case 'codeblock':
+            return convertCodeBlock(node, blocks);
     }
 }
 function convertParagraph(block, blocks) {
@@ -72,6 +74,17 @@ function convertAudio(block, blocks) {
     blocks[id] = mast;
     return id;
 }
+function convertCodeBlock(block, blocks) {
+    const id = newId();
+    const mast = {
+        id,
+        type: 'codeblock',
+        language: block.attrs.language ?? '',
+        content: block.content ?? '',
+    };
+    blocks[id] = mast;
+    return id;
+}
 // ── 行内节点转换 ───────────────────────────────────────────────────────────────
 function convertTextRun(run) {
     const mast = { type: 'text', text: run.text };

package/dist/pipeline/hast-to-mast.js

@@ -117,7 +117,7 @@ function makeEmptyParagraph() {
  * 将 HAST 元素转换为一组 MAST 块节点。
  * 返回数组是因为某些元素（如列表）会展开为多个块。
  */
-function convertBlock(node, doc) {
+function convertBlock(node, doc, opts = {}) {
     const tag = node.tagName;
     // ── 标题 ──────────────────────────────────────────────────────────────────
     if (/^h[1-6]$/.test(tag)) {
@@ -164,7 +164,7 @@ function convertBlock(node, doc) {
         for (const child of node.children) {
             if (!isElement(child))
                 continue;
-            const childBlocks = convertBlock(child, doc);
+            const childBlocks = convertBlock(child, doc, opts);
             for (const b of childBlocks) {
                 doc.blocks[b.id] = b;
                 childIds.push(b.id);
@@ -179,16 +179,43 @@ function convertBlock(node, doc) {
     }
     // ── 无序列表 ──────────────────────────────────────────────────────────────
     if (tag === 'ul') {
-        return convertList(node, doc, false, 0);
+        return convertList(node, doc, opts, false, 0);
     }
     // ── 有序列表 ──────────────────────────────────────────────────────────────
     if (tag === 'ol') {
-        return convertList(node, doc, true, 0);
+        return convertList(node, doc, opts, true, 0);
     }
     // ── 代码块 ────────────────────────────────────────────────────────────────
     if (tag === 'pre') {
         const codeEl = node.children.find((c) => isElement(c) && c.tagName === 'code');
         const rawText = codeEl ? extractTextContent(codeEl) : extractTextContent(node);
+        // 提取语言标识（从 code 元素的 className）
+        let language = '';
+        if (codeEl && codeEl.properties?.className) {
+            const classNames = Array.isArray(codeEl.properties.className)
+                ? codeEl.properties.className
+                : [codeEl.properties.className];
+            // 常见格式：language-js, lang-js, js 等
+            const langClass = classNames.find((c) => typeof c === 'string' && (c.startsWith('language-') || c.startsWith('lang-')));
+            if (langClass) {
+                language = langClass.replace(/^language-|^lang-/, '');
+            }
+            else if (classNames.length > 0 && typeof classNames[0] === 'string') {
+                // 直接使用第一个 class 名作为语言（如 typescript, python）
+                language = classNames[0];
+            }
+        }
+        // codeBlockStyle: codeblock → 生成 MASTCodeBlock
+        if (opts.codeBlockStyle === 'codeblock') {
+            const block = {
+                id: newId(),
+                type: 'codeblock',
+                language,
+                content: rawText.replace(/\n$/, ''),
+            };
+            return [block];
+        }
+        // 默认 paragraph 模式：每行转为带 code 标记的 paragraph
         const lines = rawText.replace(/\n$/, '').split('\n');
         return lines.map((line) => makeParagraph([{ type: 'text', text: line, marks: { code: true } }]));
     }
@@ -215,7 +242,7 @@ function convertBlock(node, doc) {
         const blocks = [];
         for (const child of node.children) {
             if (isElement(child)) {
-                blocks.push(...convertBlock(child, doc));
+                blocks.push(...convertBlock(child, doc, opts));
             }
         }
         return blocks;
@@ -228,7 +255,7 @@ function convertBlock(node, doc) {
     return [];
 }
 // ── 列表转换 ───────────────────────────────────────────────────────────────────
-function convertList(listEl, doc, ordered, depth) {
+function convertList(listEl, doc, opts, ordered, depth) {
     const blocks = [];
     let itemIndex = 1;
     const indent = '  '.repeat(depth);
@@ -248,10 +275,10 @@ function convertList(listEl, doc, ordered, depth) {
                 continue;
             }
             if (liChild.tagName === 'ul') {
-                nestedBlocks.push(...convertList(liChild, doc, false, depth + 1));
+                nestedBlocks.push(...convertList(liChild, doc, opts, false, depth + 1));
             }
             else if (liChild.tagName === 'ol') {
-                nestedBlocks.push(...convertList(liChild, doc, true, depth + 1));
+                nestedBlocks.push(...convertList(liChild, doc, opts, true, depth + 1));
             }
             else if (liChild.tagName === 'p') {
                 paragraphContent.push(...extractInlineContent(liChild));
@@ -315,13 +342,16 @@ function tableToMarkdown(tableEl) {
 // ── 主入口 ────────────────────────────────────────────────────────────────────
 /**
  * 将 HAST Root 转换为 MASTDocument。
+ *
+ * @param hast HAST Root 节点
+ * @param opts 转换选项
  */
-export function hastToMast(hast) {
+export function hastToMast(hast, opts = {}) {
     const doc = { blocks: {}, topLevel: [] };
     for (const node of hast.children) {
         if (!isElement(node))
             continue;
-        const blocks = convertBlock(node, doc);
+        const blocks = convertBlock(node, doc, opts);
         for (const block of blocks) {
             doc.blocks[block.id] = block;
             doc.topLevel.push(block.id);

package/dist/publish/process-directory.js

@@ -0,0 +1,118 @@
+import { readdir, lstat } from 'fs/promises';
+import { join, resolve, basename, extname } from 'path';
+import { processFile } from './process-file.js';
+/**
+ * 扫描目录中的 Markdown 文件
+ * - 递归扫描（除非 recursive = false）
+ * - 按文件名排序
+ * - 跳过隐藏文件、非 .md 文件、符号链接
+ */
+export async function scanMarkdownFiles(dirPath, recursive = true) {
+    const absPath = resolve(dirPath);
+    const files = [];
+    await scanDir(absPath, files, recursive);
+    // 按文件名排序（basename）
+    files.sort((a, b) => basename(a).localeCompare(basename(b)));
+    return files;
+}
+async function scanDir(dir, files, recursive) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        // 跳过隐藏文件（.开头）
+        if (entry.name.startsWith('.'))
+            continue;
+        // 跳过符号链接
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory() && recursive) {
+            await scanDir(fullPath, files, recursive);
+        }
+        else if (entry.isFile() && extname(entry.name).toLowerCase() === '.md') {
+            files.push(fullPath);
+        }
+    }
+}
+/**
+ * 批量发布目录中的 Markdown 文件
+ */
+export async function processDirectory(dirPath, client, opts = {}) {
+    const { recursive = true } = opts;
+    const absDirPath = resolve(dirPath);
+    // 检查目录是否存在
+    const dirStat = await lstat(absDirPath);
+    if (!dirStat.isDirectory()) {
+        throw new Error(`路径不是目录: ${absDirPath}`);
+    }
+    // 扫描文件
+    const files = await scanMarkdownFiles(absDirPath, recursive);
+    // 空目录处理
+    if (files.length === 0) {
+        console.log(`目录 ${absDirPath} 中没有 Markdown 文件`);
+        return { total: 0, success: 0, failed: 0, skipped: 0, files: [] };
+    }
+    console.log(`发现 ${files.length} 个 Markdown 文件，开始发布...\n`);
+    const results = [];
+    let index = 0;
+    for (const filePath of files) {
+        index++;
+        const fileName = basename(filePath);
+        console.log(`[${index}/${files.length}] ${fileName}`);
+        try {
+            const result = await processFile(filePath, client, opts);
+            results.push({
+                filePath,
+                status: 'success',
+                ...(result.noteId ? { noteId: result.noteId } : {}),
+                ...(result.noteUrl ? { noteUrl: result.noteUrl } : {}),
+            });
+            console.log(`  ✅ 发布成功: ${result.noteUrl ?? '(dry-run)'}\n`);
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            results.push({
+                filePath,
+                status: 'failed',
+                error: errorMsg,
+            });
+            console.log(`  ❌ 发布失败: ${errorMsg}\n`);
+        }
+        // 文件间隔 1.1 秒（最后一个文件不等待）
+        if (index < files.length) {
+            await sleep(1100);
+        }
+    }
+    // 汇总报告
+    const summary = computeSummary(results);
+    printSummary(summary);
+    return summary;
+}
+function computeSummary(files) {
+    const success = files.filter((f) => f.status === 'success').length;
+    const failed = files.filter((f) => f.status === 'failed').length;
+    const skipped = files.filter((f) => f.status === 'skipped').length;
+    return {
+        total: files.length,
+        success,
+        failed,
+        skipped,
+        files,
+    };
+}
+function printSummary(result) {
+    console.log('── 发布汇总 ──────────────────────────────────────────');
+    console.log(`总计：${result.total} 个文件`);
+    console.log(`  ✅ 成功：${result.success}`);
+    console.log(`  ❌ 失败：${result.failed}`);
+    console.log(`  ⏭️  跳过：${result.skipped}`);
+    if (result.failed > 0) {
+        console.log('\n失败文件：');
+        for (const f of result.files.filter((f) => f.status === 'failed')) {
+            console.log(`  - ${basename(f.filePath)}: ${f.error ?? '未知错误'}`);
+        }
+    }
+    console.log('──────────────────────────────────────────────────────\n');
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/publish/process-file.js

@@ -8,7 +8,7 @@ import { mastToNoteAtom } from '../noteatom/from-mast.js';
  * 单文件完整流水线：Markdown → HAST → MAST → 资源上传 → NoteAtom → 发布
  */
 export async function processFile(filePath, client, opts = {}) {
-    const { noteId, tags, autoPublish = false, dryRun = false, cacheDir } = opts;
+    const { noteId, tags, autoPublish = false, dryRun = false, cacheDir, codeBlockStyle } = opts;
     // ── 阶段 00：读取文件 ────────────────────────────────────────────────────────
     const absPath = resolve(filePath);
     const markdown = await readFile(absPath, 'utf8');
@@ -17,7 +17,7 @@ export async function processFile(filePath, client, opts = {}) {
     const hast = mdToHast(markdown);
     await writeCache(cacheDir, '01-hast.json', hast);
     // ── 阶段 02：HAST → MAST ─────────────────────────────────────────────────────
-    const mast = hastToMast(hast);
+    const mast = hastToMast(hast, codeBlockStyle ? { codeBlockStyle } : {});
     await writeCache(cacheDir, '02-mast.json', mast);
     // ── 阶段 03：资源处理 ────────────────────────────────────────────────────────
     await processAssets(mast, client, { baseDir, dryRun });
@@ -51,6 +51,7 @@ function collectStats(mast, dryRun) {
     let images = 0;
     let tables = 0;
     let audios = 0;
+    let codeblocks = 0;
     for (const block of Object.values(mast.blocks)) {
         if (block.type === 'paragraph')
             paragraphs++;
@@ -64,6 +65,8 @@ function collectStats(mast, dryRun) {
         }
         else if (block.type === 'audio')
             audios++;
+        else if (block.type === 'codeblock')
+            codeblocks++;
     }
     return {
         paragraphs,
@@ -71,7 +74,8 @@ function collectStats(mast, dryRun) {
         images,
         tables,
         audios,
-        totalBlocks: paragraphs + quotes + images + tables + audios,
+        codeblocks,
+        totalBlocks: paragraphs + quotes + images + tables + audios + codeblocks,
         uploadedAssets: dryRun ? 0 : images + tables + audios,
     };
 }
@@ -85,6 +89,7 @@ function printDryRunReport(filePath, stats, noteAtom) {
     console.log(`  图片块：    ${stats.images}`);
     console.log(`  表格块：    ${stats.tables}`);
     console.log(`  音频块：    ${stats.audios}`);
+    console.log(`  代码块：    ${stats.codeblocks}`);
     console.log(`  总块数：    ${stats.totalBlocks}`);
     console.log(`  待上传资源：${stats.images + stats.tables + stats.audios}（dry-run 跳过）`);
     console.log(`\nNoteAtom 预览（前 3 个块）：`);

package/dist/shared/config.js

@@ -0,0 +1,116 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const DEFAULT_CONFIG = {
+    defaultTags: '',
+    autoPublish: false,
+    codeBlockStyle: 'paragraph',
+    cacheDir: 'out/pipeline-cache',
+};
+// ── 环境变量映射 ───────────────────────────────────────────────────────────────
+function readEnvConfig() {
+    const config = {};
+    const tags = process.env.MOWEN_DEFAULT_TAGS;
+    if (tags !== undefined) {
+        config.defaultTags = tags;
+    }
+    const autoPublish = process.env.MOWEN_AUTO_PUBLISH;
+    if (autoPublish !== undefined) {
+        config.autoPublish = autoPublish === 'true' || autoPublish === '1';
+    }
+    const codeBlockStyle = process.env.MOWEN_CODE_BLOCK_STYLE;
+    if (codeBlockStyle !== undefined) {
+        if (codeBlockStyle === 'paragraph' || codeBlockStyle === 'codeblock') {
+            config.codeBlockStyle = codeBlockStyle;
+        }
+        else {
+            console.warn(`[config] MOWEN_CODE_BLOCK_STYLE="${codeBlockStyle}" 无效，忽略（支持：paragraph, codeblock）`);
+        }
+    }
+    const cacheDir = process.env.MOWEN_CACHE_DIR;
+    if (cacheDir !== undefined) {
+        config.cacheDir = cacheDir;
+    }
+    return config;
+}
+function loadConfigFile(path, label) {
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        // 验证并过滤已知字段
+        const validConfig = {};
+        if ('defaultTags' in parsed && typeof parsed.defaultTags === 'string') {
+            validConfig.defaultTags = parsed.defaultTags;
+        }
+        if ('autoPublish' in parsed && typeof parsed.autoPublish === 'boolean') {
+            validConfig.autoPublish = parsed.autoPublish;
+        }
+        if ('codeBlockStyle' in parsed) {
+            const style = parsed.codeBlockStyle;
+            if (style === 'paragraph' || style === 'codeblock') {
+                validConfig.codeBlockStyle = style;
+            }
+            else {
+                console.warn(`[config] ${label}: codeBlockStyle="${style}" 无效，忽略（支持：paragraph, codeblock）`);
+            }
+        }
+        if ('cacheDir' in parsed && typeof parsed.cacheDir === 'string') {
+            validConfig.cacheDir = parsed.cacheDir;
+        }
+        // 未知字段忽略（向前兼容）
+        const knownKeys = ['defaultTags', 'autoPublish', 'codeBlockStyle', 'cacheDir'];
+        const unknownKeys = Object.keys(parsed).filter((k) => !knownKeys.includes(k));
+        if (unknownKeys.length > 0) {
+            console.warn(`[config] ${label}: 忽略未知字段 ${unknownKeys.join(', ')}`);
+        }
+        return { config: validConfig, source: label };
+    }
+    catch (err) {
+        console.warn(`[config] ${label}: JSON 解析失败，使用默认值`);
+        console.warn(`         错误：${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+// ── 配置路径查找 ───────────────────────────────────────────────────────────────
+export function getConfigPaths(projectRoot) {
+    const cwd = projectRoot ?? process.cwd();
+    return {
+        project: join(cwd, '.md-to-mowen', 'config.json'),
+        user: join(homedir(), '.md-to-mowen', 'config.json'),
+    };
+}
+// ── 主入口：合并配置 ───────────────────────────────────────────────────────────
+/**
+ * 按优先级合并配置：CLI > env > 项目 > 用户 > 默认
+ *
+ * @param cliOverrides CLI 参数覆盖（最高优先级）
+ * @param projectRoot 项目根目录（用于查找项目级配置）
+ */
+export function loadConfig(cliOverrides = {}, projectRoot) {
+    const paths = getConfigPaths(projectRoot);
+    // 1. 用户级配置（最低优先级）
+    const userResult = loadConfigFile(paths.user, '用户级配置');
+    // 2. 项目级配置（优先于用户级）
+    const projectResult = loadConfigFile(paths.project, '项目级配置');
+    // 3. 环境变量配置（优先于配置文件）
+    const envConfig = readEnvConfig();
+    // 4. 合并（从低到高优先级）
+    const merged = {
+        ...userResult?.config,
+        ...projectResult?.config,
+        ...envConfig,
+        ...cliOverrides,
+    };
+    // 5. 应用默认值
+    return {
+        defaultTags: merged.defaultTags ?? DEFAULT_CONFIG.defaultTags,
+        autoPublish: merged.autoPublish ?? DEFAULT_CONFIG.autoPublish,
+        codeBlockStyle: merged.codeBlockStyle ?? DEFAULT_CONFIG.codeBlockStyle,
+        cacheDir: merged.cacheDir ?? DEFAULT_CONFIG.cacheDir,
+    };
+}
+// ── 导出默认值供测试使用 ──────────────────────────────────────────────────────
+export { DEFAULT_CONFIG };

package/dist/shared/metadata.js

@@ -0,0 +1,249 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, openSync, writeSync, fsyncSync, closeSync, renameSync, unlinkSync, } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+const METADATA_FILENAME = 'metadata.json';
+const TMP_SUFFIX = '.tmp';
+const BAK_SUFFIX = '.bak';
+const LOCK_SUFFIX = '.lock';
+const LOCK_EXPIRE_MS = 30_000; // 锁过期时间：30秒
+const LOCK_WAIT_MS = 5_000; // 等待锁的最大时间：5秒
+const LOCK_RETRY_MS = 100; // 重试间隔：100毫秒
+function emptyStore() {
+    return { version: 1, notes: {} };
+}
+/**
+ * 查找元数据文件路径（项目级优先于用户级）。
+ * 项目级：CWD/.md-to-mowen/metadata.json
+ * 用户级：~/.md-to-mowen/metadata.json
+ */
+export function findMetadataPath(projectRoot) {
+    const projectDir = projectRoot ?? process.cwd();
+    const projectPath = join(projectDir, '.md-to-mowen', METADATA_FILENAME);
+    const userPath = join(homedir(), '.md-to-mowen', METADATA_FILENAME);
+    if (existsSync(projectPath))
+        return projectPath;
+    if (existsSync(userPath))
+        return userPath;
+    // 默认写入项目级
+    return projectPath;
+}
+/** 尝试解析元数据文件，返回解析结果或 null */
+function tryParseMetadata(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const data = JSON.parse(raw);
+        if (data && typeof data === 'object' && data.version === 1 && typeof data.notes === 'object') {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 读取元数据，文件不存在或损坏时返回空 store */
+export function readMetadata(filePath) {
+    // 优先尝试读取主文件
+    const mainData = tryParseMetadata(filePath);
+    if (mainData)
+        return mainData;
+    // 主文件不存在或损坏，尝试读取备份
+    const bakPath = filePath + BAK_SUFFIX;
+    const bakData = tryParseMetadata(bakPath);
+    if (bakData) {
+        console.warn(`警告：元数据文件损坏，已从备份恢复：${filePath}`);
+        return bakData;
+    }
+    // 主文件和备份都不存在或都损坏
+    if (existsSync(filePath)) {
+        console.warn(`警告：元数据文件及备份均损坏，已重新创建：${filePath}`);
+    }
+    return emptyStore();
+}
+/** 原子写入元数据：先写临时文件，fsync 后再 rename */
+export function writeMetadata(filePath, store) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const tmpPath = filePath + TMP_SUFFIX;
+    const bakPath = filePath + BAK_SUFFIX;
+    const content = JSON.stringify(store, null, 2) + '\n';
+    // 1. 写入临时文件
+    let fd;
+    try {
+        fd = openSync(tmpPath, 'w');
+        writeSync(fd, content, 0, 'utf8');
+        // 2. fsync 确保落盘
+        fsyncSync(fd);
+        closeSync(fd);
+        fd = undefined;
+        // 3. 将现有文件重命名为备份（如果存在）
+        if (existsSync(filePath)) {
+            // 删除旧备份（不累积历史版本）
+            if (existsSync(bakPath)) {
+                unlinkSync(bakPath);
+            }
+            renameSync(filePath, bakPath);
+        }
+        // 4. 将临时文件重命名为正式文件
+        renameSync(tmpPath, filePath);
+    }
+    finally {
+        // 确保 fd 被关闭（如果中途出错）
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        // 清理临时文件（如果写入失败且临时文件残留）
+        if (existsSync(tmpPath)) {
+            try {
+                unlinkSync(tmpPath);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+/** 根据绝对路径查找已有记录 */
+export function lookupNote(store, absPath) {
+    return store.notes[absPath];
+}
+/** 更新或新增一条记录 */
+export function upsertNote(store, absPath, noteId) {
+    const now = new Date().toISOString();
+    const existing = store.notes[absPath];
+    if (existing) {
+        store.notes[absPath] = { ...existing, noteId, updatedAt: now };
+    }
+    else {
+        store.notes[absPath] = { noteId, createdAt: now, updatedAt: now };
+    }
+}
+/** 创建锁文件信息 */
+function createLockInfo() {
+    return {
+        pid: process.pid,
+        createdAt: new Date().toISOString(),
+    };
+}
+/** 解析锁文件，损坏时返回 null */
+function parseLockFile(lockPath) {
+    if (!existsSync(lockPath))
+        return null;
+    try {
+        const raw = readFileSync(lockPath, 'utf8');
+        const data = JSON.parse(raw);
+        if (data && typeof data === 'object' && typeof data.pid === 'number' && typeof data.createdAt === 'string') {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 检查锁是否过期 */
+function isLockExpired(lockInfo) {
+    const lockTime = new Date(lockInfo.createdAt).getTime();
+    const now = Date.now();
+    return now - lockTime > LOCK_EXPIRE_MS;
+}
+/** 等待并获取锁 */
+async function acquireLock(lockPath) {
+    const startTime = Date.now();
+    while (true) {
+        const existingLock = parseLockFile(lockPath);
+        if (!existingLock) {
+            // 无锁或锁文件损坏，尝试创建锁
+            try {
+                const lockInfo = createLockInfo();
+                const dir = dirname(lockPath);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                writeFileSync(lockPath, JSON.stringify(lockInfo), 'utf8');
+                return; // 成功获取锁
+            }
+            catch {
+                // 写入失败，可能被其他进程抢先，继续重试
+            }
+        }
+        else if (isLockExpired(existingLock)) {
+            // 锁已过期，强制获取（删除旧锁）
+            try {
+                unlinkSync(lockPath);
+                const lockInfo = createLockInfo();
+                writeFileSync(lockPath, JSON.stringify(lockInfo), 'utf8');
+                return; // 成功获取锁
+            }
+            catch {
+                // 删除或写入失败，继续重试
+            }
+        }
+        else {
+            // 锁有效且未过期，继续等待
+        }
+        // 检查是否超时
+        if (Date.now() - startTime > LOCK_WAIT_MS) {
+            const holderPid = existingLock?.pid ?? 'unknown';
+            const holderTime = existingLock?.createdAt ?? 'unknown';
+            throw new Error(`获取文件锁超时（等待 ${LOCK_WAIT_MS}ms）。锁文件：${lockPath}，持有者 PID：${holderPid}，创建时间：${holderTime}`);
+        }
+        // 等待后重试
+        await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+    }
+}
+/** 释放锁 */
+async function releaseLock(lockPath) {
+    try {
+        if (existsSync(lockPath)) {
+            unlinkSync(lockPath);
+        }
+    }
+    catch {
+        // 释放失败时忽略（可能是其他进程已删除）
+    }
+}
+/** 异步读取元数据 */
+export async function readMetadataAsync(filePath) {
+    return readMetadata(filePath);
+}
+/** 异步写入元数据 */
+export async function writeMetadataAsync(filePath, store) {
+    return writeMetadata(filePath, store);
+}
+/**
+ * 在锁保护下执行读-修改-写操作。
+ * 整个过程加锁，保证原子性。
+ *
+ * @param filePath 元数据文件路径
+ * @param operation 修改操作函数，接收当前 store，返回更新后的 store
+ * @throws 锁等待超时时抛出错误
+ */
+export async function withLock(filePath, operation) {
+    const lockPath = filePath + LOCK_SUFFIX;
+    await acquireLock(lockPath);
+    try {
+        const store = await readMetadataAsync(filePath);
+        const updated = operation(store);
+        await writeMetadataAsync(filePath, updated);
+    }
+    finally {
+        await releaseLock(lockPath);
+    }
+}
+/** 导出锁相关常量供测试使用 */
+export const LOCK_CONSTANTS = {
+    LOCK_EXPIRE_MS,
+    LOCK_WAIT_MS,
+    LOCK_RETRY_MS,
+    LOCK_SUFFIX,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md-to-mowen",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "将 Markdown（GFM）转换为墨问笔记的 CLI 工具",
   "type": "module",
   "bin": {