lark-docx2md 0.1.1 → 0.2.0

package/README.md

@@ -11,7 +11,7 @@
 > 命令所需权限见下 ‘飞书自创应用需要的权限’
 
 ```bash
-npx -y lark-docx2md download https://xxx.feishu.cn/wiki/xxx --app-id cli_xxx --app-secret xxxx
+npx -y lark-docx2md@latest download https://xxx.feishu.cn/wiki/xxx --app-id cli_xxx --app-secret xxxx
 ```
 
 或先设置环境变量（命令行参数可省略）：
@@ -19,23 +19,37 @@ npx -y lark-docx2md download https://xxx.feishu.cn/wiki/xxx --app-id cli_xxx --a
 ```bash
 export LARK_DOCX2MD_APP_ID=<APP_ID>
 export LARK_DOCX2MD_APP_SECRET=<APP_SECRET>
-npx -y lark-docx2md download <url>
+npx -y lark-docx2md@latest download <url>
 ```
 
-| 参数                    | 说明                                                        |
-|-----------------------|-----------------------------------------------------------|
-| `<url>`               | 飞书文档链接                                                    |
-| `--app-id`            | 飞书应用 App ID（可选；默认读取 `LARK_DOCX2MD_APP_ID`）                |
-| `--app-secret`        | 飞书应用 App Secret（可选；默认读取 `LARK_DOCX2MD_APP_SECRET`）        |
-| `-o, --output <dir>`  | 输出目录（默认：`./larkDocx2mdOutput`）                            |
-| `--agent`             | Agent 模式：日志等级为 ERROR，image-mod 为 `online`，Markdown 输出到标准流 |
-| `--image-mode <mode>` | 图片处理模式：`local`（下载到本地，默认）或 `online`（使用 24h 临时在线链接）         |
+| 参数                       | 说明                                        | 环境变量                         | 默认值                   |
+|--------------------------|-------------------------------------------|------------------------------|-----------------------|
+| `<url>`                  | 飞书文档链接（`https://*.feishu.cn/wiki/*`）      | —                            | —                     |
+| `--app-id <id>`          | 飞书应用 App ID                               | `LARK_DOCX2MD_APP_ID`        | —                     |
+| `--app-secret <secret>`  | 飞书应用 App Secret                           | `LARK_DOCX2MD_APP_SECRET`    | —                     |
+| `-o, --output <dir>`     | 输出目录                                      | `LARK_DOCX2MD_OUTPUT`        | `./larkDocx2mdOutput` |
+| `--agent`                | Agent 模式：日志 ERROR，Markdown 输出到 stdout     | `LARK_DOCX2MD_AGENT=true`    | `false`               |
+| `--image-mode <mode>`    | 图片处理模式：`local`（下载到本地）或 `online`（24h 临时链接） | `LARK_DOCX2MD_IMAGE_MODE`    | `local`               |
+| `--wb-format <format>`   | 画板输出格式：`base64`、`inline-svg`、`svg`、`yaml` | `LARK_DOCX2MD_WB_FORMAT`     | `svg`                 |
+| `--wb-bg <style>`        | 画板 SVG 背景：`none`、`dot` 或颜色值如 `#fff`       | `LARK_DOCX2MD_WB_BG`         | `none`                |
+| `--wb-image-mode <mode>` | 画板图片模式：`online`、`base64` 或 `local`        | `LARK_DOCX2MD_WB_IMAGE_MODE` | `local`               |
+
+> **参数联动规则**
+>
+> - `--agent` 开启时：`--image-mode` 强制为 `online`，`--wb-image-mode` 强制为 `online`，`--wb-format` 默认为 `yaml`（仅允许
+    `inline-svg` / `yaml`）。
+> - `--wb-format yaml` 时：`--wb-image-mode` 强制为 `online`。
+
+
+**`--agent` 开启时，飞书文档转换后的内容会直接通过标准流输出**
 
 ## 功能
 
 - 支持飞书 Wiki 文档下载
 - 转换 20+ 种块类型
 - 输出标准 Markdown 文件
