remnote-bridge 0.1.7 → 0.1.9

package/README.md

@@ -43,12 +43,34 @@ Once connected, the AI will guide you through connecting to RemNote, loading the
 
 ## Quick Start
 
+### Headless Mode (recommended for AI agents)
+
+Zero human intervention after initial setup — ideal for automated workflows.
+
+```bash
+# 1. One-time: login to RemNote in Chrome (saves credentials)
+remnote-bridge setup
+
+# 2. Auto-connect with headless Chrome (no browser window needed)
+remnote-bridge connect --headless
+
+# 3. Verify all layers are ready
+remnote-bridge health
+
+# 4. Use any command — done!
+remnote-bridge search "machine learning"
+```
+
+### Standard Mode
+
+Requires user to manually load the plugin in RemNote.
+
 ```bash
-# 1. Start the daemon (launches WS server + plugin dev server)
+# 1. Start the daemon (launches WS server + plugin server)
 remnote-bridge connect
 
 # 2. Load the plugin in RemNote
-#    Open RemNote → Settings → Plugins → Add Local Plugin
+#    Open RemNote → Plugins → Develop Your Plugin
 #    Enter: http://localhost:8080
 
 # 3. Check system status
@@ -75,8 +97,9 @@ remnote-bridge disconnect
 
 | Command | Description |
 |:--------|:------------|
-| `connect` | Start the daemon process (WS server + plugin dev server) |
-| `health` | Check daemon, Plugin, and SDK status |
+| `setup` | Launch Chrome for RemNote login, save credentials for headless mode |
+| `connect` | Start the daemon (`--headless` for auto Chrome, default requires manual plugin load) |
+| `health` | Check daemon/Plugin/SDK status (`--diagnose` for screenshots, `--reload` to restart Chrome) |
 | `disconnect` | Stop the daemon and release resources |
 
 ### Read
@@ -182,14 +205,15 @@ remnote-bridge CLI
     ↕  WebSocket IPC
 Daemon (long-lived process: WS server + handlers + cache)
     ↕  WebSocket
-remnote-plugin (runs inside RemNote browser)
+remnote-plugin (runs inside RemNote browser or headless Chrome)
     ↕
 RemNote SDK → Knowledge Base
 ```
 
 - **CLI commands** are stateless — each invocation is an independent OS process
 - **Daemon** holds state: cache, WS connections, timeout timer
-- **Plugin** runs in the browser, calls RemNote SDK on behalf of the daemon
+- **Plugin** runs in the browser (or headless Chrome), calls RemNote SDK on behalf of the daemon
+- **Headless mode** launches Chrome automatically using saved credentials — no browser window needed
 - **Three safety guards** protect edits: cache existence check, optimistic concurrency detection, str_replace exact match
 
 ## Configuration

package/dist/cli/commands/connect.js

@@ -1,16 +1,20 @@
 /**
  * connect 命令
  *
- * 启动后台守护进程（WS Server + webpack-dev-server），等待 Plugin 连接。
+ * 启动后台守护进程（WS Server + Plugin 服务），等待 Plugin 连接。
  * - 已在运行 → 打印提示，退出码 0
  * - stale PID → 清理后正常启动
  * - 启动失败 → 退出码 1
+ *
+ * 默认使用静态文件服务器 serve 预构建 plugin。
+ * --dev 模式使用 webpack-dev-server（支持 HMR）。
  */
 import path from 'path';
 import fs from 'fs';
 import { fork } from 'child_process';
 import { loadConfig, pidFilePath, findProjectRoot } from '../config.js';
 import { checkDaemon } from '../daemon/pid.js';
