remnote-bridge 0.1.10 → 0.1.12

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

@@ -8,16 +8,47 @@
 
 `connect` 以 fork 子进程方式启动后台守护进程（daemon），daemon 内部启动三个服务：
 
-| 服务 | 默认端口 | 用途 |
-|------|----------|------|
-| WS Server | 3002 | CLI 命令 ↔ daemon ↔ Plugin 的双向通信 |
-| Plugin 服务 | 8080 | 将 remnote-plugin 加载到 RemNote 浏览器（默认静态服务器，`--dev` 时为 webpack-dev-server） |
-| ConfigServer | 3003 | HTTP 配置管理界面 |
+| 服务 | 槽位 0 端口 | 用途 |
+|------|------------|------|
+| WS Server | 29100 | CLI 命令 ↔ daemon ↔ Plugin 的双向通信 |
+| Plugin 服务 | 29101 | 将 remnote-plugin 加载到 RemNote 浏览器（默认静态服务器，`--dev` 时为 webpack-dev-server） |
+| ConfigServer | 29102 | HTTP 配置管理界面 |
 
 daemon 启动后脱离父进程（detached），CLI 进程退出但 daemon 继续运行。
 
 ---
 
+## 多实例支持（`--instance`）
+
+`connect` 支持通过 `--instance <name>` 启动多个独立的 daemon 实例，每个实例连接不同的 RemNote 知识库。
+
+```bash
+# 默认实例
+remnote-bridge connect
+
+# 指定实例名
+remnote-bridge connect --instance work
+remnote-bridge connect --instance personal
+
+# JSON 模式
+remnote-bridge --json connect --instance work
+```
+
+**槽位机制**：系统最多支持 4 个并发实例，每个实例占用一个槽位（固定端口组）：
+
+| 槽位 | WS 端口 | Plugin 服务端口 | 配置端口 |
+|:-----|:--------|:---------------|:---------|
+| 0 | 29100 | 29101 | 29102 |
+| 1 | 29110 | 29111 | 29112 |
+| 2 | 29120 | 29121 | 29122 |
+| 3 | 29130 | 29131 | 29132 |
+
+**实例名解析优先级**：CLI `--instance` 参数 > 环境变量 `REMNOTE_BRIDGE_INSTANCE` > 默认值 `default`。Headless 模式下固定为 `headless`。
+
+**首次使用多实例时**，用户需在 RemNote 中为每个实例分别配置 dev plugin URL（对应各自的 Plugin 服务端口）。
+
+---
+
 ## 两种模式
 
 ### 标准模式（默认）
@@ -56,7 +87,7 @@ Headless 模式下 Plugin 可能需要 10-30 秒才能连接到 daemon，使用
 1. 打开 RemNote 桌面端或网页端
 2. 点击左侧边栏底部的插件图标（拼图形状）
 3. 点击「开发你的插件」（Develop Your Plugin）
-4. 在输入框中填入 `http://localhost:8080`（即 connect 输出的 Plugin 服务地址）
+4. 在输入框中填入 connect 输出的 Plugin 服务地址（如 `http://localhost:29101`）
 5. 等待插件加载完成
 
 ### 非首次使用（之前已加载过此插件）
@@ -82,10 +113,11 @@ remnote-bridge connect
 输出示例：
 
 ```
-守护进程已启动（PID: 12345）
-  WS Server:         ws://127.0.0.1:3002
-  Plugin 服务:       http://localhost:8080
-  配置页面:          http://127.0.0.1:3003
+正在启动守护进程（实例: default，槽位: 0）...
+守护进程已启动（PID: 12345，实例: default）
+  WS Server:         ws://127.0.0.1:29100
+  Plugin 服务:       http://localhost:29101
+  配置页面:          http://127.0.0.1:29102
   超时: 30 分钟无 CLI 交互后自动关闭
 ```
 
@@ -106,11 +138,15 @@ remnote-bridge --json connect
   "ok": true,
   "command": "connect",
   "alreadyRunning": false,
+  "instance": "default",
   "pid": 12345,
-  "wsPort": 3002,
-  "devServerPort": 8080,
-  "configPort": 3003,
+  "wsPort": 29100,
+  "devServerPort": 29101,
+  "configPort": 29102,
+  "slotIndex": 0,
   "timeoutMinutes": 30,
