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

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

@@ -0,0 +1,15 @@
+import type { AssistantAvatarModel } from './assistant-avatar.js';
+export interface AssistantAvatarPreset {
+    readonly labelKey: string;
+    readonly model: AssistantAvatarModel;
+}
+/**
+ * 目录保存经 Codex/DSH 适配器转换并核验的统一模型数据，不包含美术文件。
+ * 固定提交避免上游 main 更新悄悄改变素材；读取目录不请求网络，选中后才由渲染器加载。
+ * 预设使用独立 ID，保留此前按上游 ID 导入的用户形象与自定义清单容量。
+ */
+export declare const LEGACY_ASSISTANT_AVATAR_PRESETS: readonly AssistantAvatarPreset[];
+export declare function getAssistantAvatarPreset(id: string): AssistantAvatarPreset | undefined;
+/** 保留旧扩展的导出名称；第三方角色现在必须手工安装。 */
+export declare const ASSISTANT_AVATAR_PRESETS: readonly AssistantAvatarPreset[];
+//# sourceMappingURL=assistant-avatar-legacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-legacy.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAGjE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;CACrC;AAKD;;;;GAIG;AAEH,eAAO,MAAM,+BAA+B,EAAE,SAAS,qBAAqB,EAkB1E,CAAA;AAEF,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEtF;AAED,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAAsB,CAAA"}

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

@@ -0,0 +1,34 @@
+import { WHALE_LIVE2D_RESOURCE_PACK } from './assistant-avatar-legacy-resources.js';
+const spriteRoot = 'https://raw.githubusercontent.com/YunYueSama/codex-deepseek-pet/7661c8b304c5400701f91da01b1a643a207331de/codex-deepseek-pet/';
+const live2dRoot = WHALE_LIVE2D_RESOURCE_PACK.upstreamRoot;
+/**
+ * 目录保存经 Codex/DSH 适配器转换并核验的统一模型数据，不包含美术文件。
+ * 固定提交避免上游 main 更新悄悄改变素材；读取目录不请求网络，选中后才由渲染器加载。
+ * 预设使用独立 ID，保留此前按上游 ID 导入的用户形象与自定义清单容量。
+ */
+// 仅用于迁移旧版已经选中的记录；新安装不提供第三方内置目录。
+export const LEGACY_ASSISTANT_AVATAR_PRESETS = Object.freeze([
+    Object.freeze({ labelKey: 'avatar.preset.whaleSprite', model: Object.freeze({
+            id: 'codingns-preset-whale-sprite', name: '大肥鱼 · Q版全身',
+            renderer: 'spritesheet', source: `${spriteRoot}spritesheet.webp`, spriteVersion: 2,
+            package: Object.freeze({ adapterId: 'codex-pet', manifestUrl: `${spriteRoot}pet.json`, author: 'YunYueSama',
+                license: '大肥鱼项目署名许可 1.0：仅授权作者有权授权的新增贡献；第三方角色与参考作品权利另行确认，非 DeepSeek 官方授权。',
+                homepage: 'https://github.com/YunYueSama/codex-deepseek-pet/blob/7661c8b304c5400701f91da01b1a643a207331de/ASSET_LICENSE.md' }),
+        }) }),
+    Object.freeze({ labelKey: 'avatar.preset.whaleLive2d', model: Object.freeze({
+            id: 'codingns-preset-whale-live2d', name: '大肥鱼 · Live2D 桌前',
+            renderer: 'live2d', source: `${WHALE_LIVE2D_RESOURCE_PACK.basePath}${WHALE_LIVE2D_RESOURCE_PACK.manifest}`, spriteVersion: 2,
+            motionGroups: WHALE_LIVE2D_RESOURCE_PACK.motionGroups,
+            live2d: Object.freeze({ scale: 1, position: Object.freeze([0, 0]) }),
+            package: Object.freeze({ adapterId: 'dsh-live2d-pet', manifestUrl: `${live2dRoot}pet.json`,
+                author: '模型：上善无形 / ZipZipPipe / 氵六青 · 插件：A8Chann',
+                license: 'CC BY-NC-SA 4.0：署名、非商业、相同方式共享；商业使用须分别取得各权利人授权。清单已精简，模型与贴图未修改。',
+                homepage: 'https://github.com/A8Chann/dsh-pet-live2d/blob/185c02bfbb3b886e1a236b5c2ec035cc085b9ca2/NOTICE.md' }),
+        }) }),
+]);
+export function getAssistantAvatarPreset(id) {
+    return LEGACY_ASSISTANT_AVATAR_PRESETS.find((preset) => preset.model.id === id);
+}
+/** 保留旧扩展的导出名称；第三方角色现在必须手工安装。 */
+export const ASSISTANT_AVATAR_PRESETS = Object.freeze([]);
+//# sourceMappingURL=assistant-avatar-legacy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-legacy.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-legacy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AAOnF,MAAM,UAAU,GAAG,8HAA8H,CAAA;AACjJ,MAAM,UAAU,GAAG,0BAA0B,CAAC,YAAY,CAAA;AAE1D;;;;GAIG;AACH,gCAAgC;AAChC,MAAM,CAAC,MAAM,+BAA+B,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC7F,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1E,EAAE,EAAE,8BAA8B,EAAE,IAAI,EAAE,YAAY;YACtD,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,UAAU,kBAAkB,EAAE,aAAa,EAAE,CAAC;YAClF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,UAAU,UAAU,EAAE,MAAM,EAAE,YAAY;gBACzG,OAAO,EAAE,gEAAgE;gBACzE,QAAQ,EAAE,iHAAiH,EAAE,CAAC;SACjI,CAAC,EAAE,CAAC;IACL,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1E,EAAE,EAAE,8BAA8B,EAAE,IAAI,EAAE,iBAAiB;YAC3D,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,0BAA0B,CAAC,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,CAAC;YAC5H,YAAY,EAAE,0BAA0B,CAAC,YAAY;YACrD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC,EAAE,CAAC;YAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,UAAU,UAAU;gBACxF,MAAM,EAAE,yCAAyC;gBACjD,OAAO,EAAE,+DAA+D;gBACxE,QAAQ,EAAE,mGAAmG,EAAE,CAAC;SACnH,CAAC,EAAE,CAAC;CACN,CAAC,CAAA;AAEF,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AACjF,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,wBAAwB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,3 @@
+/** 兼容旧扩展导出；默认目录已移除，角色素材通过安装器登记。 */
+export { ASSISTANT_AVATAR_PRESETS, getAssistantAvatarPreset, type AssistantAvatarPreset } from './assistant-avatar-legacy.js';
+//# sourceMappingURL=assistant-avatar-presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-presets.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-presets.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAA"}

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

