remnote-bridge 0.1.13 → 0.1.14

package/remnote-plugin/src/bridge/message-router.ts

@@ -11,6 +11,7 @@ import type { ReactRNPlugin } from '@remnote/plugin-sdk';
 import type { BridgeRequest } from './websocket-client';
 import { readRem } from '../services/read-rem';
 import { readTree } from '../services/read-tree';
+import { readRemInTree } from '../services/read-rem-in-tree';
 import { readGlobe } from '../services/read-globe';
 import { readContext } from '../services/read-context';
 import { writeRemFields } from '../services/write-rem-fields';
@@ -36,6 +37,8 @@ export function createMessageRouter(plugin: ReactRNPlugin): (request: BridgeRequ
         return readRem(plugin, request.payload as { remId: string; includePowerup?: boolean });
       case 'read_tree':
         return readTree(plugin, request.payload as { remId: string; depth?: number; maxNodes?: number; maxSiblings?: number; ancestorLevels?: number; includePowerup?: boolean });
+      case 'read_rem_in_tree':
+        return readRemInTree(plugin, request.payload as { remId: string; depth?: number; maxNodes?: number; maxSiblings?: number; ancestorLevels?: number; includePowerup?: boolean });
       case 'write_rem_fields':
         return writeRemFields(plugin, request.payload as { remId: string; changes: Record<string, unknown> });
       case 'create_rem':

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

@@ -0,0 +1,43 @@
+/**
+ * read-rem-in-tree service — read_tree + 对每个节点 buildRemObject
+ *
+ * 同态命名：read_rem_in_tree (action) → read-rem-in-tree.ts (文件) → readRemInTree (函数)
+ */
+
+import type { ReactRNPlugin } from '@remnote/plugin-sdk';
+import type { RemObject } from '../types';
+import { readTree, type ReadTreePayload, type ReadTreeResult } from './read-tree';
+import { buildRemObject } from './read-rem';
+
+export interface ReadRemInTreePayload extends ReadTreePayload {}
+
+export interface ReadRemInTreeResult extends ReadTreeResult {
+  /** remId → RemObject 的扁平映射 */
+  remObjects: Record<string, RemObject & { powerupFiltered?: { tags: number; children: number } }>;
+}
+
+/**
+ * 读取 Rem 子树大纲 + 对树中每个节点构建完整 RemObject。
+ *
+ * @throws Error — Rem 不存在、节点数超限
+ */
+export async function readRemInTree(
+  plugin: ReactRNPlugin,
+  payload: ReadRemInTreePayload,
+): Promise<ReadRemInTreeResult> {
+  // 1. 获取 outline + nodeRemIds（复用 readTree）
+  const treeResult = await readTree(plugin, payload);
+
+  // 2. 用 readTree 遍历时收集的 nodeRemIds，直接并行 buildRemObject
+  const includePowerup = payload.includePowerup ?? false;
+  const remObjects: ReadRemInTreeResult['remObjects'] = {};
+
+  await Promise.all(treeResult.nodeRemIds.map(async (id) => {
+    const rem = await plugin.rem.findOne(id);
+    if (rem) {
+      remObjects[id] = await buildRemObject(plugin, rem, { includePowerup });
+    }
+  }));
+
+  return { ...treeResult, remObjects };
+}

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

@@ -33,6 +33,21 @@ export async function readRem(
     throw new Error(`Rem not found: ${payload.remId}`);
   }
 
+  return buildRemObject(plugin, rem, { includePowerup });
+}
+
+/**
+ * 从已有 Rem 对象组装完整 RemObject（跳过 findOne）。
+ *
+ * 供 readRem 和 readRemInTree 共享。
+ */
+export async function buildRemObject(
+  plugin: ReactRNPlugin,
+  rem: Rem,
+  options: { includePowerup?: boolean },
+): Promise<RemObject & { powerupFiltered?: { tags: number; children: number } }> {
+  const { includePowerup = false } = options;
+
   // 并行获取所有异步字段
   const [
     isDocument,

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

@@ -43,6 +43,8 @@ export interface ReadTreeResult {
   depth: number;
   nodeCount: number;
   outline: string;
+  /** 树中所有节点的 remId 列表（遍历顺序） */
+  nodeRemIds: string[];
   /** 祖先链（从直接父亲到最远祖先，由近及远） */
   ancestors?: AncestorInfo[];
   powerupFiltered?: { tags: number; children: number };
@@ -75,6 +77,7 @@ export async function readTree(
   let totalFilteredTags = 0;
   let totalFilteredChildren = 0;
   const budget = { remaining: maxNodes };
+  const nodeRemIds: string[] = [];
 
   /**
    * 递归构建 OutlineNode 树。
@@ -86,6 +89,7 @@ export async function readTree(
   async function buildNode(rem: Rem, currentDepth: number, maxDepth: number): Promise<OutlineNode> {
     nodeCount++;
     budget.remaining--;
+    nodeRemIds.push(rem._id);
 
     const allChildren = await rem.getChildrenRem();
     const children = includePowerup ? allChildren : await filterNoisyChildren(allChildren);
@@ -179,6 +183,7 @@ export async function readTree(
     depth,
     nodeCount,
     outline,
+    nodeRemIds,
   };
 
   // 祖先链构建

package/skills/remnote-bridge/SKILL.md

@@ -18,6 +18,7 @@ description: "RemNote 知识库操作指南。通过 remnote-bridge 命令行工
 | read-rem | `instructions/read-rem.md` |
 | edit-rem | `instructions/edit-rem.md` |
 | read-tree | `instructions/read-tree.md` |
+| read-rem-in-tree | `instructions/read-rem-in-tree.md` |
 | edit-tree | `instructions/edit-tree.md` |
 | read-globe | `instructions/read-globe.md` |
 | read-context | `instructions/read-context.md` |
@@ -222,6 +223,7 @@ RemNote 格式设置（fontSize、highlightColor 等）底层通过 Powerup 机
 用户当前在看什么（"当前页面"）        → read-context
 某个 Rem 的子树（"展开这个主题"）     → read-tree <remId>
 某个 Rem 的详细属性（"详细信息"）     → read-rem <remId>
+子树 + 每个节点属性（"批量标注"）     → read-rem-in-tree <remId>
 按关键词搜索（"搜索 X"）            → search <query>（中文搜索有限制，见下方说明）
 ```
 
@@ -233,8 +235,9 @@ RemNote 格式设置（fontSize、highlightColor 等）底层通过 Powerup 机
 | 我在编辑什么 | `read-context --mode focus` | 鱼眼视图（焦点 depth=3，siblings depth=1，叔伯 depth=0），**无缓存** |
 | 当前页面内容 | `read-context --mode page` | 均匀展开，**无缓存** |
 | 展开某主题细节 | `read-tree <id>` | 完整子树，**有缓存**供 edit-tree |
+| 展开子树 + 每个节点属性 | `read-rem-in-tree <id>` | 大纲 + RemObject，**双重缓存**供 edit-tree 和 edit-rem |
 
-**重要**：read-globe、read-context、search 都**不写入缓存**，不能替代 read-tree/read-rem 作为 edit 的前置条件。read-context 需要用户在 RemNote 中有焦点（focus 模式）或打开页面（page 模式）。
+**重要**：read-globe、read-context、search 都**不写入缓存**，不能替代 read-tree/read-rem/read-rem-in-tree 作为 edit 的前置条件。read-context 需要用户在 RemNote 中有焦点（focus 模式）或打开页面（page 模式）。
 
 ### 修改：用户想改什么？
 
@@ -246,6 +249,36 @@ Rem 的属性（文本、类型、格式、标签）  → edit-rem   （前置
 
 **关键区分**：`edit-rem` 修改 Rem 的**属性**，`edit-tree` 修改 Rem 之间的**结构关系**。`edit-tree` **禁止修改行内容**。
 
+### read-rem-in-tree：何时用、怎么用
+
+`read-rem-in-tree` = `read-tree` + 批量 `read-rem` 的合体。一次调用同时获取子树大纲和每个节点的 RemObject（含完整 RichText），同时建立 `tree:` 和 `rem:` 双重缓存。
+
+**何时用**：当你需要对一棵子树中的**多个节点**做属性修改（edit-rem）时。典型场景：
+
+- 批量标注重点（给多个节点加高亮/粗体）
+- 批量修改类型（把多个普通 Rem 改为 concept）
+- 读取子树后需要检查多个节点的 RichText 再决定怎么改
+
+**何时不用**：只需要看大纲结构（用 `read-tree`），或只改 1-2 个节点属性（用 `read-tree` + `read-rem`）。
+
+**用法示例**（课本划重点场景）：
+
+```bash
+# 1. 一次获取大纲 + 所有节点属性（默认 maxNodes=50）
+read-rem-in-tree --json '{"remId":"kLr...","depth":3,"maxNodes":30}'
+
+# 返回：outline（大纲文本）+ remObjects（每个节点的 RemObject）
+
+# 2. 从 remObjects 中找到要标注的节点，直接 edit-rem（rem 缓存已就绪）
+edit-rem --json '{"remId":"ABC","changes":{"highlightColor":"Yellow"}}'
+edit-rem --json '{"remId":"DEF","changes":{"text":["关键词",{"b":true,"h":1,"i":"m","text":"重点"}]}}'
+
+# 3. 如需结构变更，直接 edit-tree（tree 缓存已就绪）
+edit-tree --json '{"remId":"kLr...","oldStr":"...","newStr":"..."}'
+```
+
+**对比效率**：修改 10 个节点时，`read-rem-in-tree` = 1 次调用；`read-tree` + 10×`read-rem` = 11 次调用。
+
 ---
 
 ## 3. 标准工作流
@@ -315,9 +348,9 @@ setup 只需执行一次。之后每次连接直接用 `connect --headless`。
 4. read-globe           -- 了解知识库结构（首次探索）
    或 read-context      -- 了解用户当前上下文
 5. search "关键词"       -- 定位目标 Rem（结果不进缓存！）
-6. read-tree <id>       -- 展开子树 → 写入缓存（edit-tree 的前置）
-7. read-rem <id>        -- 读取属性 → 写入缓存（edit-rem 的前置）
-8. edit-rem / edit-tree -- 执行修改
+6a. [单节点] read-tree <id> + read-rem <id>  -- 各自建立缓存
+6b. [多节点] read-rem-in-tree <id>           -- 一次建立双重缓存（推荐 ≥3 个节点需修改时）
+7. edit-rem / edit-tree -- 执行修改
 9. disconnect           -- 结束会话（缓存全部清空，幂等）
 ```
 

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

@@ -43,7 +43,9 @@ remnote-bridge --json connect --instance work
 | 2 | 29120 | 29121 | 29122 |
 | 3 | 29130 | 29131 | 29132 |
 
-**实例名解析优先级**：CLI `--instance` 参数 > 环境变量 `REMNOTE_BRIDGE_INSTANCE` > 默认值 `default`。Headless 模式下固定为 `headless`。
+**实例名解析优先级**：CLI `--instance` 参数 > 环境变量 `REMNOTE_BRIDGE_INSTANCE` > 默认值 `default`。
+
+**⚠️ `headless` 是保留实例名**：`--instance headless` 会直接报错。headless 模式必须使用专用的 `--headless` 全局选项（见下方 Headless 模式章节）。
 
 **首次使用多实例时**，用户需在 RemNote 中为每个实例分别配置 dev plugin URL（对应各自的 Plugin 服务端口）。
 
@@ -74,6 +76,15 @@ remnote-bridge --json connect --headless
 
 Headless 模式下 Plugin 可能需要 10-30 秒才能连接到 daemon，使用 `health` 确认就绪。
 
+`--headless` 是全局选项，headless 会话中**所有命令都需要带上**：
+
+```bash
+remnote-bridge --headless connect    # 启动
+remnote-bridge --headless health     # 检查
+remnote-bridge --headless read-rem --json '{"remId":"..."}'  # 业务命令
+remnote-bridge --headless disconnect # 结束
+```
+
 排查工具：`health --diagnose`（截图+状态+console 错误）、`health --reload`（重载 Chrome 页面）。
 
 ---

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

@@ -18,12 +18,17 @@
 
 通过 `--instance <name>` 指定要停止的实例。不指定时停止 `default` 实例。
 
+`--headless` 是全局选项，用于停止 headless 模式启动的实例。
+
 ```bash
 # 停止默认实例
 remnote-bridge disconnect
 
 # 停止指定实例
 remnote-bridge disconnect --instance work
+
+# 停止 headless 实例
+remnote-bridge --headless disconnect
 ```
 
 ---

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

@@ -174,6 +174,66 @@ oldStr 必须在缓存大纲中恰好匹配 1 次
 
 ---
 
+## 行引用模板 `{{remId}}`
+
+在 oldStr/newStr 中使用 `{{remId}}` 引用缓存大纲中已有行的完整内容（不含缩进）。系统在 str_replace 前自动展开。不含 `{{}}` 的传统写法完全兼容。
+
+### 动机
+
+AI 构造 oldStr/newStr 时需精确复制已有行（含 17+ 字符 Rem ID 和元数据标记），导致 token 浪费和复制错误。`{{remId}}` 让 AI 只写 ID，系统自动替换为完整行内容。
+
+### 展开规则
+
+| 输入 | 展开为 |
+|------|--------|
+| `{{remId}}` | 该 remId 对应行的去缩进完整内容（含 `<!--remId 元数据-->`） |
+| `    {{remId}}` | AI 写的缩进 + 展开后的完整内容 |
+| 不含 `{{}}` 的文本 | 原样不变 |
+
+### 示例
+
+**重排（对比传统写法）**
+
+```
+# 传统写法（~250 tokens）
+oldStr: "    动态数组 <!--id1_1 type:concept-->\n    静态数组 <!--id1_2 type:concept-->"
+newStr: "    静态数组 <!--id1_2 type:concept-->\n    动态数组 <!--id1_1 type:concept-->"
+
+# 模板写法（~50 tokens）
+oldStr: "    {{id1_1}}\n    {{id1_2}}"
+newStr: "    {{id1_2}}\n    {{id1_1}}"
+```
+
+**移动（改变缩进）**
+
+```
+oldStr: "  {{idA}}\n    {{idT}}\n  {{idB}}"
+newStr: "  {{idA}}\n  {{idB}}\n    {{idT}}"
+```
+
+**删除（模板用于上下文定位）**
+
+```
+oldStr: "    {{idA}}\n    {{idA1}}\n    {{idB}}"
+newStr: "    {{idB}}"
+```
+
+**新增 + 模板混用**
+
+```
+oldStr: "  {{idZ}}"
+newStr: "  新增行\n  {{idZ}}"
+```
+
+### 限制
+
+- 只匹配纯字母数字（`[a-zA-Z0-9]+`），与 RemNote cloze 语法 `{{text}}` 不冲突（cloze 含中文/空格/标点不会被匹配）
+- 匹配到但不在缓存大纲中的 `{{xxx}}` 原样保留（可能是 cloze），并输出 templateWarnings
+- `{{remId}}` 不含缩进，缩进由 AI 控制（move 操作会改变缩进）
+- 新增行没有 remId，不能用模板表示
+
+---
+
 ## 支持的操作
 
 ### 新增行
@@ -458,8 +518,9 @@ RemNote SDK 存在已知 bug：
 4. daemon TreeEditHandler:
    ├─ 防线 1: cache.get('tree:' + remId) 存在？
    ├─ 防线 2: 用缓存的 depth/maxNodes/maxSiblings 重新 read-tree → 对比
-   ├─ 防线 3: countOccurrences(cachedOutline, oldStr) === 1？
-   ├─ modifiedOutline = cachedOutline.replace(oldStr, newStr)
+   ├─ 模板展开: {{remId}} → 缓存中对应行的完整内容（不含缩进）
+   ├─ 防线 3: countOccurrences(cachedOutline, expandedOldStr) === 1？
+   ├─ modifiedOutline = cachedOutline.replace(expandedOldStr, expandedNewStr)
    ├─ 解析新旧大纲为树（parseOutline）
    ├─ 对比差异（diffTrees）
    │   ├─ 根节点校验
@@ -499,11 +560,19 @@ remnote-bridge edit-tree kLr --old-str '    叶子节点 <!--leaf-->\n' --new-st
 ### 调换两个兄弟的顺序
 
 ```bash
+# 传统写法
 remnote-bridge edit-tree kLr --old-str '  节点 A <!--idA-->\n  节点 B <!--idB-->' --new-str '  节点 B <!--idB-->\n  节点 A <!--idA-->'
+
+# 模板写法（JSON 模式）
+remnote-bridge edit-tree --json '{"remId":"kLr","oldStr":"  {{idA}}\n  {{idB}}","newStr":"  {{idB}}\n  {{idA}}"}'
 ```
 
 ### 将节点移到另一个父节点下
 
 ```bash
+# 传统写法
 remnote-bridge edit-tree kLr --old-str '  旧父 <!--oldP-->\n    目标 <!--target-->\n  新父 <!--newP-->' --new-str '  旧父 <!--oldP-->\n  新父 <!--newP-->\n    目标 <!--target-->'
+
+# 模板写法（JSON 模式）
+remnote-bridge edit-tree --json '{"remId":"kLr","oldStr":"  {{oldP}}\n    {{target}}\n  {{newP}}","newStr":"  {{oldP}}\n  {{newP}}\n    {{target}}"}'
 ```

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

@@ -6,65 +6,64 @@
 
 ## 功能
 
-`health` 分两步检查指定实例的系统状态：
+`health` 检查系统状态，支持两种模式：
 
+1. **全量模式**（默认）：遍历注册表所有活跃实例，逐个查询三层状态
+2. **单实例模式**（`--instance` / `--headless`）：只查询指定实例
+
+每个实例的检查分两步：
 1. **本地检查**：通过注册表查找实例，确认 daemon 进程是否存活
 2. **远程检查**：通过 WS 连接 daemon，获取 Plugin 连接状态和 SDK 就绪状态
 
-### 多实例支持
+### 孪生连接
 
-通过 `--instance <name>` 指定要检查的实例。不指定时检查 `default` 实例。
-
-```bash
-remnote-bridge health --instance work
-```
+每个实例的 Plugin 连接会标记是否为**孪生连接**（`plugin.isTwin`）。孪生连接表示 Plugin 的 `twinSlotIndex` 与 daemon 的槽位索引匹配，优先级更高——孪生连接可以抢占非孪生连接。
 
 ---
 
 ## 用法
 
-### 人类模式
+### 全量模式（默认）
 
 ```bash
 remnote-bridge health
 ```
 
-输出示例（全部健康）：
+输出所有活跃实例的状态：
 
 ```
-✅ 守护进程  运行中（PID: 12345，实例: default，槽位: 0，已运行 5 分钟）
-✅ Plugin    已连接
+=== 实例: default（槽位 0）===
+✅ 守护进程  运行中（PID: 12345，已运行 5 分钟）
+✅ Plugin    已连接（孪生）
 ✅ SDK       就绪
-
 超时: 25 分钟后自动关闭
-```
-
-输出示例（部分不健康）：
-
-```
-✅ 守护进程  运行中（PID: 12345，实例: work，槽位: 1，已运行 2 分钟）
-❌ Plugin    未连接
-❌ SDK       未就绪
 
+=== 实例: headless（槽位 1）===
+✅ 守护进程  运行中（PID: 12346，已运行 2 分钟）
+✅ Plugin    已连接（非孪生）
+✅ SDK       就绪
+✅ Chrome     running
 超时: 28 分钟后自动关闭
 ```
 
-输出示例（daemon 未运行）：
+无活跃实例时：
 
 ```
-❌ 守护进程  未运行
-❌ Plugin    未连接
-❌ SDK       不可用
-
-提示: 执行 `remnote-bridge connect` 启动守护进程
+没有活跃的实例。执行 `remnote-bridge connect` 启动守护进程。
 ```
 
-### JSON 模式
+### 单实例模式
 
 ```bash
-remnote-bridge --json health
+# 指定实例
+remnote-bridge --instance work health
+
+# 检查 headless 实例
+remnote-bridge --headless health
 ```
 
+输出格式与之前相同，但只显示一个实例。
+
 ### Headless 诊断模式
 
 ```bash
@@ -81,7 +80,43 @@ remnote-bridge health --reload
 
 ## JSON 输出
 
-### 全部健康
+### 全量模式
+
+```json
+{
+  "ok": true,
+  "command": "health",
+  "exitCode": 0,
+  "instances": [
+    {
+      "instance": "default",
+      "slotIndex": 0,
+      "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 300 },
+      "plugin": { "connected": true, "isTwin": true },
+      "sdk": { "ready": true },
+      "timeoutRemaining": 1500
+    },
+    {
+      "instance": "headless",
+      "slotIndex": 1,
+      "daemon": { "running": true, "pid": 12346, "reachable": true, "uptime": 120 },
+      "plugin": { "connected": true, "isTwin": true },
+      "sdk": { "ready": true },
+      "timeoutRemaining": 1680,
+      "headless": {
+        "status": "running",
+        "chromeConnected": true,
+        "pageUrl": "http://localhost:29111",
+        "reloadCount": 0,
+        "lastError": null,
+        "recentConsoleErrors": []
+      }
+    }
+  ]
+}
+```
+
+### 单实例模式 — 全部健康
 
 ```json
 {
@@ -91,39 +126,36 @@ remnote-bridge health --reload
   "instance": "default",
   "slotIndex": 0,
   "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 300 },
-  "plugin": { "connected": true },
+  "plugin": { "connected": true, "isTwin": true },
   "sdk": { "ready": true },
   "timeoutRemaining": 1500
 }
 ```
 
-### Plugin 未连接
+### 单实例模式 — daemon 未运行
 
 ```json
 {
   "ok": false,
   "command": "health",
-  "exitCode": 1,
-  "instance": "work",
-  "slotIndex": 1,
-  "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 120 },
+  "exitCode": 2,
+  "instance": "default",
+  "daemon": { "running": false },
   "plugin": { "connected": false },
   "sdk": { "ready": false },
-  "timeoutRemaining": 1680
+  "error": "守护进程未运行（实例: default），请先执行 remnote-bridge connect"
 }
 ```
 
-### daemon 未运行
+### 全量模式 — 无活跃实例
 
 ```json
 {
   "ok": false,
   "command": "health",
   "exitCode": 2,
-  "instance": "default",
-  "daemon": { "running": false },
-  "plugin": { "connected": false },
-  "sdk": { "ready": false }
+  "instances": [],
+  "error": "没有活跃的实例，请执行 remnote-bridge connect 启动守护进程"
 }
 ```
 
@@ -135,6 +167,7 @@ remnote-bridge health --reload
 |--------|----------|------|
 | **daemon** | 注册表查找 + `kill(pid, 0)` 探活 | 守护进程是否在运行且可达 |
 | **plugin** | daemon 内部的 `pluginConnected` 状态 | RemNote Plugin 是否已通过 WS 连接到 daemon |
+| **plugin.isTwin** | Plugin hello 握手中的 `twinSlotIndex` | 是否为孪生连接（匹配 daemon 槽位索引） |
 | **sdk** | Plugin 的 hello 握手中的 `sdkReady` 字段 | RemNote SDK 是否就绪（知识库已加载，可调用 API） |
 
 ### 三层关系
@@ -151,9 +184,9 @@ daemon 运行 → Plugin 连接 → SDK 就绪
 
 | 退出码 | 含义 | 触发条件 |
 |--------|------|----------|
-| 0 | 全部健康 | daemon 运行 + Plugin 已连接 + SDK 就绪 |
+| 0 | 全部健康 | 所有实例三层均通过 |
 | 1 | 部分不健康 | daemon 运行但 Plugin 未连接或 SDK 未就绪 |
-| 2 | 不可达 | daemon 未运行，或运行但 WS 连接失败 |
+| 2 | 不可达 | 无活跃实例，或 daemon 不可达 |
 
 ---
 
@@ -161,11 +194,13 @@ daemon 运行 → Plugin 连接 → SDK 就绪
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
+| `instances` | array | 全量模式下所有实例的状态数组 |
 | `daemon.running` | boolean | 进程是否存活 |
 | `daemon.pid` | number | 进程 ID（仅运行时） |
 | `daemon.reachable` | boolean | WS 连接是否成功（仅运行时） |
 | `daemon.uptime` | number | 运行秒数（仅可达时） |
 | `plugin.connected` | boolean | Plugin WS 连接是否建立 |
+| `plugin.isTwin` | boolean | 是否为孪生连接 |
 | `sdk.ready` | boolean | RemNote SDK 是否就绪 |
 | `timeoutRemaining` | number | 距自动关闭的剩余秒数（仅可达时） |
 
@@ -173,19 +208,12 @@ daemon 运行 → Plugin 连接 → SDK 就绪
 
 ## Headless 模式附加输出
 
-### health 基础输出（headless 模式下额外字段）
+### health 基础输出（headless 实例额外字段）
 
-headless 模式下 `health` 基础输出额外包含 `headless` 对象：
+headless 实例额外包含 `headless` 对象：
 
 ```json
 {
-  "ok": true,
-  "command": "health",
-  "exitCode": 0,
-  "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 300 },
-  "plugin": { "connected": true },
-  "sdk": { "ready": true },
-  "timeoutRemaining": 1500,
   "headless": {
     "status": "running",
     "chromeConnected": true,
@@ -227,7 +255,7 @@ headless 模式下 `health` 基础输出额外包含 `headless` 对象：
 
 | 症状 | 可能原因 | 解决方案 |
 |------|----------|----------|
-| daemon 未运行 | 未执行 connect / 已超时关闭 | 执行 `connect` |
+| 无活跃实例 | 未执行 connect / 已超时关闭 | 执行 `connect` |
 | daemon 运行但不可达 | WS 端口被占用或配置不匹配 | 检查 `~/.remnote-bridge/slots.json` 中的端口配置 |
 | Plugin 未连接（标准模式） | RemNote 未打开 / Plugin 未安装 / URL 不匹配 | 打开 RemNote，确认 Plugin 中的 WS URL 设置 |
 | Plugin 未连接（headless 模式） | Chrome 页面加载异常 | `health --diagnose` 查看截图和状态，`health --reload` 重载页面 |