@ppdocs/mcp 3.1.9 → 3.2.0

package/dist/agent.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * PPDocs Agent V2 — 多项目管理入口
+ * 功能: Web Config UI + 多 SyncBeacon + 持久后台运行
+ */
+export {};

package/dist/agent.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+/**
+ * PPDocs Agent V2 — 多项目管理入口
+ * 功能: Web Config UI + 多 SyncBeacon + 持久后台运行
+ */
+import { startWebServer, loadAgentConfig, setAgentState, setProjectStatus } from './web/server.js';
+import { initClient } from './storage/httpClient.js';
+import { SyncBeacon } from './sync/beacon.js';
+const DEFAULT_WEB_PORT = 20010;
+// 多项目 SyncBeacon 管理
+const beacons = new Map();
+async function main() {
+    console.log('📡 PPDocs Agent V2 starting...\n');
+    // 解析端口参数
+    let webPort = DEFAULT_WEB_PORT;
+    const args = process.argv.slice(2);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--port' && args[i + 1]) {
+            webPort = parseInt(args[i + 1], 10) || DEFAULT_WEB_PORT;
+        }
+    }
+    // 加载配置
+    const config = loadAgentConfig();
+    if (config) {
+        webPort = config.webPort || webPort;
+        console.log(`📋 主机: ${config.host}:${config.port}`);
+        console.log(`📂 已绑定 ${config.projects.length} 个项目`);
+        // 测试主机连接
+        try {
+            const resp = await fetch(`http://${config.host}:${config.port}/health`);
+            setAgentState({ hostConnected: resp.ok });
+            if (resp.ok)
+                console.log('✅ 主机连接正常');
+        }
+        catch {
+            setAgentState({ hostConnected: false });
+            console.log('⚠️  主机不可达，将在后台重试');
+        }
+        // 为每个项目启动同步
+        for (const proj of config.projects) {
+            await startProjectSync(config, proj);
+        }
+    }
+    else {
+        console.log('⚙️  首次运行，请在浏览器中完成配置');
+    }
+    // 注册回调
+    setAgentState({
+        onBind: async (project) => {
+            const cfg = loadAgentConfig();
+            if (cfg)
+                await startProjectSync(cfg, project);
+        },
+        onUnbind: (remoteId) => {
+            stopProjectSync(remoteId);
+        },
+    });
+    // 启动 Web Server
+    startWebServer(webPort);
+    // 首次运行自动打开浏览器
+    if (!config) {
+        const url = `http://localhost:${webPort}`;
+        try {
+            const { exec } = await import('child_process');
+            const cmd = process.platform === 'win32' ? `start ${url}`
+                : process.platform === 'darwin' ? `open ${url}` : `xdg-open ${url}`;
+            exec(cmd);
+        }
+        catch { /* ignore */ }
+    }
+}
+async function startProjectSync(config, proj) {
+    const { host, port } = config;
+    const { remote, localDir, sync } = proj;
+    // 初始化该项目的 HTTP 连接 (验证)
+    const apiUrl = `http://${host}:${port}/api/${remote.id}/${remote.password}`;
+    try {
+        const resp = await fetch(`${apiUrl}/docs`);
+        if (resp.ok) {
+            const data = await resp.json();
+            const docCount = data.data?.length || 0;
+            setProjectStatus(remote.id, { connected: true, syncStatus: '已连接', docCount });
+            console.log(`  ✅ ${remote.name}: 已连接 (${docCount} 文档)`);
+        }
+        else {
+            setProjectStatus(remote.id, { connected: false, syncStatus: '连接失败' });
+            console.log(`  ❌ ${remote.name}: 连接失败`);
+            return;
+        }
+    }
+    catch (e) {
+        setProjectStatus(remote.id, { connected: false, syncStatus: `错误: ${e}` });
+        return;
+    }
+    // 启动 SyncBeacon
+    if (localDir && sync?.enabled) {
+        stopProjectSync(remote.id); // 先停旧的
+        // 需要临时给 httpClient 设置对应项目的 API URL
+        initClient(apiUrl);
+        const beacon = new SyncBeacon(localDir, remote.id, (sync.intervalSec || 15) * 1000);
+        beacon.start();
+        beacons.set(remote.id, beacon);
+        setProjectStatus(remote.id, { syncStatus: '同步中', lastSync: new Date() });
+        console.log(`  📂 ${remote.name}: 文件同步已启动`);
+    }
+}
+function stopProjectSync(remoteId) {
+    const beacon = beacons.get(remoteId);
+    if (beacon) {
+        beacon.stop();
+        beacons.delete(remoteId);
+        console.log(`  🛑 停止同步: ${remoteId}`);
+    }
+}
+// 优雅退出
+process.on('SIGINT', () => {
+    console.log('\n🛑 Agent 正在关闭...');
+    for (const [, beacon] of beacons)
+        beacon.stop();
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    for (const [, beacon] of beacons)
+        beacon.stop();
+    process.exit(0);
+});
+main().catch(e => {
+    console.error('❌ Agent 启动失败:', e);
+    process.exit(1);
+});

