remnote-bridge 0.1.3 → 0.1.5

package/dist/cli/commands/clean.js

@@ -0,0 +1,114 @@
+/**
+ * clean 命令
+ *
+ * 清理 remnote-bridge 在本机产生的所有残留文件：
+ * - 项目根：.remnote-bridge.pid / .remnote-bridge.log / .remnote-bridge.json
+ * - 用户目录：~/.claude/skills/remnote-bridge/
+ *
+ * 如果守护进程仍在运行，先停止再清理。
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { findProjectRoot, pidFilePath, logFilePath, configFilePath } from '../config.js';
+import { checkDaemon } from '../daemon/pid.js';
+import { jsonOutput } from '../utils/output.js';
+export async function cleanCommand(options = {}) {
+    const { json } = options;
+    const projectRoot = findProjectRoot();
+    const removed = [];
+    const errors = [];
+    // 1. 如果守护进程在运行，先停止
+    const pidPath = pidFilePath(projectRoot);
+    const status = checkDaemon(pidPath);
+    if (status.running) {
+        if (!json) {
+            console.log(`守护进程运行中（PID: ${status.pid}），正在停止...`);
+        }
+        try {
+            process.kill(status.pid, 'SIGTERM');
+            // 等待最多 5 秒
+            const start = Date.now();
+            while (Date.now() - start < 5000) {
+                try {
+                    process.kill(status.pid, 0);
+                    await new Promise(r => setTimeout(r, 200));
+                }
+                catch {
+                    break; // 进程已退出
+                }
+            }
+            // 如果还没退出，强制终止
+            try {
+                process.kill(status.pid, 0);
+                process.kill(status.pid, 'SIGKILL');
+            }
+            catch {
+                // 已退出
+            }
+        }
+        catch {
+            // 进程可能已退出
+        }
+    }
+    // 2. 清理项目根下的文件
+    const projectFiles = [
+        pidFilePath(projectRoot),
+        logFilePath(projectRoot),
+        configFilePath(projectRoot),
+    ];
+    for (const filePath of projectFiles) {
+        if (fs.existsSync(filePath)) {
+            try {
+                fs.unlinkSync(filePath);
+                removed.push(filePath);
+                if (!json) {
+                    console.log(`  已删除: ${filePath}`);
+                }
+            }
+            catch (err) {
+                errors.push(`${filePath}: ${err.message}`);
+                if (!json) {
+                    console.error(`  删除失败: ${filePath} — ${err.message}`);
+                }
+            }
+        }
+    }
+    // 3. 清理 ~/.claude/skills/remnote-bridge/
+    const skillDir = path.join(os.homedir(), '.claude', 'skills', 'remnote-bridge');
+    if (fs.existsSync(skillDir)) {
+        try {
+            fs.rmSync(skillDir, { recursive: true, force: true });
+            removed.push(skillDir);
+            if (!json) {
+                console.log(`  已删除: ${skillDir}`);
+            }
+        }
+        catch (err) {
+            errors.push(`${skillDir}: ${err.message}`);
+            if (!json) {
+                console.error(`  删除失败: ${skillDir} — ${err.message}`);
+            }
+        }
+    }
+    // 4. 输出结果
+    if (json) {
+        jsonOutput({
+            ok: errors.length === 0,
+            command: 'clean',
+            removed,
+            ...(errors.length > 0 ? { errors } : {}),
+        });
+    }
+    else {
+        if (removed.length === 0 && errors.length === 0) {
+            console.log('没有发现需要清理的文件');
+        }
+        else if (errors.length === 0) {
+            console.log(`\n清理完成，共删除 ${removed.length} 项`);
+        }
+        else {
+            console.log(`\n清理完成，删除 ${removed.length} 项，${errors.length} 项失败`);
+        }
+    }
+}

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

@@ -2,6 +2,7 @@
  * webpack-dev-server 子进程管理
  *
  * 在 remnote-plugin 目录下启动 npm run dev。
+ * 具备崩溃重试和依赖自动修复能力。
  */
 import { spawn, execSync } from 'child_process';
 import path from 'path';