+- 支持飞书画板，输出格式：`base64`（data URI 内嵌）、`inline-svg`（SVG 标签内嵌）、`svg`（独立文件）、`yaml`（AI
+  友好结构化数据）。详见 [画板支持说明](./WHITEBOARD.md)
 
 ### 支持的内容块类型
 
@@ -71,7 +85,7 @@ npx -y lark-docx2md download <url>
 | @用户  | 用户 ID       |
 | @文档  | `[标题](url)` |
 
-> 未支持的块类型（如文件附件、视频、内嵌表格、画板等）会被静默忽略。
+> 未支持的块类型（如文件附件、视频、内嵌表格等）会被静默忽略。
 
 ## 开发
 
@@ -94,14 +108,19 @@ pnpm build
 {
   "scopes": {
     "tenant": [
+      "base:app:read",
+      "bitable:app",
+      "bitable:app:readonly",
+      "board:whiteboard:node:read",
+      "contact:user.employee_id:readonly",
       "docs:document.media:download",
+      "docx:document",
       "docx:document:readonly",
-      "wiki:node:read"
+      "wiki:node:read",
+      "wiki:wiki",
+      "wiki:wiki:readonly"
     ],
-    "user": [
-      "docx:document:readonly",
-      "wiki:node:read"
-    ]
+    "user": []
   }
 }
 ```

package/dist/cli.js

@@ -1,506 +1,55 @@
 #!/usr/bin/env node
+import { r as setLogLevel, t as convert } from "./converter-ByfbJV0N.js";
 import { Command } from "commander";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as lark from "@larksuiteoapi/node-sdk";
 import { LoggerLevel } from "@larksuiteoapi/node-sdk";
-//#region src/client.ts
-function createClient(appId, appSecret, loggerLevel = LoggerLevel.warn) {
-	const client = new lark.Client({
-		appId,
-		appSecret,
-		loggerLevel
-	});
-	async function call(name, fn) {
-		let res;
-		try {
-			res = await fn();
-		} catch (e) {
-			const error = e.response?.data?.error;
-			const code = e.response?.data?.code;
-			const msg = e.response?.data?.msg;
-			if (error) throw new Error(`${name} failed: [${code}] ${msg}: \n${JSON.stringify(error, null, 2)}`);
-			throw e;
-		}
-		if (res.code !== 0) throw new Error(`${name} failed: [${res.code}] ${res.msg}`);
-		return res.data;
-	}
-	async function getWikiNodeInfo(token) {
-		return (await call("getWikiNodeInfo", () => client.wiki.v2.space.getNode({ params: { token } }))).node;
-	}
-	async function getDocxDocument(docToken) {
-		const doc = (await call("getDocxDocument", () => client.docx.v1.document.get({ path: { document_id: docToken } }))).document;
-		return {
-			documentId: doc.document_id,
-			title: doc.title
-		};
-	}
-	async function getDocxBlocks(docToken) {
-		const blocks = [];
-		let pageToken;
-		for (;;) {
-			const data = await call("getDocxBlocks", () => client.docx.v1.documentBlock.list({
-				path: { document_id: docToken },
-				params: {
-					page_size: 500,
-					document_revision_id: -1,
-					page_token: pageToken
-				}
-			}));
-			if (data.items) blocks.push(...data.items);
-			if (!data.has_more) break;
-			pageToken = data.page_token;
-		}
-		return blocks;
-	}
-	/**
-	*
-	* @param fileTokens 一次最多可传递 5 个素材的 token
-	* @return {Record<string, string>} Record<token, downloadLink>
-	*/
-	async function batchGetTmpDownloadUrl(fileTokens) {
-		const list = (await call("batchGetTmpDownloadUrl", () => client.drive.v1.media.batchGetTmpDownloadUrl({ params: { file_tokens: fileTokens } }))).tmp_download_urls ?? [];
-		const result = {};
-		for (const { file_token, tmp_download_url } of list) result[file_token] = tmp_download_url;
-		return result;
-	}
-	async function downloadImage(imgToken, outDir) {
-		try {
-			const resp = await client.drive.v1.media.download({ path: { file_token: imgToken } });
-			fs.mkdirSync(outDir, { recursive: true });
-			const ext = (resp.headers?.["content-type"])?.includes("png") ? ".png" : ".jpg";
-			const filename = path.join(outDir, `${imgToken}${ext}`);
-			await resp.writeFile(filename);
-			return filename;
-		} catch (error) {
-			if ([
-				400,
-				401,
-				403
-			].includes(error.status)) throw new Error(`下载图片[${imgToken}]异常, 检查是否有接口 https://open.feishu.cn/document/server-docs/docs/drive-v1/media/download 的权限。`);
-			throw error;
-		}
-	}
-	return {
-		getWikiNodeInfo,
-		getDocxDocument,
-		getDocxBlocks,
-		downloadImage,
-		batchGetTmpDownloadUrl
-	};
-}
-//#endregion
-//#region src/parser.ts
-const BlockType = {
-	Page: 1,
-	Text: 2,
-	Heading1: 3,
-	Heading2: 4,
-	Heading3: 5,
-	Heading4: 6,
-	Heading5: 7,
-	Heading6: 8,
-	Heading7: 9,
-	Heading8: 10,
-	Heading9: 11,
-	Bullet: 12,
-	Ordered: 13,
-	Code: 14,
-	Quote: 15,
-	Equation: 16,
-	Todo: 17,
-	Callout: 19,
-	Divider: 22,
-	Grid: 24,
-	GridColumn: 25,
-	Image: 27,
-	Table: 31,
-	TableCell: 32,
-	QuoteContainer: 34
-};
-const codeLangMap = {
-	1: "",
-	2: "abap",
-	3: "ada",
-	4: "apache",
-	5: "apex",
-	6: "assembly",
-	7: "bash",
-	8: "csharp",
-	9: "cpp",
-	10: "c",
-	11: "cobol",
-	12: "css",
-	13: "coffeescript",
-	14: "d",
-	15: "dart",
-	16: "delphi",
-	17: "django",
-	18: "dockerfile",
-	19: "erlang",
-	20: "fortran",
-	21: "foxpro",
-	22: "go",
-	23: "groovy",
-	24: "html",
-	25: "htmlbars",
-	26: "http",
-	27: "haskell",
-	28: "json",
-	29: "java",
-	30: "javascript",
-	31: "julia",
-	32: "kotlin",
-	33: "latex",
-	34: "lisp",
-	35: "logo",
-	36: "lua",
-	37: "matlab",
-	38: "makefile",
-	39: "markdown",
-	40: "nginx",
-	41: "objectivec",
-	42: "openedge-abl",
-	43: "php",
-	44: "perl",
-	45: "postscript",
-	46: "powershell",
-	47: "prolog",
-	48: "protobuf",
-	49: "python",
-	50: "r",
-	51: "rpg",
-	52: "ruby",
-	53: "rust",
-	54: "sas",
-	55: "scss",
-	56: "sql",
-	57: "scala",
-	58: "scheme",
-	59: "scratch",
-	60: "shell",
-	61: "swift",
-	62: "thrift",
-	63: "typescript",
-	64: "vbscript",
-	65: "vbnet",
-	66: "xml",
-	67: "yaml"
-};
-var Parser = class {
-	constructor() {
-		this.imgTokens = [];
-		this.blockMap = /* @__PURE__ */ new Map();
-	}
-	parseDocxContent(doc, blocks) {
-		for (const b of blocks) if (b.block_id) this.blockMap.set(b.block_id, b);
-		const entry = this.blockMap.get(doc.documentId);
-		if (!entry) return "";
-		return this.parseBlock(entry, 0);
-	}
-	parseBlock(b, indent) {
-		const prefix = "	".repeat(indent);
-		const bt = b.block_type;
-		if (bt === BlockType.Page) return this.parsePage(b);
-		if (bt === BlockType.Text) return prefix + this.parseText(b.text) + "\n";
-		if (bt >= BlockType.Heading1 && bt <= BlockType.Heading9) return prefix + this.parseHeading(b, bt - 2);
-		if (bt === BlockType.Bullet) return prefix + this.parseBullet(b, indent);
-		if (bt === BlockType.Ordered) return prefix + this.parseOrdered(b, indent);
-		if (bt === BlockType.Code) return prefix + this.parseCode(b);
-		if (bt === BlockType.Quote) return prefix + "> " + this.parseText(b.quote) + "\n";
-		if (bt === BlockType.Equation) return prefix + "$$\n" + this.parseText(b.equation) + "$$\n\n";
-		if (bt === BlockType.Todo) return prefix + this.parseTodo(b);
-		if (bt === BlockType.Callout) return this.parseCallout(b);
-		if (bt === BlockType.Divider) return prefix + "---\n\n";
-		if (bt === BlockType.Image) return prefix + this.parseImage(b) + "\n";
-		if (bt === BlockType.Table) return prefix + this.parseTable(b);
-		if (bt === BlockType.TableCell) return this.parseTableCell(b);
-		if (bt === BlockType.QuoteContainer) return this.parseQuoteContainer(b);
-		if (bt === BlockType.Grid) return this.parseGrid(b, indent);
-		return "";
-	}
-	parsePage(b) {
-		let s = "# " + this.parseText(b.page) + "\n";
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, 0) + "\n";
-		}
-		return s;
-	}
-	parseText(body) {
-		const inline = body.elements.length > 1;
-		return body.elements.map((e) => this.parseElement(e, inline)).join("") + "\n";
-	}
-	parseElement(e, inline) {
-		if (e.text_run) return this.parseTextRun(e.text_run);
-		if (e.mention_user) return e.mention_user.user_id;
-		if (e.mention_doc) {
-			const url = e.mention_doc.url ? decodeURIComponent(e.mention_doc.url) : "";
-			return `[${e.mention_doc.title ?? ""}](${url})`;
-		}
-		if (e.equation) {
-			const sym = inline ? "$" : "$$";
-			return sym + e.equation.content.replace(/\n$/, "") + sym;
-		}
-		return "";
-	}
-	parseTextRun(tr) {
-		const s = tr.text_element_style;
-		let pre = "", post = "";
-		if (s) {
-			if (s.bold) {
-				pre = "**";
-				post = "**";
-			} else if (s.italic) {
-				pre = "_";
-				post = "_";
-			} else if (s.strikethrough) {
-				pre = "~~";
-				post = "~~";
-			} else if (s.underline) {
-				pre = "<u>";
-				post = "</u>";
-			} else if (s.inline_code) {
-				pre = "`";
-				post = "`";
-			} else if (s.link) {
-				pre = "[";
-				post = `](${decodeURIComponent(s.link.url)})`;
-			}
-		}
-		return pre + tr.content + post;
-	}
-	parseHeading(b, level) {
-		const body = b[`heading${level}`];
-		let s = "#".repeat(level) + " " + (body ? this.parseText(body) : "\n");
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, 0);
-		}
-		return s;
-	}
-	parseBullet(b, indent) {
-		let s = "- " + this.parseText(b.bullet);
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, indent + 1);
-		}
-		return s;
-	}
-	parseOrdered(b, indent) {
-		const parent = this.blockMap.get(b.parent_id);
-		let order = 1;
-		if (parent?.children) {
-			const idx = parent.children.indexOf(b.block_id);
-			for (let i = idx - 1; i >= 0; i--) if (this.blockMap.get(parent.children[i])?.block_type === BlockType.Ordered) order++;
-			else break;
-		}
-		let s = `${order}. ` + this.parseText(b.ordered);
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, indent + 1);
-		}
-		return s;
-	}
-	parseCode(b) {
-		const lang = codeLangMap[b.code?.style?.language ?? 1] ?? "";
-		const text = this.parseText(b.code).trim();
-		return "```" + lang + "\n" + text + "\n```\n";
-	}
-	parseTodo(b) {
-		return `- [${b.todo?.style?.done ? "x" : " "}] ` + this.parseText(b.todo) + "\n";
-	}
-	parseCallout(b) {
-		let s = ">[!TIP] \n";
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, 0);
-		}
-		return s;
-	}
-	parseImage(b) {
-		const token = b.image?.token;
-		if (token) {
-			this.imgTokens.push(token);
-			return `![图片-${token}](${token})\n`;
-		}
-		return "";
-	}
-	parseTableCell(b) {
-		let s = "";
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += this.parseBlock(child, 0).replace(/\n/g, "") + "<br/>";
-		}
-		return s;
-	}
-	parseTable(b) {
-		const t = b.table;
-		const cols = t.property.column_size;
-		const rows = [];
-		const mergeInfos = t.property.merge_info ?? [];
-		for (let i = 0; i < (t.cells?.length ?? 0); i++) {
-			const cellId = t.cells[i];
-			const cell = this.blockMap.get(cellId);
-			const content = cell ? this.parseBlock(cell, 0).replace(/\n/g, "") : "";
-			const row = Math.floor(i / cols);
-			const col = i % cols;
-			if (!rows[row]) rows[row] = [];
-			rows[row][col] = content;
-		}
-		const mergeMap = /* @__PURE__ */ new Map();
-		for (let i = 0; i < mergeInfos.length; i++) {
-			const m = mergeInfos[i];
-			const row = Math.floor(i / cols);
-			const col = i % cols;
-			mergeMap.set(`${row}-${col}`, {
-				rowSpan: m.row_span ?? 1,
-				colSpan: m.col_span ?? 1
-			});
-		}
-		const processed = /* @__PURE__ */ new Set();
-		let buf = "<table>\n";
-		for (let r = 0; r < rows.length; r++) {
-			buf += "<tr>\n";
-			for (let c = 0; c < (rows[r]?.length ?? 0); c++) {
-				const key = `${r}-${c}`;
-				if (processed.has(key)) continue;
-				const merge = mergeMap.get(key);
-				let attrs = "";
-				if (merge) {
-					if (merge.rowSpan > 1) attrs += ` rowspan="${merge.rowSpan}"`;
-					if (merge.colSpan > 1) attrs += ` colspan="${merge.colSpan}"`;
-					for (let mr = r; mr < r + merge.rowSpan; mr++) for (let mc = c; mc < c + merge.colSpan; mc++) processed.add(`${mr}-${mc}`);
-				}
-				buf += `<td${attrs}>${rows[r][c] ?? ""}</td>`;
-			}
-			buf += "</tr>\n";
-		}
-		buf += "</table>\n";
-		return buf;
-	}
-	parseQuoteContainer(b) {
-		let s = "";
-		for (const id of b.children ?? []) {
-			const child = this.blockMap.get(id);
-			if (child) s += "> " + this.parseBlock(child, 0);
-		}
-		return s;
-	}
-	parseGrid(b, indent) {
-		let s = "";
-		for (const colId of b.children ?? []) {
-			const col = this.blockMap.get(colId);
-			if (!col) continue;
-			for (const id of col.children ?? []) {
-				const child = this.blockMap.get(id);
-				if (child) s += this.parseBlock(child, indent);
-			}
-		}
-		return s;
-	}
-};
-//#endregion
-//#region src/logger.ts
-const COLORS = {
-	[LoggerLevel.fatal]: "\x1B[35m",
-	[LoggerLevel.error]: "\x1B[31m",
-	[LoggerLevel.warn]: "\x1B[33m",
-	[LoggerLevel.info]: "\x1B[36m",
-	[LoggerLevel.debug]: "\x1B[32m",
-	[LoggerLevel.trace]: "\x1B[90m"
-};
-const RESET = "\x1B[0m";
-const LEVEL_NAMES = [
-	"FATAL",
-	"ERROR",
-	"WARN",
-	"INFO",
-	"DEBUG",
-	"TRACE"
-];
-let minLogLevel = LoggerLevel.trace;
-function log(level, module, ...args) {
-	if (level > minLogLevel) return;
-	const time = (/* @__PURE__ */ new Date()).toISOString();
-	const color = COLORS[level] ?? "";
-	const name = LEVEL_NAMES[level] ?? "INFO";
-	process.stderr.write(`${time} ${color}[${name}]${RESET} [${module}] ${args.map(String).join(" ")}\n`);
-}
-function setLogLevel(level) {
-	minLogLevel = level;
-}
-function createLogger(module) {
-	return {
-		fatal: (...args) => log(LoggerLevel.fatal, module, ...args),
-		error: (...args) => log(LoggerLevel.error, module, ...args),
-		warn: (...args) => log(LoggerLevel.warn, module, ...args),
-		info: (...args) => log(LoggerLevel.info, module, ...args),
-		debug: (...args) => log(LoggerLevel.debug, module, ...args),
-		trace: (...args) => log(LoggerLevel.trace, module, ...args)
-	};
-}
-//#endregion
 //#region src/cli.ts
