@jackwener/opencli 1.7.2 → 1.7.3

package/clis/mubu/docs.js

@@ -0,0 +1,43 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { formatDate, mubuPost } from './utils.js';
+
+cli({
+  site: 'mubu',
+  name: 'docs',
+  description: '列出幕布文档（默认根目录，--starred 查看快速访问列表）',
+  domain: 'mubu.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'folder', default: '0', help: '文件夹 ID（默认根目录 0）' },
+    { name: 'starred', type: 'bool', default: false, help: '只显示快速访问的文档和文件夹' },
+    { name: 'limit', type: 'int', default: 50, help: '最多显示条数' },
+  ],
+  columns: ['type', 'id', 'name', 'updated', 'stared'],
+  func: async (page, kwargs) => {
+    const folderId = kwargs.folder;
+    const starred = kwargs.starred;
+    const limit = kwargs.limit;
+
+    await page.goto('https://mubu.com/app');
+    const body = starred ? { source: 'star' } : { folderId };
+    const data = await mubuPost(page, '/list/get', body);
+
+    const folders = (data.folders ?? []).map((f) => ({
+      type: '📁',
+      id: f.id,
+      name: f.name,
+      updated: formatDate(f.updateTime),
+      stared: f.stared ? '★' : '',
+    }));
+
+    const docs = (data.documents ?? []).map((doc) => ({
+      type: '📄',
+      id: doc.id,
+      name: doc.name,
+      updated: formatDate(doc.updateTime),
+      stared: doc.stared ? '★' : '',
+    }));
+
+    return [...folders, ...docs].slice(0, limit);
+  },
+});

package/clis/mubu/notes.js

