zcw-shared 2.26.0 → 2.27.0

package/dist/constants/agentAvatar3d.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_AGENT_AVATAR_3D_MODEL_PATH = "/models/agent-avatar-full-body.glb";
+export declare const DEFAULT_AGENT_AVATAR_3D_MODEL_URL = "/models/agent-avatar-full-body.glb";
+export type BuiltinAgentAvatar3dCategory = 'character' | 'outfit' | 'accessory';
+export interface BuiltinAgentAvatar3dModelMeta {
+    id: string;
+    filename: string;
+    storagePath: string;
+    label: string;
+    category: BuiltinAgentAvatar3dCategory;
+}
+export declare const BUILTIN_AGENT_AVATAR_3D_MODELS: BuiltinAgentAvatar3dModelMeta[];
+export declare function hasAgentAvatar3dDefaultModel(): boolean;
+export declare function getBuiltinAgentAvatar3dModelById(id: string): BuiltinAgentAvatar3dModelMeta | undefined;
+export declare function resolveBuiltinAgentAvatar3dStoragePath(url: string): string | undefined;
+export declare function isBuiltinAgentAvatar3dModelUrl(url: string): boolean;

package/dist/constants/agentAvatar3d.js

@@ -0,0 +1,64 @@
+export const DEFAULT_AGENT_AVATAR_3D_MODEL_PATH = '/models/agent-avatar-full-body.glb';
+export const DEFAULT_AGENT_AVATAR_3D_MODEL_URL = DEFAULT_AGENT_AVATAR_3D_MODEL_PATH;
+export const BUILTIN_AGENT_AVATAR_3D_MODELS = [
+    {
+        id: 'full_body',
+        filename: 'agent-avatar-full-body.glb',
+        storagePath: '/models/agent-avatar-full-body.glb',
+        label: '全身底模',
+        category: 'character',
+    },
+    {
+        id: 'outfit_top_default',
+        filename: 'agent-avatar-outfit-top-default.glb',
+        storagePath: '/models/agent-avatar-outfit-top-default.glb',
+        label: '默认上装',
+        category: 'outfit',
+    },
+    {
+        id: 'outfit_bottom_default',
+        filename: 'agent-avatar-outfit-bottom-default.glb',
+        storagePath: '/models/agent-avatar-outfit-bottom-default.glb',
+        label: '默认下装',
+        category: 'outfit',
+    },
+    {
+        id: 'outfit_shoes_default',
+        filename: 'agent-avatar-outfit-shoes-default.glb',
+        storagePath: '/models/agent-avatar-outfit-shoes-default.glb',
+        label: '默认鞋靴',
+        category: 'outfit',
+    },
+    {
+        id: 'headwear',
+        filename: 'agent-avatar-headwear.glb',
+        storagePath: '/models/agent-avatar-headwear.glb',
+        label: '头饰',
+        category: 'accessory',
+    },
+];
+export function hasAgentAvatar3dDefaultModel() {
+    return true;
+}
+export function getBuiltinAgentAvatar3dModelById(id) {
+    return BUILTIN_AGENT_AVATAR_3D_MODELS.find((m) => m.id === id);
+}
+export function resolveBuiltinAgentAvatar3dStoragePath(url) {
+    const u = url.trim().toLowerCase();
+    if (!u)
+        return undefined;
+    for (const m of BUILTIN_AGENT_AVATAR_3D_MODELS) {
+        const fn = m.filename.toLowerCase();
+        const path = m.storagePath.toLowerCase();
+        if (u.includes(fn) || u.endsWith(path) || u === path)
+            return m.storagePath;
+    }
+    return undefined;
+}
+export function isBuiltinAgentAvatar3dModelUrl(url) {
+    const u = url.trim();
+    if (!u)
+        return true;
+    return resolveBuiltinAgentAvatar3dStoragePath(u) !== undefined;
+}
+//# sourceMappingURL=agentAvatar3d.js.map

