md-to-mowen 1.3.1 → 1.4.0

package/README.md

@@ -165,3 +165,5 @@ npm link
 ## License
 
 MIT
+
+# md-to-mowen

package/dist/cli/index.js

@@ -120,6 +120,7 @@ program
     .option('--cache-dir <dir>', '保存各阶段产物的目录（调试用）')
     .option('--code-block-style <style>', '代码块样式：paragraph 或 codeblock')
     .option('--no-recursive', '批量发布时不递归扫描子目录', false)
+    .option('--quiet', '静默模式：抑制进度条，仅输出最终汇总', false)
     .action(async (opts) => {
     const apiKey = getApiKey();
     if (!apiKey && !opts.dryRun) {
@@ -171,6 +172,7 @@ program
                 dryRun: opts.dryRun,
                 cacheDir: resolvedConfig.cacheDir,
                 recursive: !opts.noRecursive,
+                quiet: opts.quiet,
             });
             // 批量模式下，有失败则 exit 1
             if (result.failed > 0) {
@@ -197,6 +199,7 @@ program
                     dryRun: opts.dryRun,
                     cacheDir: resolvedConfig.cacheDir,
                     codeBlockStyle: resolvedConfig.codeBlockStyle,
+                    quiet: opts.quiet,
                 });
                 if (!result.dryRun && result.noteId) {
                     upsertNote(metaStore, absInput, result.noteId);
@@ -319,4 +322,42 @@ program
         process.exit(1);
     }
 });
+// ── status ───────────────────────────────────────────────────────────────────
+program
+    .command('status')
+    .description('查看已发布笔记的状态')
+    .option('-i, --input <path>', '查看指定文件的发布状态')
+    .option('--json', '输出 JSON 格式')
+    .action(async (opts) => {
+    const metaPath = findMetadataPath();
+    const metaStore = readMetadata(metaPath);
+    const cwd = process.cwd();
+    if (opts.input) {
+        // 单文件查询
+        const { lookupFileStatus, formatStatusTable, formatStatusJson } = await import('./status.js');
+        const absInput = resolve(opts.input);
+        const entry = lookupFileStatus(metaStore, absInput, cwd);
+        if (!entry) {
+            console.error(`未发布：${opts.input}（元数据中无记录）`);
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(formatStatusJson([entry]));
+        }
+        else {
+            console.log(formatStatusTable([entry]));
+        }
+    }
+    else {
+        // 列出所有
+        const { listAllNotes, formatStatusTable, formatStatusJson } = await import('./status.js');
+        const entries = listAllNotes(metaStore, cwd);
+        if (opts.json) {
+            console.log(formatStatusJson(entries));
+        }
+        else {
+            console.log(formatStatusTable(entries));
+        }
+    }
+});
 program.parse();

package/dist/cli/status.js

@@ -0,0 +1,44 @@
+import { relative } from 'path';
+const MOWEN_NOTE_BASE_URL = 'https://mowen.cn/note';
+/** 将 NoteRecord 转为 StatusEntry，路径转为相对于 cwd 的相对路径 */
+function toEntry(absPath, record, cwd) {
+    return {
+        file: relative(cwd, absPath),
+        noteId: record.noteId,
+        noteUrl: `${MOWEN_NOTE_BASE_URL}/${record.noteId}`,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt,
+    };
+}
+/** 列出所有已发布文件 */
+export function listAllNotes(store, cwd) {
+    return Object.entries(store.notes).map(([absPath, record]) => toEntry(absPath, record, cwd));
+}
+/** 查询单个文件的发布状态，未发布返回 null */
+export function lookupFileStatus(store, absPath, cwd) {
+    const record = store.notes[absPath];
+    if (!record)
+        return null;
+    return toEntry(absPath, record, cwd);
+}
+/** 格式化为表格文本 */
+export function formatStatusTable(entries) {
+    if (entries.length === 0) {
+        return '暂无已发布笔记。';
+    }
+    // 计算列宽
+    const fileWidth = Math.max(6, ...entries.map((e) => e.file.length));
+    const idWidth = Math.max(8, ...entries.map((e) => e.noteId.length));
+    const header = `${'文件'.padEnd(fileWidth)}  ${'笔记 ID'.padEnd(idWidth)}  更新时间`;
+    const divider = `${'─'.repeat(fileWidth)}  ${'─'.repeat(idWidth)}  ${'─'.repeat(24)}`;
+    const rows = entries.map((e) => {
+        const time = e.updatedAt.replace('T', ' ').replace(/\.\d{3}Z$/, '');
+        return `${e.file.padEnd(fileWidth)}  ${e.noteId.padEnd(idWidth)}  ${time}`;
+    });
+    const links = entries.map((e) => `  → ${e.noteUrl}`);
+    return [header, divider, ...rows, '', ...links].join('\n');
+}
+/** 格式化为 JSON */
+export function formatStatusJson(entries) {
+    return JSON.stringify(entries, null, 2) + '\n';
+}

package/dist/mast/to-markdown.js

