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

package/data/build/dist/client/avatar/live2d.js

@@ -0,0 +1,288 @@
+import { createElement, useEffect, useMemo, useRef, useState } from 'react';
+import { ASSISTANT_AVATAR_RUNTIME_PATH } from '../../shared/assistant-avatar.js';
+import { readAssistantAvatarCacheStatus } from './cache-status.js';
+import { captureAssistantAvatarPreview } from './preview-capture.js';
+import { createAssistantAvatarPortraitFromPreview } from './portrait-capture.js';
+import { assistantAvatarRuntimeRevision } from '../../shared/assistant-avatar-engine.js';
+/** 成功共享引擎；失败更换模块 URL，避免浏览器缓存失败的动态导入而无法恢复。 */
+export class AssistantLive2dModuleLoader {
+    importModule;
+    fetchStatus;
+    module;
+    attempt = 0;
+    retryAt = 0;
+    revision = assistantAvatarRuntimeRevision();
+    constructor(importModule = (url) => import(/* @vite-ignore */ url), fetchStatus = (...args) => fetch(...args)) {
+        this.importModule = importModule;
+        this.fetchStatus = fetchStatus;
+    }
+    load(location) {
+        if (this.revision !== assistantAvatarRuntimeRevision() || (this.retryAt > 0 && Date.now() >= this.retryAt)) {
+            this.revision = assistantAvatarRuntimeRevision();
+            this.module = undefined;
+            this.retryAt = 0;
+        }
+        if (this.module !== undefined)
+            return this.module;
+        const url = new URL(ASSISTANT_AVATAR_RUNTIME_PATH, location);
+        url.searchParams.set('v', '2.1.1');
+        const attempt = this.attempt++;
+        if (attempt > 0)
+            url.searchParams.set('retry', String(attempt));
+        const request = withLoadDeadline(this.importModule(url.href), 45000).then((module) => {
+            if (typeof module.init !== 'function')
+                throw new Error('avatar_runtime_invalid');
+            return module;
+        }).catch(async (error) => {
+            if (this.module === request)
+                this.retryAt = Date.now() + 30_000;
+            // 动态 import 的错误不包含 HTTP 状态；只在失败时读取状态，不增加成功加载请求。
+            let status;
+            try {
+                status = (await this.fetchStatus(url, { credentials: 'same-origin', signal: AbortSignal.timeout(5000) })).status;
+            }
+            catch { /* 状态探测失败时保留最初的引擎错误。 */ }
+            if (status === 503)
+                throw new Error('avatar_runtime_unavailable');
+            if (status !== undefined && status !== 200)
+                throw new Error(`avatar_runtime_http_${status}`);
+            throw error;
+        });
+        this.module = request;
+        return request;
+    }
+}
+const runtimeModuleLoader = new AssistantLive2dModuleLoader();
+/** 固定同源独立 ESM，只在用户选择 Live2D 时加载；不进入主 Client bundle。 */
+function loadLive2dModule() {
+    return runtimeModuleLoader.load(window.location.href);
+}
+/** l2d 某些下载失败只记录日志而不拒绝 Promise，必须限制永久等待。 */
+async function withLoadDeadline(task, timeoutMs, observeActivity) {
+    let timer;
+    try {
+        return await Promise.race([task, new Promise((_resolve, reject) => {
+                const refresh = () => {
+                    clearTimeout(timer);
+                    timer = setTimeout(() => reject(new Error('avatar_load_timeout')), timeoutMs);
+                };
+                observeActivity?.(refresh);
+                refresh();
+            })]);
+    }
+    finally {
+        clearTimeout(timer);
+        observeActivity?.(undefined);
+    }
+}
+/** 参考上游 load/setState/resize/destroy；旧加载完成不能复活已销毁实例。 */
+export class AssistantLive2dController {
+    runtime;
+    motionGroups;
+    options;
+    timeoutMs;
+    disposed = false;
+    state = 'idle';
+    loaded = false;
+    loadConfirmed = false;
+    cancelLoad;
+    refreshDeadline;
+    report;
+    constructor(runtime, motionGroups, options, report, timeoutMs = 45000) {
+        this.runtime = runtime;
+        this.motionGroups = motionGroups;
+        this.options = options;
+        this.timeoutMs = timeoutMs;
+        this.report = report;
+        runtime.on?.('loadstart', (total) => {
+            if (this.disposed)
+                return;
+            this.refreshDeadline?.();
+            this.report?.({ phase: 'resources', loaded: 0, total });
+        });
+        runtime.on?.('loadprogress', (loaded, total) => {
+            if (this.disposed)
+                return;
+            this.refreshDeadline?.();
+            this.report?.({ phase: total > 0 && loaded >= total ? 'rendering' : 'resources', loaded, total });
+        });
+        runtime.on?.('loaded', () => { if (!this.disposed)
+            this.loadConfirmed = true; });
+    }
+    async load(source) {
+        if (this.disposed)
+            return false;
+        this.loadConfirmed = false;
+        try {
+            const operation = this.runtime.load({ path: source, scale: this.options?.scale ?? 1, volume: 0, logLevel: 'warn',
+                ...(this.options?.position === undefined ? {} : { position: [...this.options.position] }) })
+                .then(() => {
+                if (this.disposed) {
+                    this.runtime.destroy();
+                    return false;
+                }
+                // 真实引擎可能静默返回；只有 loaded 事件才证明初始化成功。
+                if (this.runtime.on !== undefined && !this.loadConfirmed)
+                    throw new Error('avatar_model_not_loaded');
+                return true;
+            }, (error) => { if (this.disposed) {
+                this.runtime.destroy();
+                return false;
+            } throw error; });
+            const cancelled = new Promise((resolve) => { this.cancelLoad = () => resolve(false); });
+            // 大模型持续有文件进度时继续等待，只对长时间没有进展的加载超时。
+            if (!await withLoadDeadline(Promise.race([operation, cancelled]), this.timeoutMs, (refresh) => { this.refreshDeadline = refresh; }))
+                return false;
+            this.loaded = true;
+            this.setState(this.state);
+            return true;
+        }
+        catch (error) {
+            this.dispose();
+            throw error;
+        }
+        finally {
+            this.cancelLoad = undefined;
+        }
+    }
+    setState(state) {
+        if (this.disposed)
+            return;
+        this.state = state;
+        if (!this.loaded)
+            return;
+        const groups = Object.keys(this.runtime.getMotions());
+        const desired = state === 'speaking' ? /talk|speak/iu : state === 'thinking' ? /think|work/iu
+            : state === 'error' ? /fail|error|sad/iu : state === 'listening' || state === 'waiting' ? /listen|wait/iu : /idle/iu;
+        const configured = this.motionGroups?.[state];
+        const group = configured !== undefined && groups.includes(configured) ? configured
+            : groups.find((name) => desired.test(name)) ?? groups.find((name) => /idle/iu.test(name));
+        if (group !== undefined)
+            this.runtime.playMotion(group, undefined, 2);
+    }
+    resize() { if (!this.disposed && this.loaded)
+        this.runtime.resize(); }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        // 上游只有 on，没有 off；清空回调引用并隔离迟到事件，避免持有旧 React 插槽。
+        this.report = undefined;
+        this.cancelLoad?.();
+        this.runtime.destroy();
+    }
+}
+/** 没有已绘制预览时只生成一次头像；捕获后立即销毁临时 WebGL 实例。 */
+export async function createLive2dAssistantAvatarPortrait(model, signal) {
+    const preview = await createLive2dAssistantAvatarPortraitSource(model, signal);
+    return preview === undefined ? undefined : createAssistantAvatarPortraitFromPreview(preview, signal);
+}
+/** 编辑器复用同一静态帧来源，临时实例的销毁仍由适配器统一完成。 */
+export async function createLive2dAssistantAvatarPortraitSource(model, signal) {
+    if (signal.aborted || typeof document === 'undefined')
+        return undefined;
+    const module = await loadLive2dModule();
+    if (signal.aborted)
+        return undefined;
+    const canvas = document.createElement('canvas');
+    canvas.width = 512;
+    canvas.height = 555;
+    canvas.style.cssText = 'position:fixed;left:-10000px;top:0;width:256px;height:277.5px;pointer-events:none;opacity:0';
+    canvas.setAttribute('aria-hidden', 'true');
+    document.body.appendChild(canvas);
+    let controller;
+    const abort = () => controller?.dispose();
+    try {
+        const runtime = module.init(canvas);
+        if (runtime === null)
+            return undefined;
+        controller = new AssistantLive2dController(runtime, model.motionGroups, model.live2d);
+        signal.addEventListener('abort', abort, { once: true });
+        if (signal.aborted || !await controller.load(model.source) || signal.aborted)
+            return undefined;
+        return await captureAssistantAvatarPreview(runtime.getCanvas?.() ?? canvas, signal);
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+        controller?.dispose();
+        canvas.remove();
+    }
+}
+export function Live2dAssistantAvatar({ model, state, size, onError, onLoadProgress, diagnostics = false, onPreview }) {
+    const configKey = JSON.stringify([model.motionGroups, model.live2d]);
+    // 设置归一化会复制 JSON；等值映射不能因为父组件刷新而重载整个 WebGL 模型。
+    const config = useMemo(() => ({ motionGroups: model.motionGroups, options: model.live2d }), [configKey]);
+    const canvas = useRef(null);
+    const controller = useRef(undefined);
+    const currentState = useRef(state);
+    currentState.current = state;
+    const [visible, setVisible] = useState(() => typeof document === 'undefined' || !document.hidden);
+    useEffect(() => {
+        const refresh = () => setVisible(!document.hidden);
+        document.addEventListener('visibilitychange', refresh);
+        return () => document.removeEventListener('visibilitychange', refresh);
+    }, []);
+    useEffect(() => {
+        const target = canvas.current;
+        if (target === null || !visible)
+            return undefined;
+        let disposed = false;
+        let instance;
+        const previewController = new AbortController();
+        const started = diagnostics ? performance.now() : 0;
+        let progress = { phase: 'engine' };
+        const report = (next) => {
+            if (disposed)
+                return;
+            if (!diagnostics) {
+                onLoadProgress?.(next);
+                return;
+            }
+            const elapsedMs = performance.now() - started;
+            progress = { ...progress, ...next, elapsedMs,
+                ...(next.phase === 'rendering' && progress.resourcesMs === undefined ? { resourcesMs: elapsedMs } : {}) };
+            onLoadProgress?.(progress);
+        };
+        report(progress);
+        const observer = typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(() => instance?.resize());
+        observer?.observe(target);
+        // 正式环境不启动缓存诊断，也不等待它；Stage0 才采集真实前后快照。
+        void Promise.all([loadLive2dModule(), diagnostics ? readAssistantAvatarCacheStatus(model.source, window.location.href) : undefined]).then(async ([module, before]) => {
+            if (disposed)
+                return;
+            report({ phase: 'resources', ...(before === undefined ? {} : { cacheBefore: before }) });
+            const runtime = module.init(target);
+            if (runtime === null)
+                throw new Error('avatar_webgl_unavailable');
+            instance = new AssistantLive2dController(runtime, config.motionGroups, config.options, report);
+            controller.current = instance;
+            instance.setState(currentState.current);
+            if (!await instance.load(model.source) || disposed)
+                return;
+            if (onPreview !== undefined) {
+                // 引擎 loaded 时首帧可能还未绘制；等待有效绘制后才替换本地静态预览。
+                const preview = await captureAssistantAvatarPreview(runtime.getCanvas?.() ?? target, previewController.signal);
+                if (disposed)
+                    return;
+                if (preview !== undefined)
+                    onPreview(preview);
+            }
+            report({ phase: 'ready' });
+            if (!diagnostics)
+                return;
+            // 加载已完成，诊断不推迟角色显示；保留真实完成耗时，排除诊断响应时间。
+            const finished = progress;
+            const after = await readAssistantAvatarCacheStatus(model.source, window.location.href);
+            if (!disposed && after !== undefined) {
+                progress = { ...finished, cacheAfter: after };
+                onLoadProgress?.(progress);
+            }
+        }).catch((error) => { if (!disposed)
+            onError(error instanceof Error ? error.message : String(error)); });
+        return () => { disposed = true; previewController.abort(); observer?.disconnect(); instance?.dispose(); controller.current = undefined; };
+    }, [model.source, config, visible, onError, onLoadProgress, diagnostics, onPreview]);
+    useEffect(() => { controller.current?.setState(state); }, [state]);
+    return createElement('canvas', { ref: canvas, width: Math.round(size * 2), height: Math.round(size * 208 / 192 * 2), 'aria-hidden': true,
+        style: { width: size, height: 'auto', aspectRatio: '192 / 208', maxWidth: '100%', display: 'block' } });
+}
+//# sourceMappingURL=live2d.js.map