package/dist/constants/agentAvatar3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAvatar3d.js","sourceRoot":"","sources":["../../src/constants/agentAvatar3d.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kCAAkC,GAAG,oCAAoC,CAAA;AACtF,MAAM,CAAC,MAAM,iCAAiC,GAAG,kCAAkC,CAAA;AAYnF,MAAM,CAAC,MAAM,8BAA8B,GAAoC;IAC7E;QACE,EAAE,EAAE,WAAW;QACf,QAAQ,EAAE,4BAA4B;QACtC,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,WAAW;KACtB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,QAAQ,EAAE,qCAAqC;QAC/C,WAAW,EAAE,6CAA6C;QAC1D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,wCAAwC;QAClD,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,uCAAuC;QACjD,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,2BAA2B;QACrC,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,WAAW;KACtB;CACF,CAAA;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,EAAU;IAEV,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,GAAW;IAChE,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,8BAA8B,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;QACxC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,WAAW,CAAA;IAC5E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAW;IACxD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACpB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,OAAO,sCAAsC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAA;AAChE,CAAC"}

package/dist/constants/agentAvatar3dModular.d.ts

@@ -0,0 +1,34 @@
+export declare const AVATAR3D_MODULAR_SYSTEM_VERSION: "v1";
+export type Avatar3dModularSystemVersion = typeof AVATAR3D_MODULAR_SYSTEM_VERSION;
+export declare const AVATAR3D_STANDARD_SKELETON_PROFILE: "rpm_mixamo";
+export type Avatar3dSkeletonProfile = typeof AVATAR3D_STANDARD_SKELETON_PROFILE;
+export type Avatar3dModularSlotId = 'hair' | 'top' | 'bottom' | 'shoes' | 'gloves' | 'headwear' | 'faceAccessory';
+export type Avatar3dModularAttachMode = 'skinned_merge' | 'head_attach' | 'root_attach';
+export declare const AVATAR3D_MODULAR_SLOT_ORDER: Avatar3dModularSlotId[];
+export declare const AVATAR3D_MODULAR_SLOT_LABELS: Record<Avatar3dModularSlotId, string>;
+export interface Avatar3dModularBasePartMeta {
+    id: string;
+    filename: string;
+    storagePath: string;
+    label: string;
+    skeletonProfile: Avatar3dSkeletonProfile;
+    supportsFaceMorph: boolean;
+}
+export interface Avatar3dModularSlotPartMeta {
+    id: string;
+    slot: Avatar3dModularSlotId;
+    filename: string;
+    storagePath: string;
+    label: string;
+    skeletonProfile: Avatar3dSkeletonProfile;
+    attachMode: Avatar3dModularAttachMode;
+    hideBaseMeshHints?: string[];
+}
+export declare const DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID = "base_full_body";
+export declare const AVATAR3D_MODULAR_BASE_PARTS: Avatar3dModularBasePartMeta[];
+export declare const AVATAR3D_MODULAR_SLOT_PARTS: Avatar3dModularSlotPartMeta[];
+export declare function getAvatar3dModularBasePartById(id: string): Avatar3dModularBasePartMeta | undefined;
+export declare function getAvatar3dModularSlotPartById(id: string): Avatar3dModularSlotPartMeta | undefined;
+export declare function listAvatar3dModularSlotPartsForProfile(_profile: Avatar3dSkeletonProfile, slot?: Avatar3dModularSlotId): Avatar3dModularSlotPartMeta[];
+export declare function listActiveModularSlotIds(): Avatar3dModularSlotId[];
+export declare function normalizeModularBasePartId(basePartId: string): string;

package/dist/constants/agentAvatar3dModular.js

