@jingyi0605/codingns4dsh 0.2.1-beta.3 → 0.2.1-beta.5

package/data/build/dist/host/avatar/catalog.d.ts

@@ -0,0 +1,21 @@
+import type { AssistantAvatarCatalogEntry } from '../../shared/assistant-avatar-catalog.js';
+import { AssistantAvatarRemote } from './remote.js';
+import type { AssistantAvatarPackages } from './packages.js';
+type ReadCatalogFile = (path: string) => Promise<string>;
+/** 随包只保存索引和安装清单；选中记录后才请求预览，安装确认后才请求素材。 */
+export declare class AssistantAvatarCatalog {
+    private readonly read;
+    private readonly remote;
+    private records;
+    private readonly previews;
+    constructor(read?: ReadCatalogFile, remote?: AssistantAvatarRemote);
+    list(): Promise<readonly AssistantAvatarCatalogEntry[]>;
+    install(id: string, revision: string, packages: AssistantAvatarPackages, signal?: AbortSignal): Promise<import("../../index.js").AssistantAvatarInstallation>;
+    /** 固定白名单路径，不接受浏览器传入外部 URL；也不返回整张动作图集作为预览。 */
+    preview(request: Request): Promise<Response>;
+    private find;
+    private load;
+    private readRecords;
+}
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/data/build/dist/host/avatar/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/catalog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAa,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAQ5D,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAGxD,0CAA0C;AAC1C,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAqC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF7F,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgE;gBAC5D,IAAI,GAAE,eAAiC,EAAmB,MAAM,wBAA8B;IAErH,IAAI,IAAI,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC;IAEvD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,CAAC,EAAE,WAAW;IAMnG,6CAA6C;IACvC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;YAqBpC,IAAI;IAKlB,OAAO,CAAC,IAAI;YAIE,WAAW;CA6B1B"}

package/data/build/dist/host/avatar/catalog.js