+  "headless": false,
+  "portChanged": false,
   "timestamp": "2026-03-06T10:00:00.000Z"
 }
 ```
@@ -122,9 +158,12 @@ remnote-bridge --json connect
   "ok": true,
   "command": "connect",
   "alreadyRunning": true,
+  "instance": "default",
   "pid": 12345,
-  "wsPort": 3002,
-  "devServerPort": 8080,
+  "wsPort": 29100,
+  "devServerPort": 29101,
+  "configPort": 29102,
+  "slotIndex": 0,
   "timestamp": "2026-03-06T10:00:00.000Z"
 }
 ```
@@ -135,8 +174,7 @@ remnote-bridge --json connect
 {
   "ok": false,
   "command": "connect",
-  "error": "守护进程启动超时（60 秒）",
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "error": "已达最大实例数上限（4），无可用槽位"
 }
 ```
 
@@ -145,24 +183,28 @@ remnote-bridge --json connect
 ## 启动流程
 
 ```
-1. 检查 PID 文件 (.remnote-bridge.pid)
-   ├─ 已在运行 → 返回 ok + alreadyRunning: true
-   └─ 未运行 / stale PID → 继续
+1. 解析实例名（--instance / 环境变量 / 默认 'default'）
+
+2. 加载注册表，清理过期槽位
+   ├─ 实例已在运行 → 返回 ok + alreadyRunning: true
+   └─ 未运行 → 继续
+
+3. 分配槽位（第一个空闲槽位）
+   ├─ 无空闲 → 报错 "已达最大实例数上限（4）"
+   └─ 有空闲 → 占位
 
-2. fork 守护进程（detached, stdio 全部 ignore）
+4. fork 守护进程（detached, 传入 SLOT_INDEX / SLOT_WS_PORT 等环境变量）
 
-3. daemon 内部按顺序启动：
+5. daemon 内部按顺序启动：
    ├─ WS Server（必须成功，否则 daemon 退出）
    ├─ ConfigServer（非关键，失败不阻塞）
-   └─ Plugin 服务（默认静态服务器；--dev 时为 webpack-dev-server + 依赖自动安装 + 崩溃重试）
+   └─ Plugin 服务（默认静态服务器；--dev 时为 webpack-dev-server）
 
-4. daemon 写入 PID 文件
+6. daemon 通过 IPC 发送 ready 信号给父进程
 
