luckytri 1.2.1 → 1.2.3

package/server/i18n/errors.js

@@ -2,6 +2,20 @@
 // key, exactly as the code writes it. `{0}` stands for a value the code puts
 // into the message; patterns are used when a message carries one.
 export const ERRORS = {
+  表情开关无效: "Invalid sticker switch",
+  "图片理解尺寸应在 512–8192 像素之间":
+    "Image understanding size must be between 512 and 8192 pixels",
+  "图片理解大小应在 0.5–4 MB 之间":
+    "Image understanding size must be between 0.5 and 4 MB",
+  "可接收的图片大小应在 1–64 MB 之间":
+    "The accepted image size must be between 1 and 64 MB",
+  表情不存在: "The sticker does not exist",
+  文件为空: "The file is empty",
+  "表情超过 2MB，请压缩后再上传":
+    "The sticker is larger than 2 MB; compress it and upload again",
+  "只支持 PNG、JPEG、GIF、WebP 图片":
+    "Only PNG, JPEG, GIF and WebP images are supported",
+  "表情尺寸应在 4096 像素以内": "Stickers must be within 4096 pixels",
   复审超过截止时间: "The reply review passed its deadline",
   "JSON 同一对象含重复字段，不能确定哪份内容有效":
     "A JSON object contains duplicate fields; the intended value is ambiguous",
@@ -34,6 +48,42 @@ export const ERRORS = {
     "The update did not complete. The original program and data were retained. Check the runtime log before trying again.",
   "自动恢复未完成，更新前的校验备份已保留，请查看运行日志并手动恢复。":
     "Automatic recovery did not complete. The verified pre-update backup was retained. Check the runtime log and recover manually.",
+  "Node.js 版本不满足新版本要求，请先升级 Node.js 后重试。":
+    "This Node.js version does not meet the new release requirements. Upgrade Node.js and try again.",
+  "当前服务找不到 npm，请安装 npm 并检查服务的 PATH 配置。":
+    "The service cannot find npm. Install npm and check the service PATH.",
+  "npm 暂时无法下载该版本或其运行依赖，请稍后重新检查更新。":
+    "npm cannot download this release or its runtime dependencies yet. Check for updates again later.",
+  "连接 npm 失败，请检查服务器的网络、DNS 和代理配置。":
+    "Cannot reach npm. Check the server network, DNS and proxy settings.",
+  "连接 npm 时证书校验失败，请检查服务器的证书和代理配置。":
+    "Certificate verification failed when connecting to npm. Check the server certificates and proxy settings.",
+  "npm 拒绝了下载请求，请检查服务器的网络或代理访问限制。":
+    "npm rejected the download request. Check network or proxy access restrictions.",
+  "磁盘空间不足，请为新程序、数据库快照和迁移副本留出空间。":
+    "There is not enough disk space for the new program, database snapshot and migration copy.",
+  "服务账号没有所需的读写权限，请检查实例和更新目录的权限。":
+    "The service account lacks read or write access. Check the instance and update directory permissions.",
+  "当前更新步骤超时，请检查运行日志后重试。":
+    "The update step timed out. Check the runtime log and try again.",
+  "新版本安装失败，旧实例仍在运行，请查看运行日志中的 npm 报错。":
+    "Installation failed while the previous instance remains running. Check the npm errors in the runtime log.",
+  "新程序或本机运行依赖校验失败，请查看运行日志。":
+    "The new program or its local runtime dependencies failed validation. Check the runtime log.",
+  "旧实例未能安全停止，请检查进程管理和实例端口。":
+    "The previous instance could not be stopped safely. Check process management and the instance port.",
+  "更新前的数据库快照未能完成或通过校验，请查看运行日志。":
+    "The pre-update database snapshot could not be completed or verified. Check the runtime log.",
+  "记忆与数据迁移未通过校验，请查看运行日志。":
+    "Memory and data migration failed validation. Check the runtime log.",
+  "新实例未能正常启动，请检查运行日志和端口占用。":
+    "The new instance could not start correctly. Check the runtime log and port usage.",
+  "更新进程意外退出，请检查服务管理器、进程退出记录和运行日志。":
+    "The update process exited unexpectedly. Check the service manager, process exit records and runtime log.",
+  "旧版本或数据库恢复未完成，请使用更新前的校验备份恢复。":
+    "The previous program or database could not be restored. Recover from the verified pre-update backup.",
+  "当前更新步骤未完成，请查看运行日志。":
+    "The update step did not complete. Check the runtime log.",
   "缺少候选版本的数据迁移器，已停止更新":
     "The candidate release has no data migrator. The update was stopped.",
   迁移目标不是现有的绝对路径数据库文件:

package/server/runtime/update-errors.js

@@ -0,0 +1,73 @@
+// Only these descriptions reach the management UI. Subprocess output can
+// contain local paths or credentials and belongs in the local log only.
+export const UPDATE_FAILURES = Object.freeze({
+  NODE_UNSUPPORTED: "Node.js 版本不满足新版本要求，请先升级 Node.js 后重试。",
+  NPM_NOT_FOUND: "当前服务找不到 npm，请安装 npm 并检查服务的 PATH 配置。",
+  VERSION_UNAVAILABLE:
+    "npm 暂时无法下载该版本或其运行依赖，请稍后重新检查更新。",
+  NETWORK_ERROR: "连接 npm 失败，请检查服务器的网络、DNS 和代理配置。",
+  TLS_ERROR: "连接 npm 时证书校验失败，请检查服务器的证书和代理配置。",
+  REGISTRY_ACCESS: "npm 拒绝了下载请求，请检查服务器的网络或代理访问限制。",
+  DISK_FULL: "磁盘空间不足，请为新程序、数据库快照和迁移副本留出空间。",
+  PERMISSION_DENIED: "服务账号没有所需的读写权限，请检查实例和更新目录的权限。",
+  STEP_TIMEOUT: "当前更新步骤超时，请检查运行日志后重试。",
+  INSTALL_FAILED:
+    "新版本安装失败，旧实例仍在运行，请查看运行日志中的 npm 报错。",
+  PACKAGE_CHECK_FAILED: "新程序或本机运行依赖校验失败，请查看运行日志。",
+  STOP_FAILED: "旧实例未能安全停止，请检查进程管理和实例端口。",
+  BACKUP_FAILED: "更新前的数据库快照未能完成或通过校验，请查看运行日志。",
+  MIGRATION_FAILED: "记忆与数据迁移未通过校验，请查看运行日志。",
+  START_FAILED: "新实例未能正常启动，请检查运行日志和端口占用。",
+  UPDATE_INTERRUPTED:
+    "更新进程意外退出，请检查服务管理器、进程退出记录和运行日志。",
+  RECOVERY_FAILED: "旧版本或数据库恢复未完成，请使用更新前的校验备份恢复。",
+  STEP_FAILED: "当前更新步骤未完成，请查看运行日志。",
+});
+
+export function updateError(code) {
+  const known = Object.hasOwn(UPDATE_FAILURES, code) ? code : "STEP_FAILED";
+  return Object.assign(Error(UPDATE_FAILURES[known]), { updateCode: known });
+}
+
+export function npmFailureCode(output) {
+  for (const [pattern, code] of [
+    [/\bEBADENGINE\b/, "NODE_UNSUPPORTED"],
+    [/\bENOSPC\b/, "DISK_FULL"],
+    [/\b(?:EACCES|EPERM)\b/, "PERMISSION_DENIED"],
+    [/\b(?:E404|ETARGET)\b/, "VERSION_UNAVAILABLE"],
+    [/\b(?:E401|E403)\b/, "REGISTRY_ACCESS"],
+    [
+      /\b(?:CERT_[A-Z_]+|[A-Z_]*CERTIFICATE[A-Z_]*|SELF_SIGNED_CERT_IN_CHAIN|UNABLE_TO_VERIFY_LEAF_SIGNATURE)\b/,
+      "TLS_ERROR",
+    ],
+    [
+      /\b(?:ENOTFOUND|EAI_AGAIN|ECONNRESET|ECONNREFUSED|ETIMEDOUT|ESOCKETTIMEDOUT|ENETUNREACH|EHOSTUNREACH)\b/,
+      "NETWORK_ERROR",
+    ],
+  ])
+    if (pattern.test(output)) return code;
+  return "INSTALL_FAILED";
+}
+
+export function updateFailure(error, stage) {
+  const osCode = {
+    ENOSPC: "DISK_FULL",
+    EACCES: "PERMISSION_DENIED",
+    EPERM: "PERMISSION_DENIED",
+  }[error?.code];
+  const fallback =
+    {
+      downloading: "INSTALL_FAILED",
+      checking: "PACKAGE_CHECK_FAILED",
+      stopping: "STOP_FAILED",
+      backup: "BACKUP_FAILED",
+      migrating: "MIGRATION_FAILED",
+      restarting: "START_FAILED",
+      verifying: "START_FAILED",
+      restoring: "RECOVERY_FAILED",
+    }[stage] || "STEP_FAILED";
+  const failureCode = Object.hasOwn(UPDATE_FAILURES, error?.updateCode)
+    ? error.updateCode
+    : osCode || fallback;
+  return { failureCode, detail: UPDATE_FAILURES[failureCode] };
+}

package/server/runtime/update-execution.js

@@ -15,6 +15,7 @@ import {
 } from "./update-manager.js";
 import { backupDatabase } from "../../scripts/backup.js";
 import { restoreToNewFile, verifyArchive } from "../storage/archive.js";
+import { updateFailure } from "./update-errors.js";
 
 // Executed outside the server so a large verified snapshot does not stall the
 // WebUI. Dependencies are explicit for failure, restart and rollback tests.
@@ -105,12 +106,9 @@ export async function performUpdate(
     return job;
   } catch (error) {
     const failedStage = job.status;
-    job = { ...job, failedStage };
-    console.error(
-      "更新步骤未完成：",
-      failedStage,
-      error.code || error.cause?.code || "STEP_FAILED",
-    );
+    const failure = updateFailure(error, failedStage);
+    job = { ...job, failedStage, ...failure };
+    console.error("更新步骤未完成：", failedStage, failure.failureCode, error);
     if (!stopped) {
       save("error", { error: UPDATE_FAILED, finished: Date.now() });
       return job;
@@ -150,6 +148,7 @@ export async function performUpdate(
               `${paths.database}.update-failed-${id}.migration${suffix}`,
             );
       const restored = await start(paths.package);
+      save("restoring", { childPid: restored });
       await health(restored, job.previous);
       save("error", {
         error: UPDATE_FAILED,
@@ -157,8 +156,14 @@ export async function performUpdate(
         childPid: restored,
         finished: Date.now(),
       });
-    } catch {
-      save("error", { error: UPDATE_RECOVERY_FAILED, finished: Date.now() });
+    } catch (recoveryError) {
+      const recovery = updateFailure(recoveryError, "restoring");
+      console.error("更新恢复未完成：", recovery.failureCode, recoveryError);
+      save("error", {
+        error: UPDATE_RECOVERY_FAILED,
+        recoveryCode: recovery.failureCode,
+        finished: Date.now(),
+      });
     }
     return job;
   } finally {

package/server/runtime/update-manager.js

@@ -1,6 +1,11 @@
 import { randomUUID } from "node:crypto";
 import { mkdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import {
+  updateError,
+  updateFailure,
+  UPDATE_FAILURES,
+} from "./update-errors.js";
 import {
   atomicJson,
   UPDATE_ID,
@@ -11,7 +16,7 @@ export const UPDATE_FAILED =
   "更新未完成，原程序和数据已保留，请查看运行日志后重试。";
 export const UPDATE_RECOVERY_FAILED =
   "自动恢复未完成，更新前的校验备份已保留，请查看运行日志并手动恢复。";
-const ACTIVE = new Set([
+export const UPDATE_ACTIVE_STAGES = Object.freeze([
   "queued",
   "downloading",
   "checking",
@@ -22,6 +27,12 @@ const ACTIVE = new Set([
   "verifying",
   "restoring",
 ]);
+const ACTIVE = new Set(UPDATE_ACTIVE_STAGES);
+export const isUpdateActive = (stage) => ACTIVE.has(stage);
+export const isUpdateFinished = (stage) =>
+  stage === "done" || stage === "error";
+const beforeStop = (stage) =>
+  ["queued", "downloading", "checking"].includes(stage);
 export const processAlive = (pid) => {
   if (!Number.isInteger(pid) || pid <= 0) return false;
   try {
@@ -70,18 +81,17 @@ export class InstanceUpdater {
       return null;
     }
     if (
-      ACTIVE.has(job.status) &&
+      isUpdateActive(job.status) &&
       job.workerPid &&
       !processAlive(job.workerPid)
     ) {
+      const failedStage = job.status;
       job = writeUpdateJob(this.paths.home, {
         ...job,
         status: "error",
-        error: ["queued", "downloading", "checking", "migrating"].includes(
-          job.status,
-        )
-          ? UPDATE_FAILED
-          : UPDATE_RECOVERY_FAILED,
+        failedStage,
+        ...updateFailure(updateError("UPDATE_INTERRUPTED"), failedStage),
+        error: beforeStop(failedStage) ? UPDATE_FAILED : UPDATE_RECOVERY_FAILED,
         finished: this.now(),
       });
     }
@@ -95,10 +105,22 @@ export class InstanceUpdater {
       finished: job.finished,
       error: job.error || "",
       restored: !!job.restored,
+      ...(isUpdateActive(job.failedStage)
+        ? { failedStage: job.failedStage }
+        : {}),
+      ...(Object.hasOwn(UPDATE_FAILURES, job.failureCode)
+        ? {
+            failureCode: job.failureCode,
+            detail: UPDATE_FAILURES[job.failureCode],
+          }
+        : {}),
+      ...(Object.hasOwn(UPDATE_FAILURES, job.recoveryCode)
+        ? { recoveryDetail: UPDATE_FAILURES[job.recoveryCode] }
+        : {}),
     };
   }
   get busy() {
-    return this.starting || ACTIVE.has(this.status()?.status);
+    return this.starting || isUpdateActive(this.status()?.status);
   }
   async install(version) {
     if (this.busy) return this.status();

package/server/stickers/api.js

@@ -0,0 +1,149 @@
+import express from "express";
+
+// The owner's sticker library. Uploads arrive as raw bytes, one file per
+// request; everything else is JSON like the rest of the studio API.
+export function mountStickerUpload(app, system) {
+  app.post(
+    "/api/core/stickers/upload",
+    express.raw({ type: "*/*", limit: "3mb" }),
+    async (req, res) => {
+      try {
+        const item = await system.stickers.library.add(req.body, {
+          name: String(req.query.name || "").replace(/\.[a-z0-9]+$/i, ""),
+          category: String(req.query.category || ""),
+        });
+        if (!item.duplicate) queueDescribe(system, item.id);
+        res.json(item);
+      } catch (error) {
+        res.status(400).json({ error: error.message });
+      }
+    },
+  );
+}
+
+const queue = [];
+let running = false;
+function queueDescribe(system, id) {
+  queue.push(id);
+  if (running) return;
+  running = true;
+  (async () => {
+    while (queue.length) {
+      const next = queue.shift();
+      try {
+        await system.stickers.describe(next, { force: true });
+      } catch {
+        // The item records its own failure; the owner can retry.
+      }
+    }
+    running = false;
+  })();
+}
+
+const MEDIA_DEFAULTS = {
+  visionMaxSide: 2048,
+  visionMaxMB: 3,
+  visionSourceMaxMB: 20,
+};
+export function mediaSettings(repo) {
+  return { ...MEDIA_DEFAULTS, ...(repo.config("media") || {}) };
+}
+
+export function mountStickers(app, system) {
+  const { library } = system.stickers;
+  const wrap = (fn) => async (req, res) => {
+    try {
+      await fn(req, res);
+    } catch (error) {
+      res.status(400).json({ error: error.message });
+    }
+  };
+  app.get(
+    "/api/core/stickers",
+    wrap((req, res) =>
+      res.json({
+        items: library.list({
+          q: req.query.q || "",
+          category: req.query.category || "",
+        }),
+        categories: library.categories(),
+        settings: system.stickers.settings(),
+        pending: queue.length,
+      }),
+    ),
+  );
+  app.get(
+    "/api/core/stickers/:id/image",
+    wrap((req, res) => {
+      const image = library.image(req.params.id);
+      if (!image) return res.status(404).json({ error: "表情不存在" });
+      res.setHeader("Content-Type", image.mime);
+      res.setHeader("X-Content-Type-Options", "nosniff");
+      res.setHeader("Cache-Control", "private, max-age=86400");
+      res.end(Buffer.from(image.bytes));
+    }),
+  );
+  app.patch(
+    "/api/core/stickers/:id",
+    wrap((req, res) => res.json(library.update(req.params.id, req.body))),
+  );
+  app.delete(
+    "/api/core/stickers/:id",
+    wrap((req, res) => {
+      library.remove(req.params.id);
+      res.json({ ok: true });
+    }),
+  );
+  app.post(
+    "/api/core/stickers/:id/describe",
+    wrap((req, res) => {
+      if (!library.get(req.params.id)) throw Error("表情不存在");
+      library.update(req.params.id, { status: "pending" });
+      queueDescribe(system, req.params.id);
+      res.json({ ok: true });
+    }),
+  );
+  app.put(
+    "/api/core/stickers-settings",
+    wrap((req, res) => {
+      const { enabled, taggingModelId } = req.body;
+      if (enabled !== undefined && typeof enabled !== "boolean")
+        throw Error("表情开关无效");
+      system.repo.saveConfig("stickers", {
+        ...system.stickers.settings(),
+        ...(enabled !== undefined ? { enabled } : {}),
+        ...(taggingModelId !== undefined
+          ? { taggingModelId: String(taggingModelId || "") }
+          : {}),
+      });
+      res.json(system.stickers.settings());
+    }),
+  );
+  app.get(
+    "/api/core/media-settings",
+    wrap((req, res) => res.json(mediaSettings(system.repo))),
+  );
+  app.put(
+    "/api/core/media-settings",
+    wrap((req, res) => {
+      const side = Number(req.body.visionMaxSide);
+      const mb = Number(req.body.visionMaxMB);
+      const source = Number(
+        req.body.visionSourceMaxMB ??
+          mediaSettings(system.repo).visionSourceMaxMB,
+      );
+      if (!Number.isFinite(source) || source < 1 || source > 64)
+        throw Error("可接收的图片大小应在 1–64 MB 之间");
+      if (!Number.isInteger(side) || side < 512 || side > 8192)
+        throw Error("图片理解尺寸应在 512–8192 像素之间");
+      if (!Number.isFinite(mb) || mb < 0.5 || mb > 4)
+        throw Error("图片理解大小应在 0.5–4 MB 之间");
+      system.repo.saveConfig("media", {
+        visionMaxSide: side,
+        visionMaxMB: mb,
+        visionSourceMaxMB: source,
+      });
+      res.json(mediaSettings(system.repo));
+    }),
+  );
+}