package/dist/cli.d.ts

@@ -3,3 +3,5 @@
  * 命令: init - 初始化项目配置 + 安装工作流模板 + 自动注册 MCP
  */
 export declare function runCli(args: string[]): boolean;
+/** 安装项目模板文件 (供授权后自动配置调用) */
+export declare function setupProjectFiles(cwd: string, apiUrl: string): void;

package/dist/cli.js

@@ -90,6 +90,7 @@ ppdocs MCP CLI
 
 Commands:
   init    Initialize ppdocs config + install workflow templates
+  agent   Start PPDocs Agent (Web UI + File Sync)
 
 Usage:
   npx @ppdocs/mcp init -p <projectId> -k <key> [options]
@@ -126,6 +127,14 @@ export function runCli(args) {
         });
         return true;
     }
+    if (cmd === 'agent') {
+        // 动态导入 Agent 入口
+        import('./agent.js').catch(e => {
+            console.error(`❌ Agent failed: ${e}`);
+            process.exit(1);
+        });
+        return true;
+    }
     if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
         showHelp();
         return true;
@@ -181,8 +190,8 @@ async function initProject(opts) {
             installClaudeTemplates(cwd); // Default to Claude templates
         }
     }
-    // 自动检测并注册 MCP
-    const registered = autoRegisterMcp(apiUrl, opts.user);
+    // 自动检测并注册 MCP (如果已写入 Antigravity 配置，跳过 gemini CLI 注册避免冲突)
+    const registered = autoRegisterMcp(apiUrl, opts.user, detectedIdes.includes('antigravity'));
     // 如果没有检测到任何 AI CLI，并且也没有检测到配置文件夹，创建 .mcp.json 作为备用
     if (!registered && !hasIdeDir) {
         createMcpJson(cwd, apiUrl);
@@ -280,7 +289,7 @@ function execSilent(cmd) {
     catch { /* ignore */ }
 }
 /** 自动检测 AI CLI 并注册 MCP */
-function autoRegisterMcp(apiUrl, user) {
+function autoRegisterMcp(apiUrl, user, skipGemini = false) {
     const detected = [];
     const serverName = 'ppdocs-kg';
     // 检测 Claude CLI (不传环境变量，MCP启动时读取.ppdocs)
@@ -324,7 +333,7 @@ function autoRegisterMcp(apiUrl, user) {
         }
     }
     // 检测 Gemini CLI
-    if (commandExists('gemini')) {
+    if (commandExists('gemini') && !skipGemini) {
         detected.push('Gemini');
         try {
             console.log(`✅ Detected Gemini CLI, registering MCP...`);
@@ -344,33 +353,39 @@ function autoRegisterMcp(apiUrl, user) {
     return true;
 }
 /** 在指定路径创建或更新 mcp.json 配置 */
-function createMcpConfigAt(mcpPath, apiUrl) {
+function createMcpConfigAt(mcpPath, apiUrl, options) {
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
         try {
             mcpConfig = JSON.parse(fs.readFileSync(mcpPath, 'utf-8'));
         }
         catch {
-            // ignore parse error
+            // 解析失败时中止，避免清空已有配置
+            console.log(`⚠️  ${mcpPath} JSON格式无效，跳过MCP配置写入（请手动修复后重试）`);
+            return;
         }
     }
     // Windows 需要 cmd /c 包装才能执行 npx
     const isWindows = process.platform === 'win32';
     // 对于 Mac/Linux，IDE 可能没有用户的完整 PATH，导致找不到 npx
+    // 使用实际 PATH 值拼接，JSON 中的 $PATH 不会被展开
+    const macExtraPaths = '/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin';
+    const actualPath = `${process.env.PATH || '/usr/bin:/bin'}:${macExtraPaths}`;
     const ppdocsServer = isWindows
         ? {
             command: 'cmd',
             args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'],
-            env: { "PPDOCS_API_URL": apiUrl }
+            ...(options?.noEnv ? {} : { env: { "PPDOCS_API_URL": apiUrl } })
         }
         : {
             command: 'npx',
             args: ['-y', '@ppdocs/mcp@latest'],
-            env: {
-                "PPDOCS_API_URL": apiUrl,
-                // 强行注入常见路径，防止找不到 node/npx
-                "PATH": "$PATH:/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin:$HOME/.nvm/versions/node/current/bin:$HOME/.local/share/fnm/aliases/default/bin"
-            }
+            ...(options?.noEnv ? { env: { "PATH": actualPath } } : {
+                env: {
+                    "PPDOCS_API_URL": apiUrl,
+                    "PATH": actualPath
+                }
+            })
         };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),
@@ -522,8 +537,8 @@ function installCursorTemplates(cwd, apiUrl) {
 }
 /** 安装 Antigravity (Gemini IDE) 模板 */
 function installAntigravityTemplates(cwd, apiUrl) {
-    // 1. 填充 .gemini/settings.json
-    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl);
+    // 1. 填充 .gemini/settings.json (noEnv: 依赖 .ppdocs 文件，不传 PPDOCS_API_URL 避免覆盖)
+    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true });
     // 2. 生成 AGENTS.md
     generateAgentsMd(cwd);
     // 3. 安装斜杠命令 → .agents/workflows/ (Antigravity 的 slash command 机制)
@@ -587,3 +602,23 @@ function detectIDEs(cwd) {
         ides.push('kiro');
     return ides;
 }
+/** 安装项目模板文件 (供授权后自动配置调用) */
+export function setupProjectFiles(cwd, apiUrl) {
+    const detectedIdes = detectIDEs(cwd);
+    if (detectedIdes.includes('antigravity')) {
+        installAntigravityTemplates(cwd, apiUrl);
+    }
+    if (detectedIdes.includes('cursor')) {
+        installCursorTemplates(cwd, apiUrl);
+    }
+    if (detectedIdes.includes('kiro')) {
+        installKiroTemplates(cwd, apiUrl);
+    }
+    if (detectedIdes.includes('claude')) {
+        installClaudeTemplates(cwd);
+    }
+    // 如果没检测到任何 IDE，默认安装 Claude 模板
+    if (detectedIdes.length === 0) {
+        installClaudeTemplates(cwd);
+    }
+}

package/dist/config.d.ts

@@ -1,16 +1,22 @@
 /**
  * ppdocs MCP Config
- * 读取配置: 环境变量 > .ppdocs 文件
+ * 读取配置: 环境变量 > .ppdocs 文件 > 自动发现 > 授权请求
  */
 export interface PpdocsConfig {
     apiUrl: string;
     projectId: string;
     user: string;
+    source: 'env' | 'file' | 'auth';
+    /** 原始连接参数 (discover/auth 填充, 供持久化使用) */
+    connection?: {
+        host: string;
+        port: number;
+        password: string;
+    };
 }
 export declare const PPDOCS_CONFIG_FILE = ".ppdocs";
-/** 生成随机用户名 (8位字母数字) */
+/** 生成随机用户名 */
 export declare function generateUser(): string;
-/**
- * 加载配置 (优先级: 环境变量 > .ppdocs 文件)
- */
-export declare function loadConfig(): PpdocsConfig;
+/** 写入 .ppdocs 文件 (需 config.connection 存在) */
+export declare function writePpdocsFile(config: PpdocsConfig): void;
+export declare function loadConfig(): Promise<PpdocsConfig>;

package/dist/config.js

@@ -1,72 +1,136 @@
 /**
  * ppdocs MCP Config
- * 读取配置: 环境变量 > .ppdocs 文件
+ * 读取配置: 环境变量 > .ppdocs 文件 > 自动发现 > 授权请求
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import * as os from 'os';
 export const PPDOCS_CONFIG_FILE = '.ppdocs';
-/** 生成随机用户名 (8位字母数字) */
+/** 生成随机用户名 */
 export function generateUser() {
     const chars = 'abcdefghjkmnpqrstuvwxyz23456789';
     return Array.from({ length: 8 }, () => chars[Math.floor(Math.random() * chars.length)]).join('');
 }
-/**
- * 从 .ppdocs 文件读取配置
- */
+// ============ 静态配置读取 ============
+function readEnvConfig() {
+    const apiUrl = process.env.PPDOCS_API_URL;
+    if (!apiUrl)
+        return null;
+    const match = apiUrl.match(/\/api\/([^/]+)\/[^/]+\/?$/);
+    return { apiUrl, projectId: match?.[1] || 'unknown', user: process.env.PPDOCS_USER || generateUser(), source: 'env' };
+}
 function readPpdocsFile() {
-    const cwd = process.cwd();
-    const configPath = path.join(cwd, '.ppdocs');
-    if (!fs.existsSync(configPath)) {
+    const configPath = path.join(process.cwd(), '.ppdocs');
+    if (!fs.existsSync(configPath))
         return null;
+    try {
+        const c = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        if (!c.api || !c.projectId || !c.key)
+            return null;
+        return { apiUrl: `${c.api}/api/${c.projectId}/${c.key}`, projectId: c.projectId, user: c.user || generateUser(), source: 'file' };
     }
+    catch {
+        return null;
+    }
+}
+async function findLocalServer() {
+    for (const host of ['localhost', '127.0.0.1', '10.0.0.176']) {
+        for (const port of [20001]) {
+            try {
+                const res = await fetch(`http://${host}:${port}/health`, { signal: AbortSignal.timeout(2000) });
+                if (res.ok)
+                    return { host, port, base: `http://${host}:${port}` };
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+// ============ 授权请求 ============
+async function requestAuthConfig(server) {
     try {
-        const content = fs.readFileSync(configPath, 'utf-8');
-        const config = JSON.parse(content);
-        if (!config.api || !config.projectId || !config.key) {
+        const reqRes = await fetch(`${server.base}/api/auth/request`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ cwd: process.cwd(), hostname: os.hostname() }),
+        });
+        if (!reqRes.ok)
             return null;
+        const { data } = await reqRes.json();
+        if (!data?.requestId)
+            return null;
+        console.error(`[Auth] 等待桌面端授权... (请在 ppdocs 桌面端确认)`);
+        for (let i = 0; i < 150; i++) {
+            await new Promise(r => setTimeout(r, 2000));
+            const pollRes = await fetch(`${server.base}/api/auth/poll/${data.requestId}`, { signal: AbortSignal.timeout(3000) });
+            if (!pollRes.ok)
+                continue;
+            const { data: poll } = await pollRes.json();
+            if (poll?.status === 'approved' && poll.result) {
+                const r = poll.result;
+                console.error(`[Auth] 已授权: ${r.project_name} (${r.project_id})`);
+                return {
+                    apiUrl: `http://${r.api_host}:${r.api_port}/api/${r.project_id}/${r.password}`,
+                    projectId: r.project_id,
+                    user: `auto-${generateUser().slice(0, 4)}`,
+                    source: 'auth',
+                    connection: { host: r.api_host, port: r.api_port, password: r.password },
+                };
+            }
+            if (poll?.status === 'rejected') {
+                console.error('[Auth] 授权被拒绝');
+                return null;
+            }
+            if (poll?.status === 'expired') {
+                console.error('[Auth] 授权超时');
+                return null;
+            }
         }
-        return {
-            apiUrl: `${config.api}/api/${config.projectId}/${config.key}`,
-            projectId: config.projectId,
-            user: config.user || generateUser(),
-        };
+        console.error('[Auth] 轮询超时');
+        return null;
     }
     catch {
         return null;
     }
 }
-/**
- * 从环境变量读取配置
- */
-function readEnvConfig() {
-    const apiUrl = process.env.PPDOCS_API_URL;
-    if (!apiUrl)
-        return null;
-    // URL 格式: http://localhost:20001/api/{projectId}/{password}
-    const match = apiUrl.match(/\/api\/([^/]+)\/[^/]+\/?$/);
-    const projectId = match?.[1] || 'unknown';
-    const user = process.env.PPDOCS_USER || generateUser();
-    return { apiUrl, projectId, user };
+// ============ 持久化 ============
+/** 写入 .ppdocs 文件 (需 config.connection 存在) */
+export function writePpdocsFile(config) {
+    if (!config.connection)
+        return;
+    const configPath = path.join(process.cwd(), '.ppdocs');
+    if (fs.existsSync(configPath))
+        return;
+    const { host, port, password } = config.connection;
+    fs.writeFileSync(configPath, JSON.stringify({
+        api: `http://${host}:${port}`,
+        projectId: config.projectId,
+        key: password,
+        user: config.user,
+    }, null, 2), 'utf-8');
+    console.error(`[Config] 已保存 .ppdocs`);
 }
-/**
- * 加载配置 (优先级: 环境变量 > .ppdocs 文件)
- */
-export function loadConfig() {
-    // 1. 尝试环境变量
+// ============ 入口 ============
+export async function loadConfig() {
+    // 1. 环境变量
     const envConfig = readEnvConfig();
     if (envConfig)
         return envConfig;
-    // 2. 尝试 .ppdocs 文件
+    // 2. .ppdocs 文件
     const fileConfig = readPpdocsFile();
     if (fileConfig)
         return fileConfig;
-    // 3. 报错
-    console.error('ERROR: ppdocs config not found');
-    console.error('');
-    console.error('Option 1: Run init command in your project directory:');
-    console.error('  npx @ppdocs/mcp init -p <projectId> -k <key>');
-    console.error('');
-    console.error('Option 2: Set environment variable:');
-    console.error('  PPDOCS_API_URL=http://localhost:20001/api/{projectId}/{key}');
+    // 3. 扫描本地服务器 → 请求桌面端授权
+    const server = await findLocalServer();
+    if (server) {
+        const authConfig = await requestAuthConfig(server);
+        if (authConfig)
+            return authConfig;
+    }
+    // 全部失败
+    console.error('ERROR: ppdocs 配置未找到');
+    console.error('  请确保 ppdocs 桌面端正在运行，或手动配置 PPDOCS_API_URL 环境变量');
     process.exit(1);
 }

package/dist/index.js

@@ -13,8 +13,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerTools } from './tools/index.js';
 import { initClient } from './storage/httpClient.js';
-import { runCli } from './cli.js';
-import { loadConfig } from './config.js';
+import { runCli, setupProjectFiles } from './cli.js';
+import { loadConfig, writePpdocsFile } from './config.js';
 // 从 package.json 读取版本号
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
@@ -26,7 +26,17 @@ if (args.length > 0 && runCli(args)) {
 }
 // 运行 MCP 服务
 async function main() {
-    const config = loadConfig();
+    const config = await loadConfig();
+    // 自动持久化: 发现/授权后写入 .ppdocs + 安装模板
+    if (config.source === 'auth' && config.connection) {
+        try {
+            writePpdocsFile(config);
+            setupProjectFiles(process.cwd(), config.apiUrl);
+        }
+        catch (e) {
+            console.error('[AutoSetup] 自动配置失败:', e);
+        }
+    }
     initClient(config.apiUrl);
     const server = new McpServer({ name: `ppdocs [${config.projectId}]`, version: VERSION }, { capabilities: { tools: {} } });
     registerTools(server, config.projectId, config.user);

package/dist/storage/discussion.d.ts

@@ -0,0 +1,33 @@
+export interface DiscussionMessage {
+    id: string;
+    sender: string;
+    content: string;
+    timestamp: string;
+}
+export interface DiscussionTopic {
+    id: string;
+    title: string;
+    initiator: string;
+    participants: string[];
+    summary: string;
+    status: 'active' | 'completed';
+    created_at: string;
+    updated_at: string;
+    messages: DiscussionMessage[];
+}
+export declare class DiscussionManager {
+    private static getFilePath;
+    private static readAll;
+    private static writeAll;
+    static listActive(): Omit<DiscussionTopic, 'messages'>[];
+    static readByIds(ids: string[]): DiscussionTopic[];
+    static create(title: string, initiator: string, participants: string[], content: string): string;
+    static reply(id: string, sender: string, content: string, newSummary?: string): boolean;
+    static getAndRemove(id: string): DiscussionTopic | null;
+    /** 按ID删除讨论（不归档，直接删除） */
+    static delete(id: string): boolean;
+    /** 清理过期讨论（默认7天不活跃） */
+    static cleanExpired(days?: number): number;
+    /** 获取活跃讨论数量 */
+    static activeCount(): number;
+}

package/dist/storage/discussion.js

@@ -0,0 +1,116 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export class DiscussionManager {
+    static getFilePath() {
+        const dir = path.join(os.homedir(), '.ppdocs');
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        return path.join(dir, 'discussions.json');
+    }
+    static readAll() {
+        try {
+            const file = this.getFilePath();
+            if (!fs.existsSync(file))
+                return [];
+            return JSON.parse(fs.readFileSync(file, 'utf-8'));
+        }
+        catch {
+            return [];
+        }
+    }
+    static writeAll(data) {
+        fs.writeFileSync(this.getFilePath(), JSON.stringify(data, null, 2), 'utf-8');
+    }
+    static listActive() {
+        return this.readAll()
+            .filter(t => t.status === 'active')
+            .map(({ messages, ...rest }) => rest);
+    }
+    static readByIds(ids) {
+        return this.readAll().filter(t => ids.includes(t.id));
+    }
+    static create(title, initiator, participants, content) {
+        const id = `req_${Math.random().toString(36).substring(2, 9)}`;
+        const now = new Date().toISOString();
+        // 确保发起方始终在参与列表中
+        const allParticipants = participants.includes(initiator) ? [...participants] : [initiator, ...participants];
+        const topic = {
+            id,
+            title,
+            initiator,
+            participants: allParticipants,
+            summary: "等待各方回复中...",
+            status: 'active',
+            created_at: now,
+            updated_at: now,
+            messages: [{
+                    id: `msg_${Math.random().toString(36).substring(2, 9)}`,
+                    sender: initiator,
+                    content,
+                    timestamp: now
+                }]
+        };
+        const all = this.readAll();
+        all.push(topic);
+        this.writeAll(all);
+        return id;
+    }
+    static reply(id, sender, content, newSummary) {
+        const all = this.readAll();
+        const topic = all.find(t => t.id === id);
+        if (!topic || topic.status !== 'active')
+            return false;
+        const now = new Date().toISOString();
+        topic.messages.push({
+            id: `msg_${Math.random().toString(36).substring(2, 9)}`,
+            sender,
+            content,
+            timestamp: now
+        });
+        topic.updated_at = now;
+        if (newSummary) {
+            topic.summary = newSummary;
+        }
+        // Auto add to participants if not exists
+        if (!topic.participants.includes(sender)) {
+            topic.participants.push(sender);
+        }
+        this.writeAll(all);
+        return true;
+    }
+    static getAndRemove(id) {
+        const all = this.readAll();
+        const index = all.findIndex(t => t.id === id);
+        if (index === -1)
+            return null;
+        const topic = all.splice(index, 1)[0];
+        this.writeAll(all);
+        return topic;
+    }
+    /** 按ID删除讨论（不归档，直接删除） */
+    static delete(id) {
+        const all = this.readAll();
+        const index = all.findIndex(t => t.id === id);
+        if (index === -1)
+            return false;
+        all.splice(index, 1);
+        this.writeAll(all);
+        return true;
+    }
+    /** 清理过期讨论（默认7天不活跃） */
+    static cleanExpired(days = 7) {
+        const all = this.readAll();
+        const cutoff = Date.now() - days * 86400000;
+        const before = all.length;
+        const filtered = all.filter(t => new Date(t.updated_at).getTime() > cutoff);
+        if (filtered.length < before) {
+            this.writeAll(filtered);
+        }
+        return before - filtered.length;
+    }
+    /** 获取活跃讨论数量 */
+    static activeCount() {
+        return this.readAll().filter(t => t.status === 'active').length;
+    }
+}