-const logger = createLogger("cli");
-function parseWikiUrl(url) {
-	const m = url.match(/^https:\/\/[\w.-]+\/(docs|docx|wiki)\/([a-zA-Z0-9]+)/);
-	if (!m) throw new Error("Invalid feishu document URL");
-	return {
-		docType: m[1],
-		docToken: m[2]
-	};
-}
 const program = new Command();
 program.name("larkDocx2md").description("Download Lark/Feishu documents to markdown");
-program.command("download").description("Download a wiki document to markdown").option("--app-id <id>", "Feishu app ID (or read from LARK_DOCX2MD_APP_ID)").option("--app-secret <secret>", "Feishu app secret (or read from LARK_DOCX2MD_APP_SECRET)").option("-o, --output <dir>", "Output directory", "./larkDocx2mdOutput").option("--agent", "Enable agent mode: ERROR log level, and AI prompt output").option("--image-mode <mode>", "Image handling mode: \"local\" (download) or \"online\" (temp URL)", "local").argument("<url>", "Feishu wiki document URL: https://*.feishu.cn/wiki/*").action(async (url, opts) => {
+program.command("download").description("Download a wiki document to markdown").option("--app-id <id>", "Feishu app ID (or read from LARK_DOCX2MD_APP_ID)").option("--app-secret <secret>", "Feishu app secret (or read from LARK_DOCX2MD_APP_SECRET)").option("-o, --output <dir>", "Output directory (or LARK_DOCX2MD_OUTPUT)").option("--agent", "Enable agent mode: ERROR log level, and AI prompt output (or LARK_DOCX2MD_AGENT=true)").option("--wb-format <format>", "Whiteboard output format: \"base64\", \"inline-svg\", \"svg\", or \"yaml\" (or LARK_DOCX2MD_WB_FORMAT)").option("--wb-bg <style>", "Whiteboard SVG background: \"none\", \"dot\", or a color like \"#fff\" (or LARK_DOCX2MD_WB_BG)").option("--wb-image-mode <mode>", "Whiteboard image mode: \"online\", \"base64\", or \"local\" (or LARK_DOCX2MD_WB_IMAGE_MODE)").option("--image-mode <mode>", "Image handling mode: \"local\" or \"online\" (or LARK_DOCX2MD_IMAGE_MODE)").argument("<url>", "Feishu wiki document URL: https://*.feishu.cn/wiki/*").action(async (url, opts) => {
+	opts.appId = opts.appId ?? process.env.LARK_DOCX2MD_APP_ID;
+	opts.appSecret = opts.appSecret ?? process.env.LARK_DOCX2MD_APP_SECRET;
+	opts.output = opts.output ?? process.env.LARK_DOCX2MD_OUTPUT ?? "./larkDocx2mdOutput";
+	opts.agent = opts.agent ?? process.env.LARK_DOCX2MD_AGENT === "true";
+	opts.imageMode = opts.imageMode ?? process.env.LARK_DOCX2MD_IMAGE_MODE ?? "local";
+	opts.wbFormat = opts.wbFormat ?? process.env.LARK_DOCX2MD_WB_FORMAT;
+	opts.wbBg = opts.wbBg ?? process.env.LARK_DOCX2MD_WB_BG ?? "none";
+	opts.wbImageMode = opts.wbImageMode ?? process.env.LARK_DOCX2MD_WB_IMAGE_MODE ?? "local";
+	if (!opts.wbFormat) opts.wbFormat = opts.agent ? "yaml" : "svg";
 	if (opts.agent) {
 		setLogLevel(LoggerLevel.error);
 		opts.imageMode = "online";
-	} else if (opts.imageMode && !["local", "online"].includes(opts.imageMode)) program.error(`Invalid --image-mode "${opts.imageMode}", must be "local" or "online"`);
-	const { docType, docToken: rawToken } = parseWikiUrl(url);
-	logger.info("Captured document token:", rawToken);
-	const appId = opts.appId ?? process.env.LARK_DOCX2MD_APP_ID;
-	const appSecret = opts.appSecret ?? process.env.LARK_DOCX2MD_APP_SECRET;
+		opts.wbImageMode = "online";
+		if (!["inline-svg", "yaml"].includes(opts.wbFormat)) program.error(`Agent mode only supports "inline-svg" or "yaml" for --wb-format`);
+		opts.wbImageMode = "online";
+	}
+	if (opts.imageMode && !["local", "online"].includes(opts.imageMode)) program.error(`Invalid --image-mode "${opts.imageMode}", must be "local" or "online"`);
+	if (![
+		"base64",
+		"inline-svg",
+		"svg",
+		"yaml"
+	].includes(opts.wbFormat)) program.error(`Invalid --wb-format "${opts.wbFormat}", must be "base64", "inline-svg", "svg", or "yaml"`);
+	if (opts.wbFormat === "yaml") opts.wbImageMode = "online";
+	if (![
+		"online",
+		"base64",
+		"local"
+	].includes(opts.wbImageMode)) program.error(`Invalid --wb-image-mode "${opts.wbImageMode}", must be "online", "base64", or "local"`);
+	const appId = opts.appId;
+	const appSecret = opts.appSecret;
 	if (!appId || !appSecret) program.error("Missing credentials: pass --app-id/--app-secret or set LARK_DOCX2MD_APP_ID/LARK_DOCX2MD_APP_SECRET");
-	const client = createClient(appId, appSecret, opts.agent ? LoggerLevel.error : LoggerLevel.warn);
-	let docToken = rawToken;
-	if (docType === "wiki") {
-		docToken = (await client.getWikiNodeInfo(docToken)).obj_token;
-		logger.info("Resolved docx token:", docToken);
-	}
-	const doc = await client.getDocxDocument(docToken);
-	const blocks = await client.getDocxBlocks(docToken);
-	logger.info(`Fetched ${blocks.length} blocks`);
-	const parser = new Parser();
-	let markdown = parser.parseDocxContent(doc, blocks);
-	if (opts.imageMode === "online") for (let i = 0; i < parser.imgTokens.length; i += 5) {
-		const batch = parser.imgTokens.slice(i, i + 5);
-		const urlMap = await client.batchGetTmpDownloadUrl(batch);
-		for (const token of batch) {
-			const onlineUrl = urlMap[token];
-			if (onlineUrl) {
-				markdown = markdown.replace(`(${token})`, `(${onlineUrl})`);
-				logger.info("Replaced image with online URL:", token);
-			}
-		}
-	}
-	else {
-		const imgDir = path.join(opts.output, "static");
-		for (const imgToken of parser.imgTokens) {
-			let localPath = await client.downloadImage(imgToken, imgDir);
-			localPath = path.relative(opts.output, localPath);
-			markdown = markdown.replace(`(${imgToken})`, `(${localPath})`);
-			logger.info("Downloaded image:", localPath);
-		}
-	}
-	if (opts.agent) process.stdout.write(markdown);
-	else {
-		fs.mkdirSync(opts.output, { recursive: true });
-		const mdPath = path.join(opts.output, `${docToken}.md`);
-		fs.writeFileSync(mdPath, markdown);
-		logger.info("Downloaded markdown file to", mdPath);
-	}
+	const result = await convert({
+		appId,
+		appSecret,
+		url,
+		output: opts.output,
+		imageMode: opts.imageMode,
+		wbImageMode: opts.wbImageMode,
+		wbBg: opts.wbBg,
+		wbFormat: opts.wbFormat,
+		agent: opts.agent
+	});
+	if (opts.agent) process.stdout.write(result.markdown);
 });
 program.parse();
 //#endregion