md-to-mowen 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 momolibrary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { config } from 'dotenv';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+import { processFile } from '../publish/process-file.js';
+import { MowenClient } from '../mowen/client.js';
+import { noteAtomToMast } from '../noteatom/to-mast.js';
+import { mastToMarkdown } from '../mast/to-markdown.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** 按优先级搜索 .env 文件 */
+function searchEnvPaths() {
+    const projectRoot = resolve(__dirname, '../../');
+    return [
+        { label: '项目根目录', path: join(projectRoot, '.env') },
+        { label: '当前工作目录', path: resolve(process.cwd(), '.env') },
+        { label: '用户主目录', path: join(homedir(), '.md-to-mowen.env') },
+    ];
+}
+/** 加载 .env，返回找到的路径列表 */
+function loadEnvConfig() {
+    const locations = searchEnvPaths();
+    const found = [];
+    for (const loc of locations) {
+        if (existsSync(loc.path)) {
+            config({ path: loc.path });
+            found.push(loc.label);
+        }
+    }
+    return found;
+}
+function getApiKey() {
+    return process.env.MOWEN_API_KEY;
+}
+function getEnvWritePath() {
+    // 写入项目根目录 .env
+    return join(resolve(__dirname, '../../'), '.env');
+}
+async function promptApiKey() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('');
+    console.log('获取 API Key 的步骤：');
+    console.log('  1. 打开微信，搜索"墨问"小程序');
+    console.log('  2. 进入个人主页');
+    console.log('  3. 点击「开发者」');
+    console.log('  4. 进入「我的 API Key」页面');
+    console.log('  5. 复制 API Key');
+    console.log('');
+    return new Promise((resolve) => {
+        rl.question('请粘贴你的 MOWEN_API_KEY: ', (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function saveApiKey(apiKey) {
+    const envPath = getEnvWritePath();
+    const content = `MOWEN_API_KEY=${apiKey}\n`;
+    // 如果文件已存在，读取并替换；否则创建新文件
+    if (existsSync(envPath)) {
+        const existing = readFileSync(envPath, 'utf8');
+        const lines = existing.split('\n');
+        const idx = lines.findIndex((l) => l.startsWith('MOWEN_API_KEY='));
+        if (idx !== -1) {
+            lines[idx] = `MOWEN_API_KEY=${apiKey}`;
+        }
+        else {
+            lines.push(`MOWEN_API_KEY=${apiKey}`);
+        }
+        writeFileSync(envPath, lines.filter((l) => l.trim()).join('\n') + '\n', 'utf8');
+    }
+    else {
+        mkdirSync(dirname(envPath), { recursive: true });
+        writeFileSync(envPath, content, 'utf8');
+    }
+    console.log(`\n✅ API Key 已保存到 ${envPath}`);
+    console.log('   下次运行无需再输入。');
+}
+// ── 加载配置 ──────────────────────────────────────────────────────────────────
+loadEnvConfig();
+// ── CLI ───────────────────────────────────────────────────────────────────────
+const program = new Command();
+program.name('md-to-mowen').description('将 Markdown（GFM）转换为墨问笔记').version('0.0.0');
+// ── config ────────────────────────────────────────────────────────────────────
+program
+    .command('config')
+    .description('设置墨问 API Key')
+    .action(async () => {
+    const existingKey = getApiKey();
+    if (existingKey) {
+        console.log(`当前 MOWEN_API_KEY: ${existingKey.slice(0, 8)}...${existingKey.slice(-4)}`);
+    }
+    const apiKey = await promptApiKey();
+    if (!apiKey) {
+        console.error('错误：API Key 不能为空。');
+        process.exit(1);
+    }
+    saveApiKey(apiKey);
+});
+// ── publish ────────────────────────────────────────────────────────────────────
+program
+    .command('publish')
+    .description('发布 Markdown 文件为墨问笔记')
+    .requiredOption('-i, --input <file>', 'Markdown 文件路径')
+    .option('--note-id <id>', '已有笔记 ID（编辑模式，全量替换）')
+    .option('--tags <tags>', '标签，逗号分隔（如 "tech,ai"）')
+    .option('--auto-publish', '自动发布（非草稿）', false)
+    .option('--dry-run', '走完流水线但不调用墨问 API，仅打印统计', false)
+    .option('--cache-dir <dir>', '保存各阶段产物的目录（调试用）', 'out/pipeline-cache')
+    .action(async (opts) => {
+    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);
+    }
+    const client = new MowenClient(apiKey ?? 'dry-run-placeholder');
+    const tags = opts.tags ? opts.tags.split(',').map((t) => t.trim()) : undefined;
+    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`);
+        }
+    }
+    catch (err) {
+        console.error('发布失败：', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+// ── to-markdown ────────────────────────────────────────────────────────────────
+program
+    .command('to-markdown')
+    .description('将 NoteAtom JSON 转换为 Markdown')
+    .requiredOption('-i, --input <file>', 'NoteAtom JSON 文件路径')
+    .option('-o, --output <file>', '输出 Markdown 文件路径（不指定则输出到 stdout）')
+    .action(async (opts) => {
+    try {
+        const raw = (await import('fs/promises')).readFile;
+        const data = await raw(opts.input, 'utf8');
+        const noteAtom = JSON.parse(data);
+        if (!noteAtom.type || !Array.isArray(noteAtom.content)) {
+            console.error('错误：无效的 NoteAtom JSON，缺少 type 或 content 字段。');
+            process.exit(1);
+        }
+        const mast = noteAtomToMast(noteAtom);
+        const md = mastToMarkdown(mast);
+        if (opts.output) {
+            await (await import('fs/promises')).writeFile(opts.output, md, 'utf8');
+            console.log(`✅ 已输出到 ${opts.output}`);
+        }
+        else {
+            process.stdout.write(md);
+        }
+    }
+    catch (err) {
+        console.error('转换失败：', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/mast/to-markdown.js

@@ -0,0 +1,92 @@
+/**
+ * 将 MASTDocument 序列化为 Markdown 文本。
+ */
+export function mastToMarkdown(doc) {
+    const parts = [];
+    let prevType;
+    for (const id of doc.topLevel) {
+        const block = doc.blocks[id];
+        if (!block)
+            continue;
+        // 空行分隔：连续空 paragraph 合并为一个空行
+        if (block.type === 'paragraph' && block.content.length === 0) {
+            if (prevType === 'empty')
+                continue;
+            parts.push('');
+            prevType = 'empty';
+            continue;
+        }
+        // 块之间加空行（段落、引用块之间）
+        if (prevType && prevType !== 'empty') {
+            parts.push('');
+        }
+        prevType = block.type;
+        parts.push(serializeBlock(block, doc));
+    }
+    return parts.join('\n');
+}
+function serializeBlock(block, doc) {
+    switch (block.type) {
+        case 'paragraph':
+            return serializeParagraph(block);
+        case 'quote':
+            return serializeQuote(block, doc);
+        case 'image':
+            return serializeImage(block);
+        case 'audio':
+            return serializeAudio(block);
+    }
+}
+function serializeParagraph(block) {
+    if (block.content.length === 0)
+        return '';
+    return block.content.map(serializeTextRun).join('');
+}
+function serializeQuote(block, doc) {
+    const lines = [];
+    for (const childId of block.children) {
+        const child = doc.blocks[childId];
+        if (child && child.type === 'paragraph') {
+            const text = serializeParagraph(child);
+            // 段落内嵌换行，每行都要加 `> ` 前缀
+            for (const line of text.split('\n')) {
+                lines.push(`> ${line}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function serializeImage(block) {
+    const src = block.uuid ? block.src : block.src;
+    return `![${block.alt}](${src})`;
+}
+function serializeAudio(block) {
+    const src = block.uuid ? block.src : block.src;
+    return `![audio: ${block.showNote}](${src})`;
+}
+function serializeTextRun(run) {
+    if (!run.marks)
+        return run.text;
+    let text = run.text;
+    // code 最先包裹（innermost），遇到 code 时只保留 code
+    if (run.marks.code) {
+        text = `\`${text}\``;
+        // code 不与其他标记叠加
+        if (run.marks.link)
+            text = `[${text}](${run.marks.link})`;
+        return text;
+    }
+    // strikethrough
+    if (run.marks.strikethrough)
+        text = `~~${text}~~`;
+    // bold
+    if (run.marks.bold)
+        text = `**${text}**`;
+    // italic
+    if (run.marks.italic)
+        text = `*${text}*`;
+    // link 最后包裹（outermost）
+    if (run.marks.link)
+        text = `[${text}](${run.marks.link})`;
+    return text;
+}

package/dist/mast/types.js

@@ -0,0 +1,3 @@
+// MAST — Mowen AST（中间表示）
+// HAST 与 NoteAtom 之间的标准中间格式
+export {};

package/dist/mowen/client.js

@@ -0,0 +1,72 @@
+import { withRetry } from '../shared/retry.js';
+const BASE_URL = 'https://open.mowen.cn';
+/**
+ * 墨问 API 客户端
+ */
+export class MowenClient {
+    apiKey;
+    constructor(apiKey) {
+        if (!apiKey)
+            throw new Error('MOWEN_API_KEY is required');
+        this.apiKey = apiKey;
+    }
+    get headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    async request(path, body) {
+        const res = await withRetry(() => fetch(`${BASE_URL}${path}`, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify(body),
+        }), {
+            shouldRetry: (err) => {
+                // 网络错误重试；4xx 不重试
+                if (err instanceof MowenApiError && err.code < 500)
+                    return false;
+                return true;
+            },
+        });
+        const data = (await res.json());
+        if (!res.ok || data.code) {
+            throw new MowenApiError(data.code ?? res.status, data.reason ?? res.statusText);
+        }
+        return data;
+    }
+    /** 获取 OSS 上传凭证（本地上传第一步） */
+    async uploadPrepare(fileType, fileName) {
+        const res = await this.request('/api/open/api/v1/upload/prepare', { fileType, fileName });
+        return res.form;
+    }
+    /** 基于远程 URL 上传文件（一步完成） */
+    async uploadViaUrl(fileType, url, fileName) {
+        const res = await this.request('/api/open/api/v1/upload/url', {
+            fileType,
+            url,
+            ...(fileName ? { fileName } : {}),
+        });
+        return res.file.fileId;
+    }
+    /** 创建笔记，返回 noteId */
+    async createNote(body, settings) {
+        const res = await this.request('/api/open/api/v1/note/create', {
+            body,
+            settings: settings ?? {},
+        });
+        return res.noteId;
+    }
+    /** 编辑已有笔记（全量替换） */
+    async editNote(noteId, body) {
+        await this.request('/api/open/api/v1/note/edit', { noteId, body });
+    }
+}
+export class MowenApiError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[${code}] ${message}`);
+        this.code = code;
+        this.name = 'MowenApiError';
+    }
+}

package/dist/mowen/upload.js

@@ -0,0 +1,83 @@
+import { readFile } from 'fs/promises';
+import { basename, extname } from 'path';
+import { withRetry } from '../shared/retry.js';
+const MIME_MAP = {
+    gif: 'image/gif',
+    jpeg: 'image/jpeg',
+    jpg: 'image/jpeg',
+    png: 'image/png',
+    webp: 'image/webp',
+    mp3: 'audio/mpeg',
+    m4a: 'audio/mp4',
+    mp4: 'audio/mp4',
+    pdf: 'application/pdf',
+};
+function mimeFromFileName(fileName) {
+    const ext = extname(fileName).slice(1).toLowerCase();
+    return MIME_MAP[ext] ?? 'application/octet-stream';
+}
+/**
+ * 上传本地图片文件，返回 fileId。
+ * 使用两步 OSS 上传流程：prepare → multipart POST。
+ */
+export async function uploadLocalFile(filePath, client) {
+    const fileName = basename(filePath);
+    const fileBuffer = await readFile(filePath);
+    const form = await client.uploadPrepare(1, fileName);
+    await ossUpload(form, fileBuffer, fileName);
+    return form['x:file_id'];
+}
+/**
+ * 上传远程 URL 图片，返回 fileId。
+ */
+export async function uploadRemoteUrl(url, client) {
+    return client.uploadViaUrl(1, url);
+}
+/**
+ * 上传 Data URI 图片，返回 fileId。
+ * 支持 data:image/png;base64,... 格式。
+ */
+export async function uploadDataUri(dataUri, client) {
+    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 buffer = Buffer.from(b64, 'base64');
+    const form = await client.uploadPrepare(1, fileName);
+    await ossUpload(form, buffer, fileName);
+    return form['x:file_id'];
+}
+/**
+ * OSS multipart 直传（第二步）。
+ */
+async function ossUpload(form, fileBuffer, fileName) {
+    await withRetry(async () => {
+        const formData = new FormData();
+        // 按 API 文档顺序添加所有表单字段（endpoint 除外）
+        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: mimeFromFileName(fileName) }), fileName);
+        const res = await fetch(form.endpoint, { method: 'POST', body: formData });
+        if (!res.ok) {
+            throw new Error(`OSS upload failed: ${res.status} ${res.statusText}`);
+        }
+    });
+}

package/dist/noteatom/from-mast.js

@@ -0,0 +1,102 @@
+/**
+ * 将 MASTDocument 序列化为 NoteAtom JSON。
+ * 所有 MASTImageBlock 必须已有 uuid（资源阶段完成后）。
+ */
+export function mastToNoteAtom(doc) {
+    const content = [];
+    for (const id of doc.topLevel) {
+        const block = doc.blocks[id];
+        if (block) {
+            const nodes = convertBlock(block, doc);
+            content.push(...nodes);
+        }
+    }
+    return { type: 'doc', content };
+}
+// ── 块节点转换 ─────────────────────────────────────────────────────────────────
+function convertBlock(block, doc) {
+    switch (block.type) {
+        case 'paragraph':
+            return [convertParagraph(block)];
+        case 'quote':
+            return [convertQuote(block, doc)];
+        case 'image':
+            return [convertImage(block)];
+        case 'audio':
+            return [convertAudio(block)];
+    }
+}
+function convertParagraph(block) {
+    return {
+        type: 'paragraph',
+        content: block.content.map(convertTextRun),
+    };
+}
+function convertQuote(block, doc) {
+    const children = [];
+    for (const childId of block.children) {
+        const child = doc.blocks[childId];
+        if (!child)
+            continue;
+        if (child.type === 'paragraph') {
+            children.push(convertParagraph(child));
+        }
+        // quote 内嵌套 quote：展平为段落
+        else if (child.type === 'quote') {
+            const quoteChild = child;
+            for (const grandChildId of quoteChild.children) {
+                const grandChild = doc.blocks[grandChildId];
+                if (grandChild && grandChild.type === 'paragraph') {
+                    children.push(convertParagraph(grandChild));
+                }
+            }
+        }
+    }
+    return { type: 'quote', content: children };
+}
+function convertImage(block) {
+    if (!block.uuid) {
+        throw new Error(`MASTImageBlock ${block.id} has no uuid — run asset processing before serialization`);
+    }
+    return {
+        type: 'image',
+        attrs: {
+            uuid: block.uuid,
+            alt: block.alt,
+            align: block.align,
+        },
+    };
+}
+function convertAudio(block) {
+    if (!block.uuid) {
+        throw new Error(`MASTAudioBlock ${block.id} has no uuid — run asset processing before serialization`);
+    }
+    return {
+        type: 'audio',
+        attrs: {
+            'audio-uuid': block.uuid,
+            'show-note': block.showNote,
+        },
+    };
+}
+// ── 行内节点转换 ───────────────────────────────────────────────────────────────
+function convertTextRun(run) {
+    const node = { type: 'text', text: run.text };
+    if (!run.marks)
+        return node;
+    const marks = [];
+    // 按优先级顺序：code → strikethrough → bold → italic → link
+    if (run.marks.code)
+        marks.push({ type: 'code' });
+    if (run.marks.strikethrough)
+        marks.push({ type: 'strikethrough' });
+    if (run.marks.bold)
+        marks.push({ type: 'bold' });
+    if (run.marks.italic)
+        marks.push({ type: 'italic' });
+    if (run.marks.link)
+        marks.push({ type: 'link', attrs: { href: run.marks.link } });
+    if (marks.length > 0)
+        node.marks = marks;
+    return node;
+}

package/dist/noteatom/index.js

@@ -0,0 +1,2 @@
+export { mastToNoteAtom } from './from-mast.js';
+export { noteAtomToMast } from './to-mast.js';

package/dist/noteatom/to-mast.js

@@ -0,0 +1,103 @@
+let _idCounter = 0;
+function newId() {
+    return `b_${++_idCounter}`;
+}
+/**
+ * 将 NoteAtom JSON 解析为 MASTDocument。
+ */
+export function noteAtomToMast(doc) {
+    _idCounter = 0;
+    const blocks = {};
+    const topLevel = [];
+    for (const node of doc.content) {
+        const id = convertNode(node, blocks);
+        if (id)
+            topLevel.push(id);
+    }
+    return { blocks, topLevel };
+}
+// ── 块节点转换 ─────────────────────────────────────────────────────────────────
+function convertNode(node, blocks) {
+    switch (node.type) {
+        case 'paragraph':
+            return convertParagraph(node, blocks);
+        case 'quote':
+            return convertQuote(node, blocks);
+        case 'image':
+            return convertImage(node, blocks);
+        case 'audio':
+            return convertAudio(node, blocks);
+    }
+}
+function convertParagraph(block, blocks) {
+    const id = newId();
+    const content = (block.content ?? []).map(convertTextRun);
+    const mast = { id, type: 'paragraph', content };
+    blocks[id] = mast;
+    return id;
+}
+function convertQuote(block, blocks) {
+    const id = newId();
+    const children = [];
+    for (const child of block.content) {
+        const childId = convertParagraph(child, blocks);
+        children.push(childId);
+    }
+    const mast = { id, type: 'quote', children };
+    blocks[id] = mast;
+    return id;
+}
+function convertImage(block, blocks) {
+    const id = newId();
+    const mast = {
+        id,
+        type: 'image',
+        src: `mowen://file/${block.attrs.uuid}`,
+        uuid: block.attrs.uuid,
+        alt: block.attrs.alt,
+        align: block.attrs.align ?? 'center',
+    };
+    blocks[id] = mast;
+    return id;
+}
+function convertAudio(block, blocks) {
+    const id = newId();
+    const mast = {
+        id,
+        type: 'audio',
+        src: `mowen://file/${block.attrs['audio-uuid']}`,
+        uuid: block.attrs['audio-uuid'],
+        showNote: block.attrs['show-note'] ?? '',
+    };
+    blocks[id] = mast;
+    return id;
+}
+// ── 行内节点转换 ───────────────────────────────────────────────────────────────
+function convertTextRun(run) {
+    const mast = { type: 'text', text: run.text };
+    if (!run.marks || run.marks.length === 0)
+        return mast;
+    const marks = {};
+    for (const mark of run.marks) {
+        switch (mark.type) {
+            case 'bold':
+                marks.bold = true;
+                break;
+            case 'italic':
+                marks.italic = true;
+                break;
+            case 'code':
+                marks.code = true;
+                break;
+            case 'strikethrough':
+                marks.strikethrough = true;
+                break;
+            case 'link':
+                marks.link = mark.attrs.href;
+                break;
+        }
+    }
+    if (Object.keys(marks).length > 0)
+        mast.marks = marks;
+    return mast;
+}

package/dist/noteatom/types.js

@@ -0,0 +1,5 @@
+/**
+ * NoteAtom 类型定义
+ * 墨问的 ProseMirror 风格文档格式
+ */
+export {};