remnote-bridge 0.1.0 → 0.1.2

package/{skill → skills/remnote-bridge}/SKILL.md

@@ -7,21 +7,21 @@ description: "RemNote 知识库操作指南。通过 remnote-bridge 命令行工
 
 本 skill 指导 AI Agent 通过 remnote-bridge 操作 RemNote 知识库。
 
-**详细命令文档**位于 `docs/instruction/` 目录下，执行具体命令前务必先读取对应文件：
+**详细命令文档**位于 `instructions/` 目录下，执行具体命令前务必先读取对应文件：
 
 | 命令 | 文档路径 |
 |:-----|:---------|
-| connect | `docs/instruction/connect.md` |
-| disconnect | `docs/instruction/disconnect.md` |
-| health | `docs/instruction/health.md` |
-| read-rem | `docs/instruction/read-rem.md` |
-| edit-rem | `docs/instruction/edit-rem.md` |
-| read-tree | `docs/instruction/read-tree.md` |
-| edit-tree | `docs/instruction/edit-tree.md` |
-| read-globe | `docs/instruction/read-globe.md` |
-| read-context | `docs/instruction/read-context.md` |
-| search | `docs/instruction/search.md` |
-| 全局概览 | `docs/instruction/overall.md` |
+| connect | `instructions/connect.md` |
+| disconnect | `instructions/disconnect.md` |
+| health | `instructions/health.md` |
+| read-rem | `instructions/read-rem.md` |
+| edit-rem | `instructions/edit-rem.md` |
+| read-tree | `instructions/read-tree.md` |
+| edit-tree | `instructions/edit-tree.md` |
+| read-globe | `instructions/read-globe.md` |
+| read-context | `instructions/read-context.md` |
+| search | `instructions/search.md` |
+| 全局概览 | `instructions/overall.md` |
 
 ---
 
@@ -42,7 +42,7 @@ RemNote 中所有内容的基本单元都是 **Rem**。文档、文件夹、闪
 
 两个独立维度：
 
-- **type**（闪卡语义）：`concept`（`::`，加粗）、`descriptor`（`;;`，斜体）、`default`（普通）、`portal`（只读）
+- **type**（闪卡语义）：`concept`（加粗）、`descriptor`（斜体）、`default`（普通）、`portal`（只读）
 - **isDocument**（页面语义）：与 type 完全独立
 
 ### CDF 框架（Concept-Descriptor Framework）
