ellm-proxy 0.0.3 → 0.0.7

package/manager/api/harness/index.js

@@ -1,118 +1,118 @@
-// harness 代理开关聚合：Claude Code / Codex CLI / DeepSeek Harness 流量指向本机 ellm-proxy 网关。
-//   纯开关实现：claude-code.js（~/.claude/settings.json）/ codex.js（~/.codex/config.toml）/
-//   dsh.js（~/.dsh/settings.yaml + ~/.dsh/.credentials.yaml）/ backup.js（共用备份还原）
-//   createHarnessApp = HTTP 路由子应用（挂载于 /harness）：状态查询 + 开关切换（含 masterKey 校验与提示文案）
-import { Hono } from "hono";
-import { readFileSync } from "node:fs";
-import { resolveGatewayBase } from "../../../utils/service.js";
-import { claudeCodeStatus, claudeCodeEnable, claudeCodeDisable } from "./claude-code.js";
-import { codexStatus, codexEnable, codexDisable } from "./codex.js";
-import { dshStatus, dshEnable, dshDisable } from "./dsh.js";
-
-/** 配置文件顶层 masterKey（Claude Code 代理的 AUTH_TOKEN 取值；网关侧用它做鉴权） */
-function readMasterKey(configFile) {
-  try {
-    return JSON.parse(readFileSync(configFile, "utf-8")).masterKey || "";
-  } catch {
-    return "";
-  }
-}
-
-/** harness 开关子应用（挂载于 /harness）：GET / · POST /claude-code · POST /codex · POST /dsh（body {enabled}） */
-export function createHarnessApp({ startOpts }) {
-  const app = new Hono();
-
-  // GET /harness：三个开关状态
-  app.get("/", (c) => {
-    const { base } = resolveGatewayBase(startOpts.config);
-    return c.json({ ok: true, claudeCode: claudeCodeStatus(base), codex: codexStatus(), dsh: dshStatus(base), gatewayBase: base });
-  });
-
-  /** 读 body 并校验 enabled；合法返回 boolean，非法返回 400 Response（调用方直接 return 该响应） */
-  const requireEnabled = async (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;
-  };
-
-  app.post("/claude-code", async (c) => {
-    const enabled = await requireEnabled(c);
-    if (enabled instanceof Response) return enabled;
-    const { base, configFile } = resolveGatewayBase(startOpts.config);
-    if (enabled) {
-      const masterKey = readMasterKey(configFile);
-      if (!masterKey) {
-        return c.json(
-          {
-            ok: false,
-            error: `配置未设置 masterKey，Claude Code 代理无法鉴权。请先在配置文件中设置 masterKey: ${configFile}`,
-          },
-          400,
-        );
-      }
-      claudeCodeEnable({ gatewayBase: base, token: masterKey });
-      return c.json({
-        ok: true,
-        claudeCode: true,
-        file: "~/.claude/settings.json",
-        note: "已备份原文件为 settings.json.ellm-bak，重启 Claude Code 会话后生效",
-      });
-    }
-    const changed = claudeCodeDisable(base);
-    return c.json({ ok: true, claudeCode: false, changed, note: changed ? "已从备份还原" : "原本未开启，无操作" });
-  });
-
-  app.post("/codex", async (c) => {
-    const enabled = await requireEnabled(c);
-    if (enabled instanceof Response) return enabled;
-    const { base, configFile } = resolveGatewayBase(startOpts.config);
-    if (enabled) {
-      codexEnable({ gatewayBase: base });
-      const masterKey = readMasterKey(configFile);
-      return c.json({
-        ok: true,
-        codex: true,
-        file: "~/.codex/config.toml",
-        note: masterKey
-          ? `已备份原文件为 config.toml.ellm-bak；请设置环境变量 ELLM_PROXY_API_KEY=${masterKey}（Codex 以 env_key 读取鉴权）`
-          : "已备份原文件为 config.toml.ellm-bak；请设置环境变量 ELLM_PROXY_API_KEY（网关未配 masterKey 时取值任意）",
-      });
-    }
-    const changed = codexDisable();
-    return c.json({ ok: true, codex: false, changed, note: changed ? "已从备份还原" : "原本未开启，无操作" });
-  });
-
-  app.post("/dsh", async (c) => {
-    const enabled = await requireEnabled(c);
-    if (enabled instanceof Response) return enabled;
-    const { base, configFile } = resolveGatewayBase(startOpts.config);
-    const masterKey = readMasterKey(configFile);
-    if (enabled) {
-      dshEnable({ gatewayBase: base, masterKey });
-      return c.json({
-        ok: true,
-        dsh: true,
-        file: "~/.dsh/settings.yaml",
-        note: masterKey
-          ? "已写入 settings.yaml（llm-deepseek.baseURL）与 .credentials.yaml（refs.DEEPSEEK_API_KEY），原文件备份为 *.ellm-bak。注意：进程环境里已设 DEEPSEEK_API_KEY 时其优先级更高，需自行改用网关 masterKey；模型请在 dsh 内选择与网关部署名一致的模型"
-          : "已写入 settings.yaml 与 .credentials.yaml（网关未配 masterKey，密钥为占位值即可放行），原文件备份为 *.ellm-bak。模型请在 dsh 内选择与网关部署名一致的模型",
-      });
-    }
-    const changed = dshDisable(base, masterKey);
-    return c.json({ ok: true, dsh: false, changed, note: changed ? "已从备份还原（或移除本开关写入的字段）" : "原本未开启，无操作" });
-  });
-
-  return app;
-}
-
-// 纯开关函数同时聚合导出（供不经过 HTTP 的调用方直接使用）
-export * from "./claude-code.js";
-export * from "./codex.js";
-export * from "./dsh.js";
+// harness 代理开关聚合：Claude Code / Codex CLI / DeepSeek Harness 流量指向本机 ellm-proxy 网关。
+//   纯开关实现：claude-code.js（~/.claude/settings.json）/ codex.js（~/.codex/config.toml）/
+//   dsh.js（~/.dsh/settings.yaml + ~/.dsh/.credentials.yaml）/ backup.js（共用备份还原）
+//   createHarnessApp = HTTP 路由子应用（挂载于 /harness）：状态查询 + 开关切换（含 masterKey 校验与提示文案）
+import { Hono } from "hono";
+import { readFileSync } from "node:fs";
+import { resolveGatewayBase } from "../../../utils/service.js";
+import { claudeCodeStatus, claudeCodeEnable, claudeCodeDisable } from "./claude-code.js";
+import { codexStatus, codexEnable, codexDisable } from "./codex.js";
+import { dshStatus, dshEnable, dshDisable } from "./dsh.js";
+
+/** 配置文件顶层 masterKey（Claude Code 代理的 AUTH_TOKEN 取值；网关侧用它做鉴权） */
+function readMasterKey(configFile) {
+  try {
+    return JSON.parse(readFileSync(configFile, "utf-8")).masterKey || "";
+  } catch {
+    return "";
+  }
+}
+
+/** harness 开关子应用（挂载于 /harness）：GET / · POST /claude-code · POST /codex · POST /dsh（body {enabled}） */
+export function createHarnessApp({ startOpts }) {
+  const app = new Hono();
+
+  // GET /harness：三个开关状态
+  app.get("/", (c) => {
+    const { base } = resolveGatewayBase(startOpts.config);
+    return c.json({ ok: true, claudeCode: claudeCodeStatus(base), codex: codexStatus(), dsh: dshStatus(base), gatewayBase: base });
+  });
+
+  /** 读 body 并校验 enabled；合法返回 boolean，非法返回 400 Response（调用方直接 return 该响应） */
+  const requireEnabled = async (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;
+  };
+
+  app.post("/claude-code", async (c) => {
+    const enabled = await requireEnabled(c);
+    if (enabled instanceof Response) return enabled;
+    const { base, configFile } = resolveGatewayBase(startOpts.config);
+    if (enabled) {
+      const masterKey = readMasterKey(configFile);
+      if (!masterKey) {
+        return c.json(
+          {
+            ok: false,
+            error: `配置未设置 masterKey，Claude Code 代理无法鉴权。请先在配置文件中设置 masterKey: ${configFile}`,
+          },
+          400,
+        );
+      }
+      claudeCodeEnable({ gatewayBase: base, token: masterKey });
+      return c.json({
+        ok: true,
+        claudeCode: true,
+        file: "~/.claude/settings.json",
+        note: "已备份原文件为 settings.json.ellm-bak，重启 Claude Code 会话后生效",
+      });
+    }
+    const changed = claudeCodeDisable(base);
+    return c.json({ ok: true, claudeCode: false, changed, note: changed ? "已从备份还原" : "原本未开启，无操作" });
+  });
+
+  app.post("/codex", async (c) => {
+    const enabled = await requireEnabled(c);
+    if (enabled instanceof Response) return enabled;
+    const { base, configFile } = resolveGatewayBase(startOpts.config);
+    if (enabled) {
+      codexEnable({ gatewayBase: base });
+      const masterKey = readMasterKey(configFile);
+      return c.json({
+        ok: true,
+        codex: true,
+        file: "~/.codex/config.toml",
+        note: masterKey
+          ? `已备份原文件为 config.toml.ellm-bak；请设置环境变量 ELLM_PROXY_API_KEY=${masterKey}（Codex 以 env_key 读取鉴权）`
+          : "已备份原文件为 config.toml.ellm-bak；请设置环境变量 ELLM_PROXY_API_KEY（网关未配 masterKey 时取值任意）",
+      });
+    }
+    const changed = codexDisable();
+    return c.json({ ok: true, codex: false, changed, note: changed ? "已从备份还原" : "原本未开启，无操作" });
+  });
+
+  app.post("/dsh", async (c) => {
+    const enabled = await requireEnabled(c);
+    if (enabled instanceof Response) return enabled;
+    const { base, configFile } = resolveGatewayBase(startOpts.config);
+    const masterKey = readMasterKey(configFile);
+    if (enabled) {
+      dshEnable({ gatewayBase: base, masterKey });
+      return c.json({
+        ok: true,
+        dsh: true,
+        file: "~/.dsh/settings.yaml",
+        note: masterKey
+          ? "已写入 settings.yaml（llm-deepseek.baseURL）与 .credentials.yaml（refs.DEEPSEEK_API_KEY），原文件备份为 *.ellm-bak。注意：进程环境里已设 DEEPSEEK_API_KEY 时其优先级更高，需自行改用网关 masterKey；模型请在 dsh 内选择与网关部署名一致的模型"
+          : "已写入 settings.yaml 与 .credentials.yaml（网关未配 masterKey，密钥为占位值即可放行），原文件备份为 *.ellm-bak。模型请在 dsh 内选择与网关部署名一致的模型",
+      });
+    }
+    const changed = dshDisable(base, masterKey);
+    return c.json({ ok: true, dsh: false, changed, note: changed ? "已从备份还原（或移除本开关写入的字段）" : "原本未开启，无操作" });
+  });
+
+  return app;
+}
+
+// 纯开关函数同时聚合导出（供不经过 HTTP 的调用方直接使用）
+export * from "./claude-code.js";
+export * from "./codex.js";
+export * from "./dsh.js";

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);