remnote-bridge 0.1.10 → 0.1.12

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

@@ -130,7 +130,7 @@ Rem 有两个**独立维度**的类型：
 | 删除 Portal | `edit-tree` | 从大纲中移除 Portal 行（与删除普通行相同） |
 | 修改引用列表（增删引用的 Rem） | `edit-rem` | str_replace 简化 JSON 中的 `portalDirectlyIncludedRem` 数组 |
 | 移动 Portal（换父节点/位置） | `edit-tree` | 与移动普通行相同 |
-| 读取 Portal | `read-rem` | 自动输出 9 字段简化 JSON |
+| 读取 Portal | `read-rem` | 自动输出 8 字段简化 JSON |
 
 ### 2.6 Powerup 机制简述
 
@@ -199,19 +199,53 @@ health → 确认三层就绪 → 会话可用
 disconnect → daemon 关闭 → 会话结束，缓存清空
 ```
 
-> **重要**：`connect` 成功只意味着 daemon 已启动，Plugin 并未自动连接。首次使用需用户在 RemNote「开发你的插件」中填入 `http://localhost:8080`；非首次只需刷新 RemNote 页面。必须引导用户完成此步后再用 `health` 确认就绪。
+> **重要**：`connect` 成功只意味着 daemon 已启动，Plugin 并未自动连接。首次使用需用户在 RemNote「开发你的插件」中填入对应的 Plugin 服务地址；非首次只需刷新 RemNote 页面。必须引导用户完成此步后再用 `health` 确认就绪。
 
-`connect` 启动三个服务：
+`connect` 启动三个服务，端口由槽位自动分配：
 
-| 服务 | 默认端口 | 用途 |
-|:-----|:---------|:-----|
-| WS Server | 3002 | CLI ↔ daemon ↔ Plugin 通信 |
-| Plugin 服务 | 8080 | 加载 Plugin 到 RemNote（默认静态服务器，`--dev` 时为 webpack-dev-server） |
-| ConfigServer | 3003 | HTTP 配置界面 |
+| 服务 | 槽位 0 端口 | 用途 |
+|:-----|:-----------|:-----|
+| WS Server | 29100 | CLI ↔ daemon ↔ Plugin 通信 |
+| Plugin 服务 | 29101 | 加载 Plugin 到 RemNote（默认静态服务器，`--dev` 时为 webpack-dev-server） |
+| ConfigServer | 29102 | HTTP 配置界面 |
 
 超时机制：daemon 默认 **30 分钟无活动**自动关闭。每次收到 CLI 请求时重置计时器。
 
-### 3.3 健康状态
+### 3.3 多实例支持
+
+系统支持最多 **4 个并发实例**，每个实例连接不同的 RemNote 知识库。
+
+```bash
+# 启动默认实例
+remnote-bridge connect
+
+# 启动额外实例
+remnote-bridge connect --instance work
+remnote-bridge connect --instance personal
+
+# 查看指定实例状态
+remnote-bridge health --instance work
+
+# 停止指定实例
+remnote-bridge disconnect --instance work
+```
+
+**槽位分配**：每个实例启动时自动占用第一个空闲槽位，端口固定分配：
+
+| 槽位 | WS 端口 | Plugin 服务端口 | 配置端口 |
+|:-----|:--------|:---------------|:---------|
+| 0 | 29100 | 29101 | 29102 |
+| 1 | 29110 | 29111 | 29112 |
+| 2 | 29120 | 29121 | 29122 |
+| 3 | 29130 | 29131 | 29132 |
+
+**实例名解析优先级**：CLI `--instance` > 环境变量 `REMNOTE_BRIDGE_INSTANCE` > 默认值 `default`。
+
+**Plugin 自动发现**：Plugin 启动后通过 `/api/discovery` 获取其孪生 daemon 的连接信息（WS 端口、槽位索引等），自动建立连接。一个 Plugin 可同时连接最多 4 个 daemon。
+
+**业务命令的实例选择**：`read-rem`、`edit-rem` 等业务命令自动路由到 `--instance` 指定的实例（默认 `default`）。各实例的缓存相互独立。
+
+### 3.4 健康状态
 
 `health` 命令检查三层状态：
 
@@ -233,9 +267,12 @@ disconnect → daemon 关闭 → 会话结束，缓存清空
 
 | 命令 | 功能 | 需要 Plugin | 详细文档 |
 |:-----|:-----|:------------|:---------|