@@ -55,19 +55,30 @@ RemNote 推荐的知识结构化方法：
   损失函数 ;; 均方误差 (MSE)        ← Descriptor
 ```
 
-### 分隔符与闪卡方向
+### 闪卡的 CLI 操作方式
 
-| 分隔符 | type | 默认方向 | 用途 |
-|:-------|:-----|:---------|:-----|
-| `::` | concept | both | 概念定义 |
-| `;;` | descriptor | forward | 描述属性 |
-| `>>` | default | forward | 正向问答 |
-| `<<` | default | backward | 反向问答 |
-| `<>` | default | both | 双向问答 |
-| `>>>` | default | forward | 多行答案 |
-| `::>` | concept | both | 概念型多行答案 |
-| `;;>` | descriptor | forward | 描述型多行答案 |
-| `{{}}` | default | forward | 完形填空 |
+闪卡由 `type`、`backText`、`practiceDirection` 三个字段控制。通过 CLI 操作闪卡，修改的是这些**字段**。
+
+**禁止**：在文本中插入分隔符（`::`、`;;`、`>>`、`<<` 等）来创建闪卡。分隔符是 RemNote 编辑器的输入语法，CLI 无法识别。
+
+| 闪卡操作 | CLI 方法 |
+|:---------|:---------|
+| 创建概念定义 | `edit-tree` 新增行 `概念 ↔ 定义`，再 `edit-rem` 设 `type: "concept"` |
+| 创建正向问答 | `edit-tree` 新增行 `问题 → 答案` |
+| 创建多行答案 | `edit-tree` 新增行 `问题 ↓`（子行自动成为答案） |
+| 改变闪卡类型 | `edit-rem` 修改 `type`、`backText`、`practiceDirection` |
+
+### 理解用户意图：分隔符映射
+
+用户在 RemNote 编辑器中通过分隔符创建闪卡。当用户提到这些分隔符时，理解其意图并映射到上述 CLI 操作：
+
+| 用户说 / 编辑器分隔符 | 对应 type | 对应 practiceDirection |
+|:----------------------|:----------|:----------------------|
+| `::` | concept | both |
+| `;;` | descriptor | forward |
+| `>>` / `<<` / `<>` | default | forward / backward / both |
+| `>>>` / `::>` / `;;>` | default / concept / descriptor | 多行（子 Rem 为答案） |
+| `{{}}` | default | forward（完形填空） |
 
 ### 三种链接机制
 
@@ -141,16 +152,35 @@ Rem 的属性（文本、类型、格式、标签）  → edit-rem   （前置
 
 ## 3. 标准工作流
 
+### ⚠️ connect 后需要用户配合（重要）
+
+`connect` 成功只意味着 daemon 和 webpack-dev-server 已启动，**Plugin 并未自动连接**。用户必须在 RemNote 中完成操作，Plugin 才能连接到 daemon：
+
+**首次使用**（RemNote 从未加载过此插件）：
+1. 打开 RemNote 桌面端或网页端
+2. 点击左侧边栏底部的插件图标（拼图形状）
+3. 点击「开发你的插件」（Develop Your Plugin）
+4. 在输入框中填入 `http://localhost:8080`（即 connect 输出的 webpack-dev-server 地址）
+5. 等待插件加载完成
+
+**非首次使用**（之前已加载过此插件）：
+- 只需**刷新 RemNote 页面**即可（浏览器 F5 或 Cmd+R），插件会自动重新连接
+
+**你必须**：执行 `connect` 后，**立即告知用户需要完成上述操作**，不要直接调用业务命令。引导用户完成后，用 `health` 确认三层就绪再继续。
+
+### 完整流程
+
 ```
 1. connect              -- 启动会话（幂等，重复调用安全）
-2. health               -- 确认三层就绪：daemon → Plugin → SDK（链式依赖）
-3. read-globe           -- 了解知识库结构（首次探索）
+2. ⚠️ 引导用户在 RemNote 中加载插件（首次填端口，非首次刷新页面）
+3. health               -- 确认三层就绪：daemon → Plugin → SDK（链式依赖）
+4. read-globe           -- 了解知识库结构（首次探索）
    或 read-context      -- 了解用户当前上下文
-4. search "关键词"       -- 定位目标 Rem（结果不进缓存！）
-5. read-tree <id>       -- 展开子树 → 写入缓存（edit-tree 的前置）
-6. read-rem <id>        -- 读取属性 → 写入缓存（edit-rem 的前置）
-7. edit-rem / edit-tree -- 执行修改
-8. disconnect           -- 结束会话（缓存全部清空，幂等）
+5. search "关键词"       -- 定位目标 Rem（结果不进缓存！）
+6. read-tree <id>       -- 展开子树 → 写入缓存（edit-tree 的前置）
+7. read-rem <id>        -- 读取属性 → 写入缓存（edit-rem 的前置）
+8. edit-rem / edit-tree -- 执行修改
+9. disconnect           -- 结束会话（缓存全部清空，幂等）
 ```
 
 **超时**：daemon 默认 30 分钟无 CLI 交互自动关闭，每次请求重置计时器。长时间操作间可用 health 保活。
@@ -299,12 +329,12 @@ read-tree / read-globe / read-context 输出 Markdown 大纲，edit-tree 基于
 
 ### 新增行格式
 
-新增行可用 Markdown 前缀和箭头分隔符：
+新增行可用 Markdown 前缀和箭头：
 
 ```markdown
   # 新标题
   新闪卡 → 答案
-  概念 :: 定义
+  问题 ↔ 回答
   - [ ] 新待办
   `代码块`
 ```

package/{docs/instruction → skills/remnote-bridge/instructions}/connect.md

@@ -18,6 +18,30 @@ daemon 启动后脱离父进程（detached），CLI 进程退出但 daemon 继
 
 ---
 
