remnote-bridge 0.1.8 → 0.1.10

package/dist/cli/commands/connect.js

@@ -14,7 +14,7 @@ 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 { getSetupDonePath, cleanupOrphanChrome } from '../daemon/headless-browser.js';
 import { jsonOutput } from '../utils/output.js';
 function isDaemonMessage(msg) {
     return (typeof msg === 'object' &&
@@ -28,6 +28,8 @@ export async function connectCommand(options = {}) {
     const pidPath = pidFilePath(projectRoot);
     // headless 前置检查
     if (options.headless) {
+        // 清理上次可能残留的孤儿 Chrome 进程
+        cleanupOrphanChrome(json ? undefined : (msg) => console.log(msg));
         const setupDonePath = getSetupDonePath();
         if (!fs.existsSync(setupDonePath)) {
             const error = '尚未完成 setup。请先执行 `remnote-bridge setup` 登录 RemNote，然后再使用 --headless';

package/dist/cli/commands/disconnect.js

@@ -7,6 +7,7 @@
  */
 import { pidFilePath, findProjectRoot } from '../config.js';
 import { checkDaemon, removePid } from '../daemon/pid.js';
+import { cleanupOrphanChrome } from '../daemon/headless-browser.js';
 import { jsonOutput } from '../utils/output.js';
 const WAIT_TIMEOUT_MS = 10_000;
 const POLL_INTERVAL_MS = 200;
@@ -49,6 +50,8 @@ export async function disconnectCommand(options = {}) {
     const exited = await waitForExit(pid, WAIT_TIMEOUT_MS);
     if (exited) {
         removePid(pidPath);
+        // 清理可能残留的孤儿 headless Chrome
+        cleanupOrphanChrome(json ? undefined : (msg) => console.log(msg));
         if (json) {
             jsonOutput({ ok: true, command: 'disconnect', wasRunning: true, pid, forced: false });
         }
@@ -65,6 +68,8 @@ export async function disconnectCommand(options = {}) {
             // 可能已退出
         }
         removePid(pidPath);
+        // daemon 被强杀后 Chrome 更可能成为孤儿，务必清理
+        cleanupOrphanChrome(json ? undefined : (msg) => console.log(msg));
         if (json) {
             jsonOutput({ ok: true, command: 'disconnect', wasRunning: true, pid, forced: true });
         }

package/dist/cli/daemon/headless-browser.js

@@ -58,6 +58,87 @@ export function getDefaultProfileDir() {
 export function getSetupDonePath() {
     return path.join(getDefaultProfileDir(), '.setup-done');
 }
+// ── Chrome PID 文件管理（孤儿进程清理） ──
+const HEADLESS_PID_FILENAME = '.headless-pid';
+function getHeadlessPidPath() {
+    return path.join(os.homedir(), '.remnote-bridge', HEADLESS_PID_FILENAME);
+}
+/**
+ * 将 Chrome 进程 PID 写入文件，供孤儿清理使用。
+ */
+function writeHeadlessPid(pid) {
+    const filePath = getHeadlessPidPath();
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, String(pid), 'utf-8');
+}
+/**
+ * 删除 Chrome PID 文件。
+ */
+function removeHeadlessPid() {
+    try {
+        fs.unlinkSync(getHeadlessPidPath());
+    }
+    catch {
+        // 文件不存在则忽略
+    }
+}
+/**
+ * 清理孤儿 headless Chrome 进程。
+ * 读取 PID 文件，如果对应进程仍在运行则 kill，最后删除 PID 文件。
+ * 在 disconnect 和 connect --headless 启动前调用。
+ */
+export function cleanupOrphanChrome(onLog) {
+    const pidPath = getHeadlessPidPath();
+    let pidStr;
+    try {
+        pidStr = fs.readFileSync(pidPath, 'utf-8').trim();
+    }
+    catch {
+        return; // 无 PID 文件，无需清理
+    }
+    const pid = parseInt(pidStr, 10);
+    if (isNaN(pid)) {
+        removeHeadlessPid();
+        return;
+    }
+    // 检查进程是否仍在运行
+    try {
+        process.kill(pid, 0); // 不发信号，仅检查存在性
+    }
+    catch {
+        // 进程已不存在，清理 PID 文件即可
+        removeHeadlessPid();
+        return;
+    }
+    // 进程仍在运行 → kill 它
+    onLog?.(`发现孤儿 headless Chrome 进程 (PID: ${pid})，正在清理...`);
+    try {
+        process.kill(pid, 'SIGTERM');
+        // 给 Chrome 1 秒优雅退出
+        const start = Date.now();
+        while (Date.now() - start < 1000) {
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                break; // 已退出
+            }
+        }
+        // 如果还没退出，强杀
+        try {
+            process.kill(pid, 0);
+            process.kill(pid, 'SIGKILL');
+            onLog?.(`孤儿 Chrome 进程 (PID: ${pid}) 已强制终止`);
+        }
+        catch {
+            onLog?.(`孤儿 Chrome 进程 (PID: ${pid}) 已清理`);
+        }
+    }
+    catch {
+        // kill 失败，可能已退出
+    }
+    removeHeadlessPid();
+}
 const MAX_AUTO_RELOAD = 5;
 const AUTO_RELOAD_DELAY_MS = 10_000;
 const CONSOLE_ERROR_BUFFER_SIZE = 20;
@@ -142,6 +223,12 @@ export class HeadlessBrowserManager {
                 timeout: 60_000,
             });
             this.status = 'running';
+            // 记录 Chrome PID 供孤儿清理使用
+            const chromePid = this.browser.process()?.pid;
+            if (chromePid) {
+                writeHeadlessPid(chromePid);
+                this.log(`[headless] Chrome PID: ${chromePid}`);
+            }
             this.log(`[headless] Chrome 已启动，页面: ${this.options.remNoteUrl}`);
         }
         catch (err) {
@@ -181,6 +268,7 @@ export class HeadlessBrowserManager {
         catch (err) {
             this.log(`[headless] 关闭时出错: ${err}`, 'warn');
         }
+        removeHeadlessPid();
         this.log('[headless] Chrome 已关闭');
     }
     /**

package/dist/cli/daemon/static-server.js

@@ -52,7 +52,10 @@ export class StaticServer {
                     }
                     const ext = path.extname(filePath);
                     const contentType = MIME_TYPES[ext] || 'application/octet-stream';
-                    res.writeHead(200, { 'Content-Type': contentType });
+                    res.writeHead(200, {
+                        'Content-Type': contentType,
+                        'Cache-Control': 'no-cache, no-store, must-revalidate',
+                    });
                     res.end(data);
                 });
             });

package/dist/mcp/instructions.js

@@ -103,6 +103,8 @@ disconnect → 关闭 daemon，清空所有缓存
 
 标准模式每次 connect 后都需要用户手动操作 RemNote。Headless 模式通过 setup（一次性）+ headless Chrome 实现自动连接，后续 connect 无需用户介入。
 
+**⚠️ 模式选择建议**：日常使用推荐**标准模式**。Headless 模式下 Chrome 在后台运行，**无法感知用户正在 RemNote 中浏览和操作的界面**（\\\`read_context\\\` 返回的是 headless Chrome 的上下文，而非用户的浏览器）。只有在全自动化场景（CI/CD、定时任务、批量操作等无需与用户界面交互的场景）才建议使用 Headless 模式。
+
 #### 首次使用（setup）
 
 \\\`setup\\\` 会弹出 Chrome 窗口，用户需要完成两件事：

package/package.json

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