remnote-bridge 0.1.0

package/dist/cli/server/config-server.js

@@ -0,0 +1,363 @@
+/**
+ * ConfigServer — HTTP 配置管理服务器
+ *
+ * 绑定 127.0.0.1:<configPort>，提供可视化配置页面。
+ * - GET /          — 返回内联 HTML/CSS/JS 配置页面
+ * - GET /api/config — 返回当前配置 JSON
+ * - POST /api/config — 校验 → saveConfig → 返回成功
+ * - POST /api/restart — 调用 onRestart() 回调 → 返回成功
+ */
+import http from 'http';
+import { DEFAULT_CONFIG, DEFAULT_DEFAULTS, loadConfig, saveConfig, configFilePath } from '../config.js';
+export class ConfigServer {
+    server = null;
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    log(message, level = 'info') {
+        this.options.onLog?.(message, level);
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            this.server = http.createServer((req, res) => this.handleRequest(req, res));
+            this.server.on('error', (err) => {
+                this.log(`ConfigServer 错误: ${err.message}`, 'error');
+                reject(err);
+            });
+            this.server.listen(this.options.port, this.options.host ?? '127.0.0.1', () => {
+                this.log(`ConfigServer 监听 ${this.options.host ?? '127.0.0.1'}:${this.options.port}`);
+                resolve();
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    this.server = null;
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async handleRequest(req, res) {
+        const url = req.url ?? '/';
+        try {
+            if (req.method === 'GET' && url === '/') {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(this.renderPage());
+                return;
+            }
+            if (req.method === 'GET' && url === '/api/config') {
+                const config = loadConfig(this.options.projectRoot);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(config));
+                return;
+            }
+            if (req.method === 'POST' && url === '/api/config') {
+                const body = await readBody(req);
+                const newConfig = JSON.parse(body);
+                // 端口冲突校验
+                const ports = [newConfig.wsPort, newConfig.devServerPort, newConfig.configPort];
+                if (new Set(ports).size !== ports.length) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: 'wsPort, devServerPort, configPort 不能重复' }));
+                    return;
+                }
+                const filePath = configFilePath(this.options.projectRoot);
+                saveConfig(filePath, newConfig);
+                this.log('配置已保存');
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true }));
+                return;
+            }
+            if (req.method === 'POST' && url === '/api/restart') {
+                this.log('收到软重启请求');
+                try {
+                    await this.options.onRestart();
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: true }));
+                }
+                catch (err) {
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: String(err) }));
+                }
+                return;
+            }
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found' }));
+        }
+        catch (err) {
+            this.log(`请求处理错误: ${err}`, 'error');
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: String(err) }));
+        }
+    }
+    renderPage() {
+        return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>RemNote Bridge 配置</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: system-ui, -apple-system, sans-serif; background: #f5f5f5; color: #333; }
+  .container { max-width: 720px; margin: 40px auto; padding: 0 20px; }
+  h1 { font-size: 24px; margin-bottom: 8px; }
+  .subtitle { color: #666; margin-bottom: 24px; font-size: 14px; }
+  .card { background: #fff; border-radius: 8px; padding: 24px; margin-bottom: 16px; box-shadow: 0 1px 3px rgba(0,0,0,.1); }
+  .card h2 { font-size: 16px; margin-bottom: 16px; padding-bottom: 8px; border-bottom: 1px solid #eee; }
+  .field { display: flex; align-items: center; margin-bottom: 12px; }
+  .field:last-child { margin-bottom: 0; }
+  .field label { flex: 0 0 240px; font-size: 13px; color: #555; }
+  .field input, .field select { flex: 1; padding: 6px 10px; border: 1px solid #ddd; border-radius: 4px; font-size: 13px; }
+  .field input:focus, .field select:focus { outline: none; border-color: #4a9eff; box-shadow: 0 0 0 2px rgba(74,158,255,.2); }
+  .field .hint { font-size: 11px; color: #999; margin-left: 8px; white-space: nowrap; }
+  .actions { display: flex; gap: 12px; margin-top: 24px; }
+  button { padding: 8px 20px; border-radius: 6px; font-size: 14px; cursor: pointer; border: 1px solid #ddd; background: #fff; }
+  button.primary { background: #4a9eff; color: #fff; border-color: #4a9eff; }
+  button.primary:hover { background: #3a8eef; }
+  button:hover { background: #f9f9f9; }
+  .toast { position: fixed; top: 20px; right: 20px; padding: 12px 20px; border-radius: 6px; font-size: 14px; color: #fff; opacity: 0; transition: opacity .3s; z-index: 100; }
+  .toast.success { background: #22c55e; }
+  .toast.error { background: #ef4444; }
+  .toast.show { opacity: 1; }
+  .warning { background: #fef3c7; border: 1px solid #f59e0b; border-radius: 6px; padding: 12px; margin-bottom: 16px; font-size: 12px; color: #92400e; }
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>RemNote Bridge 配置</h1>
+  <p class="subtitle">修改后需保存并重启才能生效</p>
+
+  <div class="card">
+    <h2>服务端口</h2>
+    <div class="field">
+      <label>WebSocket 端口 (wsPort)</label>
+      <input type="number" id="wsPort" min="1" max="65535">
+    </div>
+    <div class="field">
+      <label>Dev Server 端口 (devServerPort)</label>
+      <input type="number" id="devServerPort" min="1" max="65535">
+    </div>
+    <div class="field">
+      <label>配置页端口 (configPort)</label>
+      <input type="number" id="configPort" min="1" max="65535">
+      <span class="hint">变更需 disconnect→connect</span>
+    </div>
+    <div class="field">
+      <label>守护进程超时 (分钟)</label>
+      <input type="number" id="daemonTimeoutMinutes" min="1">
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>共享默认值</h2>
+    <div class="field">
+      <label>最大节点数 (maxNodes)</label>
+      <input type="number" id="maxNodes" min="1">
+    </div>
+    <div class="field">
+      <label>最大同级数 (maxSiblings)</label>
+      <input type="number" id="maxSiblings" min="1">
+    </div>
+    <div class="field">
+      <label>缓存上限 (cacheMaxSize)</label>
+      <input type="number" id="cacheMaxSize" min="1">
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>read-tree 默认值</h2>
+    <div class="field">
+      <label>展开深度 (readTreeDepth)</label>
+      <input type="number" id="readTreeDepth" min="-1">
+      <span class="hint">-1 = 全部展开</span>
+    </div>
+    <div class="field">
+      <label>祖先链层数 (readTreeAncestorLevels)</label>
+      <input type="number" id="readTreeAncestorLevels" min="0">
+    </div>
+    <div class="field">
+      <label>包含 Powerup (readTreeIncludePowerup)</label>
+      <select id="readTreeIncludePowerup">
+        <option value="false">否</option>
+        <option value="true">是</option>
+      </select>
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>read-globe 默认值</h2>
+    <div class="field">
+      <label>展开深度 (readGlobeDepth)</label>
+      <input type="number" id="readGlobeDepth" min="-1">
+      <span class="hint">-1 = 全部展开</span>
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>read-context 默认值</h2>
+    <div class="field">
+      <label>模式 (readContextMode)</label>
+      <select id="readContextMode">
+        <option value="focus">focus</option>
+        <option value="page">page</option>
+      </select>
+    </div>
+    <div class="field">
+      <label>祖先链层数 (readContextAncestorLevels)</label>
+      <input type="number" id="readContextAncestorLevels" min="0">
+    </div>
+    <div class="field">
+      <label>展开深度 (readContextDepth)</label>
+      <input type="number" id="readContextDepth" min="-1">
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>search 默认值</h2>
+    <div class="field">
+      <label>结果数量 (searchNumResults)</label>
+      <input type="number" id="searchNumResults" min="1">
+    </div>
+  </div>
+
+  <div class="actions">
+    <button class="primary" onclick="saveConfig()">保存配置</button>
+    <button onclick="resetDefaults()">恢复默认值</button>
+  </div>
+</div>
+
+<div class="toast" id="toast"></div>
+
+<script>
+const DEFAULTS = ${JSON.stringify({ ...DEFAULT_CONFIG, defaults: { ...DEFAULT_DEFAULTS } })};
+
+const TOP_FIELDS = ['wsPort', 'devServerPort', 'configPort', 'daemonTimeoutMinutes'];
+const DEFAULTS_FIELDS = [
+  'maxNodes', 'maxSiblings', 'cacheMaxSize',
+  'readTreeDepth', 'readTreeAncestorLevels', 'readTreeIncludePowerup',
+  'readGlobeDepth',
+  'readContextMode', 'readContextAncestorLevels', 'readContextDepth',
+  'searchNumResults'
+];
+
+function showToast(msg, type) {
+  const t = document.getElementById('toast');
+  t.textContent = msg;
+  t.className = 'toast ' + type + ' show';
+  setTimeout(() => t.classList.remove('show'), 3000);
+}
+
+function fillForm(config) {
+  TOP_FIELDS.forEach(k => {
+    document.getElementById(k).value = config[k];
+  });
+  DEFAULTS_FIELDS.forEach(k => {
+    const el = document.getElementById(k);
+    const val = config.defaults[k];
+    if (el.tagName === 'SELECT') {
+      el.value = String(val);
+    } else {
+      el.value = val;
+    }
+  });
+}
+
+function readForm() {
+  const config = { defaults: {} };
+  TOP_FIELDS.forEach(k => {
+    config[k] = Number(document.getElementById(k).value);
+  });
+  DEFAULTS_FIELDS.forEach(k => {
+    const el = document.getElementById(k);
+    if (k === 'readTreeIncludePowerup') {
+      config.defaults[k] = el.value === 'true';
+    } else if (k === 'readContextMode') {
+      config.defaults[k] = el.value;
+    } else {
+      config.defaults[k] = Number(el.value);
+    }
+  });
+  return config;
+}
+
+async function loadConfig() {
+  try {
+    const res = await fetch('/api/config');
+    const config = await res.json();
+    fillForm(config);
+  } catch (e) {
+    showToast('加载配置失败: ' + e, 'error');
+  }
+}
+
+async function saveConfig() {
+  const config = readForm();
+  // 端口冲突校验
+  const ports = [config.wsPort, config.devServerPort, config.configPort];
+  if (new Set(ports).size !== ports.length) {
+    showToast('端口不能重复', 'error');
+    return;
+  }
+
+  try {
+    const res = await fetch('/api/config', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(config),
+    });
+    const result = await res.json();
+    if (!result.ok) {
+      showToast('保存失败: ' + result.error, 'error');
+      return;
+    }
+    showToast('配置已保存', 'success');
+
+    // 弹出确认框
+    if (confirm('配置已保存。是否立即重启以应用配置？\\n\\n注意：如果修改了 configPort，当前页面将无法访问新端口。需要 disconnect→connect 重新启动。')) {
+      try {
+        const rr = await fetch('/api/restart', { method: 'POST' });
+        const rrResult = await rr.json();
+        if (rrResult.ok) {
+          showToast('软重启成功', 'success');
+          // 重新加载配置显示
+          setTimeout(loadConfig, 1000);
+        } else {
+          showToast('重启失败: ' + rrResult.error, 'error');
+        }
+      } catch (e) {
+        showToast('重启请求失败: ' + e, 'error');
+      }
+    }
+  } catch (e) {
+    showToast('保存请求失败: ' + e, 'error');
+  }
+}
+
+function resetDefaults() {
+  if (confirm('确定要恢复所有配置为默认值吗？')) {
+    fillForm(DEFAULTS);
+  }
+}
+
+loadConfig();
+</script>
+</body>
+</html>`;
+    }
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}

package/dist/cli/server/ws-server.d.ts

@@ -0,0 +1,68 @@
+/**
+ * WebSocket Server
+ *
+ * 守护进程的核心基础设施：监听端口，管理 Plugin 和 CLI 命令的连接。
+ * - 接受 Plugin 的 hello 握手
+ * - 向 Plugin 发送 ping 心跳
+ * - 分发 CLI 请求到对应的 handler
+ * - 只允许一个 Plugin 连接
+ *
+ * 业务编排逻辑在 handlers/ 中，本文件只做连接管理和请求分发。
+ */
+import type { StatusResult } from '../protocol.js';
+import type { DefaultsConfig } from '../config.js';
+export interface BridgeServerConfig {
+    port: number;
+    host?: string;
+    pingIntervalMs?: number;
+    pongTimeoutMs?: number;
+    onLog?: (message: string, level: 'info' | 'warn' | 'error') => void;
+    /** 获取守护进程超时剩余秒数（由 daemon 注入） */
+    getTimeoutRemaining?: () => number;
+    /** 业务默认值（由 daemon 注入） */
+    defaults?: DefaultsConfig;
+}
+export declare class BridgeServer {
+    private wss;
+    private pluginSocket;
+    private pluginVersion;
+    private pluginSdkReady;
+    private pingTimer;
+    private pongTimer;
+    private startTime;
+    private pendingPluginRequests;
+    private readHandler;
+    private editHandler;
+    private treeReadHandler;
+    private treeEditHandler;
+    private globeReadHandler;
+    private contextReadHandler;
+    private defaults;
+    private config;
+    /** 每当收到 CLI 命令请求时触发（用于刷新守护进程超时计时器） */
+    onCliRequest?: () => void;
+    constructor(config: BridgeServerConfig);
+    private log;
+    /**
+     * 启动 WS Server。返回 Promise，监听成功后 resolve。
+     */
+    start(): Promise<void>;
+    /**
+     * 关闭 WS Server。
+     */
+    stop(): Promise<void>;
+    private handleConnection;
+    private handlePluginHello;
+    private handleCliRequest;
+    /**
+     * 向 Plugin 发送子请求并等待响应。
+     * 生成独立的请求 ID，通过 pendingPluginRequests 关联 Promise。
+     */
+    forwardToPlugin(action: string, payload: Record<string, unknown>): Promise<unknown>;
+    private handlePluginResponse;
+    private handlePong;
+    private startPingInterval;
+    private stopPingInterval;
+    /** 获取当前状态（timeoutRemaining 通过构造时注入的回调获取） */
+    getStatus(): StatusResult;
+}