ellm-proxy 0.0.2 → 0.0.6

package/manager/api/service-settings.js

@@ -0,0 +1,98 @@
+// 服务设置 api 子应用：开机自启开关 + 自动更新（检查/开关/手动触发）。
+// 与 api/service.js（进程控制）、api/harness/（代理开关）平级的第三域，路由形状/响应约定一致
+// （{ok,...} 或 {ok:false,error}）；实现在 utils/autostart.js 与 utils/updater.js（CLI 侧复用）。
+import { Hono } from "hono";
+import { autostartStatus, enableAutostart, disableAutostart } from "../../utils/autostart.js";
+import {
+  readUpdaterSettings,
+  writeUpdaterSettings,
+  checkForUpdate,
+  performUpdate,
+  isUpdateSupported,
+  isUpdating,
+} from "../../utils/updater.js";
+
+/** 读 body 并校验 enabled；合法返回 boolean，非法返回 400 Response（调用方直接 return 该响应） */
+async function requireEnabled(c) {
+  let enabled;
+  try {
+    enabled = (await c.req.json())?.enabled;
+  } catch {
+    return c.json({ ok: false, error: "请求体不是合法 JSON" }, 400);
+  }
+  if (typeof enabled !== "boolean") {
+    return c.json({ ok: false, error: 'body 需为 {"enabled": true|false}' }, 400);
+  }
+  return enabled;
+}
+
+/** 服务设置子应用：GET/POST /autostart · GET /update · POST /update/enabled|check|apply */
+export function createServiceSettingsApp({ startOpts }) {
+  const app = new Hono();
+
+  // —— 开机自启 ——————————————————————————————————————————————
+  app.get("/autostart", async (c) => c.json({ ok: true, ...(await autostartStatus()) }));
+
+  app.post("/autostart", async (c) => {
+    const enabled = await requireEnabled(c);
+    if (enabled instanceof Response) return enabled;
+    if (enabled) {
+      const { itemPath } = await enableAutostart();
+      return c.json({ ok: true, enabled: true, itemPath, note: "已注册自启项，下次登录时 pm2 resurrect 恢复服务" });
+    }
+    const { removed } = await disableAutostart();
+    return c.json({
+      ok: true,
+      enabled: false,
+      removed,
+      note: removed ? "已移除自启项，且首次启动不再自动注册（重新开启即可解除）" : "原本未开启，无操作",
+    });
+  });
+
+  // —— 自动更新 ——————————————————————————————————————————————
+  app.get("/update", (c) => {
+    const settings = readUpdaterSettings();
+    return c.json({
+      ok: true,
+      enabled: settings.enabled,
+      lastCheck: settings.lastCheck,
+      lastApply: settings.lastApply,
+      supported: isUpdateSupported(),
+      updating: isUpdating(),
+    });
+  });
+
+  app.post("/update/enabled", async (c) => {
+    const enabled = await requireEnabled(c);
+    if (enabled instanceof Response) return enabled;
+    writeUpdaterSettings({ enabled });
+    return c.json({
+      ok: true,
+      enabled,
+      note: enabled
+        ? "自动更新已开启（看门狗随下次 manager 启动生效；当前周期内手动检查不受影响）"
+        : "自动更新已关闭（看门狗在下次 tick 时停止）",
+    });
+  });
+
+  app.post("/update/check", async (c) => {
+    const result = await checkForUpdate();
+    return c.json({ ok: true, ...result });
+  });
+
+  app.post("/update/apply", async (c) => {
+    if (!isUpdateSupported()) {
+      return c.json({ ok: false, error: "当前为源码运行模式，更新功能不可用（仅 npm 全局安装的包支持自动更新）" }, 400);
+    }
+    const result = await performUpdate(startOpts);
+    return c.json({
+      ok: true,
+      ...result,
+      note: result.updated
+        ? `已更新 ${result.fromVersion} → ${result.toVersion}：主服务已重启，管理服务将在数秒后自重启（期间界面请求可能瞬时失败）`
+        : `已是最新版本 ${result.toVersion}`,
+    });
+  });
+
+  return app;
+}

package/manager/api/service.js

