@jingyi0605/codingns4dsh 0.2.1-beta.2 → 0.2.1-beta.4

package/data/build/dist/host/voice-diagnostics.js

@@ -0,0 +1,124 @@
+import { appendFile, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { monitorEventLoopDelay } from 'node:perf_hooks';
+import { isStage0Runtime } from './stage0-dev-hmr.js';
+import { sanitizeVoiceDiagnosticFields, subscribeVoiceDiagnostics, traceVoice } from '../shared/voice-diagnostics.js';
+/** 有界批量写入：磁盘变慢时丢诊断并记录数量，不让通话等待磁盘。 */
+export class VoiceDiagnosticWriter {
+    directory;
+    options;
+    pending = [];
+    pendingBytes = 0;
+    dropped = 0;
+    timer;
+    writing;
+    closed = false;
+    failed = false;
+    fileIndex = 0;
+    fileBytes = 0;
+    prefix;
+    constructor(directory, options = {}) {
+        this.directory = directory;
+        this.options = options;
+        this.prefix = `voice-performance-${new Date().toISOString().replace(/[:.]/gu, '-')}-${process.pid}-${randomUUID().slice(0, 8)}`;
+    }
+    get filePath() { return join(this.directory, `${this.prefix}.${this.fileIndex}.jsonl`); }
+    record(record, source = 'host') {
+        if (this.closed || this.failed || !/^[a-z][a-z0-9_.-]{0,99}$/u.test(record.event))
+            return;
+        const line = JSON.stringify({ timestamp: new Date(record.timestamp).toISOString(), receivedAt: new Date().toISOString(), source, event: record.event, fields: sanitizeVoiceDiagnosticFields(record.fields) }) + '\n';
+        const bytes = Buffer.byteLength(line);
+        if (this.pendingBytes + bytes > (this.options.maxPendingBytes ?? 1024 * 1024)) {
+            this.dropped++;
+            return;
+        }
+        this.pending.push(line);
+        this.pendingBytes += bytes;
+        this.schedule();
+    }
+    /** 单一写入任务保序；只由测试或释放资源等待，不从采集、播放路径 await。 */
+    async flush() {
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        if (this.writing !== undefined) {
+            await this.writing;
+            if (this.pending.length > 0)
+                await this.flush();
+            return;
+        }
+        if (this.failed || this.pending.length === 0)
+            return;
+        const lines = this.pending.join('');
+        const dropped = this.dropped;
+        this.pending = [];
+        this.pendingBytes = 0;
+        this.dropped = 0;
+        const task = this.write(lines, dropped).catch((error) => {
+            this.failed = true;
+            this.pending = [];
+            this.pendingBytes = 0;
+            // 文件日志不可用必须可见；只输出一次，避免异常重试刷屏。
+            console.warn('CodingNS voice diagnostic log write failed', error instanceof Error ? error.name : 'UnknownError');
+        });
+        this.writing = task;
+        try {
+            await task;
+        }
+        finally {
+            this.writing = undefined;
+            if (!this.closed && this.pending.length > 0)
+                this.schedule();
+        }
+    }
+    async dispose() { this.closed = true; await this.flush(); }
+    schedule() {
+        if (this.timer !== undefined || this.closed || this.writing !== undefined)
+            return;
+        this.timer = setTimeout(() => { this.timer = undefined; void this.flush(); }, 500);
+        this.timer.unref();
+    }
+    async write(lines, dropped) {
+        await mkdir(this.directory, { recursive: true, mode: 0o700 });
+        const content = lines + (dropped > 0 ? JSON.stringify({ timestamp: new Date().toISOString(), source: 'host', event: 'diagnostics.dropped', fields: { dropped } }) + '\n' : '');
+        const bytes = Buffer.byteLength(content);
+        if (this.fileBytes > 0 && this.fileBytes + bytes > (this.options.maxFileBytes ?? 20 * 1024 * 1024)) {
+            this.fileIndex = (this.fileIndex + 1) % (this.options.maxFiles ?? 5);
+            this.fileBytes = 0;
+            // 只循环本次启动生成的唯一文件名，不清理目录里已有的其他日志。
+            await writeFile(this.filePath, '', { mode: 0o600 });
+        }
+        await appendFile(this.filePath, content, { mode: 0o600 });
+        this.fileBytes += bytes;
+    }
+}
+/** 自动诊断仅在专用 Stage0 开启，日志固定落在该仓库 data/logs 下。 */
+export function installVoiceDiagnostics(active) {
+    if (!isStage0Runtime() || process.env.CODINGNS4DSH_VOICE_DIAGNOSTICS === '0')
+        return undefined;
+    const writer = new VoiceDiagnosticWriter(join(process.env.CODINGNS4DSH_STAGE0_REPO_ROOT, 'data', 'logs'));
+    const unsubscribe = subscribeVoiceDiagnostics((record) => writer.record(record));
+    const delay = monitorEventLoopDelay({ resolution: 20 });
+    delay.enable();
+    let previousCpu = process.cpuUsage();
+    let previousTime = performance.now();
+    const timer = setInterval(() => {
+        const now = performance.now();
+        const cpu = process.cpuUsage();
+        const memory = process.memoryUsage();
+        if (active())
+            traceVoice('host.health', {
+                durationMs: now - previousTime, cpuPercent: (cpu.user - previousCpu.user + cpu.system - previousCpu.system) / ((now - previousTime) * 10),
+                rssMb: memory.rss / 1048576, heapMb: memory.heapUsed / 1048576,
+                eventLoopMeanMs: delay.mean / 1e6, eventLoopMaxMs: delay.max / 1e6, eventLoopP99Ms: delay.percentile(99) / 1e6,
+            });
+        previousCpu = cpu;
+        previousTime = now;
+        delay.reset();
+    }, 2000);
+    timer.unref();
+    traceVoice('diagnostics.started', {});
+    return { writer, dispose: async () => { clearInterval(timer); delay.disable(); unsubscribe(); await writer.dispose(); } };
+}
+//# sourceMappingURL=voice-diagnostics.js.map

package/data/build/dist/host/voice-diagnostics.js.map

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

package/data/build/dist/shared/assistant-attachments.d.ts

@@ -0,0 +1,27 @@
+/** 上传只携带字节，不能由浏览器指定 Host 文件路径或已有附件引用。 */
+export interface AssistantAttachmentUpload {
+    readonly name: string;
+    readonly mediaType: string;
+    readonly data: string;
+}
+export interface AssistantAttachmentReference {
+    readonly attachmentId: string;
+    readonly name?: string;
+    readonly bytes: number;
+    readonly mediaType?: string;
+    readonly width?: number;
+    readonly height?: number;
+}
+export interface AssistantAttachment {
+    readonly type: 'image' | 'file';
+    readonly attachment: AssistantAttachmentReference;
+}
+export declare const ASSISTANT_ATTACHMENT_MAX_FILES = 6;
+export declare const ASSISTANT_ATTACHMENT_MAX_BYTES: number;
+export declare const ASSISTANT_ATTACHMENT_MAX_TOTAL_BYTES: number;
+export declare const ASSISTANT_IMAGE_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
+/** 在解码和写入前限制 JSON 上传的体积，所有真实图片校验仍交给 DSH。 */
+export declare function readAssistantAttachmentUploads(value: unknown): readonly AssistantAttachmentUpload[];
+/** 持久记录只保留宿主生成的引用，不保存上传编码或可执行路径。 */
+export declare function readAssistantAttachments(value: unknown): readonly AssistantAttachment[];
+//# sourceMappingURL=assistant-attachments.d.ts.map

package/data/build/dist/shared/assistant-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-attachments.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-attachments.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,yBAAyB;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACvH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAC/E;AACD,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAA;CAAE;AAC3H,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAC/C,eAAO,MAAM,8BAA8B,QAAmB,CAAA;AAC9D,eAAO,MAAM,oCAAoC,QAAmB,CAAA;AACpE,eAAO,MAAM,2BAA2B,iEAAkE,CAAA;AAE1G,4CAA4C;AAC5C,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE,CAcnG;AAED,oCAAoC;AACpC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,mBAAmB,EAAE,CAavF"}

package/data/build/dist/shared/assistant-attachments.js

@@ -0,0 +1,45 @@
+export const ASSISTANT_ATTACHMENT_MAX_FILES = 6;
+export const ASSISTANT_ATTACHMENT_MAX_BYTES = 10 * 1024 * 1024;
+export const ASSISTANT_ATTACHMENT_MAX_TOTAL_BYTES = 20 * 1024 * 1024;
+export const ASSISTANT_IMAGE_MEDIA_TYPES = ['image/png', 'image/jpeg', 'image/webp', 'image/gif'];
+/** 在解码和写入前限制 JSON 上传的体积，所有真实图片校验仍交给 DSH。 */
+export function readAssistantAttachmentUploads(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > ASSISTANT_ATTACHMENT_MAX_FILES)
+        throw new Error('助理附件数量无效，最多 6 个');
+    let total = 0;
+    return value.map((item) => {
+        if (item === null || typeof item !== 'object' || typeof item.name !== 'string' || !item.name.trim() || item.name.length > 200
+            || /[\\/\x00-\x1f]/u.test(item.name) || typeof item.mediaType !== 'string' || item.mediaType.length > 120
+            || typeof item.data !== 'string' || item.data.length > Math.ceil(ASSISTANT_ATTACHMENT_MAX_BYTES / 3) * 4)
+            throw new Error('助理附件无效或超过 10 MiB');
+        if (item.data.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/u.test(item.data))
+            throw new Error('助理附件编码无效');
+        const bytes = item.data.length / 4 * 3 - (item.data.endsWith('==') ? 2 : item.data.endsWith('=') ? 1 : 0);
+        if (bytes > ASSISTANT_ATTACHMENT_MAX_BYTES || (total += bytes) > ASSISTANT_ATTACHMENT_MAX_TOTAL_BYTES)
+            throw new Error('助理附件总大小超过 20 MiB');
+        if (item.mediaType.startsWith('image/') && !ASSISTANT_IMAGE_MEDIA_TYPES.some((type) => type === item.mediaType))
+            throw new Error('图片仅支持 PNG、JPEG、WebP 和 GIF');
+        return { name: item.name.trim(), mediaType: item.mediaType, data: item.data };
+    });
+}
+/** 持久记录只保留宿主生成的引用，不保存上传编码或可执行路径。 */
+export function readAssistantAttachments(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > ASSISTANT_ATTACHMENT_MAX_FILES)
+        throw new Error('助理附件引用无效');
+    for (const item of value) {
+        const ref = item?.attachment;
+        if (!['image', 'file'].includes(item?.type) || ref === null || typeof ref !== 'object'
+            || typeof ref.attachmentId !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(ref.attachmentId)
+            || !Number.isSafeInteger(ref.bytes) || ref.bytes < 0 || ref.bytes > ASSISTANT_ATTACHMENT_MAX_BYTES
+            || ref.name !== undefined && (typeof ref.name !== 'string' || ref.name.length > 200 || /[\\/\x00-\x1f]/u.test(ref.name))
+            || item.type === 'image' && (!ASSISTANT_IMAGE_MEDIA_TYPES.some((type) => type === ref.mediaType)
+                || !Number.isSafeInteger(ref.width) || ref.width < 1 || !Number.isSafeInteger(ref.height) || ref.height < 1))
+            throw new Error('助理附件引用无效');
+    }
+    return structuredClone(value);
+}
+//# sourceMappingURL=assistant-attachments.js.map

