remnote-bridge 0.1.15 → 0.1.16

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

@@ -7,7 +7,7 @@
  * 依赖方向：services/rem-builder → utils/tree-serializer（单向）
  */
 
-import type { ReactRNPlugin, PluginRem as Rem } from '@remnote/plugin-sdk';
+import type { ReactRNPlugin, PluginRem as Rem, RichTextInterface } from '@remnote/plugin-sdk';
 import type { SerializableRem } from '../utils/tree-serializer';
 import { filterNoisyTags } from './powerup-filter';
 
@@ -21,7 +21,7 @@ export async function safeToMarkdown(
   richText: unknown[],
 ): Promise<string> {
   try {
-    return await plugin.richText.toMarkdown(richText);
+    return await plugin.richText.toMarkdown(richText as RichTextInterface);
   } catch {
     return richTextFallback(richText);
   }
@@ -93,6 +93,8 @@ export async function buildFullSerializableRem(
     isTodo,
     todoStatus,
     isCode,
+    isQuote,
+    isListItem,
     hasDvPowerup,
     portalIncludedRems,
   ] = await Promise.all([
@@ -114,6 +116,8 @@ export async function buildFullSerializableRem(
     rem.isTodo(),
     rem.getTodoStatus(),
     rem.isCode(),
+    rem.isQuote(),
+    rem.isListItem(),
     rem.hasPowerup('dv'),
     rem.type === 6 ? rem.getPortalDirectlyIncludedRem() : Promise.resolve([]),
   ]);
@@ -151,6 +155,8 @@ export async function buildFullSerializableRem(
     isTodo,
     todoStatus: (todoStatus as 'Finished' | 'Unfinished' | null) ?? null,
     isCode,
+    isQuote,
+    isListItem,
     isDivider,
     isTopLevel: rem.parent === null,
   };

package/remnote-plugin/src/utils/tree-serializer.ts

@@ -65,6 +65,8 @@ export interface SerializableRem {
   isTodo: boolean;
   todoStatus: 'Finished' | 'Unfinished' | null;
   isCode: boolean;
+  isQuote: boolean;
+  isListItem: boolean;
   isDivider: boolean;
   /** 是否为知识库顶级 Rem（无父节点） */
   isTopLevel?: boolean;
@@ -131,6 +133,12 @@ function buildLineContent(rem: SerializableRem): string {
   // Code 包裹（最内层）
   if (rem.isCode) baseContent = '`' + baseContent + '`';
 
+  // ListItem 前缀（有序列表）
+  if (rem.isListItem) baseContent = '1. ' + baseContent;
+
+  // Quote 前缀（引用块）
+  if (rem.isQuote) baseContent = '> ' + baseContent;
+
   // Todo 前缀
   if (rem.isTodo) {
     const cb = rem.todoStatus === 'Finished' ? '- [x] ' : '- [ ] ';
@@ -207,6 +215,8 @@ export function createMinimalSerializableRem(
     isTodo: false,
     todoStatus: null,
     isCode: false,
+    isQuote: false,
+    isListItem: false,
     isDivider: false,
     ...overrides,
   };

package/skills/remnote-bridge/SKILL.md

@@ -451,6 +451,8 @@ read-tree / read-globe / read-context 输出 Markdown 大纲，edit-tree 基于
 |:-----|:-----|
 | `# ` / `## ` / `### ` | H1/H2/H3 标题 |
 | `- [ ] ` / `- [x] ` | 未完成/已完成待办 |
+| `> ` | 引用块 |
+| `1. ` | 有序列表项 |
 | `` `...` `` | 代码块 |
 | `---` | 分隔线 |
 
@@ -521,6 +523,8 @@ read-tree / read-globe / read-context 输出 Markdown 大纲，edit-tree 基于
   新闪卡 → 答案
   问题 ↔ 回答
   - [ ] 新待办
+  > 引用内容
+  1. 列表项
   `代码块`
 ```
 

package/skills/remnote-bridge/instructions/edit-tree.md

@@ -251,10 +251,20 @@ newStr: "  新增节点\n  子节点 A <!--idA-->"
 | `### text` | 创建 H3 标题 |
 | `- [ ] text` | 创建未完成待办 |
 | `- [x] text` | 创建已完成待办 |
+| `1. text` | 创建有序列表项 |
 | `` `text` `` | 创建代码块 |
 | `---` | 创建分隔线 |
 
-前缀可组合叠加，解析顺序为 Header → Todo → Code。例如 `## - [ ] text` 创建 H2 + 未完成待办。
+前缀可组合叠加，解析顺序为 Header → Todo → Quote → ListItem → Code。例如 `## - [ ] text` 创建 H2 + 未完成待办。
+
+> **⚠️ 有序列表必须用 `1. ` 前缀**
+>
+> RemNote 的有序列表采用 Lazy Numbering 风格——所有列表项统一写 `1. `，RemNote 按层级自动编号为 1./2./3./A./B./I./II. 等。
+>
+> - **正确**：`1. 第一项`、`1. 第二项`、`1. 第三项`（全部用 `1. `）
+> - **错误**：`2. 第二项`、`3. 第三项`（手动编号无意义，RemNote 会忽略）
+>
+> 系统会容错处理 `2. `~`9. ` 前缀（自动归一化为 `isListItem=true` 并返回 `templateWarnings` 警告），但 `10. ` 及以上不会被识别为有序列表，而是作为纯文本保留。
 
 #### 新增行的箭头分隔符
 

package/skills/remnote-bridge/instructions/overall.md

@@ -642,9 +642,17 @@ read-tree / read-globe / read-context 的输出核心是 Markdown 大纲文本
 | `### ` | H3 标题 | `fontSize: 'H3'` |
 | `- [ ] ` | 未完成待办 | `isTodo: true, todoStatus: 'Unfinished'` |
 | `- [x] ` | 已完成待办 | `isTodo: true, todoStatus: 'Finished'` |
+| `> ` | 引用块 | `isQuote: true` |
+| `1. ` | 有序列表项（⚠️ 见下方说明） | `isListItem: true` |
 | `` `...` `` | 代码块 | `isCode: true` |
 | `---` | 分隔线 | Divider Powerup |
 
+> **⚠️ 有序列表必须用 `1. ` 前缀（Lazy Numbering）**
+>
+> RemNote 有序列表采用 Lazy Numbering——所有列表项统一写 `1. `，RemNote 按层级自动编号（1./2./3./A./B./I./II.）。不要手动编号。
+> - `2. `~`9. ` 会被容错处理（归一化为 `isListItem=true`，返回 `templateWarnings` 警告）
+> - `10. ` 及以上**不会**被识别为有序列表，而是作为纯文本内容保留
+
 ### 8.3 箭头分隔符
 
 箭头编码 `practiceDirection`（闪卡练习方向），不编码 type（type 由元数据标记承载）。
@@ -811,6 +819,8 @@ edit-tree 使用 str_replace 对 Markdown 大纲进行结构编辑。详细文
   # 新标题 H1
   新闪卡 → 答案
   - [ ] 新待办
+  > 引用内容
+  1. 列表项
   `代码块内容`
 ```
 

package/skills/remnote-bridge-test/SKILL.md

@@ -140,6 +140,9 @@ Skill 接口加 `s` 后缀（**s** = Skill）。这样两个 subagent 创建的
 ### Step 2：构造 subagent 并执行
 
 使用 haiku subagent 执行测试。
+严禁只使用单个 sub-agent 进行测试。
+除非测试用例有特别说明，否则必须同时启用 MCP 和 Skill 两个 sub-agent 进行测试。根据测试要求，动态决定是否并行。
+严禁只测一个 sub-agent 的行为。
 
 #### 双接口策略
 

package/skills/remnote-bridge-test/references/regression-suite.md

@@ -270,6 +270,70 @@
 
 ---
 
+### L2-05: Markdown 前缀转换（有序列表 + 引用块）
+
+**task_description**:
+```
+测试 Markdown 前缀（有序列表 `1. ` 和引用块 `> `）的双向转换能力。
+
+1. 确认连接正常
+2. 读取测试页面的子树（read_tree）
+3. 在测试页面下创建以下结构（edit_tree），包含有序列表和引用块，层级嵌套到 4 层：
+
+   {prefix} Markdown 前缀测试
+     ## 有序列表测试
+       1. 第一层列表项A
+         1. 第二层列表项A-1
+           1. 第三层列表项A-1-a
+             1. 第四层列表项A-1-a-i
+             1. 第四层列表项A-1-a-ii
+           1. 第三层列表项A-1-b
+         1. 第二层列表项A-2
+       1. 第一层列表项B
+         1. 第二层列表项B-1
+         1. 第二层列表项B-2
+           1. 第三层列表项B-2-a
+     ## 引用块测试
+       > 这是一段引用文本
+       > 这是另一段引用
+       普通文本（不是引用）
+     ## 混合格式测试
+       1. 有序列表项带闪卡 → 答案内容
+       > 引用块带闪卡 → 引用中的答案
+       - [ ] 待办事项
+       `代码块内容`
+
+4. 重新读取子树（read_tree，depth=5），验证：
+   - 有序列表项都有 `1. ` 前缀
+   - 引用块都有 `> ` 前缀
+   - 4 层嵌套的有序列表层级正确
+   - 普通文本没有 `1. ` 或 `> ` 前缀
+   - 混合格式中各前缀正确（`1. `、`> `、`- [ ] `、反引号）
+
+5. 对任意 2 个有序列表节点和 1 个引用块节点执行 read_rem，验证：
+   - 有序列表节点 isListItem=true
+   - 引用块节点 isQuote=true
+   - 普通文本节点 isListItem=false, isQuote=false
+```
+
+**Chrome 验证**：
+- ⬜ "{prefix} Markdown 前缀测试" 存在
+- ⬜ "有序列表测试" 下的节点显示为数字编号（1. 2. 3...），而非 bullet
+- ⬜ 有序列表嵌套到 4 层，每层都有数字编号
+- ⬜ "引用块测试" 下有灰色引用样式（左侧竖线 + 浅灰背景）
+- ⬜ "普通文本（不是引用）" 是正常样式，没有引用标记
+- ⬜ 混合格式区域各格式正确（有序列表、引用、待办、代码块共存）
+
+**断言**：
+- [ ] edit_tree 成功创建包含 `1. ` 和 `> ` 前缀的结构
+- [ ] read_tree 输出中有序列表项带 `1. ` 前缀
+- [ ] read_tree 输出中引用块带 `> ` 前缀
+- [ ] 4 层嵌套有序列表结构完整
+- [ ] read_rem 确认 isListItem=true / isQuote=true
+- [ ] 混合格式互不干扰
+
+---
+
 ## L3 多步工作流
 
 > 多步骤组合链路，模拟真实的知识整理流程。