@@ -0,0 +1,93 @@
+export const AVATAR3D_MODULAR_SYSTEM_VERSION = 'v1';
+export const AVATAR3D_STANDARD_SKELETON_PROFILE = 'rpm_mixamo';
+export const AVATAR3D_MODULAR_SLOT_ORDER = [
+    'hair',
+    'top',
+    'bottom',
+    'shoes',
+    'gloves',
+    'headwear',
+    'faceAccessory',
+];
+export const AVATAR3D_MODULAR_SLOT_LABELS = {
+    hair: '发型',
+    top: '上装',
+    bottom: '下装',
+    shoes: '鞋靴',
+    gloves: '手套',
+    headwear: '头饰',
+    faceAccessory: '面部配饰',
+};
+export const DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID = 'base_full_body';
+export const AVATAR3D_MODULAR_BASE_PARTS = [
+    {
+        id: 'base_full_body',
+        filename: 'agent-avatar-full-body.glb',
+        storagePath: '/models/agent-avatar-full-body.glb',
+        label: '全身底模',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        supportsFaceMorph: true,
+    },
+];
+export const AVATAR3D_MODULAR_SLOT_PARTS = [
+    {
+        id: 'slot_top_default',
+        slot: 'top',
+        filename: 'agent-avatar-outfit-top-default.glb',
+        storagePath: '/models/agent-avatar-outfit-top-default.glb',
+        label: '默认上装',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Top'],
+    },
+    {
+        id: 'slot_bottom_default',
+        slot: 'bottom',
+        filename: 'agent-avatar-outfit-bottom-default.glb',
+        storagePath: '/models/agent-avatar-outfit-bottom-default.glb',
+        label: '默认下装',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Bottom'],
+    },
+    {
+        id: 'slot_shoes_default',
+        slot: 'shoes',
+        filename: 'agent-avatar-outfit-shoes-default.glb',
+        storagePath: '/models/agent-avatar-outfit-shoes-default.glb',
+        label: '默认鞋靴',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Footwear'],
+    },
+    {
+        id: 'slot_headwear_rpm',
+        slot: 'headwear',
+        filename: 'agent-avatar-headwear.glb',
+        storagePath: '/models/agent-avatar-headwear.glb',
+        label: '头饰',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'head_attach',
+    },
+];
+export function getAvatar3dModularBasePartById(id) {
+    return AVATAR3D_MODULAR_BASE_PARTS.find((p) => p.id === id);
+}
+export function getAvatar3dModularSlotPartById(id) {
+    return AVATAR3D_MODULAR_SLOT_PARTS.find((p) => p.id === id);
+}
+export function listAvatar3dModularSlotPartsForProfile(_profile, slot) {
+    return AVATAR3D_MODULAR_SLOT_PARTS.filter((p) => !slot || p.slot === slot);
+}
+export function listActiveModularSlotIds() {
+    return AVATAR3D_MODULAR_SLOT_ORDER.filter((slotId) => AVATAR3D_MODULAR_SLOT_PARTS.some((p) => p.slot === slotId));
+}
+export function normalizeModularBasePartId(basePartId) {
+    const id = basePartId.trim();
+    const meta = getAvatar3dModularBasePartById(id);
+    if (meta && meta.skeletonProfile === AVATAR3D_STANDARD_SKELETON_PROFILE) {
+        return id;
+    }
+    return DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID;
+}
+//# sourceMappingURL=agentAvatar3dModular.js.map

package/dist/constants/agentAvatar3dModular.js.map

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

package/dist/constants/agentPresence3dLabels.d.ts

@@ -0,0 +1,11 @@
+export declare const AGENT_PRESENCE_3D_LABELS: {
+    readonly sectionTitle: "3D 形象";
+    readonly shortName: "3D 形象";
+    readonly customizeAction: "定制形象";
+    readonly customizeDialogTitle: "定制 3D 形象";
+    readonly faceTuneTitle: "捏脸微调";
+    readonly applyAction: "应用";
+    readonly notConfigured: "未配置 3D 形象";
+    readonly loadingDefault: "加载中…";
+    readonly randomFaceSummary: "随机捏脸";
+};

package/dist/constants/agentPresence3dLabels.js