@@ -0,0 +1,3 @@
+/** 兼容旧扩展导出；默认目录已移除，角色素材通过安装器登记。 */
+export { ASSISTANT_AVATAR_PRESETS, getAssistantAvatarPreset } from './assistant-avatar-legacy.js';
+//# sourceMappingURL=assistant-avatar-presets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-presets.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-presets.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAA8B,MAAM,8BAA8B,CAAA"}

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

@@ -0,0 +1,16 @@
+/** 所有形象适配器与渲染器共用稳定注册快照；注销只清理自己的一代。 */
+export declare class AssistantAvatarRegistration<T extends {
+    readonly id: string;
+}> {
+    private readonly entries;
+    private readonly reserved;
+    private readonly listeners;
+    private snapshot;
+    constructor(builtins?: readonly T[]);
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getSnapshot: () => readonly T[];
+    get(id: string): T | undefined;
+    register(entry: T): () => void;
+    private emit;
+}
+//# sourceMappingURL=assistant-avatar-registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-registration.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-registration.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,qBAAa,2BAA2B,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAc;gBAClB,QAAQ,GAAE,SAAS,CAAC,EAAO;IAKvC,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAAsF;IAC/I,QAAQ,CAAC,WAAW,QAAO,SAAS,CAAC,EAAE,CAAiB;IACxD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,IAAI;IAS9B,OAAO,CAAC,IAAI;CACb"}

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

@@ -0,0 +1,33 @@
+/** 所有形象适配器与渲染器共用稳定注册快照；注销只清理自己的一代。 */
+export class AssistantAvatarRegistration {
+    entries = new Map();
+    reserved;
+    listeners = new Set();
+    snapshot;
+    constructor(builtins = []) {
+        for (const entry of builtins)
+            this.entries.set(entry.id, entry);
+        this.reserved = new Set(this.entries.keys());
+        this.snapshot = Object.freeze([...this.entries.values()]);
+    }
+    subscribe = (listener) => { this.listeners.add(listener); return () => { this.listeners.delete(listener); }; };
+    getSnapshot = () => this.snapshot;
+    get(id) { return this.entries.get(id); }
+    register(entry) {
+        if (!/^[A-Za-z][A-Za-z0-9_-]{0,79}$/u.test(entry.id) || this.reserved.has(entry.id))
+            throw new TypeError('形象扩展 ID 无效或占用内置名称');
+        if (this.entries.has(entry.id))
+            throw new TypeError(`形象扩展已注册: ${entry.id}`);
+        this.entries.set(entry.id, entry);
+        this.emit();
+        return () => {
+            if (this.entries.get(entry.id) !== entry)
+                return;
+            this.entries.delete(entry.id);
+            this.emit();
+        };
+    }
+    emit() { this.snapshot = Object.freeze([...this.entries.values()]); for (const listener of this.listeners)
+        listener(); }
+}
+//# sourceMappingURL=assistant-avatar-registration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-registration.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-registration.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,OAAO,2BAA2B;IACrB,OAAO,GAAG,IAAI,GAAG,EAAa,CAAA;IAC9B,QAAQ,CAAa;IACrB,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IAC1C,QAAQ,CAAc;IAC9B,YAAY,WAAyB,EAAE;QACrC,KAAK,MAAM,KAAK,IAAI,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC/D,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC3D,CAAC;IACQ,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA,CAAC,CAAC,CAAA;IACtI,WAAW,GAAG,GAAiB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAA;IACxD,GAAG,CAAC,EAAU,IAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC;IAC9D,QAAQ,CAAC,KAAQ;QACf,IAAI,CAAC,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC7H,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,YAAY,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9C,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC5C,CAAC,CAAA;IACH,CAAC;IACO,IAAI,KAAW,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;QAAE,QAAQ,EAAE,CAAA,CAAC,CAAC;CACtI"}

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

