remnote-bridge 0.1.8 → 0.1.10

package/remnote-plugin/src/services/breadcrumb.ts

@@ -5,6 +5,7 @@
  */
 
 import type { ReactRNPlugin, PluginRem as Rem } from '@remnote/plugin-sdk';
+import { safeToMarkdown } from './rem-builder';
 
 /**
  * 从 rem 向上追溯到根，返回路径名称数组（从根到当前）。
@@ -17,7 +18,7 @@ export async function buildBreadcrumb(
   let current: Rem | undefined = rem;
 
   while (current) {
-    const text = await plugin.richText.toMarkdown(current.text ?? []);
+    const text = await safeToMarkdown(plugin, current.text ?? []);
     path.unshift(text.replace(/\n/g, ' ').trim() || current._id);
     current = await current.getParentRem();
   }

package/remnote-plugin/src/services/read-context.ts

@@ -19,7 +19,7 @@ import {
 import { filterNoisyChildren } from './powerup-filter';
 import { sliceSiblings } from '../utils/elision';
 import { buildBreadcrumb } from './breadcrumb';
-import { buildFullSerializableRem as buildFullRem } from './rem-builder';
+import { buildFullSerializableRem as buildFullRem, safeToMarkdown } from './rem-builder';
 
 export interface ReadContextPayload {
   mode?: 'focus' | 'page';
@@ -350,7 +350,7 @@ async function buildMinimalSerializableRem(
 ) {
   const isPortal = rem.type === 6;
   const [markdownText, isDocument, portalIncludedRems] = await Promise.all([
-    plugin.richText.toMarkdown(rem.text ?? []),
+    safeToMarkdown(plugin, rem.text ?? []),
     rem.isDocument(),
     isPortal ? rem.getPortalDirectlyIncludedRem() : Promise.resolve([]),
   ]);

package/remnote-plugin/src/services/read-globe.ts

@@ -21,6 +21,7 @@ import {
 } from '../utils/tree-serializer';
 import { sliceSiblings } from '../utils/elision';
 import { filterNoisyChildren } from './powerup-filter';
+import { safeToMarkdown } from './rem-builder';
 
 export interface ReadGlobePayload {
   depth?: number;
@@ -75,7 +76,7 @@ export async function readGlobe(
 
     const isPortal = rem.type === 6;
     const [markdownText, portalIncludedRems] = await Promise.all([
-      plugin.richText.toMarkdown(rem.text ?? []),
+      safeToMarkdown(plugin, rem.text ?? []),
       isPortal ? rem.getPortalDirectlyIncludedRem() : Promise.resolve([]),
     ]);
 

package/remnote-plugin/src/services/read-tree.ts

@@ -18,7 +18,7 @@ import {
 } from '../utils/tree-serializer';
 import { filterNoisyChildren } from './powerup-filter';
 import { sliceSiblings } from '../utils/elision';
-import { buildFullSerializableRem, sanitizeNewlines } from './rem-builder';
+import { buildFullSerializableRem, sanitizeNewlines, safeToMarkdown } from './rem-builder';
 
 export interface ReadTreePayload {
   remId: string;
@@ -190,7 +190,7 @@ export async function readTree(
       const parent = await current.getParentRem();
       if (!parent) break;
       const [name, children, isDoc] = await Promise.all([
-        plugin.richText.toMarkdown(parent.text ?? []),
+        safeToMarkdown(plugin, parent.text ?? []),
         parent.getChildrenRem(),
         parent.isDocument(),
       ]);

package/remnote-plugin/src/services/rem-builder.ts

@@ -11,6 +11,56 @@ import type { ReactRNPlugin, PluginRem as Rem } from '@remnote/plugin-sdk';
 import type { SerializableRem } from '../utils/tree-serializer';
 import { filterNoisyTags } from './powerup-filter';
 
+/**
+ * SDK richText.toMarkdown 的安全包装。
+ * SDK 不认识某些 RichText 类型（如 "i":"u" URL 链接），会抛 Invalid input。
+ * 失败时回退到本地解析。
+ */
+export async function safeToMarkdown(
+  plugin: ReactRNPlugin,
+  richText: unknown[],
+): Promise<string> {
+  try {
+    return await plugin.richText.toMarkdown(richText);
+  } catch {
+    return richTextFallback(richText);
+  }
+}
+
+/**
+ * 本地 RichText → 纯文本回退，处理 SDK 不支持的类型。
+ *
+ * 覆盖 RICH_TEXT_ELEMENT_TYPE 枚举全部 12 种类型 + 遗留 "u" 类型：
+ *   m=TEXT, q=REM, i=IMAGE, a=AUDIO, x=LATEX, p=PLUGIN,
+ *   g=GLOBAL_NAME, s=CARD_DELIMITER, n=ANNOTATION,
+ *   fi=FLASHCARD_ICON, ai=ADD_ICON, o=DEPRECATED_CODE, u=URL(遗留)
+ */
+function richTextFallback(richText: unknown[]): string {
+  return richText.map(item => {
+    if (typeof item === 'string') return item;
+    if (typeof item !== 'object' || item === null) return '';
+    const obj = item as Record<string, unknown>;
+    switch (obj.i) {
+      case 'm': return String(obj.text ?? '');
+      case 'q': return `[[${String(obj._id ?? '')}]]`;
+      case 'u': return obj.title
+        ? `[${String(obj.title)}](${String(obj.url)})`
+        : String(obj.url ?? '');
+      case 'x': return `$${String(obj.text ?? '')}$`;
+      case 'i': return `![image](${String(obj.url ?? '')})`;
+      case 'a': return `[audio](${String(obj.url ?? '')})`;
+      case 'p': return String(obj.text ?? '');           // PLUGIN
+      case 'g': return String(obj.text ?? '');           // GLOBAL_NAME
+      case 'n': return String(obj.text ?? '');           // ANNOTATION
+      case 'o': return String(obj.text ?? '');           // DEPRECATED_CODE
+      case 's':                                          // CARD_DELIMITER
+      case 'fi':                                         // FLASHCARD_ICON
+      case 'ai': return '';                              // ADD_ICON（纯视觉标记）
+      default: return String(obj.text ?? obj.url ?? '');
+    }
+  }).join('');
+}
+
 export interface BuildFullRemOptions {
   /** 是否保留 Powerup 系统 Tag（默认 false = 过滤掉） */
   includePowerup?: boolean;
@@ -46,8 +96,8 @@ export async function buildFullSerializableRem(
     hasDvPowerup,
     portalIncludedRems,
   ] = await Promise.all([
-    plugin.richText.toMarkdown(rem.text ?? []),
-    rem.backText ? plugin.richText.toMarkdown(rem.backText) : Promise.resolve(null),
+    safeToMarkdown(plugin, rem.text ?? []),
+    rem.backText ? safeToMarkdown(plugin, rem.backText) : Promise.resolve(null),
     rem.getType(),
     rem.isCardItem(),
     rem.isDocument(),
@@ -80,7 +130,7 @@ export async function buildFullSerializableRem(
   const tags = await Promise.all(
     tagRems.map(async (t) => ({
       id: t._id,
-      name: sanitizeNewlines(await plugin.richText.toMarkdown(t.text ?? [])),
+      name: sanitizeNewlines(await safeToMarkdown(plugin, t.text ?? [])),
     })),
   );
 

package/remnote-plugin/src/services/search.ts

@@ -7,6 +7,7 @@
  */
 
 import type { ReactRNPlugin } from '@remnote/plugin-sdk';
+import { safeToMarkdown } from './rem-builder';
 
 export interface SearchPayload {
   query: string;
@@ -39,7 +40,7 @@ export async function search(
 
   const results: SearchResultItem[] = [];
   for (const rem of rems) {
-    const markdownText = await plugin.richText.toMarkdown(rem.text ?? []);
+    const markdownText = await safeToMarkdown(plugin, rem.text ?? []);
     const isDocument = await rem.isDocument();
     results.push({
       remId: rem._id,

package/skills/remnote-bridge/SKILL.md

@@ -267,6 +267,8 @@ Rem 的属性（文本、类型、格式、标签）  → edit-rem   （前置
 
 标准模式每次 connect 后都需要用户手动操作 RemNote。Headless 模式通过 setup（一次性）+ headless Chrome 实现自动连接，后续 connect 无需用户介入。
 
+**⚠️ 模式选择建议**：日常使用推荐**标准模式**。Headless 模式下 Chrome 在后台运行，**无法感知用户正在 RemNote 中浏览和操作的界面**（`read-context` 返回的是 headless Chrome 的上下文，而非用户的浏览器）。只有在全自动化场景（CI/CD、定时任务、批量操作等无需与用户界面交互的场景）才建议使用 Headless 模式。
+
 #### 首次使用（setup）
 
 setup 会弹出 Chrome 窗口，用户需要完成两件事：