-5. daemon 通过 IPC 发送 ready 信号给父进程
-
-6. 父进程（CLI）收到 ready → 输出结果 → 退出
-   ├─ 60 秒内未收到 → 超时失败
-   └─ 收到 error → 启动失败
+7. 父进程（CLI）收到 ready → 更新注册表 → 输出结果 → 退出
+   ├─ 60 秒内未收到 → 超时失败，释放槽位
+   └─ 收到 error → 启动失败，释放槽位
 ```
 
 ---
@@ -172,7 +214,7 @@ remnote-bridge --json connect
 - **默认模式秒级启动**：使用预构建 plugin，无需安装依赖
 - **`--dev` 模式首次较慢**：会自动安装 remnote-plugin 的依赖（约 600+ 个包），在 Windows 上可能需要 30-60 秒。connect 命令的超时为 60 秒
 - **`--dev` 依赖自动修复**：如果 webpack-dev-server 因依赖损坏而崩溃，daemon 会自动执行清洁重装（删除 node_modules + package-lock.json 后重新安装）并重试，最多重试 2 次，无需手动干预
-- **端口残留**：多次 connect 失败后可能出现端口被占用（`EADDRINUSE`），先执行 `remnote-bridge disconnect`，如仍有残留可通过 `netstat -ano | findstr 3002` 定位 PID 后 `taskkill /F /PID <pid>` 强制终止
+- **端口残留**：多次 connect 失败后可能出现端口被占用（`EADDRINUSE`），先执行 `remnote-bridge disconnect`（或 `remnote-bridge clean` 清理所有实例），如仍有残留可通过 `netstat -ano | findstr 29100` 定位 PID 后 `taskkill /F /PID <pid>` 强制终止
 
 ---
 
@@ -180,7 +222,7 @@ remnote-bridge --json connect
 
 daemon 启动后开始计时，默认 **30 分钟无 CLI 交互**自动关闭（执行优雅 shutdown）。每次收到 CLI 请求时重置计时器。
 
-超时时间可通过配置文件 `.remnote-bridge.json` 的 `daemonTimeoutMinutes` 字段调整。
+超时时间可通过配置文件 `~/.remnote-bridge/config.json` 的 `daemonTimeoutMinutes` 字段调整。
 
 ---
 
@@ -203,12 +245,11 @@ daemon 启动后开始计时，默认 **30 分钟无 CLI 交互**自动关闭（
 
 | 配置项 | 默认值 | 说明 |
 |--------|--------|------|
-| wsPort | 3002 | WS Server 监听端口 |
-| devServerPort | 8080 | Plugin 服务端口 |
-| configPort | 3003 | ConfigServer 端口 |
 | daemonTimeoutMinutes | 30 | 无活动自动关闭的分钟数 |
 
-三个端口不允许冲突（配置加载时校验）。
+端口由槽位自动分配（29100/29110/29120/29130 系列），通过 `~/.remnote-bridge/slots.json` 自定义。
+
+配置文件位置：`~/.remnote-bridge/config.json`（全局配置，所有实例共享）。
 
 ---
 
@@ -216,5 +257,7 @@ daemon 启动后开始计时，默认 **30 分钟无 CLI 交互**自动关闭（
 
 | 文件 | 位置 | 生命周期 |
 |------|------|----------|
-| `.remnote-bridge.pid` | 项目根目录 | daemon 运行期间存在，关闭时删除 |
-| `.remnote-bridge.log` | 项目根目录 | 追加写入，跨会话保留 |
+| `{slotIndex}.pid` | `~/.remnote-bridge/instances/` | daemon 运行期间存在，关闭时删除 |
+| `{slotIndex}.log` | `~/.remnote-bridge/instances/` | 追加写入，跨会话保留 |
+| `registry.json` | `~/.remnote-bridge/` | 记录实例→槽位映射，进程退出后自动清理 |
+| `slots.json` | `~/.remnote-bridge/` | 槽位端口定义，不存在时自动生成默认值 |

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

@@ -6,14 +6,26 @@
 
 ## 功能
 
-`disconnect` 向守护进程发送 SIGTERM 信号，触发优雅关闭：
+`disconnect` 向指定实例的守护进程发送 SIGTERM 信号，触发优雅关闭：
 
 1. 关闭 WS Server（断开所有连接）
 2. 关闭 ConfigServer
 3. 停止 Plugin 服务（静态文件服务器 或 webpack-dev-server）
-4. 删除 PID 文件
+4. 删除 PID 文件，释放注册表槽位
 5. 内存缓存随进程退出自动消失
 
+### 多实例支持
+
+通过 `--instance <name>` 指定要停止的实例。不指定时停止 `default` 实例。
+
+```bash
+# 停止默认实例
+remnote-bridge disconnect
+
+# 停止指定实例
+remnote-bridge disconnect --instance work
+```
+
 ---
 
 ## 用法
@@ -48,9 +60,9 @@ remnote-bridge --json disconnect
   "ok": true,
   "command": "disconnect",
   "wasRunning": true,
+  "instance": "default",
   "pid": 12345,
-  "forced": false,
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "forced": false
 }
 ```
 
@@ -61,9 +73,9 @@ remnote-bridge --json disconnect
   "ok": true,
   "command": "disconnect",
   "wasRunning": true,
+  "instance": "work",
   "pid": 12345,
-  "forced": true,
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "forced": true
 }
 ```
 
@@ -74,7 +86,7 @@ remnote-bridge --json disconnect
   "ok": true,
   "command": "disconnect",
   "wasRunning": false,
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "instance": "default"
 }
 ```
 
@@ -116,8 +128,9 @@ daemon 收到 SIGTERM 后依次执行：
 | **缓存清空** | 所有 `rem:*` 和 `tree:*` 缓存随 daemon 进程退出消失 |
 | **Plugin 断开** | WS 连接关闭，Plugin 进入重连循环（指数退避） |
 | **端口释放** | wsPort / devServerPort / configPort 全部释放 |