package/data/build/dist/shared/assistant-attachments.js.map

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

package/data/build/dist/shared/assistant-avatar-adapters.d.ts

@@ -0,0 +1,18 @@
+import type { AssistantAvatarManifest, AssistantAvatarModel } from './assistant-avatar.js';
+export interface AssistantAvatarAdapterContext {
+    readonly manifestUrl: string;
+}
+/** 适配器解释 JSON 数据，不负责下载脚本、会话或渲染实例。 */
+export interface AssistantAvatarAdapter {
+    readonly id: string;
+    readonly labelKey?: string;
+    readonly name?: string;
+    matches(manifest: unknown): boolean;
+    parse(manifest: unknown, context: AssistantAvatarAdapterContext): AssistantAvatarModel;
+}
+/** 相对路径以清单实际响应 URL 为基准，重定向后不再使用旧目录。 */
+export declare function resolveAssistantAvatarSource(source: unknown, manifestUrl: string): string;
+export declare const BUILTIN_ASSISTANT_AVATAR_ADAPTERS: readonly AssistantAvatarAdapter[];
+/** 导出原生清单时不重复嵌入导入器元数据，素材地址已统一为可访问地址。 */
+export declare function assistantAvatarManifest(model: AssistantAvatarModel): AssistantAvatarManifest;
+//# sourceMappingURL=assistant-avatar-adapters.d.ts.map