package/data/build/dist/client/avatar/live2d.js.map

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

package/data/build/dist/client/avatar/loading.d.ts

@@ -0,0 +1,27 @@
+import type { ReactElement } from 'react';
+import type { AssistantAvatarCacheStatus } from '../../shared/assistant-avatar-resources.js';
+import type { CodingNsTranslator } from '../locale.js';
+/** 统一加载反馈；可选字段只在渲染器有真实证据时提供。 */
+export interface AssistantAvatarLoadProgress {
+    readonly phase: 'engine' | 'resources' | 'rendering' | 'ready';
+    readonly loaded?: number;
+    readonly total?: number;
+    readonly elapsedMs?: number;
+    readonly resourcesMs?: number;
+    readonly cacheBefore?: AssistantAvatarCacheStatus;
+    readonly cacheAfter?: AssistantAvatarCacheStatus;
+}
+/** 百分比只根据已经完成的文件计数生成；未知总数保留循环动画。 */
+export declare function assistantAvatarLoadPercent(progress: AssistantAvatarLoadProgress): number | undefined;
+/** 透明光晕、轨道光点与细进度条，直接复用插槽尺寸和宿主主题。 */
+export declare function AssistantAvatarLoading({ progress, size, t, showCache, diagnostics, preview, animationOnly }: {
+    readonly progress: AssistantAvatarLoadProgress;
+    readonly size: number;
+    readonly t: CodingNsTranslator;
+    readonly showCache?: boolean;
+    readonly diagnostics?: boolean;
+    readonly preview?: boolean;
+    /** 临时预览仅显示加载动画，下载与引擎准备均不显示文字或进度条。 */
+    readonly animationOnly?: boolean;
+}): ReactElement | null;
+//# sourceMappingURL=loading.d.ts.map

