@yinuo-ngm/server 1.0.21 → 1.0.23

package/lib/routes/index.js

@@ -10,15 +10,16 @@ const deps_route_1 = __importDefault(require("./deps.route"));
 const fs_routes_1 = __importDefault(require("./fs.routes"));
 const project_routes_1 = __importDefault(require("./project.routes"));
 const rss_routes_1 = __importDefault(require("./rss.routes"));
-const sprite_routes_1 = require("./sprite.routes");
+const sprite_routes_1 = require("./sprite/sprite.routes");
 const system_routes_1 = __importDefault(require("./system.routes"));
 const task_routes_1 = __importDefault(require("./task.routes"));
 const api_client_1 = require("./api-client");
 const nginx_routes_1 = require("./nginx.routes");
 const svn_routes_1 = __importDefault(require("./svn.routes"));
-const sprite_browse_routes_1 = __importDefault(require("./sprite-browse.routes"));
+const sprite_browse_routes_1 = __importDefault(require("./sprite/sprite-browse.routes"));
 const static_files_routes_1 = __importDefault(require("./static-files.routes"));
 const hub_routes_1 = __importDefault(require("./hub.routes"));
+const node_runtime_routes_1 = __importDefault(require("./node-runtime.routes"));
 const node_version_routes_1 = __importDefault(require("./node-version.routes"));
 async function routes(fastify) {
     await fastify.register(system_routes_1.default);
@@ -29,8 +30,8 @@ async function routes(fastify) {
     await fastify.register(config_routes_1.default, { prefix: '/api/config' });
     await fastify.register(dashboard_routes_1.default, { prefix: '/api/dashboard' });
     await fastify.register(rss_routes_1.default, { prefix: '/api/rss' });
-    await fastify.register(sprite_routes_1.spriteRoutes, { prefix: '/api/sprite' });
     await fastify.register(svn_routes_1.default, { prefix: '/api/svn' });
+    await fastify.register(sprite_routes_1.spriteRoutes, { prefix: '/api/sprite' });
     await fastify.register(sprite_browse_routes_1.default, { prefix: '/api/sprite/browse' });
     await fastify.register(static_files_routes_1.default, { prefix: '/api/static' });
     await fastify.register(hub_routes_1.default, { prefix: '/api/hub' });
@@ -42,4 +43,5 @@ async function routes(fastify) {
     await fastify.register(api_client_1.apiClientHubTokenRoutes, { prefix: '/api/client/hub-token' });
     await fastify.register(nginx_routes_1.nginxRoutes, { prefix: '/api/nginx' });
     await fastify.register(node_version_routes_1.default, { prefix: '/api/node-version' });
+    await fastify.register(node_runtime_routes_1.default, { prefix: '/api/node-runtimes' });
 }

package/lib/routes/node-runtime.routes.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from "fastify";
+export default function nodeRuntimeRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/node-runtime.routes.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = nodeRuntimeRoutes;
+function toNodeRuntimeConfig(input) {
+    return input;
+}
+function toNodeRuntimeRecordDto(record) {
+    return {
+        id: record.id,
+        name: record.name,
+        version: record.version,
+        platform: String(record.platform),
+        arch: String(record.arch),
+        rootDir: record.rootDir,
+        nodePath: record.nodePath,
+        npmPath: record.npmPath,
+        npxPath: record.npxPath,
+        pnpmPath: record.pnpmPath,
+        yarnPath: record.yarnPath,
+        npmCliPath: record.npmCliPath,
+        npxCliPath: record.npxCliPath,
+        source: record.source,
+    };
+}
+function toResolvedNodeRuntimeDto(runtime) {
+    return {
+        type: runtime.type,
+        name: runtime.name,
+        version: runtime.version,
+        packageManager: runtime.packageManager,
+        rootDir: runtime.rootDir,
+        binDir: runtime.binDir,
+        nodePath: runtime.nodePath,
+        npmPath: runtime.npmPath,
+        npxPath: runtime.npxPath,
+        pnpmPath: runtime.pnpmPath,
+        yarnPath: runtime.yarnPath,
+        npmCliPath: runtime.npmCliPath,
+        npxCliPath: runtime.npxCliPath,
+        env: runtime.env,
+        source: runtime.source,
+    };
+}
+function toNodeRuntimeTestResultDto(result) {
+    return {
+        ok: result.ok,
+        nodeVersion: result.nodeVersion,
+        npmVersion: result.npmVersion,
+        nodePath: result.nodePath,
+        npmLaunchCommand: result.npmLaunchCommand,
+        errors: result.errors,
+    };
+}
+async function nodeRuntimeRoutes(fastify) {
+    fastify.get("/", async () => {
+        const runtimes = await fastify.core.nodeRuntime.listRuntimes();
+        return runtimes.map(toNodeRuntimeRecordDto);
+    });
+    fastify.post("/resolve", async (req) => {
+        const body = req.body;
+        const runtime = await fastify.core.nodeRuntime.resolveRuntime(toNodeRuntimeConfig(body?.runtime));
+        return toResolvedNodeRuntimeDto(runtime);
+    });
+    fastify.post("/test", async (req) => {
+        const body = req.body;
+        const result = await fastify.core.nodeRuntime.testRuntime(toNodeRuntimeConfig(body?.runtime) || { type: "system" });
+        return toNodeRuntimeTestResultDto(result);
+    });
+}

package/lib/routes/project.routes.js

@@ -65,6 +65,8 @@ function toProjectDto(project) {
         updatedAt: project.updatedAt,
         scripts: project.scripts,
         packageManager: project.packageManager,
+        runtime: project.runtime,
+        nodeVersion: project.nodeVersion,
         framework: project.framework,
         env: project.env,
         isFavorite: project.isFavorite,
@@ -126,6 +128,7 @@ async function projectRoutes(fastify) {
                 ...(body.name !== undefined ? { name: body.name } : {}),
                 ...(body.env !== undefined ? { env: body.env } : {}),
                 ...(body.scripts !== undefined ? { scripts: body.scripts } : {}),
+                ...(body.runtime !== undefined ? { runtime: body.runtime } : {}),
             });
             return toProjectDto(updated);
         }
@@ -141,6 +144,30 @@ async function projectRoutes(fastify) {
         const project = await fastify.core.project.get(id);
         return toProjectDto(project);
     });