+## ⚠️ connect 后需要用户配合
+
+`connect` 成功只意味着 daemon 和 webpack-dev-server 已启动，**Plugin 并未自动连接**。用户必须在 RemNote 中完成以下操作：
+
+### 首次使用（RemNote 从未加载过此插件）
+
+1. 打开 RemNote 桌面端或网页端
+2. 点击左侧边栏底部的插件图标（拼图形状）
+3. 点击「开发你的插件」（Develop Your Plugin）
+4. 在输入框中填入 `http://localhost:8080`（即 connect 输出的 webpack-dev-server 地址）
+5. 等待插件加载完成
+
+### 非首次使用（之前已加载过此插件）
+
+只需**刷新 RemNote 页面**即可（浏览器 F5 或 Cmd+R），插件会自动重新连接到已启动的 daemon。
+
+### AI Agent 注意事项
+
+- 执行 `connect` 后，**必须立即告知用户完成上述操作**
+- **禁止在 connect 后直接调用业务命令**——此时 Plugin 尚未连接，命令会报 "Plugin 未连接" 错误
+- 引导用户完成操作后，用 `health` 确认三层就绪（daemon → Plugin → SDK），再执行业务命令
+
+---
+
 ## 用法
 
 ### 人类模式

package/{docs/instruction → skills/remnote-bridge/instructions}/overall.md

@@ -51,7 +51,7 @@ Agent 的核心任务是将用户的自然语言请求翻译为 CLI 命令。以
 | 用户表述 | 操作类型 | CLI 命令 |
 |:---------|:---------|:---------|
 | "改文本"、"改标题"、"改颜色"、"改类型" | 修改 Rem 属性 | `edit-rem` |
-| "创建一个概念定义 (::)" | 修改 type + backText | `edit-rem` |
+| "创建一个概念定义"、"做个 :: 卡" | 新增行（edit-tree 箭头）+ 改 type（edit-rem） | `edit-tree` + `edit-rem` |
 | "新增一个子节点"、"添加笔记" | 结构操作：新增 | `edit-tree` |
 | "删除这个"、"移除" | 结构操作：删除 | `edit-tree` |
 | "移动到…下面" | 结构操作：移动 | `edit-tree` |
@@ -66,42 +66,52 @@ Rem 有两个**独立维度**的类型：
 
 #### type 字段（闪卡语义）
 
-| type 值 | 触发分隔符 | 含义 | UI 表现 |
-|:--------|:----------|:-----|:--------|
-| `concept` | `::` 或 `::>` | 概念定义 | 文字**加粗** |
-| `descriptor` | `;;` 或 `;;>` | 描述/属性 | 文字*斜体* |
-| `default` | 无分隔符 / `>>` / `<<` / `<>` / `>>>` / `{{}}` | 普通 Rem | 正常字重 |
-| `portal` | — | 嵌入引用容器 | 紫色左边框（**只读**，不可通过 setType 设置） |
+| type 值 | 含义 | UI 表现 | CLI 设置方式 |
+|:--------|:-----|:--------|:-------------|
+| `concept` | 概念定义 | 文字**加粗** | `edit-rem` 设 `type: "concept"` |
+| `descriptor` | 描述/属性 | 文字*斜体* | `edit-rem` 设 `type: "descriptor"` |
+| `default` | 普通 Rem | 正常字重 | `edit-rem` 设 `type: "default"` |
+| `portal` | 嵌入引用容器 | 紫色左边框 | **只读**，不可通过 CLI 设置 |
 
 #### isDocument 字段（页面语义）
 
 `isDocument` 与 `type` 完全独立——一个 `concept` 类型的 Rem 可以同时是 Document。
 
-### 2.4 分隔符与闪卡
+### 2.4 闪卡的 CLI 操作方式
 
-用户输入的分隔符决定了 Rem 的 `type`、`backText` 和默认 `practiceDirection`。理解分隔符是理解用户创建闪卡意图的关键。
+闪卡由 `type`、`backText`、`practiceDirection` 三个字段控制。通过 CLI 操作闪卡，修改的是这些**字段**和大纲**箭头**。
 
-| 分隔符 | type | backText | 默认方向 | 用途 |
-|:-------|:-----|:---------|:---------|:-----|
-| （无） | `default` | `null` | — | 无闪卡行为 |
-| `::` | `concept` | 后半部分 | `both` | 概念定义（CDF 框架） |
-| `;;` | `descriptor` | 后半部分 | `forward` | 描述属性（CDF 框架） |
-| `>>` | `default` | 后半部分 | `forward` | 正向问答 |
-| `<<` | `default` | 后半部分 | `backward` | 反向问答 |
-| `<>` | `default` | 后半部分 | `both` | 双向问答 |
-| `>>>` | `default` | `null` | `forward` | 多行答案（子 Rem 为答案） |
-| `::>` | `concept` | `null` | `both` | 概念型多行答案 |
-| `;;>` | `descriptor` | `null` | `forward` | 描述型多行答案 |
-| `{{}}` | `default` | `null` | `forward` | 完形填空（Cloze） |
+**禁止**：在文本中插入分隔符（`::`、`;;`、`>>`、`<<` 等）来创建闪卡。分隔符是 RemNote 编辑器的输入语法，CLI 无法识别。
 