+import { getSetupDonePath } from '../daemon/headless-browser.js';
 import { jsonOutput } from '../utils/output.js';
 function isDaemonMessage(msg) {
     return (typeof msg === 'object' &&
@@ -22,6 +26,21 @@ export async function connectCommand(options = {}) {
     const projectRoot = findProjectRoot();
     const config = loadConfig(projectRoot);
     const pidPath = pidFilePath(projectRoot);
+    // headless 前置检查
+    if (options.headless) {
+        const setupDonePath = getSetupDonePath();
+        if (!fs.existsSync(setupDonePath)) {
+            const error = '尚未完成 setup。请先执行 `remnote-bridge setup` 登录 RemNote，然后再使用 --headless';
+            if (json) {
+                jsonOutput({ ok: false, command: 'connect', error });
+            }
+            else {
+                console.error(error);
+            }
+            process.exitCode = 1;
+            return;
+        }
+    }
     // 检查是否已在运行
     const status = checkDaemon(pidPath);
     if (status.running) {
@@ -59,6 +78,12 @@ export async function connectCommand(options = {}) {
         stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
         cwd: projectRoot,
         execArgv,
+        env: {
+            ...process.env,
+            REMNOTE_BRIDGE_DEV: options.dev ? '1' : '0',
+            ...(options.headless ? { REMNOTE_HEADLESS: '1' } : {}),
+            ...(options.remoteDebuggingPort ? { REMNOTE_HEADLESS_REMOTE_PORT: String(options.remoteDebuggingPort) } : {}),
+        },
     });
     // 等待就绪信号，超时 60 秒
     // 首次启动可能需要安装 remnote-plugin 依赖（npm install），在 Windows 上可能需要较长时间
@@ -112,13 +137,17 @@ export async function connectCommand(options = {}) {
             pid: ready.pid, wsPort: ready.wsPort, devServerPort: ready.devServerPort,
             configPort: ready.configPort,
             timeoutMinutes: config.daemonTimeoutMinutes,
+            headless: ready.headless ?? false,
         });
     }
     else {
         console.log(`守护进程已启动（PID: ${ready.pid}）`);
         console.log(`  WS Server:         ws://127.0.0.1:${ready.wsPort}`);
-        console.log(`  webpack-dev-server: http://localhost:${ready.devServerPort}`);
+        console.log(`  Plugin 服务:       http://localhost:${ready.devServerPort}`);
         console.log(`  配置页面:          http://127.0.0.1:${ready.configPort}`);
+        if (ready.headless) {
+            console.log(`  Headless Chrome:   已启动（自动加载 Plugin）`);
+        }
         console.log(`  超时: ${config.daemonTimeoutMinutes} 分钟无 CLI 交互后自动关闭`);
     }
     process.exitCode = 0;

package/dist/cli/commands/health.js

@@ -11,7 +11,19 @@ import { checkDaemon } from '../daemon/pid.js';
 import { sendDaemonRequest } from '../daemon/send-request.js';
 import { jsonOutput } from '../utils/output.js';
 export async function healthCommand(options = {}) {
-    const { json } = options;
+    const { json, diagnose, reload } = options;
+    // --diagnose 和 --reload 不能同时使用
+    if (diagnose && reload) {
+        const error = '--diagnose 和 --reload 不能同时使用';
+        if (json) {
+            jsonOutput({ ok: false, command: 'health', error });
+        }
+        else {
+            console.error(error);
+        }
+        process.exitCode = 1;
+        return;
+    }
     const projectRoot = findProjectRoot();
     const pidPath = pidFilePath(projectRoot);
     // 先检查 PID 文件
@@ -34,6 +46,97 @@ export async function healthCommand(options = {}) {
         process.exitCode = 2;
         return;
     }
+    // --diagnose 模式
+    if (diagnose) {
+        try {
+            const result = await sendDaemonRequest('diagnose');
+            if (!result) {
+                const error = '非 headless 模式，不支持 --diagnose';
+                if (json) {
+                    jsonOutput({ ok: false, command: 'health', error });
+                }
+                else {
+                    console.error(error);
+                }
+                process.exitCode = 1;
+                return;
+            }
+            if (json) {
+                jsonOutput({ ok: true, command: 'health', mode: 'diagnose', ...result });
+            }
+            else {
+                console.log('=== Headless Chrome 诊断 ===');
+                console.log(`状态: ${result.headless.status}`);
+                console.log(`Chrome 连接: ${result.headless.chromeConnected ? '是' : '否'}`);
+                console.log(`页面 URL: ${result.headless.pageUrl ?? '无'}`);
+                console.log(`重载次数: ${result.headless.reloadCount}`);
+                console.log(`Plugin 连接: ${result.pluginConnected ? '是' : '否'}`);
+                console.log(`SDK 就绪: ${result.sdkReady ? '是' : '否'}`);
+                if (result.screenshotPath) {
+                    console.log(`截图: ${result.screenshotPath}`);
+                }
+                if (result.headless.lastError) {
+                    console.log(`\n最近错误: ${result.headless.lastError}`);
+                }
+                if (result.headless.recentConsoleErrors.length > 0) {
+                    console.log('\nConsole 错误:');
+                    for (const err of result.headless.recentConsoleErrors) {
+                        console.log(`  ${err}`);
+                    }
+                }
+                // 排查建议
+                if (!result.headless.chromeConnected) {
+                    console.log('\n排查建议: Chrome 已断开，尝试 `health --reload` 重载');
+                }
+                else if (!result.pluginConnected) {
+                    console.log('\n排查建议: Chrome 运行中但 Plugin 未连接，可能页面加载异常，尝试 `health --reload`');
+                }
+                else if (!result.sdkReady) {
+                    console.log('\n排查建议: Plugin 已连接但 SDK 未就绪，等待几秒后重试');
+                }
+            }
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            if (json) {
+                jsonOutput({ ok: false, command: 'health', error: errorMsg });
+            }
+            else {
+                console.error(`诊断失败: ${errorMsg}`);
+            }
+            process.exitCode = 1;
+        }
+        return;
+    }
+    // --reload 模式
+    if (reload) {
+        try {
+            const result = await sendDaemonRequest('headless_reload');
+            if (json) {
+                jsonOutput({ ok: result.ok, command: 'health', mode: 'reload', error: result.error });
+            }
+            else {
+                if (result.ok) {
+                    console.log('Headless Chrome 页面已重载');
+                }
+                else {
+                    console.error(`重载失败: ${result.error}`);
+                }
+            }
+            process.exitCode = result.ok ? 0 : 1;
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            if (json) {
+                jsonOutput({ ok: false, command: 'health', mode: 'reload', error: errorMsg });
+            }
+            else {
+                console.error(`重载失败: ${errorMsg}`);
+            }
+            process.exitCode = 1;
+        }
+        return;
+    }
     // 通过 WS 连接守护进程获取状态
     let status;
     try {
@@ -69,6 +172,7 @@ export async function healthCommand(options = {}) {
             plugin: { connected: status.pluginConnected },
             sdk: { ready: status.sdkReady },
             timeoutRemaining: status.timeoutRemaining,
+            ...(status.headless ? { headless: status.headless } : {}),
         });
     }
     else {
@@ -85,6 +189,12 @@ export async function healthCommand(options = {}) {
         else {
             console.log('❌ SDK       未就绪');
         }
+        // Headless Chrome 状态行
+        if (status.headless) {
+            const h = status.headless;
+            const icon = h.status === 'running' ? '✅' : '❌';
+            console.log(`${icon} Chrome     ${h.status}${h.lastError ? ` (${h.lastError})` : ''}`);
+        }
         console.log(`\n超时: ${formatUptime(status.timeoutRemaining)} 后自动关闭`);
     }
     process.exitCode = exitCode;

package/dist/cli/commands/setup.js

@@ -0,0 +1,112 @@
+/**
+ * setup 命令
+ *
+ * 启动有界面的 Chrome（使用共享 profile 目录），让用户登录 RemNote。
+ * 登录完成后关闭 Chrome，写入 .setup-done 标记。
+ * 后续 connect --headless 使用相同 profile 实现免登录。
+ */
+import fs from 'fs';
+import { spawn } from 'child_process';
+import { findChromePath, hasDisplay, getDefaultProfileDir, getSetupDonePath, } from '../daemon/headless-browser.js';
+import { jsonOutput } from '../utils/output.js';
+export async function setupCommand(options = {}) {
+    const { json } = options;
+    const profileDir = getDefaultProfileDir();
+    const setupDonePath = getSetupDonePath();
+    // 检查桌面环境
+    if (!hasDisplay()) {
+        const error = '未检测到桌面环境（无 DISPLAY/WAYLAND_DISPLAY），setup 需要 GUI 才能登录';
+        if (json) {
+            jsonOutput({ ok: false, command: 'setup', error });
+        }
+        else {
+            console.error(error);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // 检查 Chrome
+    const chromePath = findChromePath();
+    if (!chromePath) {
+        const error = '未找到 Chrome/Chromium，请安装后重试';
+        if (json) {
+            jsonOutput({ ok: false, command: 'setup', error });
+        }
+        else {
+            console.error(error);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // 检查是否已完成 setup
+    if (fs.existsSync(setupDonePath)) {
+        if (json) {
+            jsonOutput({ ok: true, command: 'setup', profileDir, alreadyDone: true });
+        }
+        else {
+            console.log(`已完成 setup（profile: ${profileDir}）`);
+            console.log('如需重新登录，请删除以下文件后重试：');
+            console.log(`  ${setupDonePath}`);
+        }
+        process.exitCode = 0;
+        return;
+    }
+    // 确保 profile 目录存在
+    fs.mkdirSync(profileDir, { recursive: true });
+    if (!json) {
+        console.log('正在启动 Chrome...');
+        console.log('请在浏览器中登录 RemNote，完成后关闭浏览器窗口。');
+    }
+    // 启动 Chrome（非 headless，用户可见）
+    const child = spawn(chromePath, [
+        `--user-data-dir=${profileDir}`,
+        '--no-first-run',
+        '--no-default-browser-check',
+        'https://www.remnote.com',
+    ], {
+        stdio: 'ignore',
+        detached: false,
+    });
+    // 等待 Chrome 退出（超时 10 分钟）
+    const exitCode = await new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            child.kill();
+            resolve(null);
+        }, 600_000);
+        child.on('exit', (code) => {
+            clearTimeout(timeout);
+            resolve(code);
+        });
+        child.on('error', (err) => {
+            clearTimeout(timeout);
+            resolve(-1);
+        });
+    });
+    if (exitCode === null) {
+        const error = 'Chrome 未在 10 分钟内关闭，setup 超时';
+        if (json) {
+            jsonOutput({ ok: false, command: 'setup', error });
+        }
+        else {
+            console.error(error);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // 写入 .setup-done 标记
+    const doneData = {
+        completedAt: new Date().toISOString(),
+        chromePath,
+        profileDir,
+    };
+    fs.writeFileSync(setupDonePath, JSON.stringify(doneData, null, 2));
+    if (json) {
+        jsonOutput({ ok: true, command: 'setup', profileDir, alreadyDone: false });
+    }
+    else {
+        console.log('setup 完成！');
+        console.log(`  profile 目录: ${profileDir}`);
+        console.log('现在可以使用 `remnote-bridge connect --headless` 启动无头连接。');
+    }
+    process.exitCode = 0;
+}

package/dist/cli/daemon/daemon.js

@@ -3,7 +3,7 @@
  *
  * 作为 fork 子进程运行：
  * 1. 启动 WS Server
- * 2. 启动 webpack-dev-server 子进程
+ * 2. 启动 Plugin 服务（静态文件服务器 或 webpack-dev-server）
  * 3. 写入 PID 文件
  * 4. 管理自动超时关闭
  * 5. 通过 IPC 向父进程发送 ready 信号
@@ -13,6 +13,8 @@ import fs from 'fs';
 import { BridgeServer } from '../server/ws-server.js';
 import { ConfigServer } from '../server/config-server.js';
 import { DevServerManager } from './dev-server.js';
+import { StaticServer } from './static-server.js';
+import { HeadlessBrowserManager } from './headless-browser.js';
 import { writePid, removePid } from './pid.js';
 import { loadConfig, pidFilePath, logFilePath, findProjectRoot } from '../config.js';
 let shutdownInProgress = false;
@@ -53,6 +55,31 @@ async function main() {
             onLog: log,
             getTimeoutRemaining,
             defaults: cfg.defaults,
+            // Headless Chrome 回调（闭包引用 headlessBrowser，调用时读取最新值）
+            getHeadlessStatus: () => headlessBrowser?.getDiagnostics() ?? null,
+            diagnoseHeadless: async () => {
+                if (!headlessBrowser)
+                    return null;
+                const diag = headlessBrowser.getDiagnostics();
+                const screenshotPath = await headlessBrowser.takeScreenshot();
+                return {
+                    headless: diag,
+                    screenshotPath,
+                    pluginConnected: false, // 由 ws-server 填充
+                    sdkReady: false, // 由 ws-server 填充
+                };
+            },
+            reloadHeadless: async () => {
+                if (!headlessBrowser)
+                    return { ok: false, error: '非 headless 模式' };
+                try {
+                    await headlessBrowser.manualReload();
+                    return { ok: true };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
         });
         srv.onCliRequest = () => resetTimeout();
         return srv;
@@ -84,27 +111,60 @@ async function main() {
         onRestart: reload,
         onLog: log,
     });
-    // 启动 webpack-dev-server
+    // 启动 Plugin 服务（静态文件服务器 或 webpack-dev-server）
     // 从包安装路径计算 pluginDir（dist/cli/daemon/daemon.js → 包根/remnote-plugin）
     const packageRoot = path.resolve(import.meta.dirname, '..', '..', '..');
     const pluginDir = path.join(packageRoot, 'remnote-plugin');
-    const devServer = new DevServerManager({
-        pluginDir,
-        port: config.devServerPort,
-        onLog: log,
-        onExit: (code) => {
-            if (!shutdownInProgress && code !== 0) {
-                log('webpack-dev-server 异常退出，守护进程关闭', 'error');
-                shutdown();
-            }
-        },
-    });
+    const devMode = process.env.REMNOTE_BRIDGE_DEV === '1';
+    const headlessMode = process.env.REMNOTE_HEADLESS === '1';
+    const headlessRemotePort = process.env.REMNOTE_HEADLESS_REMOTE_PORT
+        ? parseInt(process.env.REMNOTE_HEADLESS_REMOTE_PORT, 10)
+        : undefined;
+    // Headless Chrome 管理器（在 createServer 之前声明，闭包可引用）
+    let headlessBrowser = null;
+    const distDir = path.join(pluginDir, 'dist');
+    const distExists = fs.existsSync(path.join(distDir, 'index.html'));
+    if (!devMode && !distExists) {
+        const msg = 'Plugin dist/ 未找到。请使用 --dev 模式，或确认 remnote-bridge 包完整性。';
+        log(msg, 'error');
+        process.send?.({ type: 'error', message: msg });
+        process.exit(1);
+    }
+    const pluginServerLabel = devMode ? 'webpack-dev-server' : '静态文件服务器';
+    const pluginServer = devMode
+        ? new DevServerManager({
+            pluginDir,
+            port: config.devServerPort,
+            onLog: log,
+            onExit: (code) => {
+                if (!shutdownInProgress && code !== 0) {
+                    log('webpack-dev-server 异常退出，守护进程关闭', 'error');
+                    shutdown();
+                }
+            },
+        })
+        : new StaticServer({
+            distDir,
+            port: config.devServerPort,
+            onLog: log,
+        });
     async function shutdown() {
         if (shutdownInProgress)
             return;
         shutdownInProgress = true;
         log('开始优雅关闭...');
         clearTimeout(timeoutTimer);
+        // 先关闭 headless Chrome
+        if (headlessBrowser) {
+            try {
+                await headlessBrowser.stop();
+                log('Headless Chrome 已关闭');
+            }
+            catch (err) {
+                log(`Headless Chrome 关闭失败: ${err}`, 'error');
+            }
+            headlessBrowser = null;
+        }
         try {
             await server.stop();
             log('WS Server 已关闭');
@@ -120,11 +180,11 @@ async function main() {
             log(`ConfigServer 关闭失败: ${err}`, 'error');
         }
         try {
-            await devServer.stop();
-            log('webpack-dev-server 已关闭');
+            await pluginServer.stop();
+            log(`${pluginServerLabel} 已关闭`);
         }
         catch (err) {
-            log(`webpack-dev-server 关闭失败: ${err}`, 'error');
+            log(`${pluginServerLabel} 关闭失败: ${err}`, 'error');
         }
         removePid(pidPath);
         log('PID 文件已删除');
@@ -153,18 +213,38 @@ async function main() {
         // ConfigServer 非关键，启动失败不阻塞
     }
     try {
-        devServer.start();
-        log(`webpack-dev-server 启动中 (端口 ${config.devServerPort})`);
+        await pluginServer.start();
+        log(`${pluginServerLabel} 已启动 (端口 ${config.devServerPort})`);
     }
     catch (err) {
-        log(`webpack-dev-server 启动失败: ${err}`, 'error');
+        log(`${pluginServerLabel} 启动失败: ${err}`, 'error');
         await server.stop();
-        process.send?.({ type: 'error', message: `webpack-dev-server 启动失败: ${err}` });
+        process.send?.({ type: 'error', message: `${pluginServerLabel} 启动失败: ${err}` });
         process.exit(1);
     }
     // 写入 PID 文件
     writePid(pidPath, process.pid);
     log(`PID 文件已写入: ${pidPath} (PID: ${process.pid})`);
+    // 启动 Headless Chrome（如果启用）
+    // headless Chrome 加载 RemNote 本身（不是 plugin 静态文件），
+    // RemNote 会自动加载已配置的 dev plugin（从 localhost:8080）
+    if (headlessMode) {
+        const remNoteUrl = 'https://www.remnote.com';
+        headlessBrowser = new HeadlessBrowserManager({
+            remNoteUrl,
+            remoteDebuggingPort: headlessRemotePort,
+            onLog: log,
+        });
+        try {
+            await headlessBrowser.start();
+            log(`Headless Chrome 已启动，加载 ${remNoteUrl}`);
+        }
+        catch (err) {
+            // 非致命：daemon 继续运行，日志记录错误
+            log(`Headless Chrome 启动失败（非致命）: ${err}`, 'error');
+            headlessBrowser = null;
+        }
+    }
     // 启动超时计时器
     resetTimeout();
     // 通知父进程就绪
@@ -174,6 +254,7 @@ async function main() {
         devServerPort: config.devServerPort,
         configPort: config.configPort,
         pid: process.pid,
+        headless: headlessMode,
     });
     // 断开 IPC 通道（让父进程可以退出）
     if (process.channel) {