@@ -37,6 +37,10 @@ function serializeBlock(block, doc) {
             return serializeAudio(block);
         case 'codeblock':
             return serializeCodeBlock(block);
+        case 'note':
+            return serializeNote(block);
+        case 'pdf':
+            return serializePdf(block);
     }
 }
 function serializeParagraph(block) {
@@ -70,6 +74,12 @@ function serializeCodeBlock(block) {
     const lang = block.language || '';
     return '```' + lang + '\n' + block.content + '\n```';
 }
+function serializeNote(block) {
+    return `![[note:${block.noteId}]]`;
+}
+function serializePdf(block) {
+    return `![[pdf:${block.src}]]`;
+}
 function serializeTextRun(run) {
     if (!run.marks)
         return run.text;
@@ -91,6 +101,9 @@ function serializeTextRun(run) {
     // italic
     if (run.marks.italic)
         text = `*${text}*`;
+    // highlight
+    if (run.marks.highlight)
+        text = `==${text}==`;
     // link 最后包裹（outermost）
     if (run.marks.link)
         text = `[${text}](${run.marks.link})`;

package/dist/mowen/upload.js

@@ -19,12 +19,14 @@ function mimeFromFileName(fileName) {
 /**
  * 上传本地图片文件，返回 fileId。
  * 使用两步 OSS 上传流程：prepare → multipart POST。
+ *
+ * @param alt 可选的替代文本，用作上传文件名。为空时不传文件名（图片不带标题）。
  */
-export async function uploadLocalFile(filePath, client) {
-    const fileName = basename(filePath);
+export async function uploadLocalFile(filePath, client, alt) {
+    const fileName = alt?.trim() || '';
     const fileBuffer = await readFile(filePath);
     const form = await client.uploadPrepare(1, fileName);
-    await ossUpload(form, fileBuffer, fileName);
+    await ossUpload(form, fileBuffer, fileName || basename(filePath));
     return form['x:file_id'];
 }
 /**
@@ -36,18 +38,21 @@ export async function uploadRemoteUrl(url, client) {
 /**
  * 上传 Data URI 图片，返回 fileId。
  * 支持 data:image/png;base64,... 格式。
+ *
+ * @param alt 可选的替代文本，用作上传文件名。为空时不传文件名（图片不带标题）。
  */
-export async function uploadDataUri(dataUri, client) {
+export async function uploadDataUri(dataUri, client, alt) {
     const match = dataUri.match(/^data:([^;]+);base64,(.+)$/);
     if (!match)
         throw new Error(`Invalid data URI: ${dataUri.slice(0, 40)}`);
     const mime = match[1] ?? 'image/png';
     const b64 = match[2] ?? '';
     const ext = mime.split('/')[1] ?? 'png';
-    const fileName = `image.${ext}`;
+    const uploadFileName = alt?.trim() || '';
+    const ossFileName = `image.${ext}`;
     const buffer = Buffer.from(b64, 'base64');
-    const form = await client.uploadPrepare(1, fileName);
-    await ossUpload(form, buffer, fileName);
+    const form = await client.uploadPrepare(1, uploadFileName);
+    await ossUpload(form, buffer, ossFileName);
     return form['x:file_id'];
 }
 /**

package/dist/noteatom/from-mast.js

@@ -26,6 +26,10 @@ function convertBlock(block, doc) {
             return [convertAudio(block)];
         case 'codeblock':
             return [convertCodeBlock(block)];
+        case 'note':
+            return [convertNote(block)];
+        case 'pdf':
+            return [convertPdf(block)];
     }
 }
 function convertParagraph(block) {
@@ -90,13 +94,32 @@ function convertCodeBlock(block) {
         content: block.content,
     };
 }
+function convertNote(block) {
+    return {
+        type: 'note',
+        attrs: {
+            uuid: block.noteId,
+        },
+    };
+}
+function convertPdf(block) {
+    if (!block.uuid) {
+        throw new Error(`MASTPdfBlock ${block.id} has no uuid — run asset processing before serialization`);
+    }
+    return {
+        type: 'pdf',
+        attrs: {
+            uuid: block.uuid,
+        },
+    };
+}
 // ── 行内节点转换 ───────────────────────────────────────────────────────────────
 function convertTextRun(run) {
     const node = { type: 'text', text: run.text };
     if (!run.marks)
         return node;
     const marks = [];
-    // 按优先级顺序：code → strikethrough → bold → italic → link
+    // 按优先级顺序：code → strikethrough → bold → italic → highlight → link
     if (run.marks.code)
         marks.push({ type: 'code' });
     if (run.marks.strikethrough)
@@ -105,6 +128,8 @@ function convertTextRun(run) {
         marks.push({ type: 'bold' });
     if (run.marks.italic)
         marks.push({ type: 'italic' });
+    if (run.marks.highlight)
+        marks.push({ type: 'highlight' });
     if (run.marks.link)
         marks.push({ type: 'link', attrs: { href: run.marks.link } });
     if (marks.length > 0)

package/dist/noteatom/to-mast.js

@@ -29,6 +29,10 @@ function convertNode(node, blocks) {
             return convertAudio(node, blocks);
         case 'codeblock':
             return convertCodeBlock(node, blocks);
+        case 'note':
+            return convertNote(node, blocks);
+        case 'pdf':
+            return convertPdf(node, blocks);
     }
 }
 function convertParagraph(block, blocks) {
@@ -85,6 +89,27 @@ function convertCodeBlock(block, blocks) {
     blocks[id] = mast;
     return id;
 }
+function convertNote(block, blocks) {
+    const id = newId();
+    const mast = {
+        id,
+        type: 'note',
+        noteId: block.attrs.uuid,
+    };
+    blocks[id] = mast;
+    return id;
+}
+function convertPdf(block, blocks) {
+    const id = newId();
+    const mast = {
+        id,
+        type: 'pdf',
+        src: `mowen://file/${block.attrs.uuid}`,
+        uuid: block.attrs.uuid,
+    };
+    blocks[id] = mast;
+    return id;
+}
 // ── 行内节点转换 ───────────────────────────────────────────────────────────────
 function convertTextRun(run) {
     const mast = { type: 'text', text: run.text };
@@ -105,6 +130,9 @@ function convertTextRun(run) {
             case 'strikethrough':
                 marks.strikethrough = true;
                 break;
+            case 'highlight':
+                marks.highlight = true;
+                break;
             case 'link':
                 marks.link = mark.attrs.href;
                 break;

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

@@ -1,3 +1,4 @@
+import { HIGHLIGHT_MARKER } from './md-to-hast.js';
 // ── ID 生成 ────────────────────────────────────────────────────────────────────
 let _counter = 0;
 function newId() {
@@ -18,21 +19,65 @@ function getTagName(node) {
     return isElement(node) ? node.tagName : null;
 }
 // ── 行内节点提取 ───────────────────────────────────────────────────────────────
+/**
+ * 处理含高亮标记（⸻）的文本节点。
+ * 将文本按 marker 分割，根据当前高亮状态决定哪些段落加 highlight mark。
+ *
+ * 例（hlActive=false）："普通 ⸻高亮⸻ 文本"
+ *   → [{ text: "普通" }, { text: "高亮", marks: { highlight } }, { text: " 文本" }]
+ *
+ * 例（hlActive=true，从前节点继承）："⸻ 混合。"
+ *   → [{ text: " 混合。" }]   ← marker 关闭高亮，后续文本正常
+ *
+ * @param hlActive 从前序节点继承的高亮状态
+ * @returns runs 生成的 TextRun 列表
+ * @returns lastHighlighted 末段是否仍处于高亮状态（供后续节点继承）
+ */
+function processTextWithHighlight(text, marks, hlActive) {
+    const parts = text.split(HIGHLIGHT_MARKER);
+    const runs = [];
+    for (let i = 0; i < parts.length; i++) {
+        // 每个 marker 切换高亮状态（无论当前段是否为空）
+        if (i > 0)
+            hlActive = !hlActive;
+        const part = parts[i];
+        if (!part)
+            continue; // 跳过空段（marker 相邻或位于首尾）
+        const run = { type: 'text', text: part };
+        const merged = { ...marks, ...(hlActive ? { highlight: true } : {}) };
+        if (Object.keys(merged).length > 0) {
+            run.marks = merged;
+        }
+        runs.push(run);
+    }
+    return { runs, lastHighlighted: hlActive };
+}
 /**
  * 递归遍历 HAST 行内节点树，将嵌套标记展平为 MASTTextRun 列表。
  * 例：<strong><em>text</em></strong> → [{ text, marks: { bold, italic } }]
+ *
+ * @param highlightActive 是否继承前序节点的高亮状态（用于跨节点高亮）
  */
-function extractInline(nodes, marks = {}) {
+function extractInline(nodes, marks = {}, highlightActive = false) {
     const runs = [];
+    let hlActive = highlightActive;
     for (const node of nodes) {
         if (isText(node)) {
             if (node.value) {
-                const run = { type: 'text', text: node.value };
-                const activeMarks = { ...marks };
-                if (Object.keys(activeMarks).length > 0) {
-                    run.marks = activeMarks;
+                if (node.value.includes(HIGHLIGHT_MARKER)) {
+                    // 含高亮 marker：分割处理
+                    const result = processTextWithHighlight(node.value, marks, hlActive);
+                    runs.push(...result.runs);
+                    hlActive = result.lastHighlighted;
+                }
+                else {
+                    const run = { type: 'text', text: node.value };
+                    const activeMarks = hlActive ? { ...marks, highlight: true } : { ...marks };
+                    if (Object.keys(activeMarks).length > 0) {
+                        run.marks = activeMarks;
+                    }
+                    runs.push(run);
                 }
-                runs.push(run);
             }
             continue;
         }
@@ -53,6 +98,9 @@ function extractInline(nodes, marks = {}) {
             case 'del':
                 childMarks.strikethrough = true;
                 break;
+            case 'mark':
+                childMarks.highlight = true;
+                break;
             case 'a': {
                 const href = node.properties?.href ?? '';
                 // 忽略纯锚点链接（fragment links）
@@ -68,7 +116,13 @@ function extractInline(nodes, marks = {}) {
             case 'img':
                 continue;
         }
-        runs.push(...extractInline(node.children ?? [], childMarks));
+        const childRuns = extractInline(node.children ?? [], childMarks, hlActive);
+        runs.push(...childRuns);
+        // 更新 hlActive：如果子节点处理后仍处于高亮状态，继承下去
+        const lastRun = childRuns[childRuns.length - 1];
+        if (lastRun) {
+            hlActive = !!lastRun.marks?.highlight;
+        }
     }
     return runs;
 }
@@ -104,6 +158,7 @@ function marksEqual(a, b) {
         a.italic === b.italic &&
         a.code === b.code &&
         a.strikethrough === b.strikethrough &&
+        a.highlight === b.highlight &&
         a.link === b.link);
 }
 // ── 块节点转换 ─────────────────────────────────────────────────────────────────
@@ -117,7 +172,7 @@ function makeEmptyParagraph() {
  * 将 HAST 元素转换为一组 MAST 块节点。
  * 返回数组是因为某些元素（如列表）会展开为多个块。
  */
-function convertBlock(node, doc, opts = {}) {
+function convertBlock(node, doc, opts = {}, warnings = []) {
     const tag = node.tagName;
     // ── 标题 ──────────────────────────────────────────────────────────────────
     if (/^h[1-6]$/.test(tag)) {
@@ -125,6 +180,7 @@ function convertBlock(node, doc, opts = {}) {
         // H1–H6 全部 → bold paragraph
         const extraMarks = { bold: true };
         const content = extractInlineContent(node, extraMarks);
+        warnings.push({ type: 'heading', message: `H${level} 标题转换为加粗段落（墨问不支持标题层级）`, source: tag });
         return [makeParagraph(content)];
     }
     // ── 段落 ──────────────────────────────────────────────────────────────────
@@ -145,6 +201,28 @@ function convertBlock(node, doc, opts = {}) {
                 };
                 return [block];
             }
+            // 内链笔记约定：alt 以 "note:" 开头，src 以 "note:" 开头
+            if (alt.startsWith('note:') && src.startsWith('note:')) {
+                const noteId = alt.slice('note:'.length).trim();
+                const block = {
+                    id: newId(),
+                    type: 'note',
+                    noteId,
+                };
+                return [block];
+            }
+            // PDF 嵌入约定：alt 以 "pdf:" 开头，src 以 "pdf:" 开头
+            if (alt.startsWith('pdf:') && src.startsWith('pdf:')) {
+                const pdfSrc = src.slice('pdf:'.length).trim();
+                const block = {
+                    id: newId(),
+                    type: 'pdf',
+                    src: pdfSrc,
+                    // 如果 src 看起来像 fileId（包含 -TMP 后缀），直接设为 uuid
+                    ...(pdfSrc.includes('-TMP') ? { uuid: pdfSrc } : {}),
+                };
+                return [block];
+            }
             const block = {
                 id: newId(),
                 type: 'image',
@@ -164,7 +242,7 @@ function convertBlock(node, doc, opts = {}) {
         for (const child of node.children) {
             if (!isElement(child))
                 continue;
-            const childBlocks = convertBlock(child, doc, opts);
+            const childBlocks = convertBlock(child, doc, opts, warnings);
             for (const b of childBlocks) {
                 doc.blocks[b.id] = b;
                 childIds.push(b.id);
@@ -179,11 +257,11 @@ function convertBlock(node, doc, opts = {}) {
     }
     // ── 无序列表 ──────────────────────────────────────────────────────────────
     if (tag === 'ul') {
-        return convertList(node, doc, opts, false, 0);
+        return convertList(node, doc, opts, false, 0, warnings);
     }
     // ── 有序列表 ──────────────────────────────────────────────────────────────
     if (tag === 'ol') {
-        return convertList(node, doc, opts, true, 0);
+        return convertList(node, doc, opts, true, 0, warnings);
     }
     // ── 代码块 ────────────────────────────────────────────────────────────────
     if (tag === 'pre') {
@@ -242,11 +320,21 @@ function convertBlock(node, doc, opts = {}) {
         const blocks = [];
         for (const child of node.children) {
             if (isElement(child)) {
-                blocks.push(...convertBlock(child, doc, opts));
+                blocks.push(...convertBlock(child, doc, opts, warnings));
             }
         }
         return blocks;
     }
+    // ── 脚注检测 ────────────────────────────────────────────────────────────
+    if (tag === 'sup' && node.properties?.id && String(node.properties.id).startsWith('fnref-')) {
+        warnings.push({ type: 'footnote', message: '脚注引用转换为纯文本（墨问不支持脚注）', source: 'footnote-ref' });
+        const content = extractInlineContent(node);
+        return content.length > 0 ? [makeParagraph(content)] : [];
+    }
+    if (tag === 'section' && node.properties?.['data-footnotes'] !== undefined) {
+        warnings.push({ type: 'footnote', message: '脚注定义被丢弃（墨问不支持脚注）', source: 'footnote-def' });
+        return [];
+    }
     // 其他未知标签：尝试提取文本
     const content = extractInlineContent(node);
     if (content.length > 0) {
@@ -255,13 +343,22 @@ function convertBlock(node, doc, opts = {}) {
     return [];
 }
 // ── 列表转换 ───────────────────────────────────────────────────────────────────
-function convertList(listEl, doc, opts, ordered, depth) {
+function convertList(listEl, doc, opts, ordered, depth, warnings = []) {
     const blocks = [];
     let itemIndex = 1;
     const indent = '  '.repeat(depth);
     for (const child of listEl.children) {
         if (!isElement(child) || child.tagName !== 'li')
             continue;
+        // 检测 task list（li 内含 <input type="checkbox">）
+        const hasCheckbox = child.children.some((c) => isElement(c) && c.tagName === 'input' && c.properties?.type === 'checkbox');
+        if (hasCheckbox) {
+            warnings.push({
+                type: 'task-list',
+                message: '任务列表项转换为纯文本（墨问不支持 checkbox）',
+                source: 'task-list',
+            });
+        }
         const prefix = ordered ? `${indent}${itemIndex}. ` : `${indent}• `;
         itemIndex++;
         // li 内容可能包含段落和嵌套列表
@@ -275,10 +372,10 @@ function convertList(listEl, doc, opts, ordered, depth) {
                 continue;
             }
             if (liChild.tagName === 'ul') {
-                nestedBlocks.push(...convertList(liChild, doc, opts, false, depth + 1));
+                nestedBlocks.push(...convertList(liChild, doc, opts, false, depth + 1, warnings));
             }
             else if (liChild.tagName === 'ol') {
-                nestedBlocks.push(...convertList(liChild, doc, opts, true, depth + 1));
+                nestedBlocks.push(...convertList(liChild, doc, opts, true, depth + 1, warnings));
             }
             else if (liChild.tagName === 'p') {
                 paragraphContent.push(...extractInlineContent(liChild));
@@ -345,17 +442,37 @@ function tableToMarkdown(tableEl) {
  *
  * @param hast HAST Root 节点
  * @param opts 转换选项
+ * @returns 包含文档和转换警告的结果对象
  */
 export function hastToMast(hast, opts = {}) {
     const doc = { blocks: {}, topLevel: [] };
+    const warnings = [];
+    let prevEndLine = null;
     for (const node of hast.children) {
+        // ── 空行插入：根据相邻元素的行号差推断空行数量 ─────────────────────
+        if (isElement(node)) {
+            const startLine = node.position?.start?.line;
+            if (startLine != null && prevEndLine != null) {
+                const gap = startLine - prevEndLine;
+                // gap > 1 表示中间有空行，每个空行对应一个空段落
+                for (let i = 1; i < gap; i++) {
+                    const emptyBlock = makeEmptyParagraph();
+                    doc.blocks[emptyBlock.id] = emptyBlock;
+                    doc.topLevel.push(emptyBlock.id);
+                }
+            }
+        }
         if (!isElement(node))
             continue;
-        const blocks = convertBlock(node, doc, opts);
+        const blocks = convertBlock(node, doc, opts, warnings);
         for (const block of blocks) {
             doc.blocks[block.id] = block;
             doc.topLevel.push(block.id);
         }
+        // 记录当前元素的结束行号
+        if (node.position?.end?.line != null) {
+            prevEndLine = node.position.end.line;
+        }
     }
-    return doc;
+    return { doc, warnings };
 }

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

@@ -2,13 +2,78 @@ import { unified } from 'unified';
 import remarkParse from 'remark-parse';
 import remarkGfm from 'remark-gfm';
 import remarkRehype from 'remark-rehype';
+/** 高亮标记字符（U+2E3B THREE-EM DASH），用作 ==text== 的中间占位符 */
+export const HIGHLIGHT_MARKER = '⸻';
+/**
+ * 预处理 Markdown 中的 ==text== 高亮语法。
+ * 将 `==内容==` 替换为 `⸻内容⸻`（marker 包裹），
+ * 供后续 extractInline 阶段识别并转换为 highlight mark。
+ */
+function preprocessHighlight(markdown) {
+    return markdown.replace(/==([^\n=]+?)==/g, `${HIGHLIGHT_MARKER}$1${HIGHLIGHT_MARKER}`);
+}
 /**
  * 将 Markdown 字符串解析为 HAST（Hypertext AST）。
  * 使用 unified + remark-parse + remark-gfm + remark-rehype。
  */
 export function mdToHast(markdown) {
-    const processor = unified().use(remarkParse).use(remarkGfm).use(remarkRehype, { allowDangerousHtml: false });
-    const mdast = processor.parse(markdown);
+    // 预处理：==text== → <mark>text</mark>
+    let preprocessed = preprocessHighlight(markdown);
+    // 预处理：![[note:noteId]] → ![note:noteId](note:noteId)
+    preprocessed = preprocessed.replace(/!\[\[note:([^\]]+)\]\]/g, '![note:$1](note:$1)');
+    // 预处理：![[pdf:path]] → ![pdf:path](pdf:path)
+    preprocessed = preprocessed.replace(/!\[\[pdf:([^\]]+)\]\]/g, '![pdf:$1](pdf:$1)');
+    const processor = unified().use(remarkParse).use(remarkGfm).use(remarkRehype, { allowDangerousHtml: true });
+    const mdast = processor.parse(preprocessed);
     const hast = processor.runSync(mdast);
+    // 后处理：将 raw <mark> 节点转为 HAST element 节点
+    convertRawMarkToElements(hast);
     return hast;
 }
+/** 将 HAST 中的 raw <mark>/<mark> 节点转为 element 节点 */
+function convertRawMarkToElements(node) {
+    if (node.type !== 'element' && node.type !== 'root')
+        return;
+    const parent = node;
+    for (let i = 0; i < parent.children.length; i++) {
+        const child = parent.children[i];
+        if (!child)
+            continue;
+        // 递归处理子节点
+        if (child.type === 'element' || child.type === 'root') {
+            convertRawMarkToElements(child);
+            continue;
+        }
+        // 处理 raw 节点：寻找 <mark>...</mark> 配对
+        const childValue = child.type === 'raw' ? child.value : null;
+        if (childValue === '<mark>') {
+            // 收集 <mark> 和 </mark> 之间的所有节点
+            const innerNodes = [];
+            let j = i + 1;
+            while (j < parent.children.length) {
+                const next = parent.children[j];
+                if (!next) {
+                    j++;
+                    continue;
+                }
+                const nextValue = next.type === 'raw' ? next.value : null;
+                if (nextValue === '</mark>')
+                    break;
+                if (next.type === 'element' || next.type === 'text') {
+                    innerNodes.push(next);
+                }
+                j++;
+            }
+            if (j < parent.children.length) {
+                // 找到了配对的 </mark>，替换为 element 节点
+                const markElement = {
+                    type: 'element',
+                    tagName: 'mark',
+                    properties: {},
+                    children: innerNodes,
+                };
+                parent.children.splice(i, j - i + 1, markElement);
+            }
+        }
+    }
+}

package/dist/pipeline/remark-highlight.js

@@ -0,0 +1,14 @@
+/**
+ * remark 插件：解析 ==高亮文本== 语法。
+ *
+ * 策略：在 Markdown 预处理阶段将 ==text== 替换为 <mark>text</mark>，
+ * 经 remark-rehype（allowDangerousHtml）后保留为 HAST 元素，
+ * 最终在 hast-to-mast 阶段的 extractInline 中转为 highlight 标记。
+ */
+/** 预处理：将 ==text== 替换为 <mark>text</mark> */
+export function preprocessHighlight(markdown) {
+    // 匹配 ==...==，不跨行，非贪婪匹配
+    return markdown.replace(/==([^=\n]+?)==/g, (_match, inner) => {
+        return `<mark>${inner}</mark>`;
+    });
+}

package/dist/publish/asset-adapter.js

@@ -27,8 +27,9 @@ export async function processAssets(doc, client, opts = {}) {
     const { baseDir = process.cwd(), dryRun = false } = opts;
     const imageBlocks = Object.values(doc.blocks).filter((b) => b.type === 'image');
     const audioBlocks = Object.values(doc.blocks).filter((b) => b.type === 'audio');
-    // 并发上传，最多 3 个同时进行
-    await concurrentMap([...imageBlocks, ...audioBlocks], 3, async (block) => {
+    const pdfBlocks = Object.values(doc.blocks).filter((b) => b.type === 'pdf' && !b.uuid);
+    // 串行上传，每次间隔 1.1s
+    await concurrentMap([...imageBlocks, ...audioBlocks, ...pdfBlocks], 3, async (block) => {
         if (dryRun) {
             block.uuid = `dry-run-${block.id}`;
             return;
@@ -36,11 +37,54 @@ export async function processAssets(doc, client, opts = {}) {
         if (block.type === 'audio') {
             block.uuid = await uploadAudioBlock(block, client, baseDir);
         }
+        else if (block.type === 'pdf') {
+            block.uuid = await uploadPdfBlock(block, client, baseDir);
+        }
         else {
             block.uuid = await uploadBlock(block, client, baseDir);
         }
     });
 }
+async function uploadPdfBlock(block, client, baseDir) {
+    const src = block.src;
+    // 远程 URL
+    if (src.startsWith('http://') || src.startsWith('https://')) {
+        return client.uploadViaUrl(3, src);
+    }
+    // 本地路径
+    const { readFile } = await import('fs/promises');
+    const { resolve, isAbsolute, basename } = await import('path');
+    const decodedSrc = decodeURIComponent(src);
+    const absPath = isAbsolute(decodedSrc) ? decodedSrc : resolve(baseDir, decodedSrc);
+    const fileName = basename(absPath);
+    const fileBuffer = await readFile(absPath);
+    const form = await client.uploadPrepare(3, fileName);
+    await withRetry(async () => {
+        const formData = new FormData();
+        const fields = [
+            'key',
+            'policy',
+            'callback',
+            'success_action_status',
+            'x-oss-credential',
+            'x-oss-date',
+            'x-oss-meta-mo-uid',
+            'x-oss-signature',
+            'x-oss-signature-version',
+            'x:file_id',
+            'x:file_name',
+            'x:file_uid',
+        ];
+        for (const field of fields) {
+            formData.append(field, form[field]);
+        }
+        formData.append('file', new Blob([fileBuffer], { type: 'application/pdf' }), fileName);
+        const res = await fetch(form.endpoint, { method: 'POST', body: formData });
+        if (!res.ok)
+            throw new Error(`OSS upload failed: ${res.status}`);
+    });
+    return form['x:file_id'];
+}
 async function uploadAudioBlock(block, client, baseDir) {
     const src = block.src;
     // 远程 URL
@@ -90,7 +134,7 @@ async function uploadBlock(block, client, baseDir) {
     const src = block.src;
     // Data URI
     if (src.startsWith('data:')) {
-        return uploadDataUri(src, client);
+        return uploadDataUri(src, client, block.alt);
     }
     // 远程 URL
     if (src.startsWith('http://') || src.startsWith('https://')) {
@@ -100,7 +144,7 @@ async function uploadBlock(block, client, baseDir) {
     const { resolve, isAbsolute } = await import('path');
     const decodedSrc = decodeURIComponent(src);
     const absPath = isAbsolute(decodedSrc) ? decodedSrc : resolve(baseDir, decodedSrc);
-    return uploadLocalFile(absPath, client);
+    return uploadLocalFile(absPath, client, block.alt);
 }
 /**
  * 上传内存中的 PNG Buffer（表格渲染结果）。
@@ -108,7 +152,8 @@ async function uploadBlock(block, client, baseDir) {
  */
 async function uploadPngBuffer(buffer, client) {
     const fileName = `table-${Date.now()}.png`;
-    const form = await client.uploadPrepare(1, fileName);
+    // 表格截图不带标题（传空文件名）
+    const form = await client.uploadPrepare(1, '');
     await withRetry(async () => {
         const formData = new FormData();
         const fields = [

package/dist/publish/process-directory.js

@@ -1,6 +1,7 @@
 import { readdir, lstat } from 'fs/promises';
 import { join, resolve, basename, extname } from 'path';
 import { processFile } from './process-file.js';
+import { createProgressLine } from './progress.js';
 /**
  * 扫描目录中的 Markdown 文件
  * - 递归扫描（除非 recursive = false）
@@ -37,7 +38,7 @@ async function scanDir(dir, files, recursive) {
  * 批量发布目录中的 Markdown 文件
  */
 export async function processDirectory(dirPath, client, opts = {}) {
-    const { recursive = true } = opts;
+    const { recursive = true, quiet = false } = opts;
     const absDirPath = resolve(dirPath);
     // 检查目录是否存在
     const dirStat = await lstat(absDirPath);
@@ -53,11 +54,18 @@ export async function processDirectory(dirPath, client, opts = {}) {
     }
     console.log(`发现 ${files.length} 个 Markdown 文件，开始发布...\n`);
     const results = [];
-    let index = 0;
-    for (const filePath of files) {
-        index++;
+    const startTime = Date.now();
+    for (let index = 0; index < files.length; index++) {
+        const filePath = files[index];
         const fileName = basename(filePath);
-        console.log(`[${index}/${files.length}] ${fileName}`);
+        const current = index + 1;
+        if (quiet) {
+            console.log(`[${current}/${files.length}] ${fileName}`);
+        }
+        else {
+            const elapsed = Date.now() - startTime;
+            console.log(createProgressLine(current, files.length, elapsed));
+        }
         try {
             const result = await processFile(filePath, client, opts);
             results.push({
@@ -66,7 +74,7 @@ export async function processDirectory(dirPath, client, opts = {}) {
                 ...(result.noteId ? { noteId: result.noteId } : {}),
                 ...(result.noteUrl ? { noteUrl: result.noteUrl } : {}),
             });
-            console.log(`  ✅ 发布成功: ${result.noteUrl ?? '(dry-run)'}\n`);
+            console.log(`  ✅ ${fileName}`);
         }
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
@@ -75,16 +83,17 @@ export async function processDirectory(dirPath, client, opts = {}) {
                 status: 'failed',
                 error: errorMsg,
             });
-            console.log(`  ❌ 发布失败: ${errorMsg}\n`);
+            console.log(`  ❌ ${fileName}: ${errorMsg}`);
         }
         // 文件间隔 1.1 秒（最后一个文件不等待）
-        if (index < files.length) {
+        if (current < files.length) {
             await sleep(1100);
         }
     }
     // 汇总报告
+    const elapsedMs = Date.now() - startTime;
     const summary = computeSummary(results);
-    printSummary(summary);
+    printSummary(summary, elapsedMs);
     return summary;
 }
 function computeSummary(files) {
@@ -99,12 +108,16 @@ function computeSummary(files) {
         files,
     };
 }
-function printSummary(result) {
+function printSummary(result, elapsedMs) {
     console.log('── 发布汇总 ──────────────────────────────────────────');
     console.log(`总计：${result.total} 个文件`);
     console.log(`  ✅ 成功：${result.success}`);
     console.log(`  ❌ 失败：${result.failed}`);
     console.log(`  ⏭️  跳过：${result.skipped}`);
+    if (elapsedMs !== undefined) {
+        const seconds = (elapsedMs / 1000).toFixed(1);
+        console.log(`  ⏱️  耗时：${seconds}s`);
+    }
     if (result.failed > 0) {
         console.log('\n失败文件：');
         for (const f of result.files.filter((f) => f.status === 'failed')) {

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, codeBlockStyle } = opts;
+    const { noteId, tags, autoPublish = false, dryRun = false, cacheDir, codeBlockStyle, quiet = false } = opts;
     // ── 阶段 00：读取文件 ────────────────────────────────────────────────────────
     const absPath = resolve(filePath);
     const markdown = await readFile(absPath, 'utf8');
@@ -17,8 +17,14 @@ 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, codeBlockStyle ? { codeBlockStyle } : {});
+    const { doc: mast, warnings } = hastToMast(hast, codeBlockStyle ? { codeBlockStyle } : {});
     await writeCache(cacheDir, '02-mast.json', mast);
+    // ── 有损转换警告 ───────────────────────────────────────────────────────────
+    if (!quiet && warnings.length > 0) {
+        for (const w of warnings) {
+            console.warn(`⚠️ ${w.message}`);
+        }
+    }
     // ── 阶段 03：资源处理 ────────────────────────────────────────────────────────
     await processAssets(mast, client, { baseDir, dryRun });
     await writeCache(cacheDir, '03-mast-with-assets.json', mast);
@@ -29,8 +35,8 @@ export async function processFile(filePath, client, opts = {}) {
     await writeCache(cacheDir, '04-noteatom.json', noteAtom);
     // ── dry-run：打印报告，不调用 API ────────────────────────────────────────────
     if (dryRun) {
-        printDryRunReport(filePath, stats, noteAtom);
-        return { dryRun: true, stats };
+        printDryRunReport(filePath, stats, noteAtom, warnings);
+        return { dryRun: true, stats, warnings };
     }
     // ── 阶段 05：发布 ────────────────────────────────────────────────────────────
     let resultNoteId;
@@ -42,7 +48,7 @@ export async function processFile(filePath, client, opts = {}) {
         resultNoteId = await client.createNote(noteAtom, { autoPublish, tags: tags ?? [] });
     }
     const noteUrl = `https://mowen.cn/note/${resultNoteId}`;
-    return { noteId: resultNoteId, noteUrl, dryRun: false, stats };
+    return { noteId: resultNoteId, noteUrl, dryRun: false, stats, warnings };
 }
 // ── 统计 ──────────────────────────────────────────────────────────────────────
 function collectStats(mast, dryRun) {
@@ -67,6 +73,7 @@ function collectStats(mast, dryRun) {
             audios++;
         else if (block.type === 'codeblock')
             codeblocks++;
+        // note 块不计入统计（无需上传资源）
     }
     return {
         paragraphs,
@@ -80,7 +87,7 @@ function collectStats(mast, dryRun) {
     };
 }
 // ── dry-run 报告 ──────────────────────────────────────────────────────────────
-function printDryRunReport(filePath, stats, noteAtom) {
+function printDryRunReport(filePath, stats, noteAtom, warnings) {
     console.log('\n── dry-run 报告 ──────────────────────────────────────────');
     console.log(`文件：${filePath}`);
     console.log(`\n流水线统计：`);
@@ -92,6 +99,12 @@ function printDryRunReport(filePath, stats, noteAtom) {
     console.log(`  代码块：    ${stats.codeblocks}`);
     console.log(`  总块数：    ${stats.totalBlocks}`);
     console.log(`  待上传资源：${stats.images + stats.tables + stats.audios}（dry-run 跳过）`);
+    if (warnings.length > 0) {
+        console.log(`\n有损转换警告（${warnings.length} 处）：`);
+        for (const w of warnings) {
+            console.log(`  ⚠️ ${w.message}`);
+        }
+    }
     console.log(`\nNoteAtom 预览（前 3 个块）：`);
     const preview = noteAtom.content.slice(0, 3);
     console.log(JSON.stringify(preview, null, 2));

package/dist/publish/progress.js

@@ -0,0 +1,37 @@
+const BAR_WIDTH = 10;
+/** 构建进度条字符串，如 "██████░░░░" */
+export function buildProgressBar(current, total, width = BAR_WIDTH) {
+    const ratio = total > 0 ? current / total : 0;
+    const filled = Math.round(ratio * width);
+    return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+/** 格式化 ETA 秒数为人类可读格式，如 "2m30s" */
+export function formatEta(seconds) {
+    if (seconds < 60)
+        return `${Math.round(seconds)}s`;
+    const m = Math.floor(seconds / 60);
+    const s = Math.round(seconds % 60);
+    return `${m}m${s}s`;
+}
+/**
+ * 生成单行进度文本，如：
+ * "[██████░░░░] 15/50 (30%) ETA: 2m30s"
+ *
+ * @param elapsedMs 已耗毫秒数（从第一个文件开始计时）
+ */
+export function createProgressLine(current, total, elapsedMs) {
+    const bar = buildProgressBar(current, total);
+    const pct = Math.round((current / total) * 100);
+    if (current >= total) {
+        const elapsedSec = Math.round(elapsedMs / 1000);
+        return `[${bar}] ${current}/${total} (${pct}%) 完成，耗时 ${formatEta(elapsedSec)}`;
+    }
+    if (current <= 1) {
+        return `[${bar}] ${current}/${total} (${pct}%) ETA: 计算中`;
+    }
+    // 根据已耗时间推算剩余
+    const avgPerFile = elapsedMs / current;
+    const remaining = avgPerFile * (total - current);
+    const etaSec = Math.round(remaining / 1000);
+    return `[${bar}] ${current}/${total} (${pct}%) ETA: ${formatEta(etaSec)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md-to-mowen",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "将 Markdown（GFM）转换为墨问笔记的 CLI 工具",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
     "build": "tsc -p tsconfig.json && sh scripts/postbuild.sh && chmod +x dist/cli/index.js",
     "release": "semantic-release",
     "prepare": "husky",
-    "postinstall": "npx playwright install chromium"
+    "install:browser": "npx playwright install chromium"
   },
   "keywords": [
     "markdown",
@@ -44,8 +44,7 @@
     "unist-util-visit": "^5.0.0",
     "hast-util-to-string": "^3.0.0",
     "commander": "^12.0.0",
-    "dotenv": "^16.0.0",
-    "playwright": "^1.40.0"
+    "dotenv": "^16.0.0"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
@@ -61,6 +60,7 @@
     "semantic-release": "^24.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0",
-    "vitest": "^1.0.0"
+    "vitest": "^1.0.0",
+    "playwright": "^1.40.0"
   }
 }