@next-open-ai/openbot 0.2.1 → 0.2.8

package/README.md

@@ -36,7 +36,7 @@
          ▼                        ▼                             ▼
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                            Gateway Server (Node)                             │
-│  • 静态资源 • 自动发现端口 • 子进程拉起 Desktop Server                        │
+│  • 内嵌 Nest（/server-api）• 按 path 分流 • 静态资源 • 自动发现端口             │
 └────────────────────────────────────┬────────────────────────────────────────┘
                                       │
          ┌────────────────────────────┼────────────────────────────┐
@@ -55,21 +55,55 @@
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
-- **CLI**：直接调用 Agent 核心，单次提示或批量脚本。
-- **WebSocket Gateway**（`src/gateway/`）：对外提供 WebSocket（JSON-RPC），供 Web/移动端连接；负责起端口、拉 Nest 后端子进程、代理 `/server-api` 请求。**与「Desktop 后端」是不同进程。**
-- **Desktop 后端**（`src/server/`）：NestJS HTTP API，即 **server-api**；默认端口 38081。会话、智能体配置、技能、任务、工作区、鉴权等由本模块提供。
+- **CLI**：直接调用 Agent 核心，单次提示或批量脚本；可启动 Gateway（`openbot gateway`）及配置开机自启（`openbot service install/uninstall`）。
+- **WebSocket Gateway**（`src/gateway/`）：单进程内嵌 Nest，对外提供 WebSocket（JSON-RPC）与 HTTP；按 path 分流：`/server-api` 走 Nest、`/ws` 为 Agent 对话、`/ws/voice`/`/sse`/`/channel` 为扩展占位，其余为静态资源。供 Web/移动端连接；支持以开机/登录自启方式常驻（Linux cron、macOS LaunchAgent、Windows 计划任务）。
+- **Desktop 后端**（`src/server/`）：NestJS HTTP API，即 **server-api**；可被 Gateway 内嵌或独立监听（默认端口 38081）。会话、智能体配置、技能、任务、工作区、鉴权等由本模块提供。
 - **Desktop**：Electron 包一层 Vue 前端 + 上述后端；通过 Gateway 或直连 Desktop 后端与 Agent 通信。
 - **Agent 核心**：统一由 `AgentManager` 管理会话、技能注入与工具注册；记忆与 compaction 作为扩展参与 system prompt 与经验写入。
 
+### 项目目录结构
+
+```
+openbot/
+├── src/                    # 源码（构建输出 dist/）
+│   ├── core/               # 公共核心，CLI 与 Gateway 共用
+│   │   ├── agent/          # AgentManager、run、技能与配置
+│   │   ├── config/         # 桌面配置（~/.openbot/desktop）
+│   │   ├── memory/         # 向量存储、嵌入、compaction
+│   │   ├── installer/      # 技能安装
+│   │   └── tools/          # 内置工具（browser、install-skill、save-experience 等）
+│   ├── cli/                # CLI 入口与 service 子命令
+│   │   ├── cli.ts          # 主入口，构建为 dist/cli/cli.js
+│   │   └── service.ts      # 开机自启 install/uninstall/stop
+│   ├── gateway/            # WebSocket 网关（内嵌 Nest、path 分流）
+│   ├── server/             # Desktop 后端（NestJS）
+│   ├── cli.ts              # 兼容入口，仅转发到 cli/cli.js
+│   └── index.ts            # 包导出
+├── apps/
+│   ├── desktop/            # Electron + Vue 桌面端
+│   ├── web/                # 预留
+│   ├── mobile/             # 预留
+│   ├── miniprogram/        # 预留
+│   └── browser-extension/  # 预留
+├── deploy/                 # Docker、K8s 等部署
+├── test/                   # 单元与 e2e 测试
+├── examples/               # 示例（含 workspace、gateway-client）
+└── skills/                 # 内置技能（find-skills、agent-browser）
+```
+
 ### 目录与模块对应
 
 | 目录 | 说明 |
 |------|------|