-| `connect` | 启动守护进程 | 否 | `connect.md` |
-| `health` | 检查系统状态 | 否 | `health.md` |
-| `disconnect` | 停止守护进程 | 否 | `disconnect.md` |
+| `connect` | 启动守护进程（支持 `--instance`） | 否 | `connect.md` |
+| `health` | 检查系统状态（支持 `--instance`） | 否 | `health.md` |
+| `disconnect` | 停止守护进程（支持 `--instance`） | 否 | `disconnect.md` |
+| `addon` | 管理增强项目（list/install/uninstall） | 否 | `addon.md` |
+| `clean` | 清理所有进程、缓存和注册表 | 否 | `clean.md` |
+| `install-skill` | 安装 Skill 到 Agent 环境 | 否 | `install-skill.md` |
 
 #### 读取命令
 
@@ -454,8 +491,8 @@ RemObject 是本项目对 RemNote Rem 的标准化表示，包含 51 个字段
 | 标记 | 含义 | 数量 | 输出条件 |
 |:-----|:-----|:-----|:---------|
 | RW | 可读可写 | 20 | 默认输出 |
-| R | 只读 | 14 | 默认输出 |
-| R-F | 只读低频 | 17 | 仅 `--full` 输出 |
+| R | 只读 | 13 | 默认输出 |
+| R-F | 只读低频 | 18 | 仅 `--full` 输出 |
 
 ### 7.2 核心字段速览
 
@@ -463,7 +500,7 @@ RemObject 是本项目对 RemNote Rem 的标准化表示，包含 51 个字段
 标识：  id
 内容：  text [RW], backText [RW]
 类型：  type [RW], isDocument [RW]
-结构：  parent [RW], children [R]
+结构：  parent [RW], children [R-F]
 格式：  fontSize [RW], highlightColor [RW]
 状态：  isTodo [RW], todoStatus [RW], isCode [RW], isQuote [RW],
         isListItem [RW], isCardItem [RW], isSlot [RW], isProperty [RW]
@@ -536,7 +573,14 @@ Portal：portalType [R], portalDirectlyIncludedRem [Portal-W]
 
 > 在 RemObject 格式化 JSON 中，数组内对象展开为多行。构造 edit-rem 的 oldStr/newStr 必须用多行格式。
 
-**highlightColor vs h**：`highlightColor` 是 RemObject 顶层字段（字符串如 `"Red"`），`h` 是 RichText 行内格式标记（数字 0-9）。两者独立。
+**⚠️ highlightColor vs h — 两种完全不同的高亮**：
+
+| 属性 | 位置 | 值类型 | 效果 |
+|:-----|:-----|:-------|:-----|
+| `highlightColor` | RemObject 顶层字段 | 字符串 `"Yellow"`/`"Red"` 等或 `null` | 整行背景色（左侧彩色竖条） |
+| `h` | RichText 元素内部 | 数字 0-9 | 文字片段荧光底色 |
+
+`h` 颜色值：0=无, 1=Red, 2=Orange, 3=Yellow, 4=Green, 5=Purple, 6=Blue, 7=Gray, 8=Brown, 9=Pink。
 
 **序列化确定性**：RichText 对象内部按 key 字母序排列（`sortRichTextKeys()`）。`_id` 的 `_`（U+005F）排在所有小写字母之前。这对 edit-rem 的 str_replace 和并发检测至关重要。
 
@@ -751,13 +795,10 @@ RemNote 的格式设置通过 Powerup 机制实现，会向 Rem 注入隐藏的
 
 ## 12. 配置系统
 
-配置文件位于项目根目录：`.remnote-bridge.json`
+配置文件位于全局目录：`~/.remnote-bridge/config.json`（所有实例共享）。
 
 ```json
 {
-  "wsPort": 3002,
-  "devServerPort": 8080,
-  "configPort": 3003,
   "daemonTimeoutMinutes": 30,
   "defaults": {
     "maxNodes": 200,
@@ -776,7 +817,21 @@ RemNote 的格式设置通过 Powerup 机制实现，会向 Rem 注入隐藏的
 ```
 
 - 文件不存在时使用全部默认值
-- 三个端口不允许冲突
+- 端口由槽位自动分配（`~/.remnote-bridge/slots.json`），通常无需手动配置
+
+### 多实例文件布局
+
+```
+~/.remnote-bridge/
+  ├── config.json      — 全局配置（所有实例共享）
+  ├── slots.json       — 槽位端口定义（自动生成）
+  ├── registry.json    — 实例→槽位映射（运行时维护）
+  └── instances/
+      ├── 0.pid / 0.log   — 槽位 0 的 PID 和日志
+      ├── 1.pid / 1.log   — 槽位 1
+      ├── 2.pid / 2.log   — 槽位 2
+      └── 3.pid / 3.log   — 槽位 3
+```
 
 ---
 