@@ -0,0 +1,12 @@
+export const AGENT_PRESENCE_3D_LABELS = {
+    sectionTitle: '3D 形象',
+    shortName: '3D 形象',
+    customizeAction: '定制形象',
+    customizeDialogTitle: '定制 3D 形象',
+    faceTuneTitle: '捏脸微调',
+    applyAction: '应用',
+    notConfigured: '未配置 3D 形象',
+    loadingDefault: '加载中…',
+    randomFaceSummary: '随机捏脸',
+};
+//# sourceMappingURL=agentPresence3dLabels.js.map

package/dist/constants/agentPresence3dLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPresence3dLabels.js","sourceRoot":"","sources":["../../src/constants/agentPresence3dLabels.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY,EAAE,OAAO;IACrB,SAAS,EAAE,OAAO;IAClB,eAAe,EAAE,MAAM;IACvB,oBAAoB,EAAE,UAAU;IAChC,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,MAAM;IACtB,iBAAiB,EAAE,MAAM;CACjB,CAAA"}

package/dist/constants/aiApiRoutes.d.ts

@@ -0,0 +1,8 @@
+export declare const AI_ADMIN_API_PREFIX = "admin/ai";
+export declare const AI_CHAT_API_PREFIX = "chat/ai";
+export declare const LLM_GATEWAY_OPENAI_PREFIX = "v1";
+export declare function adminAiApiPath(suffix?: string): string;
+export declare function chatAiApiPath(suffix?: string): string;
+export declare const CHAT_AI_SPA_PREFIX = "ai";
+export declare function chatAiSpaPath(suffix?: string): string;
+export declare function adminAiAgentSubResourcePathRegex(suffix: string): RegExp;

package/dist/constants/aiApiRoutes.js