@@ -0,0 +1,123 @@
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { BUILTIN_ASSISTANT_AVATAR_ADAPTERS } from '../../shared/assistant-avatar-adapters.js';
+import { ASSISTANT_AVATAR_CATALOG_PREVIEW_PATH } from '../../shared/assistant-avatar-catalog.js';
+import { AssistantAvatarRemote, remoteUrl } from './remote.js';
+const previewLimit = 1024 * 1024;
+/** 随包只保存索引和安装清单；选中记录后才请求预览，安装确认后才请求素材。 */
+export class AssistantAvatarCatalog {
+    read;
+    remote;
+    records;
+    previews = new Map();
+    constructor(read = readCatalogFile, remote = new AssistantAvatarRemote()) {
+        this.read = read;
+        this.remote = remote;
+    }
+    async list() { return (await this.load()).map(({ entry }) => entry); }
+    async install(id, revision, packages, signal) {
+        signal?.throwIfAborted();
+        const record = await this.find(id, revision);
+        return packages.installManifest(record.manifest, record.manifestUrl, 'codingns-pack', signal);
+    }
+    /** 固定白名单路径，不接受浏览器传入外部 URL；也不返回整张动作图集作为预览。 */
+    async preview(request) {
+        const url = new URL(request.url);
+        if (url.pathname !== ASSISTANT_AVATAR_CATALOG_PREVIEW_PATH)
+            return new Response(null, { status: 404 });
+        if (request.method !== 'GET')
+            return new Response(null, { status: 405, headers: { Allow: 'GET' } });
+        const record = await this.find(url.searchParams.get('id') ?? '', url.searchParams.get('revision') ?? '');
+        if (record.previewUrl === undefined)
+            return new Response(null, { status: 404 });
+        const key = `${record.entry.id}:${record.entry.revision}`;
+        let preview = this.previews.get(key);
+        if (preview === undefined) {
+            const { bytes } = await this.remote.read(record.previewUrl, previewLimit, request.signal);
+            const contentType = previewContentType(bytes);
+            request.signal.throwIfAborted();
+            preview = { bytes, contentType };
+            // 上限八张小图，既避免反复切换下载，也不长期积累整个目录的图片。
+            if (this.previews.size >= 8)
+                this.previews.delete(this.previews.keys().next().value);
+            this.previews.set(key, preview);
+        }
+        return new Response(new Uint8Array(preview.bytes), { headers: { 'Content-Type': preview.contentType,
+                'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff' } });
+    }
+    async find(id, revision) {
+        const record = (await this.load()).find(({ entry }) => entry.id === id && entry.revision === revision);
+        if (record === undefined)
+            throw new TypeError('形象目录记录已变更，请重新选择');
+        return record;
+    }
+    load() {
+        this.records ??= this.readRecords().catch((error) => { this.records = undefined; throw error; });
+        return this.records;
+    }
+    async readRecords() {
+        const value = parseJson(await this.read('avatar-packages/catalog.json'));
+        if (value?.catalogVersion !== 1 || !Array.isArray(value.packages) || value.packages.length > 100)
+            throw new TypeError('形象目录格式无效');
+        const ids = new Set();
+        const native = BUILTIN_ASSISTANT_AVATAR_ADAPTERS.find((adapter) => adapter.id === 'codingns-pack');
+        return Promise.all(value.packages.map(async (item, index) => {
+            if (item === null || typeof item !== 'object' || typeof item.id !== 'string' || !/^[a-z0-9-]{1,80}$/u.test(item.id)
+                || ids.has(item.id) || item.number !== index + 1 || typeof item.revision !== 'string' || !/^[a-f0-9]{40}$/u.test(item.revision))
+                throw new TypeError('形象目录身份无效');
+            ids.add(item.id);
+            const manifest = parseJson(await this.read(`avatar-packages/manifests/${item.id}.avatar.json`));
+            const manifestUrl = publicUrl(item.installManifestUrl);
+            const model = native.parse(manifest, { manifestUrl });
+            const name = label(item.name, 80);
+            const author = label(item.author, 500);
+            if (model.id !== `catalog-${item.id}` || model.name !== name || model.package?.author !== author || !model.package.license || !model.package.homepage)
+                throw new TypeError('形象清单与目录不一致');
+            const repositoryUrl = publicUrl(item.repositoryUrl);
+            const repository = new URL(repositoryUrl);
+            const pinnedSource = `https://raw.githubusercontent.com${repository.pathname}/${item.revision}/`;
+            if (repository.origin !== 'https://github.com' || !model.source.startsWith(pinnedSource))
+                throw new TypeError('形象素材未固定到目录版本');
+            const stats = item.verification;
+            if (!Number.isSafeInteger(stats?.files) || stats.files < 1 || !Number.isSafeInteger(stats?.bytes) || stats.bytes < 1)
+                throw new TypeError('形象目录大小无效');
+            const previewUrl = item.previewUrl === undefined ? undefined : publicUrl(item.previewUrl);
+            return { manifest, manifestUrl, ...(previewUrl === undefined ? {} : { previewUrl }), entry: Object.freeze({
+                    id: item.id, number: index + 1, name, author, description: label(item.description, 1000), remarks: label(item.remarks, 2000),
+                    repositoryUrl, licenseUrl: publicUrl(item.licenseUrl), license: model.package.license, homepage: model.package.homepage,
+                    format: label(item.format, 80), revision: item.revision, bytes: stats.bytes, files: stats.files, previewAvailable: previewUrl !== undefined,
+                }) };
+        }));
+    }
+}
+async function readCatalogFile(path) {
+    const root = dirname(createRequire(import.meta.url).resolve('@jingyi0605/codingns4dsh/package.json'));
+    return readFile(join(root, path), 'utf8');
+}
+function parseJson(text) {
+    if (text.length > 256 * 1024)
+        throw new TypeError('形象目录清单过大');
+    return JSON.parse(text);
+}
+function label(value, max) {
+    if (typeof value !== 'string' || !value.trim() || value.length > max)
+        throw new TypeError('形象目录文字无效');
+    return value;
+}
+function publicUrl(value) {
+    if (typeof value !== 'string')
+        throw new TypeError('形象目录地址无效');
+    return remoteUrl(value).href;
+}
+function previewContentType(bytes) {
+    const signature = Buffer.from(bytes.subarray(0, 12));
+    if (signature.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
+        return 'image/png';
+    if (signature.subarray(0, 4).toString() === 'RIFF' && signature.subarray(8, 12).toString() === 'WEBP')
+        return 'image/webp';
+    if (signature[0] === 255 && signature[1] === 216 && signature[2] === 255)
+        return 'image/jpeg';
+    throw new TypeError('形象预览必须为 PNG、WebP 或 JPEG 图片');
+}
+//# sourceMappingURL=catalog.js.map

package/data/build/dist/host/avatar/catalog.js.map

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

package/data/build/dist/host/avatar/engine.d.ts

@@ -0,0 +1,42 @@
+export type AssistantAvatarEngineProgress = {
+    readonly phase: 'checking';
+} | {
+    readonly phase: 'downloading';
+    readonly bytes: number;
+    readonly total: number | null;
+} | {
+    readonly phase: 'extracting';
+} | {
+    readonly phase: 'ready';
+};
+export type AssistantAvatarEngineDownload = (url: string, file: string, signal: AbortSignal, progress: (bytes: number, total: number | null) => void) => Promise<void>;
+export type AssistantAvatarEngineCommand = (command: string, args: readonly string[], signal: AbortSignal) => Promise<void>;
+export interface AssistantAvatarEngineInstallOptions {
+    readonly signal: AbortSignal;
+    readonly directory?: string;
+    readonly progress?: (progress: AssistantAvatarEngineProgress) => void;
+    readonly download?: AssistantAvatarEngineDownload;
+    readonly run?: AssistantAvatarEngineCommand;
+}
+/**
+ * CodingNS 自有引擎目录，不复用 DSH 插件目录、源码或 Desktop Profile。
+ *
+ * 显式目录用于离线预置与测试；默认与语音模型同根，随 DSH_HOME 隔离。
+ */
+export declare function assistantAvatarEngineDirectory(environment?: NodeJS.ProcessEnv): string;
+/** 只读取已校验的完整安装；缺少标记、版本漂移或入口异常都视为未安装。 */
+export declare function readAssistantAvatarEngine(options?: {
+    readonly directory?: string;
+}): Promise<string | undefined>;
+export declare function assistantAvatarEngineInstalled(options?: {
+    readonly directory?: string;
+}): Promise<boolean>;
+/**
+ * 在专属暂存目录下载、校验并解压，最后原子提升；失败不留伪就绪标记。
+ *
+ * 同进程内串行化，重复点击不会产生两份并发下载；已就绪时直接返回。
+ */
+export declare function installAssistantAvatarEngine(options: AssistantAvatarEngineInstallOptions): Promise<void>;
+/** 参数数组调用，取消与超时后才结算，避免旧安装进程覆盖新结果。 */
+export declare function runEngineProcess(command: string, args: readonly string[], signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=engine.d.ts.map

package/data/build/dist/host/avatar/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/engine.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/B,MAAM,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EACzF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAC3E,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAC3H,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,6BAA6B,KAAK,IAAI,CAAA;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAA;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,4BAA4B,CAAA;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAMnG;AAED,wCAAwC;AACxC,wBAAsB,yBAAyB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ1H;AAED,wBAAsB,8BAA8B,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpH;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,mCAAmC,GAAG,OAAO,CAAC,IAAI,CAAC,CAExG;AAsDD,qCAAqC;AACrC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnH"}

package/data/build/dist/host/avatar/engine.js

@@ -0,0 +1,167 @@
+import { spawn } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, mkdtemp, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { ASSISTANT_AVATAR_ENGINE_ENTRY, ASSISTANT_AVATAR_ENGINE_MAX_ARCHIVE_BYTES, ASSISTANT_AVATAR_ENGINE_MIN_ENTRY_BYTES, ASSISTANT_AVATAR_ENGINE_SHA512, ASSISTANT_AVATAR_ENGINE_TARBALL, ASSISTANT_AVATAR_ENGINE_VERSION, } from '../../shared/assistant-avatar-engine.js';
+import { systemTarCommand } from '../tar-archive.js';
+/**
+ * CodingNS 自有引擎目录，不复用 DSH 插件目录、源码或 Desktop Profile。
+ *
+ * 显式目录用于离线预置与测试；默认与语音模型同根，随 DSH_HOME 隔离。
+ */
+export function assistantAvatarEngineDirectory(environment = process.env) {
+    const configured = environment.CODINGNS4DSH_AVATAR_ENGINE_DIR?.trim();
+    if (configured !== undefined && configured !== '')
+        return configured;
+    const dshHome = environment.DSH_HOME?.trim();
+    return join(dshHome === undefined || dshHome === '' ? join(homedir(), '.dsh') : dshHome, 'codingns4dsh', 'avatar-engine', `l2d-${ASSISTANT_AVATAR_ENGINE_VERSION}`);
+}
+/** 只读取已校验的完整安装；缺少标记、版本漂移或入口异常都视为未安装。 */
+export async function readAssistantAvatarEngine(options = {}) {
+    const directory = options.directory ?? assistantAvatarEngineDirectory();
+    try {
+        const marker = JSON.parse(await readFile(join(directory, 'ready.json'), 'utf8'));
+        if (marker.version !== ASSISTANT_AVATAR_ENGINE_VERSION || marker.sha512 !== ASSISTANT_AVATAR_ENGINE_SHA512)
+            return undefined;
+        const bytes = await readFile(join(directory, ASSISTANT_AVATAR_ENGINE_ENTRY));
+        return bytes.byteLength < ASSISTANT_AVATAR_ENGINE_MIN_ENTRY_BYTES ? undefined : bytes.toString('utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function assistantAvatarEngineInstalled(options = {}) {
+    return await readAssistantAvatarEngine(options) !== undefined;
+}
+/**
+ * 在专属暂存目录下载、校验并解压，最后原子提升；失败不留伪就绪标记。
+ *
+ * 同进程内串行化，重复点击不会产生两份并发下载；已就绪时直接返回。
+ */
+export function installAssistantAvatarEngine(options) {
+    return serialize(() => installOnce(options));
+}
+async function installOnce(options) {
+    const directory = options.directory ?? assistantAvatarEngineDirectory();
+    options.signal.throwIfAborted();
+    options.progress?.({ phase: 'checking' });
+    if (await assistantAvatarEngineInstalled({ directory }))
+        return;
+    const root = dirname(directory);
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    const staging = await mkdtemp(join(root, '.prepare-'));
+    try {
+        const archive = join(staging, 'engine.tgz');
+        options.progress?.({ phase: 'downloading', bytes: 0, total: null });
+        await (options.download ?? downloadEngineArchive)(ASSISTANT_AVATAR_ENGINE_TARBALL, archive, options.signal, (bytes, total) => options.progress?.({ phase: 'downloading', bytes, total }));
+        options.signal.throwIfAborted();
+        options.progress?.({ phase: 'extracting' });
+        await (options.run ?? runEngineProcess)(systemTarCommand(), ['-xzf', archive, '-C', staging], options.signal);
+        const info = await stat(join(staging, ASSISTANT_AVATAR_ENGINE_ENTRY)).catch(() => undefined);
+        if (info === undefined || !info.isFile() || info.size < ASSISTANT_AVATAR_ENGINE_MIN_ENTRY_BYTES)
+            throw new Error('Live2D 引擎解压结果不完整，请重试');
+        options.signal.throwIfAborted();
+        await rm(archive, { force: true });
+        await writeFile(join(staging, 'ready.json'), JSON.stringify({ version: ASSISTANT_AVATAR_ENGINE_VERSION, sha512: ASSISTANT_AVATAR_ENGINE_SHA512 }), { mode: 0o600 });
+        await promoteEngine(staging, directory);
+        options.progress?.({ phase: 'ready' });
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+/** 摘要与大小上限固定，不执行远程脚本；网络失败与内容变化都必须在写入前失败。 */
+async function downloadEngineArchive(url, file, signal, progress) {
+    const response = await fetch(url, { signal: AbortSignal.any([signal, AbortSignal.timeout(180_000)]), redirect: 'follow' });
+    if (!response.ok || response.body === null)
+        throw new Error(`Live2D 引擎下载失败（${response.status}），请检查网络后重试`);
+    const length = Number(response.headers.get('content-length'));
+    const total = length > 0 && response.headers.get('content-encoding') === null ? length : null;
+    const reader = response.body.getReader();
+    const handle = await open(file, 'wx', 0o600);
+    const hash = createHash('sha512');
+    let bytes = 0;
+    try {
+        while (true) {
+            const next = await reader.read();
+            signal.throwIfAborted();
+            if (next.done)
+                break;
+            bytes += next.value.byteLength;
+            if (bytes > ASSISTANT_AVATAR_ENGINE_MAX_ARCHIVE_BYTES)
+                throw new Error('Live2D 引擎超过下载大小限制');
+            hash.update(next.value);
+            await handle.writeFile(next.value);
+            progress(bytes, total);
+        }
+        if (bytes === 0 || (total !== null && bytes !== total))
+            throw new Error('Live2D 引擎下载不完整，请重试');
+        if (hash.digest('base64') !== ASSISTANT_AVATAR_ENGINE_SHA512)
+            throw new Error('Live2D 引擎完整性校验失败，请重试');
+        await handle.sync();
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+        await handle.close();
+    }
+}
+/** 参数数组调用，取消与超时后才结算，避免旧安装进程覆盖新结果。 */
+export async function runEngineProcess(command, args, signal) {
+    signal.throwIfAborted();
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, [...args], { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+        let output = '';
+        let failure;
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        const collect = (chunk) => { output = (output + chunk).slice(-2000); };
+        child.stdout.on('data', collect);
+        child.stderr.on('data', collect);
+        const stop = (error) => { failure = error; child.kill('SIGKILL'); };
+        const cancel = () => stop(new Error('Live2D 引擎安装已取消'));
+        signal.addEventListener('abort', cancel, { once: true });
+        if (signal.aborted)
+            cancel();
+        const timeout = setTimeout(() => stop(new Error('Live2D 引擎解压超时')), 180_000);
+        child.once('error', (error) => { failure = new Error(`无法运行解压命令 ${command}：${error.message}`); });
+        child.once('close', (code) => {
+            clearTimeout(timeout);
+            signal.removeEventListener('abort', cancel);
+            if (failure !== undefined || code !== 0)
+                reject(failure ?? new Error(`Live2D 引擎解压失败（${code}）：${output}`));
+            else
+                resolve();
+        });
+    });
+}
+async function promoteEngine(staging, directory) {
+    const previous = `${directory}.${randomUUID()}.previous`;
+    let moved = false;
+    try {
+        await rename(directory, previous);
+        moved = true;
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    try {
+        await rename(staging, directory);
+    }
+    catch (error) {
+        if (moved)
+            await rename(previous, directory);
+        throw error;
+    }
+    if (moved)
+        await rm(previous, { recursive: true, force: true });
+}
+let engineInstallation = Promise.resolve();
+function serialize(action) {
+    const task = engineInstallation.then(action);
+    engineInstallation = task.catch(() => undefined);
+    return task;
+}
+//# sourceMappingURL=engine.js.map

package/data/build/dist/host/avatar/engine.js.map

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

package/data/build/dist/host/avatar/materials.d.ts

@@ -0,0 +1,28 @@
+import type { AssistantAvatarAsset, AssistantAvatarModel } from '../../shared/assistant-avatar.js';
+import { AssistantAvatarRemote } from './remote.js';
+export interface AssistantAvatarMaterial {
+    readonly key: string;
+    readonly contentType: string;
+    readonly bytes: Uint8Array;
+}
+export interface AssistantAvatarMaterialContext {
+    readonly signal?: AbortSignal;
+    file(source: string, kind: 'image' | 'binary' | 'json' | 'sound' | 'motion'): Promise<string>;
+    model(source: string): Promise<string>;
+}
+/** 渲染格式拥有自己的依赖解释器；安装器不识别角色、文件目录或插件名称。 */
+export interface AssistantAvatarMaterialAdapter {
+    readonly id: string;
+    supports(renderer: string): boolean;
+    install(asset: AssistantAvatarAsset, context: AssistantAvatarMaterialContext): Promise<AssistantAvatarAsset>;
+}
+export declare const BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS: readonly AssistantAvatarMaterialAdapter[];
+/** 依赖完整下载并重写为本地引用；模型、动作、贴图本体不做裁剪。 */
+export declare function installAssistantAvatarMaterials(model: AssistantAvatarModel, remote: AssistantAvatarRemote, signal?: AbortSignal, adapters?: readonly AssistantAvatarMaterialAdapter[]): Promise<{
+    id: string;
+    model: AssistantAvatarModel;
+    materials: readonly AssistantAvatarMaterial[];
+}>;
+/** Cubism 2/3 的所有文件引用统一走安装上下文，其余布局、参数和扩展数据原样保留。 */
+export declare function rewriteAssistantAvatarModel(value: unknown, source: string, context: AssistantAvatarMaterialContext): Promise<unknown>;
+//# sourceMappingURL=materials.d.ts.map

package/data/build/dist/host/avatar/materials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/materials.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAIlG,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,WAAW,uBAAuB;IAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE;AAC3H,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7F,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvC;AACD,yCAAyC;AACzC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,OAAO,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC7G;AAaD,eAAO,MAAM,0CAA0C,EAAE,SAAS,8BAA8B,EAAoB,CAAA;AAIpH,qCAAqC;AACrC,wBAAsB,+BAA+B,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,WAAW,EACpI,QAAQ,GAAE,SAAS,8BAA8B,EAA+C,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;CAAE,CAAC,CA6EvM;AAED,mDAAmD;AACnD,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC3I"}

package/data/build/dist/host/avatar/materials.js

@@ -0,0 +1,183 @@
+import { createHash } from 'node:crypto';
+import { copyAssistantAvatarModel, validateAssistantAvatarModel } from '../../shared/assistant-avatar.js';
+import { assistantAvatarInstalledSource } from '../../shared/assistant-avatar-installation.js';
+import { resolveAssistantAvatarSource } from '../../shared/assistant-avatar-adapters.js';
+import { AssistantAvatarRemote } from './remote.js';
+const image = {
+    id: 'image', supports: (renderer) => renderer === 'image' || renderer === 'spritesheet',
+    async install(asset, context) {
+        const source = await context.file(asset.source, 'image');
+        const entries = await Promise.all(Object.entries(asset.stateSources ?? {}).map(async ([state, url]) => [state, await context.file(url, 'image')]));
+        return { ...asset, source, ...(asset.stateSources === undefined ? {} : { stateSources: Object.fromEntries(entries) }) };
+    },
+};
+const live2d = {
+    id: 'live2d', supports: (renderer) => renderer === 'live2d',
+    async install(asset, context) { return { ...asset, source: await context.model(asset.source) }; },
+};
+export const BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS = [image, live2d];
+const marker = 'PACK_VERSION';
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+/** 依赖完整下载并重写为本地引用；模型、动作、贴图本体不做裁剪。 */
+export async function installAssistantAvatarMaterials(model, remote, signal, adapters = BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS) {
+    validateAssistantAvatarModel(model);
+    const lifetime = new AbortController();
+    const cancellation = signal === undefined ? lifetime.signal : AbortSignal.any([lifetime.signal, signal]);
+    const pending = new Map();
+    const materials = [];
+    let size = 0;
+    let active = 0;
+    const waiters = [];
+    const read = async (source, maxBytes) => {
+        if (active >= 4)
+            await new Promise((resolve) => waiters.push(resolve));
+        else
+            active++;
+        try {
+            cancellation.throwIfAborted();
+            return await remote.read(source, maxBytes, cancellation);
+        }
+        finally {
+            const next = waiters.shift();
+            if (next === undefined)
+                active--;
+            else
+                next();
+        }
+    };
+    const register = (source, contentType, bytes) => {
+        size += bytes.byteLength;
+        if (size > 256 * 1024 * 1024)
+            throw new TypeError('单个形象包超过 256 MiB');
+        const suffix = new URL(source).pathname.match(/(\.model3?\.json|\.[a-z0-9]+)$/iu)?.[1]?.toLowerCase() ?? '.bin';
+        const key = `${digest(source)}${suffix}`;
+        materials.push({ key, contentType, bytes });
+        return assistantAvatarInstalledSource(marker, key);
+    };
+    const once = (source, action) => {
+        const existing = pending.get(source);
+        if (existing !== undefined)
+            return existing;
+        if (pending.size >= 256)
+            throw new TypeError('单个形象包最多包含 256 个资源');
+        const task = action();
+        pending.set(source, task);
+        return task;
+    };
+    const context = {
+        signal: cancellation,
+        file(source, kind) {
+            const contentType = resourceType(source, kind);
+            return once(source, async () => {
+                const result = await read(source, kind === 'json' ? 2 * 1024 * 1024 : 32 * 1024 * 1024);
+                // 对资源 JSON 做语法验证，避免把错误网页作为缓存成功保存。
+                if (kind === 'json')
+                    JSON.parse(new TextDecoder().decode(result.bytes));
+                if (kind === 'image' && !imageSignature(result.bytes))
+                    throw new TypeError('图片资源内容无效');
+                return register(source, contentType, result.bytes);
+            });
+        },
+        model(source) {
+            resourceType(source, 'json');
+            return once(source, async () => {
+                const result = await read(source, 2 * 1024 * 1024);
+                const value = JSON.parse(new TextDecoder().decode(result.bytes));
+                const rewritten = await rewriteAssistantAvatarModel(value, result.url, context);
+                // l2d 通过字符串拼接目录，因此依赖引用须是同目录的相对入口，而非绝对 URL。
+                const bytes = new TextEncoder().encode(JSON.stringify(rewritten));
+                return register(source, 'application/json', bytes);
+            });
+        },
+    };
+    const install = async (asset) => {
+        const adapter = adapters.find((item) => item.supports(asset.renderer));
+        if (adapter === undefined)
+            throw new TypeError(`此渲染器尚无本地素材安装适配器：${asset.renderer}`);
+        return adapter.install(asset, context);
+    };
+    try {
+        // 顺序收集展示位置，共用去重表，不重复下载同一个模型或贴图。
+        const base = await install(model);
+        const surfaces = model.surfaces === undefined ? undefined : Object.fromEntries(await Promise.all(Object.entries(model.surfaces).map(async ([surface, asset]) => [surface, await install(asset)])));
+        await Promise.all(pending.values());
+        cancellation.throwIfAborted();
+        const result = { id: model.id, name: model.name, ...base, package: model.package, ...(surfaces === undefined ? {} : { surfaces }) };
+        const id = digest(JSON.stringify([result, materials.map((file) => [file.key, digest(file.bytes)]).sort(([a], [b]) => a.localeCompare(b))]));
+        const local = JSON.parse(JSON.stringify(result).replaceAll(`pack=${marker}`, `pack=${id}`));
+        const completed = materials.map((file) => file.contentType !== 'application/json' ? file : { ...file,
+            bytes: new TextEncoder().encode(new TextDecoder().decode(file.bytes).replaceAll(`pack=${marker}`, `pack=${id}`)) });
+        return { id, model: copyAssistantAvatarModel({ ...local, package: { ...local.package, adapterId: local.package?.adapterId ?? 'codingns-pack', installationId: id } }), materials: completed };
+    }
+    catch (error) {
+        // 一项失败后取消其余并发下载，再等待它们退出，避免孤立请求跨越安装生命周期。
+        lifetime.abort();
+        await Promise.allSettled(pending.values());
+        throw error;
+    }
+}
+/** Cubism 2/3 的所有文件引用统一走安装上下文，其余布局、参数和扩展数据原样保留。 */
+export async function rewriteAssistantAvatarModel(value, source, context) {
+    if (!record(value))
+        throw new TypeError('Live2D 模型清单无效');
+    const cubism3 = value.FileReferences !== undefined;
+    if (cubism3 && (value.Version !== 3 || !record(value.FileReferences)))
+        throw new TypeError('Live2D 模型版本无效');
+    const refs = { ...(cubism3 ? value.FileReferences : value) };
+    const field = async (input, kind) => {
+        const local = await context.file(resolveAssistantAvatarSource(input, source), kind);
+        return local.slice(local.lastIndexOf('/') + 1);
+    };
+    const mocKey = cubism3 ? 'Moc' : 'model';
+    const textureKey = cubism3 ? 'Textures' : 'textures';
+    const textures = refs[textureKey];
+    if (!Array.isArray(textures) || textures.length === 0 || textures.length > 32)
+        throw new TypeError('Live2D 模型贴图无效');
+    refs[mocKey] = await field(refs[mocKey], 'binary');
+    refs[textureKey] = await Promise.all(textures.map((url) => field(url, 'image')));
+    for (const key of cubism3 ? ['Physics', 'Pose', 'UserData', 'DisplayInfo'] : ['physics', 'pose']) {
+        if (refs[key] !== undefined && refs[key] !== '')
+            refs[key] = await field(refs[key], 'json');
+    }
+    const rewriteEntries = async (entries) => {
+        if (!Array.isArray(entries) || entries.length > 256)
+            throw new TypeError('Live2D 动作或表情列表无效');
+        return Promise.all(entries.map(async (entry) => {
+            if (!record(entry))
+                throw new TypeError('Live2D 动作或表情无效');
+            const key = cubism3 ? 'File' : 'file';
+            const result = { ...entry, [key]: await field(entry[key], cubism3 || new URL(resolveAssistantAvatarSource(entry[key], source)).pathname.endsWith('.json') ? 'json' : 'motion') };
+            const sound = cubism3 ? 'Sound' : 'sound';
+            if (entry[sound] !== undefined && entry[sound] !== '')
+                result[sound] = await field(entry[sound], 'sound');
+            return result;
+        }));
+    };
+    const expressions = cubism3 ? 'Expressions' : 'expressions';
+    if (refs[expressions] !== undefined)
+        refs[expressions] = await rewriteEntries(refs[expressions]);
+    const motionsKey = cubism3 ? 'Motions' : 'motions';
+    if (refs[motionsKey] !== undefined) {
+        if (!record(refs[motionsKey]))
+            throw new TypeError('Live2D 动作映射无效');
+        refs[motionsKey] = Object.fromEntries(await Promise.all(Object.entries(refs[motionsKey]).map(async ([group, entries]) => [group, await rewriteEntries(entries)])));
+    }
+    return cubism3 ? { ...value, FileReferences: refs } : refs;
+}
+function record(value) { return value !== null && typeof value === 'object' && !Array.isArray(value); }
+function resourceType(source, kind) {
+    const ext = new URL(source).pathname.split('.').pop()?.toLowerCase();
+    const types = kind === 'image' ? { png: 'image/png', webp: 'image/webp', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif' }
+        : kind === 'json' ? { json: 'application/json' } : kind === 'binary' ? { moc: 'application/octet-stream', moc3: 'application/octet-stream' }
+            : kind === 'motion' ? { mtn: 'application/octet-stream' } : { wav: 'audio/wav', mp3: 'audio/mpeg', ogg: 'audio/ogg' };
+    const type = ext === undefined ? undefined : types[ext];
+    if (type === undefined)
+        throw new TypeError('形象资源类型不受支持，请提供 JSON、模型、图片或音频文件地址');
+    return type;
+}
+function imageSignature(bytes) {
+    const head = new TextDecoder().decode(bytes.slice(0, 12));
+    return (bytes[0] === 137 && head.slice(1, 4) === 'PNG') || head.startsWith('GIF8')
+        || (head.startsWith('RIFF') && head.slice(8, 12) === 'WEBP') || (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255);
+}
+//# sourceMappingURL=materials.js.map