package/data/build/dist/client/avatar/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../../../../src/client/avatar/loading.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAA;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAGtD,gCAAgC;AAChC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAA;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,CAAA;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAA;CACjD;AAeD,oCAAoC;AACpC,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAIpG;AAkBD,oCAAoC;AACpC,wBAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,SAAiB,EAAE,WAAmB,EAAE,OAAe,EAAE,aAAqB,EAAE,EAAE;IAC5I,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAA;IACrG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IACxF,qCAAqC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACjC,GAAG,YAAY,GAAG,IAAI,CAiDtB"}

package/data/build/dist/client/avatar/loading.js

@@ -0,0 +1,74 @@
+import { createElement } from 'react';
+import { dshThemeColor } from '../theme.js';
+const loadingStyle = `
+@keyframes codingns-avatar-orbit { to { transform: rotate(360deg); } }
+@keyframes codingns-avatar-breathe { 50% { transform: scale(1.08); opacity: .65; } }
+@keyframes codingns-avatar-shimmer { from { transform: translateX(-130%); } to { transform: translateX(330%); } }
+[data-codingns-avatar-loading] .codingns-avatar-halo { animation: codingns-avatar-breathe 2.6s ease-in-out infinite; }
+[data-codingns-avatar-loading] .codingns-avatar-orbit { animation: codingns-avatar-orbit 3s linear infinite; }
+[data-codingns-avatar-loading] .codingns-avatar-indeterminate { animation: codingns-avatar-shimmer 1.6s ease-in-out infinite; }
+@media (prefers-reduced-motion: reduce) {
+  [data-codingns-avatar-loading] .codingns-avatar-halo,
+  [data-codingns-avatar-loading] .codingns-avatar-orbit,
+  [data-codingns-avatar-loading] .codingns-avatar-indeterminate { animation: none; }
+}`;
+/** 百分比只根据已经完成的文件计数生成；未知总数保留循环动画。 */
+export function assistantAvatarLoadPercent(progress) {
+    if (progress.total === undefined || progress.loaded === undefined || !Number.isFinite(progress.total)
+        || !Number.isFinite(progress.loaded) || progress.total <= 0)
+        return undefined;
+    return Math.round(Math.min(1, Math.max(0, progress.loaded / progress.total)) * 100);
+}
+/** 计数只在同一缓存代际内可相减，Host 重建后不能把相同数字解释成下载为零。 */
+function newHostDownloads(progress) {
+    const before = progress.cacheBefore;
+    const after = progress.cacheAfter;
+    if (before === undefined || after === undefined || after.generation !== before.generation || after.downloads < before.downloads)
+        return undefined;
+    return after.downloads - before.downloads;
+}
+function cacheText(progress, t) {
+    const before = progress.cacheBefore;
+    if (before === undefined)
+        return t('avatar.cacheUnknown');
+    const initial = t('avatar.cacheBefore', { cached: before.cached, total: before.total });
+    const count = newHostDownloads(progress);
+    return count === undefined ? initial : `${initial} · ${t('avatar.cacheDownloads', { count })}`;
+}
+/** 透明光晕、轨道光点与细进度条，直接复用插槽尺寸和宿主主题。 */
+export function AssistantAvatarLoading({ progress, size, t, showCache = false, diagnostics = false, preview = false, animationOnly = false }) {
+    // 即使第三方渲染器仍上报诊断字段，正式环境也不能显示摘要或隐藏的调试 tooltip。
+    showCache = !animationOnly && diagnostics && showCache;
+    if (progress.phase === 'ready' && (!diagnostics || animationOnly))
+        return null;
+    const percent = assistantAvatarLoadPercent(progress);
+    const compact = size < 120;
+    const ready = progress.phase === 'ready';
+    const elapsed = progress.elapsedMs === undefined ? '' : t('avatar.loadElapsed', { seconds: (progress.elapsedMs / 1000).toFixed(2) });
+    const shortElapsed = progress.elapsedMs === undefined ? '' : t('avatar.loadElapsedCompact', { seconds: (progress.elapsedMs / 1000).toFixed(2) });
+    const details = [showCache ? cacheText(progress, t) : '', elapsed,
+        progress.resourcesMs === undefined ? '' : t('avatar.loadResourcesElapsed', { seconds: (progress.resourcesMs / 1000).toFixed(2) })].filter(Boolean).join(' · ');
+    const newDownloads = newHostDownloads(progress);
+    if (ready)
+        return createElement('span', { 'data-codingns-avatar-load-summary': true, title: details,
+            style: { position: 'absolute', bottom: 0, maxWidth: '100%', fontSize: 10, lineHeight: 1.4, color: dshThemeColor.labelSecondary,
+                textAlign: 'center', background: dshThemeColor.cardBackground, borderRadius: 8, padding: '2px 6px' } }, showCache ? createElement('span', { style: { display: 'block' } }, progress.cacheBefore === undefined ? t('avatar.cacheUnknown')
+            : t(compact ? 'avatar.cacheTiny' : 'avatar.cacheShort', { cached: progress.cacheBefore.cached, total: progress.cacheBefore.total })) : null, createElement('span', { style: { display: 'block' } }, [showCache && newDownloads !== undefined
+                ? t(compact ? 'avatar.cacheDownloadsTiny' : 'avatar.cacheDownloadsCompact', { count: newDownloads }) : '',
+            compact && showCache && newDownloads !== undefined ? '' : shortElapsed].filter(Boolean).join(' · ')));
+    const phaseText = progress.phase === 'engine' ? t('avatar.loadEngine') : progress.phase === 'rendering' ? t('avatar.loadRendering') : t('avatar.loading');
+    const orbSize = preview ? 14 : Math.min(80, size * (compact ? .3 : .46));
+    const cache = progress.cacheBefore;
+    const cacheLabel = compact ? cache === undefined ? t('avatar.cacheUnknownCompact') : t('avatar.cacheTiny', { cached: cache.cached, total: cache.total }) : cacheText(progress, t);
+    return createElement('div', { 'data-codingns-avatar-loading': progress.phase, role: 'status', 'aria-label': phaseText,
+        ...(showCache ? { title: cacheText(progress, t) } : {}),
+        style: { position: 'absolute', inset: preview ? 'auto 0 0' : 0, display: 'flex', flexDirection: 'column', justifyContent: 'center', alignItems: 'center', gap: compact || preview ? 4 : 10,
+            ...(preview ? { padding: '5px 4px', borderRadius: 10, background: dshThemeColor.cardBackground } : {}),
+            pointerEvents: 'none', color: dshThemeColor.labelSecondary, textAlign: 'center' } }, createElement('style', null, loadingStyle), createElement('div', { style: { display: 'flex', flexDirection: preview ? 'row' : 'column', alignItems: 'center', gap: compact || preview ? 4 : 10 } }, createElement('div', { 'aria-hidden': true, style: { position: 'relative', flexShrink: 0, width: orbSize, height: orbSize, color: dshThemeColor.accent } }, createElement('div', { className: 'codingns-avatar-halo', style: { position: 'absolute', inset: '-14%', borderRadius: '50%',
+            background: 'radial-gradient(circle, rgba(112, 148, 255, .24), rgba(132, 204, 247, .10) 55%, transparent 72%)' } }), createElement('div', { className: 'codingns-avatar-orbit', style: { position: 'absolute', inset: 0, borderRadius: '50%', border: '1px solid rgba(112, 148, 255, .20)' } }, createElement('span', { style: { position: 'absolute', top: -3, left: '50%', width: 6, height: 6, borderRadius: '50%', background: 'currentColor', boxShadow: '0 0 12px rgba(112, 148, 255, .5)' } })), createElement('svg', { viewBox: '0 0 64 64', style: { position: 'absolute', inset: '20%', width: '60%', height: '60%' }, fill: 'none' }, createElement('path', { d: 'M32 9C35 23 41 29 55 32C41 35 35 41 32 55C29 41 23 35 9 32C23 29 29 23 32 9Z', fill: 'currentColor', opacity: .85 }), createElement('circle', { cx: 51, cy: 12, r: 3, fill: 'currentColor', opacity: .4 }))), animationOnly ? null : createElement('span', { style: { fontSize: compact || preview ? 10 : size < 160 ? 11 : 13, fontWeight: 500 } }, compact || preview ? t('avatar.loadingCompact') : phaseText)), animationOnly ? null : createElement('div', { role: 'progressbar', 'aria-label': t('avatar.loadProgress'), 'aria-valuemin': 0, 'aria-valuemax': 100,
+        ...(percent === undefined ? {} : { 'aria-valuenow': percent }),
+        style: { width: Math.min(130, size * .74), height: 3, flexShrink: 0, borderRadius: 3, overflow: 'hidden', background: 'rgba(112, 148, 255, .15)' } }, createElement('div', { className: percent === undefined ? 'codingns-avatar-indeterminate' : undefined,
+        style: { width: percent === undefined ? '30%' : `${percent}%`, height: '100%', borderRadius: 3,
+            background: 'linear-gradient(90deg, #81c9ed, #7791f7)', transition: 'width .2s ease' } })), animationOnly ? null : createElement('span', { style: { fontSize: 10, lineHeight: 1.5, padding: '0 6px', maxWidth: '100%' } }, percent === undefined ? null : `${progress.loaded}/${progress.total} · ${percent}%`, showCache ? createElement('span', { style: { display: 'block' } }, cacheLabel) : null));
+}
+//# sourceMappingURL=loading.js.map