@@ -0,0 +1,23 @@
+export const AI_ADMIN_API_PREFIX = 'admin/ai';
+export const AI_CHAT_API_PREFIX = 'chat/ai';
+export const LLM_GATEWAY_OPENAI_PREFIX = 'v1';
+export function adminAiApiPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${AI_ADMIN_API_PREFIX}/${s}` : `/${AI_ADMIN_API_PREFIX}`;
+}
+export function chatAiApiPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${AI_CHAT_API_PREFIX}/${s}` : `/${AI_CHAT_API_PREFIX}`;
+}
+export const CHAT_AI_SPA_PREFIX = 'ai';
+export function chatAiSpaPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${CHAT_AI_SPA_PREFIX}/${s}` : `/${CHAT_AI_SPA_PREFIX}`;
+}
+export function adminAiAgentSubResourcePathRegex(suffix) {
+    const seg = String(suffix ?? '')
+        .replace(/^\//, '')
+        .replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`^/${AI_ADMIN_API_PREFIX}/agents/[^/]+/${seg}$`);
+}
+//# sourceMappingURL=aiApiRoutes.js.map

package/dist/constants/aiApiRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiApiRoutes.js","sourceRoot":"","sources":["../../src/constants/aiApiRoutes.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAA;AAG7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAA;AAG3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAE7C,MAAM,UAAU,cAAc,CAAC,MAAM,GAAG,EAAE;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,EAAE;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAA;AACrE,CAAC;AAKD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAEtC,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,EAAE;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAA;AACrE,CAAC;AAGD,MAAM,UAAU,gCAAgC,CAAC,MAAc;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;SAC7B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IACzC,OAAO,IAAI,MAAM,CAAC,KAAK,mBAAmB,iBAAiB,GAAG,GAAG,CAAC,CAAA;AACpE,CAAC"}

package/dist/functions/ai/agentAvatar3dArkitMorph.d.ts

@@ -0,0 +1,14 @@
+export type ArkitMorphDirectionSpec = {
+    positive?: string[];
+    negative?: string[];
+};
+export declare const ARKIT_CATALOG_MORPH_SPECS: Record<string, ArkitMorphDirectionSpec>;
+export declare function isArkitBlendshapeModel(modelMorphNames: string[]): boolean;
+export declare function resolveMorphNamesInModel(templates: string[], modelMorphNames: string[]): string[];
+export declare function resolveArkitCatalogMorphNames(catalogId: string, modelMorphNames: string[]): {
+    positive: string[];
+    negative: string[];
+};
+export declare function isArkitMorphCatalogIdBound(catalogId: string, modelMorphNames: string[]): boolean;
+export declare function morphSliderToArkitInfluence(v: number): number;
+export declare function morphSliderToSymmetricInfluence(v: number): number;

package/dist/functions/ai/agentAvatar3dArkitMorph.js

@@ -0,0 +1,149 @@
+export const ARKIT_CATALOG_MORPH_SPECS = {
+    face_width: {
+        positive: ['cheekPuff'],
+        negative: ['jawLeft', 'jawRight'],
+    },
+    face_round: {
+        positive: ['cheekPuff'],
+        negative: ['cheekSquintLeft', 'cheekSquintRight'],
+    },
+    jaw_width: {
+        positive: ['jawLeft', 'jawRight'],
+        negative: ['jawForward'],
+    },
+    chin_length: {
+        positive: ['jawForward'],
+        negative: ['jawOpen'],
+    },
+    cheek_height: {
+        positive: ['cheekSquintLeft', 'cheekSquintRight'],
+        negative: ['cheekPuff'],
+    },
+    face_height: {
+        positive: ['jawOpen'],
+        negative: ['jawForward'],
+    },
+    brow_thickness: {
+        positive: ['browDownLeft', 'browDownRight'],
+        negative: ['browOuterUpLeft', 'browOuterUpRight'],
+    },
+    brow_height: {
+        positive: ['browInnerUp'],
+        negative: ['browDownLeft', 'browDownRight'],
+    },
+    brow_spacing: {
+        positive: ['browOuterUpLeft', 'browOuterUpRight'],
+        negative: ['browDownLeft', 'browDownRight'],
+    },
+    eye_size: {
+        positive: ['eyeWideLeft', 'eyeWideRight'],
+        negative: ['eyeSquintLeft', 'eyeSquintRight'],
+    },
+    eye_spacing: {
+        positive: ['eyeLookOutLeft', 'eyeLookOutRight'],
+        negative: ['eyeLookInLeft', 'eyeLookInRight'],
+    },
+    eye_height: {
+        positive: ['eyeLookUpLeft', 'eyeLookUpRight'],
+        negative: ['eyeLookDownLeft', 'eyeLookDownRight'],
+    },
+    eye_corner: {
+        positive: ['eyeSquintLeft', 'eyeSquintRight'],
+        negative: ['eyeWideLeft', 'eyeWideRight'],
+    },
+    eye_depth: {
+        positive: ['eyeSquintLeft', 'eyeSquintRight'],
+        negative: ['eyeWideLeft', 'eyeWideRight'],
+    },
+    nose_size: {
+        positive: ['noseSneerLeft', 'noseSneerRight'],
+        negative: [],
+    },
+    nose_width: {
+        positive: ['mouthFunnel'],
+        negative: ['mouthPucker'],
+    },
+    nose_height: {
+        positive: ['noseSneerLeft', 'noseSneerRight'],
+        negative: [],
+    },
+    nose_bridge: {
+        positive: ['jawForward'],
+        negative: [],
+    },
+    mouth_width: {
+        positive: ['mouthStretchLeft', 'mouthStretchRight'],
+        negative: ['mouthPucker'],
+    },
+    mouth_size: {
+        positive: ['mouthFunnel', 'mouthPucker'],
+        negative: [],
+    },
+    lip_thickness: {
+        positive: ['mouthPucker'],
+        negative: ['mouthStretchLeft', 'mouthStretchRight'],
+    },
+    mouth_corner: {
+        positive: ['mouthSmileLeft', 'mouthSmileRight'],
+        negative: ['mouthFrownLeft', 'mouthFrownRight'],
+    },
+};
+export function isArkitBlendshapeModel(modelMorphNames) {
+    const lower = modelMorphNames.map((n) => n.toLowerCase());
+    return lower.some((n) => n.startsWith('brow') ||
+        n.startsWith('jaw') ||
+        n.startsWith('mouthsmile') ||
+        n === 'browinnerup' ||
+        n === 'jawopen');
+}
+function findMorphName(needle, modelMorphNames) {
+    const lowerNeedle = needle.toLowerCase();
+    const exact = modelMorphNames.find((n) => n.toLowerCase() === lowerNeedle);
+    if (exact)
+        return exact;
+    const partial = modelMorphNames.find((n) => n.toLowerCase().includes(lowerNeedle));
+    return partial ?? null;
+}
+export function resolveMorphNamesInModel(templates, modelMorphNames) {
+    const modelSet = new Set(modelMorphNames);
+    const out = new Set();
+    for (const template of templates) {
+        const hit = findMorphName(template, modelMorphNames);
+        if (hit)
+            out.add(hit);
+        const lower = template.toLowerCase();
+        if (lower.endsWith('left')) {
+            const rightTemplate = template.replace(/left$/i, 'Right');
+            const rightHit = findMorphName(rightTemplate, modelMorphNames);
+            if (rightHit)
+                out.add(rightHit);
+        }
+        else if (lower.endsWith('right')) {
+            const leftTemplate = template.replace(/right$/i, 'Left');
+            const leftHit = findMorphName(leftTemplate, modelMorphNames);
+            if (leftHit)
+                out.add(leftHit);
+        }
+    }
+    return [...out].filter((n) => modelSet.has(n));
+}
+export function resolveArkitCatalogMorphNames(catalogId, modelMorphNames) {
+    const spec = ARKIT_CATALOG_MORPH_SPECS[catalogId];
+    if (!spec)
+        return { positive: [], negative: [] };
+    return {
+        positive: resolveMorphNamesInModel(spec.positive ?? [], modelMorphNames),
+        negative: resolveMorphNamesInModel(spec.negative ?? [], modelMorphNames),
+    };
+}
+export function isArkitMorphCatalogIdBound(catalogId, modelMorphNames) {
+    const { positive, negative } = resolveArkitCatalogMorphNames(catalogId, modelMorphNames);
+    return positive.length > 0 || negative.length > 0;
+}
+export function morphSliderToArkitInfluence(v) {
+    return Math.max(0, Math.min(1, v));
+}
+export function morphSliderToSymmetricInfluence(v) {
+    return (v + 1) / 2;
+}
+//# sourceMappingURL=agentAvatar3dArkitMorph.js.map

package/dist/functions/ai/agentAvatar3dArkitMorph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAvatar3dArkitMorph.js","sourceRoot":"","sources":["../../../src/functions/ai/agentAvatar3dArkitMorph.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,yBAAyB,GAA4C;IAChF,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;KAClC;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAClD;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;QACjC,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACjD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QAC3C,QAAQ,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAClD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;KAC5C;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QACjD,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;KAC5C;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;QACzC,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;KAC9C;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;QAC/C,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;KAC9C;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAClD;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;KAC1C;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;KAC1C;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,EAAE;KACb;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;QACnD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;QACxC,QAAQ,EAAE,EAAE;KACb;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;KACpD;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;QAC/C,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KAChD;CACF,CAAA;AAED,MAAM,UAAU,sBAAsB,CAAC,eAAyB;IAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;QAC1B,CAAC,KAAK,aAAa;QACnB,CAAC,KAAK,SAAS,CAClB,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,eAAyB;IAC9D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,CAAA;IAC1E,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAClF,OAAO,OAAO,IAAI,IAAI,CAAA;AACxB,CAAC;AAGD,MAAM,UAAU,wBAAwB,CACtC,SAAmB,EACnB,eAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAE7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACpD,IAAI,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAErB,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;QACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;YAC9D,IAAI,QAAQ;gBAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;YACxD,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,EAAE,eAAe,CAAC,CAAA;YAC5D,IAAI,OAAO;gBAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,eAAyB;IAEzB,MAAM,IAAI,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAA;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAChD,OAAO;QACL,QAAQ,EAAE,wBAAwB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,eAAe,CAAC;QACxE,QAAQ,EAAE,wBAAwB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,eAAe,CAAC;KACzE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,eAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,6BAA6B,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;IACxF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;AACnD,CAAC;AAGD,MAAM,UAAU,2BAA2B,CAAC,CAAS;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACpC,CAAC;AAGD,MAAM,UAAU,+BAA+B,CAAC,CAAS;IACvD,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC"}

package/dist/functions/ai/agentAvatar3dCapabilities.d.ts

@@ -0,0 +1,44 @@
+export type Avatar3dEditorMode = 'procedural' | 'glb_custom' | 'glb_monolithic';
+export interface Avatar3dColorCapabilities {
+    skin: boolean;
+    hair: boolean;
+    eye: boolean;
+}
+export interface Avatar3dMeshInventoryEntry {
+    meshName: string;
+    materialNames: string[];
+    hasTextureMap: boolean;
+    visible: boolean;
+}
+export interface Avatar3dCapabilities {
+    mode: Avatar3dEditorMode;
+    colors: Avatar3dColorCapabilities;
+    morphBoundCount: number;
+    morphTotal: number;
+    isArkit: boolean;
+    colorHint?: string;
+    morphHint?: string;
+}
+type ThreeLikeMaterial = {
+    name?: string;
+    map?: unknown;
+};
+type ThreeLikeMesh = {
+    isMesh?: boolean;
+    name?: string;
+    visible?: boolean;
+    material?: ThreeLikeMaterial | ThreeLikeMaterial[];
+};
+type ThreeLikeObject = {
+    traverse: (fn: (obj: ThreeLikeMesh) => void) => void;
+};
+export declare function listAvatar3dMeshInventory(root: ThreeLikeObject | null | undefined): Avatar3dMeshInventoryEntry[];
+export declare function isMonolithicTextureAvatar(inventory: Avatar3dMeshInventoryEntry[]): boolean;
+export declare function proceduralAvatar3dCapabilities(): Avatar3dCapabilities;
+export declare function deriveAvatar3dCapabilities(input: {
+    useProcedural: boolean;
+    inventory: Avatar3dMeshInventoryEntry[];
+    morphNames: string[];
+}): Avatar3dCapabilities;
+export declare function hasAnyAvatar3dColorCapability(colors: Avatar3dColorCapabilities): boolean;
+export {};

package/dist/functions/ai/agentAvatar3dCapabilities.js

@@ -0,0 +1,121 @@
+import { isArkitBlendshapeModel } from './agentAvatar3dArkitMorph.js';
+import { countAvatar3dMorphBindings, listAvatar3dMorphCatalogIds, } from './agentAvatar3dMorphCatalog.js';
+const OVERLAY_MESH_HINTS = ['transparent', 'headwear'];
+const OUTFIT_HINTS = ['outfit', 'cloth', 'shirt', 'pants', 'shoes', 'garment', 'top', 'bottom', 'jacket'];
+const SKIN_MESH_HINTS = ['skin', 'flesh', 'body'];
+const HAIR_MESH_HINTS = ['hair', 'scalp'];
+const EYE_MESH_HINTS = ['eye', 'iris', 'pupil', 'eyeball'];
+function meshLabel(meshName, matName) {
+    return `${meshName} ${matName}`.toLowerCase();
+}
+function isOverlayMeshName(name) {
+    const n = name.toLowerCase();
+    return OVERLAY_MESH_HINTS.some((h) => n.includes(h));
+}
+function matchesAny(text, hints) {
+    return hints.some((h) => text.includes(h));
+}
+export function listAvatar3dMeshInventory(root) {
+    const out = [];
+    if (!root?.traverse)
+        return out;
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const meshName = String(child.name ?? '');
+        const materials = Array.isArray(child.material)
+            ? child.material
+            : child.material
+                ? [child.material]
+                : [];
+        const materialNames = [];
+        let hasTextureMap = false;
+        for (const mat of materials) {
+            if (!mat)
+                continue;
+            materialNames.push(String(mat.name ?? ''));
+            if (mat.map)
+                hasTextureMap = true;
+        }
+        out.push({
+            meshName,
+            materialNames,
+            hasTextureMap,
+            visible: child.visible !== false,
+        });
+    });
+    return out;
+}
+function hasSeparableSkinMesh(inventory) {
+    return inventory.some((entry) => {
+        if (isOverlayMeshName(entry.meshName))
+            return false;
+        const labels = entry.materialNames.map((m) => meshLabel(entry.meshName, m));
+        return labels.some((l) => matchesAny(l, SKIN_MESH_HINTS) &&
+            !matchesAny(l, OUTFIT_HINTS) &&
+            !l.includes('wolf3d_avatar'));
+    });
+}
+export function isMonolithicTextureAvatar(inventory) {
+    const visible = inventory.filter((e) => e.visible && !isOverlayMeshName(e.meshName));
+    const textured = visible.filter((e) => e.hasTextureMap);
+    if (textured.length !== 1)
+        return false;
+    const entry = textured[0];
+    const mesh = entry.meshName.toLowerCase();
+    if (mesh.includes('wolf3d') || mesh.includes('avatar'))
+        return true;
+    return !hasSeparableSkinMesh(inventory);
+}
+function analyzeColorCapabilities(inventory, monolithic) {
+    if (monolithic)
+        return { skin: false, hair: false, eye: false };
+    const labels = inventory.flatMap((e) => e.materialNames.map((m) => meshLabel(e.meshName, m)));
+    const skin = labels.some((l) => matchesAny(l, SKIN_MESH_HINTS) &&
+        !matchesAny(l, OUTFIT_HINTS) &&
+        !l.includes('wolf3d_avatar'));
+    const hair = labels.some((l) => matchesAny(l, HAIR_MESH_HINTS));
+    const eye = labels.some((l) => matchesAny(l, EYE_MESH_HINTS) &&
+        !l.includes('eyebrow') &&
+        !l.includes('lash') &&
+        !l.includes('eyelash'));
+    return { skin, hair, eye };
+}
+export function proceduralAvatar3dCapabilities() {
+    const morphTotal = listAvatar3dMorphCatalogIds().length;
+    return {
+        mode: 'procedural',
+        colors: { skin: true, hair: true, eye: true },
+        morphBoundCount: morphTotal,
+        morphTotal,
+        isArkit: false,
+        morphHint: '积木人形支持全部五官参数与独立配色',
+    };
+}
+export function deriveAvatar3dCapabilities(input) {
+    if (input.useProcedural)
+        return proceduralAvatar3dCapabilities();
+    const morphNames = [...new Set(input.morphNames)];
+    const morphTotal = listAvatar3dMorphCatalogIds().length;
+    const morphBoundCount = countAvatar3dMorphBindings(morphNames);
+    const isArkit = isArkitBlendshapeModel(morphNames);
+    const monolithic = isMonolithicTextureAvatar(input.inventory);
+    const colors = analyzeColorCapabilities(input.inventory, monolithic);
+    return {
+        mode: monolithic ? 'glb_monolithic' : 'glb_custom',
+        colors,
+        morphBoundCount,
+        morphTotal,
+        isArkit,
+        colorHint: monolithic
+            ? '烘焙贴图，无法单独改色'
+            : !colors.skin && !colors.hair && !colors.eye
+                ? '未检测到可染色材质'
+                : undefined,
+        morphHint: morphBoundCount === 0 ? '当前模型不支持 morph' : undefined,
+    };
+}
+export function hasAnyAvatar3dColorCapability(colors) {
+    return colors.skin || colors.hair || colors.eye;
+}
+//# sourceMappingURL=agentAvatar3dCapabilities.js.map

package/dist/functions/ai/agentAvatar3dCapabilities.js.map

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