@next-open-ai/openbot 0.2.8 → 0.6.6

package/dist/gateway/methods/install-skill-from-upload.js

@@ -0,0 +1,13 @@
+/**
+ * 在 Gateway 层处理 POST /server-api/skills/install-from-upload，
+ * 接收 multipart zip 文件，委托核心 installer 解压并安装到全局或工作区。
+ */
+import { installSkillFromUpload } from "../../core/installer/index.js";
+export async function handleInstallSkillFromUpload(body) {
+    const { buffer, scope = "global", workspace = "default" } = body;
+    if (!buffer || !Buffer.isBuffer(buffer) || buffer.length === 0) {
+        throw new Error("请上传 zip 文件");
+    }
+    const result = await installSkillFromUpload(buffer, { scope, workspace });
+    return { success: true, data: { installDir: result.installDir, name: result.name } };
+}

package/dist/gateway/methods/run-scheduled-task.js

@@ -49,12 +49,16 @@ export async function handleRunScheduledTask(req, res) {
         if (agentConfig.apiKey)
             apiKey = agentConfig.apiKey;
     }
+    const COMPOSITE_KEY_SEP = "::";
     try {
         const session = await agentManager.getOrCreateSession(sessionId, {
+            agentId: sessionAgentId,
             workspace: resolvedWorkspace,
             provider,
             modelId,
             apiKey,
+            mcpServers: agentConfig?.mcpServers,
+            systemPrompt: agentConfig?.systemPrompt,
         });
         let assistantContent = "";
         let turnPromptTokens = 0;
@@ -120,7 +124,6 @@ export async function handleRunScheduledTask(req, res) {
         res.end(JSON.stringify({ success: false, error: friendlyError }));
     }
     finally {
-        // 执行完成（成功或失败）后立即关闭并移除该 AgentSession，避免空悬占用内存/连接等资源
-        agentManager.deleteSession(sessionId);
+        agentManager.deleteSession(sessionId + COMPOSITE_KEY_SEP + sessionAgentId);
     }
 }

package/dist/gateway/server.js

@@ -31,10 +31,18 @@ import { handleSse } from "./sse-handler.js";
 import { handleVoiceUpgrade } from "./voice-handler.js";
 import { handleConnection } from "./connection-handler.js";
 import { handleRunScheduledTask } from "./methods/run-scheduled-task.js";
+import multer from "multer";
 import { handleInstallSkillFromPath } from "./methods/install-skill-from-path.js";
+import { handleInstallSkillFromUpload } from "./methods/install-skill-from-upload.js";
 import { setBackendBaseUrl } from "./backend-url.js";
-import { ensureDesktopConfigInitialized } from "../core/config/desktop-config.js";
+import { ensureDesktopConfigInitialized, getChannelsConfigSync } from "../core/config/desktop-config.js";
 import { createNestAppEmbedded } from "../server/bootstrap.js";
+import { registerChannel, startAllChannels, stopAllChannels } from "./channel/registry.js";
+import { createFeishuChannel } from "./channel/adapters/feishu.js";
+import { setChannelSessionPersistence } from "./channel/session-persistence.js";
+import { setSessionCurrentAgentResolver, setSessionCurrentAgentUpdater, setAgentListProvider, setCreateAgentProvider, } from "../core/session-current-agent.js";
+import { AgentsService } from "../server/agents/agents.service.js";
+import { AgentConfigService } from "../server/agent-config/agent-config.service.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = join(__dirname, "..", "..");
 /** 内嵌到 Electron 时由主进程设置 OPENBOT_STATIC_DIR，指向打包后的 renderer/dist */