-**重要**：分隔符决定创建时的**默认**方向，用户可以事后独立修改 `practiceDirection`。`practiceDirection` 的取值：`forward`（正向）、`backward`（反向）、`both`（双向）、`none`（不练习）。
+| 闪卡操作 | CLI 方法 |
+|:---------|:---------|
+| 创建概念定义 | `edit-tree` 新增行 `概念 ↔ 定义`，再 `edit-rem` 设 `type: "concept"` |
+| 创建正向问答 | `edit-tree` 新增行 `问题 → 答案` |
+| 创建反向问答 | `edit-tree` 新增行 `问题 ← 答案` |
+| 创建双向问答 | `edit-tree` 新增行 `问题 ↔ 答案` |
+| 创建多行答案 | `edit-tree` 新增行 `问题 ↓`（子行自动成为答案） |
+| 改变闪卡类型/方向 | `edit-rem` 修改 `type`、`backText`、`practiceDirection` |
 
-**CDF（Concept-Descriptor Framework）**：RemNote 推荐的知识结构化方法——`Concept` 是需要理解的概念，`Descriptor` 是概念的属性/描述。典型结构：
+`practiceDirection` 的取值：`forward`（正向）、`backward`（反向）、`both`（双向）、`none`（不练习）。
+
+### 2.5 理解用户意图：编辑器分隔符映射
+
+用户在 RemNote 编辑器中通过分隔符创建闪卡。当用户提到这些分隔符时，理解其意图并映射到上述 CLI 操作：
+
+| 用户说 / 编辑器分隔符 | 对应 type | 对应 practiceDirection |
+|:----------------------|:----------|:----------------------|
+| `::` | concept | both |
+| `;;` | descriptor | forward |
+| `>>` / `<<` / `<>` | default | forward / backward / both |
+| `>>>` / `::>` / `;;>` | default / concept / descriptor | 多行（子 Rem 为答案） |
+| `{{}}` | default | forward（完形填空） |
+
+**CDF（Concept-Descriptor Framework）**：RemNote 推荐的知识结构化方法——`Concept`（type:concept）是需要理解的概念，`Descriptor`（type:descriptor）是概念的属性/描述。在 CLI 大纲中的表现：
 
 ```
-线性回归 :: 最基本的回归模型        ← Concept
-  假设 ;; 因变量与自变量呈线性关系   ← Descriptor
-  损失函数 ;; 均方误差 (MSE)        ← Descriptor
+线性回归 ↔ 最基本的回归模型 <!--id1 type:concept-->
+  假设 → 因变量与自变量呈线性关系 <!--id2 type:descriptor-->
+  损失函数 → 均方误差 (MSE) <!--id3 type:descriptor-->
 ```
 
 ### 2.5 三种链接机制
@@ -170,11 +180,17 @@ RemNote SDK → 知识库
 一次**会话（Session）= 守护进程的生命周期**。
 
 ```
-connect → daemon 启动 → 会话开始
+connect → daemon 启动
+  ↓
+⚠️ 用户在 RemNote 中加载插件（首次填端口，非首次刷新页面）
+  ↓
+health → 确认三层就绪 → 会话可用
   ↕ (业务命令：read-rem, edit-tree, search, ...)
 disconnect → daemon 关闭 → 会话结束，缓存清空
 ```
 
+> **重要**：`connect` 成功只意味着 daemon 已启动，Plugin 并未自动连接。首次使用需用户在 RemNote「开发你的插件」中填入 `http://localhost:8080`；非首次只需刷新 RemNote 页面。必须引导用户完成此步后再用 `health` 确认就绪。
+
 `connect` 启动三个服务：
 
 | 服务 | 默认端口 | 用途 |