@@ -9,29 +10,60 @@ import fs from 'fs';
 export class DevServerManager {
     child = null;
     options;
+    retryCount = 0;
+    maxRetries;
+    stopping = false;
     constructor(options) {
         this.options = options;
+        this.maxRetries = options.maxRetries ?? 2;
     }
     /**
      * 启动 webpack-dev-server。
      * 如果 remnote-plugin 目录不存在，抛出错误。
      */
     start() {
-        const { pluginDir, port, onLog, onExit } = this.options;
+        const { pluginDir, port, onLog } = this.options;
         if (!fs.existsSync(path.join(pluginDir, 'package.json'))) {
             throw new Error(`Plugin 目录不存在或缺少 package.json: ${pluginDir}`);
         }
-        // 首次使用时自动安装 plugin 依赖
-        if (!fs.existsSync(path.join(pluginDir, 'node_modules'))) {
-            onLog?.('[dev-server] remnote-plugin/node_modules 不存在，正在安装依赖...', 'info');
+        this.ensureDependencies(false);
+        this.spawnDevServer();
+    }
+    /**
+     * 确保依赖完整。
+     * @param cleanInstall true = 删除 node_modules 后重装（修复损坏）
+     */
+    ensureDependencies(cleanInstall) {
+        const { pluginDir, onLog } = this.options;
+        const nodeModulesDir = path.join(pluginDir, 'node_modules');
+        const hasCompleteDeps = fs.existsSync(nodeModulesDir) &&
+            fs.existsSync(path.join(nodeModulesDir, '.package-lock.json'));
+        if (cleanInstall && fs.existsSync(nodeModulesDir)) {
+            onLog?.('[dev-server] 检测到依赖损坏，正在清洁重装...', 'warn');
+            // 删除 node_modules 和 package-lock.json 以彻底修复
+            fs.rmSync(nodeModulesDir, { recursive: true, force: true });
+            const lockFile = path.join(pluginDir, 'package-lock.json');
+            if (fs.existsSync(lockFile)) {
+                fs.unlinkSync(lockFile);
+            }
+        }
+        if (cleanInstall || !hasCompleteDeps) {
+            onLog?.('[dev-server] remnote-plugin 依赖缺失或不完整，正在安装...', 'info');
             execSync('npm install', { cwd: pluginDir, stdio: 'pipe' });
             onLog?.('[dev-server] 依赖安装完成', 'info');
         }
-        // 通过环境变量传递端口
+    }
+    /**
+     * 启动 dev-server 子进程并挂载事件监听。
+     */
+    spawnDevServer() {
+        const { pluginDir, port, onLog, onExit } = this.options;
+        // shell: true 确保 Windows 上能找到 npm.cmd
         this.child = spawn('npm', ['run', 'dev'], {
             cwd: pluginDir,
             env: { ...process.env, PORT: String(port) },
             stdio: 'pipe',
+            shell: true,
         });
         this.child.stdout?.on('data', (data) => {
             onLog?.(`[dev-server] ${data.toString().trim()}`, 'info');
@@ -40,9 +72,35 @@ export class DevServerManager {
             onLog?.(`[dev-server] ${data.toString().trim()}`, 'warn');
         });
         this.child.on('exit', (code) => {
-            onLog?.(`webpack-dev-server 退出 (code: ${code})`, code === 0 ? 'info' : 'error');
             this.child = null;
-            onExit?.(code);
+            // 正常退出或正在停止中，不重试
+            if (code === 0 || this.stopping) {
+                onLog?.(`webpack-dev-server 退出 (code: ${code})`, 'info');
+                onExit?.(code);
+                return;
+            }
+            onLog?.(`webpack-dev-server 异常退出 (code: ${code})`, 'error');
+            // 尝试重试
+            if (this.retryCount < this.maxRetries) {
+                this.retryCount++;
+                const isCleanRetry = this.retryCount === 1;
+                onLog?.(`[dev-server] 第 ${this.retryCount}/${this.maxRetries} 次重试` +
+                    (isCleanRetry ? '（清洁重装依赖）' : '') + '...', 'warn');
+                try {
+                    // 第一次重试：清洁重装依赖（修复损坏的 node_modules）
+                    // 后续重试：直接重启
+                    this.ensureDependencies(isCleanRetry);
+                    this.spawnDevServer();
+                }
+                catch (err) {
+                    onLog?.(`[dev-server] 重试失败: ${err.message}`, 'error');
+                    onExit?.(code);
+                }
+            }
+            else {
+                onLog?.(`[dev-server] 已达最大重试次数 (${this.maxRetries})，放弃`, 'error');
+                onExit?.(code);
+            }
         });
         this.child.on('error', (err) => {
             onLog?.(`webpack-dev-server 启动失败: ${err.message}`, 'error');
@@ -54,6 +112,7 @@ export class DevServerManager {
      * 停止 webpack-dev-server。
      */
     stop() {
+        this.stopping = true;
         return new Promise((resolve) => {
             if (!this.child) {
                 resolve();

package/dist/cli/main.js

@@ -16,6 +16,7 @@ import { readGlobeCommand } from './commands/read-globe.js';
 import { readContextCommand } from './commands/read-context.js';
 import { searchCommand } from './commands/search.js';
 import { installSkillCommand, installSkillCopyCommand } from './commands/install-skill.js';
+import { cleanCommand } from './commands/clean.js';
 const program = new Command();
 /**
  * --json 模式下解析 JSON 输入参数。
@@ -53,7 +54,7 @@ function parseJsonInput(command, jsonStr, requiredFields = []) {
 program
     .name('remnote-bridge')
     .description('RemNote Bridge — CLI + MCP Server + Plugin')
-    .version('0.1.3')
+    .version('0.1.5')
     .option('--json', '以 JSON 格式输出（适用于程序化调用）');
 program
     .command('connect')
@@ -305,4 +306,11 @@ installCmd.command('skill')
         await installSkillCommand();
     }
 });
+program
+    .command('clean')
+    .description('清理所有残留文件（.pid / .log / .json / skill 目录）')
+    .action(async () => {
+    const { json } = program.opts();
+    await cleanCommand({ json });
+});
 program.parse();

package/dist/mcp/instructions.js

@@ -130,10 +130,18 @@ disconnect → 关闭 daemon，清空所有缓存
 
 **注意**：中文等无空格语言搜索效果较差。如果完整词搜索无结果，尝试用单个最具区分度的字搜索；如果仍然无果，改用 \\\`read_globe\\\` → \\\`read_tree\\\` 手动定位。
 
-### 场景 C：了解当前上下文
+### 场景 C：了解当前上下文（⚠️ 高优先级）
 
 > 用户说："我现在在看什么"、"当前页面是什么"
 
+**重要：用户正在看的页面对你来说是不可见的。** 用户在跟你沟通时，往往默认你也能看到他正在浏览的 RemNote 页面，但实际上你们的信息是不对等的。当你发现以下情况时，**必须主动调用 \\\`read_context\\\` 来对齐信息**：
+- 用户提到了你没有上下文的内容（如"这个"、"当前页面"、"这里"）
+- 用户的描述与你已知的信息对不上
+- 你搜索不到用户提到的某些内容
+- 用户似乎在引用他正在查看的界面
+
+先用 \\\`read_context\\\` 看到用户所看到的，再做决策，沟通才能顺畅。
+
 使用 \\\`read_context\\\`：
 - **focus 模式**（默认）：以用户当前光标所在的 Rem 为中心，构建鱼眼视图——焦点处完全展开，周围递减。焦点行以 \\\`* \\\` 前缀标记。需要用户在 RemNote 中已点击某个 Rem。
 - **page 模式**：以当前打开的页面为根，均匀展开子树。

package/package.json

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

package/skills/remnote-bridge/SKILL.md

@@ -191,6 +191,16 @@ RemNote 格式设置（fontSize、highlightColor 等）底层通过 Powerup 机
 
 ## 2. 命令决策
 
+### ⚠️ 用户正在看的页面对你不可见
+
+用户在跟你沟通时，往往默认你也能看到他正在浏览的 RemNote 页面，但实际上你们的信息是不对等的。当你发现以下情况时，**必须主动执行 `read-context` 来对齐信息**：
+- 用户提到了你没有上下文的内容（如"这个"、"当前页面"、"这里"）
+- 用户的描述与你已知的信息对不上
+- 你搜索不到用户提到的某些内容
+- 用户似乎在引用他正在查看的界面
+
+先用 `read-context` 看到用户所看到的，再做决策，沟通才能顺畅。
+
 ### 读取：用户想了解什么？
 
 ```