luckytri 1.2.3 → 1.3.0

package/server/studio/updates.js

@@ -1,144 +1,154 @@
-import { SOURCE_CHECKOUT } from "../paths.js";
-import { USER_AGENT, VERSION } from "../version.js";
-
-const REGISTRY = "https://registry.npmjs.org/luckytri/latest";
-const SEMVER =
-  /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-function parts(value) {
-  const m =
-    typeof value === "string" && value.length <= 100 && value.match(SEMVER);
-  if (!m || m.slice(1, 4).some((n) => !Number.isSafeInteger(Number(n))))
-    return null;
-  if (m[4]?.split(".").some((part) => /^0\d+$/.test(part))) return null;
-  return { numbers: m.slice(1, 4).map(Number), pre: m[4]?.split(".") || [] };
-}
-export function compareVersions(a, b) {
-  const left = parts(a),
-    right = parts(b);
-  if (!left || !right) throw Error("版本信息无效");
-  for (let i = 0; i < 3; i++)
-    if (left.numbers[i] !== right.numbers[i])
-      return Math.sign(left.numbers[i] - right.numbers[i]);
-  if (!left.pre.length || !right.pre.length)
-    return Math.sign(Number(!left.pre.length) - Number(!right.pre.length));
-  for (let i = 0; i < Math.max(left.pre.length, right.pre.length); i++) {
-    const x = left.pre[i],
-      y = right.pre[i];
-    if (x === y) continue;
-    if (x === undefined || y === undefined) return x === undefined ? -1 : 1;
-    const xn = /^\d+$/.test(x),
-      yn = /^\d+$/.test(y);
-    if (xn && yn) return BigInt(x) < BigInt(y) ? -1 : 1;
-    if (xn !== yn) return xn ? -1 : 1;
-    return x < y ? -1 : 1;
-  }
-  return 0;
-}
-
-// A manual, bounded metadata read. It never installs code, runs commands or
-// sends instance data, model keys or npm login credentials to the registry.
-export class UpdateChecker {
-  constructor({
-    fetch: fetcher = globalThis.fetch,
-    now = Date.now,
-    current = VERSION,
-    source = SOURCE_CHECKOUT,
-    timeout = 10000,
-  } = {}) {
-    this.fetch = fetcher;
-    this.now = now;
-    this.current = current;
-    this.source = source;
-    this.timeout = timeout;
-    this.latest = null;
-    this.checkedAt = null;
-    this.lastAttempt = null;
-    this.error = "";
-    this.pending = null;
-  }
-  status() {
-    return {
-      current: this.current,
-      latest: this.latest,
-      checkedAt: this.checkedAt,
-      error: this.error,
-      status: this.error
-        ? "unavailable"
-        : !this.latest
-          ? "unchecked"
-          : compareVersions(this.latest, this.current) > 0
-            ? "available"
-            : compareVersions(this.latest, this.current) === 0
-              ? "current"
-              : "ahead",
-      installation: this.source ? "source" : "npm",
-      npmUrl: "https://www.npmjs.com/package/luckytri",
-      releaseUrl: "https://github.com/TodayYueC/LuckyTri/releases",
-    };
-  }
-  check() {
-    if (this.pending) return this.pending;
-    const now = this.now();
-    const elapsed =
-      this.lastAttempt == null ? Infinity : now - this.lastAttempt;
-    if (elapsed >= 0 && elapsed < (this.error ? 15000 : 300000))
-      return Promise.resolve({ ...this.status(), cached: true });
-    this.lastAttempt = now;
-    this.pending = this.read().finally(() => {
-      this.pending = null;
-    });
-    return this.pending;
-  }
-  async read() {
-    let response;
-    try {
-      response = await this.fetch(REGISTRY, {
-        headers: { Accept: "application/json", "User-Agent": USER_AGENT },
-        redirect: "error",
-        signal: AbortSignal.timeout(this.timeout),
-      });
-      if (!response.ok) throw Error(`HTTP ${response.status}`);
-      if (Number(response.headers.get("content-length")) > 65536)
-        throw Error("版本信息过大");
-      const chunks = [];
-      let bytes = 0;
-      for await (const chunk of response.body) {
-        bytes += chunk.length;
-        if (bytes > 65536) throw Error("版本信息过大");
-        chunks.push(Buffer.from(chunk));
-      }
-      const data = JSON.parse(Buffer.concat(chunks).toString("utf8"));
-      if (data.name !== "luckytri" || !parts(data.version))
-        throw Error("版本信息无效");
-      this.latest = data.version;
-      this.checkedAt = this.now();
-      this.error = "";
-    } catch {
-      try {
-        await response?.body?.cancel();
-      } catch {
-        /* Already consumed or cancelled. */
-      }
-      this.error = "暂时无法连接 npm 或读取版本信息，请稍后重试。";
-    }
-    return { ...this.status(), cached: false };
-  }
-}
-
-export function mountUpdates(app, checker, updater) {
-  const view = (info) => ({ ...info, operation: updater?.status() || null });
-  app.get("/api/system/update", (_req, res) =>
-    res.json(view(checker.status())),
-  );
-  app.post("/api/system/update/check", async (_req, res) =>
-    res.json(view(await checker.check())),
-  );
-  app.post("/api/system/update/install", async (req, res) => {
-    try {
-      if (!updater) throw Error("当前实例不支持自动更新");
-      res.json(await updater.install(req.body.version));
-    } catch (error) {
-      res.status(400).json({ error: error.message });
-    }
-  });
-}
+import { SOURCE_CHECKOUT } from "../paths.js";
+import { USER_AGENT, VERSION } from "../version.js";
+
+const REGISTRY = "https://registry.npmjs.org/luckytri/latest";
+const SEMVER =
+  /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function parts(value) {
+  const m =
+    typeof value === "string" && value.length <= 100 && value.match(SEMVER);
+  if (!m || m.slice(1, 4).some((n) => !Number.isSafeInteger(Number(n))))
+    return null;
+  if (m[4]?.split(".").some((part) => /^0\d+$/.test(part))) return null;
+  return { numbers: m.slice(1, 4).map(Number), pre: m[4]?.split(".") || [] };
+}
+export function compareVersions(a, b) {
+  const left = parts(a),
+    right = parts(b);
+  if (!left || !right) throw Error("版本信息无效");
+  for (let i = 0; i < 3; i++)
+    if (left.numbers[i] !== right.numbers[i])
+      return Math.sign(left.numbers[i] - right.numbers[i]);
+  if (!left.pre.length || !right.pre.length)
+    return Math.sign(Number(!left.pre.length) - Number(!right.pre.length));
+  for (let i = 0; i < Math.max(left.pre.length, right.pre.length); i++) {
+    const x = left.pre[i],
+      y = right.pre[i];
+    if (x === y) continue;
+    if (x === undefined || y === undefined) return x === undefined ? -1 : 1;
+    const xn = /^\d+$/.test(x),
+      yn = /^\d+$/.test(y);
+    if (xn && yn) return BigInt(x) < BigInt(y) ? -1 : 1;
+    if (xn !== yn) return xn ? -1 : 1;
+    return x < y ? -1 : 1;
+  }
+  return 0;
+}
+
+// A manual, bounded metadata read. It never installs code, runs commands or
+// sends instance data, model keys or npm login credentials to the registry.
+export class UpdateChecker {
+  constructor({
+    fetch: fetcher = globalThis.fetch,
+    now = Date.now,
+    current = VERSION,
+    source = SOURCE_CHECKOUT,
+    timeout = 10000,
+  } = {}) {
+    this.fetch = fetcher;
+    this.now = now;
+    this.current = current;
+    this.source = source;
+    this.timeout = timeout;
+    this.latest = null;
+    this.checkedAt = null;
+    this.lastAttempt = null;
+    this.error = "";
+    this.pending = null;
+  }
+  status() {
+    return {
+      current: this.current,
+      latest: this.latest,
+      checkedAt: this.checkedAt,
+      error: this.error,
+      status: this.error
+        ? "unavailable"
+        : !this.latest
+          ? "unchecked"
+          : compareVersions(this.latest, this.current) > 0
+            ? "available"
+            : compareVersions(this.latest, this.current) === 0
+              ? "current"
+              : "ahead",
+      installation: this.source ? "source" : "npm",
+      npmUrl: "https://www.npmjs.com/package/luckytri",
+      releaseUrl: "https://github.com/TodayYueC/LuckyTri/releases",
+    };
+  }
+  check() {
+    if (this.pending) return this.pending;
+    const now = this.now();
+    const elapsed =
+      this.lastAttempt == null ? Infinity : now - this.lastAttempt;
+    if (elapsed >= 0 && elapsed < (this.error ? 15000 : 300000))
+      return Promise.resolve({ ...this.status(), cached: true });
+    this.lastAttempt = now;
+    this.pending = this.read().finally(() => {
+      this.pending = null;
+    });
+    return this.pending;
+  }
+  async read() {
+    let response;
+    try {
+      response = await this.fetch(REGISTRY, {
+        headers: { Accept: "application/json", "User-Agent": USER_AGENT },
+        redirect: "error",
+        signal: AbortSignal.timeout(this.timeout),
+      });
+      if (!response.ok) throw Error(`HTTP ${response.status}`);
+      if (Number(response.headers.get("content-length")) > 65536)
+        throw Error("版本信息过大");
+      const chunks = [];
+      let bytes = 0;
+      for await (const chunk of response.body) {
+        bytes += chunk.length;
+        if (bytes > 65536) throw Error("版本信息过大");
+        chunks.push(Buffer.from(chunk));
+      }
+      const data = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+      if (data.name !== "luckytri" || !parts(data.version))
+        throw Error("版本信息无效");
+      this.latest = data.version;
+      this.checkedAt = this.now();
+      this.error = "";
+    } catch {
+      try {
+        await response?.body?.cancel();
+      } catch {
+        /* Already consumed or cancelled. */
+      }
+      this.error = "暂时无法连接 npm 或读取版本信息，请稍后重试。";
+    }
+    return { ...this.status(), cached: false };
+  }
+}
+
+export function mountUpdates(app, checker, updater, autoUpdate) {
+  const view = (info) => ({
+    ...info,
+    operation: updater?.status() || null,
+    auto: autoUpdate?.view() || null,
+  });
+  app.post("/api/system/update/auto", (req, res) => {
+    if (!autoUpdate)
+      return res.status(400).json({ error: "当前实例不支持自动更新" });
+    autoUpdate.save(req.body || {});
+    res.json(view(checker.status()));
+  });
+  app.get("/api/system/update", (_req, res) =>
+    res.json(view(checker.status())),
+  );
+  app.post("/api/system/update/check", async (_req, res) =>
+    res.json(view(await checker.check())),
+  );
+  app.post("/api/system/update/install", async (req, res) => {
+    try {
+      if (!updater) throw Error("当前实例不支持自动更新");
+      res.json(await updater.install(req.body.version));
+    } catch (error) {
+      res.status(400).json({ error: error.message });
+    }
+  });
+}