@@ -59,6 +67,27 @@ export async function startGatewayServer(port = 38080) {
     console.log(`Starting gateway server on port ${port}...`);
     setBackendBaseUrl(`http://localhost:${port}`);
     const { app: nestApp, express: nestExpress } = await createNestAppEmbedded();
+    try {
+        const agentsService = nestApp.get(AgentsService);
+        setChannelSessionPersistence(agentsService);
+        setSessionCurrentAgentResolver((sessionId) => agentsService.getSession(sessionId)?.agentId);
+        setSessionCurrentAgentUpdater((sessionId, agentId) => agentsService.updateSessionAgentId(sessionId, agentId));
+        const agentConfigService = nestApp.get(AgentConfigService);
+        setAgentListProvider(() => agentConfigService.listAgents().then((agents) => agents.map((a) => ({ id: a.id, name: a.name }))));
+        setCreateAgentProvider(async (params) => {
+            try {
+                const agent = await agentConfigService.createAgent(params);
+                return { id: agent.id, name: agent.name };
+            }
+            catch (e) {
+                const msg = e?.message ?? e?.response?.message ?? String(e);
+                return { error: msg };
+            }
+        });
+    }
+    catch (e) {
+        console.warn("[Gateway] Channel session persistence / session-agent bridge unavailable:", e);
+    }
     const gatewayExpress = express();
     gatewayExpress.get(PATHS.HEALTH, (_req, res) => {
         res.status(200).json({ status: "ok", timestamp: Date.now() });
@@ -66,6 +95,10 @@ export async function startGatewayServer(port = 38080) {
     gatewayExpress.post(PATHS.RUN_SCHEDULED_TASK, async (req, res) => {
         await handleRunScheduledTask(req, res);
     });
+    const uploadZip = multer({
+        storage: multer.memoryStorage(),
+        limits: { fileSize: 10 * 1024 * 1024 },
+    });
     gatewayExpress.post(`${PATHS.SERVER_API}/skills/install-from-path`, async (req, res) => {
         const body = await new Promise((resolve, reject) => {
             const chunks = [];
@@ -88,6 +121,24 @@ export async function startGatewayServer(port = 38080) {
             res.status(code).json({ success: false, message });
         }
     });
+    gatewayExpress.post(`${PATHS.SERVER_API}/skills/install-from-upload`, authHookServerApi, uploadZip.single("file"), async (req, res) => {
+        try {
+            const file = req.file;
+            const buffer = file?.buffer;
+            if (!buffer || !Buffer.isBuffer(buffer)) {
+                return res.status(400).json({ success: false, message: "请上传 zip 文件" });
+            }
+            const scope = req.body?.scope === "workspace" ? "workspace" : "global";
+            const workspace = req.body?.workspace ?? "default";
+            const result = await handleInstallSkillFromUpload({ buffer, scope, workspace });
+            res.status(200).json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const code = message.includes("请上传") || message.includes("SKILL.md") || message.includes("目录") || message.includes("10MB") ? 400 : 500;
+            res.status(code).json({ success: false, message });
+        }
+    });
     gatewayExpress.use(PATHS.SERVER_API, authHookServerApi, nestExpress);
     gatewayExpress.use(PATHS.CHANNEL, authHookChannel, (req, res) => handleChannel(req, res));
     gatewayExpress.use(PATHS.SSE, authHookSse, (req, res) => handleSse(req, res));
@@ -154,8 +205,30 @@ export async function startGatewayServer(port = 38080) {
             resolve(p);
         });
     });
+    // 通道：根据配置注册并启动（如飞书 WebSocket）
+    const channelsConfig = getChannelsConfigSync();
+    const feishuCfg = channelsConfig.feishu;
+    if (feishuCfg?.enabled && feishuCfg.appId?.trim() && feishuCfg.appSecret?.trim()) {
+        try {
+            console.log("[Channel] Starting Feishu (WebSocket)...");
+            const feishuChannel = createFeishuChannel({
+                appId: feishuCfg.appId.trim(),
+                appSecret: feishuCfg.appSecret.trim(),
+                defaultAgentId: feishuCfg.defaultAgentId?.trim() || "default",
+            });
+            registerChannel(feishuChannel);
+            await startAllChannels();
+        }
+        catch (e) {
+            console.warn("Feishu channel start failed:", e);
+        }
+    }
+    else if (feishuCfg?.enabled) {
+        console.warn("[Channel] Feishu is enabled but appId or appSecret is missing; skip start. Check Settings → Channels.");
+    }
     const close = async () => {
         console.log("Closing gateway server...");
+        await stopAllChannels();
         await nestApp.close();
         wss.clients.forEach((c) => c.close());
         await new Promise((r) => wss.close(() => r()));

package/dist/server/agent-config/agent-config.controller.d.ts

@@ -16,11 +16,16 @@ export declare class AgentConfigController {
     createAgent(body: {
         name: string;
         workspace: string;
+        provider?: string;
+        model?: string;
+        modelItemCode?: string;
+        systemPrompt?: string;
+        icon?: string;
     }): Promise<{
         success: boolean;
         data: AgentConfigItem;
     }>;
-    updateAgent(id: string, body: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode'>>): Promise<{
+    updateAgent(id: string, body: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon'>>): Promise<{
         success: boolean;
         data: AgentConfigItem;
     }>;

package/dist/server/agent-config/agent-config.service.d.ts

@@ -1,3 +1,4 @@
+import type { McpServerConfig } from '../../core/mcp/index.js';
 /** 缺省智能体 ID / 工作空间名，不可删除；对应目录 ~/.openbot/workspace/default */
 export declare const DEFAULT_AGENT_ID = "default";
 /**
@@ -14,6 +15,12 @@ export interface AgentConfigItem {
     modelItemCode?: string;
     /** 是否为系统缺省智能体（主智能体），不可删除 */
     isDefault?: boolean;
+    /** MCP 服务器配置列表，创建 Session 时传入（与 Skill 类似） */
+    mcpServers?: McpServerConfig[];
+    /** 自定义系统提示词，会与技能等一起组成最终 systemPrompt */
+    systemPrompt?: string;
+    /** 智能体图标标识（前端预设图标 id，如 default、star、code 等） */
+    icon?: string;
 }
 export declare class AgentConfigService {
     private configDir;
@@ -30,8 +37,15 @@ export declare class AgentConfigService {
     createAgent(params: {
         name: string;
         workspace: string;
+        provider?: string;
+        model?: string;
+        modelItemCode?: string;
+        /** 自定义系统提示词；可由用户描述生成，创建后可在详情页修改 */
+        systemPrompt?: string;
+        /** 智能体图标标识 */
+        icon?: string;
     }): Promise<AgentConfigItem>;
-    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode'>>): Promise<AgentConfigItem>;
+    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon'>>): Promise<AgentConfigItem>;
     deleteAgent(id: string): Promise<void>;
     /**
      * 根据 config 的 defaultProvider / defaultModel / defaultModelItemCode 及 configuredModels 同步 agents.json 中缺省智能体的 provider、model、modelItemCode。

package/dist/server/agent-config/agent-config.service.js

@@ -93,7 +93,7 @@ let AgentConfigService = class AgentConfigService {
         return null;
     }
     async createAgent(params) {
-        const { name, workspace } = params;
+        const { name, workspace, provider, model, modelItemCode, systemPrompt, icon } = params;
         if (workspace === DEFAULT_AGENT_ID) {
             throw new BadRequestException('工作空间名 default 为系统保留（主智能体），请使用其他名称');
         }
@@ -118,8 +118,11 @@ let AgentConfigService = class AgentConfigService {
             id: workspace,
             name: trimmedName,
             workspace,
-            provider: undefined,
-            model: undefined,
+            provider: provider?.trim() || undefined,
+            model: model?.trim() || undefined,
+            modelItemCode: modelItemCode?.trim() || undefined,
+            systemPrompt: systemPrompt?.trim() || undefined,
+            icon: icon?.trim() || undefined,
         };
         file.agents.push(agent);
         await this.writeAgentsFile(file);
@@ -150,6 +153,12 @@ let AgentConfigService = class AgentConfigService {
             agent.model = updates.model;
         if (updates.modelItemCode !== undefined)
             agent.modelItemCode = updates.modelItemCode;
+        if (updates.mcpServers !== undefined)
+            agent.mcpServers = updates.mcpServers;
+        if (updates.systemPrompt !== undefined)
+            agent.systemPrompt = updates.systemPrompt?.trim() || undefined;
+        if (updates.icon !== undefined)
+            agent.icon = updates.icon?.trim() || undefined;
         await this.writeAgentsFile(file);
         return { ...agent, isDefault: agent.id === DEFAULT_AGENT_ID };
     }

package/dist/server/agents/agents.controller.d.ts

@@ -22,6 +22,12 @@ export declare class AgentsController {
         success: boolean;
         data: import("./agents.service.js").AgentSession;
     };
+    updateSession(id: string, body: {
+        agentId?: string;
+    }): {
+        success: boolean;
+        data: import("./agents.service.js").AgentSession | undefined;
+    };
     deleteSession(id: string): Promise<{
         success: boolean;
         message: string;
@@ -30,6 +36,10 @@ export declare class AgentsController {
         success: boolean;
         data: import("./agents.service.js").ChatMessage[];
     };
+    clearHistory(id: string): {
+        success: boolean;
+        message: string;
+    };
     appendMessage(id: string, body: {
         role: 'user' | 'assistant';
         content: string;

package/dist/server/agents/agents.controller.js

@@ -10,7 +10,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { Controller, Get, Post, Delete, Body, Param, HttpException, HttpStatus, } from '@nestjs/common';
+import { Controller, Delete, Get, Patch, Post, Body, Param, Header, HttpException, HttpStatus, } from '@nestjs/common';
 import { AgentsService } from './agents.service.js';
 let AgentsController = class AgentsController {
     agentsService;
@@ -46,11 +46,19 @@ let AgentsController = class AgentsController {
             data: session,
         };
     }
-    async deleteSession(id) {
-        const deleted = await this.agentsService.deleteSession(id);
-        if (!deleted) {
+    updateSession(id, body) {
+        const session = this.agentsService.getSession(id);
+        if (!session) {
             throw new HttpException('Session not found', HttpStatus.NOT_FOUND);
         }
+        if (body.agentId != null) {
+            this.agentsService.updateSessionAgentId(id, String(body.agentId));
+        }
+        const updated = this.agentsService.getSession(id);
+        return { success: true, data: updated };
+    }
+    async deleteSession(id) {
+        await this.agentsService.deleteSession(id);
         return {
             success: true,
             message: 'Session deleted',
@@ -63,6 +71,14 @@ let AgentsController = class AgentsController {
             data: history,
         };
     }
+    clearHistory(id) {
+        const session = this.agentsService.getSession(id);
+        if (!session) {
+            throw new HttpException('Session not found', HttpStatus.NOT_FOUND);
+        }
+        this.agentsService.clearSessionMessages(id);
+        return { success: true, message: 'Messages cleared' };
+    }
     appendMessage(id, body) {
         this.agentsService.appendMessage(id, body.role, body.content, {
             toolCalls: body.toolCalls,
@@ -80,6 +96,7 @@ __decorate([
 ], AgentsController.prototype, "createSession", null);
 __decorate([
     Get('sessions'),
+    Header('Cache-Control', 'no-store'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
@@ -91,6 +108,14 @@ __decorate([
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", void 0)
 ], AgentsController.prototype, "getSession", null);
+__decorate([
+    Patch('sessions/:id'),
+    __param(0, Param('id')),
+    __param(1, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", void 0)
+], AgentsController.prototype, "updateSession", null);
 __decorate([
     Delete('sessions/:id'),
     __param(0, Param('id')),
@@ -105,6 +130,13 @@ __decorate([
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", void 0)
 ], AgentsController.prototype, "getHistory", null);
+__decorate([
+    Delete('sessions/:id/messages'),
+    __param(0, Param('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", void 0)
+], AgentsController.prototype, "clearHistory", null);
 __decorate([
     Post('sessions/:id/messages'),
     __param(0, Param('id')),

package/dist/server/agents/agents.gateway.js

@@ -51,14 +51,28 @@ let AgentsGateway = class AgentsGateway {
             client.emit('agent_tool', data);
         });
         subscriptions.set('tool', unsubTool);
-        // Subscribe to message completion
+        // turn_end / agent_end：各通道均可收到，按自身逻辑处理（如 desktop 用 agent_end 开放输入）
+        const unsubTurnEnd = this.agentsService.addEventListener('turn_end', (data) => {
+            if (data.sessionId === sessionId)
+                client.emit('turn_end', data);
+        });
+        subscriptions.set('turn_end', unsubTurnEnd);
+        const unsubAgentEnd = this.agentsService.addEventListener('agent_end', (data) => {
+            if (data.sessionId === sessionId)
+                client.emit('agent_end', data);
+        });
+        subscriptions.set('agent_end', unsubAgentEnd);
+        // 兼容：message_complete（turn_end 语义）、conversation_end（agent_end 语义）
         const unsubComplete = this.agentsService.addEventListener('message_complete', (data) => {
-            // Ensure we only emit for the subscribed session
-            if (data.sessionId === sessionId) {
+            if (data.sessionId === sessionId)
                 client.emit('message_complete', data);
-            }
         });
         subscriptions.set('complete', unsubComplete);
+        const unsubConversationEnd = this.agentsService.addEventListener('conversation_end', (data) => {
+            if (data.sessionId === sessionId)
+                client.emit('conversation_end', data);
+        });
+        subscriptions.set('conversation_end', unsubConversationEnd);
         this.sessionSubscriptions.set(client.id, subscriptions);
         return { success: true };
     }

package/dist/server/agents/agents.service.d.ts

@@ -53,11 +53,15 @@ export declare class AgentsService {
     }): Promise<AgentSession>;
     getSessions(): AgentSession[];
     getSession(sessionId: string): AgentSession | undefined;
-    deleteSession(sessionId: string): Promise<boolean>;
+    /** 更新会话的当前 agent（同一 session 内切换 agent 时调用） */
+    updateSessionAgentId(sessionId: string, agentId: string): void;
+    deleteSession(sessionId: string): Promise<void>;
     getMessageHistory(sessionId: string): ChatMessage[];
     addAssistantMessage(sessionId: string, content: string): void;
     appendMessage(sessionId: string, role: 'user' | 'assistant', content: string, options?: {
         toolCalls?: any[];
         contentParts?: any[];
     }): void;
+    /** 清除会话的所有对话消息（保留会话本身，message_count 置 0） */
+    clearSessionMessages(sessionId: string): void;
 }

package/dist/server/agents/agents.service.js

@@ -134,10 +134,19 @@ let AgentsService = class AgentsService {
         const r = this.db.get('SELECT * FROM sessions WHERE id = ?', [sessionId]);
         return r ? this.rowToSession(r) : undefined;
     }
+    /** 更新会话的当前 agent（同一 session 内切换 agent 时调用） */
+    updateSessionAgentId(sessionId, agentId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            return;
+        this.db.run('UPDATE sessions SET agent_id = ? WHERE id = ?', [agentId, sessionId]);
+    }
     async deleteSession(sessionId) {
-        agentManager.deleteSession(sessionId);
         const result = this.db.run('DELETE FROM sessions WHERE id = ?', [sessionId]);
-        return result.changes > 0;
+        if (result.changes > 0) {
+            this.db.persist();
+        }
+        agentManager.deleteSessionsByBusinessId(sessionId);
     }
     getMessageHistory(sessionId) {
         const rows = this.db.all('SELECT * FROM chat_messages WHERE session_id = ? ORDER BY timestamp ASC', [sessionId]);
@@ -159,6 +168,15 @@ let AgentsService = class AgentsService {
         this.db.run(`INSERT INTO chat_messages (id, session_id, role, content, timestamp, tool_calls_json) VALUES (?, ?, ?, ?, ?, ?)`, [id, sessionId, role, content, now, toolCallsJson]);
         this.db.run('UPDATE sessions SET last_active_at = ?, status = ?, message_count = message_count + 1 WHERE id = ?', [now, role === 'assistant' ? 'idle' : session.status, sessionId]);
     }
+    /** 清除会话的所有对话消息（保留会话本身，message_count 置 0） */
+    clearSessionMessages(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            return;
+        this.db.run('DELETE FROM chat_messages WHERE session_id = ?', [sessionId]);
+        this.db.run('UPDATE sessions SET message_count = 0 WHERE id = ?', [sessionId]);
+        this.db.persist();
+    }
 };
 AgentsService = __decorate([
     Injectable(),

package/dist/server/app.module.js

@@ -15,6 +15,7 @@ import { UsersModule } from './users/users.module.js';
 import { WorkspaceModule } from './workspace/workspace.module.js';
 import { TasksModule } from './tasks/tasks.module.js';
 import { UsageModule } from './usage/usage.module.js';
+import { SavedItemsModule } from './saved-items/saved-items.module.js';
 let AppModule = class AppModule {
 };
 AppModule = __decorate([
@@ -30,6 +31,7 @@ AppModule = __decorate([
             WorkspaceModule,
             TasksModule,
             UsageModule,
+            SavedItemsModule,
         ],
     })
 ], AppModule);

package/dist/server/config/config.controller.d.ts

@@ -26,6 +26,7 @@ export declare class ConfigController {
                 embeddingProvider?: string;
                 embeddingModel?: string;
             };
+            channels?: import("../../core/config/desktop-config.js").ChannelsConfig;
         };
     }>;
     updateConfig(updates: Partial<AppConfig>): Promise<{
@@ -52,6 +53,7 @@ export declare class ConfigController {
                 embeddingProvider?: string;
                 embeddingModel?: string;
             };
+            channels?: import("../../core/config/desktop-config.js").ChannelsConfig;
         };
     }>;
     getProviders(): Promise<{

package/dist/server/config/config.service.d.ts

@@ -1,3 +1,4 @@
+import { type ChannelsConfig } from '../../core/config/desktop-config.js';
 import { AgentConfigService } from '../agent-config/agent-config.service.js';
 /** 模型 cost 配置，写入 models.json；缺省均为 0 */
 export interface ModelCost {
@@ -55,6 +56,8 @@ export interface AppConfig {
         embeddingProvider?: string;
         embeddingModel?: string;
     };
+    /** 通道配置：飞书、Telegram 等 token/key */
+    channels?: ChannelsConfig;
 }
 export declare class ConfigService {
     private readonly agentConfigService;

package/dist/server/config/config.service.js

@@ -11,6 +11,7 @@ import { Injectable } from '@nestjs/common';
 import { readFile, writeFile, mkdir } from 'fs/promises';
 import { join } from 'path';
 import { existsSync } from 'fs';
+import { homedir } from 'os';
 import { getProviderSupport, syncDesktopConfigToModelsJson } from '../../core/config/desktop-config.js';
 import { AgentConfigService } from '../agent-config/agent-config.service.js';
 let ConfigService = class ConfigService {
@@ -19,7 +20,7 @@ let ConfigService = class ConfigService {
     config;
     constructor(agentConfigService) {
         this.agentConfigService = agentConfigService;
-        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+        const homeDir = process.env.HOME || process.env.USERPROFILE || homedir();
         const configDir = join(homeDir, '.openbot', 'desktop');
         this.configPath = join(configDir, 'config.json');
         // Ensure config directory exists
@@ -40,6 +41,7 @@ let ConfigService = class ConfigService {
             providers: {},
             configuredModels: [],
             rag: undefined,
+            channels: {},
         };
     }
     /** 当前缺省智能体 id */

package/dist/server/database/database.service.d.ts

@@ -13,6 +13,13 @@ export declare class DatabaseService implements OnModuleInit, OnModuleDestroy {
     private getDb;
     private runMigrations;
     run(sql: string, params?: unknown[]): RunResult;
+    /**
+     * 使用文件 DB 时立即落盘。每次 run() 写入后都会调用，保证「每次保存马上写到磁盘」。
+     * 落盘失败时重新抛出，便于上层返回错误、前端不乐观更新，避免「删了但重启又出现」。
+     */
+    private persistIfFile;
+    /** 供删除等关键操作后显式落盘，确保删除结果持久化 */
+    persist(): void;
     get<T>(sql: string, params?: unknown[]): T | undefined;
     all<T>(sql: string, params?: unknown[]): T[];
     onModuleDestroy(): void;

package/dist/server/database/database.service.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Injectable } from '@nestjs/common';
 import { mkdirSync, existsSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { join, resolve } from 'path';
 import { homedir } from 'os';
 let DatabaseService = class DatabaseService {
     sqlDb = null;
@@ -25,7 +25,8 @@ let DatabaseService = class DatabaseService {
             ? ':memory:'
             : pathEnv ?? join(process.env.OPENBOT_DB_DIR ?? defaultDir, 'openbot.db');
         if (path !== ':memory:') {
-            const dir = path.endsWith('.db') ? join(path, '..') : path;
+            const resolvedPath = resolve(path);
+            const dir = resolvedPath.endsWith('.db') ? join(resolvedPath, '..') : resolvedPath;
             if (!existsSync(dir)) {
                 mkdirSync(dir, { recursive: true });
             }
@@ -38,18 +39,23 @@ let DatabaseService = class DatabaseService {
             this.dbPath = ':memory:';
         }
         else {
-            if (existsSync(path)) {
-                const buf = readFileSync(path);
+            const absolutePath = resolve(path);
+            if (existsSync(absolutePath)) {
+                const buf = readFileSync(absolutePath);
                 db = new SQL.Database(new Uint8Array(buf));
             }
             else {
                 db = new SQL.Database();
             }
-            this.dbPath = path;
+            this.dbPath = absolutePath;
         }
         this.sqlDb = db;
         db.run('PRAGMA foreign_keys = ON;');
         this.runMigrations();
+        if (path !== ':memory:') {
+            this.persistIfFile();
+            console.log('[DatabaseService] Database file:', this.dbPath);
+        }
     }
     getDb() {
         if (!this.sqlDb) {
@@ -127,6 +133,28 @@ let DatabaseService = class DatabaseService {
           );
           CREATE INDEX IF NOT EXISTS idx_token_usage_session_id ON token_usage(session_id);
           CREATE INDEX IF NOT EXISTS idx_token_usage_created_at ON token_usage(created_at);
+
+          CREATE TABLE IF NOT EXISTS tags (
+            id TEXT PRIMARY KEY,
+            name TEXT UNIQUE NOT NULL,
+            sort_order INTEGER NOT NULL DEFAULT 0,
+            created_at INTEGER NOT NULL
+          );
+          CREATE TABLE IF NOT EXISTS saved_items (
+            id TEXT PRIMARY KEY,
+            url TEXT NOT NULL,
+            title TEXT,
+            workspace TEXT NOT NULL DEFAULT 'default',
+            created_at INTEGER NOT NULL
+          );
+          CREATE TABLE IF NOT EXISTS saved_item_tags (
+            saved_item_id TEXT NOT NULL,
+            tag_id TEXT NOT NULL,
+            PRIMARY KEY (saved_item_id, tag_id),
+            FOREIGN KEY (saved_item_id) REFERENCES saved_items(id) ON DELETE CASCADE,
+            FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
+          );
+          CREATE INDEX IF NOT EXISTS idx_saved_item_tags_tag_id ON saved_item_tags(tag_id);
         `;
         const statements = ddl.split(';').map((s) => s.trim()).filter(Boolean);
         for (const stmt of statements) {
@@ -148,11 +176,32 @@ let DatabaseService = class DatabaseService {
     run(sql, params = []) {
         const db = this.getDb();
         db.run(sql, params);
+        this.persistIfFile();
         const rows = db.exec('SELECT changes() AS c, last_insert_rowid() AS id');
         const c = rows[0]?.values?.[0]?.[0] ?? 0;
         const id = rows[0]?.values?.[0]?.[1] ?? 0;
         return { changes: Number(c), lastInsertRowid: Number(id) };
     }
+    /**
+     * 使用文件 DB 时立即落盘。每次 run() 写入后都会调用，保证「每次保存马上写到磁盘」。
+     * 落盘失败时重新抛出，便于上层返回错误、前端不乐观更新，避免「删了但重启又出现」。
+     */
+    persistIfFile() {
+        if (!this.sqlDb || !this.dbPath || this.dbPath === ':memory:')
+            return;
+        try {
+            const data = this.sqlDb.export();
+            writeFileSync(this.dbPath, Buffer.from(data));
+        }
+        catch (e) {
+            console.error('[DatabaseService] Failed to persist database:', e);
+            throw e;
+        }
+    }
+    /** 供删除等关键操作后显式落盘，确保删除结果持久化 */
+    persist() {
+        this.persistIfFile();
+    }
     get(sql, params = []) {
         const db = this.getDb();
         const stmt = db.prepare(sql);