remnote-bridge 0.1.0

package/dist/cli/commands/read-context.js

@@ -0,0 +1,77 @@
+/**
+ * read-context 命令
+ *
+ * 读取当前上下文视图。
+ * - --mode focus|page（默认 focus）
+ * - --ancestor-levels N 向上追溯几层祖先（默认 2，仅 focus 模式）
+ * - --depth N 展开深度（默认 3，仅 page 模式）
+ * - --max-nodes N 全局节点上限（默认 200）
+ * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function readContextCommand(options = {}) {
+    const { json } = options;
+    const mode = options.mode || 'focus';
+    if (mode !== 'focus' && mode !== 'page') {
+        const errMsg = '--mode must be "focus" or "page"';
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-context', error: errMsg });
+        }
+        else {
+            console.error(`错误: ${errMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const ancestorLevels = options.ancestorLevels !== undefined ? parseInt(options.ancestorLevels, 10) : undefined;
+    const depth = options.depth !== undefined ? parseInt(options.depth, 10) : undefined;
+    const maxNodes = options.maxNodes !== undefined ? parseInt(options.maxNodes, 10) : undefined;
+    const maxSiblings = options.maxSiblings !== undefined ? parseInt(options.maxSiblings, 10) : undefined;
+    if ((ancestorLevels !== undefined && isNaN(ancestorLevels)) || (depth !== undefined && isNaN(depth)) || (maxNodes !== undefined && isNaN(maxNodes)) || (maxSiblings !== undefined && isNaN(maxSiblings))) {
+        const errMsg = 'numeric options must be numbers';
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-context', error: errMsg });
+        }
+        else {
+            console.error(`错误: ${errMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    let result;
+    try {
+        result = await sendDaemonRequest('read_context', {
+            mode, ancestorLevels, depth, maxNodes, maxSiblings,
+        });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'read-context', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-context', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    if (json) {
+        jsonOutput({ ok: true, command: 'read-context', data });
+    }
+    else {
+        console.log(data.outline);
+    }
+}

package/dist/cli/commands/read-globe.d.ts

@@ -0,0 +1,16 @@
+/**
+ * read-globe 命令
+ *
+ * 读取知识库全局概览（仅 Document 层级）。
+ * - --depth N 控制 Document 嵌套深度（默认 -1 无限）
+ * - --max-nodes N 全局节点上限（默认 200）
+ * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+export interface ReadGlobeOptions {
+    json?: boolean;
+    depth?: string;
+    maxNodes?: string;
+    maxSiblings?: string;
+}
+export declare function readGlobeCommand(options?: ReadGlobeOptions): Promise<void>;

package/dist/cli/commands/read-globe.js

@@ -0,0 +1,60 @@
+/**
+ * read-globe 命令
+ *
+ * 读取知识库全局概览（仅 Document 层级）。
+ * - --depth N 控制 Document 嵌套深度（默认 -1 无限）
+ * - --max-nodes N 全局节点上限（默认 200）
+ * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function readGlobeCommand(options = {}) {
+    const { json } = options;
+    const depth = options.depth !== undefined ? parseInt(options.depth, 10) : undefined;
+    const maxNodes = options.maxNodes !== undefined ? parseInt(options.maxNodes, 10) : undefined;
+    const maxSiblings = options.maxSiblings !== undefined ? parseInt(options.maxSiblings, 10) : undefined;
+    if ((depth !== undefined && isNaN(depth)) || (maxNodes !== undefined && isNaN(maxNodes)) || (maxSiblings !== undefined && isNaN(maxSiblings))) {
+        const errMsg = '--depth, --max-nodes, --max-siblings must be numbers';
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-globe', error: errMsg });
+        }
+        else {
+            console.error(`错误: ${errMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    let result;
+    try {
+        result = await sendDaemonRequest('read_globe', { depth, maxNodes, maxSiblings });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'read-globe', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-globe', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    if (json) {
+        jsonOutput({ ok: true, command: 'read-globe', data });
+    }
+    else {
+        console.log(data.outline);
+    }
+}

package/dist/cli/commands/read-rem.d.ts

@@ -0,0 +1,16 @@
+/**
+ * read-rem 命令
+ *
+ * 读取单个 Rem 的完整 JSON 对象。
+ * - 默认输出 [RW] + [R] 字段（34 个）
+ * - --full 输出全部 51 个字段（含 [R-F]）
+ * - --fields 指定输出字段子集
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+export interface ReadRemOptions {
+    json?: boolean;
+    fields?: string;
+    full?: boolean;
+    includePowerup?: boolean;
+}
+export declare function readRemCommand(remId: string, options?: ReadRemOptions): Promise<void>;

package/dist/cli/commands/read-rem.js

@@ -0,0 +1,80 @@
+/**
+ * read-rem 命令
+ *
+ * 读取单个 Rem 的完整 JSON 对象。
+ * - 默认输出 [RW] + [R] 字段（34 个）
+ * - --full 输出全部 51 个字段（含 [R-F]）
+ * - --fields 指定输出字段子集
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function readRemCommand(remId, options = {}) {
+    const { json, fields, full, includePowerup } = options;
+    // 构造 payload
+    const payload = { remId };
+    if (includePowerup) {
+        payload.includePowerup = true;
+    }
+    if (full) {
+        payload.full = true;
+    }
+    else if (fields) {
+        payload.fields = fields.split(',').map(f => f.trim()).filter(Boolean);
+    }
+    let result;
+    try {
+        result = await sendDaemonRequest('read_rem', payload);
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'read-rem', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        if (err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'read-rem', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        // 业务错误（Rem not found, Plugin 未连接等）
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-rem', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    const cacheOverridden = data._cacheOverridden;
+    delete data._cacheOverridden;
+    const powerupFiltered = data.powerupFiltered;
+    delete data.powerupFiltered;
+    if (json) {
+        jsonOutput({ ok: true, command: 'read-rem', data, ...(cacheOverridden ? { cacheOverridden } : {}), ...(powerupFiltered ? { powerupFiltered } : {}) });
+    }
+    else {
+        if (cacheOverridden) {
+            console.warn(`注意: Rem ${cacheOverridden.id} 的缓存（${cacheOverridden.previousCachedAt}）已被本次 read 覆盖`);
+        }
+        if (powerupFiltered) {
+            console.warn(`⚠ 已过滤 Powerup 系统数据（${powerupFiltered.tags} 个 Tag、${powerupFiltered.children} 个隐藏子 Rem）。`);
+            console.warn('  Powerup 是 RemNote 的格式渲染机制，其产生的 Tag 和子 Rem 在 UI 中不可见。');
+            console.warn('  如需查看完整数据，请加 --includePowerup 选项。');
+        }
+        console.log(JSON.stringify(data, null, 2));
+    }
+}

package/dist/cli/commands/read-tree.d.ts

@@ -0,0 +1,17 @@
+/**
+ * read-tree 命令
+ *
+ * 读取 Rem 子树并序列化为带缩进的 Markdown 大纲。
+ * - --depth N 控制展开深度（默认 3，-1 = 全部展开）
+ * - --json 结构化 JSON 输出
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+export interface ReadTreeOptions {
+    json?: boolean;
+    depth?: string;
+    maxNodes?: string;
+    maxSiblings?: string;
+    ancestorLevels?: string;
+    includePowerup?: boolean;
+}
+export declare function readTreeCommand(remId: string, options?: ReadTreeOptions): Promise<void>;

package/dist/cli/commands/read-tree.js

@@ -0,0 +1,85 @@
+/**
+ * read-tree 命令
+ *
+ * 读取 Rem 子树并序列化为带缩进的 Markdown 大纲。
+ * - --depth N 控制展开深度（默认 3，-1 = 全部展开）
+ * - --json 结构化 JSON 输出
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function readTreeCommand(remId, options = {}) {
+    const { json } = options;
+    const depth = options.depth !== undefined ? parseInt(options.depth, 10) : undefined;
+    const maxNodes = options.maxNodes !== undefined ? parseInt(options.maxNodes, 10) : undefined;
+    const maxSiblings = options.maxSiblings !== undefined ? parseInt(options.maxSiblings, 10) : undefined;
+    const ancestorLevels = options.ancestorLevels !== undefined ? parseInt(options.ancestorLevels, 10) : undefined;
+    if ((depth !== undefined && isNaN(depth)) || (maxNodes !== undefined && isNaN(maxNodes)) || (maxSiblings !== undefined && isNaN(maxSiblings)) || (ancestorLevels !== undefined && isNaN(ancestorLevels))) {
+        const errMsg = '--depth, --max-nodes, --max-siblings, --ancestor-levels must be numbers';
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-tree', error: errMsg });
+        }
+        else {
+            console.error(`错误: ${errMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    let result;
+    try {
+        result = await sendDaemonRequest('read_tree', {
+            remId, depth, maxNodes, maxSiblings, ancestorLevels,
+            includePowerup: options.includePowerup,
+        });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'read-tree', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'read-tree', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    const cacheOverridden = data._cacheOverridden;
+    delete data._cacheOverridden;
+    const powerupFiltered = data.powerupFiltered;
+    delete data.powerupFiltered;
+    const ancestors = data.ancestors;
+    delete data.ancestors;
+    if (json) {
+        jsonOutput({ ok: true, command: 'read-tree', data, ...(ancestors ? { ancestors } : {}), ...(cacheOverridden ? { cacheOverridden } : {}), ...(powerupFiltered ? { powerupFiltered } : {}) });
+    }
+    else {
+        if (cacheOverridden) {
+            console.warn(`注意: Tree ${cacheOverridden.id} 的缓存（${cacheOverridden.previousCachedAt}）已被本次 read 覆盖`);
+        }
+        if (powerupFiltered) {
+            console.warn(`⚠ 已过滤 Powerup 系统数据（${powerupFiltered.tags} 个 Tag、${powerupFiltered.children} 个隐藏子 Rem）。`);
+            console.warn('  Powerup 是 RemNote 的格式渲染机制，其产生的 Tag 和子 Rem 在 UI 中不可见。');
+            console.warn('  如需查看完整数据，请加 --includePowerup 选项。');
+        }
+        if (ancestors && ancestors.length > 0) {
+            // 由近及远 → 反转为由远及近，构建路径
+            const pathParts = [...ancestors].reverse().map(a => {
+                const topMark = a.isTopLevel ? ' [top]' : '';
+                return `${a.name} (${a.id}${topMark})`;
+            });
+            console.log(`<!-- ancestors: ${pathParts.join(' > ')} -->`);
+        }
+        console.log(data.outline);
+    }
+}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,12 @@
+/**
+ * search 命令
+ *
+ * 在知识库中按文本搜索 Rem。
+ * - --limit N 结果数量上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+export interface SearchOptions {
+    json?: boolean;
+    limit?: string;
+}
+export declare function searchCommand(query: string, options?: SearchOptions): Promise<void>;

package/dist/cli/commands/search.js

@@ -0,0 +1,65 @@
+/**
+ * search 命令
+ *
+ * 在知识库中按文本搜索 Rem。
+ * - --limit N 结果数量上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function searchCommand(query, options = {}) {
+    const { json } = options;
+    const numResults = options.limit !== undefined ? parseInt(options.limit, 10) : undefined;
+    if (numResults !== undefined && isNaN(numResults)) {
+        const errMsg = '--limit must be a number';
+        if (json) {
+            jsonOutput({ ok: false, command: 'search', error: errMsg });
+        }
+        else {
+            console.error(`错误: ${errMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    let result;
+    try {
+        result = await sendDaemonRequest('search', { query, numResults });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'search', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'search', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    if (json) {
+        jsonOutput({ ok: true, command: 'search', data });
+    }
+    else {
+        if (data.results.length === 0) {
+            console.log(`未找到与 "${data.query}" 相关的结果`);
+        }
+        else {
+            console.log(`搜索 "${data.query}"，找到 ${data.totalFound} 条结果：\n`);
+            for (const item of data.results) {
+                const docTag = item.isDocument ? ' [Doc]' : '';
+                console.log(`  [${item.remId}]${docTag} ${item.text}`);
+            }
+        }
+    }
+}

package/dist/cli/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 配置加载
+ *
+ * 从项目根目录读取 .remnote-bridge.json，合并默认值。
+ * 文件不存在时使用全部默认值，不报错。
+ */
+export interface DefaultsConfig {
+    maxNodes: number;
+    maxSiblings: number;
+    cacheMaxSize: number;
+    readTreeDepth: number;
+    readTreeAncestorLevels: number;
+    readTreeIncludePowerup: boolean;
+    readGlobeDepth: number;
+    readContextMode: 'focus' | 'page';
+    readContextAncestorLevels: number;
+    readContextDepth: number;
+    searchNumResults: number;
+}
+export declare const DEFAULT_DEFAULTS: Readonly<DefaultsConfig>;
+export interface BridgeConfig {
+    wsPort: number;
+    devServerPort: number;
+    configPort: number;
+    daemonTimeoutMinutes: number;
+    defaults: DefaultsConfig;
+}
+export declare const DEFAULT_CONFIG: Readonly<BridgeConfig>;
+/**
+ * 查找项目根目录（monorepo 根：包含 .git 目录的最近祖先）
+ *
+ * 从 startDir 向上查找 .git 目录，找到即返回。
+ * 到达文件系统根仍未找到时回退到 cwd。
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * 加载配置。不存在时返回默认值。
+ */
+export declare function loadConfig(projectRoot?: string): BridgeConfig;
+/**
+ * 获取配置文件路径
+ */
+export declare function configFilePath(projectRoot?: string): string;
+/**
+ * 原子写入配置文件（写临时文件 → rename）
+ */
+export declare function saveConfig(filePath: string, config: BridgeConfig): void;
+/**
+ * PID 文件路径
+ */
+export declare function pidFilePath(projectRoot?: string): string;
+/**
+ * 日志文件路径
+ */
+export declare function logFilePath(projectRoot?: string): string;

