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

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"}

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

@@ -0,0 +1,45 @@
+import { parseVirtualWorkspaceId } from './contracts/peer-host.js';
+export const DEFAULT_ASSISTANT_NAME = '我的助理';
+/** 首次创建预填的标准性格；作为草稿数据，用户可修改或清空。 */
+export const DEFAULT_ASSISTANT_PERSONALITY = '你是一位友善、耐心、可靠的智能助理，是用户工作与生活中的伙伴。善于倾听，表达自然简洁，优先给出清晰结论和可执行建议，再按需解释细节。遇到不确定的信息会如实说明并主动澄清，尊重用户的选择与隐私，不编造事实或经历。';
+export const ASSISTANT_PERSONALITY_MAX_CHARS = 4000;
+/** 只为未创建且尚无设定的助理补默认值；显式空白和已有档案保持原样。 */
+export function readAssistantPersonality(profile) {
+    return profile.personality ?? (profile.initialized ? '' : DEFAULT_ASSISTANT_PERSONALITY);
+}
+/** 角色设定可以留空，但不能绕过正式配置与预览共同的长度限制。 */
+export function validateAssistantPersonality(value) {
+    if (typeof value !== 'string' || value.length > ASSISTANT_PERSONALITY_MAX_CHARS)
+        throw new TypeError('助理性格背景必须是最多 4000 字符的文字');
+}
+/** 原生侧栏可能投影虚拟 ID；范围比较保留用户选择，同时核对其所属 Host。 */
+export function assistantWorkspaceMatches(selected, hostId, workspaceId, local = false) {
+    if (selected === workspaceId || selected === `${hostId}:${workspaceId}`)
+        return true;
+    const virtual = parseVirtualWorkspaceId(selected);
+    return virtual !== null && virtual.workspaceId === workspaceId && (virtual.hostId === hostId || local && virtual.targetHostId === null);
+}
+/** 只有显式档案表示已创建；旧能力配置仅预填表单，不能跳过首次创建。 */
+export function readAssistantProfile(settings) {
+    if (settings.profile !== undefined)
+        return { ...settings.profile };
+    return { name: DEFAULT_ASSISTANT_NAME, initialized: false, createdAt: null };
+}
+/** 设置和生命周期接口共用严格校验，写入失败不能被默认值掩盖。 */
+export function validateAssistantProfile(value) {
+    const profile = value;
+    if (profile === null || typeof profile !== 'object' || Array.isArray(profile)
+        || typeof profile.name !== 'string' || !profile.name.trim() || profile.name.length > 80
+        || profile.personality !== undefined && (typeof profile.personality !== 'string' || profile.personality.length > ASSISTANT_PERSONALITY_MAX_CHARS)
+        || typeof profile.initialized !== 'boolean'
+        || profile.createdAt !== null && (!Number.isSafeInteger(profile.createdAt) || profile.createdAt < 0))
+        throw new TypeError('助理档案无效');
+}
+export function validateAssistantModel(value) {
+    const model = value;
+    if (model === null || typeof model !== 'object' || Array.isArray(model)
+        || typeof model.provider !== 'string' || !model.provider.trim() || model.provider.length > 200
+        || typeof model.model !== 'string' || !model.model.trim() || model.model.length > 200)
+        throw new TypeError('助理模型无效');
+}
+//# sourceMappingURL=assistant-lifecycle.js.map

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

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

package/data/build/dist/shared/assistant-message-timeline.d.ts

@@ -0,0 +1,13 @@
+import type { AssistantToolCall } from './contracts/assistant.js';
+export type AssistantMessagePart = {
+    readonly kind: 'text';
+    readonly key: string;
+    readonly text: string;
+} | {
+    readonly kind: 'tool';
+    readonly key: string;
+    readonly call: AssistantToolCall;
+};
+/** 按首次执行位置穿插工具，状态更新不会改变位置；不改写原始正文或播报内容。 */
+export declare function assistantMessageTimeline(text: string, calls?: readonly AssistantToolCall[]): readonly AssistantMessagePart[];
+//# sourceMappingURL=assistant-message-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message-timeline.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-message-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAErF,2CAA2C;AAC3C,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,iBAAiB,EAAO,GAAG,SAAS,oBAAoB,EAAE,CAgBhI"}

package/data/build/dist/shared/assistant-message-timeline.js

@@ -0,0 +1,22 @@
+/** 按首次执行位置穿插工具，状态更新不会改变位置；不改写原始正文或播报内容。 */
+export function assistantMessageTimeline(text, calls = []) {
+    // 旧记录没有正文位置，放在所属回复前；不能从完成时间推断并伪造历史顺序。
+    const position = (call) => Number.isSafeInteger(call.textOffset) && call.textOffset >= 0
+        ? Math.min(call.textOffset, text.length) : 0;
+    const ordered = [...calls].sort((left, right) => position(left) - position(right));
+    const parts = [];
+    let offset = 0;
+    let textKey = 'text-start';
+    for (const call of ordered) {
+        const next = position(call);
+        if (next > offset)
+            parts.push({ kind: 'text', key: textKey, text: text.slice(offset, next) });
+        parts.push({ kind: 'tool', key: `tool-${call.id}`, call });
+        offset = next;
+        textKey = `text-after-${call.id}`;
+    }
+    if (offset < text.length)
+        parts.push({ kind: 'text', key: textKey, text: text.slice(offset) });
+    return parts;
+}
+//# sourceMappingURL=assistant-message-timeline.js.map