@@ -0,0 +1,26 @@
+/** 可复用的资源包描述，不包含任何角色素材来源或目录。 */
+export interface AssistantAvatarResourcePack {
+    readonly basePath: string;
+    readonly upstreamRoot: string;
+    readonly manifest: string;
+    readonly motionGroups: Readonly<Record<string, string>>;
+    readonly files: readonly {
+        readonly path: string;
+        readonly contentType: string;
+        readonly maxBytes: number;
+        readonly preload?: false;
+    }[];
+}
+export interface AssistantAvatarCacheStatus {
+    readonly version: 1;
+    readonly generation: string;
+    readonly pack: string;
+    readonly cached: number;
+    readonly pending: number;
+    readonly total: number;
+    readonly downloads: number;
+}
+export declare function assistantAvatarCacheStatusPath(pack: AssistantAvatarResourcePack): string;
+/** 默认没有第三方资源包，保留旧内部调用的目录形状。 */
+export declare const ASSISTANT_AVATAR_RESOURCE_PACKS: readonly AssistantAvatarResourcePack[];
+//# sourceMappingURL=assistant-avatar-resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-resources.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-resources.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAE,EAAE,CAAA;CACxI;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AACD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,2BAA2B,GAAG,MAAM,CAA+C;AACxI,+BAA+B;AAC/B,eAAO,MAAM,+BAA+B,EAAE,SAAS,2BAA2B,EAAsB,CAAA"}

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