package/data/build/dist/shared/assistant-avatar-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-adapters.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,uBAAuB,EAAE,oBAAoB,EAAoD,MAAM,uBAAuB,CAAA;AAElK,MAAM,WAAW,6BAA6B;IAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC/E,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAA;IACnC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,6BAA6B,GAAG,oBAAoB,CAAA;CACvF;AAED,uCAAuC;AACvC,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzF;AAgGD,eAAO,MAAM,iCAAiC,EAAE,SAAS,sBAAsB,EAAiC,CAAA;AAEhH,wCAAwC;AACxC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,uBAAuB,CAO5F"}

package/data/build/dist/shared/assistant-avatar-adapters.js

@@ -0,0 +1,119 @@
+import { copyAssistantAvatarModel, isAssistantAvatarSource, validateAssistantAvatarModel } from './assistant-avatar.js';
+/** 相对路径以清单实际响应 URL 为基准，重定向后不再使用旧目录。 */
+export function resolveAssistantAvatarSource(source, manifestUrl) {
+    if (typeof source !== 'string' || source.trim().length === 0 || source.trim().startsWith('//') || /[\\\u0000-\u001f]/u.test(source))
+        throw new TypeError('形象包资源地址无效');
+    if (!isAssistantAvatarSource(manifestUrl))
+        throw new TypeError('形象包清单地址无效');
+    const resolved = new URL(source, manifestUrl).href;
+    if (!isAssistantAvatarSource(resolved))
+        throw new TypeError('形象包资源地址无效');
+    return resolved;
+}
+function record(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new TypeError('形象包清单必须是 JSON 对象');
+    return value;
+}
+function looksLike(value, key) {
+    return typeof value === 'object' && value !== null && key in value;
+}
+function asset(value, url) {
+    const input = record(value);
+    return { renderer: input.renderer, source: resolveAssistantAvatarSource(input.source, url),
+        spriteVersion: (input.spriteVersion ?? 2),
+        ...(input.stateSources === undefined ? {} : { stateSources: Object.fromEntries(Object.entries(record(input.stateSources)).map(([state, source]) => [state, resolveAssistantAvatarSource(source, url)])) }),
+        ...(input.motionGroups === undefined ? {} : { motionGroups: record(input.motionGroups) }),
+        ...(input.live2d === undefined ? {} : { live2d: record(input.live2d) }),
+    };
+}
+function build(input, base, context, adapterId, surfaces) {
+    const info = { adapterId, manifestUrl: context.manifestUrl,
+        ...(input.author === undefined ? {} : { author: input.author }),
+        ...(input.license === undefined ? {} : { license: input.license }),
+        ...(input.homepage === undefined ? {} : { homepage: resolveAssistantAvatarSource(input.homepage, context.manifestUrl) }), };
+    const model = { id: input.id, name: (input.name ?? input.displayName), ...base, package: info,
+        ...(surfaces === undefined ? {} : { surfaces }) };
+    validateAssistantAvatarModel(model);
+    return copyAssistantAvatarModel(model);
+}
+const native = {
+    id: 'codingns-pack', labelKey: 'avatar.adapter.native',
+    matches: (value) => looksLike(value, 'avatarManifestVersion'),
+    parse(value, context) {
+        const input = record(value);
+        if (input.avatarManifestVersion !== 1)
+            throw new TypeError('不支持的 CodingNS 形象包版本');
+        const surfaces = input.surfaces === undefined ? undefined : Object.fromEntries(Object.entries(record(input.surfaces)).map(([surface, source]) => [surface, asset(source, context.manifestUrl)]));
+        return build(input, asset(input.asset, context.manifestUrl), context, this.id, surfaces);
+    },
+};
+const codex = {
+    id: 'codex-pet', labelKey: 'avatar.adapter.codex',
+    matches: (value) => looksLike(value, 'spritesheetPath'),
+    parse(value, context) {
+        const input = record(value);
+        return build(input, { renderer: 'spritesheet', source: resolveAssistantAvatarSource(input.spritesheetPath, context.manifestUrl),
+            spriteVersion: input.spriteVersionNumber }, context, this.id);
+    },
+};
+const dsh = {
+    id: 'dsh-live2d-pet', labelKey: 'avatar.adapter.dsh',
+    matches: (value) => looksLike(value, 'petManifestVersion'),
+    parse(value, context) {
+        const input = record(value);
+        if (input.petManifestVersion !== 2 || input.renderer !== 'live2d')
+            throw new TypeError('不支持的 DSH 形象包格式');
+        const live2d = record(input.live2d);
+        const translate = live2d.translate === undefined ? undefined : record(live2d.translate);
+        // DSH 的 failed/asking 与 CodingNS 的 error/waiting 在适配边界转换。
+        const motions = live2d.motions === undefined ? {} : record(live2d.motions);
+        const states = {
+            idle: ['idle'], thinking: ['thinking', 'tool'], speaking: ['speaking'],
+            listening: ['listening', 'waiting'], waiting: ['waiting', 'asking', 'queued'], error: ['error', 'failed'],
+        };
+        const motionGroups = Object.fromEntries(Object.entries(states).flatMap(([state, aliases]) => {
+            const group = aliases.map((key) => motions[key]).find((item) => item !== undefined);
+            return group === undefined ? [] : [[state, group]];
+        }));
+        return build(input, { renderer: 'live2d', source: resolveAssistantAvatarSource(live2d.model, context.manifestUrl), spriteVersion: 2,
+            ...(Object.keys(motionGroups).length === 0 ? {} : { motionGroups }),
+            ...(live2d.scale === undefined && translate === undefined ? {} : { live2d: {
+                    ...(live2d.scale === undefined ? {} : { scale: live2d.scale }),
+                    ...(translate === undefined ? {} : { position: [translate.x, translate.y] }),
+                } }),
+        }, context, this.id);
+    },
+};
+const cubism = {
+    id: 'cubism-model', labelKey: 'avatar.adapter.cubism',
+    matches: (value) => looksLike(value, 'FileReferences') || looksLike(value, 'model'),
+    parse(value, context) {
+        const input = record(value);
+        const refs = input.FileReferences === undefined ? input : record(input.FileReferences);
+        const textures = refs.Textures ?? refs.textures;
+        if ((input.FileReferences !== undefined && input.Version !== 3) || !Array.isArray(textures) || textures.length === 0)
+            throw new TypeError('Live2D 模型清单不完整');
+        resolveAssistantAvatarSource(refs.Moc ?? refs.model, context.manifestUrl);
+        for (const texture of textures)
+            resolveAssistantAvatarSource(texture, context.manifestUrl);
+        // 模型没有角色 ID，使用来源的稳定指纹，重复导入不会生成无限副本。
+        let hash = 2166136261;
+        for (const character of context.manifestUrl)
+            hash = Math.imul(hash ^ character.charCodeAt(0), 16777619);
+        const filename = new URL(context.manifestUrl).pathname.split('/').pop() ?? 'Live2D';
+        return build({ id: `live2d-${(hash >>> 0).toString(36)}`, name: decodeURIComponent(filename).replace(/\.model3?\.json$/iu, '').slice(0, 80) || 'Live2D' }, { renderer: 'live2d', source: context.manifestUrl, spriteVersion: 2 }, context, this.id);
+    },
+};
+export const BUILTIN_ASSISTANT_AVATAR_ADAPTERS = [native, codex, dsh, cubism];
+/** 导出原生清单时不重复嵌入导入器元数据，素材地址已统一为可访问地址。 */
+export function assistantAvatarManifest(model) {
+    validateAssistantAvatarModel(model);
+    if (model.renderer === 'builtin')
+        throw new TypeError('内置形象不需要导出素材包');
+    const { id, name, package: info, surfaces, ...base } = copyAssistantAvatarModel(model);
+    return { avatarManifestVersion: 1, id, name, asset: base, ...(surfaces === undefined ? {} : { surfaces }),
+        ...(info?.author === undefined ? {} : { author: info.author }), ...(info?.license === undefined ? {} : { license: info.license }),
+        ...(info?.homepage === undefined ? {} : { homepage: info.homepage }) };
+}
+//# sourceMappingURL=assistant-avatar-adapters.js.map