package/data/build/dist/client/avatar/loading.js.map

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

package/data/build/dist/client/avatar/manager.d.ts

@@ -0,0 +1,71 @@
+import type { AssistantAppearanceSettings, AssistantAvatarModel } from '../../shared/assistant-avatar.js';
+import type { AssistantAvatarAdapter } from '../../shared/assistant-avatar-adapters.js';
+import type { CodingNsSettings } from '../../shared/contracts/config.js';
+import type { CodingNsSettingsStore } from '../../dsh-capabilities/settings-store.js';
+import type { CodingNsClientServices } from '../features/types.js';
+import { AssistantAvatarRegistration } from './registration.js';
+import type { CodingNsRpcClient } from '../features/types.js';
+import type { AssistantAvatarCandidate } from '../../shared/assistant-avatar-installation.js';
+import type { AssistantAvatarCatalogEntry, AssistantAvatarTemporaryPreview } from '../../shared/assistant-avatar-catalog.js';
+import type { AssistantAvatarEngineStatus } from '../../shared/assistant-avatar-engine.js';
+export declare class AssistantAvatarAdapterRegistry extends AssistantAvatarRegistration<AssistantAvatarAdapter> {
+    constructor();
+    parse(manifest: unknown, manifestUrl: string, adapterId?: string): AssistantAvatarModel;
+}
+export type AssistantAppearanceUpdate = Partial<Pick<AssistantAppearanceSettings, 'floatingEnabled' | 'dialogEnabled' | 'floatingSize' | 'dialogSize'>>;
+/** 唯一写入入口：包导入与手工素材最终都变成同一清单，不拥有语音或会话。 */
+export declare class AssistantAvatarManager {
+    private readonly settings;
+    readonly adapters: AssistantAvatarAdapterRegistry;
+    private readonly fetchManifest;
+    private readonly baseUrl;
+    private readonly rpc?;
+    private readonly removePortrait;
+    private writes;
+    private appearance;
+    private catalog;
+    constructor(settings: CodingNsSettingsStore<CodingNsSettings>, adapters?: AssistantAvatarAdapterRegistry, fetchManifest?: typeof fetch, baseUrl?: string | undefined, rpc?: CodingNsRpcClient | undefined, removePortrait?: (id: string) => void);
+    /** React 和扩展都可以订阅这一份稳定快照，语音设置变化不会刷新形象列表。 */
+    readonly getSnapshot: () => AssistantAppearanceSettings;
+    readonly subscribe: (listener: () => void) => (() => void);
+    getAppearance(): AssistantAppearanceSettings;
+    list(): readonly AssistantAvatarModel[];
+    getSelected(): AssistantAvatarModel;
+    select(id: string): Promise<void>;
+    add(model: AssistantAvatarModel): Promise<void>;
+    update(model: AssistantAvatarModel): Promise<void>;
+    remove(id: string): Promise<void>;
+    configure(update: AssistantAppearanceUpdate): Promise<void>;
+    /** 必须从独立协议操作调用；展示配置不会隐式开启第三方目录。 */
+    setThirdPartyEnabled(enabled: boolean): Promise<void>;
+    /** 引擎许可与第三方素材协议分开记录；撤销同意不卸载已安装引擎。 */
+    setEngineEnabled(enabled: boolean): Promise<void>;
+    /** 只读探测；已确认许可后由安装接口写入 CodingNS 自有引擎目录。 */
+    engineStatus(signal?: AbortSignal): Promise<AssistantAvatarEngineStatus>;
+    installEngine(signal?: AbortSignal): Promise<AssistantAvatarEngineStatus>;
+    getCatalog(signal?: AbortSignal): Promise<readonly AssistantAvatarCatalogEntry[]>;
+    previewCatalog(id: string, revision: string, lease: string, signal?: AbortSignal): Promise<AssistantAvatarTemporaryPreview>;
+    releasePreview(lease: string): Promise<void>;
+    keepPreview(lease: string): Promise<void>;
+    installCatalog(id: string, revision: string, licenseAccepted: boolean, signal?: AbortSignal, lease?: string): Promise<AssistantAvatarModel>;
+    /** 只读清单 JSON；网络/解析/取消失败都不新增形象，不修改当前选择。 */
+    importPackage(source: string, adapterId?: string, signal?: AbortSignal): Promise<AssistantAvatarModel>;
+    /** 新入口在 Host 安装完整素材后才写入形象列表；旧外链导入 API 保持兼容。 */
+    discover(source: string, signal?: AbortSignal): Promise<readonly AssistantAvatarCandidate[]>;
+    installPackage(source: string, adapterId?: string, signal?: AbortSignal): Promise<AssistantAvatarModel>;
+    private registerInstallation;
+    private call;
+    private insert;
+    private write;
+    private saveAppearance;
+    private requireWritable;
+    private requireConsent;
+    private requireEngineConsent;
+    private requireModel;
+    private requireCustom;
+}
+export declare function bindAssistantAvatarManager(services: CodingNsClientServices, manager: AssistantAvatarManager): void;
+export declare function getAssistantAvatarManager(services: CodingNsClientServices): AssistantAvatarManager;
+/** 扩展应将注销函数登记到 context.resources，已导入的数据不会随适配器注销丢失。 */
+export declare function registerAssistantAvatarAdapter(services: CodingNsClientServices, adapter: AssistantAvatarAdapter): () => void;
+//# sourceMappingURL=manager.d.ts.map

package/data/build/dist/client/avatar/manager.d.ts.map

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