@@ -322,18 +338,19 @@ Agent 需要根据用户意图选择正确的读取命令：
 
 ```
 1. connect              ← 启动会话
-2. health               ← 确认系统就绪
-3. read-globe           ← 了解知识库结构（首次探索）
+2. ⚠️ 引导用户在 RemNote 中加载插件（首次填端口，非首次刷新页面）
+3. health               ← 确认系统就绪（daemon → Plugin → SDK 三层全通过）
+4. read-globe           ← 了解知识库结构（首次探索）
    或 read-context      ← 了解用户当前上下文
-4. search "关键词"       ← 定位目标 Rem（中文搜索可能需单字策略，详见 search.md）
-5. read-tree <id>       ← 展开目标区域的子树
-6. read-rem <id>        ← 读取详细属性（编辑前必需）
-7. edit-rem <id> ...    ← 修改 Rem 属性
+5. search "关键词"       ← 定位目标 Rem（中文搜索可能需单字策略，详见 search.md）
+6. read-tree <id>       ← 展开目标区域的子树
+7. read-rem <id>        ← 读取详细属性（编辑前必需）
+8. edit-rem <id> ...    ← 修改 Rem 属性
    或 edit-tree <id> ...← 修改树结构
-8. disconnect           ← 结束会话
+9. disconnect           ← 结束会话
 ```
 
-**注意**：步骤 6 是 `edit-rem` 的强制前置条件，步骤 5 是 `edit-tree` 的强制前置条件。跳过会触发防线 1 错误。
+**注意**：步骤 7 是 `edit-rem` 的强制前置条件，步骤 6 是 `edit-tree` 的强制前置条件。跳过会触发防线 1 错误。步骤 2 是必须的——connect 后不引导用户加载插件就直接调用业务命令，会报"Plugin 未连接"错误。
 
 ---
 

package/dist/cli/commands/connect.d.ts

@@ -1,12 +0,0 @@
-/**
- * connect 命令
- *
- * 启动后台守护进程（WS Server + webpack-dev-server），等待 Plugin 连接。
- * - 已在运行 → 打印提示，退出码 0
- * - stale PID → 清理后正常启动
- * - 启动失败 → 退出码 1
- */
-export interface ConnectOptions {
-    json?: boolean;
-}
-export declare function connectCommand(options?: ConnectOptions): Promise<void>;

package/dist/cli/commands/disconnect.d.ts

@@ -1,11 +0,0 @@
-/**
- * disconnect 命令
- *
- * 停止守护进程，释放端口和资源。
- * - 守护进程运行中 → 发送 SIGTERM，等待退出
- * - 守护进程未运行 → 打印提示，退出码 0
- */
-export interface DisconnectOptions {
-    json?: boolean;
-}
-export declare function disconnectCommand(options?: DisconnectOptions): Promise<void>;

package/dist/cli/commands/edit-rem.d.ts

@@ -1,13 +0,0 @@
-/**
- * edit-rem 命令
- *
- * 通过 str_replace 编辑 Rem 的 JSON 序列化。
- * 三道防线保证安全：缓存存在性、并发检测、精确匹配。
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface EditRemOptions {
-    json?: boolean;
-    oldStr: string;
-    newStr: string;
-}
-export declare function editRemCommand(remId: string, options: EditRemOptions): Promise<void>;

package/dist/cli/commands/edit-tree.d.ts

@@ -1,14 +0,0 @@
-/**
- * edit-tree 命令
- *
- * 通过 str_replace 编辑 Rem 子树结构（行级增/删/移/重排）。
- * - 禁止修改已有行内容（走 edit-rem）
- * - --json 结构化 JSON 输出
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface EditTreeOptions {
-    json?: boolean;
-    oldStr: string;
-    newStr: string;
-}
-export declare function editTreeCommand(remId: string, options: EditTreeOptions): Promise<void>;

package/dist/cli/commands/health.d.ts

@@ -1,12 +0,0 @@
-/**
- * health 命令
- *
- * 检查守护进程、Plugin 连接、SDK 状态，输出 ✅/❌ 列表。
- * - 全部健康 → 退出码 0
- * - 部分不健康 → 退出码 1
- * - 守护进程不可达 → 退出码 2
- */
-export interface HealthOptions {
-    json?: boolean;
-}
-export declare function healthCommand(options?: HealthOptions): Promise<void>;

package/dist/cli/commands/install-skill.d.ts

@@ -1,6 +0,0 @@
-/**
- * install skill 命令
- *
- * 将 SKILL.md 和 docs/instruction/*.md 安装到 ~/.claude/skills/remnote-bridge/
- */
-export declare function installSkillCommand(): Promise<void>;

package/dist/cli/commands/read-context.d.ts

