remnote-bridge 0.1.10 → 0.1.11

package/dist/cli/commands/read-context.js

@@ -7,6 +7,7 @@
  * - --depth N 展开深度（默认 3，仅 page 模式）
  * - --max-nodes N 全局节点上限（默认 200）
  * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
+ * - --focus-rem-id <remId> 指定鱼眼中心 Rem ID（仅 focus 模式，默认使用当前焦点）
  * - --json 结构化 JSON 输出
  */
 import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
@@ -42,9 +43,10 @@ export async function readContextCommand(options = {}) {
     }
     let result;
     try {
-        result = await sendDaemonRequest('read_context', {
-            mode, ancestorLevels, depth, maxNodes, maxSiblings,
-        });
+        const reqPayload = { mode, ancestorLevels, depth, maxNodes, maxSiblings };
+        if (options.focusRemId)
+            reqPayload.focusRemId = options.focusRemId;
+        result = await sendDaemonRequest('read_context', reqPayload);
     }
     catch (err) {
         if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {

package/dist/cli/handlers/context-read-handler.js

@@ -17,8 +17,10 @@ export class ContextReadHandler {
         const depth = payload.depth ?? this.defaults.readContextDepth;
         const maxNodes = payload.maxNodes ?? this.defaults.maxNodes;
         const maxSiblings = payload.maxSiblings ?? this.defaults.maxSiblings;
-        return await this.forwardToPlugin('read_context', {
-            mode, ancestorLevels, depth, maxNodes, maxSiblings,
-        });
+        const focusRemId = payload.focusRemId;
+        const pluginPayload = { mode, ancestorLevels, depth, maxNodes, maxSiblings };
+        if (focusRemId)
+            pluginPayload.focusRemId = focusRemId;
+        return await this.forwardToPlugin('read_context', pluginPayload);
     }
 }

package/dist/cli/main.js

@@ -187,6 +187,7 @@ program
     .option('--depth <depth>', '展开深度（默认 3，仅 page 模式）')
     .option('--max-nodes <maxNodes>', '全局节点上限（默认 200）')
     .option('--max-siblings <maxSiblings>', '每个父节点下展示的 children 上限（默认 20）')
+    .option('--focus-rem-id <remId>', '指定鱼眼中心 Rem ID（仅 focus 模式，默认使用当前焦点）')
     .action(async (jsonStr, cmdOpts) => {
     const { json } = program.opts();
     if (json) {
@@ -208,6 +209,7 @@ program
             depth: input.depth?.toString(),
             maxNodes: input.maxNodes?.toString(),
             maxSiblings: input.maxSiblings?.toString(),
+            focusRemId: input.focusRemId ? String(input.focusRemId) : undefined,
         });
     }
     else {

package/dist/mcp/instructions.js

@@ -210,7 +210,7 @@ disconnect → 关闭 daemon + headless Chrome，清空所有缓存
 先用 \\\`read_context\\\` 看到用户所看到的，再做决策，沟通才能顺畅。
 
 使用 \\\`read_context\\\`：
-- **focus 模式**（默认）：以用户当前光标所在的 Rem 为中心，构建鱼眼视图——焦点处完全展开，周围递减。焦点行以 \\\`* \\\` 前缀标记。需要用户在 RemNote 中已点击某个 Rem。
+- **focus 模式**（默认）：以用户当前光标所在的 Rem 为中心，构建鱼眼视图——焦点处完全展开，周围递减。焦点行以 \\\`* \\\` 前缀标记。需要用户在 RemNote 中已点击某个 Rem。可通过 \\\`focusRemId\\\` 指定任意 Rem 作为鱼眼中心，此时不依赖用户焦点。
 - **page 模式**：以当前打开的页面为根，均匀展开子树。
 
 两种模式都会返回面包屑路径，帮助你理解当前位置在知识库中的层级。
@@ -404,6 +404,7 @@ newStr:   最后一个兄弟 <!--idZ-->
 | orphan_detected | 删了父行但保留了子行 | 同时删除所有子行 |
 | folded_delete | 删除有隐藏子节点的行 | 用更大 depth 重新 read_tree |
 | children_captured | 新行插在父 Rem 和它的 children 之间，劫持了已有子节点 | 把新行插到所有兄弟的**末尾**而非紧跟父 Rem 之后（见下方说明） |
+| focusRemId 仅在 focus 模式下有效 | page 模式下不应传 focusRemId | 去掉 focusRemId 参数，或改用 focus 模式 |
 
 完整错误参考见 \\\`resource://error-reference\\\`。
 `;

package/dist/mcp/resources/error-reference.js

@@ -78,7 +78,9 @@ export const ERROR_REFERENCE_CONTENT = `
 | 错误信息 | 触发命令 | 原因 | 恢复操作 |
 |:---------|:---------|:-----|:---------|
 | Rem not found: {remId} | read_rem / read_tree | remId 无效或 Rem 已被删除 | 使用 \\\`search\\\` 重新定位 |
-| 无法获取当前聚焦的 Rem | read_context (focus) | 用户未在 RemNote 中点击任何 Rem | 提醒用户在 RemNote 中点击一个 Rem |
+| 指定的 Rem 不存在: {remId} | read_context (focus + focusRemId) | focusRemId 无效或 Rem 已被删除 | 使用 \\\`search\\\` 重新定位 |
+| focusRemId 仅在 focus 模式下有效 | read_context (page + focusRemId) | page 模式下不应传 focusRemId | 去掉 focusRemId 参数，或改用 focus 模式 |
+| 无法获取当前聚焦的 Rem | read_context (focus) | 用户未在 RemNote 中点击任何 Rem（且未指定 focusRemId） | 提醒用户在 RemNote 中点击一个 Rem，或传入 focusRemId |
 | 无法获取当前页面 | read_context (page) | RemNote 未打开文档页面 | 提醒用户打开一个文档页面 |
 
 ---

package/dist/mcp/tools/read-tools.js

@@ -149,7 +149,7 @@ export function registerReadTools(server) {
     // -------------------------------------------------------------------------
     server.addTool({
         name: 'read_context',
-        description: '读取用户在 RemNote 中的当前上下文视图，生成带面包屑路径的 Markdown 大纲。\n无需指定 remId，自动获取用户当前焦点位置或打开的页面。\n\n适用场景：\n- 用户说"我现在在看什么"、"当前页面是什么"\n- 需要了解用户焦点位置以提供上下文帮助\n- 不适合查看特定 Rem（已知 remId 用 read_tree）\n\n两种模式：\n- focus（默认）：以焦点 Rem 为中心的鱼眼视图。焦点完全展开（depth=3），siblings 浅层预览（depth=1），叔伯不展开。焦点行以 * 前缀标记。\n- page：以当前页面为根均匀展开子树。\n\n输出：Markdown 大纲 + 面包屑路径。不缓存。\n前提：focus 模式需用户有焦点 Rem，page 模式需有打开的页面。\n典型工作流：read_context 了解位置 → read_tree/read_rem 深入。',
+        description: '读取用户在 RemNote 中的当前上下文视图，生成带面包屑路径的 Markdown 大纲。\n无需指定 remId，自动获取用户当前焦点位置或打开的页面。\n\n适用场景：\n- 用户说"我现在在看什么"、"当前页面是什么"\n- 需要了解用户焦点位置以提供上下文帮助\n- 不适合查看特定 Rem（已知 remId 用 read_tree）\n\n两种模式：\n- focus（默认）：以焦点 Rem 为中心的鱼眼视图。焦点完全展开（depth=3），siblings 浅层预览（depth=1），叔伯不展开。焦点行以 * 前缀标记。可通过 focusRemId 指定任意 Rem 作为鱼眼中心，此时不依赖用户焦点。\n- page：以当前页面为根均匀展开子树。\n\n输出：Markdown 大纲 + 面包屑路径。不缓存。\n前提：focus 模式需用户有焦点 Rem 或指定 focusRemId，page 模式需有打开的页面。\n典型工作流：read_context 了解位置 → read_tree/read_rem 深入。',
         parameters: z.object({
             mode: z
                 .enum(['focus', 'page'])
@@ -171,6 +171,10 @@ export function registerReadTools(server) {
                 .number()
                 .optional()
                 .describe('同级节点显示上限'),
+            focusRemId: z
+                .string()
+                .optional()
+                .describe('指定鱼眼中心 Rem ID（仅 focus 模式，默认使用当前焦点）'),
         }),
         execute: async (args) => {
             const payload = {};
@@ -184,6 +188,8 @@ export function registerReadTools(server) {
                 payload.maxNodes = args.maxNodes;
             if (args.maxSiblings !== undefined)
                 payload.maxSiblings = args.maxSiblings;
+            if (args.focusRemId !== undefined)
+                payload.focusRemId = args.focusRemId;
             const response = await callCli('read-context', payload);
             const data = response.data;
             if (data?.outline && typeof data.outline === 'string') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remnote-bridge",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "RemNote 自动化桥接工具集：CLI + MCP Server + Plugin",
   "type": "module",
   "bin": {