-| `src/server/` | **Desktop 后端**（NestJS），HTTP API，前缀 `server-api`。 |
-| `src/gateway/` | **WebSocket 网关**，独立进程，提供 WS JSON-RPC 并代理到 Desktop 后端。 |
-| `src/agent/` | Agent 核心（CLI 与 Gateway 共用）。 |
-| `src/config/` | 桌面配置（~/.openbot/desktop）：config.json、agents.json、provider-support.json；CLI 与 Gateway 共用。 |
-| `examples/workspace/` | 示例工作区数据（仅示例/测试用）。真实工作区根目录为 `~/.openbot/workspace/`。 |
+| `src/core/` | **公共核心**：`agent/`（AgentManager、pi-coding-agent）、`config/`（桌面配置）、`memory/`、`installer/`、`tools/`；CLI 与 Gateway 共用。 |
+| `src/cli/` | **CLI**：`cli.ts` 主入口（构建为 `dist/cli/cli.js`），`service.ts` 提供开机自启（install/uninstall/stop）。 |
+| `src/gateway/` | **WebSocket 网关**：单进程内嵌 Nest，按 path 分流：`/server-api`、`/ws`、`/ws/voice`、`/sse`、`/channel`、`/health`、静态资源（`apps/desktop/renderer/dist`）。 |
+| `src/server/` | **Desktop 后端**（NestJS），HTTP API 前缀 `server-api`；可内嵌到 Gateway 或独立监听。 |
+| `apps/desktop/` | **桌面端**（Electron + Vue），前端构建产物由 Gateway 提供。 |
+| `deploy/` | Dockerfile、K8s 等部署配置。 |
+| `test/` | 单元与 e2e 测试（config、gateway、server、installer）。 |
+| `examples/` | 示例工作区、gateway 客户端等。真实工作区根目录为 `~/.openbot/workspace/`。 |
+| `skills/` | 内置技能（SKILL.md 规范）。 |
 
 ---
 
@@ -82,8 +116,9 @@
 | 运行时 | Node.js 20+ |
 | 语言 | TypeScript 5.7 |
 | 入口 | `openbot`（bin → `dist/cli/cli.js`） |
-| 框架 | Commander（子命令：`gateway`、`login`、`config`） |
-| 配置 | `~/.openbot/agent`（API Key、模型、技能等） |
+| 框架 | Commander（子命令：`gateway`、`login`、`config`、`service`） |
+| 配置 | `~/.openbot/agent`（API Key、模型、技能等）；`~/.openbot/desktop`（与桌面共用） |
+| 开机自启 | `openbot service install` / `uninstall`（Linux cron、macOS LaunchAgent、Windows 计划任务）；`openbot service stop` 停止当前 gateway |
 
 ### WebSocket Gateway
 
@@ -91,7 +126,8 @@
 |------|------|
 | 协议 | JSON-RPC over WebSocket（`ws`） |
 | 端口 | 默认 38080，可 `-p` 指定 |
-| 职责 | 连接管理、消息路由、静态资源、拉 Nest 子进程 |
+| 架构 | 单进程内嵌 Nest；按 path 分流：`/server-api`、`/ws`、`/ws/voice`、`/sse`、`/channel`、`/health`、静态资源 |
+| 职责 | 连接管理、消息路由、鉴权钩子、静态资源（Desktop 前端） |
 | 方法 | `connect`、`agent.chat`、`agent.cancel`、`subscribe_session`、`unsubscribe_session` 等 |
 
 ### Agent 核心
@@ -156,8 +192,29 @@
 
 适用于：使用 **CLI**，或在自有环境中运行 **Gateway（Web）**。
 