package/skills/remnote-bridge/instructions/read-context.md

@@ -27,7 +27,7 @@
 ### 人类模式
 
 ```bash
-remnote-bridge read-context [--mode <mode>] [--ancestor-levels <N>] [--depth <N>] [--max-nodes <N>] [--max-siblings <N>]
+remnote-bridge read-context [--mode <mode>] [--ancestor-levels <N>] [--depth <N>] [--max-nodes <N>] [--max-siblings <N>] [--focus-rem-id <remId>]
 ```
 
 | 参数/选项 | 类型 | 必需 | 说明 |
@@ -37,6 +37,7 @@ remnote-bridge read-context [--mode <mode>] [--ancestor-levels <N>] [--depth <N>
 | `--depth <N>` | integer | 否 | 展开深度（默认 3，仅 page 模式） |
 | `--max-nodes <N>` | integer | 否 | 全局节点上限（默认 200） |
 | `--max-siblings <N>` | integer | 否 | 每个父节点下展示的 children 上限（默认 20） |
+| `--focus-rem-id <remId>` | string | 否 | 指定鱼眼中心 Rem ID（仅 focus 模式，默认使用当前焦点） |
 
 Focus 模式输出示例：
 
@@ -73,6 +74,7 @@ Page 模式输出示例：
 
 ```bash
 remnote-bridge read-context --json '{"mode":"focus","ancestorLevels":3,"maxNodes":100}'
+remnote-bridge read-context --json '{"mode":"focus","focusRemId":"kLrIOHJLyMd8Y2lyA","ancestorLevels":2}'
 remnote-bridge read-context --json '{"mode":"page","depth":5,"maxSiblings":10}'
 ```
 
@@ -87,6 +89,7 @@ remnote-bridge read-context --json '{"mode":"page","depth":5,"maxSiblings":10}'
 | `depth` | number | 否 | 展开深度（默认 3，仅 page 模式） |
 | `maxNodes` | number | 否 | 全局节点上限（默认 200） |
 | `maxSiblings` | number | 否 | 每个父节点下展示的 children 上限（默认 20） |
+| `focusRemId` | string | 否 | 指定鱼眼中心 Rem ID（仅 focus 模式，默认使用当前焦点） |
 
 ---
 
@@ -124,7 +127,7 @@ remnote-bridge read-context --json '{"mode":"page","depth":5,"maxSiblings":10}'
 }
 ```
 
-### 无焦点 Rem（focus 模式）
+### 无焦点 Rem（focus 模式，未指定 focusRemId）
 
 ```json
 {
@@ -135,6 +138,28 @@ remnote-bridge read-context --json '{"mode":"page","depth":5,"maxSiblings":10}'
 }
 ```
 
+### focusRemId 指定的 Rem 不存在
+
+```json
+{
+  "ok": false,
+  "command": "read-context",
+  "error": "指定的 Rem 不存在: kLrIOHJLyMd8Y2lyA",
+  "timestamp": "2026-03-07T10:00:00.000Z"
+}
+```
+
+### page 模式下误传 focusRemId
+
+```json
+{
+  "ok": false,
+  "command": "read-context",
+  "error": "focusRemId 仅在 focus 模式下有效，page 模式下请勿指定",
+  "timestamp": "2026-03-07T10:00:00.000Z"
+}
+```
+
 ### 无打开的页面（page 模式）
 
 ```json