@@ -1,20 +0,0 @@
-/**
- * read-context 命令
- *
- * 读取当前上下文视图。
- * - --mode focus|page（默认 focus）
- * - --ancestor-levels N 向上追溯几层祖先（默认 2，仅 focus 模式）
- * - --depth N 展开深度（默认 3，仅 page 模式）
- * - --max-nodes N 全局节点上限（默认 200）
- * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface ReadContextOptions {
-    json?: boolean;
-    mode?: string;
-    ancestorLevels?: string;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-}
-export declare function readContextCommand(options?: ReadContextOptions): Promise<void>;

package/dist/cli/commands/read-globe.d.ts

@@ -1,16 +0,0 @@
-/**
- * read-globe 命令
- *
- * 读取知识库全局概览（仅 Document 层级）。
- * - --depth N 控制 Document 嵌套深度（默认 -1 无限）
- * - --max-nodes N 全局节点上限（默认 200）
- * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface ReadGlobeOptions {
-    json?: boolean;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-}
-export declare function readGlobeCommand(options?: ReadGlobeOptions): Promise<void>;

package/dist/cli/commands/read-rem.d.ts

@@ -1,16 +0,0 @@
-/**
- * read-rem 命令
- *
- * 读取单个 Rem 的完整 JSON 对象。
- * - 默认输出 [RW] + [R] 字段（34 个）
- * - --full 输出全部 51 个字段（含 [R-F]）
- * - --fields 指定输出字段子集
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface ReadRemOptions {
-    json?: boolean;
-    fields?: string;
-    full?: boolean;
-    includePowerup?: boolean;
-}
-export declare function readRemCommand(remId: string, options?: ReadRemOptions): Promise<void>;

package/dist/cli/commands/read-tree.d.ts

@@ -1,17 +0,0 @@
-/**
- * read-tree 命令
- *
- * 读取 Rem 子树并序列化为带缩进的 Markdown 大纲。
- * - --depth N 控制展开深度（默认 3，-1 = 全部展开）
- * - --json 结构化 JSON 输出
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface ReadTreeOptions {
-    json?: boolean;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-    ancestorLevels?: string;
-    includePowerup?: boolean;
-}
-export declare function readTreeCommand(remId: string, options?: ReadTreeOptions): Promise<void>;

package/dist/cli/commands/search.d.ts

@@ -1,12 +0,0 @@
-/**
- * search 命令
- *
- * 在知识库中按文本搜索 Rem。
- * - --limit N 结果数量上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface SearchOptions {
-    json?: boolean;
-    limit?: string;
-}
-export declare function searchCommand(query: string, options?: SearchOptions): Promise<void>;

package/dist/cli/config.d.ts

@@ -1,55 +0,0 @@
-/**
- * 配置加载
- *
- * 从项目根目录读取 .remnote-bridge.json，合并默认值。
- * 文件不存在时使用全部默认值，不报错。
- */
-export interface DefaultsConfig {
-    maxNodes: number;
-    maxSiblings: number;
-    cacheMaxSize: number;
-    readTreeDepth: number;
-    readTreeAncestorLevels: number;
-    readTreeIncludePowerup: boolean;
-    readGlobeDepth: number;
-    readContextMode: 'focus' | 'page';
-    readContextAncestorLevels: number;
-    readContextDepth: number;
-    searchNumResults: number;
-}
-export declare const DEFAULT_DEFAULTS: Readonly<DefaultsConfig>;
-export interface BridgeConfig {
-    wsPort: number;
-    devServerPort: number;
-    configPort: number;
-    daemonTimeoutMinutes: number;
-    defaults: DefaultsConfig;
-}
-export declare const DEFAULT_CONFIG: Readonly<BridgeConfig>;
-/**
- * 查找项目根目录（monorepo 根：包含 .git 目录的最近祖先）
- *
- * 从 startDir 向上查找 .git 目录，找到即返回。
- * 到达文件系统根仍未找到时回退到 cwd。
- */
-export declare function findProjectRoot(startDir?: string): string;
-/**
- * 加载配置。不存在时返回默认值。
- */
-export declare function loadConfig(projectRoot?: string): BridgeConfig;
-/**
- * 获取配置文件路径
- */
-export declare function configFilePath(projectRoot?: string): string;
-/**
- * 原子写入配置文件（写临时文件 → rename）
- */
-export declare function saveConfig(filePath: string, config: BridgeConfig): void;
-/**
- * PID 文件路径
- */
-export declare function pidFilePath(projectRoot?: string): string;
-/**
- * 日志文件路径
- */
-export declare function logFilePath(projectRoot?: string): string;