@@ -0,0 +1,244 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError } from '@jackwener/opencli/errors';
+import { mubuPost, nodesToMarkdown, nodesToText, htmlToText } from './utils.js';
+
+// ── 日期工具 ──────────────────────────────────────────────
+
+function localToday() {
+  const d = new Date();
+  return { year: d.getFullYear(), month: d.getMonth() + 1, day: d.getDate() };
+}
+
+function lastDayOfMonth(year, month) {
+  return new Date(year, month, 0).getDate();
+}
+
+function validateYear(year, label = '年份') {
+  if (!Number.isInteger(year) || year < 1) {
+    throw new ArgumentError(`${label} 非法：${year}，应为正整数`);
+  }
+}
+
+function validateMonth(month) {
+  if (!Number.isInteger(month) || month < 1 || month > 12) {
+    throw new ArgumentError(`月份非法：${month}，应为 1-12`);
+  }
+}
+
+function validateDay(year, month, day) {
+  const maxDay = lastDayOfMonth(year, month);
+  if (!Number.isInteger(day) || day < 1 || day > maxDay) {
+    throw new ArgumentError(`日期非法：${year}-${month}-${day}（${year} 年 ${month} 月共 ${maxDay} 天）`);
+  }
+}
+
+function parseDate(s) {
+  const parts = s.split('-').map(Number);
+  if (parts.length !== 3 || parts.some(isNaN)) {
+    throw new ArgumentError(`日期格式错误：${s}，应为 YYYY-MM-DD`);
+  }
+  const [year, month, day] = parts;
+  validateYear(year);
+  validateMonth(month);
+  validateDay(year, month, day);
+  return { year, month, day };
+}
+
+function parseMonth(s) {
+  const parts = s.split('-').map(Number);
+  if (parts.length !== 2 || parts.some(isNaN)) {
+    throw new ArgumentError(`月份格式错误：${s}，应为 YYYY-MM`);
+  }
+  const [year, month] = parts;
+  validateYear(year);
+  validateMonth(month);
+  return { year, month };
+}
+
+function dateToKey(d) {
+  return `${d.year}-${String(d.month).padStart(2, '0')}-${String(d.day).padStart(2, '0')}`;
+}
+
+/** 将各种时间参数统一解析为 {start, end} */
+function resolveRange(kwargs) {
+  const dateStr = kwargs.date;
+  const monthStr = kwargs.month;
+  const yearArg = kwargs.year;
+  const fromStr = kwargs.from;
+  const toStr = kwargs.to;
+
+  // --from / --to 优先级最高
+  if (fromStr || toStr) {
+    if (!fromStr) throw new ArgumentError('使用 --to 时必须同时指定 --from');
+    const start = parseDate(fromStr);
+    const end = toStr ? parseDate(toStr) : localToday();
+    if (dateToKey(start) > dateToKey(end)) throw new ArgumentError('--from 不能晚于 --to');
+    return { start, end };
+  }
+
+  if (yearArg !== undefined && yearArg !== null) {
+    validateYear(yearArg, '--year');
+    return {
+      start: { year: yearArg, month: 1, day: 1 },
+      end: { year: yearArg, month: 12, day: 31 },
+    };
+  }
+
+  if (monthStr) {
+    const { year, month } = parseMonth(monthStr);
+    return {
+      start: { year, month, day: 1 },
+      end: { year, month, day: lastDayOfMonth(year, month) },
+    };
+  }
+
+  if (dateStr) {
+    const d = parseDate(dateStr);
+    return { start: d, end: d };
+  }
+
+  // 默认：今天
+  const today = localToday();
+  return { start: today, end: today };
+}
+
+// ── API 工具 ──────────────────────────────────────────────
+
+async function getYearDocId(page, year) {
+  const raw = await page.evaluate(`localStorage.getItem('daily_notes_doc_list')`);
+  if (!raw) return null;
+  const list = JSON.parse(raw);
+  return list.find((d) => d.name === `${year}年`)?.id ?? null;
+}
+
+async function getYearNodes(page, docId) {
+  const data = await mubuPost(page, '/document/edit/get', { docId });
+  const def = JSON.parse(data.definition);
+  return def.nodes ?? [];
+}
+
+/** 加载某年的所有 day 节点，返回带 dateKey 的列表 */
+async function loadYearEntries(page, year) {
+  const docId = await getYearDocId(page, year);
+  if (!docId) return [];
+
+  const yearNodes = await getYearNodes(page, docId);
+  const entries = [];
+
+  for (const monthNode of yearNodes) {
+    const monthNum = parseInt(htmlToText(monthNode.text), 10);
+    if (!monthNode.children?.length) continue;
+
+    for (const dayNode of monthNode.children) {
+      const plain = htmlToText(dayNode.text).replace(/\s+/g, ' ').trim();
+      const compact = plain.replace(/\s/g, '');
+      const match = compact.match(/^(\d+)月(\d+)日/);
+      if (!match) continue;
+      const m = parseInt(match[1], 10);
+      const d = parseInt(match[2], 10);
+      if (m !== monthNum) continue;
+
+      const dateKey = dateToKey({ year, month: m, day: d });
+      entries.push({ dateKey, label: plain, node: dayNode });
+    }
+  }
+
+  return entries;
+}
+
+/** 收集 [start, end] 范围内涉及的所有年份 */
+function yearsInRange(start, end) {
+  const years = [];
+  for (let y = start.year; y <= end.year; y++) years.push(y);
+  return years;
+}
+
+// ── 命令 ──────────────────────────────────────────────────
+
+cli({
+  site: 'mubu',
+  name: 'notes',
+  description: '读取幕布速记（默认今天）。支持 --date/--month/--year/--from/--to 指定时间范围，--list 为概览模式（日期+条数）。',
+  domain: 'mubu.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    {
+      name: 'list',
+      type: 'bool',
+      default: false,
+      help: '概览模式：只输出日期和条数，不含速记内容。可与任意时间范围参数组合。',
+    },
+    {
+      name: 'date',
+      help: '单日，格式 YYYY-MM-DD。不指定时间范围则默认今天（系统本地时间）。',
+    },
+    {
+      name: 'month',
+      help: '整月，格式 YYYY-MM。',
+    },
+    {
+      name: 'year',
+      type: 'int',
+      help: '整年，格式 YYYY（整数）。',
+    },
+    {
+      name: 'from',
+      help: '范围起始日，格式 YYYY-MM-DD。须与 --to 同时使用。',
+    },
+    {
+      name: 'to',
+      help: '范围截止日，格式 YYYY-MM-DD。须与 --from 同时使用。',
+    },
+    {
+      name: 'output',
+      default: 'md',
+      help: '输出格式：md（默认，Markdown）或 text（纯文本）',
+    },
+  ],
+  columns: ['date', 'content'],
+  func: async (page, kwargs) => {
+    const isList = kwargs.list;
+    const format = kwargs.output;
+    if (format !== 'md' && format !== 'text') {
+      throw new ArgumentError(`--output 只接受 md 或 text，收到：${format}`);
+    }
+
+    await page.goto('https://mubu.com/app');
+
+    const { start, end } = resolveRange(kwargs);
+    const startKey = dateToKey(start);
+    const endKey = dateToKey(end);
+
+    // 并行加载所有涉及年份的 day 节点，按范围过滤
+    const yearResults = await Promise.all(
+      yearsInRange(start, end).map((year) => loadYearEntries(page, year)),
+    );
+    const allEntries = yearResults
+      .flat()
+      .filter((e) => e.dateKey >= startKey && e.dateKey <= endKey);
+
+    if (allEntries.length === 0) {
+      const label = startKey === endKey ? startKey : `${startKey} ~ ${endKey}`;
+      return [{ date: label, content: '该时间段暂无速记' }];
+    }
+
+    // 概览模式
+    if (isList) {
+      return allEntries.map((e) => ({
+        date: e.label,
+        content: `${e.node.children?.length ?? 0} 条记录`,
+      }));
+    }
+
+    // 内容模式
+    const render = (children) =>
+      format === 'text' ? nodesToText(children) : nodesToMarkdown(children);
+
+    return allEntries
+      .filter((e) => e.node.children?.length)
+      .map((e) => ({
+        date: e.label,
+        content: render(e.node.children ?? []) || '（空）',
+      }));
+  },
+});