+    async function updateProjectRuntime(projectId, body) {
+        const updated = await fastify.core.project.update(projectId, {
+            runtime: body.runtime,
+        });
+        return toProjectDto(updated);
+    }
+    fastify.patch("/:id/runtime", async (req) => {
+        const { id } = req.params;
+        const body = req.body;
+        return updateProjectRuntime(id, body);
+    });
+    fastify.post("/:id/runtime", async (req) => {
+        const { id } = req.params;
+        const body = req.body;
+        return updateProjectRuntime(id, body);
+    });
+    fastify.post("/:id/runtime/test", async (req) => {
+        const { id } = req.params;
+        const project = await fastify.core.project.get(id);
+        const runtimeConfig = project.runtime ?? (project.nodeVersion
+            ? { type: "managed", version: project.nodeVersion, packageManager: project.packageManager === "pnpm" || project.packageManager === "yarn" ? project.packageManager : "npm" }
+            : { type: "system", packageManager: project.packageManager === "pnpm" || project.packageManager === "yarn" ? project.packageManager : "npm" });
+        return await fastify.core.nodeRuntime.testRuntime(runtimeConfig);
+    });
     fastify.delete("/delete/:id", async (req) => {
         const { id } = req.params;
         await fastify.core.project.remove(id);

package/lib/routes/sprite/sprite-browse.routes.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from "fastify";
+export default function spriteBrowseRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/sprite/sprite-browse.routes.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = spriteBrowseRoutes;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("@yinuo-ngm/errors");
+const sprite_quick_utils_1 = require("./sprite-quick.utils");
+const SKIP = new Set([
+    ".svn",
+    ".git",
+    ".hg",
+    ".DS_Store",
+    "__MACOSX",
+    "Thumbs.db",
+]);
+function safeJoin(root, sub) {
+    const resolved = node_path_1.default.resolve(root, sub);
+    const rootResolved = node_path_1.default.resolve(root);
+    if (!resolved.startsWith(rootResolved)) {
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "INVALID_PATH");
+    }
+    return resolved;
+}
+function listDir(root) {
+    if (!node_fs_1.default.existsSync(root))
+        return [];
+    return node_fs_1.default
+        .readdirSync(root, { withFileTypes: true })
+        .filter(d => !SKIP.has(d.name) && !d.name.startsWith("."))
+        .map(d => ({
+        name: d.name,
+        kind: (d.isDirectory() ? "dir" : "file"),
+        ext: d.isDirectory() ? undefined : node_path_1.default.extname(d.name).toLowerCase(),
+    })).sort((a, b) => {
+        if (a.kind === b.kind) {
+            return a.name.localeCompare(b.name, "zh-Hans-CN", { numeric: true });
+        }
+        return a.kind === "dir" ? -1 : 1;
+    });
+}
+function countFiles(dir) {
+    if (!node_fs_1.default.existsSync(dir) || !node_fs_1.default.statSync(dir).isDirectory())
+        return 0;
+    return node_fs_1.default.readdirSync(dir, { withFileTypes: true }).filter(d => d.isFile()).length;
+}
+function toBrowseEntriesDto(root, entries) {
+    return { root, entries };
+}
+function toBrowseFilesDto(root, dir, entries) {
+    return { root, dir, entries };
+}
+async function spriteBrowseRoutes(fastify) {
+    fastify.get("/icons/groups/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const project = await fastify.core.project.get(projectId);
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        const localRoot = String(cfg?.localImageRoot ?? "").trim();
+        const root = localRoot || project?.assets?.iconsSvn?.localDir;
+        if (!root) {
+            return toBrowseEntriesDto("", []);
+        }
+        const entries = listDir(root).filter(e => e.kind === "dir");
+        if (localRoot) {
+            const rootFiles = listDir(root).filter((e) => e.kind === "file" && (e.ext === ".png" || e.ext === ".svg"));
+            if (rootFiles.length > 0) {
+                entries.unshift({ name: "root", kind: "dir", ext: undefined });
+            }
+        }
+        return toBrowseEntriesDto(root, entries);
+    });
+    fastify.get("/icons/files/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const group = req.query?.group;
+        const project = await fastify.core.project.get(projectId);
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        const localRoot = String(cfg?.localImageRoot ?? "").trim();
+        const root = localRoot || project?.assets?.iconsSvn?.localDir;
+        if (!root) {
+            return toBrowseEntriesDto("", []);
+        }
+        const isRootGroup = !!localRoot && (group === "root");
+        const groupDir = isRootGroup ? root : safeJoin(root, group || "");
+        const entries = listDir(groupDir)
+            .filter(e => e.kind === "file")
+            .map(e => ({
+            ...e,
+            url: localRoot
+                ? `/api/static/local/${projectId}/${isRootGroup ? e.name : `${group}/${e.name}`}`
+                : `/api/static/svn/${projectId}/icons/${group}/${e.name}`,
+        }));
+        return toBrowseEntriesDto(groupDir, entries);
+    });
+    fastify.get("/images/list/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const quickProjectId = await (0, sprite_quick_utils_1.resolveEnabledRemoteProjectId)(fastify, projectId);
+        if (quickProjectId) {
+            const cfg = await fastify.core.sprite.getConfig(projectId);
+            const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(cfg);
+            const dir = String(req.query?.dir ?? "").trim();
+            const cache = await (0, sprite_quick_utils_1.fetchAndCacheRemoteMiscImages)(fastify, baseUrl, quickProjectId);
+            return (0, sprite_quick_utils_1.buildBrowseFromCache)(quickProjectId, cache, dir || undefined);
+        }
+        const project = await fastify.core.project.get(projectId);
+        const root = project?.assets?.cutImageSvn?.localDir;
+        if (!root) {
+            return toBrowseEntriesDto("", []);
+        }
+        const dir = String(req.query?.dir ?? "").trim();
+        if (dir.split(/[\\/]/g).some(seg => seg === "..")) {
+            return toBrowseFilesDto(root, "", []);
+        }
+        const absDir = dir ? safeJoin(root, dir) : root;
+        if (!node_fs_1.default.existsSync(absDir))
+            return toBrowseFilesDto(root, dir, []);
+        const entries = listDir(absDir).map(e => {
+            if (e.kind === "file") {
+                const rel = dir ? `${dir}/${e.name}` : e.name;
+                return {
+                    ...e,
+                    url: `/api/static/svn/${projectId}/images/${rel}`,
+                };
+            }
+            else if (e.kind === "dir") {
+                const rel = dir ? `${dir}/${e.name}` : e.name;
+                return {
+                    ...e,
+                    fileCount: countFiles(safeJoin(root, rel)),
+                };
+            }
+            return e;
+        });
+        return toBrowseFilesDto(root, dir, entries);
+    });
+}