package/server/voice/index.js

@@ -0,0 +1,255 @@
+// Her voice: text to speech for a short line she chooses to say aloud.
+// Off unless the owner configures a speech service and turns it on; even
+// then saying it aloud (or singing) is her choice in the turn, never forced.
+import { randomUUID } from "node:crypto";
+import { saucTranscribe } from "./sauc.js";
+
+export const VOICE_DEFAULTS = {
+  enabled: false,
+  protocol: "volc-openspeech-v3", // or openai-audio
+  baseUrl: "https://openspeech.bytedance.com/api/v3/plan/tts/unidirectional",
+  resourceId: "seed-tts-2.0",
+  model: "",
+  speaker: "zh_female_vv_uranus_bigtts",
+  // How her voice sounds, in words; sent as a tone hint where supported.
+  style: "",
+  format: "mp3",
+  sampleRate: 24000,
+  apiKey: "",
+  // Understanding voice messages people send (speech recognition).
+  listen: false,
+  // Agent Plan preset; volc-flash and openai-audio are the alternatives.
+  asrProtocol: "volc-plan-sauc",
+  asrBaseUrl:
+    "wss://openspeech.bytedance.com/api/v3/plan/sauc/bigmodel_nostream",
+  asrResourceId: "volc.seedasr.sauc.duration",
+  asrModel: "",
+  asrApiKey: "",
+};
+const MAX_CHARS = 60;
+
+export function voiceSettings(repo) {
+  return { ...VOICE_DEFAULTS, ...(repo.config("voice") || {}) };
+}
+export function publicVoice(settings) {
+  const { apiKey, asrApiKey, ...safe } = settings;
+  return {
+    ...safe,
+    hasApiKey: !!apiKey,
+    hasAsrApiKey: !!asrApiKey,
+    ready: voiceReady(settings),
+    hearingReady: hearingReady(settings),
+  };
+}
+export function voiceReady(s) {
+  return !!(s.apiKey && s.baseUrl && s.speaker);
+}
+// Whether "say it aloud" is offered at all this turn.
+export function voiceOffered(s) {
+  return s.enabled === true && voiceReady(s);
+}
+export function hearingReady(s) {
+  return !!((s.asrApiKey || s.apiKey) && s.asrBaseUrl);
+}
+export function hearingOn(s) {
+  return s.listen === true && hearingReady(s);
+}
+
+export async function transcribe(
+  s,
+  audio,
+  format = "mp3",
+  { fetch: f = globalThis.fetch } = {},
+) {
+  if (!hearingReady(s)) throw new Error("语音识别还没有配置");
+  const key = s.asrApiKey || s.apiKey;
+  if (s.asrProtocol === "volc-plan-sauc")
+    return saucTranscribe(
+      { url: s.asrBaseUrl, key, resourceId: s.asrResourceId },
+      audio,
+    );
+  const signal = AbortSignal.timeout(15000);
+  if (s.asrProtocol === "openai-audio") {
+    const form = new FormData();
+    form.append("model", s.asrModel || "whisper-1");
+    form.append("file", new Blob([audio]), `voice.${format}`);
+    const r = await f(
+      `${s.asrBaseUrl.replace(/\/$/, "")}/audio/transcriptions`,
+      {
+        method: "POST",
+        signal,
+        headers: { Authorization: `Bearer ${key}` },
+        body: form,
+      },
+    );
+    if (!r.ok)
+      throw Object.assign(new Error("语音识别失败"), { status: r.status });
+    return String((await r.json()).text || "");
+  }
+  const r = await f(s.asrBaseUrl, {
+    method: "POST",
+    signal,
+    headers: {
+      "X-Api-Key": key,
+      "X-Api-Resource-Id": s.asrResourceId || "volc.bigasr.auc_turbo",
+      "X-Api-Request-Id": randomUUID(),
+      "X-Api-Sequence": "-1",
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      user: { uid: "luckytri" },
+      audio: { data: Buffer.from(audio).toString("base64"), format },
+      request: { model_name: "bigmodel", enable_punc: true, enable_itn: true },
+    }),
+  });
+  if (!r.ok)
+    throw Object.assign(new Error("语音识别失败"), { status: r.status });
+  const data = await r.json();
+  return String(data?.result?.text || data?.text || "");
+}
+
+export function speakable(bubbles) {
+  const text = (bubbles || []).join("，");
+  return text.length > 0 && text.length <= MAX_CHARS;
+}
+
+export async function synthesize(
+  s,
+  text,
+  { fetch: f = globalThis.fetch } = {},
+) {
+  if (!voiceReady(s)) throw new Error("语音服务还没有配置");
+  const signal = AbortSignal.timeout(20000);
+  if (s.protocol === "openai-audio") {
+    const r = await f(`${s.baseUrl.replace(/\/$/, "")}/audio/speech`, {
+      method: "POST",
+      signal,
+      headers: {
+        Authorization: `Bearer ${s.apiKey}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        model: s.model || "tts-1",
+        voice: s.speaker,
+        input: text,
+        response_format: s.format || "mp3",
+        ...(s.style ? { instructions: s.style } : {}),
+      }),
+    });
+    if (!r.ok)
+      throw Object.assign(new Error("语音合成失败"), { status: r.status });
+    return Buffer.from(await r.arrayBuffer());
+  }
+  const r = await f(s.baseUrl, {
+    method: "POST",
+    signal,
+    headers: {
+      "X-Api-Key": s.apiKey,
+      "X-Api-Resource-Id": s.resourceId || "seed-tts-2.0",
+      "X-Api-Request-Id": randomUUID(),
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      user: { uid: "luckytri" },
+      req_params: {
+        text,
+        speaker: s.speaker,
+        audio_params: {
+          format: s.format || "mp3",
+          sample_rate: Number(s.sampleRate) || 24000,
+        },
+        ...(s.style
+          ? { additions: JSON.stringify({ context_texts: [s.style] }) }
+          : {}),
+      },
+    }),
+  });
+  if (!r.ok)
+    throw Object.assign(new Error("语音合成失败"), { status: r.status });
+  // One JSON object per line; audio arrives as base64 chunks in `data`.
+  const chunks = [];
+  for (const line of (await r.text()).split("\n")) {
+    if (!line.trim()) continue;
+    let item;
+    try {
+      item = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (item.data) chunks.push(Buffer.from(item.data, "base64"));
+    if (item.code && item.code !== 0 && item.code !== 20000000)
+      throw new Error("语音合成失败");
+  }
+  if (!chunks.length) throw new Error("语音合成没有返回声音");
+  return Buffer.concat(chunks);
+}
+
+export function mountVoice(app, system) {
+  const wrap = (fn) => async (req, res) => {
+    try {
+      await fn(req, res);
+    } catch (error) {
+      res.status(400).json({ error: error.message });
+    }
+  };
+  app.get("/api/core/voice", (req, res) =>
+    res.json(publicVoice(voiceSettings(system.repo))),
+  );
+  app.put(
+    "/api/core/voice",
+    wrap((req, res) => {
+      const b = req.body || {};
+      const now = voiceSettings(system.repo);
+      const next = { ...now };
+      for (const k of [
+        "protocol",
+        "baseUrl",
+        "resourceId",
+        "model",
+        "speaker",
+        "style",
+        "format",
+      ])
+        if (typeof b[k] === "string")
+          next[k] = b[k].trim().slice(0, k === "style" ? 200 : 300);
+      if (!["volc-openspeech-v3", "openai-audio"].includes(next.protocol))
+        throw Error("语音协议无效");
+      if (next.baseUrl && !/^https:\/\//.test(next.baseUrl))
+        throw Error("语音服务地址需要 https");
+      if (typeof b.apiKey === "string" && b.apiKey.trim())
+        next.apiKey = b.apiKey.trim();
+      if (b.clearKey === true) next.apiKey = "";
+      if (typeof b.asrApiKey === "string" && b.asrApiKey.trim())
+        next.asrApiKey = b.asrApiKey.trim();
+      if (
+        !["volc-plan-sauc", "volc-flash", "openai-audio"].includes(
+          next.asrProtocol,
+        )
+      )
+        throw Error("语音协议无效");
+      if (next.asrBaseUrl && !/^(?:https|wss):\/\//.test(next.asrBaseUrl))
+        throw Error("语音服务地址需要 https");
+      if (typeof b.listen === "boolean") next.listen = b.listen;
+      if (!hearingReady(next)) next.listen = false;
+      if (typeof b.enabled === "boolean") next.enabled = b.enabled;
+      // Without a working service the switch stays off.
+      if (!voiceReady(next)) next.enabled = false;
+      system.repo.saveConfig("voice", next);
+      res.json(publicVoice(next));
+    }),
+  );
+  app.post(
+    "/api/core/voice/test",
+    wrap(async (req, res) => {
+      const text = String(req.body?.text || "你好呀，今天过得怎么样？").slice(
+        0,
+        MAX_CHARS,
+      );
+      const audio = await synthesize(voiceSettings(system.repo), text);
+      res.json({
+        format: voiceSettings(system.repo).format,
+        base64: audio.toString("base64"),
+      });
+    }),
+  );
+}