package/data/build/dist/shared/assistant-avatar-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-adapters.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAavH,uCAAuC;AACvC,MAAM,UAAU,4BAA4B,CAAC,MAAe,EAAE,WAAmB;IAC/E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;IACrK,IAAI,CAAC,uBAAuB,CAAC,WAAW,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;IAC3E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAA;IAClD,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;IACxE,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,CAAC,CAAA;IAChH,OAAO,KAAgC,CAAA;AACzC,CAAC;AACD,SAAS,SAAS,CAAC,KAAc,EAAE,GAAW;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,CAAA;AACpE,CAAC;AACD,SAAS,KAAK,CAAC,KAAc,EAAE,GAAW;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAkB,EAAE,MAAM,EAAE,4BAA4B,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;QAClG,aAAa,EAAE,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAU;QAClD,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,4BAA4B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1M,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAsD,EAAE,CAAC;QAC9I,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAgD,EAAE,CAAC;KACvH,CAAA;AACH,CAAC;AACD,SAAS,KAAK,CAAC,KAA8B,EAAE,IAA0B,EAAE,OAAsC,EAAE,SAAiB,EAClI,QAA2C;IAC3C,MAAM,IAAI,GAA+B,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW;QACpF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAgB,EAAE,CAAC;QACzE,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAiB,EAAE,CAAC;QAC5E,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,GACzH,CAAA;IACD,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAY,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,CAAW,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI;QAC/G,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IACnD,4BAA4B,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,MAAM,GAA2B;IACrC,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,uBAAuB;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,uBAAuB,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAA;QACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;QAChM,OAAO,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC1F,CAAC;CACF,CAAA;AACD,MAAM,KAAK,GAA2B;IACpC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,sBAAsB;IACjD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,iBAAiB,CAAC;IACvD,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,4BAA4B,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC;YAC7H,aAAa,EAAE,KAAK,CAAC,mBAA4B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1E,CAAC;CACF,CAAA;AACD,MAAM,GAAG,GAA2B;IAClC,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB;IACpD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,oBAAoB,CAAC;IAC1D,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAAA;QACxG,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACvF,0DAA0D;QAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC1E,MAAM,MAAM,GAAoD;YAC9D,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtE,SAAS,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;SAC1G,CAAA;QACD,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE;YAC1F,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;YACnF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;QACpD,CAAC,CAAC,CAAC,CAAA;QACH,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,4BAA4B,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;YACjI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE;oBACzE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;oBACxE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAqB,EAAE,CAAC;iBACjG,EAAE,CAAC;SACL,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACtB,CAAC;CACF,CAAA;AACD,MAAM,MAAM,GAA2B;IACrC,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,uBAAuB;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;IACnF,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAA;QAC/C,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAAA;QAC3J,4BAA4B,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QACzE,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1F,oCAAoC;QACpC,IAAI,IAAI,GAAG,UAAU,CAAA;QACrB,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACvG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAA;QACnF,OAAO,KAAK,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,EACvJ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5F,CAAC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,iCAAiC,GAAsC,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;AAEhH,wCAAwC;AACxC,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,4BAA4B,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,cAAc,CAAC,CAAA;IACrE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAA;IACtF,OAAO,EAAE,qBAAqB,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QACvG,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjI,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAA;AAC1E,CAAC"}