+### 前置环境准备
+
+需先安装 **Node.js 20+**（Node >=20）。任选一种方式安装即可：
+
+| 方式 | 说明 |
+|------|------|
+| **官网安装包** | 打开 [nodejs.org](https://nodejs.org/)，下载 LTS 并安装；安装后终端执行 `node -v` 应显示 v20.x 或更高。 |
+| **nvm（推荐）** | 多版本切换方便：`curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh \| bash`，重启终端后 `nvm install 20`、`nvm use 20`。 |
+| **macOS (Homebrew)** | `brew install node@20`，或 `brew install nvm` 再用 nvm 安装 20。 |
+| **Windows** | 使用 [nodejs.org](https://nodejs.org/) 安装包，或 `winget install OpenJS.NodeJS.LTS`。 |
+| **Linux** | 使用发行版包管理器（如 `apt install nodejs`）或 [nvm](https://github.com/nvm-sh/nvm) 安装。 |
+
+安装后请确认：
+
+```bash
+node -v   # 应为 v20.x 或 v22.x
+npm -v    # 能正常输出版本号
+```
+
+### 安装命令
+
 ```bash
-# 全局安装（测试过node版本：20/22 24太新，有一些库要本地编译环境）
+# 全局安装（测试过 node 版本：20/22；24 太新，部分库需本地编译环境）
 npm install -g @next-open-ai/openbot
 ```
 
@@ -196,6 +253,8 @@ npm link   # 或 npm install -g . 本地全局安装
 - 从 [Releases](https://github.com/next-open-ai/openbot/releases) 下载对应平台的安装包（macOS / Windows）。
 - 安装后启动 OpenBot Desktop，按界面引导配置 API Key 与默认模型即可使用。
 
+安装包由仓库通过 **Desktop 打包** 流程生成（见下方「三、开发 → 3.3 Desktop 开发 → Desktop 打包」）。
+
 首次使用建议在设置中配置默认 Provider/模型，或通过 CLI 执行 `openbot login <provider> <apiKey> [model]` / `openbot config set-model <provider> <modelId>`（与桌面端共用 `~/.openbot/desktop/` 配置）。
 
 ---
@@ -268,6 +327,8 @@ openbot "总结一下当前有哪些技能"
 openbot gateway --port 38080
 ```
 
+若需网关开机/登录自启，可执行 `openbot service install`（支持 Linux / macOS / Windows）；移除自启用 `openbot service uninstall`，停止当前网关用 `openbot service stop`。
+
 客户端连接 `ws://localhost:38080`，使用 JSON-RPC 调用 `connect`、`agent.chat`、`agent.cancel` 等（详见下方「Gateway API 简述」）。  
 前端可自行实现或使用仓库内 Web 示例（若有）。
 
@@ -326,8 +387,9 @@ npm run build
 ## 3.1 CLI 开发
 
 - 入口：`openbot` → bin → `dist/cli/cli.js`
-- 技术：Commander（子命令 `gateway`、`login`、`config`）、TypeScript 5.7
+- 技术：Commander（子命令 `gateway`、`login`、`config`、`service`）、TypeScript 5.7
 - 配置与数据：`~/.openbot/agent`、`~/.openbot/desktop`（与桌面共用）
+- Gateway 开机自启：`openbot service install` / `uninstall` / `stop`（见 `src/cli/service.ts`）
 
 修改 CLI 后重新构建并本地安装：
 
@@ -341,7 +403,7 @@ openbot --help
 
 ## 3.2 Web 开发（Gateway + 前端）
 
-- **Gateway**：`src/gateway/`，默认端口 38080，可 `-p` 指定；协议 JSON-RPC over WebSocket；职责包括连接管理、消息路由、静态资源、拉 Nest 子进程。
+- **Gateway**：`src/gateway/`，默认端口 38080，可 `-p` 指定；单进程内嵌 Nest，按 path 分流（`/server-api`、`/ws`、静态资源等）；协议 JSON-RPC over WebSocket；职责包括连接管理、消息路由、鉴权、静态资源。
 - **方法**：`connect`、`agent.chat`、`agent.cancel`、`subscribe_session`、`unsubscribe_session` 等。
 
 本地启动网关：
@@ -357,7 +419,7 @@ openbot gateway --port 38080
 
 ## 3.3 Desktop 开发
 
-- **后端**：NestJS（`src/server/`），前缀 `server-api`，默认端口 38081；Gateway 启动时会拉该子进程并代理 `/server-api`。
+- **后端**：NestJS（`src/server/`），前缀 `server-api`，默认端口 38081；Gateway 内嵌时直接挂载该 Express，无独立子进程。
 - **前端**：Electron 28 + Vue 3 + Pinia + Vite 5，位于 `apps/desktop/`。
 
 ```bash
@@ -371,6 +433,33 @@ npm run desktop:dev
 npm run desktop:install
 ```
 
+### Desktop 打包
+
+从源码构建可安装的桌面安装包（DMG/NSIS/AppImage），供发布或本地安装使用。
+
+**命令（在仓库根目录执行）：**
+
+```bash
+npm run desktop:pack
+```
+
+该命令会依次执行：
+
+1. **根目录构建**：`npm run build`，生成 `dist/`（含 Gateway、Server、Agent 等）。
+2. **桌面构建**：`cd apps/desktop && npm run build`，其中包含：
+   - **build:gateway**：若需则再次构建根目录 `dist`；
+   - **build:copy-gateway**：将根目录 `dist` 复制到 `apps/desktop/gateway-dist`，写入 `package.json`（`type: "module"` + 生产依赖），并执行 `npm install --production`，得到带 `node_modules` 的 gateway 运行时；
+   - **build:renderer**：Vite 构建前端到 `renderer/dist`；
+   - **electron-builder**：打包为各平台安装包，并将 `gateway-dist` 作为 **extraResources** 拷贝到应用内 `Contents/Resources/dist`（含 Gateway 代码与依赖），无需用户安装 Node 即可运行。
+
+**产出物：**
+
+- **macOS**：`apps/desktop/dist/` 下生成 `.dmg`、`.zip`（如 `OpenBot Desktop-0.1.1-arm64.dmg`）；
+- **Windows**：nsis 安装程序；
+- **Linux**：AppImage。
+
+安装包安装后，Gateway 与前端均内嵌在应用内，用户无需单独安装 Node.js。
+
 ---
 
 ## 测试

package/apps/desktop/renderer/dist/index.html

@@ -5,7 +5,7 @@
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>OpenBot Desktop</title>
+    <title>OpenBot</title>
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link

package/dist/cli/cli.js

@@ -6,6 +6,7 @@ import { Command } from "commander";
 import { getOpenbotAgentDir } from "../core/agent/agent-dir.js";
 import { run } from "../core/agent/run.js";
 import { loadDesktopAgentConfig, getBoundAgentIdForCli, setProviderApiKey, setDefaultModel, getDesktopConfigList, syncDesktopConfigToModelsJson, ensureDesktopConfigInitialized, } from "../core/config/desktop-config.js";
+import { writeGatewayPid, removeGatewayPidFile, serviceInstall, serviceUninstall, serviceStop, } from "./service.js";
 const require = createRequire(import.meta.url);
 const PKG = require("../../package.json");
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -107,17 +108,42 @@ program
         console.error("Error: Invalid port number");
         process.exit(1);
     }
+    writeGatewayPid();
     const { startGatewayServer } = await import("../gateway/index.js");
     const { close } = await startGatewayServer(port);
-    // Handle graceful shutdown
     const shutdown = async () => {
         console.log("\nShutting down...");
+        removeGatewayPidFile();
         await close();
         process.exit(0);
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
 });
+// Service: 开机自启 install / uninstall，以及 stop
+const serviceCmd = program
+    .command("service")
+    .description("Gateway 开机/登录自启与停止（Linux cron、macOS LaunchAgent、Windows 计划任务）");
+serviceCmd
+    .command("install")
+    .description("添加开机/登录自启：下次重启或登录后自动启动 gateway")
+    .action(() => {
+    const nodePath = process.execPath;
+    const cliPath = join(__dirname, "cli.js");
+    serviceInstall({ nodePath, cliPath });
+});
+serviceCmd
+    .command("uninstall")
+    .description("移除开机/登录自启")
+    .action(() => {
+    serviceUninstall();
+});
+serviceCmd
+    .command("stop")
+    .description("停止当前运行的 gateway 进程")
+    .action(() => {
+    serviceStop();
+});
 // Login command（写入桌面 config；可选 model，不传则取该 provider 第一个模型，补齐后可直接运行）
 program
     .command("login")

package/dist/cli/service.d.ts

@@ -0,0 +1,13 @@
+/** 供 gateway 命令调用：写入当前进程 PID */
+export declare function writeGatewayPid(): void;
+/** 供 gateway 命令调用：关闭时删除 PID 文件 */
+export declare function removeGatewayPidFile(): void;
+/** 获取 PID 文件路径（供外部读取） */
+export declare function getGatewayPidPath(): string;
+export type ServiceOptions = {
+    nodePath: string;
+    cliPath: string;
+};
+export declare function serviceInstall(opts: ServiceOptions): void;
+export declare function serviceUninstall(): void;
+export declare function serviceStop(): boolean;

package/dist/cli/service.js

@@ -0,0 +1,243 @@
+/**
+ * openbot service install / uninstall / stop
+ * - install: 开机/登录自启（Linux cron @reboot, macOS LaunchAgent, Windows 计划任务）
+ * - uninstall: 移除自启
+ * - stop: 停止当前运行的 gateway 进程（依赖 gateway 写入的 PID 文件）
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { execSync, spawnSync } from "node:child_process";
+const OPENBOT_USER_DIR = process.env.OPENBOT_USER_DIR ?? join(homedir(), ".openbot");
+const GATEWAY_PID_FILE = join(OPENBOT_USER_DIR, "gateway.pid");
+const GATEWAY_PORT = 38080;
+/** 供 gateway 命令调用：写入当前进程 PID */
+export function writeGatewayPid() {
+    if (!existsSync(OPENBOT_USER_DIR))
+        mkdirSync(OPENBOT_USER_DIR, { recursive: true });
+    writeFileSync(GATEWAY_PID_FILE, String(process.pid), "utf-8");
+}
+/** 供 gateway 命令调用：关闭时删除 PID 文件 */
+export function removeGatewayPidFile() {
+    try {
+        if (existsSync(GATEWAY_PID_FILE))
+            rmSync(GATEWAY_PID_FILE);
+    }
+    catch {
+        // ignore
+    }
+}
+/** 获取 PID 文件路径（供外部读取） */
+export function getGatewayPidPath() {
+    return GATEWAY_PID_FILE;
+}
+function getBootCommand(nodePath, cliPath) {
+    const port = process.env.OPENBOT_GATEWAY_PORT ?? String(GATEWAY_PORT);
+    return `"${nodePath}" "${cliPath}" gateway -p ${port}`;
+}
+function detectPlatform() {
+    const p = platform();
+    if (p === "win32")
+        return "win32";
+    if (p === "darwin")
+        return "darwin";
+    return "linux";
+}
+/** Linux: cron @reboot */
+function installLinux(nodePath, cliPath) {
+    const cronLine = `@reboot ${getBootCommand(nodePath, cliPath)}\n`;
+    const marker = "# openbot-gateway";
+    let current = "";
+    try {
+        current = execSync("crontab -l 2>/dev/null || true", { encoding: "utf-8" });
+    }
+    catch {
+        // no crontab
+    }
+    if (current.includes(marker)) {
+        throw new Error("已存在 openbot gateway 的开机自启，请先执行 openbot service uninstall");
+    }
+    const newCrontab = current.trimEnd() + (current ? "\n" : "") + marker + "\n" + cronLine;
+    execSync("crontab -", { input: newCrontab, stdio: ["pipe", "inherit", "inherit"] });
+    console.log("[openbot] 已添加 cron @reboot，下次重启将自动启动 gateway");
+}
+function uninstallLinux() {
+    let current = "";
+    try {
+        current = execSync("crontab -l 2>/dev/null || true", { encoding: "utf-8" });
+    }
+    catch {
+        console.log("[openbot] 未找到 crontab 或已为空");
+        return;
+    }
+    const marker = "# openbot-gateway";
+    const lines = current.split("\n");
+    const out = [];
+    let skipNext = false;
+    for (const line of lines) {
+        if (line.includes(marker)) {
+            skipNext = true;
+            continue;
+        }
+        if (skipNext && line.trim().startsWith("@reboot") && line.includes("gateway")) {
+            skipNext = false;
+            continue;
+        }
+        skipNext = false;
+        out.push(line);
+    }
+    const newCrontab = out.join("\n").replace(/\n\n+/g, "\n").trim();
+    if (newCrontab)
+        execSync("crontab -", { input: newCrontab, stdio: ["pipe", "inherit", "inherit"] });
+    else
+        execSync("crontab -r 2>/dev/null || true", { stdio: "inherit" });
+    console.log("[openbot] 已移除 cron @reboot");
+}
+function escapePlistString(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** macOS: LaunchAgent (用户级，登录时运行) */
+function installDarwin(nodePath, cliPath) {
+    const launchAgentsDir = join(homedir(), "Library", "LaunchAgents");
+    if (!existsSync(launchAgentsDir))
+        mkdirSync(launchAgentsDir, { recursive: true });
+    const plistPath = join(launchAgentsDir, "com.openbot.gateway.plist");
+    if (existsSync(plistPath)) {
+        throw new Error("已存在 openbot gateway 自启，请先执行 openbot service uninstall");
+    }
+    const port = process.env.OPENBOT_GATEWAY_PORT ?? String(GATEWAY_PORT);
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.openbot.gateway</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${escapePlistString(nodePath)}</string>
+    <string>${escapePlistString(cliPath)}</string>
+    <string>gateway</string>
+    <string>-p</string>
+    <string>${port}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <false/>
+  <key>StandardOutPath</key>
+  <string>${escapePlistString(OPENBOT_USER_DIR)}/gateway.log</string>
+  <key>StandardErrorPath</key>
+  <string>${escapePlistString(OPENBOT_USER_DIR)}/gateway.err</string>
+</dict>
+</plist>
+`;
+    writeFileSync(plistPath, plist, "utf-8");
+    execSync(`launchctl load "${plistPath}"`, { stdio: "inherit" });
+    console.log("[openbot] 已安装 LaunchAgent，下次登录将自动启动 gateway");
+}
+function uninstallDarwin() {
+    const plistPath = join(homedir(), "Library", "LaunchAgents", "com.openbot.gateway.plist");
+    if (existsSync(plistPath)) {
+        try {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: "inherit" });
+        }
+        catch {
+            // may already be unloaded
+        }
+        rmSync(plistPath);
+        console.log("[openbot] 已移除 LaunchAgent");
+    }
+    else {
+        console.log("[openbot] 未找到自启配置");
+    }
+}
+/** Windows: 任务计划（用户登录时运行） */
+function installWin32(nodePath, cliPath) {
+    const taskName = "OpenBotGateway";
+    const r = spawnSync("schtasks", ["/query", "/tn", taskName], { encoding: "utf-8" });
+    if (r.status === 0) {
+        throw new Error("已存在 OpenBot Gateway 自启任务，请先执行 openbot service uninstall");
+    }
+    const port = process.env.OPENBOT_GATEWAY_PORT ?? String(GATEWAY_PORT);
+    const cmd = `"${nodePath}" "${cliPath}" gateway -p ${port}`;
+    const r2 = spawnSync("schtasks", [
+        "/create",
+        "/tn", taskName,
+        "/tr", cmd,
+        "/sc", "onlogon",
+        "/rl", "highest",
+        "/f",
+    ], { encoding: "utf-8", stdio: "inherit", shell: true });
+    if (r2.status !== 0) {
+        throw new Error("创建计划任务失败，请以管理员身份运行或检查 schtasks");
+    }
+    console.log("[openbot] 已创建计划任务，下次登录将自动启动 gateway");
+}
+function uninstallWin32() {
+    const taskName = "OpenBotGateway";
+    const r = spawnSync("schtasks", ["/query", "/tn", taskName], { encoding: "utf-8" });
+    if (r.status !== 0) {
+        console.log("[openbot] 未找到自启任务");
+        return;
+    }
+    spawnSync("schtasks", ["/delete", "/tn", taskName, "/f"], { stdio: "inherit", shell: true });
+    console.log("[openbot] 已删除计划任务");
+}
+/** 停止 gateway：读 PID 文件发 SIGTERM */
+function stopGateway() {
+    if (!existsSync(GATEWAY_PID_FILE)) {
+        console.log("[openbot] 未找到 gateway PID 文件，可能未以后台/服务方式运行");
+        return false;
+    }
+    const pidStr = readFileSync(GATEWAY_PID_FILE, "utf-8").trim();
+    const pid = parseInt(pidStr, 10);
+    if (Number.isNaN(pid)) {
+        console.log("[openbot] PID 文件内容无效");
+        return false;
+    }
+    try {
+        if (platform() === "win32") {
+            spawnSync("taskkill", ["/pid", String(pid), "/f"], { stdio: "inherit", shell: true });
+        }
+        else {
+            process.kill(pid, "SIGTERM");
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes("kill") || msg.includes("ESRCH")) {
+            console.log("[openbot] 进程已不存在");
+        }
+        else {
+            throw e;
+        }
+    }
+    removeGatewayPidFile();
+    console.log("[openbot] 已停止 gateway");
+    return true;
+}
+export function serviceInstall(opts) {
+    const p = detectPlatform();
+    if (p === "linux")
+        installLinux(opts.nodePath, opts.cliPath);
+    else if (p === "darwin")
+        installDarwin(opts.nodePath, opts.cliPath);
+    else
+        installWin32(opts.nodePath, opts.cliPath);
+}
+export function serviceUninstall() {
+    const p = detectPlatform();
+    if (p === "linux")
+        uninstallLinux();
+    else if (p === "darwin")
+        uninstallDarwin();
+    else
+        uninstallWin32();
+}
+export function serviceStop() {
+    return stopGateway();
+}

package/dist/gateway/server.js

@@ -37,7 +37,8 @@ import { ensureDesktopConfigInitialized } from "../core/config/desktop-config.js
 import { createNestAppEmbedded } from "../server/bootstrap.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = join(__dirname, "..", "..");
-const STATIC_DIR = join(PACKAGE_ROOT, "apps", "desktop", "renderer", "dist");
+/** 内嵌到 Electron 时由主进程设置 OPENBOT_STATIC_DIR，指向打包后的 renderer/dist */
+const STATIC_DIR = process.env.OPENBOT_STATIC_DIR || join(PACKAGE_ROOT, "apps", "desktop", "renderer", "dist");
 const MIME_TYPES = {
     ".html": "text/html",
     ".js": "text/javascript",

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.2.1",
+    "version": "0.2.8",
     "description": "CLI and library to run prompts with skill paths (Agent Skills style). Use as npm package or openbot CLI.",
     "type": "module",
     "main": "dist/index.js",
@@ -50,11 +50,12 @@
         "@types/sql.js": "^1.4.9",
         "@types/ws": "^8.18.1",
         "jest": "^29.7.0",
+        "rimraf": "^5.0.5",
         "ts-jest": "^29.2.5",
         "typescript": "^5.7.0"
     },
     "scripts": {
-        "clean": "rm -rf dist",
+        "clean": "rimraf dist",
         "build": "npm run clean && tsc",
         "build:web": "cd apps/desktop && npm run build:renderer",
         "build:all": "npm run build && npm run build:web",
@@ -64,6 +65,7 @@
         "dev": "npm run build && node dist/cli/cli.js",
         "desktop:dev": "cd apps/desktop && npm run dev",
         "desktop:build": "cd apps/desktop && npm run build",
+        "desktop:pack": "npm run build && cd apps/desktop && npm run build",
         "desktop:install": "cd apps/desktop && npm install",
         "test": "jest --config test/jest.config.cjs",
         "test:memory": "node test/run-memory.mjs",