package/lib/routes/sprite/sprite-quick.utils.d.ts

@@ -0,0 +1,19 @@
+import type { FastifyInstance } from "fastify";
+import type { QuickSpriteProjectDto, QuickGenerateResponseDto, QuickImagesResponseDto, SpriteSnapshotDto, SpriteGroupItemDto, BrowseFilesDto } from "@yinuo-ngm/protocol";
+import type { SpriteConfig } from "@yinuo-ngm/sprite";
+export declare function getBaseUrl(cfg?: {
+    quickSpriteBaseUrl?: string;
+} | null): string;
+export declare const QUICK_SPRITE_PROXY_PREFIX = "/api/sprite/proxy";
+export declare function buildQuickPreviewUrl(localProjectId: string, group: string): string;
+export declare function quickFetch<T>(fastify: FastifyInstance, baseUrl: string, path: string, init?: RequestInit): Promise<T>;
+export declare function resolveEnabledRemoteProjectId(fastify: FastifyInstance, projectId: string): Promise<string | null>;
+export declare function fetchRemoteProject(fastify: FastifyInstance, baseUrl: string, quickProjectId: string): Promise<QuickSpriteProjectDto | null>;
+export declare function mapToGroup(result: QuickGenerateResponseDto, localProjectId: string, prefix: string, spriteUrlTemplate: string): SpriteGroupItemDto;
+export declare function mapQuickGroupsToSnapshot(projectId: string, results: QuickGenerateResponseDto[], remoteProj: QuickSpriteProjectDto | null, localCfg: SpriteConfig | null): SpriteSnapshotDto;
+export declare function copyRawResponseHeaders(response: Response, reply: any): void;
+export declare function hasQuickSprite(fastify: FastifyInstance, projectId: string): Promise<boolean>;
+export declare function fetchAndCacheRemoteMiscImages(fastify: FastifyInstance, baseUrl: string, quickProjectId: string, forceRefresh?: boolean): Promise<QuickImagesResponseDto>;
+export declare function buildBrowseFromCache(quickProjectId: string, cache: QuickImagesResponseDto, dir?: string): BrowseFilesDto;
+export declare const MISC_PROXY_PREFIX = "/api/sprite/misc-proxy";
+export declare function buildRemoteMiscUrl(baseUrl: string, quickProjectId: string, filename: string): string;