package/data/build/dist/shared/assistant-avatar-catalog.d.ts

@@ -0,0 +1,37 @@
+/** 目录仅提供安装清单链接；浏览目录不注册角色，也不下载第三方素材。 */
+export declare const ASSISTANT_AVATAR_CATALOG_URL = "https://github.com/jingyi0605/Codingns4DSH/blob/main/assets/assistant-avatar-catalog.md";
+/** 使用说明单独版本化；升级说明后必须重新确认，不能继承旧版同意。 */
+export declare const ASSISTANT_AVATAR_CONSENT_VERSION = "2026-10-07.1";
+export declare const ASSISTANT_AVATAR_CATALOG_PREVIEW_PATH = "/api/codingns/assistant-avatar-catalog-preview";
+/** 临时素材只通过随机预览租约读取，不与正式安装目录混用。 */
+export declare const ASSISTANT_AVATAR_TEMPORARY_ASSET_PATH = "/api/codingns/assistant-avatar-temporary-assets";
+export interface AssistantAvatarTemporaryPreview {
+    readonly lease: string;
+    readonly model: import('./assistant-avatar.js').AssistantAvatarModel;
+}
+export interface AssistantAvatarConsent {
+    readonly version: string;
+    readonly acceptedAt: number;
+}
+/** 目录只传元数据；完整素材始终由用户另外确认安装。 */
+export interface AssistantAvatarCatalogEntry {
+    readonly id: string;
+    readonly number: number;
+    readonly name: string;
+    readonly author: string;
+    readonly description: string;
+    readonly remarks: string;
+    readonly repositoryUrl: string;
+    readonly licenseUrl: string;
+    readonly license: string;
+    readonly homepage: string;
+    readonly format: string;
+    readonly revision: string;
+    readonly bytes: number;
+    readonly files: number;
+    readonly previewAvailable: boolean;
+}
+export declare function validAssistantAvatarConsent(value: unknown): value is AssistantAvatarConsent;
+export declare function hasAssistantAvatarConsent(value: unknown): boolean;
+export declare function assistantAvatarCatalogPreviewUrl(entry: Pick<AssistantAvatarCatalogEntry, 'id' | 'revision'>): string;
+//# sourceMappingURL=assistant-avatar-catalog.d.ts.map

package/data/build/dist/shared/assistant-avatar-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-catalog.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-catalog.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,eAAO,MAAM,4BAA4B,4FAA4F,CAAA;AAErI,sCAAsC;AACtC,eAAO,MAAM,gCAAgC,iBAAiB,CAAA;AAC9D,eAAO,MAAM,qCAAqC,mDAAmD,CAAA;AACrG,kCAAkC;AAClC,eAAO,MAAM,qCAAqC,oDAAoD,CAAA;AACtG,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,uBAAuB,EAAE,oBAAoB,CAAA;CACrE;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AACD,+BAA+B;AAC/B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC;AACD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAK3F;AACD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjE;AACD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,CAEpH"}