@@ -182,15 +207,15 @@ remnote-bridge read-context --json '{"mode":"page","depth":5,"maxSiblings":10}'
 ## 内部流程
 
 ```
-1. CLI 解析参数（mode, ancestorLevels, depth, maxNodes, maxSiblings）
+1. CLI 解析参数（mode, ancestorLevels, depth, maxNodes, maxSiblings, focusRemId）
 2. sendRequest → WS → daemon
 3. daemon ContextReadHandler:
    ├─ 合并配置默认值（config.ts）
-   └─ forwardToPlugin('read_context', { mode, ancestorLevels, depth, maxNodes, maxSiblings })
+   └─ forwardToPlugin('read_context', { mode, ancestorLevels, depth, maxNodes, maxSiblings, focusRemId })
 4. Plugin 端 readContext() 分支：
    │
    ├─ mode === 'focus' → readContextFocus():
-   │   ├─ plugin.focus.getFocusedRem() → 获取焦点 Rem
+   │   ├─ focusRemId ? plugin.rem.findOne(focusRemId) : plugin.focus.getFocusedRem() → 获取焦点 Rem
    │   ├─ 向上追溯 ancestorLevels 层 → ancestorPath[]
    │   ├─ buildBreadcrumb(plugin, focusRem) → 面包屑路径
    │   ├─ 从最顶层祖先开始递归 buildFisheyeNode()：
@@ -274,8 +299,8 @@ focus 模式的核心特点是**渐进式展开**——离焦点越近，展开
 
 | 维度 | focus 模式 | page 模式 |
 |:-----|:----------|:----------|
-| 触发点 | 当前焦点 Rem（光标位置） | 当前打开的页面 Rem |
-| SDK 入口 | `plugin.focus.getFocusedRem()` | `plugin.window.getFocusedPaneId()` → `getOpenPaneRemId()` |
+| 触发点 | 当前焦点 Rem 或指定 `focusRemId` | 当前打开的页面 Rem |
+| SDK 入口 | `focusRemId` ? `plugin.rem.findOne()` : `plugin.focus.getFocusedRem()` | `plugin.window.getFocusedPaneId()` → `getOpenPaneRemId()` |
 | 深度参数 | `ancestorLevels`（向上几层） | `depth`（向下几层） |
 | 展开策略 | 鱼眼（焦点完全展开，周围递减） | 均匀展开（全树同深度控制） |
 | 大纲头注释 | `<!-- path: ... -->` + `<!-- focus: Name (id) -->` | `<!-- page: Name -->` + `<!-- path: ... -->` |
@@ -345,7 +370,8 @@ focus 模式的核心特点是**渐进式展开**——离焦点越近，展开
 ## 注意事项
 
 - read-context **不缓存**结果——每次调用都重新从 SDK 获取最新数据
-- focus 模式需要用户在 RemNote 中有焦点 Rem（光标需在某个 Rem 上）
+- focus 模式需要用户在 RemNote 中有焦点 Rem（光标需在某个 Rem 上），或通过 `focusRemId` 指定任意 Rem 作为鱼眼中心
+- `focusRemId` 仅在 focus 模式下有效，page 模式下传入会报错
 - page 模式需要 RemNote 中有打开的页面
 - 输出使用 `createMinimalSerializableRem` 序列化，不包含 backText、practiceDirection 等详细信息
 - Powerup 过滤是硬编码的，无法通过参数关闭

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

@@ -9,7 +9,7 @@
 `read-rem` 通过 Rem ID 读取一个 Rem 的所有可获取属性，返回标准化的 RemObject。读取结果会被缓存在 daemon 内存中，供后续 `edit-rem` 使用。
 
 核心能力：
-- 返回 51 个字段的完整 Rem 数据（默认 34 个，Portal 简化 9 个，`--full` 时 51 个）
+- 返回 51 个字段的完整 Rem 数据（默认 33 个，Portal 简化 8 个，`--full` 时 51 个）
 - 支持 `--fields` 指定字段子集
 - 支持 Powerup 噪音过滤（默认过滤）
 - 自动缓存，为 `edit-rem` 建立编辑基础
@@ -76,12 +76,11 @@ remnote-bridge read-rem --json '{"remId":"kLrIOHJLyMd8Y2lyA"}'
     "type": "concept",
     "isDocument": false,
     "parent": "parentRemId",
-    "children": ["childId1", "childId2"],
     "fontSize": null,
     "highlightColor": null,
     "isTodo": false,
     "todoStatus": null,
-    "...": "（共 34 个字段，--full 时 51 个）"
+    "...": "（共 33 个字段，--full 时 51 个）"
   },
   "timestamp": "2026-03-06T10:00:00.000Z"
 }
@@ -159,8 +158,8 @@ remnote-bridge read-rem --json '{"remId":"kLrIOHJLyMd8Y2lyA"}'
    ├─ 字段过滤：
    │   ├─ --full → 返回全部 51 字段
    │   ├─ --fields → 返回指定字段 + id
-   │   ├─ type=portal → Portal 简化模式（返回 9 个关键字段）
-   │   └─ 默认 → 排除 R-F 字段（返回 34 字段）
+   │   ├─ type=portal → Portal 简化模式（返回 8 个关键字段）
+   │   └─ 默认 → 排除 R-F 字段（返回 33 字段）
    └─ 附加 _cacheOverridden 元数据（若之前有缓存）
 4. CLI 格式化输出（人类模式 pretty-print / JSON 模式单行）
 ```
