@yunzai-ng/core 0.1.0

package/dist/platform/detect.js

@@ -0,0 +1,178 @@
+/**
+ * 模块职责：探测运行环境（操作系统族、Termux、容器、内存档位、资源占用）
+ * 依赖方向：仅依赖 node 内置模块与类型包
+ * 生命周期：`detectPlatform()` 结果在进程内不变，缓存一份
+ * 注意事项：Termux 上的 Node 通常把 `process.platform` 报成 `"linux"`，
+ *          单看它会把安卓当普通 Linux，进而按桌面策略去找 Chromium、
+ *          按大内存开并发 —— 这是安卓端最常见的 OOM 原因。
+ *          所以这里做多重取证：环境变量 PREFIX / TERMUX_VERSION、
+ *          `/data/data/com.termux` 目录、`/system/build.prop`。
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { arch, cpus, platform, totalmem } from "node:os";
+/** 低内存判定阈值：2GB */
+const LOW_MEMORY_BYTES = 2 * 1024 * 1024 * 1024;
+/** 探测结果缓存 */
+let cached;
+/**
+ * 是否运行在 Termux（安卓）里
+ * @returns 是否为 Termux 环境
+ */
+function detectTermux() {
+    if (process.env.TERMUX_VERSION)
+        return true;
+    const prefix = process.env.PREFIX ?? "";
+    if (prefix.includes("com.termux"))
+        return true;
+    if (existsSync("/data/data/com.termux/files/usr"))
+        return true;
+    return false;
+}
+/**
+ * 是否运行在安卓上（含非 Termux 的其他安卓运行环境）
+ * @returns 是否为安卓
+ */
+function detectAndroid() {
+    if (platform() === "android")
+        return true;
+    if (detectTermux())
+        return true;
+    // 非 Termux 的安卓容器：靠系统属性文件判断
+    return existsSync("/system/build.prop") && existsSync("/system/bin/app_process");
+}
+/**
+ * 是否运行在容器里
+ *
+ * 容器内可用内存往往远小于 `os.totalmem()` 报告的宿主机内存，
+ * 日志和并发策略需要知道这件事。
+ * @returns 是否为容器环境
+ */
+function detectContainer() {
+    if (existsSync("/.dockerenv"))
+        return true;
+    if (process.env.KUBERNETES_SERVICE_HOST)
+        return true;
+    try {
+        const cgroup = readFileSync("/proc/1/cgroup", "utf8");
+        return /docker|kubepods|containerd|lxc/.test(cgroup);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 判定操作系统族
+ * @returns 操作系统族
+ */
+function detectOs() {
+    if (detectAndroid())
+        return "android";
+    switch (platform()) {
+        case "win32":
+            return "windows";
+        case "darwin":
+            return "macos";
+        case "linux":
+            return "linux";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * 读取 cgroup v2/v1 的内存上限
+ *
+ * 容器里 `os.totalmem()` 给的是宿主机内存，会让"低内存档位"判断失效。
+ * @returns 字节数；读不到时 undefined
+ */
+function readCgroupMemoryLimit() {
+    const candidates = ["/sys/fs/cgroup/memory.max", "/sys/fs/cgroup/memory/memory.limit_in_bytes"];
+    for (const file of candidates) {
+        try {
+            const text = readFileSync(file, "utf8").trim();
+            if (text === "max")
+                continue;
+            const value = Number(text);
+            // cgroup v1 未设限时是一个接近 2^63 的巨大数，直接忽略
+            if (Number.isFinite(value) && value > 0 && value < Number.MAX_SAFE_INTEGER)
+                return value;
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+/**
+ * 探测运行环境
+ * @returns 环境信息（进程内缓存，多次调用返回同一对象）
+ */
+export function detectPlatform() {
+    if (cached)
+        return cached;
+    const isContainer = detectContainer();
+    const hostMemory = totalmem();
+    const limited = readCgroupMemoryLimit();
+    const totalMemory = limited !== undefined ? Math.min(hostMemory, limited) : hostMemory;
+    cached = Object.freeze({
+        os: detectOs(),
+        arch: arch(),
+        isTermux: detectTermux(),
+        isContainer,
+        nodeVersion: process.versions.node,
+        cpus: Math.max(1, cpus().length),
+        totalMemory,
+        lowMemory: totalMemory > 0 && totalMemory < LOW_MEMORY_BYTES
+    });
+    return cached;
+}
+/** 上一次 CPU 采样点 */
+let lastCpuSample;
+/**
+ * 采样进程资源占用
+ *
+ * `cpu` 是**两次调用之间**的平均占用率，因此第一次调用必然返回 0。
+ * WebUI 的资源曲线按固定间隔轮询即可。
+ * @returns 资源占用快照
+ */
+export function sampleUsage() {
+    const mem = process.memoryUsage();
+    const now = process.hrtime.bigint();
+    const usage = process.cpuUsage();
+    let cpu = 0;
+    if (lastCpuSample) {
+        const elapsedUs = Number(now - lastCpuSample.time) / 1000;
+        if (elapsedUs > 0) {
+            const usedUs = usage.user - lastCpuSample.usage.user + (usage.system - lastCpuSample.usage.system);
+            // 除以核心数，让多核机器上的数值仍落在 0~1
+            cpu = Math.min(1, Math.max(0, usedUs / elapsedUs / detectPlatform().cpus));
+        }
+    }
+    lastCpuSample = { time: now, usage };
+    return {
+        rss: mem.rss,
+        heapUsed: mem.heapUsed,
+        heapTotal: mem.heapTotal,
+        external: mem.external + (mem.arrayBuffers ?? 0),
+        uptime: Math.round(process.uptime()),
+        cpu: Number(cpu.toFixed(4))
+    };
+}
+/**
+ * 按内存档位给出建议的并发上限
+ *
+ * 渲染器、图片下载这类"每个任务几十 MB"的操作用它定并发，
+ * 而不是各自拍一个魔数。
+ * @param kind 任务类型：`render` 每任务约 80MB，`io` 约 2MB
+ * @returns 建议并发数，至少 1
+ */
+export function suggestConcurrency(kind) {
+    const info = detectPlatform();
+    if (kind === "io")
+        return info.lowMemory ? 4 : Math.min(16, info.cpus * 2);
+    // 渲染：低内存设备强制串行，避免 Chromium 多标签把内存打满
+    if (info.lowMemory)
+        return 1;
+    const byMemory = Math.floor(info.totalMemory / (1024 * 1024 * 1024));
+    return Math.max(1, Math.min(4, Math.min(byMemory - 1, info.cpus)));
+}
+//# sourceMappingURL=detect.js.map

package/dist/platform/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/platform/detect.ts"],"names":[],"mappings":"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"}

package/dist/platform/paths.d.ts

@@ -0,0 +1,38 @@
+import type { RuntimePaths } from "@yunzai-ng/types";
+/** 解析目录布局的参数 */
+export interface ResolvePathsOptions {
+    /** 显式指定数据根目录；相对路径按 `process.cwd()` 解析 */
+    home?: string;
+    /** 内核包所在目录；缺省由 `import.meta.url` 推导 */
+    runtime?: string;
+}
+/**
+ * 解析目录布局
+ *
+ * 只做路径计算，不创建目录 —— 便于测试与 `yzng doctor` 之类"只想看看
+ * 路径解析成什么"的场景。创建请调用 `ensurePaths`。
+ * @param opts 解析参数
+ * @returns 目录布局（全为绝对路径）
+ */
+export declare function resolvePaths(opts?: ResolvePathsOptions): RuntimePaths;
+/**
+ * 创建目录布局里的所有目录
+ *
+ * `runtime` 不创建（它是安装目录，理应已存在且可能只读）。
+ * @param paths 目录布局
+ * @returns 传入的布局本身，便于链式使用
+ * @throws 目录无法创建时抛出（磁盘只读、权限不足），此时应终止启动
+ */
+export declare function ensurePaths(paths: RuntimePaths): Promise<RuntimePaths>;
+/**
+ * 在临时目录下生成一个带前缀的路径
+ *
+ * 用完请自行删除；`temp` 目录也会在启动时按保留期清理。
+ * @param paths 目录布局
+ * @param prefix 文件名前缀
+ * @param ext 扩展名（含点），如 `".png"`
+ * @param unique 唯一后缀，通常传 `randomId()`
+ * @returns 临时文件绝对路径
+ */
+export declare function tempFile(paths: RuntimePaths, prefix: string, ext: string, unique: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/platform/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/platform/paths.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAapD,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAoDD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAgBzE;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAW5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjG"}

package/dist/platform/paths.js

@@ -0,0 +1,129 @@
+/**
+ * 模块职责：确定并创建运行时目录布局
+ * 依赖方向：依赖 util/fs、platform/detect
+ * 生命周期：启动时解析一次，之后只读
+ * 注意事项：全程不使用 `process.cwd()` —— 以 Windows 服务、开机自启或 pm2 启动时
+ *          工作目录并非项目目录。启动时把八个目录一次性定死成绝对路径，
+ *          其余模块只准通过 `app.paths` 取。
+ *
+ *          优先级：显式参数 > `YZNG_HOME` 环境变量 > 便携模式标记 > 系统默认位置。
+ *          便携模式（安装目录下有 `.portable` 文件）让 ZIP 解压即用、
+ *          换机拷走整个文件夹就能迁移 —— Windows 用户最常见的诉求。
+ */
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { ensureDir } from "../util/fs.js";
+import { detectPlatform } from "./detect.js";
+/** 便携模式标记文件名 */
+const PORTABLE_MARKER = ".portable";
+/** 应用目录名（系统默认位置下使用） */
+const APP_DIR_NAME = "YunzaiNG";
+/** 类 Unix 系统下的隐藏目录名 */
+const APP_DIR_NAME_UNIX = ".yunzai-ng";
+/**
+ * 推导内核自身所在目录
+ *
+ * 编译后本文件位于 `<pkg>/dist/platform/paths.js`，上溯两级即包根。
+ * @returns 内核包根目录的绝对路径
+ */
+function detectRuntimeDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..");
+}
+/**
+ * 寻找便携模式标记
+ *
+ * 依次检查工作目录、内核包上两级（`node_modules/@yunzai-ng/core` → 安装根）。
+ * @param runtimeDir 内核包目录
+ * @returns 命中的便携根目录；未命中时 undefined
+ */
+function findPortableRoot(runtimeDir) {
+    const candidates = [process.cwd(), resolve(runtimeDir, "..", "..", ".."), resolve(runtimeDir, "..", "..")];
+    for (const dir of candidates) {
+        if (existsSync(join(dir, PORTABLE_MARKER)))
+            return dir;
+    }
+    return undefined;
+}
+/**
+ * 系统默认的数据根目录
+ * @returns 绝对路径
+ */
+function defaultHome() {
+    const info = detectPlatform();
+    const home = homedir();
+    if (info.os === "windows") {
+        const base = process.env.LOCALAPPDATA ?? process.env.APPDATA ?? join(home, "AppData", "Local");
+        return join(base, APP_DIR_NAME);
+    }
+    if (info.os === "macos") {
+        return join(home, "Library", "Application Support", APP_DIR_NAME);
+    }
+    if (info.os === "android") {
+        // Termux 的 $HOME 已经在应用私有目录里，再套 XDG 只会加深路径
+        return join(home, APP_DIR_NAME_UNIX);
+    }
+    const xdg = process.env.XDG_DATA_HOME;
+    if (xdg && isAbsolute(xdg))
+        return join(xdg, "yunzai-ng");
+    return join(home, APP_DIR_NAME_UNIX);
+}
+/**
+ * 解析目录布局
+ *
+ * 只做路径计算，不创建目录 —— 便于测试与 `yzng doctor` 之类"只想看看
+ * 路径解析成什么"的场景。创建请调用 `ensurePaths`。
+ * @param opts 解析参数
+ * @returns 目录布局（全为绝对路径）
+ */
+export function resolvePaths(opts = {}) {
+    const runtime = opts.runtime ? resolve(opts.runtime) : detectRuntimeDir();
+    const explicit = opts.home ?? process.env.YZNG_HOME;
+    const home = explicit ? resolve(process.cwd(), explicit) : (findPortableRoot(runtime) ?? defaultHome());
+    return Object.freeze({
+        home,
+        config: join(home, "config"),
+        data: join(home, "data"),
+        logs: join(home, "logs"),
+        temp: join(home, "temp"),
+        plugins: join(home, "plugins"),
+        cache: join(home, "cache"),
+        runtime
+    });
+}
+/**
+ * 创建目录布局里的所有目录
+ *
+ * `runtime` 不创建（它是安装目录，理应已存在且可能只读）。
+ * @param paths 目录布局
+ * @returns 传入的布局本身，便于链式使用
+ * @throws 目录无法创建时抛出（磁盘只读、权限不足），此时应终止启动
+ */
+export async function ensurePaths(paths) {
+    await Promise.all([
+        ensureDir(paths.home),
+        ensureDir(paths.config),
+        ensureDir(paths.data),
+        ensureDir(paths.logs),
+        ensureDir(paths.temp),
+        ensureDir(paths.plugins),
+        ensureDir(paths.cache)
+    ]);
+    return paths;
+}
+/**
+ * 在临时目录下生成一个带前缀的路径
+ *
+ * 用完请自行删除；`temp` 目录也会在启动时按保留期清理。
+ * @param paths 目录布局
+ * @param prefix 文件名前缀
+ * @param ext 扩展名（含点），如 `".png"`
+ * @param unique 唯一后缀，通常传 `randomId()`
+ * @returns 临时文件绝对路径
+ */
+export function tempFile(paths, prefix, ext, unique) {
+    return join(paths.temp, `${prefix}-${unique}${ext}`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/platform/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/platform/paths.ts"],"names":[],"mappings":"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"}

package/dist/platform/system.d.ts

@@ -0,0 +1,71 @@
+/** 一个分区的占用 */
+export interface DiskInfo {
+    /** 挂载点；Windows 上形如 `C:\` */
+    readonly mount: string;
+    /** 总容量（字节） */
+    readonly total: number;
+    /** 可用容量（字节），取非特权用户可用的那个数 */
+    readonly free: number;
+    /** 已用容量（字节），即 `total - free` */
+    readonly used: number;
+}
+/** 一块显卡 */
+export interface GpuInfo {
+    /** 型号名 */
+    readonly name: string;
+    /** 占用率（0-1）；nvidia-smi 未给出时不出现 */
+    readonly load?: number;
+    /** 显存已用（字节） */
+    readonly memoryUsed?: number;
+    /** 显存总量（字节） */
+    readonly memoryTotal?: number;
+}
+/** `GET /api/system` 的响应 */
+export interface SystemInfo {
+    /** 各分区占用；一个都探不到时为空数组 */
+    readonly disks: readonly DiskInfo[];
+    /**
+     * 各显卡
+     *
+     * **测不到时本字段不出现**，与「有 0 块显卡」相区分，见文件头第 3 条。
+     */
+    readonly gpus?: readonly GpuInfo[];
+}
+/**
+ * 列举现有的盘符
+ *
+ * Node 没有列举盘符的 API，只能逐个字母试。`access` 而非 `statfs`：后者在未插盘的
+ * 读卡器上会等到超时，前者只问「能不能访问」。
+ * @returns 形如 `C:\` 的盘根数组，按字母升序
+ */
+export declare function listDriveRoots(): Promise<string[]>;
+/**
+ * 探测各分区占用
+ * @returns 各分区；一个都探不到时为空数组
+ */
+export declare function probeDisks(): Promise<DiskInfo[]>;
+/**
+ * 解析 nvidia-smi 的 CSV 输出
+ *
+ * 取不到的字段 nvidia-smi 会写 `[N/A]`（如虚拟化环境下的占用率），此时该字段
+ * **不出现**而不是记 0 —— 理由同文件头第 3 条。
+ * @param raw 标准输出
+ * @returns 各显卡；一行都解不出时为空数组
+ */
+export declare function parseNvidiaSmi(raw: string): GpuInfo[];
+/**
+ * 探测显卡
+ * @returns 各显卡；测不到时 undefined（与「有 0 块」相区分）
+ */
+export declare function probeGpus(): Promise<GpuInfo[] | undefined>;
+/**
+ * 采一份系统快照
+ *
+ * 磁盘与显卡并发探测：两者互不相关，串行只是把 nvidia-smi 的耗时加到磁盘上。
+ * @param force 是否绕过缓存，仅测试用
+ * @returns 系统快照
+ */
+export declare function sampleSystem(force?: boolean): Promise<SystemInfo>;
+/** 清掉缓存与「没有 nvidia-smi」的记忆，仅测试用 */
+export declare function resetSystemCache(): void;
+//# sourceMappingURL=system.d.ts.map

package/dist/platform/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/platform/system.ts"],"names":[],"mappings":"AAmDA,cAAc;AACd,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,UAAU;IACV,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe;IACf,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,eAAe;IACf,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CACnC;AAQD;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAYxD;AAqED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAItD;AA2BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CA6BrD;AAED;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAMhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAQrE;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}