remnote-bridge 0.1.10 → 0.1.12

package/remnote-plugin/dist/manifest.json

@@ -6,7 +6,7 @@
   "repoUrl": "https://github.com/baobao700508/unofficial-remnote-bridge-cli",
   "version": {
     "major": 0,
-    "minor": 1,
+    "minor": 2,
     "patch": 0
   },
   "theme": [],

package/remnote-plugin/package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "unofficial-remnote-bridge-plugin",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "RemNote 桥接层：嵌入 RemNote 的 WebSocket 桥接插件",
   "scripts": {

package/remnote-plugin/public/manifest.json

@@ -6,7 +6,7 @@
   "repoUrl": "https://github.com/baobao700508/unofficial-remnote-bridge-cli",
   "version": {
     "major": 0,
-    "minor": 1,
+    "minor": 2,
     "patch": 0
   },
   "theme": [],

package/remnote-plugin/src/bridge/message-router.ts

@@ -49,7 +49,7 @@ export function createMessageRouter(plugin: ReactRNPlugin): (request: BridgeRequ
       case 'read_globe':
         return readGlobe(plugin, request.payload as { depth?: number; maxNodes?: number; maxSiblings?: number });
       case 'read_context':
-        return readContext(plugin, request.payload as { mode?: 'focus' | 'page'; ancestorLevels?: number; maxNodes?: number; maxSiblings?: number; depth?: number });
+        return readContext(plugin, request.payload as { mode?: 'focus' | 'page'; ancestorLevels?: number; maxNodes?: number; maxSiblings?: number; depth?: number; focusRemId?: string });
       case 'search':
         return search(plugin, request.payload as { query: string; numResults?: number });
 

package/remnote-plugin/src/bridge/multi-connection-manager.ts

@@ -0,0 +1,151 @@
+/**
+ * Multi-Connection Manager — 管理 Plugin 到多个 Daemon 的连接
+ *
+ * 一个 Plugin 同时连接最多 4 个 daemon，通过"孪生优先级"机制
+ * 保证各 daemon 与其原生 Plugin 的亲和性，同时允许空闲 daemon 被接管。
+ *
+ * 依赖方向：multi-connection-manager → websocket-client（单向）
+ */
+
+import { WebSocketClient } from './websocket-client';
+import type { ConnectionStatus, BridgeRequest } from './websocket-client';
+import { ALL_WS_PORTS, SCAN_INTERVAL_MS } from '../settings';
+
+// ── 类型定义 ──
+
+export type DisconnectReason = 'not_started' | 'preempted' | 'twin_occupied' | 'other_occupied' | null;
+
+export interface SlotState {
+  slotIndex: number;
+  wsPort: number;
+  status: ConnectionStatus;
+  isTwin: boolean;
+  disconnectReason: DisconnectReason;
+}
+
+export interface MultiConnectionManagerConfig {
+  twinSlotIndex: number;
+  pluginVersion: string;
+  sdkReady: boolean;
+  onSlotsChange: (slots: SlotState[]) => void;
+  onLog: (slotIndex: number, message: string, level: 'info' | 'warn' | 'error') => void;
+}
+
+// ── 实现 ──
+
+export class MultiConnectionManager {
+  private clients: WebSocketClient[] = [];
+  private slotStates: SlotState[] = [];
+  private scanTimer: ReturnType<typeof setInterval> | null = null;
+  private config: MultiConnectionManagerConfig;
+
+  constructor(config: MultiConnectionManagerConfig) {
+    this.config = config;
+
+    // 初始化 4 个槽位状态 + 创建 4 个 WebSocketClient
+    for (let i = 0; i < ALL_WS_PORTS.length; i++) {
+      const isTwin = (i === config.twinSlotIndex);
+
+      this.slotStates.push({
+        slotIndex: i,
+        wsPort: ALL_WS_PORTS[i],
+        status: 'disconnected',
+        isTwin,
+        disconnectReason: 'not_started',
+      });
+
+      this.clients.push(new WebSocketClient({
+        url: `ws://127.0.0.1:${ALL_WS_PORTS[i]}`,
+        pluginVersion: config.pluginVersion,
+        sdkReady: config.sdkReady,
+        twinSlotIndex: config.twinSlotIndex,
+        isTwinConnection: isTwin,
+        maxReconnectAttempts: isTwin ? 10 : 0,  // 非孪生不自动重连
+        initialReconnectDelay: 1000,
+        maxReconnectDelay: 30000,
+        onStatusChange: (status) => this.handleStatusChange(i, status),
+        onLog: (message, level) => config.onLog(i, message, level),
+        onPreempted: () => this.handleDisconnectReason(i, 'preempted'),
+        onTwinOccupied: () => this.handleDisconnectReason(i, 'twin_occupied'),
+        onOtherOccupied: () => this.handleDisconnectReason(i, 'other_occupied'),
+      }));
+    }
+  }
+
+  /** 设置消息处理器（所有连接共享同一个 messageHandler） */
+  setMessageHandler(handler: (request: BridgeRequest) => Promise<unknown>): void {
+    for (const client of this.clients) {
+      client.setMessageHandler(handler);
+    }
+  }
+
+  /** 启动连接：先连孪生槽位，延迟 2s 后连其余 */
+  start(): void {
+    const twinIdx = this.config.twinSlotIndex;
+
+    // 先连孪生
+    this.clients[twinIdx].connect();
+
+    // 延迟 2s 后连其余
+    setTimeout(() => {
+      for (let i = 0; i < this.clients.length; i++) {
+        if (i !== twinIdx) {
+          this.clients[i].connect();
+        }
+      }
+    }, 2000);
+
+    // 启动周期扫描
+    this.scanTimer = setInterval(() => this.scanAndReconnect(), SCAN_INTERVAL_MS);
+  }
+
+  /** 停止所有连接和定时器 */
+  stop(): void {
+    if (this.scanTimer) {
+      clearInterval(this.scanTimer);
+      this.scanTimer = null;
+    }
+    for (const client of this.clients) {
+      client.disconnect();
+    }
+  }
+
+  /** 获取当前所有槽位状态 */
+  getSlots(): SlotState[] {
+    return this.slotStates.slice();
+  }
+
+  // ── 内部方法 ──
+
+  private handleStatusChange(slotIndex: number, status: ConnectionStatus): void {
+    const slot = this.slotStates[slotIndex];
+    slot.status = status;
+    if (status === 'connected') {
+      slot.disconnectReason = null;
+    }
+    this.notifySlotsChange();
+  }
+
+  private handleDisconnectReason(slotIndex: number, reason: DisconnectReason): void {
+    this.slotStates[slotIndex].disconnectReason = reason;
+    this.notifySlotsChange();
+  }
+
+  private notifySlotsChange(): void {
+    this.config.onSlotsChange(this.slotStates.slice());
+  }
+
+  /** 周期扫描：对所有未连接的非孪生槽位尝试重连 */
+  private scanAndReconnect(): void {
+    for (let i = 0; i < this.clients.length; i++) {
+      const slot = this.slotStates[i];
+      // 跳过孪生（有自己的重连逻辑）、已连接
+      if (slot.isTwin) continue;
+      if (slot.status === 'connected' || slot.status === 'connecting') continue;
+      // 所有非孪生槽位都参与轮询（含 preempted/twin_occupied/other_occupied）
+      // 对方 Plugin 可能已断开，daemon 空闲后我们能感知到
+
+      this.clients[i].connect();
+    }
+  }
+}

package/remnote-plugin/src/bridge/websocket-client.ts

@@ -13,12 +13,23 @@
 
 // ── 协议类型（独立定义）──
 
+/** 已有其他 Plugin 连接（非孪生），拒绝 */
+const WS_CLOSE_OTHER_CONNECTED = 4000;
+/** 孪生已连，拒绝非孪生 */
+const WS_CLOSE_TWIN_EXISTS = 4003;
+
 export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected';
 
 export interface HelloMessage {
   type: 'hello';
   version: string;
   sdkReady: boolean;
+  twinSlotIndex: number;  // Plugin 的孪生 daemon 槽位索引 (0-3)
+}
+
+export interface PreemptedMessage {
+  type: 'preempted';
+  reason: string;  // 'twin_plugin_connected'
 }
 
 export interface PingMessage {
@@ -47,11 +58,16 @@ export interface WebSocketClientConfig {
   url: string;
   pluginVersion: string;
   sdkReady: boolean;
+  twinSlotIndex: number;       // Plugin 的孪生槽位
+  isTwinConnection?: boolean;  // 本连接是否孪生连接
   maxReconnectAttempts?: number;
   initialReconnectDelay?: number;
   maxReconnectDelay?: number;
   onStatusChange?: (status: ConnectionStatus) => void;
   onLog?: (message: string, level: 'info' | 'warn' | 'error') => void;
+  onPreempted?: () => void;      // 被孪生 Plugin 抢占回调
+  onTwinOccupied?: () => void;   // 被拒绝：孪生 Plugin 已连（不可重试）
+  onOtherOccupied?: () => void;  // 被拒绝：已有其他非孪生 Plugin（可重试）
 }
 
 // ── WebSocket Client 实现 ──
@@ -63,11 +79,16 @@ export class WebSocketClient {
   private messageHandler: ((request: BridgeRequest) => Promise<unknown>) | null = null;
   private status: ConnectionStatus = 'disconnected';
   private isShuttingDown = false;
+  private isPreempted = false;
   private _sdkReady: boolean;
 
-  private config: Required<Omit<WebSocketClientConfig, 'onStatusChange' | 'onLog'>> & {
+  private config: Required<Omit<WebSocketClientConfig, 'onStatusChange' | 'onLog' | 'onPreempted' | 'onTwinOccupied' | 'onOtherOccupied' | 'isTwinConnection'>> & {
     onStatusChange?: (status: ConnectionStatus) => void;
     onLog?: (message: string, level: 'info' | 'warn' | 'error') => void;
+    onPreempted?: () => void;
+    onTwinOccupied?: () => void;
+    onOtherOccupied?: () => void;
+    isTwinConnection: boolean;
   };
 
   constructor(config: WebSocketClientConfig) {
@@ -76,11 +97,16 @@ export class WebSocketClient {
       url: config.url,
       pluginVersion: config.pluginVersion,
       sdkReady: config.sdkReady,
+      twinSlotIndex: config.twinSlotIndex,
+      isTwinConnection: config.isTwinConnection ?? false,
       maxReconnectAttempts: config.maxReconnectAttempts ?? 10,
       initialReconnectDelay: config.initialReconnectDelay ?? 1000,
       maxReconnectDelay: config.maxReconnectDelay ?? 30000,
       onStatusChange: config.onStatusChange,
       onLog: config.onLog,
+      onPreempted: config.onPreempted,
+      onTwinOccupied: config.onTwinOccupied,
+      onOtherOccupied: config.onOtherOccupied,
     };
   }
 
@@ -100,10 +126,11 @@ export class WebSocketClient {
       type: 'hello',
       version: this.config.pluginVersion,
       sdkReady: this._sdkReady,
+      twinSlotIndex: this.config.twinSlotIndex,
     };
     try {
       this.ws?.send(JSON.stringify(hello));
-      this.log(`发送 hello（v${this.config.pluginVersion}, sdkReady=${this._sdkReady}）`);
+      this.log(`发送 hello（v${this.config.pluginVersion}, sdkReady=${this._sdkReady}, twinSlot=${this.config.twinSlotIndex}）`);
     } catch (error) {
       this.log(`发送 hello 失败: ${error}`, 'warn');
     }
@@ -115,8 +142,8 @@ export class WebSocketClient {
     }
 
     this.isShuttingDown = false;
+    this.isPreempted = false;
     this.setStatus('connecting');
-    this.log(`正在连接 ${this.config.url}...`);
 
     try {
       this.ws = new WebSocket(this.config.url);
@@ -133,16 +160,26 @@ export class WebSocketClient {
       };
 
       this.ws.onclose = (event) => {
-        this.log(`连接断开: ${event.code} ${event.reason}`, 'warn');
+        // 1006 = 连接从未建立（daemon 未运行），不打日志
+        if (event.code !== 1006) {
+          this.log(`连接断开: ${event.code} ${event.reason}`, 'warn');
+        }
         this.setStatus('disconnected');
 
+        // 被 daemon 拒绝
+        if (event.code === WS_CLOSE_TWIN_EXISTS) {
+          this.config.onTwinOccupied?.();
+        } else if (event.code === WS_CLOSE_OTHER_CONNECTED) {
+          this.config.onOtherOccupied?.();
+        }
+
         if (!this.isShuttingDown) {
           this.scheduleReconnect();
         }
       };
 
-      this.ws.onerror = (error) => {
-        this.log(`WebSocket 错误: ${error}`, 'error');
+      this.ws.onerror = () => {
+        // 连接失败的错误由 onclose 处理，此处不重复打日志
       };
     } catch (error) {
       this.log(`连接失败: ${error}`, 'error');
@@ -155,6 +192,14 @@ export class WebSocketClient {
     try {
       const message = JSON.parse(data);
 
+      // 抢占通知
+      if (message.type === 'preempted') {
+        this.isPreempted = true;
+        this.log(`被孪生 Plugin 抢占: ${message.reason}`, 'warn');
+        this.config.onPreempted?.();
+        return;
+      }
+
       // 心跳响应
       if (message.type === 'ping') {
         this.ws?.send(JSON.stringify({ type: 'pong' } as PongMessage));
@@ -186,6 +231,17 @@ export class WebSocketClient {
   private scheduleReconnect(): void {
     if (this.isShuttingDown) return;
 
+    // 被抢占 → 不在此处重连，由外部轮询驱动
+    if (this.isPreempted) {
+      return;
+    }
+
+    // 非孪生连接 → 不在此处重连，由外部轮询驱动
+    if (!this.config.isTwinConnection) {
+      return;
+    }
+
+    // 孪生连接保留指数退避重连
     if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
       this.log('已达最大重连次数', 'error');
       return;
@@ -213,10 +269,6 @@ export class WebSocketClient {
     this.messageHandler = handler;
   }
 
-  setSdkReady(ready: boolean): void {
-    this._sdkReady = ready;
-  }
-
   disconnect(): void {
     this.isShuttingDown = true;
 
@@ -233,12 +285,6 @@ export class WebSocketClient {
     this.setStatus('disconnected');
   }
 
-  reconnect(): void {
-    this.reconnectAttempts = 0;
-    this.disconnect();
-    this.connect();
-  }
-
   getStatus(): ConnectionStatus {
     return this.status;
   }

package/remnote-plugin/src/services/index.ts

@@ -5,12 +5,4 @@
  * 由 bridge 层调用，不直接暴露给 widgets。
  *
  * 依赖方向：services → utils（单向）
- *
- * 待实现：
- * - read-note.ts    → readNote()
- * - create-note.ts  → createNote()
- * - update-note.ts  → updateNote()
- * - search.ts       → search()
- * - search-by-tag.ts → searchByTag()
- * - append-journal.ts → appendJournal()
  */

package/remnote-plugin/src/services/read-context.ts

@@ -27,6 +27,7 @@ export interface ReadContextPayload {
   maxNodes?: number;
   maxSiblings?: number;
   depth?: number;
+  focusRemId?: string;
 }
 
 export interface ReadContextResult {
@@ -46,12 +47,14 @@ export async function readContext(
     maxNodes = 200,
     maxSiblings = 20,
     depth = 3,
+    focusRemId,
   } = payload;
 
   if (mode === 'page') {
+    if (focusRemId) throw new Error('focusRemId 仅在 focus 模式下有效，page 模式下请勿指定');
     return readContextPage(plugin, { maxNodes, maxSiblings, depth });
   }
-  return readContextFocus(plugin, { ancestorLevels, maxNodes, maxSiblings });
+  return readContextFocus(plugin, { ancestorLevels, maxNodes, maxSiblings, focusRemId });
 }
 
 // ────────────────────────── Page 模式 ──────────────────────────
@@ -87,10 +90,16 @@ async function readContextPage(
 
 async function readContextFocus(
   plugin: ReactRNPlugin,
-  opts: { ancestorLevels: number; maxNodes: number; maxSiblings: number },
+  opts: { ancestorLevels: number; maxNodes: number; maxSiblings: number; focusRemId?: string },
 ): Promise<ReadContextResult> {
-  const focusRem = await plugin.focus.getFocusedRem();
-  if (!focusRem) throw new Error('当前没有聚焦的 Rem，请先在 RemNote 中点击一个 Rem');
+  let focusRem: Rem | undefined;
+  if (opts.focusRemId) {
+    focusRem = await plugin.rem.findOne(opts.focusRemId);
+    if (!focusRem) throw new Error(`指定的 Rem 不存在: ${opts.focusRemId}`);
+  } else {
+    focusRem = await plugin.focus.getFocusedRem();
+    if (!focusRem) throw new Error('当前没有聚焦的 Rem，请先在 RemNote 中点击一个 Rem');
+  }
 
   const breadcrumb = await buildBreadcrumb(plugin, focusRem);
 

package/remnote-plugin/src/services/read-rem.ts

@@ -16,6 +16,7 @@ import type {
   PropertyTypeValue,
 } from '../types';
 import { filterNoisyChildren, filterNoisyTags } from './powerup-filter';
+import { remTypeToString } from './rem-builder';
 
 /**
  * 读取单个 Rem，组装为完整 RemObject。
@@ -263,15 +264,6 @@ function sortRichTextKeys(rt: RichText): RichText {
   });
 }
 
-/** SDK RemType 枚举值 → 字符串 */
-function remTypeToString(type: number): RemTypeValue {
-  switch (type) {
-    case 1: return 'concept';
-    case 2: return 'descriptor';
-    case 6: return 'portal';
-    default: return 'default';
-  }
-}
 
 /** SDK PORTAL_TYPE 枚举值 → 字符串 */
 function portalTypeToString(pt: number): PortalType {

package/remnote-plugin/src/services/search.ts

@@ -38,16 +38,19 @@ export async function search(
 
   const rems = await plugin.search.search([query], undefined, { numResults });
 
-  const results: SearchResultItem[] = [];
-  for (const rem of rems) {
-    const markdownText = await safeToMarkdown(plugin, rem.text ?? []);
-    const isDocument = await rem.isDocument();
-    results.push({
-      remId: rem._id,
-      text: markdownText.replace(/\n/g, ' '),
-      isDocument,
-    });
-  }
+  const results: SearchResultItem[] = await Promise.all(
+    rems.map(async (rem) => {
+      const [markdownText, isDocument] = await Promise.all([
+        safeToMarkdown(plugin, rem.text ?? []),
+        rem.isDocument(),
+      ]);
+      return {
+        remId: rem._id,
+        text: markdownText.replace(/\n/g, ' '),
+        isDocument,
+      };
+    }),
+  );
 
   return {
     query,

package/remnote-plugin/src/settings.ts

@@ -1,12 +1,14 @@
 /**
- * Plugin 设置常量
+ * Plugin 常量
  *
- * 定义 RemNote 设置面板中的设置项 ID 和默认值。
+ * 定义默认值和版本号。
+ * 多 daemon 连接：Plugin 同时连接 ALL_WS_PORTS 对应的 4 个槽位。
  */
 
-// 设置项 ID
-export const SETTING_WS_URL = 'bridge-ws-url';
+export const DEFAULT_PLUGIN_VERSION = '0.2.0';
 
-// 默认值
-export const DEFAULT_WS_URL = 'ws://127.0.0.1:3002';
-export const DEFAULT_PLUGIN_VERSION = '0.1.0';
+/** 4 个固定 WS 端口，对应 4 个 daemon 槽位 */
+export const ALL_WS_PORTS = [29100, 29110, 29120, 29130] as const;
+
+/** 非孪生槽位周期扫描间隔（ms） */
+export const SCAN_INTERVAL_MS = 18_000;

package/remnote-plugin/src/utils/index.ts

@@ -2,9 +2,4 @@
  * Utils 层 — 共享辅助工具（无状态纯函数）
  *
  * 被 services 层单向依赖，不依赖任何其他业务层。
- *
- * 待实现：
- * - rich-text.ts        → 富文本解析（extractText 等）
- * - content-renderer.ts → 内容渲染（Markdown / Structured）
- * - rem-classifier.ts   → Rem 分类、别名、父级解析
  */