@@ -172,8 +171,8 @@ remnote-bridge read-rem --json '{"remId":"kLrIOHJLyMd8Y2lyA"}'
 RemObject 共 51 个字段，按读写权限分为三类：
 
 - **RW**（20 个）：可读可写，SDK 有对应的 setter
-- **R**（14 个）：只读，默认输出
-- **R-F**（17 个）：只读，仅 `--full` 模式输出（低频 / 可由其他字段推导）
+- **R**（13 个）：只读，默认输出
+- **R-F**（18 个）：只读，仅 `--full` 模式输出（低频 / 可由其他字段推导）
 
 ### 核心标识
 
@@ -200,7 +199,7 @@ RemObject 共 51 个字段，按读写权限分为三类：
 | 字段 | 类型 | 权限 | 说明 |
 |------|------|:----:|------|
 | `parent` | `string \| null` | RW | 父 Rem ID。null=顶级。UI：Rem 从原位置消失，出现在新父级下 |
-| `children` | `string[]` | R | 子 Rem ID 有序数组 |
+| `children` | `string[]` | R-F | 子 Rem ID 有序数组 |
 
 ### 格式 / 显示
 
@@ -377,14 +376,15 @@ text | number | date | checkbox | single_select | multi_select | url | image | t
 
 | 模式 | 输出字段数 | 说明 |
 |------|:----------:|------|
-| 默认 | 34 | RW + R 字段，覆盖常用场景 |
-| Portal 简化 | 9 | type=portal 时自动使用（id、type、portalType、portalDirectlyIncludedRem、parent、positionAmongstSiblings、children、createdAt、updatedAt）。`--full` / `--fields` 可覆盖 |
+| 默认 | 33 | RW + R 字段，覆盖常用场景 |
+| Portal 简化 | 8 | type=portal 时自动使用（id、type、portalType、portalDirectlyIncludedRem、parent、positionAmongstSiblings、createdAt、updatedAt）。`--full` / `--fields` 可覆盖 |
 | `--full` | 51 | 全部字段（含 R-F 低频字段） |
 | `--fields` | 自选 + id | 仅返回指定字段（始终包含 id） |
 
 ### R-F 字段列表（默认不输出，`--full` 时输出）
 
 ```
+children,
 isPowerup, isPowerupEnum, isPowerupProperty, isPowerupPropertyListItem, isPowerupSlot,
 deepRemsBeingReferenced,
 ancestorTagRem, descendantTagRem,

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

@@ -1,12 +1,26 @@
 # search
 
-> 在知识库中按文本搜索 Rem，返回匹配结果列表。
+> 在知识库中搜索 Rem，返回匹配结果列表。支持 SDK 全文搜索和 RAG 语义搜索。
 
 ---
 
 ## 功能
 
-`search` 调用 RemNote SDK 的全文搜索 API（`plugin.search.search()`），在当前知识库中搜索包含关键词的 Rem，返回匹配结果的 ID、文本和文档标记。
+`search` 在当前知识库中搜索包含关键词的 Rem。搜索方式由配置驱动：
+
+- **RAG 语义搜索**：在 `~/.remnote-bridge/config.json` 中启用 `addons.remnote-rag`（`enabled: true`），并在 `~/.remnote-bridge/addons/remnote-rag/config.json` 中配置 API Key，系统自动使用语义向量搜索（中文支持更好）
+- **SDK 全文搜索**：addon 未启用、未安装、或调用失败时自动降级
+
+安装与管理 addon：`remnote-bridge addon install remnote-rag` / `remnote-bridge addon list`。
+
+### 搜索来源（source 字段）
+
+| source | 说明 | 返回字段 |
+|--------|------|----------|
+| `"rag"` | 语义向量搜索（remnote-rag 已启用且可用） | remId, text, backText, ancestorPath, type, isDocument, tags, score |
+| `"sdk"` | SDK 全文搜索（默认降级） | remId, text, isDocument |
+
+降级场景：addon 未启用、remnote-rag 未安装、向量库未索引、子进程超时（10s）、返回异常。
 
 ---
 
@@ -58,7 +72,33 @@ remnote-bridge search --json '{"query":"机器学习","numResults":10}'
 
 ## JSON 输出
 
-### 成功
+### 成功（RAG 模式）
+
+```json
+{
+  "ok": true,
+  "command": "search",
+  "data": {
+    "query": "机器学习",
+    "results": [
+      {
+        "remId": "kLrIOHJLyMd8Y2lyA",
+        "text": "支持向量机的核心思想",
+        "backText": "最大化分类间隔",
+        "ancestorPath": ["机器学习", "监督学习"],
+        "type": "concept",
+        "isDocument": false,
+        "tags": ["统计学习"],
+        "score": 0.87
+      }
+    ],
+    "totalFound": 1,
+    "source": "rag"
+  }
+}
+```
+
+### 成功（SDK 降级模式）
 
 ```json
 {
@@ -70,7 +110,8 @@ remnote-bridge search --json '{"query":"机器学习","numResults":10}'
       { "remId": "kLrIOHJLyMd8Y2lyA", "text": "机器学习笔记", "isDocument": true },
       { "remId": "abc123def456", "text": "监督学习与机器学习的关系", "isDocument": false }
     ],