-| **PID 文件删除** | `.remnote-bridge.pid` 被删除 |
-| **日志保留** | `.remnote-bridge.log` 保留（追加写入，不删除） |
+| **PID 文件删除** | `~/.remnote-bridge/instances/{slotIndex}.pid` 被删除 |
+| **注册表释放** | 实例对应的槽位在 `registry.json` 中释放 |
+| **日志保留** | `~/.remnote-bridge/instances/{slotIndex}.log` 保留 |
 
 ---
 

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

@@ -348,9 +348,9 @@ edit-rem(remId, oldStr, newStr)
 
 ### 简化 JSON 作为操作目标
 
-**问题**：缓存中存储完整 51 字段 JSON，但 AI 看到的是 9 字段简化 JSON。oldStr 来自简化输出，在完整 JSON 上匹配不到。
+**问题**：缓存中存储完整 51 字段 JSON，但 AI 看到的是 8 字段简化 JSON。oldStr 来自简化输出，在完整 JSON 上匹配不到。
 
-**方案**：Portal 路径在**简化 JSON**（9 字段）上执行 str_replace：
+**方案**：Portal 路径在**简化 JSON**（8 字段）上执行 str_replace：
 
 1. 防线 1 + 2：不变（完整 JSON 对比）
 2. **str_replace**：将缓存的完整 JSON 转换为简化 JSON，在简化 JSON 上执行 str_replace
@@ -635,21 +635,49 @@ newStr:  "\"text\": [\n    \"点击\",\n    {\n      \"i\": \"m\",\n      \"iUrl
 
 ### 示例 4：修改高亮颜色（Rem 级别 vs RichText 级别）
 
-**Rem 级别的 `highlightColor`**（整行背景色，值为英文字符串）：
+#### ⚠️ highlightColor vs h — 两种完全不同的高亮
+
+| 属性 | 位置 | 值类型 | 效果 | 修改方式 |
+|:-----|:-----|:-------|:-----|:---------|
+| `highlightColor` | RemObject 顶层字段 | 字符串 `"Red"`/`"Yellow"` 等，或 `null` | 整行背景色（左侧彩色竖条） | str_replace 顶层字段 |
+| `h` | RichText 元素内部 | 数字 0-9 | 文字片段的荧光底色 | str_replace text 数组内的对象 |
+
+#### RichText `h` 颜色值对照表（必须用数字，不是字符串）
+
+| 值 | 颜色 | 值 | 颜色 | 值 | 颜色 |
+|:---|:-----|:---|:-----|:---|:-----|
+| 0 | 无（默认） | 4 | Green | 7 | Gray |
+| 1 | Red | 5 | Purple | 8 | Brown |
+| 2 | Orange | 6 | Blue | 9 | Pink |
+| 3 | Yellow | — | — | — | — |
+
+#### 4a. 设置/清除整行背景色（highlightColor）
 
 ```
+// 设置为黄色背景
 oldStr:  "\"highlightColor\": null"
-newStr:  "\"highlightColor\": \"Red\""
+newStr:  "\"highlightColor\": \"Yellow\""
+
+// 清除背景色
+oldStr:  "\"highlightColor\": \"Yellow\""
+newStr:  "\"highlightColor\": null"
 ```
 
-**RichText 级别的 `h`**（行内文字高亮，值为数字 0-9）：
+#### 4b. 给文字加/去荧光底色（RichText h 字段）
+
+先 read_rem 找到 text 数组中目标文字对象的精确 JSON。用 `h` 值旁边的 `"i"` 和 `"text"` 字段一起匹配，确保唯一。
 
 ```
-oldStr:  "\"text\": [\n    \"普通文本\"\n  ]"
-newStr:  "\"text\": [\n    {\n      \"h\": 1,\n      \"i\": \"m\",\n      \"text\": \"红色高亮文本\"\n    }\n  ]"
+// "Todo List" 文字加黄色荧光（h: 0 → 3）
+oldStr:  "\"h\": 0,\n      \"i\": \"m\",\n      \"text\": \"Todo List \""
+newStr:  "\"h\": 3,\n      \"i\": \"m\",\n      \"text\": \"Todo List \""
+
+// 去掉荧光（h: 3 → 0）
+oldStr:  "\"h\": 3,\n      \"i\": \"m\",\n      \"text\": \"Todo List \""
+newStr:  "\"h\": 0,\n      \"i\": \"m\",\n      \"text\": \"Todo List \""
 ```
 