package/dist/cli/config.js

@@ -0,0 +1,139 @@
+/**
+ * 配置加载
+ *
+ * 从项目根目录读取 .remnote-bridge.json，合并默认值。
+ * 文件不存在时使用全部默认值，不报错。
+ */
+import fs from 'fs';
+import path from 'path';
+export const DEFAULT_DEFAULTS = {
+    maxNodes: 200,
+    maxSiblings: 20,
+    cacheMaxSize: 200,
+    readTreeDepth: 3,
+    readTreeAncestorLevels: 0,
+    readTreeIncludePowerup: false,
+    readGlobeDepth: -1,
+    readContextMode: 'focus',
+    readContextAncestorLevels: 2,
+    readContextDepth: 3,
+    searchNumResults: 20,
+};
+export const DEFAULT_CONFIG = {
+    wsPort: 3002,
+    devServerPort: 8080,
+    configPort: 3003,
+    daemonTimeoutMinutes: 30,
+    defaults: { ...DEFAULT_DEFAULTS },
+};
+const CONFIG_FILENAME = '.remnote-bridge.json';
+function isValidPort(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 1 && value <= 65535;
+}
+/**
+ * 查找项目根目录（monorepo 根：包含 .git 目录的最近祖先）
+ *
+ * 从 startDir 向上查找 .git 目录，找到即返回。
+ * 到达文件系统根仍未找到时回退到 cwd。
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        // 优先匹配 .git 目录（monorepo 根标识）
+        if (fs.existsSync(path.join(dir, '.git'))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            // 到达文件系统根，回退到 cwd
+            return process.cwd();
+        }
+        dir = parent;
+    }
+}
+function isPositiveNumber(value) {
+    return typeof value === 'number' && value > 0;
+}
+function mergeDefaults(parsed) {
+    if (!parsed)
+        return { ...DEFAULT_DEFAULTS };
+    return {
+        maxNodes: isPositiveNumber(parsed.maxNodes) ? parsed.maxNodes : DEFAULT_DEFAULTS.maxNodes,
+        maxSiblings: isPositiveNumber(parsed.maxSiblings) ? parsed.maxSiblings : DEFAULT_DEFAULTS.maxSiblings,
+        cacheMaxSize: isPositiveNumber(parsed.cacheMaxSize) ? parsed.cacheMaxSize : DEFAULT_DEFAULTS.cacheMaxSize,
+        readTreeDepth: typeof parsed.readTreeDepth === 'number' ? parsed.readTreeDepth : DEFAULT_DEFAULTS.readTreeDepth,
+        readTreeAncestorLevels: typeof parsed.readTreeAncestorLevels === 'number' && parsed.readTreeAncestorLevels >= 0
+            ? parsed.readTreeAncestorLevels : DEFAULT_DEFAULTS.readTreeAncestorLevels,
+        readTreeIncludePowerup: typeof parsed.readTreeIncludePowerup === 'boolean'
+            ? parsed.readTreeIncludePowerup : DEFAULT_DEFAULTS.readTreeIncludePowerup,
+        readGlobeDepth: typeof parsed.readGlobeDepth === 'number' ? parsed.readGlobeDepth : DEFAULT_DEFAULTS.readGlobeDepth,
+        readContextMode: parsed.readContextMode === 'focus' || parsed.readContextMode === 'page'
+            ? parsed.readContextMode : DEFAULT_DEFAULTS.readContextMode,
+        readContextAncestorLevels: typeof parsed.readContextAncestorLevels === 'number' && parsed.readContextAncestorLevels >= 0
+            ? parsed.readContextAncestorLevels : DEFAULT_DEFAULTS.readContextAncestorLevels,
+        readContextDepth: typeof parsed.readContextDepth === 'number' ? parsed.readContextDepth : DEFAULT_DEFAULTS.readContextDepth,
+        searchNumResults: isPositiveNumber(parsed.searchNumResults) ? parsed.searchNumResults : DEFAULT_DEFAULTS.searchNumResults,
+    };
+}
+/**
+ * 加载配置。不存在时返回默认值。
+ */
+export function loadConfig(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    const configPath = path.join(root, CONFIG_FILENAME);
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG, defaults: { ...DEFAULT_DEFAULTS } };
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const config = {
+            wsPort: isValidPort(parsed.wsPort) ? parsed.wsPort : DEFAULT_CONFIG.wsPort,
+            devServerPort: isValidPort(parsed.devServerPort) ? parsed.devServerPort : DEFAULT_CONFIG.devServerPort,
+            configPort: isValidPort(parsed.configPort) ? parsed.configPort : DEFAULT_CONFIG.configPort,
+            daemonTimeoutMinutes: typeof parsed.daemonTimeoutMinutes === 'number' && parsed.daemonTimeoutMinutes > 0
+                ? parsed.daemonTimeoutMinutes
+                : DEFAULT_CONFIG.daemonTimeoutMinutes,
+            defaults: mergeDefaults(parsed.defaults),
+        };
+        // 端口冲突校验
+        const ports = [config.wsPort, config.devServerPort, config.configPort];
+        if (new Set(ports).size !== ports.length) {
+            throw new Error('wsPort, devServerPort, configPort must be different');
+        }
+        return config;
+    }
+    catch {
+        // 配置文件损坏时使用默认值
+        return { ...DEFAULT_CONFIG, defaults: { ...DEFAULT_DEFAULTS } };
+    }
+}
+/**
+ * 获取配置文件路径
+ */
+export function configFilePath(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    return path.join(root, CONFIG_FILENAME);
+}
+/**
+ * 原子写入配置文件（写临时文件 → rename）
+ */
+export function saveConfig(filePath, config) {
+    const tmpPath = filePath + '.tmp.' + process.pid;
+    fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * PID 文件路径
+ */
+export function pidFilePath(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    return path.join(root, '.remnote-bridge.pid');
+}
+/**
+ * 日志文件路径
+ */
+export function logFilePath(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    return path.join(root, '.remnote-bridge.log');
+}

package/dist/cli/daemon/daemon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 守护进程主逻辑
+ *
+ * 作为 fork 子进程运行：
+ * 1. 启动 WS Server
+ * 2. 启动 webpack-dev-server 子进程
+ * 3. 写入 PID 文件
+ * 4. 管理自动超时关闭
+ * 5. 通过 IPC 向父进程发送 ready 信号
+ */
+export {};