package/data/build/dist/shared/assistant-avatar-catalog.js

@@ -0,0 +1,21 @@
+/** 目录仅提供安装清单链接；浏览目录不注册角色，也不下载第三方素材。 */
+export const ASSISTANT_AVATAR_CATALOG_URL = 'https://github.com/jingyi0605/Codingns4DSH/blob/main/assets/assistant-avatar-catalog.md';
+/** 使用说明单独版本化；升级说明后必须重新确认，不能继承旧版同意。 */
+export const ASSISTANT_AVATAR_CONSENT_VERSION = '2026-10-07.1';
+export const ASSISTANT_AVATAR_CATALOG_PREVIEW_PATH = '/api/codingns/assistant-avatar-catalog-preview';
+/** 临时素材只通过随机预览租约读取，不与正式安装目录混用。 */
+export const ASSISTANT_AVATAR_TEMPORARY_ASSET_PATH = '/api/codingns/assistant-avatar-temporary-assets';
+export function validAssistantAvatarConsent(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const consent = value;
+    return typeof consent.version === 'string' && consent.version.length > 0 && consent.version.length <= 80
+        && Number.isSafeInteger(consent.acceptedAt) && consent.acceptedAt > 0;
+}
+export function hasAssistantAvatarConsent(value) {
+    return validAssistantAvatarConsent(value) && value.version === ASSISTANT_AVATAR_CONSENT_VERSION;
+}
+export function assistantAvatarCatalogPreviewUrl(entry) {
+    return `${ASSISTANT_AVATAR_CATALOG_PREVIEW_PATH}?${new URLSearchParams({ id: entry.id, revision: entry.revision })}`;
+}
+//# sourceMappingURL=assistant-avatar-catalog.js.map

package/data/build/dist/shared/assistant-avatar-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-catalog.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-catalog.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,CAAC,MAAM,4BAA4B,GAAG,yFAAyF,CAAA;AAErI,sCAAsC;AACtC,MAAM,CAAC,MAAM,gCAAgC,GAAG,cAAc,CAAA;AAC9D,MAAM,CAAC,MAAM,qCAAqC,GAAG,gDAAgD,CAAA;AACrG,kCAAkC;AAClC,MAAM,CAAC,MAAM,qCAAqC,GAAG,iDAAiD,CAAA;AA2BtG,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,OAAO,GAAG,KAAwC,CAAA;IACxD,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE;WACnG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAW,GAAG,CAAC,CAAA;AAC1E,CAAC;AACD,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,2BAA2B,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,gCAAgC,CAAA;AACjG,CAAC;AACD,MAAM,UAAU,gCAAgC,CAAC,KAA2D;IAC1G,OAAO,GAAG,qCAAqC,IAAI,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAA;AACtH,CAAC"}

package/data/build/dist/shared/assistant-avatar-engine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Live2D 引擎的固定版本与许可契约。
+ *
+ * 引擎不随插件打包：Host 在用户确认引擎许可后，从固定 registry 地址下载
+ * 精确版本并校验摘要，安装到 CodingNS 自有目录；源码开发仍可直接解析
+ * 仓库中的开发依赖。升级版本必须同时更新 tarball 地址、摘要与许可说明。
+ */
+export declare const ASSISTANT_AVATAR_ENGINE_VERSION = "2.1.1";
+export declare const ASSISTANT_AVATAR_ENGINE_TARBALL = "https://registry.npmjs.org/l2d/-/l2d-2.1.1.tgz";
+export declare const ASSISTANT_AVATAR_ENGINE_SHA512 = "Q9Rp3uDPiZyS4SJZ/RJ+tuR1YQ75gKhGeS2gZNCO6KvydDB6okPQJk+zsKt8KyJ6Y5g0okVMtj3Sisjxr35ptA==";
+/** npm tarball 顶层固定为 package/，入口是真正的 ESM 文件而非全局 IIFE。 */
+export declare const ASSISTANT_AVATAR_ENGINE_ENTRY = "package/dist/index.js";
+/** 真实入口约 820 KB；明显偏小说明下载或解压不完整。 */
+export declare const ASSISTANT_AVATAR_ENGINE_MIN_ENTRY_BYTES: number;
+export declare const ASSISTANT_AVATAR_ENGINE_MAX_ARCHIVE_BYTES: number;
+/** 引擎许可单独版本化：Cubism SDK 条款与第三方素材许可分别确认。 */
+export declare const ASSISTANT_AVATAR_ENGINE_CONSENT_VERSION = "2026-10-08.1";
+export interface AssistantAvatarEngineConsent {
+    readonly version: string;
+    readonly acceptedAt: number;
+}
+/** managed 为 CodingNS 自有目录安装，dependency 为源码开发或用户手工安装。 */
+export type AssistantAvatarEngineSource = 'managed' | 'dependency' | 'missing';
+export interface AssistantAvatarEngineStatus {
+    readonly installed: boolean;
+    readonly version: string;
+    readonly source: AssistantAvatarEngineSource;
+}
+export declare function validAssistantAvatarEngineConsent(value: unknown): value is AssistantAvatarEngineConsent;
+export declare function hasAssistantAvatarEngineConsent(value: unknown): boolean;
+//# sourceMappingURL=assistant-avatar-engine.d.ts.map

