@next-open-ai/openbot 0.1.10 → 0.2.8

package/dist/cli/cli.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+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));
+const PKG_ROOT = join(__dirname, "..", "..");
+async function runAction(positionalPrompt, opts) {
+    const skillPaths = opts.skillPath || [];
+    const agentId = (opts.agent && String(opts.agent).trim()) || (await getBoundAgentIdForCli());
+    const prompt = (opts.prompt ?? positionalPrompt ?? "").trim();
+    if (!prompt) {
+        console.error("Error: 请提供提示词（位置参数或 --prompt）");
+        process.exit(1);
+    }
+    console.error(`[openbot] Using agent: ${agentId}${!opts.agent ? " (default from config)" : ""}`);
+    const needDesktop = opts.apiKey === undefined || opts.provider === undefined || opts.model === undefined;
+    const desktopConfig = needDesktop ? await loadDesktopAgentConfig(agentId) : null;
+    const provider = opts.provider ?? desktopConfig?.provider ?? "deepseek";
+    const model = opts.model ?? desktopConfig?.model ?? "deepseek-chat";
+    const apiKey = opts.apiKey ?? process.env.OPENAI_API_KEY ?? desktopConfig?.apiKey ?? "";
+    if (desktopConfig && (desktopConfig.provider || desktopConfig.model)) {
+        console.error(`[openbot] Using model: ${provider}/${model} (from desktop config)`);
+    }
+    if (opts.timing)
+        process.env.OPENBOT_TIMING = "1";
+    const workspaceName = desktopConfig?.workspace ?? agentId;
+    try {
+        const result = await run({
+            workspace: workspaceName,
+            skillPaths,
+            userPrompt: prompt,
+            dryRun: opts.dryRun ?? false,
+            model,
+            provider,
+            agentDir: opts.agentDir ?? getOpenbotAgentDir(),
+            apiKey: apiKey || undefined,
+        });
+        if (result.dryRun) {
+            console.log("=== System prompt (skills) ===");
+            console.log(result.systemPrompt);
+            console.log("\n=== User prompt ===");
+            console.log(result.userPrompt);
+            console.log("\n(dry-run: 未调用 LLM，设置 OPENAI_API_KEY 可实际调用)");
+            return;
+        }
+        // Content is already streamed by run()
+        if (!result.dryRun &&
+            (result.assistantContent === undefined || result.assistantContent === "")) {
+            console.warn("（模型返回为空；若此前有工具调用提示，说明当前为单轮模式，模型会基于技能描述直接以文本回答。）");
+        }
+    }
+    catch (err) {
+        console.error(err);
+        process.exit(1);
+    }
+}
+const program = new Command();
+program
+    .name("openbot")
+    .description("CLI to run prompts with skill paths (Agent Skills style)")
+    .version(PKG.version, "-v, --version", "显示版本号")
+    .option("-s, --skill-path <paths...>", "Additional skill paths to load")
+    .option("-a, --agent <id>", "指定智能体 ID，不传则使用桌面配置中的缺省智能体")
+    .option("-p, --prompt <text>", "用户提示词（与位置参数二选一）")
+    .option("--dry-run", "只输出组装的 system/user 内容，不调用 LLM")
+    .option("--model <id>", "模型 ID", "deepseek-chat")
+    .option("--provider <name>", "Provider（pi ModelRegistry）；可选 deepseek、dashscope、openai", "deepseek")
+    .option("--agent-dir <path>", "Agent 配置目录（默认 ~/.openbot/agent）", getOpenbotAgentDir())
+    .option("--api-key <key>", "API Key（不传则使用环境变量 OPENAI_API_KEY）")
+    .option("--timing", "打印每轮 LLM 与 tool 耗时到 stderr")
+    .option("--max-tool-turns <n>", "最大工具调用轮数（默认 30）；可设环境变量 OPENBOT_MAX_TOOL_TURNS", (v) => parseInt(v, 10) || 0, 0)
+    .argument("[prompt]", "用户提示词（与 --prompt 二选一）")
+    .action(async (positionalPrompt) => {
+    await runAction(positionalPrompt, program.opts());
+});
+program.addHelpText("after", `
+Environment:
+  DEEPSEEK_API_KEY          默认 provider 为 deepseek 时使用；不设时回退 OPENAI_API_KEY
+  OPENAI_API_KEY            通用 API Key（可被 --api-key 覆盖）
+  DASHSCOPE_API_KEY         provider=dashscope 时使用；不设时回退 OPENAI_API_KEY
+  OPENAI_BASE_URL           可选，在 pi 未找到模型时使用的 endpoint
+  OPENBOT_AGENT_DIR         缺省 agent 目录（默认 ~/.openbot/agent）
+  OPENBOT_TIMING=1          等同 --timing
+  OPENBOT_ALLOW_RUN_CODE    缺省 1（启用 run_python）；设为 0 关闭
+  OPENBOT_MAX_TOOL_TURNS    最大工具轮数（默认 30）
+
+Examples:
+  openbot "总结一下当前有哪些技能"
+  openbot -a my-agent "总结一下当前有哪些技能"  使用指定智能体
+  openbot -s ./skills "总结一下当前有哪些技能"
+  openbot -s ./my-skills --prompt "用 weather 技能查北京天气" --dry-run
+`);
+// Gateway server command
+program
+    .command("gateway")
+    .description("Start WebSocket gateway server")
+    .option("-p, --port <port>", "Port to listen on", "38080")
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port <= 0 || port > 65535) {
+        console.error("Error: Invalid port number");
+        process.exit(1);
+    }
+    writeGatewayPid();
+    const { startGatewayServer } = await import("../gateway/index.js");
+    const { close } = await startGatewayServer(port);
+    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")
+    .description("Save API key for a provider to desktop config (~/.openbot/desktop); optional model, default first model")
+    .argument("<provider>", "Provider name (e.g., deepseek, dashscope, openai)")
+    .argument("<apiKey>", "API Key")
+    .argument("[model]", "Model ID (optional; default: first model for provider)")
+    .action(async (provider, apiKey, model) => {
+    await setProviderApiKey(provider, apiKey, model);
+    console.log(`[openbot] API key saved for provider: ${provider}`);
+});
+// Config command
+const configCmd = program.command("config").description("Manage configurations");
+configCmd
+    .command("set-model")
+    .description("Set default provider and model in desktop config (~/.openbot/desktop)")
+    .argument("<provider>", "Provider name")
+    .argument("<modelId>", "Model ID")
+    .action(async (provider, modelId) => {
+    await setDefaultModel(provider, modelId);
+    console.log(`[openbot] Default model set: ${provider}/${modelId}`);
+});
+configCmd
+    .command("list")
+    .description("List desktop config (centralized config source)")
+    .action(async () => {
+    const list = await getDesktopConfigList();
+    if (list.providers.length === 0) {
+        console.log("No providers in desktop config. Run: openbot login <provider> <apiKey>");
+        return;
+    }
+    console.log(`Default: ${list.defaultProvider} / ${list.defaultModel}\n`);
+    console.table(list.providers.map((r) => ({
+        Provider: r.provider,
+        "Default Model": r.defaultModel,
+        "API Key": r.hasKey ? "✅" : "❌",
+    })));
+});
+configCmd
+    .command("sync")
+    .description("Sync desktop config to ~/.openbot/agent/models.json for pi-agent")
+    .action(async () => {
+    await syncDesktopConfigToModelsJson();
+    console.log("[openbot] Synced desktop providers to agent models.json");
+});
+(async () => {
+    await ensureDesktopConfigInitialized();
+    await program.parseAsync(process.argv);
+})().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

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/cli.d.ts