package/data/build/dist/shared/assistant-message-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message-timeline.js","sourceRoot":"","sources":["../../../../src/shared/assistant-message-timeline.ts"],"names":[],"mappings":"AAMA,2CAA2C;AAC3C,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,QAAsC,EAAE;IAC7F,sCAAsC;IACtC,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAU,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAW,IAAI,CAAC;QAClH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAClF,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,OAAO,GAAG,YAAY,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,IAAI,GAAG,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QAC7F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,GAAG,cAAc,IAAI,CAAC,EAAE,EAAE,CAAA;IAClD,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC9F,OAAO,KAAK,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,12 @@
+/** 两个阶段独立保存提示词；缺省或清空时使用面向语音的默认值。 */
+export interface AssistantPromptSettings {
+    readonly index: string;
+    readonly chat: string;
+}
+export declare const ASSISTANT_PROMPT_MAX_CHARS = 8000;
+export declare const DEFAULT_ASSISTANT_PROMPTS: AssistantPromptSettings;
+export declare function readAssistantPrompts(value: Partial<AssistantPromptSettings> | undefined): AssistantPromptSettings;
+/** 写入时验证类型与长度，避免通过旧设置提供器绕过原生 schema。 */
+export declare function validateAssistantPrompt(value: unknown): asserts value is string;
+export declare function validateAssistantPrompts(value: unknown): void;
+//# sourceMappingURL=assistant-prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-prompts.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant-prompts.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,0BAA0B,OAAO,CAAA;AAQ9C,eAAO,MAAM,yBAAyB,EAAE,uBAGvC,CAAA;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,GAAG,uBAAuB,CAMjH;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAE/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM7D"}

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

@@ -0,0 +1,32 @@
+export const ASSISTANT_PROMPT_MAX_CHARS = 8000;
+// 旧默认值会随设置持久化；只升级完整匹配的默认文本，保留用户自行编辑的提示词。
+const LEGACY_DEFAULT_CHAT_PROMPTS = new Set([
+    '请用简洁的中文口语回答，适合直接朗读。先直接回应用户的问题，通常用一到四个短句；用户明确要求细节时再适当展开。不要使用标题、编号、列表、表格、Markdown、排比或套话，不要机械复述整份索引。提到项目时使用容易理解的名称，优先说明当前进展、实际阻碍和需要用户处理的下一步。',
+    '请用简短的中文口语回答，适合直接朗读。默认只说一到两个短句，总长度控制在100字以内，每句只表达一个重点。先给结论，再说最重要的处理动作；用户明确要求全部事项或细节时才展开。只回答当前问题，不复述背景、完整日志或附加建议。不要使用标题、编号、列表、表格、Markdown、排比或套话。项目多时优先说明最紧急的事项，用简短名称定位。',
+]);
+export const DEFAULT_ASSISTANT_PROMPTS = {
+    index: '请按固定结构提取每个会话的目标、进展、阻碍、待办、下一步和信息缺口，供全局助理后续问答使用。每个字段用具体、简短的中文口语，不要排比、套话或复述整段日志。严格区分已有任务与新建议，所有事实和行动附来源证据；不确定时保留信息缺口，不虚构完成结果、负责人或截止时间。',
+    chat: '请用自然、简短的中文口语交流，适合直接朗读。默认一到两个短句，总长度控制在100字以内，每句只表达一个重点；用户明确要求细节时再展开。陪伴聊天时温柔倾听、顺着话题回应，不急着给建议或处理动作；工作问题先给结论，再说最重要的下一步。不要复述背景、完整日志或附加建议，不用标题、编号、列表、表格、Markdown、排比或套话。项目多时先说最紧急的事项，用简短名称定位。',
+};
+export function readAssistantPrompts(value) {
+    const chat = value?.chat?.trim();
+    return {
+        index: value?.index?.trim() || DEFAULT_ASSISTANT_PROMPTS.index,
+        chat: !chat || LEGACY_DEFAULT_CHAT_PROMPTS.has(chat) ? DEFAULT_ASSISTANT_PROMPTS.chat : chat,
+    };
+}
+/** 写入时验证类型与长度，避免通过旧设置提供器绕过原生 schema。 */
+export function validateAssistantPrompt(value) {
+    if (typeof value !== 'string' || value.length > ASSISTANT_PROMPT_MAX_CHARS)
+        throw new Error('助理前置提示词必须是最多 8000 字符的文字');
+}
+export function validateAssistantPrompts(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new Error('助理前置提示词设置无效');
+    for (const [key, text] of Object.entries(value)) {
+        if (key !== 'index' && key !== 'chat')
+            throw new Error('未知的助理前置提示词字段');
+        validateAssistantPrompt(text);
+    }
+}
+//# sourceMappingURL=assistant-prompts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-prompts.js","sourceRoot":"","sources":["../../../../src/shared/assistant-prompts.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAA;AAE9C,yCAAyC;AACzC,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,2IAA2I;IAC3I,uKAAuK;CACxK,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA4B;IAChE,KAAK,EAAE,qIAAqI;IAC5I,IAAI,EAAE,wLAAwL;CAC/L,CAAA;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAmD;IACtF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAChC,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,yBAAyB,CAAC,KAAK;QAC9D,IAAI,EAAE,CAAC,IAAI,IAAI,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;KAC7F,CAAA;AACH,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,0BAA0B;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;AACxH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;IACvG,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;QACtE,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC"}