@@ -9,7 +9,7 @@ import { createRequire } from "node:module";
 import { Hono } from "hono";
 import { APP_NAME, MANAGER_APP_NAME } from "../../utils/paths.js";
 import { withPm2, findApp, pm2cb, safeDump } from "../../utils/pm2.js";
-import { doStart, resolveGatewayBase, resolvePort } from "../../utils/service.js";
+import { doStart, stopMainOnly, resolveGatewayBase, resolvePort } from "../../utils/service.js";
 
 // 本文件在 manager/api/ 下，包根为上两级
 const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
@@ -108,19 +108,9 @@ async function processesPayload(startOpts) {
   ];
 }
 
-/** 仅停止主服务（管理服务保持存活）；管理服务仍在 dump 列表中，resurrect 后它会先起来继续提供远程启停 */
-async function stopMainOnly() {
-  return withPm2(async () => {
-    const proc = await findApp();
-    if (!proc) return "already-stopped";
-    await pm2cb("delete", APP_NAME);
-    await safeDump();
-    return "stopped";
-  });
-}
-
 /** pm2 启停：start / stop / restart（restart = 停主服务 + start，
- *  start 时管理服务已在线会被 doStart 的幂等检查跳过） */
+ *  start 时管理服务已在线会被 doStart 的幂等检查跳过）。
+ *  stopMainOnly 已抽到 utils/service.js（updater 更新前停主服务复用同语义）。 */
 async function runStartStop(action, startOpts) {
   if (action === "stop") return stopMainOnly();
   if (action === "start") return doStart(startOpts);

package/manager/index.js

@@ -1,170 +1,182 @@
-// ellm-proxy 管理服务入口（独立常驻脚本）：随 `ellm-proxy start` 一并由 pm2 托管（name=ellm-proxy-manager）；
-// 也可手动 `node manager/index.js` 运行。本文件 = 创建 app（中间件 + api 聚合挂载）+ 启动 HTTP 服务；
-// 各 api 域实现在 api/ 下：service.js（进程控制，命名对齐 backend/src/api/service.ts）、harness/（代理开关域）。
-//
-// 为什么独立于 backend：ellm-proxy 与 backend 同进程，进程自杀后管理台与转发层同时失联，
-// 无法返回操作结果——启停必须由活在外面的本服务执行。
-//
-// 管理界面托管：本服务同进程托管 web-ui 构建产物（根路径 /，hash 路由），并反代 /api/* 到主服务——
-// web-ui 全部接口（/api/* 管理台 + /status /restart /harness 等进程/开关域）同源可达，config.js 留空零配置。
-//
-// 接口（CORS 全放开，均返回 {ok, ...} 或 {ok:false, error}）：
-//   GET  /                    web-ui 管理界面（静态托管，产物缺失时仅告警跳过）
-//   GET  /api/*               反代主服务管理台 API（端口 = ELLM_PORT env > 配置文件 port，每请求解析）
-//   GET  /status                ellm-proxy 运行状态（running/pid/status/uptime/网关端口）
-//   GET  /processes             全进程列表（pm2 守护进程/管理服务/主服务：状态/PID/端口/内存/CPU/运行时长）
-//   POST /start | /stop | /restart   pm2 启动/停止/重启 ellm-proxy（复用 utils/service.js，含探活）
-//   GET  /harness               Claude Code / Codex / DeepSeek Harness 代理开关状态
-//   POST /harness/claude-code   body {enabled}；开 = 写 ~/.claude/settings.json（备份），关 = 还原备份
-//   POST /harness/codex         body {enabled}；开 = 写 ~/.codex/config.toml（备份），关 = 还原备份
-//   POST /harness/dsh           body {enabled}；开 = 写 ~/.dsh/settings.yaml + .credentials.yaml（备份），关 = 还原
-//
-// 配置来源（env 优先，argv 可覆盖，缺省兜底）：
-//   监听端口  ELLM_MANAGER_PORT（doStart 统一预算 = 主服务端口+1）> argv --port > 29771
-//   web-ui 产物 ELLM_WEBUI_DIR（可选覆盖）> 按本文件位置推导：包模式 <pkgRoot>/dist/web-ui → 仓库模式 <repoRoot>/web-ui/dist
-//   主服务参数 与 ellm-proxy start 注入的 env 同源：ELLM_CONFIG / ELLM_DATA_DIR / ELLM_APP_DIR / ELLM_PORT /
-//             ELLM_SERVER_JS（主服务 dist/server.js 路径，restart 重启主服务时使用，保证参数不漂移）
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { Hono } from "hono";
-import { cors } from "hono/cors";
-import { proxy } from "hono/proxy";
-import { serve } from "@hono/node-server";
-import { serveStatic } from "@hono/node-server/serve-static";
-import { dirname, join, relative, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import mri from "mri";
-import { absolutize } from "../utils/paths.js";
-import { resolveGatewayBase } from "../utils/service.js";
-import { ICONS, say } from "../utils/ui.js";
-import { createServiceApp } from "./api/service.js";
-import { createHarnessApp } from "./api/harness/index.js";
-
-const DEFAULT_SERVER_PORT = 29771; // 手动运行且无 env 时的兜底（默认网关 29770 + 1）
-// 本文件在 manager/ 下，包根为上一级
-const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-
-// web-ui 构建产物目录：ELLM_WEBUI_DIR 优先；缺省按本文件位置推导（包模式 dist/web-ui 与 server.js 同级，
-// 仓库模式落到 monorepo 的 web-ui/dist）。启动时判定一次，缺失则跳过静态托管（接口不受影响）。
-const WEBUI_DIST_DIR = process.env.ELLM_WEBUI_DIR
-  ? resolve(process.cwd(), process.env.ELLM_WEBUI_DIR)
-  : ([join(pkgRoot, "dist", "web-ui"), resolve(pkgRoot, "..", "web-ui", "dist")].find((p) =>
-      existsSync(join(p, "index.html")),
-    ) ?? join(pkgRoot, "dist", "web-ui"));
-const HAS_WEBUI = existsSync(join(WEBUI_DIST_DIR, "index.html"));
-
-/** web-ui 管理界面静态托管：/ 出 index.html（hash 路由唯一服务端入口），assets/ 补长缓存头。
- *  须在 api 聚合与 /api 反代之后注册——serve-static 未命中才放行，不会遮蔽接口。 */
-function registerWebUi(app) {
-  if (!HAS_WEBUI) return;
-  // serve-static 的 root 只接受相对 cwd 的路径：把绝对定位换算成当前 cwd 表达（仓库/发布包/任意 cwd 均成立）
-  const root = relative(process.cwd(), WEBUI_DIST_DIR);
-  app.get("/", async (c) => {
-    try {
-      const buf = await readFile(join(WEBUI_DIST_DIR, "index.html"));
-      return c.body(new Uint8Array(buf), 200, {
-        "Content-Type": "text/html; charset=utf-8",
-        "Cache-Control": "no-cache",
-      });
-    } catch {
-      return c.text("Not Found", 404);
-    }
-  });
-  app.use("/*", (c, next) => {
-    if (c.req.path === "/") return next(); // 根路径由上面的 serveIndex 处理
-    return serveStatic({
-      root,
-      onFound: (_p, ctx) => {
-        if (ctx.req.path.startsWith("/assets/")) ctx.header("Cache-Control", "public, max-age=31536000, immutable");
-      },
-    })(c, next);
-  });
-}
-
-/** 创建管理服务 app：CORS 全放开 + api 聚合挂载 + /api 反代主服务 + web-ui 静态托管 + 统一 404/500 */
-function createApp({ startOpts }) {
-  const app = new Hono();
-
-  // CORS 全放开（OPTIONS 预检由中间件自动处理）
-  app.use("*", cors());
-
-  // api 聚合：进程控制（GET /status · POST /start|stop|restart）与 harness 开关（GET /harness · POST /harness/claude-code|codex|dsh）
-  app.route("/", createServiceApp({ startOpts }));
-  app.route("/harness", createHarnessApp({ startOpts }));
-
-  // 反代主服务管理台 API（web-ui 同源访问的 /api/*）：端口与 start 口径一致（ELLM_PORT env > 配置文件），
-  // 每请求解析——主服务端口顺延漂移无感知
-  app.all("/api/*", (c) => {
-    const { base } = resolveGatewayBase();
-    const port = Number(new URL(base).port);
-    if (!port) {
-      return c.json(
-        { ok: false, error: "主服务端口无法解析（ELLM_PORT env 与配置文件 port 均缺失），无法转发 /api/*" },
-        502,
-      );
-    }
-    // 目标 URL 必须带上原始查询串：c.req.path 只有 pathname，漏拼 search 会把
-    // ?id=... / ?page=... 等查询参数全部丢掉（主服务按缺参返回 400 或默认分页）
-    const incoming = new URL(c.req.raw.url);
-    return proxy(new URL(incoming.pathname + incoming.search, base), {
-      method: c.req.method,
-      headers: c.req.raw.headers,
-      body: c.req.method === "GET" || c.req.method === "HEAD" ? undefined : c.req.raw.body,
-      duplex: "half", // body 为流时 undici 必需
-    });
-  });
-
-  registerWebUi(app);
-
-  app.notFound((c) =>
-    c.json(
-      {
-        ok: false,
-        error: `未知接口: ${c.req.method} ${c.req.path}（可用: GET /（管理界面）, GET /api/*（反代主服务）, GET /status, GET /processes, POST /start|stop|restart, GET /harness, POST /harness/claude-code|codex|dsh）`,
-      },
-      404,
-    ),
-  );
-  app.onError((err, c) => {
-    console.error(`[ellm-proxy-manager] ${c.req.method} ${c.req.path} 失败:`, err?.message ?? err);
-    return c.json({ ok: false, error: err?.message ?? String(err) }, 500);
-  });
-
-  return app;
-}
-
-async function main() {
-  // argv 解析（mri）：仅 --port（其余主服务参数一律走 env，与 start 注入链同源）
-  const argv = mri(process.argv.slice(2));
-  const listenPort = Number(argv.port) || Number(process.env.ELLM_MANAGER_PORT) || DEFAULT_SERVER_PORT;
-  // 主服务启动参数（start/restart 时透传给 doStart）：ELLM_* env 与 CLI start 注入链同源
-  const startOpts = absolutize({
-    config: process.env.ELLM_CONFIG,
-    dataDir: process.env.ELLM_DATA_DIR,
-    workingDir: process.env.ELLM_APP_DIR,
-    serverJs: process.env.ELLM_SERVER_JS || join(pkgRoot, "dist", "server.js"),
-  });
-
-  const app = createApp({ startOpts });
-
-  const server = serve({ fetch: app.fetch, port: listenPort, hostname: "127.0.0.1" });
-  server.on("error", (err) => {
-    console.error(
-      `错误：管理服务监听 ${listenPort} 失败（${err.code ?? err.message}）${err.code === "EADDRINUSE" ? "，端口被占用" : ""}`,
-    );
-    process.exit(1);
-  });
-
-  say(`ellm-proxy 管理服务已启动: http://127.0.0.1:${listenPort}`, ICONS.rocket);
-  say(
-    HAS_WEBUI
-      ? `   管理界面: http://127.0.0.1:${listenPort}/（web-ui，/api/* 反代主服务）`
-      : `   管理界面未托管：web-ui 构建产物缺失（${WEBUI_DIST_DIR}），仓库根执行 pnpm build:web 后重启本服务`,
-  );
-  say(
-    "   接口: GET /status /processes · POST /start /stop /restart · GET /harness · POST /harness/claude-code /harness/codex /harness/dsh",
-  );
-  say("   CORS 已全放开（仅监听 127.0.0.1，不对外）");
-}
-
-main();
+// ellm-proxy 管理服务入口（独立常驻脚本）：随 `ellm-proxy start` 一并由 pm2 托管（name=ellm-proxy-manager）；
+// 也可手动 `node manager/index.js` 运行。本文件 = 创建 app（中间件 + api 聚合挂载）+ 启动 HTTP 服务；
+// 各 api 域实现在 api/ 下：service.js（进程控制，命名对齐 backend/src/api/service.ts）、harness/（代理开关域）。
+//
+// 为什么独立于 backend：ellm-proxy 与 backend 同进程，进程自杀后管理台与转发层同时失联，
+// 无法返回操作结果——启停必须由活在外面的本服务执行。
+//
+// 管理界面托管：本服务同进程托管 web-ui 构建产物（根路径 /，hash 路由），并反代 /api/* 到主服务——
+// web-ui 全部接口（/api/* 管理台 + /status /restart /harness 等进程/开关域）同源可达，config.js 留空零配置。
+//
+// 接口（CORS 全放开，均返回 {ok, ...} 或 {ok:false, error}）：
+//   GET  /                    web-ui 管理界面（静态托管，产物缺失时仅告警跳过）
+//   GET  /api/*               反代主服务管理台 API（端口 = ELLM_PORT env > 配置文件 port，每请求解析）
+//   GET  /status                ellm-proxy 运行状态（running/pid/status/uptime/网关端口）
+//   GET  /processes             全进程列表（pm2 守护进程/管理服务/主服务：状态/PID/端口/内存/CPU/运行时长）
+//   POST /start | /stop | /restart   pm2 启动/停止/重启 ellm-proxy（复用 utils/service.js，含探活）
+//   GET|POST /autostart        开机自启状态 / 开关（body {enabled}；utils/autostart.js，opt-out 尊重用户选择）
+//   GET  /update               自动更新状态（开关/上次检查/上次更新/supported）
+//   POST /update/enabled       body {enabled}；自动更新开关（<appDir>/updater.json）
+//   POST /update/check         手动检查更新（npm view 私有源）
+//   POST /update/apply         手动执行更新（停主服务 → npm i -g → 重启主服务 → manager 延迟自重启）
+//   GET  /harness               Claude Code / Codex / DeepSeek Harness 代理开关状态
+//   POST /harness/claude-code   body {enabled}；开 = 写 ~/.claude/settings.json（备份），关 = 还原备份
+//   POST /harness/codex         body {enabled}；开 = 写 ~/.codex/config.toml（备份），关 = 还原备份
+//   POST /harness/dsh           body {enabled}；开 = 写 ~/.dsh/settings.yaml + .credentials.yaml（备份），关 = 还原
+//
+// 配置来源（env 优先，argv 可覆盖，缺省兜底）：
+//   监听端口  ELLM_MANAGER_PORT（doStart 统一预算 = 主服务端口+1）> argv --port > 29771
+//   web-ui 产物 ELLM_WEBUI_DIR（可选覆盖）> 按本文件位置推导：包模式 <pkgRoot>/dist/web-ui → 仓库模式 <repoRoot>/web-ui/dist
+//   主服务参数 与 ellm-proxy start 注入的 env 同源：ELLM_CONFIG / ELLM_DATA_DIR / ELLM_APP_DIR / ELLM_PORT /
+//             ELLM_SERVER_JS（主服务 dist/server.js 路径，restart 重启主服务时使用，保证参数不漂移）
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { proxy } from "hono/proxy";
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import mri from "mri";
+import { absolutize } from "../utils/paths.js";
+import { resolveGatewayBase } from "../utils/service.js";
+import { startUpdateWatchdog } from "../utils/updater.js";
+import { ICONS, say } from "../utils/ui.js";
+import { createServiceApp } from "./api/service.js";
+import { createServiceSettingsApp } from "./api/service-settings.js";
+import { createHarnessApp } from "./api/harness/index.js";
+
+const DEFAULT_SERVER_PORT = 29771; // 手动运行且无 env 时的兜底（默认网关 29770 + 1）
+// 本文件在 manager/ 下，包根为上一级
+const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+// web-ui 构建产物目录：ELLM_WEBUI_DIR 优先；缺省按本文件位置推导（包模式 dist/web-ui 与 server.js 同级，
+// 仓库模式落到 monorepo 的 web-ui/dist）。启动时判定一次，缺失则跳过静态托管（接口不受影响）。
+const WEBUI_DIST_DIR = process.env.ELLM_WEBUI_DIR
+  ? resolve(process.cwd(), process.env.ELLM_WEBUI_DIR)
+  : ([join(pkgRoot, "dist", "web-ui"), resolve(pkgRoot, "..", "web-ui", "dist")].find((p) =>
+      existsSync(join(p, "index.html")),
+    ) ?? join(pkgRoot, "dist", "web-ui"));
+const HAS_WEBUI = existsSync(join(WEBUI_DIST_DIR, "index.html"));
+
+/** web-ui 管理界面静态托管：/ 出 index.html（hash 路由唯一服务端入口），assets/ 补长缓存头。
+ *  须在 api 聚合与 /api 反代之后注册——serve-static 未命中才放行，不会遮蔽接口。 */
+function registerWebUi(app) {
+  if (!HAS_WEBUI) return;
+  // serve-static 的 root 只接受相对 cwd 的路径：把绝对定位换算成当前 cwd 表达（仓库/发布包/任意 cwd 均成立）
+  const root = relative(process.cwd(), WEBUI_DIST_DIR);
+  app.get("/", async (c) => {
+    try {
+      const buf = await readFile(join(WEBUI_DIST_DIR, "index.html"));
+      return c.body(new Uint8Array(buf), 200, {
+        "Content-Type": "text/html; charset=utf-8",
+        "Cache-Control": "no-cache",
+      });
+    } catch {
+      return c.text("Not Found", 404);
+    }
+  });
+  app.use("/*", (c, next) => {
+    if (c.req.path === "/") return next(); // 根路径由上面的 serveIndex 处理
+    return serveStatic({
+      root,
+      onFound: (_p, ctx) => {
+        if (ctx.req.path.startsWith("/assets/")) ctx.header("Cache-Control", "public, max-age=31536000, immutable");
+      },
+    })(c, next);
+  });
+}
+
+/** 创建管理服务 app：CORS 全放开 + api 聚合挂载 + /api 反代主服务 + web-ui 静态托管 + 统一 404/500 */
+function createApp({ startOpts }) {
+  const app = new Hono();
+
+  // CORS 全放开（OPTIONS 预检由中间件自动处理）
+  app.use("*", cors());
+
+  // api 聚合：进程控制（GET /status · POST /start|stop|restart）、服务设置（autostart / update 域）
+  // 与 harness 开关（GET /harness · POST /harness/claude-code|codex|dsh）
+  app.route("/", createServiceApp({ startOpts }));
+  app.route("/", createServiceSettingsApp({ startOpts }));
+  app.route("/harness", createHarnessApp({ startOpts }));
+
+  // 反代主服务管理台 API（web-ui 同源访问的 /api/*）：端口与 start 口径一致（ELLM_PORT env > 配置文件），
+  // 每请求解析——主服务端口顺延漂移无感知
+  app.all("/api/*", (c) => {
+    const { base } = resolveGatewayBase();
+    const port = Number(new URL(base).port);
+    if (!port) {
+      return c.json(
+        { ok: false, error: "主服务端口无法解析（ELLM_PORT env 与配置文件 port 均缺失），无法转发 /api/*" },
+        502,
+      );
+    }
+    // 目标 URL 必须带上原始查询串：c.req.path 只有 pathname，漏拼 search 会把
+    // ?id=... / ?page=... 等查询参数全部丢掉（主服务按缺参返回 400 或默认分页）
+    const incoming = new URL(c.req.raw.url);
+    return proxy(new URL(incoming.pathname + incoming.search, base), {
+      method: c.req.method,
+      headers: c.req.raw.headers,
+      body: c.req.method === "GET" || c.req.method === "HEAD" ? undefined : c.req.raw.body,
+      duplex: "half", // body 为流时 undici 必需
+    });
+  });
+
+  registerWebUi(app);
+
+  app.notFound((c) =>
+    c.json(
+      {
+        ok: false,
+        error: `未知接口: ${c.req.method} ${c.req.path}（可用: GET /（管理界面）, GET /api/*（反代主服务）, GET /status, GET /processes, POST /start|stop|restart, GET|POST /autostart, GET /update, POST /update/enabled|check|apply, GET /harness, POST /harness/claude-code|codex|dsh）`,
+      },
+      404,
+    ),
+  );
+  app.onError((err, c) => {
+    console.error(`[ellm-proxy-manager] ${c.req.method} ${c.req.path} 失败:`, err?.message ?? err);
+    return c.json({ ok: false, error: err?.message ?? String(err) }, 500);
+  });
+
+  return app;
+}
+
+async function main() {
+  // argv 解析（mri）：仅 --port（其余主服务参数一律走 env，与 start 注入链同源）
+  const argv = mri(process.argv.slice(2));
+  const listenPort = Number(argv.port) || Number(process.env.ELLM_MANAGER_PORT) || DEFAULT_SERVER_PORT;
+  // 主服务启动参数（start/restart 时透传给 doStart）：ELLM_* env 与 CLI start 注入链同源
+  const startOpts = absolutize({
+    config: process.env.ELLM_CONFIG,
+    dataDir: process.env.ELLM_DATA_DIR,
+    workingDir: process.env.ELLM_APP_DIR,
+    serverJs: process.env.ELLM_SERVER_JS || join(pkgRoot, "dist", "server.js"),
+  });
+
+  const app = createApp({ startOpts });
+
+  const server = serve({ fetch: app.fetch, port: listenPort, hostname: "127.0.0.1" });
+  server.on("error", (err) => {
+    console.error(
+      `错误：管理服务监听 ${listenPort} 失败（${err.code ?? err.message}）${err.code === "EADDRINUSE" ? "，端口被占用" : ""}`,
+    );
+    process.exit(1);
+  });
+
+  say(`ellm-proxy 管理服务已启动: http://127.0.0.1:${listenPort}`, ICONS.rocket);
+  say(
+    HAS_WEBUI
+      ? `   管理界面: http://127.0.0.1:${listenPort}/（web-ui，/api/* 反代主服务）`
+      : `   管理界面未托管：web-ui 构建产物缺失（${WEBUI_DIST_DIR}），仓库根执行 pnpm build:web 后重启本服务`,
+  );
+  say(
+    "   接口: GET /status /processes · POST /start /stop /restart · GET|POST /autostart · GET /update · POST /update/enabled|check|apply · GET /harness · POST /harness/claude-code /harness/codex /harness/dsh",
+  );
+  say("   CORS 已全放开（仅监听 127.0.0.1，不对外）");
+
+  // 自动更新看门狗：源码运行时内部直接返回（不轮询）；开关默认开启，每小时检查私有源新版本
+  startUpdateWatchdog(startOpts);
+}
+
+main();

package/package.json

@@ -1,40 +1,44 @@
-{
-  "name": "ellm-proxy",
-  "version": "0.0.2",
-  "description": "Self-hosted LLM gateway with admin web UI (pm2-managed)",
-  "license": "MIT",
-  "type": "module",
-  "engines": {
-    "node": ">=22.13.0"
-  },
-  "bin": {
-    "ellm-proxy": "bin/ellm-proxy.js"
-  },
-  "files": [
-    "bin",
-    "manager",
-    "utils",
-    "dist",
-    "docs",
-    "ellm.config.example.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node scripts/build-package.mjs",
-    "prepack": "node scripts/build-package.mjs"
-  },
-  "devDependencies": {
-    "@types/node": "^22.12.1"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.19.17",
-    "cac": "^6.7.14",
-    "get-node": "^15.0.4",
-    "hono": "^4.13.5",
-    "mri": "^1.2.0",
-    "pm2": "^7.0.4",
-    "smol-toml": "^1.8.0",
-    "yaml": "^2.9.0"
-  }
-}
+{
+  "name": "ellm-proxy",
+  "version": "0.0.6",
+  "description": "Self-hosted LLM gateway with admin web UI (pm2-managed)",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "bin": {
+    "ellm-proxy": "bin/ellm-proxy.js"
+  },
+  "files": [
+    "bin",
+    "manager",
+    "utils",
+    "dist",
+    "docs",
+    "ellm.config.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build-package.mjs",
+    "prepack": "node scripts/build-package.mjs",
+    "release": "node scripts/release.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.1"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.17",
+    "cac": "^6.7.14",
+    "get-node": "^15.0.4",
+    "hono": "^4.13.5",
+    "mri": "^1.2.0",
+    "pm2": "^7.0.4",
+    "smol-toml": "^1.8.0",
+    "yaml": "^2.9.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}