-    "totalFound": 2
+    "totalFound": 2,
+    "source": "sdk"
   },
   "timestamp": "2026-03-06T10:00:00.000Z"
 }
@@ -119,29 +160,47 @@ remnote-bridge search --json '{"query":"机器学习","numResults":10}'
 
 ```
 1. CLI 解析参数（query, numResults）
-2. sendRequest → WS → daemon → forwardToPlugin('search', { query, numResults })
-3. Plugin 端：
-   ├─ plugin.search.search([query], undefined, { numResults })
-   ├─ 遍历结果 Rem：
-   │   ├─ plugin.richText.toMarkdown(rem.text) → 转 Markdown 文本
-   │   ├─ 换行符替换为空格（保持单行）
-   │   └─ rem.isDocument() → 是否文档
-   └─ 返回 { query, results, totalFound }
-4. CLI 格式化输出
+2. 检查配置：addons.remnote-rag.enabled
+   ├─ 未启用 → 跳到步骤 4
+   └─ 已启用 → 继续步骤 3
+3. 尝试 RAG 搜索：
+   ├─ execFile('remnote-rag', ['search', '--json', payload])
+   ├─ remnote-rag 从 ~/.remnote-bridge/addons/remnote-rag/config.json 读取配置
+   ├─ 超时 10s
+   ├─ 成功 → 返回 RAG 结果（source: "rag"）
+   └─ 失败 → 继续到步骤 4（静默降级）
+4. 降级到 SDK 搜索：
+   ├─ sendRequest → WS → daemon → forwardToPlugin('search', ...)
+   ├─ Plugin 端调用 plugin.search.search()
+   └─ 返回 SDK 结果（source: "sdk"）
+5. CLI 格式化输出
 ```
 
 ---
 
 ## 结果字段说明
 
+### 通用字段（两种模式都有）
+
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `query` | string | 原始搜索关键词 |
 | `results` | array | 结果数组 |
 | `results[].remId` | string | 匹配 Rem 的 ID |
-| `results[].text` | string | Rem 正面文本（Markdown 格式，单行） |
+| `results[].text` | string | Rem 正面文本 |
 | `results[].isDocument` | boolean | 是否为文档页面 |
 | `totalFound` | number | 返回的结果数量 |
+| `source` | string | 搜索来源：`"rag"` 或 `"sdk"` |
+
+### RAG 模式额外字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `results[].backText` | string \| null | Rem 背面文本 |
+| `results[].ancestorPath` | string[] | 祖先路径名称数组（从根到父级） |
+| `results[].type` | string | Rem 类型：`"concept"` / `"descriptor"` / `"default"` |
+| `results[].tags` | string[] | 标签名称数组 |
+| `results[].score` | number | 语义相关性分数（0-1，越高越相关） |
 
 ---
 

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

@@ -91,7 +91,7 @@ setup 会弹出 Chrome 窗口，用户需要完成两件事：登录 RemNote +
 2. **立即告知用户**：
    > 已打开 Chrome 浏览器。请完成以下操作：
    > 1. 登录 RemNote
-   > 2. 在 RemNote 中配置开发插件：点击左下角插件图标 → 开发你的插件 → 输入 `http://localhost:8080`
+   > 2. 在 RemNote 中配置开发插件：点击左下角插件图标 → 开发你的插件 → 输入 connect 输出的 Plugin 服务地址（如 `http://localhost:29101`）
    > 3. 完成后彻底退出 Chrome（macOS 请按 Cmd+Q，仅关窗口不够）
 3. 等待 `setup` 命令返回（阻塞式，超时 600 秒）
 4. 收到成功 → 继续执行 `connect --headless`