-> **区分**：`highlightColor` 是 RemObject 顶层字段，值为字符串（`"Red"`, `"Blue"` 等）；RichText 的 `h` 是行内格式标记，值为数字（1=Red, 2=Orange 等，见 RemColor 枚举）。
+⚠️ **关键**：oldStr 中必须包含足够的上下文（如 `"i": "m"` 和 `"text": "..."`）来唯一定位。不能只写 `"h": 0` — 可能匹配到多处。
 
 ### 示例 5：添加完形填空
 
@@ -714,5 +742,5 @@ newStr:  "\"text\": [\n    \"光合作用需要\",\n    {\n      \"cId\": \"cloz
 | `invalid JSON` | 替换后的文本不是合法 JSON | 检查 newStr 的引号、逗号、括号完整性 |
 | `Failed to update field` | SDK setter 调用失败 | 检查字段值是否在允许范围内（如 type 不能设为 portal） |
 | `Field '...' is read-only and was ignored` | 修改了只读字段 | 该字段只能读取，不可通过 edit-rem 修改 |
-| `old_str not found in the simplified Portal JSON` | Portal 编辑时 oldStr 在简化 JSON 中不匹配 | 检查 oldStr 是否匹配 9 字段简化 JSON 格式（而非完整 51 字段 JSON） |
+| `old_str not found in the simplified Portal JSON` | Portal 编辑时 oldStr 在简化 JSON 中不匹配 | 检查 oldStr 是否匹配 8 字段简化 JSON 格式（而非完整 51 字段 JSON） |
 | `守护进程未运行` | daemon 未启动 | 执行 `remnote-bridge connect` |

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

@@ -6,11 +6,19 @@
 
 ## 功能
 
-`health` 分两步检查系统状态：
+`health` 分两步检查指定实例的系统状态：
 
-1. **本地检查**：读取 PID 文件，确认 daemon 进程是否存活
+1. **本地检查**：通过注册表查找实例，确认 daemon 进程是否存活
 2. **远程检查**：通过 WS 连接 daemon，获取 Plugin 连接状态和 SDK 就绪状态
 
+### 多实例支持
+
+通过 `--instance <name>` 指定要检查的实例。不指定时检查 `default` 实例。
+
+```bash
+remnote-bridge health --instance work
+```
+
 ---
 
 ## 用法
@@ -24,7 +32,7 @@ remnote-bridge health
 输出示例（全部健康）：
 
 ```
-✅ 守护进程  运行中（PID: 12345，已运行 5 分钟）
+✅ 守护进程  运行中（PID: 12345，实例: default，槽位: 0，已运行 5 分钟）
 ✅ Plugin    已连接
 ✅ SDK       就绪
 
@@ -34,7 +42,7 @@ remnote-bridge health
 输出示例（部分不健康）：
 
 ```
-✅ 守护进程  运行中（PID: 12345，已运行 2 分钟）
+✅ 守护进程  运行中（PID: 12345，实例: work，槽位: 1，已运行 2 分钟）
 ❌ Plugin    未连接
 ❌ SDK       未就绪
 
@@ -80,11 +88,12 @@ remnote-bridge health --reload
   "ok": true,
   "command": "health",
   "exitCode": 0,
+  "instance": "default",
+  "slotIndex": 0,
   "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 300 },
   "plugin": { "connected": true },
   "sdk": { "ready": true },
-  "timeoutRemaining": 1500,
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "timeoutRemaining": 1500
 }
 ```
 
@@ -95,11 +104,12 @@ remnote-bridge health --reload
   "ok": false,
   "command": "health",
   "exitCode": 1,
+  "instance": "work",
+  "slotIndex": 1,
   "daemon": { "running": true, "pid": 12345, "reachable": true, "uptime": 120 },
   "plugin": { "connected": false },
   "sdk": { "ready": false },
-  "timeoutRemaining": 1680,
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "timeoutRemaining": 1680
 }
 ```
 
@@ -110,10 +120,10 @@ remnote-bridge health --reload
   "ok": false,
   "command": "health",
   "exitCode": 2,
+  "instance": "default",
   "daemon": { "running": false },
   "plugin": { "connected": false },