package/clis/mubu/recent.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { formatDate, mubuPost } from './utils.js';
+
+cli({
+  site: 'mubu',
+  name: 'recent',
+  description: '最近编辑的幕布文档',
+  domain: 'mubu.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: '最多显示条数' },
+  ],
+  columns: ['id', 'name', 'updated'],
+  func: async (page, kwargs) => {
+    const limit = kwargs.limit;
+
+    await page.goto('https://mubu.com/app');
+
+    const data = await mubuPost(page, '/list/get', { folderId: 'recent' });
+
+    return (data.documents ?? []).slice(0, limit).map((doc) => ({
+      id: doc.id,
+      name: doc.name,
+      updated: formatDate(doc.updateTime),
+    }));
+  },
+});

package/clis/mubu/search.js

@@ -0,0 +1,62 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { mubuPost, htmlToText } from './utils.js';
+
+cli({
+  site: 'mubu',
+  name: 'search',
+  description: '全局搜索幕布文档和文件夹（标题+内容，服务端全量匹配）。结果含 type/id/name/path/hits/snippet 字段。',
+  domain: 'mubu.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'query', positional: true, required: true, help: '搜索关键词' },
+    { name: 'limit', type: 'int', default: 100, help: '最多显示条数（默认 100，结果被截断时用 --limit N 调大）' },
+  ],
+  columns: ['type', 'id', 'name', 'path', 'hits', 'snippet'],
+  func: async (page, kwargs) => {
+    const query = kwargs.query;
+    const limit = kwargs.limit ?? 100;
+
+    await page.goto('https://mubu.com/app');
+
+    const data = await mubuPost(page, '/list/search', { keywords: query });
+
+    const formatPath = (paths) => paths.map((p) => p.name).join(' > ');
+
+    const folders = (data.folders ?? []).map((f) => ({
+      type: 'folder',
+      id: f.id,
+      name: f.name,
+      path: formatPath(f.paths),
+      hits: '',
+      snippet: '',
+    }));
+
+    const docs = (data.documents ?? []).map((d) => ({
+      type: 'doc',
+      id: d.id,
+      name: d.name,
+      path: formatPath(d.paths),
+      hits: d.total > 0 ? String(d.total) : '',
+      snippet: d.nodes
+        .map((n) => htmlToText(n.text))
+        .filter(Boolean)
+        .join(' | '),
+    }));
+
+    const all = [...folders, ...docs];
+    const result = all.slice(0, limit);
+
+    if (all.length > limit) {
+      result.push({
+        type: '...',
+        id: '',
+        name: `还有 ${all.length - limit} 条未显示，用 --limit ${all.length} 查看全部`,
+        path: '',
+        hits: '',
+        snippet: '',
+      });
+    }
+
+    return result;
+  },
+});

package/clis/mubu/utils.js

