remnote-bridge 0.1.7 → 0.1.8

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

@@ -1,18 +1,38 @@
 /**
- * 基础设施工具：connect、disconnect、health
+ * 基础设施工具：setup、connect、disconnect、health
  */
 import { z } from 'zod';
 import { callCli } from '../daemon-client.js';
 export function registerInfraTools(server) {
     // -------------------------------------------------------------------------
-    // connect
+    // setup
     // -------------------------------------------------------------------------
     server.addTool({
-        name: 'connect',
-        description: '启动守护进程（daemon），建立 CLI 与 RemNote Plugin 之间的通信通道。这是所有业务命令（read_rem、edit_rem、search 等）的前置步骤。\n\n适用场景：\n- 开始一次 RemNote 操作会话前，必须先调用此工具\n- 不确定 daemon 是否在运行时，也可安全调用（幂等）\n\n输出：返回 JSON，关键字段 ok、alreadyRunning（是否已运行）、pid、wsPort。\n幂等：重复调用不会启动多个 daemon。daemon 默认 30 分钟无活动自动关闭。\n关联工具：disconnect（结束会话）、health（检查状态）',
+        name: 'setup',
+        description: '启动 Chrome 浏览器让用户登录 RemNote，保存登录凭证到本地 profile。这是使用 headless 模式（connect --headless）的前置步骤。\n\n调用后 Chrome 窗口会弹出，你需要立即告知用户："已打开 Chrome，请在浏览器中登录 RemNote，并在 RemNote 中配置 dev plugin URL（http://localhost:8080），完成后用 Cmd+Q（macOS）或关闭窗口彻底退出 Chrome"。此工具会阻塞等待用户关闭 Chrome 后返回结果。\n\n幂等：已完成 setup 后重复调用返回 alreadyDone: true。\n超时：600 秒（用户可能需要较长时间完成登录、2FA 验证等）。\n前置条件：需要桌面环境（GUI），无 GUI 环境会报错。\n关联工具：connect（启动会话，传 headless 参数实现无人值守连接）',
         parameters: z.object({}),
         execute: async () => {
-            const response = await callCli('connect');
+            const response = await callCli('setup', undefined, { timeoutMs: 600_000 });
+            return JSON.stringify(response, null, 2);
+        },
+    });
+    // -------------------------------------------------------------------------
+    // connect
+    // -------------------------------------------------------------------------
+    server.addTool({
+        name: 'connect',
+        description: '启动守护进程（daemon），建立 CLI 与 RemNote Plugin 之间的通信通道。这是所有业务命令（read_rem、edit_rem、search 等）的前置步骤。\n\n适用场景：\n- 开始一次 RemNote 操作会话前，必须先调用此工具\n- 不确定 daemon 是否在运行时，也可安全调用（幂等）\n\n两种模式：\n- 标准模式（默认）：启动 daemon 后需要用户在 RemNote 中手动加载 Plugin\n- Headless 模式（headless=true）：自动启动 headless Chrome 加载 Plugin，无需用户操作。需先完成 setup（保存登录凭证）\n\n输出：返回 JSON，关键字段 ok、alreadyRunning（是否已运行）、pid、wsPort、headless。\n幂等：重复调用不会启动多个 daemon。daemon 默认 30 分钟无活动自动关闭。\n关联工具：setup（headless 前置）、disconnect（结束会话）、health（检查状态）',
+        parameters: z.object({
+            headless: z.boolean().optional().describe('启用 headless 模式：自动启动 Chrome 加载 Plugin（需先 setup）'),
+        }),
+        execute: async (args) => {
+            const flags = [];
+            if (args.headless)
+                flags.push('--headless');
+            const response = await callCli('connect', undefined, {
+                timeoutMs: 90_000,
+                flags: flags.length > 0 ? flags : undefined,
+            });
             return JSON.stringify(response, null, 2);
         },
     });
@@ -33,10 +53,20 @@ export function registerInfraTools(server) {
     // -------------------------------------------------------------------------
     server.addTool({
         name: 'health',
-        description: '检查系统三层状态（daemon 守护进程 / Plugin 连接 / SDK 就绪），用于诊断连接问题。\n\n适用场景：\n- 业务命令失败时，首先调用 health 定位故障层级\n- 执行 connect 后确认通道是否完全就绪\n- 长时间未操作后，检查 daemon 是否仍在运行\n\n输出：返回 JSON，关键字段 ok（三层是否全部健康）、daemon.running、plugin.connected、sdk.ready、timeoutRemaining。\n三层有严格依赖：daemon 运行 → Plugin 连接 → SDK 就绪。\nok 为 false 时：daemon 未运行则 connect；Plugin 未连接则确认 RemNote 已打开；SDK 未就绪则等待重试。\n只读不写，不改变任何状态。\n关联工具：connect（启动）、disconnect（结束）',
-        parameters: z.object({}),
-        execute: async () => {
-            const response = await callCli('health');
+        description: '检查系统三层状态（daemon 守护进程 / Plugin 连接 / SDK 就绪），用于诊断连接问题。\n\n适用场景：\n- 业务命令失败时，首先调用 health 定位故障层级\n- 执行 connect 后确认通道是否完全就绪\n- 长时间未操作后，检查 daemon 是否仍在运行\n\n输出：返回 JSON，关键字段 ok（三层是否全部健康）、daemon.running、plugin.connected、sdk.ready、timeoutRemaining。headless 模式下额外包含 headless 对象。\n三层有严格依赖：daemon 运行 → Plugin 连接 → SDK 就绪。\nok 为 false 时：daemon 未运行则 connect；Plugin 未连接则确认 RemNote 已打开（或使用 headless 模式）；SDK 未就绪则等待重试。\n\n--diagnose 模式（headless 专用）：截图 + 详细状态 + console 错误 + 排查建议。\n--reload 模式（headless 专用）：重载 headless Chrome 页面。\n\n只读不写，不改变任何状态（--reload 除外）。\n关联工具：connect（启动）、disconnect（结束）',
+        parameters: z.object({
+            diagnose: z.boolean().optional().describe('诊断 headless Chrome（截图 + 状态 + console 错误）'),
+            reload: z.boolean().optional().describe('重载 headless Chrome 页面'),
+        }),
+        execute: async (args) => {
+            const flags = [];
+            if (args.diagnose)
+                flags.push('--diagnose');
+            if (args.reload)
+                flags.push('--reload');
+            const response = await callCli('health', undefined, {
+                flags: flags.length > 0 ? flags : undefined,
+            });
             return JSON.stringify(response, null, 2);
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remnote-bridge",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "RemNote 自动化桥接工具集：CLI + MCP Server + Plugin",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist/**/*.js",
+    "remnote-plugin/dist/",
     "remnote-plugin/src/bridge/",
     "remnote-plugin/src/services/",
     "remnote-plugin/src/utils/",
@@ -27,12 +28,15 @@
   ],
   "scripts": {
     "build": "tsc",
+    "build:plugin": "cd remnote-plugin && npm install && npm run build",
+    "prepublishOnly": "npm run build && npm run build:plugin",
     "dev": "tsx src/cli/main.ts",
     "test": "vitest run",
     "lint:deps": "node scripts/check-layer-deps.cjs"
   },
   "dependencies": {
     "commander": "^12.1.0",
+    "puppeteer-core": "^24.0.0",
     "ws": "^8.16.0",
     "fastmcp": "latest",
     "zod": "^3.23.0"

package/remnote-plugin/dist/bridge-icon.svg

@@ -0,0 +1,8 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Bidirectional arrows -->
+  <path d="M3 8 L9 8 M7 6 L9 8 L7 10" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+  <path d="M21 8 L15 8 M17 6 L15 8 L17 10" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+
+  <!-- MCP text -->
+  <text x="12" y="19" text-anchor="middle" font-size="7" fill="currentColor" font-weight="700" font-family="system-ui, -apple-system, sans-serif">MCP</text>
+</svg>