dsh-her 0.0.1 → 0.1.0

package/lib/core/workshop.js

@@ -0,0 +1,330 @@
+/**
+ * 形象工坊 (docs/形象工坊与多场景.md §4): a look as a project the user fills in,
+ * and the prompts and files made from it. Pure: the brain writes the files
+ * (dsh/workshop.ts), the "她" page edits the project.
+ *
+ * Prompts come in three layers:
+ * - rules: fixed, by kind (desk pet or scene);
+ * - who she is: one sentence from the character card, the same in every
+ *   image and every clip, so she stays the same person;
+ * - the action: one per clip, preset or the user's own.
+ */
+export const PROJECT_FORMAT = 'dsh-her-workshop@1';
+export const PROJECT_FILE = '形象.json';
+export const REFERENCE_FILE = '参考图.png';
+export const DESK_DIR = '桌宠';
+export const sceneDir = (scene) => `场景-${safeName(scene.name)}`;
+/** A folder or file name from what the user typed. */
+export function safeName(text) {
+    return text.trim().replace(/[\\/:*?"<>|]+/g, '-').replace(/^\.+/, '') || '未命名';
+}
+/** Choices for each field of the card ("自己写" is always possible). Ages are adults only. */
+export const CARD_CHOICES = {
+    gender: ['女', '男'],
+    age: ['二十出头', '二十多岁', '三十岁左右', '三十多岁'],
+    skin: ['白皙', '自然肤色', '小麦色', '深色'],
+    hairStyle: ['长直发', '长卷发', '中长发', '短发', '马尾', '丸子头'],
+    hairColor: ['黑色', '深棕色', '栗色', '金色', '银白色'],
+    build: ['纤细', '匀称', '健美', '丰满'],
+    outfit: ['家居服', '衬衫连衣裙', '卫衣和牛仔裤', '吊带和短裙', '西装套装', '针织衫和长裙', '汉服'],
+    accessories: ['无', '细框眼镜', '发卡', '耳环', '项链'],
+    style: ['写实照片', '日系动漫', '3D 卡通'],
+};
+export const CARD_LABELS = {
+    gender: '性别', age: '年龄', skin: '肤色', hairStyle: '发型', hairColor: '发色', build: '身材',
+    outfit: '衣服', accessories: '配饰', style: '画风', extra: '其他特征', sentence: '角色描述',
+};
+export const DEFAULT_CARD = {
+    gender: '女', age: '二十多岁', skin: '自然肤色', hairStyle: '长卷发', hairColor: '深棕色', build: '匀称',
+    outfit: '家居服', accessories: '无', style: '写实照片', extra: '', sentence: '',
+};
+/** Card fields that are about how she looks (not the art style). */
+const subject = (card) => (card.gender === '男' ? '成年男性' : card.gender === '女' ? '成年女性' : `成年人（${card.gender}）`);
+/** "二十多岁的成年女性，自然肤色，深棕色长卷发，戴细框眼镜，穿家居服，身材匀称" — or the user's own sentence. */
+export function describe(card) {
+    if (card.sentence.trim() !== '')
+        return card.sentence.trim();
+    const parts = [
+        `${card.age}的${subject(card)}`,
+        `${card.skin}皮肤`,
+        `${card.hairColor}${card.hairStyle}`,
+        ...(card.accessories === '无' || card.accessories.trim() === '' ? [] : [`戴${card.accessories}`]),
+        `穿${card.outfit}`,
+        `身材${card.build}`,
+        ...(card.extra.trim() === '' ? [] : [card.extra.trim()]),
+    ];
+    return parts.join('，');
+}
+/** The art style as words for a prompt. */
+const styleWords = (card) => (card.style === '写实照片' ? '写实摄影风格，真实皮肤质感，自然光' : card.style === '日系动漫' ? '日系动漫画风，干净线条' : card.style === '3D 卡通' ? '3D 卡通渲染风格' : card.style);
+/** Green clothes would be keyed away with the green screen: then the background is grey. */
+export function screenColor(card) {
+    return /绿/.test(`${card.outfit}${card.extra}${card.sentence}`) ? { name: '纯灰色', hex: '#808080' } : { name: '纯绿色', hex: '#00B140' };
+}
+export const POSE_WORDS = { stand: '站着', sit: '坐着', lie: '躺着' };
+const WEB_HOW = '一段段生成：上传首帧，粘贴提示词（有"负面提示词"框就把负面提示词也粘进去，有"尾帧"就也放首帧那张图），下载后按文件名存进对应的文件夹。「生成清单.md」里每段都列好了。';
+export const GENERATORS = {
+    minimax: {
+        name: 'MiniMax Code', label: 'MiniMax Code（给它任务文件，自动生成下载）',
+        settings: 'MiniMax-Hailuo-2.3 图生视频，1080P，6 秒。',
+        how: '在 MiniMax Code 里说："按 <项目文件夹>/MiniMax生成任务.md 生成"，它会一段段生成、下载、存好。',
+    },
+    comfyui: {
+        name: 'ComfyUI', label: 'ComfyUI（本地，Wan 2.2 等图生视频工作流）',
+        settings: '图生视频工作流（比如 Wan 2.2 I2V），尺寸和首帧同比例、短边 720 以上，约 5 秒（16 fps 时 81 帧），负面提示词放进负面节点，每段用同一套参数。',
+        how: '用你的图生视频工作流一段段跑，或者用脚本读「ComfyUI生成清单.json」（每段的首帧、提示词、负面提示词、保存路径）批量跑。输出存成清单里的文件名。',
+    },
+    jimeng: { name: '即梦', label: '即梦（网页 / App）', settings: '图生视频，1080P，5 秒。', how: `在即梦里${WEB_HOW}` },
+    kling: { name: '可灵', label: '可灵（网页 / App）', settings: '图生视频，1080P，5 秒。', how: `在可灵里${WEB_HOW}` },
+    hailuo: { name: '海螺 AI', label: '海螺 AI（MiniMax 的网页版）', settings: '图生视频，1080P，6 秒。', how: `在海螺 AI 里${WEB_HOW}` },
+    wanx: { name: '通义万相', label: '通义万相（网页 / 阿里云百炼）', settings: '图生视频，1080P，5 秒。', how: `在通义万相里${WEB_HOW}` },
+    vidu: { name: 'Vidu', label: 'Vidu（网页）', settings: '图生视频，1080P，4–5 秒。', how: `在 Vidu 里${WEB_HOW}` },
+};
+export const MANUAL_LABEL = '手工填写（别的工具，自己写名字和设置）';
+/** The project's tool, a custom one filled in from `custom`. */
+export function generatorInfo(project) {
+    if (project.generator !== 'manual' && project.generator in GENERATORS)
+        return GENERATORS[project.generator];
+    const name = project.custom?.name.trim() || '你用的工具';
+    const settings = project.custom?.settings.trim() || '图生视频，和首帧同比例，1080P，5–6 秒，每段用同一套设置。';
+    return { name, label: MANUAL_LABEL, settings, how: `在${name}里${WEB_HOW}` };
+}
+/** Preset actions; `{pose}` reads 站着 / 坐着 / 躺着. */
+const PRESETS = [
+    { role: 'idle', n: 1, required: true, action: '安静地{pose}，自然呼吸，偶尔眨眼，头极轻微地晃动，嘴巴闭合，浅浅地笑' },
+    { role: 'talk', n: 1, required: true, action: '看着镜头温柔地说话，嘴巴自然持续开合，轻轻点头，手有很小的动作。最后一秒闭嘴回到原姿势' },
+    { role: 'talk', n: 2, required: true, action: '看着镜头说话，换一种节奏，略带笑意，嘴巴自然持续开合，一只手轻轻抬起又放下。最后一秒闭嘴回到原姿势' },
+    { role: 'idle', n: 2, action: '安静地{pose}，轻轻把一缕头发拨到耳后，然后恢复原姿势' },
+    { role: 'listen', n: 1, action: '认真地听，嘴巴闭着，轻轻点头两次，眼神专注看着镜头' },
+    { role: 'think', n: 1, action: '眼睛看向右上方像在思考，食指轻碰下巴，然后放下手，视线回到镜头' },
+    { role: 'happy', n: 1, action: '开心地笑出来，眼睛弯起，肩膀轻微耸动，然后恢复浅笑' },
+    { role: 'shy', n: 1, action: '害羞地低头，手指卷一下发梢，再抬眼看镜头，恢复原姿势' },
+    { role: 'wave', n: 1, action: '看到你很开心，抬起右手朝镜头挥手，然后放下手恢复原姿势' },
+    { role: 'touched', n: 1, action: '像被轻轻戳了一下，微微一惊，然后看着镜头笑，恢复原姿势' },
+    { role: 'sleepy', n: 1, action: '打一个小哈欠，用手背轻揉眼睛，然后对镜头笑一下，恢复原姿势' },
+];
+/** The preset clips for a pose: the minimum ticked, the rest offered unticked. */
+export function presetClips(pose) {
+    return PRESETS.map(p => ({
+        file: `${pose}_${p.role}_${String(p.n).padStart(2, '0')}`,
+        action: p.action.replaceAll('{pose}', POSE_WORDS[pose]),
+        ...(p.required === true ? { required: true } : { off: true }),
+    }));
+}
+/** A clip of the user's own: an action name from what they typed (`<pose>_<name>_01`), not clashing with the others. */
+export function customClip(pose, existing, action) {
+    let n = 1;
+    while (existing.some(c => c.file === `${pose}_act${n}_01`))
+        n++;
+    return { file: `${pose}_act${n}_01`, action: action.trim() };
+}
+export function newProject(id, name, now = new Date()) {
+    return {
+        format: PROJECT_FORMAT, id, name, card: { ...DEFAULT_CARD },
+        desk: { on: true, clips: presetClips('stand') },
+        scenes: [],
+        generator: 'minimax',
+        createdAt: now.toISOString(),
+    };
+}
+export function newScene(id, name, pose = 'stand') {
+    return { id, name, place: '', pose, clips: presetClips(pose) };
+}
+/** Fixed rules every clip carries, for its kind and the generator. */
+export function rules(project, kind, scene) {
+    const common = [
+        '固定机位，单一连续镜头，不推拉摇移，不变焦，不切镜',
+        '脸、五官、发型、妆容、服装、身材比例全程完全不变',
+        '动作自然、克制、幅度小，真实的呼吸和眨眼',
+        '画面中不出现任何文字、字幕、水印、Logo，无背景音乐',
+        '视频开始和结束时，人物姿势与参考图完全一致',
+    ];
+    if (kind === 'desk') {
+        const color = screenColor(project.card);
+        return [`参考图中的同一位${subject(project.card)}，全身站立，${color.name}背景`, ...common,
+            `背景始终是均匀的${color.name}（${color.hex}），无地面、无阴影、无渐变、无任何物体，光照不变`,
+            '双脚始终站在原地，身体始终完整地在画面内（头顶和脚都不出画）'].join('。') + '。';
+    }
+    return [`参考图中的同一位${subject(project.card)}，在${scene?.name ?? '场景'}里${POSE_WORDS[scene?.pose ?? 'stand']}`, ...common,
+        '背景与参考图完全一致且静止，光照不变', '人物不离开原位，身体始终在画面内'].join('。') + '。';
+}
+export const NEGATIVE = '换脸, 身份漂移, 发型变化, 服装变化, 年龄变化, 多余人物, 多余手指, 手部畸形, 肢体扭曲, 脚步移动, 走出画面, 瞬移, 镜头移动, 变焦, 切镜, 背景变化, 光线闪烁, 阴影出现, 文字, 字幕, 水印, logo, 夸张表情, 卡通化, 塑料皮肤, 模糊, 低清';
+/** The full prompt of one clip: rules, who she is, the action. */
+export function clipPrompt(project, kind, clip, scene) {
+    const prefix = project.generator === 'manual' ? project.custom?.prefix.trim() ?? '' : '';
+    return `${prefix === '' ? '' : `${prefix.replace(/[，。,.\s]+$/, '')}。`}${rules(project, kind, scene)}她是：${describe(project.card)}。${clip.action}。`;
+}
+/** The reference picture: her on a plain screen, full length. It is also the desk pet's anchor. */
+export function referencePrompt(project) {
+    const color = screenColor(project.card);
+    return [
+        `${describe(project.card)}`,
+        '全身正面站立，双手自然垂在身侧，表情温和，看着镜头',
+        `${color.name}背景（${color.hex}），背景完全均匀，无地面、无阴影、无渐变、无任何物体`,
+        '人物居中，头顶和脚下各留一点空，竖版 9:16，1080×1920',
+        styleWords(project.card),
+    ].join('。') + '。';
+}
+/** A scene's full-screen photo, made with the reference picture so she stays the same person. */
+export function scenePhotoPrompt(project, scene, screen) {
+    const size = screen === undefined ? '横版 16:10，2560 宽以上' : `横版，和屏幕一样的比例，${screen.width}×${screen.height}`;
+    return [
+        `${scene.place.trim() === '' ? scene.name : scene.place.trim()}`,
+        `画面里有一位${describe(project.card)}，${POSE_WORDS[scene.pose]}，看着镜头`,
+        '用参考图保持人物完全一致（同一张脸、同样的发型和衣服）',
+        '人物完整地在画面中间偏一侧，头顶和脚下留出空间，人物高度约占画面的六成',
+        size,
+        styleWords(project.card),
+    ].join('。') + '。';
+}
+/** Every clip to make, with where it goes and its prompt. */
+export function plannedClips(project) {
+    const out = [];
+    if (project.desk.on) {
+        for (const clip of project.desk.clips.filter(c => c.off !== true)) {
+            out.push({ part: '桌宠', folder: DESK_DIR, first: REFERENCE_FILE, clip, prompt: clipPrompt(project, 'desk', clip) });
+        }
+    }
+    for (const scene of project.scenes) {
+        for (const clip of scene.clips.filter(c => c.off !== true)) {
+            out.push({ part: scene.name, folder: sceneDir(scene), first: `${sceneDir(scene)}/crop.png`, clip, prompt: clipPrompt(project, 'scene', clip, scene) });
+        }
+    }
+    return out;
+}
+/** 提示词.txt of one part (the desk pet, or a scene): every clip's prompt, ready to copy. */
+export function promptsFile(project, part) {
+    const kind = part === 'desk' ? 'desk' : 'scene';
+    const scene = part === 'desk' ? undefined : part;
+    const clips = part === 'desk' ? project.desk.clips : part.clips;
+    const first = part === 'desk' ? `上一层的 ${REFERENCE_FILE}（复制进来改名叫 anchor_stand.png 也行）` : 'crop.png（先在「她」页面里框好人物区）';
+    return [
+        `${project.name} · ${part === 'desk' ? '桌宠' : part.name} · 视频提示词`,
+        '',
+        `用${generatorInfo(project).name}：${generatorInfo(project).settings}`,
+        `首帧（和尾帧，工具支持的话）：${first}。比例和首帧一致。`,
+        '生成好的视频按下面的文件名命名（.mp4），放进这个文件夹。',
+        '',
+        `负面提示词：${NEGATIVE}`,
+        '',
+        ...clips.filter(c => c.off !== true).flatMap(c => [`${c.file}.mp4${c.required === true ? '（必须）' : ''}`, clipPrompt(project, kind, c, scene), '']),
+    ].join('\n');
+}
+/** 生成清单.md: every clip with its first frame, where it goes and its prompt, for any tool. */
+export function clipList(project, root) {
+    const tool = generatorInfo(project);
+    const lines = [
+        `# ${project.name} · 视频片段清单（${tool.name}）`,
+        '',
+        `统一设置：${tool.settings}`,
+        '提示词原样使用；首尾接不上没关系，导入时会自动处理成循环。已经有的 mp4 不用重做。',
+        '',
+        `负面提示词（工具有这个框就用）：${NEGATIVE}`,
+        '',
+    ];
+    for (const item of plannedClips(project)) {
+        lines.push(`## ${item.part} / ${item.clip.file}${item.clip.required === true ? '（必须）' : ''}`, `- 首帧：\`${root}/${item.first}\``, `- 保存到：\`${root}/${item.folder}/${item.clip.file}.mp4\``, `- 提示词：${item.prompt}`, '');
+    }
+    return lines.join('\n');
+}
+/** ComfyUI生成清单.json: the same list for a script that drives a ComfyUI workflow. */
+export function comfyuiList(project, root) {
+    return `${JSON.stringify({
+        format: 'dsh-her-clips@1',
+        settings: GENERATORS.comfyui.settings,
+        negative: NEGATIVE,
+        clips: plannedClips(project).map(item => ({
+            part: item.part, name: item.clip.file, required: item.clip.required === true,
+            image: `${root}/${item.first}`, output: `${root}/${item.folder}/${item.clip.file}.mp4`, prompt: item.prompt,
+        })),
+    }, null, 2)}\n`;
+}
+/** The task file for MiniMax Code: one uniform setting, at most 5 at a time, download as each finishes. */
+export function minimaxTask(project, root) {
+    const lines = [
+        `# ${project.name} · 视频片段生成任务（给 MiniMax Code）`,
+        '',
+        '按下面的清单生成视频，下载保存到指定路径。所有片段用完全相同的设置。',
+        '',
+        '## 统一设置',
+        '- 模型：**MiniMax-Hailuo-2.3**，图生视频，只给首帧（每段写了用哪张图）。',
+        '- 分辨率 **1080P**，时长 **6 秒**，静音，不加水印，不配乐。',
+        '- 提示词原样使用，不要改写、不要翻译、不要加任何前缀或说明。',
+        '- 首尾接不上没关系，导入时会自动处理成循环。',
+        '',
+        '## 怎么跑',
+        `- 临时文件放在 \`${root}/.minimax-work/\`，不要放进任何代码仓库。`,
+        '- 已经存在的 mp4 跳过，不要覆盖。',
+        '- 同时最多 5 个任务在生成：满了就先查询已提交的任务，**每段一完成就立刻下载**到它的保存路径（下载链接几小时后失效），腾出位置再提交下一段。',
+        '- 失败的段重试一次；还失败就记下来跳过，不要卡住。',
+        '- 除了新生成的 MP4，不要改动、删除这些文件夹里的任何文件。',
+        '- 全部结束后报告：每段成功/失败、分辨率、时长，失败的原因。',
+        '',
+        '## 清单',
+        '',
+    ];
+    for (const item of plannedClips(project)) {
+        lines.push(`### ${item.part} / ${item.clip.file}`, `- 首帧：\`${root}/${item.first}\``, `- 保存到：\`${root}/${item.folder}/${item.clip.file}.mp4\``, `- 提示词：${item.prompt}`, '');
+    }
+    return lines.join('\n');
+}
+/** An age that is clearly grown up: 二十多岁, 三十岁左右, 25 岁, 成年 … */
+export function isAdult(age) {
+    if (/成年|二十|三十|四十|五十|六十|七十/.test(age))
+        return true;
+    const years = [...age.matchAll(/(\d{1,3})\s*岁?/g)].map(m => Number(m[1]));
+    return years.length > 0 && years.every(n => n >= 18);
+}
+/** Check a project read from disk or sent by the page. */
+export function validateProject(value) {
+    const p = value;
+    if (typeof p !== 'object' || p === null || p.format !== PROJECT_FORMAT)
+        throw new Error('不是形象工坊的项目');
+    if (typeof p.id !== 'string' || !/^[a-z0-9-]{1,40}$/.test(p.id))
+        throw new Error('项目 id 不对');
+    if (typeof p.name !== 'string' || p.name.trim() === '')
+        throw new Error('先给形象起个名字');
+    if (typeof p.card !== 'object' || p.card === null)
+        throw new Error('缺少角色卡');
+    for (const key of Object.keys(DEFAULT_CARD)) {
+        if (typeof p.card[key] !== 'string')
+            throw new Error(`角色卡缺少「${CARD_LABELS[key]}」`);
+    }
+    if (!isAdult(p.card.age))
+        throw new Error('年龄只能是成年人（比如"二十多岁"或"25 岁"）');
+    if (!Array.isArray(p.scenes) || typeof p.desk !== 'object' || !Array.isArray(p.desk?.clips))
+        throw new Error('项目内容不完整');
+    if (!p.desk.on && p.scenes.length === 0)
+        throw new Error('桌宠和场景至少要有一个');
+    if (p.generator !== 'manual' && !(p.generator in GENERATORS))
+        throw new Error('不认识这个生成工具');
+    if (p.custom !== undefined && (typeof p.custom !== 'object' || p.custom === null || [p.custom.name, p.custom.settings, p.custom.prefix].some(v => typeof v !== 'string')))
+        throw new Error('手工填写的工具信息不对');
+    const names = new Set();
+    for (const scene of p.scenes) {
+        if (typeof scene.id !== 'string' || typeof scene.name !== 'string' || scene.name.trim() === '' || !Array.isArray(scene.clips))
+            throw new Error('场景要有名字');
+        if (names.has(sceneDir(scene)))
+            throw new Error(`有两个场景都叫「${scene.name}」`);
+        names.add(sceneDir(scene));
+    }
+    return p;
+}
+/**
+ * Example pictures and clips each card shows, by file name under
+ * `examples/workshop/` (in the plugin; a file of the same name in
+ * `<home>/examples/workshop/` wins). A missing one shows as a placeholder
+ * naming the file, until the finished showroom's material is put there.
+ */
+export const EXAMPLE_SLOTS = {
+    look: [{ file: 'look.png', label: '做好的她（角色卡这样填出来的样子）' }],
+    reference: [{ file: 'reference.png', label: '参考图：纯色背景、全身、正面站立' }],
+    desk: [{ file: 'desk.mp4', label: '桌宠片段（绿幕原片）' }, { file: 'desk-keyed.png', label: '抠好后浮在桌面上' }],
+    scene: [
+        { file: 'scene-plate.png', label: '场景的全屏照片' },
+        { file: 'scene-crop.png', label: '框好的人物区（crop.png）' },
+        { file: 'scene.mp4', label: '场景片段' },
+    ],
+    import: [{ file: 'result.png', label: '导入后桌面上的样子' }],
+};
+export const EXAMPLE_FILES = new Set(Object.values(EXAMPLE_SLOTS).flatMap(slots => slots.map(s => s.file)));

package/lib/dsh/api.js

@@ -0,0 +1,156 @@
+/**
+ * HTTP endpoints for the "她" page, on DSH's own authenticated `/api` channel
+ * (`ctx.connection.fetch`), so every request has already passed DSH's browser
+ * authentication before it gets here.
+ *
+ * Every endpoint is POST with a JSON body and answers `{ ok: true, … }` or
+ * `{ ok: false, message }`. The page polls `/state`; changes answer with the
+ * fresh state, so the page never shows something the brain does not have.
+ */
+export const API_BASE = '/api/dsh-her';
+class ApiError extends Error {
+}
+const str = (v, name) => {
+    if (typeof v !== 'string')
+        throw new ApiError(`${name} 不对`);
+    return v;
+};
+const num = (v, name) => {
+    const n = Number(v);
+    if (!Number.isFinite(n))
+        throw new ApiError(`${name} 不对`);
+    return n;
+};
+const ids = (v) => (Array.isArray(v) ? v.map(String).filter(Boolean) : []);
+const MODES = new Set(['overlay', 'wallpaper', 'window']);
+export function apiHandlers(rt) {
+    const withState = (extra = {}) => ({ ...extra, state: rt.state() });
+    return {
+        '/state': async () => withState(),
+        '/character': async (body) => {
+            const patch = {};
+            if (body.name !== undefined)
+                patch.name = str(body.name, '名字').trim();
+            if (body.persona !== undefined)
+                patch.persona = str(body.persona, '人设').trim();
+            if (body.callYou !== undefined)
+                patch.callYou = str(body.callYou, '称呼').trim();
+            if (body.pronoun !== undefined) {
+                const p = str(body.pronoun, '人称');
+                if (p !== '他' && p !== '她' && p !== 'TA')
+                    throw new ApiError('人称只能是 他 / 她 / TA');
+                patch.pronoun = p;
+            }
+            if (body.voice !== undefined || body.speed !== undefined) {
+                const current = rt.state().character.voice;
+                patch.voice = { id: body.voice === undefined ? current.id : str(body.voice, '音色'), speed: body.speed === undefined ? current.speed : num(body.speed, '语速') };
+            }
+            if (body.onboarded !== undefined)
+                patch.onboarded = body.onboarded === true;
+            if (body.model !== undefined) {
+                if (body.model === null)
+                    patch.model = undefined;
+                else {
+                    const m = body.model;
+                    patch.model = { provider: str(m.provider, '模型'), model: str(m.model, '模型'), ...(m.effort ? { effort: str(m.effort, '思考强度') } : {}) };
+                }
+            }
+            rt.saveCharacter(patch);
+            return withState();
+        },
+        '/persona/expand': async (body) => ({
+            persona: await rt.expandPersona({ name: str(body.name, '名字'), idea: str(body.idea, '描述'), callYou: str(body.callYou ?? '', '称呼'), pronoun: str(body.pronoun ?? '他', '人称') }),
+        }),
+        '/persona/try': async (body) => ({
+            reply: await rt.tryPersona({
+                name: str(body.name, '名字'), persona: str(body.persona, '人设'), callYou: str(body.callYou ?? '', '称呼'), pronoun: str(body.pronoun ?? '他', '人称'),
+                history: Array.isArray(body.history) ? body.history.slice(-6) : [],
+                message: str(body.message, '消息'),
+            }),
+        }),
+        '/voice/preview': async (body) => rt.previewVoice(str(body.voice, '音色'), num(body.speed ?? 1, '语速'), str(body.text ?? '你好呀，我在你桌面上等你好久啦。', '试听的话')),
+        '/body/start': async () => withState({ message: rt.startBody() }),
+        '/body/mode': async (body) => {
+            const mode = str(body.mode, '模式');
+            if (!MODES.has(mode))
+                throw new ApiError('模式不对');
+            rt.setMode(mode);
+            return withState();
+        },
+        '/pack/pick': async () => {
+            rt.pickPack();
+            return withState();
+        },
+        '/pack/use': async (body) => {
+            rt.usePack(str(body.packId, '外形包'));
+            return withState();
+        },
+        '/look/set': async (body) => {
+            const change = {};
+            if (typeof body.auto === 'boolean')
+                change.auto = body.auto;
+            if (typeof body.locked === 'boolean')
+                change.locked = body.locked;
+            if (typeof body.go === 'string')
+                change.go = body.go;
+            if (typeof body.on === 'object' && body.on !== null) {
+                change.on = Object.fromEntries(Object.entries(body.on).filter(([, v]) => typeof v === 'boolean'));
+            }
+            rt.setLook(change);
+            return withState();
+        },
+        '/body/install': async () => {
+            rt.installBody();
+            return withState();
+        },
+        '/body/restart': async () => {
+            await rt.restartBody();
+            return withState();
+        },
+        '/workshop/list': async () => ({ projects: rt.workshopList() }),
+        '/workshop/new': async (body) => rt.workshopNew(str(body.name, '名字').trim()),
+        '/workshop/save': async (body) => rt.workshopSave(body.project),
+        '/workshop/export': async (body) => (await rt.workshopExport(str(body.id, '项目'), body.media === true)) ?? { cancelled: true },
+        '/workshop/import-project': async () => (await rt.workshopImportProject()) ?? { cancelled: true },
+        '/workshop/examples': async () => ({ examples: rt.workshopExamples() }),
+        '/workshop/open': async (body) => {
+            rt.workshopOpen(str(body.id, '项目'));
+            return {};
+        },
+        '/workshop/frame': async (body) => {
+            rt.workshopFrame(str(body.id, '项目'), str(body.scene, '场景'));
+            return {};
+        },
+        '/workshop/import': async (body) => {
+            rt.workshopImport(str(body.id, '项目'));
+            return withState();
+        },
+        '/memory/remove': async (body) => withState({ removed: rt.memoryRemove(ids(body.ids)) }),
+        '/memory/confirm': async (body) => withState({ confirmed: rt.memoryConfirm(ids(body.ids)) }),
+        '/memory/digest': async () => withState({ report: await rt.digest() }),
+        '/memory/export': async () => ({ markdown: rt.exportMemory() }),
+    };
+}
+function json(status, value) {
+    return new Response(JSON.stringify(value), {
+        status,
+        headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' },
+    });
+}
+export async function handle(handler, request) {
+    let body = {};
+    try {
+        const text = await request.text();
+        body = text === '' ? {} : JSON.parse(text);
+    }
+    catch {
+        return json(400, { ok: false, message: '请求不是 JSON' });
+    }
+    try {
+        return json(200, { ok: true, ...(await handler(body)) });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return json(error instanceof ApiError ? 400 : 500, { ok: false, message });
+    }
+}

package/lib/dsh/body-install.js

@@ -0,0 +1,137 @@
+/**
+ * The installed body: downloaded from the release (body/scripts/package.mjs
+ * makes it), checked, unpacked into `<home>/body/<version>/`, and kept up to
+ * date. The release has `body-latest.json`:
+ *
+ *   { "format": "dsh-her-body@1", "version": "0.1.0",
+ *     "assets": { "darwin-arm64": { "file": "dsh-her-body-0.1.0-darwin-arm64.zip", "size": …, "sha256": "…" } } }
+ *
+ * `<home>/body/current.json` says which version is installed. A download
+ * that does not match its SHA-256 is thrown away; the previous version stays
+ * until the new one is in place, and one older version is kept to go back to.
+ */
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { promisify } from 'node:util';
+const run = promisify(execFile);
+export const MANIFEST = 'body-latest.json';
+const APP = 'dsh-her.app';
+/** This computer's asset key in the manifest. */
+export const platformKey = (platform = process.platform, arch = process.arch) => `${platform}-${arch}`;
+/** -1, 0, 1: "0.1.0-dev.0" < "0.1.0" < "0.1.1" < "0.2.0". */
+export function compareVersions(a, b) {
+    const parse = (v) => {
+        const [main = '', pre] = v.split('-', 2);
+        return { nums: main.split('.').map(n => Number.parseInt(n, 10) || 0), pre };
+    };
+    const x = parse(a);
+    const y = parse(b);
+    for (let i = 0; i < Math.max(x.nums.length, y.nums.length); i++) {
+        const d = (x.nums[i] ?? 0) - (y.nums[i] ?? 0);
+        if (d !== 0)
+            return Math.sign(d);
+    }
+    if (x.pre === y.pre)
+        return 0;
+    if (x.pre === undefined)
+        return 1;
+    if (y.pre === undefined)
+        return -1;
+    return x.pre < y.pre ? -1 : 1;
+}
+export function validateManifest(value) {
+    const m = value;
+    if (typeof m !== 'object' || m === null || m.format !== 'dsh-her-body@1' || typeof m.version !== 'string' || typeof m.assets !== 'object' || m.assets === null) {
+        throw new Error('发布里的 body-latest.json 不对');
+    }
+    for (const asset of Object.values(m.assets)) {
+        if (typeof asset?.file !== 'string' || !/^[\w.-]+\.zip$/.test(asset.file) || typeof asset.size !== 'number' || !/^[0-9a-f]{64}$/.test(asset.sha256)) {
+            throw new Error('发布里的 body-latest.json 有一项不对');
+        }
+    }
+    return m;
+}
+const bodyRoot = (home) => join(home, 'body');
+export function installedBody(home) {
+    try {
+        const current = JSON.parse(readFileSync(join(bodyRoot(home), 'current.json'), 'utf8'));
+        return existsSync(current.app) ? current : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** How to start the installed body. */
+export function installedPlan(home) {
+    const installed = installedBody(home);
+    if (installed === undefined)
+        return undefined;
+    if (process.platform === 'darwin')
+        return { binary: join(installed.app, 'Contents', 'MacOS', 'Electron'), args: [], cwd: join(installed.app, '..') };
+    return undefined;
+}
+/** `base` + file: the release's download address ends with a slash, or the file is appended after one. */
+const at = (base, file) => `${base.replace(/\/?$/, '/')}${file}`;
+export async function fetchManifest(base) {
+    const res = await fetch(at(base, MANIFEST), { redirect: 'follow', signal: AbortSignal.timeout(20_000) });
+    if (!res.ok)
+        throw new Error(`读不到发布信息（${res.status}）：${at(base, MANIFEST)}`);
+    return validateManifest(await res.json());
+}
+/**
+ * Download this computer's asset of `manifest`, check it, unpack it next to
+ * the installed version and make it current. Progress in bytes.
+ */
+export async function install(home, base, manifest, onProgress) {
+    if (process.platform !== 'darwin')
+        throw new Error('这个系统的身体程序还没有发布（现在只有 macOS 版）');
+    const asset = manifest.assets[platformKey()];
+    if (asset === undefined)
+        throw new Error(`发布里没有这台电脑（${platformKey()}）的身体程序`);
+    const root = bodyRoot(home);
+    const downloads = join(root, 'download');
+    mkdirSync(downloads, { recursive: true });
+    const zip = join(downloads, asset.file);
+    const res = await fetch(at(base, asset.file), { redirect: 'follow' });
+    if (!res.ok || res.body === null)
+        throw new Error(`下载失败（${res.status}）`);
+    const hash = createHash('sha256');
+    let done = 0;
+    const counted = Readable.fromWeb(res.body).on('data', (chunk) => {
+        hash.update(chunk);
+        done += chunk.length;
+        onProgress(done, asset.size);
+    });
+    await pipeline(counted, createWriteStream(`${zip}.part`));
+    if (done !== asset.size || hash.digest('hex') !== asset.sha256) {
+        rmSync(`${zip}.part`, { force: true });
+        throw new Error('下载的文件校验不对（可能没下完或被改过），已经删掉，再试一次');
+    }
+    renameSync(`${zip}.part`, zip);
+    const target = join(root, manifest.version);
+    const unpacking = `${target}.unpacking`;
+    rmSync(unpacking, { recursive: true, force: true });
+    mkdirSync(unpacking, { recursive: true });
+    // ditto keeps the app's symlinks, permissions and signature.
+    await run('ditto', ['-x', '-k', zip, unpacking], { timeout: 300_000 });
+    if (!existsSync(join(unpacking, APP)))
+        throw new Error('下载的包里没有身体程序');
+    rmSync(target, { recursive: true, force: true });
+    renameSync(unpacking, target);
+    rmSync(zip, { force: true });
+    const previous = installedBody(home);
+    const installed = { version: manifest.version, app: join(target, APP), installedAt: new Date().toISOString() };
+    writeFileSync(join(root, 'current.json.tmp'), `${JSON.stringify(installed, null, 2)}\n`);
+    renameSync(join(root, 'current.json.tmp'), join(root, 'current.json'));
+    // Keep this version and the one before it; older ones go.
+    for (const entry of readdirSync(root)) {
+        const keep = entry === manifest.version || entry === previous?.version || entry === 'download' || entry.endsWith('.json');
+        if (!keep)
+            rmSync(join(root, entry), { recursive: true, force: true });
+    }
+    return installed;
+}