@@ -0,0 +1,4 @@
+export function assistantAvatarCacheStatusPath(pack) { return `${pack.basePath}cache-status.json`; }
+/** 默认没有第三方资源包，保留旧内部调用的目录形状。 */
+export const ASSISTANT_AVATAR_RESOURCE_PACKS = Object.freeze([]);
+//# sourceMappingURL=assistant-avatar-resources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-avatar-resources.js","sourceRoot":"","sources":["../../../../src/shared/assistant-avatar-resources.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,8BAA8B,CAAC,IAAiC,IAAY,OAAO,GAAG,IAAI,CAAC,QAAQ,mBAAmB,CAAA,CAAC,CAAC;AACxI,+BAA+B;AAC/B,MAAM,CAAC,MAAM,+BAA+B,GAA2C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,103 @@
+import type { AssistantAvatarConsent } from './assistant-avatar-catalog.js';
+import type { AssistantAvatarEngineConsent } from './assistant-avatar-engine.js';
+/** 形象只消费助理状态，不持有会话、语音设备或工作区权限。 */
+export type AssistantAvatarState = 'idle' | 'listening' | 'thinking' | 'speaking' | 'waiting' | 'error';
+export type AssistantAvatarSurface = 'floating' | 'dialog';
+export declare const ASSISTANT_AVATAR_STATES: readonly AssistantAvatarState[];
+/** 素材与角色身份分开，同一个包可以为两个展示位置提供不同素材。 */
+export interface AssistantAvatarAsset {
+    /** 内置 ID 为 builtin/image/spritesheet/live2d；其他 ID 由扩展注册。 */
+    readonly renderer: string;
+    readonly source: string;
+    readonly spriteVersion: 1 | 2;
+    /** 图片差分按统一助理状态选择，未声明的状态使用 source。 */
+    readonly stateSources?: Readonly<Partial<Record<AssistantAvatarState, string>>>;
+    /** Live2D 动作组显式映射，未声明的状态保留自动识别与待机回落。 */
+    readonly motionGroups?: Readonly<Partial<Record<AssistantAvatarState, string>>>;
+    /** 模型自适应后再应用包内缩放和位置，适配不同模型的构图。 */
+    readonly live2d?: {
+        readonly scale?: number;
+        readonly position?: readonly [number, number];
+    };
+}
+export interface AssistantAvatarPackageInfo {
+    readonly adapterId: string;
+    readonly manifestUrl?: string;
+    readonly author?: string;
+    readonly license?: string;
+    readonly homepage?: string;
+    /** 本地素材安装的内容版本；不持有渲染实例或绝对磁盘路径。 */
+    readonly installationId?: string;
+}
+export interface AssistantAvatarModel extends AssistantAvatarAsset {
+    readonly id: string;
+    readonly name: string;
+    readonly package?: AssistantAvatarPackageInfo;
+    readonly surfaces?: Readonly<Partial<Record<AssistantAvatarSurface, AssistantAvatarAsset>>>;
+}
+/** CodingNS 原生包清单；其他格式由适配器转换后使用相同的存储与展示接口。 */
+export interface AssistantAvatarManifest {
+    readonly avatarManifestVersion: 1;
+    readonly id: string;
+    readonly name: string;
+    readonly asset: AssistantAvatarAsset;
+    readonly surfaces?: AssistantAvatarModel['surfaces'];
+    readonly author?: string;
+    readonly license?: string;
+    readonly homepage?: string;
+}
+export interface AssistantAppearanceSettings {
+    readonly floatingEnabled: boolean;
+    readonly dialogEnabled: boolean;
+    readonly floatingSize: number;
+    readonly dialogSize: number;
+    readonly selectedId: string;
+    readonly models: readonly AssistantAvatarModel[];
+    /** 仅控制第三方目录访问，撤销同意不会删除已安装形象。 */
+    readonly thirdPartyConsent?: AssistantAvatarConsent;
+    /** 仅控制 Live2D 引擎下载；撤销同意不会删除已安装引擎。 */
+    readonly engineConsent?: AssistantAvatarEngineConsent;
+}
+export declare const ASSISTANT_AVATAR_RUNTIME_PATH = "/api/codingns/assistant-avatar-runtime";
+/** 尺寸档位只映射到既有数值字段，旧自定义尺寸无需迁移。 */
+export declare const ASSISTANT_AVATAR_FLOATING_STANDARD_SIZE = 144;
+export declare const ASSISTANT_AVATAR_FLOATING_MINI_SIZE: number;
+export declare const BUILTIN_ASSISTANT_AVATAR: AssistantAvatarModel;
+/** 保留旧默认 ID 和存储字段；实际生图素材通过固定的同源 URL 加载。 */
+export declare const BUILTIN_ASSISTANT_AVATARS: readonly AssistantAvatarModel[];
+export declare const BUILTIN_ASSISTANT_AVATAR_SOURCES: Readonly<Record<string, string>>;
+/** 两个基础形象加原有的 19 个自定义名额，升级时不会丢掉已登记角色。 */
+export declare const ASSISTANT_AVATAR_MAX_MODELS = 21;
+export declare function getBuiltinAssistantAvatar(id: unknown): AssistantAvatarModel | undefined;
+export declare function builtinAssistantAvatarLabelKey(id: string): string | undefined;
+export declare const DEFAULT_ASSISTANT_APPEARANCE: AssistantAppearanceSettings;
+/** 资源只允许网页地址；任意脚本、file: 和协议相对地址均不能作为素材入口。 */
+export declare function isAssistantAvatarSource(value: string): boolean;
+/** 读取旧设置时补默认值；非法模型被过滤，绝不让坏配置阻止助理入口。 */
+export declare function normalizeAssistantAppearance(value: unknown): AssistantAppearanceSettings;
+/** 写入必须严格校验，不能把被静默修正的数据报告为保存成功。 */
+export declare function validateAssistantAppearance(value: unknown): void;
+/** 所有导入和管理写入共享同一校验，不能由某个适配器绕过资源边界。 */
+export declare function validateAssistantAvatarModel(value: unknown): asserts value is AssistantAvatarModel;
+/** 保留旧存储字段，复制白名单内的数据，避免扩展把运行对象写进设置。 */
+export declare function copyAssistantAvatarModel(model: AssistantAvatarModel): AssistantAvatarModel;
+export declare function selectedAssistantAvatar(appearance: AssistantAppearanceSettings): AssistantAvatarModel;
+/** 创建表单只列已登记形象；已创建助理和管理器可保留旧选择的兼容入口。 */
+export declare function listAssistantAvatars(appearance: AssistantAppearanceSettings, includeLegacy?: boolean): readonly AssistantAvatarModel[];
+/** 展示位置只覆盖素材，不覆盖身份；状态映射也跟随所选素材，不串用另一种格式。 */
+export declare function resolveAssistantAvatarAsset(model: AssistantAvatarModel, surface: AssistantAvatarSurface): AssistantAvatarModel;
+export declare function assistantAvatarImageSource(model: AssistantAvatarAsset, state: AssistantAvatarState): string;
+export declare function resolveAssistantAvatarState(state: string | undefined, pending?: boolean): AssistantAvatarState;
+export interface AssistantSpriteMotion {
+    readonly row: number;
+    readonly frames: number;
+    readonly interval: number;
+}
+/** 帧布局来自 Signalight/codex-to-dsh-pet；单帧 192×208，8 列。 */
+export declare function assistantSpriteMotion(state: AssistantAvatarState): AssistantSpriteMotion;
+/** 视口变化或旧坐标失效时让宠物保持在可点击范围。 */
+export declare function clampAssistantAvatarPosition(x: number, y: number, width: number, height: number, viewportWidth: number, viewportHeight: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=assistant-avatar.d.ts.map

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

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

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

@@ -0,0 +1,240 @@
+import { getAssistantAvatarPreset } from './assistant-avatar-legacy.js';
+import { validAssistantAvatarConsent } from './assistant-avatar-catalog.js';
+import { validAssistantAvatarEngineConsent } from './assistant-avatar-engine.js';
+export const ASSISTANT_AVATAR_STATES = ['idle', 'listening', 'thinking', 'speaking', 'waiting', 'error'];
+export const ASSISTANT_AVATAR_RUNTIME_PATH = '/api/codingns/assistant-avatar-runtime';
+/** 尺寸档位只映射到既有数值字段，旧自定义尺寸无需迁移。 */
+export const ASSISTANT_AVATAR_FLOATING_STANDARD_SIZE = 144;
+export const ASSISTANT_AVATAR_FLOATING_MINI_SIZE = ASSISTANT_AVATAR_FLOATING_STANDARD_SIZE / 2;
+export const BUILTIN_ASSISTANT_AVATAR = {
+    id: 'codingns-default', name: '鱼妞', renderer: 'builtin', source: '', spriteVersion: 2,
+};
+/** 保留旧默认 ID 和存储字段；实际生图素材通过固定的同源 URL 加载。 */
+export const BUILTIN_ASSISTANT_AVATARS = [BUILTIN_ASSISTANT_AVATAR,
+    { id: 'codingns-basic-male', name: '鱼仔', renderer: 'builtin', source: '', spriteVersion: 2 }];
+/** 旧名称仅用于写入兼容；读取归一化后统一显示新名称，其他内置字段仍不可替换。 */
+const legacyBuiltinNames = {
+    'codingns-default': 'CodingNS', 'codingns-basic-male': '基础形象 · 男生',
+};
+export const BUILTIN_ASSISTANT_AVATAR_SOURCES = {
+    'codingns-default': '/api/codingns/assistant-avatar-basic/female-v1.png',
+    'codingns-basic-male': '/api/codingns/assistant-avatar-basic/male-v1.png',
+};
+/** 两个基础形象加原有的 19 个自定义名额，升级时不会丢掉已登记角色。 */
+export const ASSISTANT_AVATAR_MAX_MODELS = 21;
+export function getBuiltinAssistantAvatar(id) {
+    return BUILTIN_ASSISTANT_AVATARS.find((model) => model.id === id);
+}
+export function builtinAssistantAvatarLabelKey(id) {
+    if (id === BUILTIN_ASSISTANT_AVATAR.id)
+        return 'avatar.builtinName';
+    if (id === 'codingns-basic-male')
+        return 'avatar.builtinMaleName';
+    return undefined;
+}
+export const DEFAULT_ASSISTANT_APPEARANCE = {
+    floatingEnabled: false, dialogEnabled: true, floatingSize: ASSISTANT_AVATAR_FLOATING_STANDARD_SIZE, dialogSize: 240,
+    selectedId: BUILTIN_ASSISTANT_AVATAR.id, models: BUILTIN_ASSISTANT_AVATARS,
+};
+/** 资源只允许网页地址；任意脚本、file: 和协议相对地址均不能作为素材入口。 */
+export function isAssistantAvatarSource(value) {
+    if (value.length === 0 || value.length > 2048 || /[\s\\\u0000-\u001f]/u.test(value))
+        return false;
+    if (value.startsWith('/') && !value.startsWith('//'))
+        return true;
+    try {
+        const url = new URL(value);
+        return (url.protocol === 'https:' || url.protocol === 'http:') && url.username === '' && url.password === '';
+    }
+    catch {
+        return false;
+    }
+}
+/** 读取旧设置时补默认值；非法模型被过滤，绝不让坏配置阻止助理入口。 */
+export function normalizeAssistantAppearance(value) {
+    const record = asRecord(value);
+    const models = [...BUILTIN_ASSISTANT_AVATARS];
+    const seen = new Set(models.map((model) => model.id));
+    for (const item of Array.isArray(record.models) ? record.models.slice(0, ASSISTANT_AVATAR_MAX_MODELS) : []) {
+        if (models.length >= ASSISTANT_AVATAR_MAX_MODELS)
+            break;
+        const model = asRecord(item);
+        if (!validModel(model) || seen.has(model.id))
+            continue;
+        seen.add(model.id);
+        models.push(copyAssistantAvatarModel(model));
+    }
+    return {
+        floatingEnabled: record.floatingEnabled === true,
+        dialogEnabled: record.dialogEnabled !== false,
+        floatingSize: boundedSize(record.floatingSize, ASSISTANT_AVATAR_FLOATING_MINI_SIZE, 320, ASSISTANT_AVATAR_FLOATING_STANDARD_SIZE),
+        dialogSize: boundedSize(record.dialogSize, 120, 480, 240),
+        selectedId: typeof record.selectedId === 'string' && (seen.has(record.selectedId) || getAssistantAvatarPreset(record.selectedId) !== undefined) ? record.selectedId : BUILTIN_ASSISTANT_AVATAR.id,
+        models,
+        ...(validAssistantAvatarConsent(record.thirdPartyConsent) ? { thirdPartyConsent: {
+                version: record.thirdPartyConsent.version, acceptedAt: record.thirdPartyConsent.acceptedAt
+            } } : {}),
+        ...(validAssistantAvatarEngineConsent(record.engineConsent) ? { engineConsent: {
+                version: record.engineConsent.version, acceptedAt: record.engineConsent.acceptedAt
+            } } : {}),
+    };
+}
+/** 写入必须严格校验，不能把被静默修正的数据报告为保存成功。 */
+export function validateAssistantAppearance(value) {
+    const record = asRecord(value);
+    if (record.thirdPartyConsent !== undefined && !validAssistantAvatarConsent(record.thirdPartyConsent))
+        throw new TypeError('第三方形象协议记录无效');
+    if (record.engineConsent !== undefined && !validAssistantAvatarEngineConsent(record.engineConsent))
+        throw new TypeError('Live2D 引擎许可记录无效');
+    if (typeof record.floatingEnabled !== 'boolean' || typeof record.dialogEnabled !== 'boolean')
+        throw new TypeError('形象显示开关无效');
+    for (const [key, min, max] of [['floatingSize', ASSISTANT_AVATAR_FLOATING_MINI_SIZE, 320], ['dialogSize', 120, 480]]) {
+        if (typeof record[key] !== 'number' || !Number.isInteger(record[key]) || record[key] < min || record[key] > max)
+            throw new TypeError('形象尺寸超出范围');
+    }
+    if (!Array.isArray(record.models) || record.models.length === 0 || record.models.length > ASSISTANT_AVATAR_MAX_MODELS)
+        throw new TypeError(`形象清单必须包含 1 到 ${ASSISTANT_AVATAR_MAX_MODELS} 项`);
+    const seen = new Set();
+    for (const item of record.models) {
+        const model = asRecord(item);
+        validateAssistantAvatarModel(model);
+        if (typeof model.id !== 'string' || seen.has(model.id))
+            throw new TypeError('形象 ID 重复或无效');
+        seen.add(model.id);
+    }
+    if (!seen.has(BUILTIN_ASSISTANT_AVATAR.id) || typeof record.selectedId !== 'string'
+        || (!seen.has(record.selectedId) && getAssistantAvatarPreset(record.selectedId) === undefined))
+        throw new TypeError('当前形象不在清单中');
+}
+/** 所有导入和管理写入共享同一校验，不能由某个适配器绕过资源边界。 */
+export function validateAssistantAvatarModel(value) {
+    const model = asRecord(value);
+    const builtin = getBuiltinAssistantAvatar(model.id);
+    if (builtin !== undefined) {
+        const keys = Object.keys(builtin);
+        if (keys.some((key) => model[key] !== builtin[key] && !(key === 'name' && model[key] === legacyBuiltinNames[builtin.id]))
+            || Object.keys(model).some((key) => !keys.includes(key) && model[key] !== undefined))
+            throw new TypeError('内置形象不可替换');
+        return;
+    }
+    if (!validModel(model))
+        throw new TypeError('形象名称、类型或资源地址无效');
+}
+/** 保留旧存储字段，复制白名单内的数据，避免扩展把运行对象写进设置。 */
+export function copyAssistantAvatarModel(model) {
+    return { id: model.id, name: model.name.trim(), ...copyAsset(model),
+        ...(model.package === undefined ? {} : { package: { ...model.package } }),
+        ...(model.surfaces === undefined ? {} : { surfaces: Object.fromEntries(Object.entries(model.surfaces).map(([surface, asset]) => [surface, copyAsset(asset)])) }),
+    };
+}
+export function selectedAssistantAvatar(appearance) {
+    return appearance.models.find((model) => model.id === appearance.selectedId)
+        ?? getAssistantAvatarPreset(appearance.selectedId)?.model ?? BUILTIN_ASSISTANT_AVATAR;
+}
+/** 创建表单只列已登记形象；已创建助理和管理器可保留旧选择的兼容入口。 */
+export function listAssistantAvatars(appearance, includeLegacy = true) {
+    if (!includeLegacy)
+        return appearance.models;
+    const legacy = getAssistantAvatarPreset(appearance.selectedId)?.model;
+    return legacy === undefined || appearance.models.some((model) => model.id === legacy.id)
+        ? appearance.models : [...appearance.models, legacy];
+}
+/** 展示位置只覆盖素材，不覆盖身份；状态映射也跟随所选素材，不串用另一种格式。 */
+export function resolveAssistantAvatarAsset(model, surface) {
+    const asset = model.surfaces?.[surface];
+    return asset === undefined ? model : { id: model.id, name: model.name, ...copyAsset(asset),
+        ...(model.package === undefined ? {} : { package: model.package }), ...(model.surfaces === undefined ? {} : { surfaces: model.surfaces }) };
+}
+export function assistantAvatarImageSource(model, state) {
+    return model.stateSources?.[state] ?? model.source;
+}
+export function resolveAssistantAvatarState(state, pending = false) {
+    if (state === 'error')
+        return 'error';
+    if (state === 'speaking')
+        return 'speaking';
+    if (pending || state === 'loading' || state === 'thinking')
+        return 'thinking';
+    if (state === 'listening' || state === 'recording')
+        return 'listening';
+    if (state === 'waiting')
+        return 'waiting';
+    return 'idle';
+}
+/** 帧布局来自 Signalight/codex-to-dsh-pet；单帧 192×208，8 列。 */
+export function assistantSpriteMotion(state) {
+    if (state === 'error')
+        return { row: 5, frames: 8, interval: 140 };
+    if (state === 'waiting' || state === 'listening')
+        return { row: 6, frames: 6, interval: 150 };
+    if (state === 'thinking')
+        return { row: 7, frames: 6, interval: 120 };
+    if (state === 'speaking')
+        return { row: 8, frames: 6, interval: 150 };
+    return { row: 0, frames: 6, interval: 160 };
+}
+/** 视口变化或旧坐标失效时让宠物保持在可点击范围。 */
+export function clampAssistantAvatarPosition(x, y, width, height, viewportWidth, viewportHeight) {
+    return { x: Math.max(0, Math.min(Number.isFinite(x) ? x : 0, Math.max(0, viewportWidth - width))),
+        y: Math.max(0, Math.min(Number.isFinite(y) ? y : 0, Math.max(0, viewportHeight - height))) };
+}
+function validModel(model) {
+    return typeof model.id === 'string' && /^[A-Za-z][A-Za-z0-9_-]{0,79}$/u.test(model.id)
+        && typeof model.name === 'string' && model.name.trim().length > 0 && model.name.length <= 80
+        && validAsset(model) && validPackage(model.package) && validSurfaces(model.surfaces);
+}
+function validAsset(asset) {
+    return typeof asset.renderer === 'string' && validId(asset.renderer) && asset.renderer !== 'builtin'
+        && typeof asset.source === 'string' && isAssistantAvatarSource(asset.source)
+        && (asset.spriteVersion === 1 || asset.spriteVersion === 2)
+        && validStateMap(asset.stateSources, (source) => asset.renderer === 'image' && isAssistantAvatarSource(source))
+        && validStateMap(asset.motionGroups, (group) => asset.renderer === 'live2d' && group.trim().length > 0 && group.length <= 120)
+        && validLive2dOptions(asset.live2d, asset.renderer);
+}
+function validStateMap(value, valid) {
+    return value === undefined || (isRecord(value) && Object.entries(value).every(([state, item]) => ASSISTANT_AVATAR_STATES.includes(state) && typeof item === 'string' && valid(item)));
+}
+function validPackage(value) {
+    if (value === undefined)
+        return true;
+    if (!isRecord(value) || typeof value.adapterId !== 'string' || !validId(value.adapterId))
+        return false;
+    for (const key of ['manifestUrl', 'homepage'])
+        if (value[key] !== undefined && (typeof value[key] !== 'string' || !isAssistantAvatarSource(value[key])))
+            return false;
+    for (const key of ['author', 'license'])
+        if (value[key] !== undefined && (typeof value[key] !== 'string' || value[key].length > 2048))
+            return false;
+    if (value.installationId !== undefined && (typeof value.installationId !== 'string' || !/^[a-f0-9]{64}$/u.test(value.installationId)))
+        return false;
+    return Object.keys(value).every((key) => ['adapterId', 'manifestUrl', 'homepage', 'author', 'license', 'installationId'].includes(key));
+}
+function validSurfaces(value) {
+    return value === undefined || (isRecord(value) && Object.entries(value).every(([surface, asset]) => ['floating', 'dialog'].includes(surface) && isRecord(asset) && validAsset(asset)));
+}
+function validLive2dOptions(value, renderer) {
+    if (value === undefined)
+        return true;
+    if (!isRecord(value) || renderer !== 'live2d' || Object.keys(value).some((key) => !['scale', 'position'].includes(key)))
+        return false;
+    if (value.scale !== undefined && (typeof value.scale !== 'number' || !Number.isFinite(value.scale) || value.scale < 0.05 || value.scale > 10))
+        return false;
+    return value.position === undefined || (Array.isArray(value.position) && value.position.length === 2
+        && value.position.every((item) => typeof item === 'number' && Number.isFinite(item) && Math.abs(item) <= 2));
+}
+function copyAsset(asset) {
+    return { renderer: asset.renderer, source: asset.source, spriteVersion: asset.spriteVersion,
+        ...(asset.stateSources === undefined ? {} : { stateSources: { ...asset.stateSources } }),
+        ...(asset.motionGroups === undefined ? {} : { motionGroups: { ...asset.motionGroups } }),
+        ...(asset.live2d === undefined ? {} : { live2d: { ...asset.live2d, ...(asset.live2d.position === undefined ? {} : { position: [...asset.live2d.position] }) } }),
+    };
+}
+function validId(value) { return /^[A-Za-z][A-Za-z0-9_-]{0,79}$/u.test(value); }
+function isRecord(value) { return typeof value === 'object' && value !== null && !Array.isArray(value); }
+function boundedSize(value, min, max, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(min, Math.min(max, Math.round(value))) : fallback;
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+}
+//# sourceMappingURL=assistant-avatar.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** 清理指令是固定的协议标识，中文别名不随界面语言变化。 */
+export declare const ASSISTANT_CLEAR_COMMANDS: readonly string[];
+//# sourceMappingURL=assistant-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-commands.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-commands.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAAuC,CAAA"}

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

@@ -0,0 +1,3 @@
+/** 清理指令是固定的协议标识，中文别名不随界面语言变化。 */
+export const ASSISTANT_CLEAR_COMMANDS = ['/clear', '/清理', '/reset', '/重置'];
+//# sourceMappingURL=assistant-commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-commands.js","sourceRoot":"","sources":["../../../../src/shared/assistant-commands.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA"}

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

@@ -0,0 +1,17 @@
+import type { AssistantProfileSettings, AssistantSettings } from './contracts/config.js';
+export declare const DEFAULT_ASSISTANT_NAME = "\u6211\u7684\u52A9\u7406";
+/** 首次创建预填的标准性格；作为草稿数据，用户可修改或清空。 */
+export declare const DEFAULT_ASSISTANT_PERSONALITY = "\u4F60\u662F\u4E00\u4F4D\u53CB\u5584\u3001\u8010\u5FC3\u3001\u53EF\u9760\u7684\u667A\u80FD\u52A9\u7406\uFF0C\u662F\u7528\u6237\u5DE5\u4F5C\u4E0E\u751F\u6D3B\u4E2D\u7684\u4F19\u4F34\u3002\u5584\u4E8E\u503E\u542C\uFF0C\u8868\u8FBE\u81EA\u7136\u7B80\u6D01\uFF0C\u4F18\u5148\u7ED9\u51FA\u6E05\u6670\u7ED3\u8BBA\u548C\u53EF\u6267\u884C\u5EFA\u8BAE\uFF0C\u518D\u6309\u9700\u89E3\u91CA\u7EC6\u8282\u3002\u9047\u5230\u4E0D\u786E\u5B9A\u7684\u4FE1\u606F\u4F1A\u5982\u5B9E\u8BF4\u660E\u5E76\u4E3B\u52A8\u6F84\u6E05\uFF0C\u5C0A\u91CD\u7528\u6237\u7684\u9009\u62E9\u4E0E\u9690\u79C1\uFF0C\u4E0D\u7F16\u9020\u4E8B\u5B9E\u6216\u7ECF\u5386\u3002";
+export declare const ASSISTANT_PERSONALITY_MAX_CHARS = 4000;
+/** 只为未创建且尚无设定的助理补默认值；显式空白和已有档案保持原样。 */
+export declare function readAssistantPersonality(profile: AssistantProfileSettings): string;
+/** 角色设定可以留空，但不能绕过正式配置与预览共同的长度限制。 */
+export declare function validateAssistantPersonality(value: unknown): asserts value is string;
+/** 原生侧栏可能投影虚拟 ID；范围比较保留用户选择，同时核对其所属 Host。 */
+export declare function assistantWorkspaceMatches(selected: string, hostId: string, workspaceId: string, local?: boolean): boolean;
+/** 只有显式档案表示已创建；旧能力配置仅预填表单，不能跳过首次创建。 */
+export declare function readAssistantProfile(settings: AssistantSettings): AssistantProfileSettings;
+/** 设置和生命周期接口共用严格校验，写入失败不能被默认值掩盖。 */
+export declare function validateAssistantProfile(value: unknown): asserts value is AssistantProfileSettings;
+export declare function validateAssistantModel(value: unknown): asserts value is NonNullable<AssistantSettings['model']>;
+//# sourceMappingURL=assistant-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGxF,eAAO,MAAM,sBAAsB,6BAAS,CAAA;AAC5C,mCAAmC;AACnC,eAAO,MAAM,6BAA6B,2nBAA8G,CAAA;AACxJ,eAAO,MAAM,+BAA+B,OAAO,CAAA;AAEnD,uCAAuC;AACvC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAElF;AAED,oCAAoC;AACpC,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAEpF;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAIvH;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,wBAAwB,CAG1F;AAED,oCAAoC;AACpC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAOlG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAK/G"}