remnote-bridge 0.1.15 → 0.1.17

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

@@ -42,7 +42,7 @@ export async function readContext(
   payload: ReadContextPayload,
 ): Promise<ReadContextResult> {
   const {
-    mode = 'focus',
+    mode = 'page',
     ancestorLevels = 2,
     maxNodes = 200,
     maxSiblings = 20,

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/types.ts

@@ -97,13 +97,20 @@ export type PropertyTypeValue =
 
 // ─── RemObject 主体 ─────────────────────────────────────────
 
+/**
+ * RemObject 字段注释标记说明：
+ * - [R] 只读 / [RW] 可读写 / [R-F] 只读+默认过滤
+ * - 🛡️D2 = 参与防线2语义比较（变化 → 硬拒绝）
+ * - ⚠️D2 = 敏感元数据（变化 → 放行 + 专门警告）
+ * - ⊘D2 = 普通元数据（变化 → 放行 + 统一警告）
+ */
 export interface RemObject {
 
   // ══════════════════════════════════════════════════════════
   //  核心标识
   // ══════════════════════════════════════════════════════════
 
-  /** [R] Rem 唯一 ID。SDK 直接属性 _id */
+  /** [R] ⊘D2 Rem 唯一 ID。SDK 直接属性 _id */
   id: string;
 
   // ══════════════════════════════════════════════════════════
@@ -111,12 +118,12 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 正面文本（RichText 数组）。SDK: text / setText()
+   * [RW] 🛡️D2 ✅ 正面文本（RichText 数组）。SDK: text / setText()
    * UI 行为：文本内容立即更新显示，无格式副作用
    */
   text: RichText;
   /**
-   * [RW] ✅ 背面文本。SDK: backText / setBackText()
+   * [RW] 🛡️D2 ✅ 背面文本。SDK: backText / setBackText()
    * UI 行为：设值后 Rem 显示为 "正面文本 → 背面文本" 格式（箭头分隔符）
    *         默认 null（无背面）；设值即产生闪卡正反面结构
    * 写入语义：null → setBackText([])（SDK 接受 undefined | RichTextInterface，空数组清除背面）
@@ -129,14 +136,14 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ Rem 类型。SDK: type, getType() / setType(SetRemType)
+   * [RW] 🛡️D2 ✅ Rem 类型。SDK: type, getType() / setType(SetRemType)
    * UI 行为：CONCEPT → 文字变粗体；DESCRIPTOR → 保持正常字重（与默认无视觉差异）
    *         SetRemType 不含 PORTAL(6)，Portal 只能通过 createPortal() 创建
    * 底层机制：纯字段修改，不涉及 Powerup Tag 注入或隐藏子 Rem
    */
   type: RemTypeValue;
   /**
-   * [RW] ✅ 是否作为独立文档页面打开。SDK: isDocument() / setIsDocument()
+   * [RW] 🛡️D2 ✅ 是否作为独立文档页面打开。SDK: isDocument() / setIsDocument()
    * UI 行为：bullet (•) 变为文档页面图标（小方块），Rem 可作为独立页面打开
    *         独立于 type，CONCEPT Rem 可以同时是 Document
    * 底层机制：Powerup — 注入"文档" Tag + 自动创建 [Status];;[Draft] descriptor 子 Rem
@@ -148,11 +155,12 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 父 Rem ID。null 表示顶级。SDK: parent / setParent(parent, position?)
+   * [RW] ⚠️D2 ✅ 父 Rem ID。null 表示顶级。SDK: parent / setParent(parent, position?)
    * UI 行为：Rem 从原位置消失，出现在新父级的子列表中
+   * 防线2：结构操作后常变化，放行但输出专门警告
    */
   parent: string | null;
-  /** [R] 子 Rem ID 有序数组。SDK 直接属性 children（修改子的 parent 间接改变） */
+  /** [R] ⊘D2 子 Rem ID 有序数组。SDK 直接属性 children（修改子的 parent 间接改变） */
   children: string[];
 
   // ══════════════════════════════════════════════════════════
@@ -160,14 +168,14 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 标题大小。SDK: getFontSize() / setFontSize()
+   * [RW] 🛡️D2 ✅ 标题大小。SDK: getFontSize() / setFontSize()
    * UI 行为：H1 → 超大粗体；H2 → 大粗体（略小于 H1）；H3 → 中粗体
    *         默认 null（普通大小）；setFontSize(undefined) 恢复
    * 底层机制：Powerup — 注入"标题" Tag + 创建 [Size];;[H1/H2/H3] descriptor 子 Rem
    */
   fontSize: FontSize | null;
   /**
-   * [RW] ✅ 高亮颜色。SDK: getHighlightColor() / setHighlightColor()
+   * [RW] 🛡️D2 ✅ 高亮颜色。SDK: getHighlightColor() / setHighlightColor()
    * UI 行为：整行背景变为对应颜色（Red→粉红、Blue→浅蓝），bullet 也着色
    *         默认 null（无高亮）
    * SDK 注意：setHighlightColor() 只能设置颜色，不能清除（null/undefined 均被拒绝）
@@ -181,47 +189,47 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 是否待办。SDK: isTodo() / setIsTodo()
+   * [RW] 🛡️D2 ✅ 是否待办。SDK: isTodo() / setIsTodo()
    * UI 行为：文本前出现空心 checkbox（☐）；副作用：todoStatus 自动初始化为 "Unfinished"
    * 底层机制：Powerup — 注入"待办" Tag + 自动创建 [Status];;[Unfinished] descriptor 子 Rem
    */
   isTodo: boolean;
   /**
-   * [RW] ✅ 待办完成状态。SDK: getTodoStatus() / setTodoStatus()
+   * [RW] 🛡️D2 ✅ 待办完成状态。SDK: getTodoStatus() / setTodoStatus()
    * UI 行为：Finished → checkbox 变蓝色已勾选（☑）+ 文本加删除线
    *         前提：需先 setIsTodo(true)，否则无意义
    * 写入语义：null → 跳过（清除 todo 状态应通过 isTodo=false 实现，SDK 不接受 null）
    */
   todoStatus: TodoStatus | null;
   /**
-   * [RW] ✅ 是否代码块。SDK: isCode() / setIsCode()
+   * [RW] 🛡️D2 ✅ 是否代码块。SDK: isCode() / setIsCode()
    * UI 行为：Rem 变为代码块容器——等宽字体、灰色背景、块级缩进
    * 底层机制：Powerup — 注入"代码" Tag，无参数子 Rem
    */
   isCode: boolean;
   /**
-   * [RW] ✅ 是否引用块。SDK: isQuote() / setIsQuote()
+   * [RW] 🛡️D2 ✅ 是否引用块。SDK: isQuote() / setIsQuote()
    * UI 行为：左侧出现灰色竖线 + 行背景变浅灰（经典 blockquote 样式）
    * 底层机制：Powerup — 注入"引用" Tag，无参数子 Rem
    */
   isQuote: boolean;
   /**
-   * [RW] ✅ 是否列表项。SDK: isListItem() / setIsListItem()
+   * [RW] 🛡️D2 ✅ 是否列表项。SDK: isListItem() / setIsListItem()
    * UI 行为：bullet (•) 变为数字编号 "1."（有序列表样式）
    * 底层机制：Powerup — 注入"列表项" Tag，无参数子 Rem
    */
   isListItem: boolean;
   /**
-   * [RW] ✅ 是否卡片项。SDK: isCardItem() / setIsCardItem()
+   * [RW] 🛡️D2 ✅ 是否卡片项。SDK: isCardItem() / setIsCardItem()
    * UI：无明显变化。功能：标记 Rem 以卡片样式显示（类似看板布局），
    *     而非默认项目符号列表，在 RemNote 的 Card View 中生效
    * 底层机制：Powerup — 注入"卡片条目" Tag (MultiLineCard)，无参数子 Rem
    */
   isCardItem: boolean;
-  /** [R] 是否表格。SDK: isTable()（无 setIsTable，只有 setTableFilter） */
+  /** [R] 🛡️D2 是否表格。SDK: isTable()（无 setIsTable，只有 setTableFilter） */
   isTable: boolean;
   /**
-   * [RW] ✅ 是否 Powerup 插槽。SDK: isSlot() / setIsSlot()
+   * [RW] 🛡️D2 ✅ 是否 Powerup 插槽。SDK: isSlot() / setIsSlot()
    * UI：bullet 变为方形图标（☐）。功能：标记 Rem 为 Powerup 的数据插槽（slot），
    *     Powerup 注册时通过 slots 配置定义，用于存储键值对数据（值为 RichText）。
    *     通过 getPowerupProperty(code, slot) / setPowerupProperty() 读写
@@ -232,7 +240,7 @@ export interface RemObject {
    */
   isSlot: boolean;
   /**
-   * [RW] ✅ 是否 Tag 属性（表格列）。SDK: isProperty() / setIsProperty()
+   * [RW] 🛡️D2 ✅ 是否 Tag 属性（表格列）。SDK: isProperty() / setIsProperty()
    * UI：bullet 变为方形图标（☐，与 isSlot 相同）。功能：标记 Rem 为父级 Tag 的
    *     结构化属性列，可通过 getPropertyType() 指定数据类型（text/number/date/checkbox/
    *     single_select/multi_select/url/image 等），通过 getTagPropertyValue(propertyId) /
@@ -240,31 +248,31 @@ export interface RemObject {
    * 底层机制：与 isSlot 完全相同 — 注入同一个"模板插槽" Tag (vD8KGEg5dkj9bzkRn)
    */
   isProperty: boolean;
-  /** [R-F] 是否 Powerup。SDK: isPowerup()（写入用 addPowerup/removePowerup，参数化）。Powerup 系统标识 */
+  /** [R-F] ⊘D2 是否 Powerup。SDK: isPowerup()（写入用 addPowerup/removePowerup，参数化）。Powerup 系统标识 */
   isPowerup: boolean;
-  /** [R-F] 是否 Powerup 枚举。SDK: isPowerupEnum()。Powerup 细分类型 */
+  /** [R-F] ⊘D2 是否 Powerup 枚举。SDK: isPowerupEnum()。Powerup 细分类型 */
   isPowerupEnum: boolean;
-  /** [R-F] 是否 Powerup 属性。SDK: isPowerupProperty()。Powerup 细分类型 */
+  /** [R-F] ⊘D2 是否 Powerup 属性。SDK: isPowerupProperty()。Powerup 细分类型 */
   isPowerupProperty: boolean;
-  /** [R-F] 是否 Powerup 属性列表项。SDK: isPowerupPropertyListItem()。Powerup 细分类型 */
+  /** [R-F] ⊘D2 是否 Powerup 属性列表项。SDK: isPowerupPropertyListItem()。Powerup 细分类型 */
   isPowerupPropertyListItem: boolean;
-  /** [R-F] 是否 Powerup 插槽。SDK: isPowerupSlot()。Powerup 细分类型 */
+  /** [R-F] ⊘D2 是否 Powerup 插槽。SDK: isPowerupSlot()。Powerup 细分类型 */
   isPowerupSlot: boolean;
 
   // ══════════════════════════════════════════════════════════
   //  Portal 专用
   // ══════════════════════════════════════════════════════════
 
-  /** [R] Portal 子类型。仅 type === 'portal' 时有值。SDK: getPortalType() */
+  /** [R] 🛡️D2 Portal 子类型。仅 type === 'portal' 时有值。SDK: getPortalType() */
   portalType: PortalType | null;
-  /** [Portal-W] Portal 直接包含的 Rem ID 数组。SDK: getPortalDirectlyIncludedRem() / addToPortal() / removeFromPortal()。写入时使用 diff 机制。仅 type === 'portal' 时可修改 */
+  /** [Portal-W] 🛡️D2 Portal 直接包含的 Rem ID 数组。SDK: getPortalDirectlyIncludedRem() / addToPortal() / removeFromPortal()。写入时使用 diff 机制。仅 type === 'portal' 时可修改 */
   portalDirectlyIncludedRem: string[];
 
   // ══════════════════════════════════════════════════════════
   //  属性类型（当此 Rem 是 tag/powerup 的属性时）
   // ══════════════════════════════════════════════════════════
 
-  /** [R] 属性数据类型。SDK: getPropertyType() */
+  /** [R] 🛡️D2 属性数据类型。SDK: getPropertyType() */
   propertyType: PropertyTypeValue | null;
 
   // ══════════════════════════════════════════════════════════
@@ -272,14 +280,14 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 是否启用间隔重复练习。SDK: getEnablePractice() / setEnablePractice()
+   * [RW] 🛡️D2 ✅ 是否启用间隔重复练习。SDK: getEnablePractice() / setEnablePractice()
    * UI：无明显变化。功能：为 true 时，RemNote 根据 Rem 的 text/backText 结构
    *     自动生成闪卡并纳入间隔重复调度。setType(CONCEPT) 可能自动置为 true
    * 底层机制：纯字段修改，不涉及 Powerup Tag 注入或隐藏子 Rem
    */
   enablePractice: boolean;
   /**
-   * [RW] ✅ 闪卡练习方向。SDK: getPracticeDirection() / setPracticeDirection()
+   * [RW] 🛡️D2 ✅ 闪卡练习方向。SDK: getPracticeDirection() / setPracticeDirection()
    * UI：无明显变化。功能：控制闪卡生成方向——forward=正面→背面，
    *     backward=背面→正面，both=双向生成，none=不生成闪卡
    * 底层机制：纯字段修改，不涉及 Powerup Tag 注入或隐藏子 Rem
@@ -291,7 +299,7 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 标签 Rem ID 数组。SDK: getTagRems() / addTag() / removeTag()
+   * [RW] 🛡️D2 ✅ 标签 Rem ID 数组。SDK: getTagRems() / addTag() / removeTag()
    * UI 行为：行右侧出现标签徽章（圆角矩形，显示标签名 + × 删除按钮）
    *         setType(CONCEPT) 等操作可能自动添加系统标签
    * 注意：系统 Powerup Tag 会混入此数组（如 setIsCode 注入的"代码" Tag），
@@ -299,12 +307,12 @@ export interface RemObject {
    */
   tags: string[];
   /**
-   * [RW] ✅ 来源 Rem ID 数组。SDK: getSources() / addSource() / removeSource()
+   * [RW] 🛡️D2 ✅ 来源 Rem ID 数组。SDK: getSources() / addSource() / removeSource()
    * UI 行为：Rem 下方出现来源引用子元素（灰色圆角框，显示来源 Rem 名 + ↗ 图标）
    */
   sources: string[];
   /**
-   * [R] 别名 Rem ID 数组。SDK: getAliases()
+   * [R] 🛡️D2 别名 Rem ID 数组。SDK: getAliases()
    * 写入接口 getOrCreateAliasWithText(text) 需要文本参数（非 ID），与 RemObject 的 ID 数组形式不匹配。
    * v1 标记为只读，后续可提供独立命令 `add-alias <remId> <text>`
    */
@@ -314,37 +322,37 @@ export interface RemObject {
   //  关联 — 引用关系（ID 数组）
   // ══════════════════════════════════════════════════════════
 
-  /** [R] 本 Rem 引用的其他 Rem ID 数组。SDK: remsBeingReferenced() */
+  /** [R] 🛡️D2 本 Rem 引用的其他 Rem ID 数组。SDK: remsBeingReferenced() */
   remsBeingReferenced: string[];
-  /** [R-F] 本 Rem 深层引用的 Rem ID 数组。SDK: deepRemsBeingReferenced()。可由 remsBeingReferenced 递归获取 */
+  /** [R-F] ⊘D2 本 Rem 深层引用的 Rem ID 数组。SDK: deepRemsBeingReferenced()。可由 remsBeingReferenced 递归获取 */
   deepRemsBeingReferenced: string[];
-  /** [R] 引用本 Rem 的 Rem ID 数组（反向链接）。SDK: remsReferencingThis() */
+  /** [R] ⊘D2 引用本 Rem 的 Rem ID 数组（反向链接）。SDK: remsReferencingThis() */
   remsReferencingThis: string[];
 
   // ══════════════════════════════════════════════════════════
   //  关联 — 标签体系（ID 数组）
   // ══════════════════════════════════════════════════════════
 
-  /** [R] 被本 Rem 标记的 Rem ID 数组（本 Rem 作为 tag 时）。SDK: taggedRem() */
+  /** [R] ⊘D2 被本 Rem 标记的 Rem ID 数组（本 Rem 作为 tag 时）。SDK: taggedRem() */
   taggedRem: string[];
-  /** [R-F] 祖先标签 Rem ID 数组。SDK: ancestorTagRem()。标签继承链，低频 */
+  /** [R-F] ⊘D2 祖先标签 Rem ID 数组。SDK: ancestorTagRem()。标签继承链，低频 */
   ancestorTagRem: string[];
-  /** [R-F] 后代标签 Rem ID 数组。SDK: descendantTagRem()。标签继承链，低频 */
+  /** [R-F] ⊘D2 后代标签 Rem ID 数组。SDK: descendantTagRem()。标签继承链，低频 */
   descendantTagRem: string[];
 
   // ══════════════════════════════════════════════════════════
   //  关联 — 层级遍历（ID 数组）
   // ══════════════════════════════════════════════════════════
 
-  /** [R] 所有后代 Rem ID 数组。SDK: getDescendants() */
+  /** [R] ⊘D2 所有后代 Rem ID 数组。SDK: getDescendants() */
   descendants: string[];
-  /** [R] 兄弟 Rem ID 数组。SDK: siblingRem() */
+  /** [R] ⊘D2 兄弟 Rem ID 数组。SDK: siblingRem() */
   siblingRem: string[];
-  /** [R-F] 包含的 Portal 和文档 Rem ID 数组。SDK: portalsAndDocumentsIn()。使用场景有限 */
+  /** [R-F] ⊘D2 包含的 Portal 和文档 Rem ID 数组。SDK: portalsAndDocumentsIn()。使用场景有限 */
   portalsAndDocumentsIn: string[];
-  /** [R-F] 文档/Portal 中所有 Rem ID 数组。SDK: allRemInDocumentOrPortal()。可能数据量大 */
+  /** [R-F] ⊘D2 文档/Portal 中所有 Rem ID 数组。SDK: allRemInDocumentOrPortal()。可能数据量大 */
   allRemInDocumentOrPortal: string[];
-  /** [R-F] 文件夹队列中的 Rem ID 数组。SDK: allRemInFolderQueue()。场景有限 */
+  /** [R-F] ⊘D2 文件夹队列中的 Rem ID 数组。SDK: allRemInFolderQueue()。场景有限 */
   allRemInFolderQueue: string[];
 
   // ══════════════════════════════════════════════════════════
@@ -352,36 +360,36 @@ export interface RemObject {
   // ══════════════════════════════════════════════════════════
 
   /**
-   * [RW] ✅ 在兄弟间的位置（0 起始）。SDK: positionAmongstSiblings() / setParent(parent, position)
+   * [RW] ⊘D2 ✅ 在兄弟间的位置（0 起始）。SDK: positionAmongstSiblings() / setParent(parent, position)
    * UI 行为：Rem 在父级子列表中的显示位置改变（测试：A→B→C 变为 B→C→A）
    *         position 超过实际数量会被钳位到末尾；位置相对于父 Rem 的全部 children
    */
   positionAmongstSiblings: number | null;
-  /** [R-F] 搜索中被选次数。SDK: timesSelectedInSearch()。统计数据，低频 */
+  /** [R-F] ⊘D2 搜索中被选次数。SDK: timesSelectedInSearch()。统计数据，低频 */
   timesSelectedInSearch: number;
-  /** [R-F] 上次移动时间（毫秒时间戳）。SDK: getLastTimeMovedTo()。过于细粒度 */
+  /** [R-F] ⊘D2 上次移动时间（毫秒时间戳）。SDK: getLastTimeMovedTo()。过于细粒度 */
   lastTimeMovedTo: number;
-  /** [R-F] Schema 版本号。SDK: getSchemaVersion()。内部版本号 */
+  /** [R-F] ⊘D2 Schema 版本号。SDK: getSchemaVersion()。内部版本号 */
   schemaVersion: number;
 
   // ══════════════════════════════════════════════════════════
   //  队列视图
   // ══════════════════════════════════════════════════════════
 
-  /** [R-F] 嵌入式队列视图模式。SDK: embeddedQueueViewMode()。场景有限 */
+  /** [R-F] ⊘D2 嵌入式队列视图模式。SDK: embeddedQueueViewMode()。场景有限 */
   embeddedQueueViewMode: boolean;
 
   // ══════════════════════════════════════════════════════════
   //  元数据 / 时间戳
   // ══════════════════════════════════════════════════════════
 
-  /** [R] 创建时间（毫秒时间戳）。SDK 直接属性 createdAt */
+  /** [R] ⊘D2 创建时间（毫秒时间戳）。SDK 直接属性 createdAt */
   createdAt: number;
-  /** [R] 最后更新时间（毫秒时间戳）。SDK 直接属性 updatedAt */
+  /** [R] ⊘D2 最后更新时间（毫秒时间戳）。SDK 直接属性 updatedAt */
   updatedAt: number;
-  /** [R-F] 本地最后更新时间（毫秒时间戳）。SDK 直接属性 localUpdatedAt。与 updatedAt 重叠 */
+  /** [R-F] ⊘D2 本地最后更新时间（毫秒时间戳）。SDK 直接属性 localUpdatedAt。与 updatedAt 重叠 */
   localUpdatedAt: number;
-  /** [R-F] 上次练习时间（毫秒时间戳）。SDK: getLastPracticed()。间隔重复内部数据 */
+  /** [R-F] ⊘D2 上次练习时间（毫秒时间戳）。SDK: getLastPracticed()。间隔重复内部数据 */
   lastPracticed: number;
 }
 

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

@@ -196,7 +196,7 @@ Portal 的编辑同步意味着修改一处会影响另一处。Portal 引用的
 
 #### 序列化确定性
 
-RichText 对象内部按 **key 字母序排列**（`sortRichTextKeys()`），确保 JSON 始终一致。`_id` 中的 `_`（U+005F）排在所有小写字母（`a`=U+0061）之前。防线 2（乐观并发检测）依赖此确定性序列化来比较缓存与最新数据。
+RichText 对象内部按 **key 字母序排列**（`sortRichTextKeys()`），确保 JSON 始终一致。`_id` 中的 `_`（U+005F）排在所有小写字母（`a`=U+0061）之前。防线 2（语义并发检测）依赖此确定性序列化来逐字段比较缓存与最新数据。
 
 ### Powerup 机制与噪音过滤
 
@@ -232,12 +232,12 @@ RemNote 格式设置（fontSize、highlightColor 等）底层通过 Powerup 机
 | 场景 | 命令 | 特点 |
 |:-----|:-----|:-----|
 | 知识库有什么 | `read-globe` | 仅 Document 层级，**无缓存**，最小序列化（无 backText/箭头） |
-| 我在编辑什么 | `read-context --mode focus` | 鱼眼视图（焦点 depth=3，siblings depth=1，叔伯 depth=0），**无缓存** |
-| 当前页面内容 | `read-context --mode page` | 均匀展开，**无缓存** |
+| 当前页面内容 | `read-context` | 均匀展开（默认，推荐——只需有打开页面即可），**无缓存** |
+| 我光标在哪 / 正在编辑的 Rem | `read-context --mode focus` | 鱼眼视图（需光标在某 Rem 上，否则报错），**无缓存** |
 | 展开某主题细节 | `read-tree <id>` | 完整子树，**有缓存**供 edit-tree |
 | 展开子树 + 每个节点属性 | `read-rem-in-tree <id>` | 大纲 + RemObject，**双重缓存**供 edit-tree 和 edit-rem |
 
-**重要**：read-globe、read-context、search 都**不写入缓存**，不能替代 read-tree/read-rem/read-rem-in-tree 作为 edit 的前置条件。read-context 需要用户在 RemNote 中有焦点（focus 模式）或打开页面（page 模式）。
+**重要**：read-globe、read-context、search 都**不写入缓存**，不能替代 read-tree/read-rem/read-rem-in-tree 作为 edit 的前置条件。read-context 需要用户在 RemNote 中有打开页面（page 模式，默认）或有焦点（focus 模式）。
 
 ### 修改：用户想改什么？
 
@@ -409,9 +409,14 @@ search 调用 RemNote SDK 官方搜索方法，其分词基于空格分割。**
 
 必须先 read 再 edit。未缓存的 Rem 不允许编辑。
 
-### 防线 2：乐观并发检测
+### 防线 2：语义并发检测（三层字段分类）
 
-edit 时从 SDK 重新读取最新数据，与缓存严格比较。被外部修改则拒绝编辑且**不更新缓存**——迫使 Agent 重新 read。
+edit 时从 SDK 重新读取最新数据，逐字段与缓存比较并按三层分类处理：
+- **语义字段**（text/type/tags/highlightColor 等）变化 → **硬拒绝**，不更新缓存，迫使 Agent 重新 read
+- **敏感元数据**（parent）变化 → **放行** + warnings 返回 `"⚠️ parent has changed (was: X, now: Y)..."`，静默刷新缓存
+- **普通元数据**（positionAmongstSiblings/updatedAt/siblingRem 等）变化 → **放行** + warnings 返回 `"ℹ️ Metadata fields changed since last read: ..."`，静默刷新缓存
+
+这意味着 edit-tree 移动/重排 Rem 后，可直接 edit-rem 修改受影响节点，无需重新 read。
 
 ### 防线 3：str_replace 精确匹配（仅 edit-tree）
 
@@ -424,7 +429,9 @@ edit-rem 使用字段直接修改（changes 对象），不经过 str_replace，
 | 场景 | 缓存行为 | Agent 操作 |
 |:-----|:---------|:-----------|
 | 写入成功 | 从 SDK 重新读取 → 更新缓存 | 可继续编辑 |
-| 防线 2 拒绝 / 部分写入失败 | **不更新缓存** | 必须重新 read |
+| 仅元数据变化（位置/时间戳等） | 静默刷新缓存并放行 | 可继续编辑（返回 warnings） |
+| 语义字段冲突（text/type 等） | **不更新缓存** | 必须重新 read |
+| 部分写入失败 | **不更新缓存** | 必须重新 read |
 | 枚举值非法（edit-rem） | 缓存保持不变 | 检查允许的值范围后重试 |
 | 防线 3 拒绝 / JSON 语法错误（edit-tree） | 缓存保持不变 | 调整 oldStr/newStr 后**直接重试** |
 | 操作执行中异常（edit-tree） | 已执行的操作保留（**无回滚**），不更新缓存 | 必须重新 read-tree |
@@ -451,6 +458,8 @@ read-tree / read-globe / read-context 输出 Markdown 大纲，edit-tree 基于
 |:-----|:-----|
 | `# ` / `## ` / `### ` | H1/H2/H3 标题 |
 | `- [ ] ` / `- [x] ` | 未完成/已完成待办 |
+| `> ` | 引用块 |
+| `1. ` | 有序列表项 |
 | `` `...` `` | 代码块 |
 | `---` | 分隔线 |
 
@@ -521,6 +530,8 @@ read-tree / read-globe / read-context 输出 Markdown 大纲，edit-tree 基于
   新闪卡 → 答案
   问题 ↔ 回答
   - [ ] 新待办
+  > 引用内容
+  1. 列表项
   `代码块`
 ```
 
@@ -650,7 +661,7 @@ aliases, descendants, siblingRem, isTable, portalType, propertyType
 | 守护进程未运行 | 未 connect 或已超时 | `connect` |
 | Plugin 未连接 | RemNote 未打开 | 打开 RemNote（health 三层：daemon→Plugin→SDK 链式依赖） |
 | has not been read yet | 未先 read | 执行对应 read 命令（search 结果不算 read！） |
-| has been modified since last read | 被外部修改 | 重新 read（必须，不可直接重试） |
+| has been modified since last read | 语义字段被外部修改（元数据变化不触发此错误，只返回 warnings） | 重新 read（必须，不可直接重试） |
 | Invalid value for 'field' | 枚举字段值不合法（edit-rem） | 检查该字段允许的值范围 |
 | old_str not found | oldStr 不精确（edit-tree） | 检查引号、空格、换行 |
 | old_str matches N locations | oldStr 不够具体（edit-tree） | 扩大 oldStr 范围，包含更多上下文 |

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

@@ -225,28 +225,55 @@ if cache.get('rem:' + remId) === null:
 
 **恢复方式**：执行 `read-rem <remId>` 后重试。
 
-### 防线 2：乐观并发检测
+### 防线 2：语义并发检测（三层字段分类）
 
 **目的**：检测自上次 read 以来，Rem 是否被外部修改（如用户在 RemNote UI 中编辑、其他 Agent 修改等）。
 
+**核心机制**：将 RemObject 所有字段逐个比较，按差异字段所属层级决定处理方式：
+
 ```
 currentRemObject = forwardToPlugin('read_rem', { remId })
-currentJson = JSON.stringify(currentRemObject, null, 2)
-cachedJson = JSON.stringify(cachedObj, null, 2)
+{ semantic, warned, ignored } = classifyDiff(cachedObj, currentRemObject)
+
+if semantic.length > 0:
+    // 第1层：语义字段冲突 → 硬拒绝，不更新缓存
+    throw "Rem {remId} has been modified since last read."
+
+if warned.length > 0:
+    // 第2层：parent 变化 → 放行 + 专门警告
+    warnings.push("⚠️ parent has changed (was: {old}, now: {new}). ...")
 
-if currentJson !== cachedJson:
-    // 不更新缓存 — 迫使 AI 重新 read 获取最新状态
-    throw "Rem {remId} has been modified since last read. Please read it again before editing."
+if ignored.length > 0:
+    // 第3层：普通元数据变化 → 放行 + 统一警告
+    warnings.push("ℹ️ Metadata fields changed since last read: {fields}. ...")
+
+if warned.length > 0 || ignored.length > 0:
+    // 静默刷新缓存（保持新鲜度）
+    cache.set('rem:' + remId, currentRemObject)
 ```
 
-**关键设计**：
-- 比较方式：**将当前 RemObject 和缓存 RemObject 分别 JSON.stringify 后做文本比较**
-- 失败时**不更新缓存**：防止 AI 跳过 re-read 直接重试
-- RichText key 排序保证序列化确定性（`sortRichTextKeys()`）
+**三层字段分类**：
+
+| 层级 | 包含字段 | 变化时行为 |
+|:-----|:---------|:----------|
+| 第1层：语义字段 | text, backText, type, tags, highlightColor, fontSize 等（不在下面两层的所有字段） | **硬拒绝**，不更新缓存 |
+| 第2层：敏感元数据 | parent | **放行** + `⚠️ parent has changed (was: X, now: Y)...` 警告 + 刷新缓存 |
+| 第3层：普通元数据 | positionAmongstSiblings, updatedAt, siblingRem, children, descendants 等 23 个字段 | **放行** + `ℹ️ Metadata fields changed since last read: ...` 警告 + 刷新缓存 |
 
-**恢复方式**：执行 `read-rem <remId>` 获取最新状态后重试。
+**设计意义**：`edit_tree` 移动/重排 Rem 后，可以直接 `edit_rem` 修改受影响节点的文本格式，无需逐个重新 `read_rem`。只有真正的内容/属性并发冲突才会被拦截。
 
-### 两道防线判断树
+**warnings 输出示例**：
+
+| 场景 | warnings |
+|:-----|:---------|
+| 无外部变化 | `[]` |
+| edit_tree 重排后 | `["ℹ️ Metadata fields changed since last read: positionAmongstSiblings. This is expected after structural operations. Proceeding with edit."]` |
+| edit_tree 移动后 | `["⚠️ parent has changed (was: oldId, now: newId). The Rem has been moved to a different parent since last read. Proceeding with edit.", "ℹ️ Metadata fields changed since last read: siblingRem, positionAmongstSiblings, updatedAt. ..."]` |
+| 语义字段被外部修改 | 不返回（抛异常 `"has been modified since last read"`） |
+
+**恢复方式**（仅语义冲突需要）：执行 `read-rem <remId>` 获取最新状态后重试。
+
+### 防线判断树
 
 ```
 edit-rem(remId, changes)
@@ -255,9 +282,11 @@ edit-rem(remId, changes)
 │   ├─ 否 → ERROR: "has not been read yet"
 │   └─ 是 → 继续
 │
-├─ 防线 2: 当前值 === 缓存值？
-│   ├─ 否 → ERROR: "has been modified since last read"
-│   └─ 是 → 继续
+├─ 防线 2: 三层字段分类比较
+│   ├─ 语义字段变化 → ERROR: "has been modified since last read"
+│   ├─ 仅 parent 变化 → 放行（warnings += ⚠️ parent 警告，刷新缓存）
+│   ├─ 仅元数据变化 → 放行（warnings += ℹ️ 元数据警告，刷新缓存）
+│   └─ 无变化 → 继续
 │
 ├─ 字段分类
 │   ├─ 只读字段 → 警告

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. ` 及以上不会被识别为有序列表，而是作为纯文本保留。
 
 #### 新增行的箭头分隔符