package/data/build/dist/shared/assistant-avatar-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-engine.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,UAAU,CAAA;AACtD,eAAO,MAAM,+BAA+B,mDAAmD,CAAA;AAC/F,eAAO,MAAM,8BAA8B,6FAA6F,CAAA;AACxI,yDAAyD;AACzD,eAAO,MAAM,6BAA6B,0BAA0B,CAAA;AACpE,mCAAmC;AACnC,eAAO,MAAM,uCAAuC,QAAa,CAAA;AACjE,eAAO,MAAM,yCAAyC,QAAkB,CAAA;AACxE,2CAA2C;AAC3C,eAAO,MAAM,uCAAuC,iBAAiB,CAAA;AACrE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AACD,yDAAyD;AACzD,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAC9E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;CAC7C;AACD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,4BAA4B,CAKvG;AACD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvE"}

package/data/build/dist/shared/assistant-avatar-engine.js

@@ -0,0 +1,28 @@
+/**
+ * Live2D 引擎的固定版本与许可契约。
+ *
+ * 引擎不随插件打包：Host 在用户确认引擎许可后，从固定 registry 地址下载
+ * 精确版本并校验摘要，安装到 CodingNS 自有目录；源码开发仍可直接解析
+ * 仓库中的开发依赖。升级版本必须同时更新 tarball 地址、摘要与许可说明。
+ */
+export const ASSISTANT_AVATAR_ENGINE_VERSION = '2.1.1';
+export const ASSISTANT_AVATAR_ENGINE_TARBALL = 'https://registry.npmjs.org/l2d/-/l2d-2.1.1.tgz';
+export const ASSISTANT_AVATAR_ENGINE_SHA512 = 'Q9Rp3uDPiZyS4SJZ/RJ+tuR1YQ75gKhGeS2gZNCO6KvydDB6okPQJk+zsKt8KyJ6Y5g0okVMtj3Sisjxr35ptA==';
+/** npm tarball 顶层固定为 package/，入口是真正的 ESM 文件而非全局 IIFE。 */
+export const ASSISTANT_AVATAR_ENGINE_ENTRY = 'package/dist/index.js';
+/** 真实入口约 820 KB；明显偏小说明下载或解压不完整。 */
+export const ASSISTANT_AVATAR_ENGINE_MIN_ENTRY_BYTES = 512 * 1024;
+export const ASSISTANT_AVATAR_ENGINE_MAX_ARCHIVE_BYTES = 8 * 1024 * 1024;
+/** 引擎许可单独版本化：Cubism SDK 条款与第三方素材许可分别确认。 */
+export const ASSISTANT_AVATAR_ENGINE_CONSENT_VERSION = '2026-10-08.1';
+export function validAssistantAvatarEngineConsent(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const consent = value;
+    return typeof consent.version === 'string' && consent.version.length > 0 && consent.version.length <= 80
+        && Number.isSafeInteger(consent.acceptedAt) && consent.acceptedAt > 0;
+}
+export function hasAssistantAvatarEngineConsent(value) {
+    return validAssistantAvatarEngineConsent(value) && value.version === ASSISTANT_AVATAR_ENGINE_CONSENT_VERSION;
+}
+//# sourceMappingURL=assistant-avatar-engine.js.map

package/data/build/dist/shared/assistant-avatar-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-engine.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAA;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,gDAAgD,CAAA;AAC/F,MAAM,CAAC,MAAM,8BAA8B,GAAG,0FAA0F,CAAA;AACxI,yDAAyD;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAA;AACpE,mCAAmC;AACnC,MAAM,CAAC,MAAM,uCAAuC,GAAG,GAAG,GAAG,IAAI,CAAA;AACjE,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AACxE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uCAAuC,GAAG,cAAc,CAAA;AAYrE,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,OAAO,GAAG,KAA8C,CAAA;IAC9D,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE;WACnG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAW,GAAG,CAAC,CAAA;AAC1E,CAAC;AACD,MAAM,UAAU,+BAA+B,CAAC,KAAc;IAC5D,OAAO,iCAAiC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,uCAAuC,CAAA;AAC9G,CAAC"}

package/data/build/dist/shared/assistant-avatar-installation.d.ts

@@ -0,0 +1,17 @@
+import type { AssistantAvatarModel } from './assistant-avatar.js';
+/** 固定入口通过内容版本和文件键读取已安装素材，不接受远程代理目标。 */
+export declare const ASSISTANT_AVATAR_ASSET_PATH = "/api/codingns/assistant-avatar-assets";
+export declare const ASSISTANT_AVATAR_STATUS_PATH = "/api/codingns/assistant-avatar-cache-status";
+export interface AssistantAvatarCandidate {
+    readonly url: string;
+    readonly name: string;
+}
+export interface AssistantAvatarInstallation {
+    readonly id: string;
+    readonly model: AssistantAvatarModel;
+    readonly created: boolean;
+    readonly files: number;
+    readonly bytes: number;
+}
+export declare function assistantAvatarInstalledSource(id: string, file: string): string;
+//# sourceMappingURL=assistant-avatar-installation.d.ts.map

package/data/build/dist/shared/assistant-avatar-installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-installation.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-installation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjE,uCAAuC;AACvC,eAAO,MAAM,2BAA2B,0CAA0C,CAAA;AAClF,eAAO,MAAM,4BAA4B,gDAAgD,CAAA;AACzF,MAAM,WAAW,wBAAwB;IAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACzF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AACD,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/data/build/dist/shared/assistant-avatar-installation.js