package/dist/cli/daemon/daemon.d.ts

@@ -1,11 +0,0 @@
-/**
- * 守护进程主逻辑
- *
- * 作为 fork 子进程运行：
- * 1. 启动 WS Server
- * 2. 启动 webpack-dev-server 子进程
- * 3. 写入 PID 文件
- * 4. 管理自动超时关闭
- * 5. 通过 IPC 向父进程发送 ready 信号
- */
-export {};

package/dist/cli/daemon/dev-server.d.ts

@@ -1,26 +0,0 @@
-/**
- * webpack-dev-server 子进程管理
- *
- * 在 remnote-plugin 目录下启动 npm run dev。
- */
-export interface DevServerOptions {
-    pluginDir: string;
-    port: number;
-    onLog?: (message: string, level: 'info' | 'warn' | 'error') => void;
-    onExit?: (code: number | null) => void;
-}
-export declare class DevServerManager {
-    private child;
-    private options;
-    constructor(options: DevServerOptions);
-    /**
-     * 启动 webpack-dev-server。
-     * 如果 remnote-plugin 目录不存在，抛出错误。
-     */
-    start(): void;
-    /**
-     * 停止 webpack-dev-server。
-     */
-    stop(): Promise<void>;
-    isRunning(): boolean;
-}

package/dist/cli/daemon/pid.d.ts

@@ -1,34 +0,0 @@
-/**
- * PID 文件管理
- *
- * 写入、读取、stale 检测、清理。
- */
-/**
- * 写入 PID 文件
- */
-export declare function writePid(filePath: string, pid: number): void;
-/**
- * 读取 PID 文件。文件不存在返回 null。
- */
-export declare function readPid(filePath: string): number | null;
-/**
- * 删除 PID 文件
- */
-export declare function removePid(filePath: string): void;
-/**
- * 检查进程是否存活
- */
-export declare function isProcessAlive(pid: number): boolean;
-/**
- * 检查守护进程状态。返回：
- * - { running: true, pid } — 守护进程正在运行
- * - { running: false } — 守护进程未运行（无 PID 文件或 stale）
- *
- * 若 PID 文件存在但进程已死（stale），自动清理 PID 文件。
- */
-export declare function checkDaemon(pidPath: string): {
-    running: true;
-    pid: number;
-} | {
-    running: false;
-};

package/dist/cli/daemon/send-request.d.ts

@@ -1,24 +0,0 @@
-/**
- * Daemon 通信工具 — CLI 命令向守护进程发送请求的通用方法
- *
- * 封装 WS 连接建立、请求发送、响应等待、超时处理的完整流程。
- * 所有业务命令（health、read-rem、edit-rem 等）均通过此函数与 daemon 通信。
- */
-export declare class DaemonNotRunningError extends Error {
-    constructor();
-}
-export declare class DaemonUnreachableError extends Error {
-    constructor(cause: string);
-}
-/**
- * 向守护进程发送请求并等待响应。
- *
- * 流程：读取 PID 文件 → 建立 WS 连接 → 发送 BridgeRequest → 等待 BridgeResponse → 关闭连接
- *
- * @throws DaemonNotRunningError — PID 文件不存在或进程已死
- * @throws DaemonUnreachableError — WS 连接失败
- * @throws Error — daemon 返回 error 字段或响应超时
- */
-export declare function sendDaemonRequest(action: string, payload?: Record<string, unknown>, options?: {
-    timeout?: number;
-}): Promise<unknown>;

package/dist/cli/handlers/context-read-handler.d.ts

@@ -1,18 +0,0 @@
-/**
- * ContextReadHandler — read-context 请求的业务编排
- *
- * 职责：转发到 Plugin 获取上下文视图，返回结果。
- */
-import type { DefaultsConfig } from '../config.js';
-export interface ContextReadResult {
-    nodeCount: number;
-    outline: string;
-    breadcrumb: string[];
-    mode: 'focus' | 'page';
-}
-export declare class ContextReadHandler {
-    private forwardToPlugin;
-    private defaults;
-    constructor(forwardToPlugin: (action: string, payload: Record<string, unknown>) => Promise<unknown>, defaults?: DefaultsConfig);
-    handleReadContext(payload: Record<string, unknown>): Promise<ContextReadResult>;
-}