-  "sdk": { "ready": false },
-  "timestamp": "2026-03-06T10:00:00.000Z"
+  "sdk": { "ready": false }
 }
 ```
 
@@ -123,7 +133,7 @@ remnote-bridge health --reload
 
 | 检查项 | 检查方式 | 含义 |
 |--------|----------|------|
-| **daemon** | PID 文件 + `kill(pid, 0)` 探活 | 守护进程是否在运行且可达 |
+| **daemon** | 注册表查找 + `kill(pid, 0)` 探活 | 守护进程是否在运行且可达 |
 | **plugin** | daemon 内部的 `pluginConnected` 状态 | RemNote Plugin 是否已通过 WS 连接到 daemon |
 | **sdk** | Plugin 的 hello 握手中的 `sdkReady` 字段 | RemNote SDK 是否就绪（知识库已加载，可调用 API） |
 
@@ -179,7 +189,7 @@ headless 模式下 `health` 基础输出额外包含 `headless` 对象：
   "headless": {
     "status": "running",
     "chromeConnected": true,
-    "pageUrl": "http://localhost:8080",
+    "pageUrl": "http://localhost:29101",
     "reloadCount": 0,
     "lastError": null,
     "recentConsoleErrors": []
@@ -218,7 +228,7 @@ headless 模式下 `health` 基础输出额外包含 `headless` 对象：
 | 症状 | 可能原因 | 解决方案 |
 |------|----------|----------|
 | daemon 未运行 | 未执行 connect / 已超时关闭 | 执行 `connect` |
-| daemon 运行但不可达 | WS 端口被占用或配置不匹配 | 检查 `.remnote-bridge.json` 中的 `wsPort` |
+| daemon 运行但不可达 | WS 端口被占用或配置不匹配 | 检查 `~/.remnote-bridge/slots.json` 中的端口配置 |
 | Plugin 未连接（标准模式） | RemNote 未打开 / Plugin 未安装 / URL 不匹配 | 打开 RemNote，确认 Plugin 中的 WS URL 设置 |
 | Plugin 未连接（headless 模式） | Chrome 页面加载异常 | `health --diagnose` 查看截图和状态，`health --reload` 重载页面 |
 | SDK 未就绪 | 知识库加载中 / Plugin 异常 | 等待几秒后重试，或刷新 RemNote 页面 |

package/skills/remnote-bridge/instructions/install-skill.md

@@ -0,0 +1,58 @@
+# install-skill
+
+> 将 remnote-bridge Skill 安装到 AI Agent 环境中。
+
+---
+
+## 功能
+
+`install-skill` 将 Skill 文档（SKILL.md + instructions/*.md）安装到 AI Agent 可发现的位置。支持两种安装方式：
+
+| 方式 | 说明 |
+|:-----|:-----|
+| Vercel Skills CLI（默认） | 通过 `npx skills add` 安装，适用于支持 Vercel Skills 生态的 Agent |
+| Claude Code 直接复制（fallback） | 将文件复制到 `~/.claude/skills/remnote-bridge/`，仅适用于 Claude Code |
+
+---
+
+## 用法
+
+```bash
+# 通过 Vercel Skills CLI 安装（推荐）
+remnote-bridge install-skill
+
+# 直接复制到 Claude Code skills 目录
+remnote-bridge install-skill-copy
+```
+
+---
+
+## 安装逻辑
+
+### install-skill
+
+1. 检测 `npx` 是否可用
+2. 可用 → 执行 `npx skills add baobao700508/unofficial-remnote-bridge-cli -s remnote-bridge`
+3. 不可用或执行失败 → 自动 fallback 到文件复制模式
+
+### install-skill-copy
+
+直接将 Skill 文件从 npm 包内复制到 `~/.claude/skills/remnote-bridge/`：
+- `SKILL.md`
+- `instructions/*.md`（所有 Markdown 文件）
+
+---
+
+## 退出码
+
+| 退出码 | 含义 |
+|:-------|:-----|
+| 0 | 安装成功 |
+| 1 | 安装失败（找不到源文件、权限不足等） |
+
+---
+
+## AI Agent 注意事项
+
+- 此命令通常由用户在初始设置时手动执行，Agent 一般不需要调用
+- 安装完成后，Agent 即可通过 Skill 接口发现和使用 remnote-bridge 功能