@@ -0,0 +1,304 @@
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
+
+export const API_BASE = 'https://api2.mubu.com/v3/api';
+const MUBU_DOMAIN = 'mubu.com';
+const AUTH_HINT = 'Mubu requires a logged-in browser session at mubu.com';
+
+function isAuthFailure(code, message) {
+  if (code === 401 || code === 403) return true;
+  if (!message) return false;
+  return /not logged in|login required|unauthorized|未登录|请先登录|需要登录|login expired/i.test(message);
+}
+
+/**
+ * 在浏览器页面上下文里用 XHR 发 POST 请求（参考 zsxq 适配器模式）。
+ * mubu app 自身也是这个机制：从 localStorage 读 Jwt-Token，通过同名 header 发到 api2.mubu.com。
+ * 不经过 Node.js 进程发网络请求，避免 CORS 问题和 extension fetch 拦截。
+ */
+export async function mubuPost(page, path, body) {
+  const url = `${API_BASE}${path}`;
+
+  const result = await page.evaluate(`
+    (async () => {
+      const token = localStorage.getItem('Jwt-Token');
+      if (!token) return { ok: false, status: 0, data: null, error: 'no token' };
+      return await new Promise((resolve) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open('POST', ${JSON.stringify(url)}, true);
+        xhr.setRequestHeader('Content-Type', 'application/json');
+        xhr.setRequestHeader('Jwt-Token', token);
+        xhr.onload = () => {
+          let data = null;
+          try { data = JSON.parse(xhr.responseText); } catch {}
+          resolve({ ok: xhr.status >= 200 && xhr.status < 300, status: xhr.status, data });
+        };
+        xhr.onerror = () => resolve({ ok: false, status: 0, data: null, error: 'network error' });
+        xhr.send(${JSON.stringify(JSON.stringify(body))});
+      });
+    })()
+  `);
+
+  if (!result || result.error === 'no token') {
+    throw new AuthRequiredError(MUBU_DOMAIN, AUTH_HINT);
+  }
+  if (!result.ok || !result.data) {
+    throw new CommandExecutionError(`mubu: ${path}: HTTP ${result.status} ${result.error ?? ''}`);
+  }
+
+  const { data } = result;
+  if (data.code !== 0) {
+    if (isAuthFailure(data.code, data.message)) {
+      throw new AuthRequiredError(MUBU_DOMAIN, AUTH_HINT);
+    }
+    throw new CommandExecutionError(`mubu: ${path}: code=${data.code} ${data.message ?? ''}`);
+  }
+
+  return data.data;
+}
+
+export function formatDate(ts) {
+  if (!ts) return '';
+  const d = new Date(ts);
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+
+const NAMED_ENTITIES = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ' };
+
+function decodeHtmlEntities(s) {
+  return s
+    .replace(/&#x([0-9a-f]+);/gi, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+    .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(parseInt(n, 10)))
+    .replace(/&(amp|lt|gt|quot|apos|nbsp);/g, (_, n) => NAMED_ENTITIES[n]);
+}
+
+/** 解析幕布 HTML 表格为行列二维数组（保留内部 HTML） */
+function parseTableRows(tableHtml) {
+  const rows = [];
+  const rowMatches = tableHtml.match(/<tr[^>]*>[\s\S]*?<\/tr>/gi) ?? [];
+  for (const row of rowMatches) {
+    const cells = [];
+    const cellMatches = row.match(/<(?:td|th)[^>]*>[\s\S]*?<\/(?:td|th)>/gi) ?? [];
+    for (const cell of cellMatches) {
+      // 只剥离最外层的 <td> 或 <th>，保留内部的加粗、链接和 <br>
+      let innerHtml = cell.replace(/^<(?:td|th)[^>]*>|<\/(?:td|th)>$/gi, '');
+      cells.push(innerHtml.trim());
+    }
+    rows.push(cells);
+  }
+  return rows;
+}
+
+/** 将幕布 HTML text 转为纯文本 */
+export function htmlToText(html) {
+  let text = html;
+  // 表格 → 纯文本（tab 分隔）；用 </table>\s*</div> 作结束锚，跳过 th/td 内部嵌套 div
+  text = text.replace(/<div class="table-container">[\s\S]*?<\/table>\s*<\/div>/g, (m) => {
+    return parseTableRows(m).map((r) => r.map(c => {
+      // 纯文本环境：<br> 换空格，清空所有标签
+      let plainCell = c.replace(/<br\s*\/?>/gi, ' ').replace(/<[^>]+>/g, '');
+      return decodeHtmlEntities(plainCell).trim();
+    }).join('\t')).join('\n');
+  });
+  text = text
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<[^>]+>/g, '');
+  return decodeHtmlEntities(text).trim();
+}
+
+/** 将幕布 HTML 表格转为 Markdown 表格 */
+function tableToMarkdown(tableHtml) {
+  const rows = parseTableRows(tableHtml);
+  if (rows.length === 0) return '';
+  
+  const processRow = (row) => row.map(cellHtml => {
+    // 把表格内的 <br> 换成占位符，防止稍后被全局替换为 \n 导致表格断裂
+    return cellHtml.replace(/<br\s*\/?>/gi, '[[BR]]');
+  }).join(' | ');
+
+  const lines = [`| ${processRow(rows[0])} |`, `| ${rows[0].map(() => '---').join(' | ')} |`];
+  for (let i = 1; i < rows.length; i++) {
+    lines.push(`| ${processRow(rows[i])} |`);
+  }
+  return lines.join('\n');
+}
+
+/** 将幕布 HTML text 转为 Markdown inline 标记 */
+export function htmlToMarkdown(html) {
+  let md = html;
+  
+  // 1. 表格 → Markdown 表格
+  md = md.replace(/<div class="table-container">[\s\S]*?<\/table>\s*<\/div>/g, (m) => tableToMarkdown(m));
+  
+  // 2. <br> → 换行
+  md = md.replace(/<br\s*\/?>/gi, '\n');
+  
+  // 3. 统一处理样式标签，支持多 class 组合
+  md = md.replace(/<span class="([^"]+)"[^>]*>([\s\S]*?)<\/span>/gi, (match, classes, inner) => {
+    // 允许正常处理超链接内部的 bold 和 italic 样式
+    if (classes.includes('node-mention')) {
+      return match;
+    }
+    let res = inner;
+    if (/\bbold\b/.test(classes)) res = `**${res}**`;
+    if (/\bitalic\b/.test(classes)) res = `*${res}*`;
+    if (/\bstrikethrough\b/.test(classes)) res = `~~${res}~~`;
+    if (/\bunderline\b/.test(classes)) res = `\uFFFEU_OPEN\uFFFE${res}\uFFFEU_CLOSE\uFFFE`;
+    return res;
+  });
+
+  // 4. node-mention（主题链接 → Markdown 链接，支持组合 class 并继承自身样式）
+  md = md.replace(
+    /<span([^>]*\bclass="[^"]*\bnode-mention\b[^"]*"[^>]*)>([\s\S]*?)<\/span>/gi,
+    (match, attrs, inner) => {
+      const docMatch = attrs.match(/\bdata-doc="([^"]+)"/i);
+      const docId = docMatch ? docMatch[1] : '';
+      if (!docId) return match;
+      
+      const classMatch = attrs.match(/\bclass="([^"]+)"/i);
+      const classes = classMatch ? classMatch[1] : '';
+      
+      let res = inner.replace(/<[^>]+>/g, '').trim();
+      
+      // 继承标签自身的样式
+      if (/\bbold\b/.test(classes)) res = `**${res}**`;
+      if (/\bitalic\b/.test(classes)) res = `*${res}*`;
+      if (/\bstrikethrough\b/.test(classes)) res = `~~${res}~~`;
+      if (/\bunderline\b/.test(classes)) res = `\uFFFEU_OPEN\uFFFE${res}\uFFFEU_CLOSE\uFFFE`;
+      
+      return `[${res}](https://mubu.com/app/edit/${docId})`;
+    }
+  );
+  
+  // 5. links （外部链接 → Markdown 链接，继承 a 标签自身样式）
+  md = md.replace(/<a([^>]*)>([\s\S]*?)<\/a>/gi, (match, attrs, inner) => {
+    const hrefMatch = attrs.match(/\bhref="([^"]+)"/i);
+    if (!hrefMatch) return match;
+    const href = hrefMatch[1];
+    
+    const classMatch = attrs.match(/\bclass="([^"]+)"/i);
+    const classes = classMatch ? classMatch[1] : '';
+    
+    let res = inner;
+    
+    // 继承 a 标签自身的样式
+    if (/\bbold\b/.test(classes)) res = `**${res}**`;
+    if (/\bitalic\b/.test(classes)) res = `*${res}*`;
+    if (/\bstrikethrough\b/.test(classes)) res = `~~${res}~~`;
+    if (/\bunderline\b/.test(classes)) res = `\uFFFEU_OPEN\uFFFE${res}\uFFFEU_CLOSE\uFFFE`;
+    
+    return `[${res}](${href})`;
+  });
+  
+  // 6. 普通 span
+  md = md.replace(/<span[^>]*>([\s\S]*?)<\/span>/gi, '$1');
+  
+  // 7. 清理其余标签
+  md = md.replace(/<[^>]+>/g, '');
+  
+  // 8. HTML 实体解码
+  md = decodeHtmlEntities(md);
+  
+  // 9. 还原 underline 占位符
+  md = md.replace(/\uFFFEU_OPEN\uFFFE/g, '<u>').replace(/\uFFFEU_CLOSE\uFFFE/g, '</u>');
+  
+  // 10. 还原表格内的换行符
+  md = md.replace(/\[\[BR\]\]/g, '<br>');
+
+  return md.trim();
+}
+
+const IMAGE_BASE = 'https://api2.mubu.com/v3';
+
+function imageUrl(uri) {
+  return uri.startsWith('http') ? uri : `${IMAGE_BASE}/${uri}`;
+}
+
+function taskPrefix(node) {
+  if (!node.taskStatus) return '';
+  return node.taskStatus === 2 ? '[x] ' : '[ ] ';
+}
+
+function taskMeta(node) {
+  const parts = [];
+  if (node.deadline) {
+    const ts = formatDate(node.deadline * 1000);
+    parts.push(`📅 ${node.deadlineType === 'date' ? ts.slice(0, 10) : ts}`);
+  }
+  if (node.remindAt) parts.push(`⏰ ${formatDate(node.remindAt * 1000)}`);
+  return parts.length ? ' ' + parts.join(' ') : '';
+}
+
+/** 递归将节点树渲染为缩进纯文本 */
+export function nodesToText(nodes, depth = 0) {
+  const lines = [];
+  for (const node of nodes) {
+    const indent = '  '.repeat(depth);
+    const emoji = node.emoji ? node.emoji + ' ' : '';
+    const text = htmlToText(node.text);
+    const prefix = taskPrefix(node);
+    const meta = taskMeta(node);
+    if (text || emoji || prefix) {
+      if (text.includes('\n')) {
+        const [first, ...rest] = text.split('\n');
+        lines.push(indent + prefix + emoji + first);
+        for (const line of rest) lines.push(indent + '  ' + line);
+        if (meta) lines.push(indent + '  ' + meta.trim());
+      } else {
+        lines.push(indent + prefix + emoji + text + meta);
+      }
+    }
+    if (node.note) {
+      const noteText = htmlToText(node.note);
+      for (const line of noteText.split('\n')) lines.push(indent + '  ' + line);
+    }
+    if (node.images?.length) {
+      for (const img of node.images) {
+        lines.push(indent + `[图片: ${imageUrl(img.uri)}]`);
+      }
+    }
+    if (node.children?.length) {
+      lines.push(nodesToText(node.children, depth + 1));
+    }
+  }
+  return lines.filter(Boolean).join('\n');
+}
+
+/** 递归将节点树渲染为 Markdown（大纲 = 缩进列表，不映射为标题） */
+export function nodesToMarkdown(nodes, depth = 0) {
+  const lines = [];
+  for (const node of nodes) {
+    const text = htmlToMarkdown(node.text);
+    if (!text && !node.images?.length && !node.note && !node.emoji) continue;
+
+    const indent = '  '.repeat(depth);
+    const emoji = node.emoji ? node.emoji + ' ' : '';
+    const prefix = taskPrefix(node);
+    const meta = taskMeta(node);
+    if (text || emoji || prefix) {
+      if (text.includes('\n')) {
+        const [first, ...rest] = text.split('\n');
+        lines.push(indent + '- ' + prefix + emoji + first);
+        const continuation = indent + '  ';
+        for (const line of rest) lines.push(continuation + line);
+        if (meta) lines.push(continuation + meta.trim());
+      } else {
+        lines.push(indent + '- ' + prefix + emoji + text + meta);
+      }
+    }
+    if (node.note) {
+      const noteLines = htmlToMarkdown(node.note).split('\n');
+      for (const line of noteLines) lines.push(indent + '  > ' + line);
+    }
+    if (node.images?.length) {
+      for (const img of node.images) {
+        lines.push(indent + `  ![image](${imageUrl(img.uri)})`);
+      }
+    }
+
+    if (node.children?.length) {
+      lines.push(nodesToMarkdown(node.children, depth + 1));
+    }
+  }
+  return lines.filter(Boolean).join('\n');
+}

package/clis/reuters/search.js

@@ -21,7 +21,7 @@ cli({
       (async () => {
         const count = ${count};
         const apiQuery = JSON.stringify({
-          keyword: '${kwargs.query.replace(/'/g, "\\'")}',
+          keyword: ${JSON.stringify(kwargs.query)},
           offset: 0, orderby: 'display_date:desc', size: count, website: 'reuters'
         });
         const apiUrl = 'https://www.reuters.com/pf/api/v3/content/fetch/articles-by-search-v2?query=' + encodeURIComponent(apiQuery);