@@ -0,0 +1,7 @@
+/** 固定入口通过内容版本和文件键读取已安装素材，不接受远程代理目标。 */
+export const ASSISTANT_AVATAR_ASSET_PATH = '/api/codingns/assistant-avatar-assets';
+export const ASSISTANT_AVATAR_STATUS_PATH = '/api/codingns/assistant-avatar-cache-status';
+export function assistantAvatarInstalledSource(id, file) {
+    return `${ASSISTANT_AVATAR_ASSET_PATH}?pack=${id}&file=${encodeURIComponent(file)}`;
+}
+//# sourceMappingURL=assistant-avatar-installation.js.map

package/data/build/dist/shared/assistant-avatar-installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-installation.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-installation.ts"],"names":[],"mappings":"AAEA,uCAAuC;AACvC,MAAM,CAAC,MAAM,2BAA2B,GAAG,uCAAuC,CAAA;AAClF,MAAM,CAAC,MAAM,4BAA4B,GAAG,6CAA6C,CAAA;AASzF,MAAM,UAAU,8BAA8B,CAAC,EAAU,EAAE,IAAY;IACrE,OAAO,GAAG,2BAA2B,SAAS,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAA;AACrF,CAAC"}

package/data/build/dist/shared/assistant-avatar-legacy-resources.d.ts

@@ -0,0 +1,6 @@
+import type { AssistantAvatarResourcePack } from './assistant-avatar-resources.js';
+export { assistantAvatarCacheStatusPath } from './assistant-avatar-resources.js';
+/** 地址包含上游提交与精简策略版本；修改资源或策略时必须更新版本，避免浏览器旧缓存。 */
+export declare const WHALE_LIVE2D_RESOURCE_PACK: AssistantAvatarResourcePack;
+export declare const ASSISTANT_AVATAR_RESOURCE_PACKS: readonly AssistantAvatarResourcePack[];
+//# sourceMappingURL=assistant-avatar-legacy-resources.d.ts.map

package/data/build/dist/shared/assistant-avatar-legacy-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-legacy-resources.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-legacy-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAA;AAClF,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA;AAEhF,+CAA+C;AAC/C,eAAO,MAAM,0BAA0B,EAAE,2BAevC,CAAA;AAEF,eAAO,MAAM,+BAA+B,EAAE,SAAS,2BAA2B,EAAgD,CAAA"}

package/data/build/dist/shared/assistant-avatar-legacy-resources.js

@@ -0,0 +1,20 @@
+export { assistantAvatarCacheStatusPath } from './assistant-avatar-resources.js';
+/** 地址包含上游提交与精简策略版本；修改资源或策略时必须更新版本，避免浏览器旧缓存。 */
+export const WHALE_LIVE2D_RESOURCE_PACK = Object.freeze({
+    basePath: '/api/codingns/assistant-avatar-assets/whale-185c02bf-v1/',
+    upstreamRoot: 'https://raw.githubusercontent.com/A8Chann/dsh-pet-live2d/185c02bfbb3b886e1a236b5c2ec035cc085b9ca2/dsh-live2d-pet/pets/ds-whale-girl/',
+    manifest: 'c_0120.model3.json',
+    motionGroups: Object.freeze({ idle: 'Idle', thinking: 'Idle', listening: 'Idle', waiting: 'Idle', error: 'SprayWater' }),
+    files: Object.freeze([
+        { path: 'c_0120.model3.json', contentType: 'application/json', maxBytes: 262144 },
+        { path: 'model/c_0120.moc3', contentType: 'application/octet-stream', maxBytes: 4194304 },
+        { path: 'model/c_0120.physics3.json', contentType: 'application/json', maxBytes: 1048576 },
+        { path: 'model/c_0120.cdi3.json', contentType: 'application/json', maxBytes: 1048576, preload: false },
+        { path: 'textures/texture_00.png', contentType: 'image/png', maxBytes: 4194304 },
+        { path: 'textures/texture_01.png', contentType: 'image/png', maxBytes: 1048576 },
+        { path: 'motions/idle.motion3.json', contentType: 'application/json', maxBytes: 1048576 },
+        { path: 'motions/spray-water.motion3.json', contentType: 'application/json', maxBytes: 1048576 },
+    ].map((file) => Object.freeze(file))),
+});
+export const ASSISTANT_AVATAR_RESOURCE_PACKS = Object.freeze([WHALE_LIVE2D_RESOURCE_PACK]);
+//# sourceMappingURL=assistant-avatar-legacy-resources.js.map

package/data/build/dist/shared/assistant-avatar-legacy-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-legacy-resources.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-legacy-resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA;AAEhF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,0BAA0B,GAAgC,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,EAAE,0DAA0D;IACpE,YAAY,EAAE,sIAAsI;IACpJ,QAAQ,EAAE,oBAAoB;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IACxH,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE;QACjF,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,OAAO,EAAE;QACzF,EAAE,IAAI,EAAE,4BAA4B,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC1F,EAAE,IAAI,EAAE,wBAAwB,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAc,EAAE;QAC/G,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE;QAChF,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE;QAChF,EAAE,IAAI,EAAE,2BAA2B,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE;QACzF,EAAE,IAAI,EAAE,kCAAkC,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE;KACjG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CACtC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAA2C,MAAM,CAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAA"}