package/lib/routes/sprite/sprite-quick.utils.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISC_PROXY_PREFIX = exports.QUICK_SPRITE_PROXY_PREFIX = void 0;
+exports.getBaseUrl = getBaseUrl;
+exports.buildQuickPreviewUrl = buildQuickPreviewUrl;
+exports.quickFetch = quickFetch;
+exports.resolveEnabledRemoteProjectId = resolveEnabledRemoteProjectId;
+exports.fetchRemoteProject = fetchRemoteProject;
+exports.mapToGroup = mapToGroup;
+exports.mapQuickGroupsToSnapshot = mapQuickGroupsToSnapshot;
+exports.copyRawResponseHeaders = copyRawResponseHeaders;
+exports.hasQuickSprite = hasQuickSprite;
+exports.fetchAndCacheRemoteMiscImages = fetchAndCacheRemoteMiscImages;
+exports.buildBrowseFromCache = buildBrowseFromCache;
+exports.buildRemoteMiscUrl = buildRemoteMiscUrl;
+const errors_1 = require("@yinuo-ngm/errors");
+const sprite_1 = require("@yinuo-ngm/sprite");
+function getBaseUrl(cfg) {
+    return (cfg?.quickSpriteBaseUrl?.trim() ||
+        "http://192.168.1.31:7010").replace(/\/+$/, "");
+}
+exports.QUICK_SPRITE_PROXY_PREFIX = "/api/sprite/proxy";
+function buildQuickPreviewUrl(localProjectId, group) {
+    return `${exports.QUICK_SPRITE_PROXY_PREFIX}/${encodeURIComponent(localProjectId)}/${encodeURIComponent(group)}.png`;
+}
+async function quickFetch(fastify, baseUrl, path, init) {
+    const url = `${baseUrl}${path}`;
+    fastify.log.info(`[sprite-quick] → ${init?.method || "GET"} ${url}`);
+    let res;
+    try {
+        res = await fetch(url, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                ...init?.headers,
+            },
+        });
+    }
+    catch (err) {
+        fastify.log.error(`[sprite-quick] ✗ 无法连接远端 ${url}: ${err?.message || err}`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端雪碧图服务 (${baseUrl})：${err?.message || err}`);
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        fastify.log.error(`[sprite-quick] ← ${res.status} ${url}: ${text}`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `远端服务返回 ${res.status}: ${text || res.statusText}`);
+    }
+    const data = (await res.json());
+    fastify.log.info(`[sprite-quick] ← ${res.status} ${url}`);
+    return data;
+}
+async function resolveEnabledRemoteProjectId(fastify, projectId) {
+    const cfg = await fastify.core.sprite.getConfig(projectId);
+    if (!cfg?.quickSpriteEnabled || !cfg?.quickSpriteProjectId)
+        return null;
+    return cfg.quickSpriteProjectId;
+}
+async function fetchRemoteProject(fastify, baseUrl, quickProjectId) {
+    try {
+        return await quickFetch(fastify, baseUrl, `/api/projects/${encodeURIComponent(quickProjectId)}`);
+    }
+    catch {
+        return null;
+    }
+}
+function mapToGroup(result, localProjectId, prefix, spriteUrlTemplate) {
+    const classes = (result.classes || []).map((c) => ({
+        name: c.name,
+        className: `${prefix}-${result.group.split("-")[0]}-${c.name}`,
+        x: c.x,
+        y: c.y,
+        width: c.width,
+        height: c.height,
+    }));
+    const derived = deriveSpriteSize(classes);
+    const spriteWidth = derived.width > 0 ? derived.width : result.width || 0;
+    const spriteHeight = derived.height > 0 ? derived.height : result.height || 0;
+    const [tileW, tileH] = parseTileSize(result.group);
+    const resolvedSpriteUrl = spriteUrlTemplate
+        ? spriteUrlTemplate.replace(/{group}/g, result.group).replace(/{size}/g, String(tileW))
+        : result.spriteUrl;
+    const cssOpts = {
+        prefix,
+        spriteUrlResolver: ({ spriteUrl }) => spriteUrl,
+    };
+    const lessText = (0, sprite_1.buildLessForSprite)({ group: result.group, spriteUrl: resolvedSpriteUrl, classes }, cssOpts);
+    return {
+        group: result.group,
+        kind: "png",
+        spriteUrl: resolvedSpriteUrl,
+        previewSpriteUrl: buildQuickPreviewUrl(localProjectId, result.group),
+        lessText,
+        status: "ok",
+        meta: {
+            mode: result.mode,
+            group: result.group,
+            tileWidth: tileW,
+            tileHeight: tileH,
+            spriteWidth,
+            spriteHeight,
+            classes,
+        },
+    };
+}
+function deriveSpriteSize(classes) {
+    if (!classes.length)
+        return { width: 0, height: 0 };
+    let maxW = 0;
+    let maxH = 0;
+    for (const c of classes) {
+        const r = c.x + c.width;
+        const b = c.y + c.height;
+        if (r > maxW)
+            maxW = r;
+        if (b > maxH)
+            maxH = b;
+    }
+    return { width: maxW, height: maxH };
+}
+function parseTileSize(group) {
+    if (!group)
+        return [0, 0];
+    const parts = group.split("-");
+    if (parts.length === 0)
+        return [0, 0];
+    if (parts.length === 1) {
+        const n = parseInt(parts[0], 10);
+        return Number.isFinite(n) ? [n, n] : [0, 0];
+    }
+    const w = parseInt(parts[0], 10);
+    const h = parseInt(parts[1], 10);
+    return [Number.isFinite(w) ? w : 0, Number.isFinite(h) ? h : 0];
+}
+function mapQuickGroupsToSnapshot(projectId, results, remoteProj, localCfg) {
+    const cssPrefix = localCfg?.prefix ?? "sl";
+    const spriteUrlTpl = localCfg?.spriteUrl ?? "";
+    const groups = (results || []).map((r) => mapToGroup(r, projectId, cssPrefix, spriteUrlTpl));
+    return {
+        projectId,
+        sourceId: "",
+        iconsRoot: remoteProj?.iconsPath ?? "",
+        cacheOutDir: remoteProj?.exportSpritesDir ?? "",
+        config: {
+            projectId,
+            enabled: true,
+            sourceId: "",
+            localDir: "",
+            prefix: cssPrefix,
+            algorithm: "binary-tree",
+            persistLess: false,
+            updatedAt: remoteProj?.updatedAt
+                ? new Date(remoteProj.updatedAt).getTime()
+                : Date.now(),
+            template: localCfg?.template ?? '<i class="{base} {class}"></i>',
+            spriteUrl: localCfg?.spriteUrl ?? "",
+            spriteExportDir: localCfg?.spriteExportDir ?? "",
+            lessExportDir: localCfg?.lessExportDir ?? "",
+            localImageRoot: localCfg?.localImageRoot ?? "",
+            localCacheDir: localCfg?.localCacheDir ?? "",
+        },
+        total: groups.length,
+        success: groups.length,
+        failed: 0,
+        groups,
+    };
+}
+function copyRawResponseHeaders(response, reply) {
+    const contentType = response.headers.get("content-type");
+    if (contentType)
+        reply.header("content-type", contentType);
+    const contentLength = response.headers.get("content-length");
+    if (contentLength)
+        reply.header("content-length", contentLength);
+    const cacheControl = response.headers.get("cache-control");
+    if (cacheControl)
+        reply.header("cache-control", cacheControl);
+    const etag = response.headers.get("etag");
+    if (etag)
+        reply.header("etag", etag);
+    const lastModified = response.headers.get("last-modified");
+    if (lastModified)
+        reply.header("last-modified", lastModified);
+}
+async function hasQuickSprite(fastify, projectId) {
+    const cfg = await fastify.core.sprite.getConfig(projectId);
+    return !!cfg?.quickSpriteProjectId;
+}
+const miscCache = new Map();
+const MISC_CACHE_TTL = 5 * 60 * 1000;
+async function fetchAndCacheRemoteMiscImages(fastify, baseUrl, quickProjectId, forceRefresh = false) {
+    const cached = miscCache.get(quickProjectId);
+    if (!forceRefresh && cached && Date.now() - cached.time < MISC_CACHE_TTL) {
+        return cached.data;
+    }
+    const data = await quickFetch(fastify, baseUrl, `/api/misc/list?projectId=${encodeURIComponent(quickProjectId)}`);
+    miscCache.set(quickProjectId, { time: Date.now(), data });
+    return data;
+}
+function buildBrowseFromCache(quickProjectId, cache, dir) {
+    const list = cache.list || [];
+    const quickDir = dir ? `${dir}` : ".";
+    const filtered = list.filter((item) => item.dir === quickDir);
+    const sorted = [...filtered].sort((a, b) => a.name.localeCompare(b.name, "zh-Hans-CN", { numeric: true }));
+    const fileEntries = sorted.map((item) => {
+        const encodedName = encodeURIComponent(item.name);
+        return {
+            name: item.name,
+            kind: "file",
+            ext: item.name.split(".").pop()?.toLowerCase(),
+            url: `/api/sprite/misc-proxy/${encodeURIComponent(quickProjectId)}/${encodeURIComponent(item.dir)}/${encodedName}`,
+        };
+    });
+    const dirSet = new Set();
+    for (const item of list) {
+        if (item.dir)
+            dirSet.add(item.dir);
+    }
+    const subDirSet = new Set();
+    for (const d of dirSet) {
+        if (d === quickDir)
+            continue;
+        if (d.startsWith(quickDir) || quickDir === ".") {
+            const dirName = quickDir === "."
+                ? d.split("/")[0]
+                : d.slice(quickDir.length).split("/")[1];
+            subDirSet.add(dirName);
+        }
+    }
+    const dirEntries = Array.from(subDirSet)
+        .sort((a, b) => a.localeCompare(b, "zh-Hans-CN", { numeric: true }))
+        .map((d) => ({
+        name: d,
+        kind: "dir",
+        ext: undefined,
+        fileCount: list.filter((item) => item.dir === `${quickDir === "." ? "" : quickDir + "/"}${d}`).length,
+    }));
+    const entries = [...dirEntries, ...fileEntries];
+    return {
+        root: `remote:${quickProjectId}`,
+        dir,
+        entries,
+    };
+}
+exports.MISC_PROXY_PREFIX = "/api/sprite/misc-proxy";
+function buildRemoteMiscUrl(baseUrl, quickProjectId, filename) {
+    return `${baseUrl}/misc/${encodeURIComponent(quickProjectId)}/misc/${encodeURIComponent(filename)}`;
+}

package/lib/routes/sprite/sprite.routes.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from "fastify";
+export declare function spriteRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/sprite/sprite.routes.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spriteRoutes = spriteRoutes;
+const node_path_1 = __importDefault(require("node:path"));
+const node_stream_1 = require("node:stream");
+const errors_1 = require("@yinuo-ngm/errors");
+const sprite_quick_utils_1 = require("./sprite-quick.utils");
+function toSpriteConfigDto(cfg) {
+    return {
+        projectId: cfg.projectId,
+        enabled: cfg.enabled,
+        sourceId: cfg.sourceId,
+        localDir: cfg.localDir,
+        prefix: cfg.prefix,
+        template: cfg.template,
+        spriteUrl: cfg.spriteUrl,
+        spriteExportDir: cfg.spriteExportDir,
+        lessExportDir: cfg.lessExportDir,
+        algorithm: cfg.algorithm,
+        persistLess: cfg.persistLess,
+        updatedAt: cfg.updatedAt,
+        localImageRoot: cfg.localImageRoot,
+        localCacheDir: cfg.localCacheDir,
+        quickSpriteProjectId: cfg.quickSpriteProjectId,
+        quickSpriteEnabled: cfg.quickSpriteEnabled,
+        quickSpriteBaseUrl: cfg.quickSpriteBaseUrl,
+    };
+}
+function toSpriteGroupItemDto(item) {
+    return {
+        group: item.group,
+        kind: item.kind,
+        previewSpriteUrl: item.previewSpriteUrl,
+        spriteUrl: item.spriteUrl,
+        meta: item.meta,
+        lessText: item.lessText,
+        exported: item.exported,
+        status: item.status,
+        error: item.error,
+    };
+}
+function toSpriteSnapshotDto(snapshot) {
+    return {
+        projectId: snapshot.projectId,
+        sourceId: snapshot.sourceId,
+        iconsRoot: snapshot.iconsRoot,
+        cacheOutDir: snapshot.cacheOutDir,
+        config: toSpriteConfigDto(snapshot.config),
+        total: snapshot.total,
+        success: snapshot.success,
+        failed: snapshot.failed,
+        groups: (snapshot.groups ?? []).map(toSpriteGroupItemDto),
+    };
+}
+function toGenerateSpriteResultDto(snapshot) {
+    return toSpriteSnapshotDto(snapshot);
+}
+async function spriteRoutes(fastify) {
+    fastify.get("/config/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        if (cfg && !cfg?.quickSpriteBaseUrl) {
+            const base = (0, sprite_quick_utils_1.getBaseUrl)(cfg);
+            cfg.quickSpriteBaseUrl = base;
+        }
+        return cfg ? toSpriteConfigDto(cfg) : null;
+    });
+    fastify.post("/config/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const body = req.body;
+        if (!body || !body.config) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "Missing config in request body");
+        }
+        const nextCfg = body.config;
+        const nextAssets = (body.assets || {});
+        const hasLocalImageRoot = !!String(nextCfg.localImageRoot ?? "").trim();
+        const enableQuickSprite = nextCfg.quickSpriteProjectId && nextCfg.quickSpriteEnabled;
+        if (!enableQuickSprite && !nextAssets.iconsSvn && !hasLocalImageRoot) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "iconsSvn asset or localImageRoot is required");
+        }
+        if (nextCfg.localDir && nextAssets.iconsSvn) {
+            nextAssets.iconsSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.iconsSvn.label || "icons");
+            if (nextAssets.cutImageSvn) {
+                nextAssets.cutImageSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.cutImageSvn.label || "images");
+            }
+        }
+        const shouldUpdateAssets = !!(nextAssets.iconsSvn || nextAssets.cutImageSvn);
+        const project = shouldUpdateAssets
+            ? await fastify.core.project.updateAssets(projectId, nextAssets)
+            : await fastify.core.project.get(projectId);
+        if (project.assets?.iconsSvn) {
+            nextCfg.sourceId = project.assets.iconsSvn.id;
+        }
+        const cfg = await fastify.core.sprite.createConfig(projectId, nextCfg);
+        const assets = project.assets
+            ? {
+                iconsSvn: project.assets.iconsSvn,
+                cutImageSvn: project.assets.cutImageSvn,
+            }
+            : undefined;
+        return {
+            cfg: toSpriteConfigDto(cfg),
+            project: { id: project.id, name: project.name, root: project.root, assets },
+        };
+    });
+    fastify.post("/generate/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const body = req.body || {};
+        const quickProjectId = await (0, sprite_quick_utils_1.resolveEnabledRemoteProjectId)(fastify, projectId);
+        if (quickProjectId) {
+            const localCfg = await fastify.core.sprite.getConfig(projectId);
+            const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(localCfg);
+            const [results, remoteProj] = await Promise.all([
+                (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/project-sprites?projectId=${encodeURIComponent(quickProjectId)}`),
+                (0, sprite_quick_utils_1.fetchRemoteProject)(fastify, baseUrl, quickProjectId),
+            ]);
+            if (!results?.length) {
+                throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端项目「${quickProjectId}」尚未生成任何雪碧图，请先在远端服务中为该项目生成雪碧图后再试`);
+            }
+            return (0, sprite_quick_utils_1.mapQuickGroupsToSnapshot)(projectId, results, remoteProj, localCfg);
+        }
+        const result = await fastify.core.sprite.generate(projectId, {
+            groups: body.groups,
+            forceRefresh: !!body.forceRefresh,
+            concurrency: body.concurrency ?? 1,
+            continueOnError: body.continueOnError ?? true,
+        });
+        return toGenerateSpriteResultDto(result);
+    });
+    fastify.get("/list/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const local = String(req.query?.local ?? "").toLowerCase() === "true";
+        const quickProjectId = await (0, sprite_quick_utils_1.resolveEnabledRemoteProjectId)(fastify, projectId);
+        if (quickProjectId) {
+            const localCfg = await fastify.core.sprite.getConfig(projectId);
+            const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(localCfg);
+            const [results, remoteProj] = await Promise.all([
+                (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/project-sprites?projectId=${encodeURIComponent(quickProjectId)}`),
+                (0, sprite_quick_utils_1.fetchRemoteProject)(fastify, baseUrl, quickProjectId),
+            ]);
+            return (0, sprite_quick_utils_1.mapQuickGroupsToSnapshot)(projectId, results, remoteProj, localCfg);
+        }
+        const snapshot = await fastify.core.sprite.getSprites(projectId, local);
+        return toSpriteSnapshotDto(snapshot);
+    });
+    fastify.get("/quick/projects", async (_req) => {
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const projects = await (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, "/api/projects");
+        return projects;
+    });
+    fastify.get("/quick/groups/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const groups = await (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/groups?projectId=${encodeURIComponent(projectId)}`);
+        return groups;
+    });
+    fastify.get("/proxy/:projectId/:group.png", async (req, reply) => {
+        const { projectId, group } = req.params;
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        const quickProjectId = cfg?.quickSpriteProjectId;
+        if (!quickProjectId) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `项目「${projectId}」未配置快捷雪碧图远端映射`);
+        }
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(cfg);
+        const remoteUrl = `${baseUrl}/sprites/${encodeURIComponent(quickProjectId)}/${encodeURIComponent(group)}.png`;
+        fastify.log.info(`[sprite-proxy] → GET ${remoteUrl}`);
+        let response;
+        try {
+            response = await fetch(remoteUrl);
+        }
+        catch (err) {
+            fastify.log.error(`[sprite-proxy] ✗ ${remoteUrl}: ${err?.message || err}`);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端雪碧图服务: ${err?.message || err}`);
+        }
+        if (!response.ok) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端雪碧图不存在: ${response.status}`);
+        }
+        (0, sprite_quick_utils_1.copyRawResponseHeaders)(response, reply);
+        const body = response.body;
+        if (!body) {
+            return reply.status(response.status).send();
+        }
+        return reply.status(response.status).send(node_stream_1.Readable.fromWeb(body));
+    });
+    fastify.get("/misc-proxy/:quickProjectId/*", async (req, reply) => {
+        const { quickProjectId } = req.params;
+        const filename = req.params["*"];
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const remoteUrl = (0, sprite_quick_utils_1.buildRemoteMiscUrl)(baseUrl, quickProjectId, filename);
+        fastify.log.info(`[sprite-misc-proxy] → GET ${remoteUrl}`);
+        let response;
+        try {
+            response = await fetch(remoteUrl);
+        }
+        catch (err) {
+            fastify.log.error(`[sprite-misc-proxy] ✗ ${remoteUrl}: ${err?.message || err}`);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端切图服务: ${err?.message || err}`);
+        }
+        if (!response.ok) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端切图不存在: ${response.status}`);
+        }
+        (0, sprite_quick_utils_1.copyRawResponseHeaders)(response, reply);
+        const body = response.body;
+        if (!body) {
+            return reply.status(response.status).send();
+        }
+        return reply.status(response.status).send(node_stream_1.Readable.fromWeb(body));
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yinuo-ngm/server",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "a server package for Yinuo NG Manager",
   "author": "ZhangJing <892295834@qq.com>",
   "license": "ISC",
@@ -28,11 +28,11 @@
   "dependencies": {
     "@fastify/static": "^9.0.0",
     "@fastify/websocket": "^11.2.0",
-    "@yinuo-ngm/api": "^0.1.7",
-    "@yinuo-ngm/core": "^0.1.13",
+    "@yinuo-ngm/api": "^0.1.9",
+    "@yinuo-ngm/core": "^0.1.15",
     "@yinuo-ngm/errors": "^1.0.2",
     "@yinuo-ngm/nginx": "^0.1.4",
-    "@yinuo-ngm/protocol": "^0.1.2",
+    "@yinuo-ngm/protocol": "^0.1.4",
     "fastify": "^5.6.2",
     "fastify-plugin": "^5.1.0",
     "launch-editor": "^2.12.0",
@@ -43,5 +43,5 @@
     "@types/mime-types": "^3.0.1",
     "tsx": "^4.21.0"
   },
-  "gitHead": "3f4445714fe3483f9b92687b700100dcdd621614"
+  "gitHead": "9c45bd57798a539e3b6cf40dd56f7cdffdc02589"
 }