@@ -1,2 +1,5 @@
 #!/usr/bin/env node
-export {};
+/**
+ * 兼容旧命令 node dist/cli.js / openbot → 实际入口为 dist/cli/cli.js
+ */
+import "./cli/cli.js";

package/dist/cli.js

@@ -1,173 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { Command } from "commander";
-import { getOpenbotAgentDir } from "./agent/agent-dir.js";
-import { run } from "./agent/run.js";
-import { loadDesktopAgentConfig, getBoundAgentIdForCli, setProviderApiKey, setDefaultModel, getDesktopConfigList, syncDesktopConfigToModelsJson, ensureDesktopConfigInitialized, } from "./config/desktop-config.js";
-const require = createRequire(import.meta.url);
-const PKG = require("../package.json");
-// Based on distillate, the package root is one level up from dist/
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const PKG_ROOT = join(__dirname, "..");
-async function runAction(positionalPrompt, opts) {
-    const skillPaths = opts.skillPath || [];
-    const agentId = (opts.agent && String(opts.agent).trim()) || (await getBoundAgentIdForCli());
-    const prompt = (opts.prompt ?? positionalPrompt ?? "").trim();
-    if (!prompt) {
-        console.error("Error: 请提供提示词（位置参数或 --prompt）");
-        process.exit(1);
-    }
-    console.error(`[openbot] Using agent: ${agentId}${!opts.agent ? " (default from config)" : ""}`);
-    const needDesktop = opts.apiKey === undefined || opts.provider === undefined || opts.model === undefined;
-    const desktopConfig = needDesktop ? await loadDesktopAgentConfig(agentId) : null;
-    const provider = opts.provider ?? desktopConfig?.provider ?? "deepseek";
-    const model = opts.model ?? desktopConfig?.model ?? "deepseek-chat";
-    const apiKey = opts.apiKey ?? process.env.OPENAI_API_KEY ?? desktopConfig?.apiKey ?? "";
-    if (desktopConfig && (desktopConfig.provider || desktopConfig.model)) {
-        console.error(`[openbot] Using model: ${provider}/${model} (from desktop config)`);
-    }
-    if (opts.timing)
-        process.env.OPENBOT_TIMING = "1";
-    const workspaceName = desktopConfig?.workspace ?? agentId;
-    try {
-        const result = await run({
-            workspace: workspaceName,
-            skillPaths,
-            userPrompt: prompt,
-            dryRun: opts.dryRun ?? false,
-            model,
-            provider,
-            agentDir: opts.agentDir ?? getOpenbotAgentDir(),
-            apiKey: apiKey || undefined,
-        });
-        if (result.dryRun) {
-            console.log("=== System prompt (skills) ===");
-            console.log(result.systemPrompt);
-            console.log("\n=== User prompt ===");
-            console.log(result.userPrompt);
-            console.log("\n(dry-run: 未调用 LLM，设置 OPENAI_API_KEY 可实际调用)");
-            return;
-        }
-        // Content is already streamed by run()
-        if (!result.dryRun &&
-            (result.assistantContent === undefined || result.assistantContent === "")) {
-            console.warn("（模型返回为空；若此前有工具调用提示，说明当前为单轮模式，模型会基于技能描述直接以文本回答。）");
-        }
-    }
-    catch (err) {
-        console.error(err);
-        process.exit(1);
-    }
-}
-const program = new Command();
-program
-    .name("openbot")
-    .description("CLI to run prompts with skill paths (Agent Skills style)")
-    .version(PKG.version, "-v, --version", "显示版本号")
-    .option("-s, --skill-path <paths...>", "Additional skill paths to load")
-    .option("-a, --agent <id>", "指定智能体 ID，不传则使用桌面配置中的缺省智能体")
-    .option("-p, --prompt <text>", "用户提示词（与位置参数二选一）")
-    .option("--dry-run", "只输出组装的 system/user 内容，不调用 LLM")
-    .option("--model <id>", "模型 ID", "deepseek-chat")
-    .option("--provider <name>", "Provider（pi ModelRegistry）；可选 deepseek、dashscope、openai", "deepseek")
-    .option("--agent-dir <path>", "Agent 配置目录（默认 ~/.openbot/agent）", getOpenbotAgentDir())
-    .option("--api-key <key>", "API Key（不传则使用环境变量 OPENAI_API_KEY）")
-    .option("--timing", "打印每轮 LLM 与 tool 耗时到 stderr")
-    .option("--max-tool-turns <n>", "最大工具调用轮数（默认 30）；可设环境变量 OPENBOT_MAX_TOOL_TURNS", (v) => parseInt(v, 10) || 0, 0)
-    .argument("[prompt]", "用户提示词（与 --prompt 二选一）")
-    .action(async (positionalPrompt) => {
-    await runAction(positionalPrompt, program.opts());
-});
-program.addHelpText("after", `
-Environment:
-  DEEPSEEK_API_KEY          默认 provider 为 deepseek 时使用；不设时回退 OPENAI_API_KEY
-  OPENAI_API_KEY            通用 API Key（可被 --api-key 覆盖）
-  DASHSCOPE_API_KEY         provider=dashscope 时使用；不设时回退 OPENAI_API_KEY
-  OPENAI_BASE_URL           可选，在 pi 未找到模型时使用的 endpoint
-  OPENBOT_AGENT_DIR         缺省 agent 目录（默认 ~/.openbot/agent）
-  OPENBOT_TIMING=1          等同 --timing
-  OPENBOT_ALLOW_RUN_CODE    缺省 1（启用 run_python）；设为 0 关闭
-  OPENBOT_MAX_TOOL_TURNS    最大工具轮数（默认 30）
-
-Examples:
-  openbot "总结一下当前有哪些技能"
-  openbot -a my-agent "总结一下当前有哪些技能"  使用指定智能体
-  openbot -s ./skills "总结一下当前有哪些技能"
-  openbot -s ./my-skills --prompt "用 weather 技能查北京天气" --dry-run
-`);
-// Gateway server command
-program
-    .command("gateway")
-    .description("Start WebSocket gateway server")
-    .option("-p, --port <port>", "Port to listen on", "38080")
-    .action(async (options) => {
-    const port = parseInt(options.port, 10);
-    if (isNaN(port) || port <= 0 || port > 65535) {
-        console.error("Error: Invalid port number");
-        process.exit(1);
-    }
-    const { startGatewayServer } = await import("./gateway/index.js");
-    const { close } = await startGatewayServer(port);
-    // Handle graceful shutdown
-    const shutdown = async () => {
-        console.log("\nShutting down...");
-        await close();
-        process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-});
-// Login command（写入桌面 config；可选 model，不传则取该 provider 第一个模型，补齐后可直接运行）
-program
-    .command("login")
-    .description("Save API key for a provider to desktop config (~/.openbot/desktop); optional model, default first model")
-    .argument("<provider>", "Provider name (e.g., deepseek, dashscope, openai)")
-    .argument("<apiKey>", "API Key")
-    .argument("[model]", "Model ID (optional; default: first model for provider)")
-    .action(async (provider, apiKey, model) => {
-    await setProviderApiKey(provider, apiKey, model);
-    console.log(`[openbot] API key saved for provider: ${provider}`);
-});
-// Config command
-const configCmd = program.command("config").description("Manage configurations");
-configCmd
-    .command("set-model")
-    .description("Set default provider and model in desktop config (~/.openbot/desktop)")
-    .argument("<provider>", "Provider name")
-    .argument("<modelId>", "Model ID")
-    .action(async (provider, modelId) => {
-    await setDefaultModel(provider, modelId);
-    console.log(`[openbot] Default model set: ${provider}/${modelId}`);
-});
-configCmd
-    .command("list")
-    .description("List desktop config (centralized config source)")
-    .action(async () => {
-    const list = await getDesktopConfigList();
-    if (list.providers.length === 0) {
-        console.log("No providers in desktop config. Run: openbot login <provider> <apiKey>");
-        return;
-    }
-    console.log(`Default: ${list.defaultProvider} / ${list.defaultModel}\n`);
-    console.table(list.providers.map((r) => ({
-        Provider: r.provider,
-        "Default Model": r.defaultModel,
-        "API Key": r.hasKey ? "✅" : "❌",
-    })));
-});
-configCmd
-    .command("sync")
-    .description("Sync desktop config to ~/.openbot/agent/models.json for pi-agent")
-    .action(async () => {
-    await syncDesktopConfigToModelsJson();
-    console.log("[openbot] Synced desktop providers to agent models.json");
-});
-(async () => {
-    await ensureDesktopConfigInitialized();
-    await program.parseAsync(process.argv);
-})().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
+/**
+ * 兼容旧命令 node dist/cli.js / openbot → 实际入口为 dist/cli/cli.js
+ */
+import "./cli/cli.js";

package/dist/gateway/auth-hooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gateway 各通道入口的鉴权/安全钩子（占位模块）。
+ * 连接之初可在此做 token 校验、限流等，当前暂不加逻辑，仅透传。
+ */
+import type { Request, Response, NextFunction } from 'express';
+import type { IncomingMessage } from 'http';
+/** HTTP：/server-api 进入 Nest 前的鉴权钩子（占位，直接 next） */
+export declare function authHookServerApi(req: Request, res: Response, next: NextFunction): void;
+/** HTTP：/channel 进入通道模块前的鉴权钩子（占位，直接 next） */
+export declare function authHookChannel(req: Request, res: Response, next: NextFunction): void;
+/** HTTP：/sse 进入 SSE 前的鉴权钩子（占位，直接 next） */
+export declare function authHookSse(req: Request, res: Response, next: NextFunction): void;
+/**
+ * WebSocket upgrade：/ws 或 /ws/voice 连接前的鉴权钩子（占位）。
+ * 返回 true 表示放行，false 表示拒绝（调用方应关闭 socket）。
+ */
+export declare function authHookWs(_req: IncomingMessage, _path: string): boolean;

package/dist/gateway/auth-hooks.js

@@ -0,0 +1,19 @@
+/** HTTP：/server-api 进入 Nest 前的鉴权钩子（占位，直接 next） */
+export function authHookServerApi(req, res, next) {
+    next();
+}
+/** HTTP：/channel 进入通道模块前的鉴权钩子（占位，直接 next） */
+export function authHookChannel(req, res, next) {
+    next();
+}
+/** HTTP：/sse 进入 SSE 前的鉴权钩子（占位，直接 next） */
+export function authHookSse(req, res, next) {
+    next();
+}
+/**
+ * WebSocket upgrade：/ws 或 /ws/voice 连接前的鉴权钩子（占位）。
+ * 返回 true 表示放行，false 表示拒绝（调用方应关闭 socket）。
+ */
+export function authHookWs(_req, _path) {
+    return true;
+}