dsh-her 0.0.1 → 0.1.0

package/lib/dsh/workshop.js

@@ -0,0 +1,222 @@
+/**
+ * 形象工坊 on disk: each project is a folder under `~/Documents/dsh-her 素材`
+ * (where the user can see it and drop files in), with
+ *
+ *   形象.json              the project (character card, scenes, clips)
+ *   参考图提示词.txt        how to make 参考图.png, her "ID photo"
+ *   参考图.png             (the user's) — also the desk pet's anchor
+ *   生成清单.md            every clip: first frame, file, prompt
+ *   MiniMax生成任务.md      the same, as a task for MiniMax Code (when that is the tool)
+ *   ComfyUI生成清单.json    the same, for a ComfyUI script (when that is the tool)
+ *   桌宠/提示词.txt         + the desk pet's clips
+ *   场景-卧室/提示词.txt     + 照片提示词.txt, plate.png, scene.json, crop.png, clips
+ *
+ * The prompts are rewritten on every save; the user's pictures and clips are
+ * never touched. Importing hands the folders to the body (same computer).
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { clipList, comfyuiList, DESK_DIR, EXAMPLE_FILES, EXAMPLE_SLOTS, minimaxTask, PROJECT_FILE, promptsFile, REFERENCE_FILE, referencePrompt, safeName, sceneDir, scenePhotoPrompt, validateProject, } from "../core/workshop.js";
+export const MATERIALS_DIR = join(homedir(), 'Documents', 'dsh-her 素材');
+function readProject(dir) {
+    try {
+        return validateProject(JSON.parse(readFileSync(join(dir, PROJECT_FILE), 'utf8')));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Every project in the materials folder, newest first. */
+export function listProjects(root = MATERIALS_DIR) {
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(root)) {
+        if (entry.startsWith('.'))
+            continue;
+        const dir = join(root, entry);
+        const project = readProject(dir);
+        if (project !== undefined)
+            out.push({ project, status: projectStatus(project, dir) });
+    }
+    return out.sort((a, b) => b.project.createdAt.localeCompare(a.project.createdAt));
+}
+export function findProject(id, root = MATERIALS_DIR) {
+    const found = listProjects(root).find(p => p.project.id === id);
+    return found === undefined ? undefined : { project: found.project, dir: found.status.dir };
+}
+const has = (dir, file) => existsSync(join(dir, file));
+export function projectStatus(project, dir) {
+    const parts = [];
+    const count = (folder, clips) => {
+        const planned = clips.filter(c => c.off !== true);
+        const made = planned.filter(c => has(join(dir, folder), `${c.file}.mp4`));
+        const enough = clips.filter(c => c.required === true).every(c => has(join(dir, folder), `${c.file}.mp4`));
+        return { planned: planned.length, made: made.length, enough };
+    };
+    if (project.desk.on)
+        parts.push({ name: '桌宠', folder: DESK_DIR, ...count(DESK_DIR, project.desk.clips) });
+    for (const scene of project.scenes) {
+        const folder = sceneDir(scene);
+        const photo = ['plate.png', 'plate.jpg'].some(f => has(join(dir, folder), f));
+        const framed = has(join(dir, folder), 'scene.json') && has(join(dir, folder), 'crop.png');
+        parts.push({ name: scene.name, folder, ...count(folder, scene.clips), photo, framed });
+    }
+    const reference = has(dir, REFERENCE_FILE);
+    return { dir, reference, parts, importable: parts.some(p => p.enough && p.framed !== false && (p.folder !== DESK_DIR || reference || has(join(dir, DESK_DIR), 'anchor_stand.png'))) };
+}
+/**
+ * Write a project: its folder (made on first save, named after it), 形象.json
+ * and every prompt file. Pictures and clips already there stay as they are.
+ */
+export function saveProject(input, screen, root = MATERIALS_DIR) {
+    const project = validateProject(input);
+    const existing = findProject(project.id, root);
+    let dir = existing?.dir;
+    if (dir === undefined) {
+        const base = safeName(project.name);
+        dir = join(root, existsSync(join(root, base)) ? `${base}-${project.id}` : base);
+    }
+    mkdirSync(dir, { recursive: true });
+    const write = (file, text) => {
+        writeFileSync(`${file}.tmp`, text);
+        renameSync(`${file}.tmp`, file);
+    };
+    write(join(dir, PROJECT_FILE), `${JSON.stringify(project, null, 2)}\n`);
+    write(join(dir, '参考图提示词.txt'), [
+        `${project.name} · 参考图（她的"身份证"）`,
+        '',
+        `用文生图工具（豆包、即梦等）生成，存成 ${REFERENCE_FILE} 放在这个文件夹里。之后每个场景的照片都要把它当参考图，她才是同一个人。`,
+        '',
+        referencePrompt(project),
+        '',
+    ].join('\n'));
+    write(join(dir, '生成清单.md'), clipList(project, dir));
+    // The tool's own task file; another tool's, left from before, goes.
+    const taskFiles = [['MiniMax生成任务.md', 'minimax', minimaxTask], ['ComfyUI生成清单.json', 'comfyui', comfyuiList]];
+    for (const [file, generator, make] of taskFiles) {
+        if (project.generator === generator)
+            write(join(dir, file), make(project, dir));
+        else
+            rmSync(join(dir, file), { force: true });
+    }
+    if (project.desk.on) {
+        mkdirSync(join(dir, DESK_DIR), { recursive: true });
+        write(join(dir, DESK_DIR, '提示词.txt'), promptsFile(project, 'desk'));
+    }
+    for (const scene of project.scenes) {
+        const folder = join(dir, sceneDir(scene));
+        mkdirSync(folder, { recursive: true });
+        write(join(folder, '照片提示词.txt'), [
+            `${project.name} · ${scene.name} · 全屏照片`,
+            '',
+            `用文生图工具生成，把上一层的 ${REFERENCE_FILE} 放进"参考图 / 保持人物一致"。存成 plate.png 放在这个文件夹，然后在「她」页面的形象工坊里点"框人物区"。`,
+            '',
+            scenePhotoPrompt(project, scene, screen),
+            '',
+        ].join('\n'));
+        write(join(folder, '提示词.txt'), promptsFile(project, scene));
+    }
+    return { project, status: projectStatus(project, dir) };
+}
+/** Before importing: the desk pet's anchor is the reference picture. */
+export function prepareImport(project, dir) {
+    if (project.desk.on && has(dir, REFERENCE_FILE) && !has(join(dir, DESK_DIR), 'anchor_stand.png')) {
+        copyFileSync(join(dir, REFERENCE_FILE), join(dir, DESK_DIR, 'anchor_stand.png'));
+    }
+}
+/** The settings of a project: what export copies without "pictures and videos". */
+const SETTINGS = new Set(['.json', '.txt', '.md']);
+/** Every file of a folder (relative paths), skipping MiniMax's scratch and hidden files. */
+function filesOf(dir, prefix = '') {
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith('.'))
+            continue;
+        const path = join(dir, entry);
+        if (statSync(path).isDirectory())
+            out.push(...filesOf(path, `${prefix}${entry}/`));
+        else
+            out.push(prefix + entry);
+    }
+    return out;
+}
+/** A folder name in `parent` that is not taken yet: name, name-2, name-3 … */
+function freeDir(parent, name) {
+    let dir = join(parent, name);
+    for (let n = 2; existsSync(dir); n++)
+        dir = join(parent, `${name}-${n}`);
+    return dir;
+}
+/**
+ * Copy a project to another folder (`dest`/<its name>): its settings
+ * (形象.json, the prompts, scene.json), and with `media` its pictures and
+ * clips too. The copy can be imported anywhere with importProject.
+ */
+export function exportProject(id, dest, media, root = MATERIALS_DIR) {
+    const found = findProject(id, root);
+    if (found === undefined)
+        throw new Error('找不到这个项目');
+    if (resolve(dest).startsWith(resolve(found.dir)))
+        throw new Error('不能导出到项目自己的文件夹里');
+    const dir = freeDir(dest, basename(found.dir));
+    let files = 0;
+    for (const file of filesOf(found.dir)) {
+        if (!media && !SETTINGS.has(extname(file).toLowerCase()))
+            continue;
+        mkdirSync(dirname(join(dir, file)), { recursive: true });
+        copyFileSync(join(found.dir, file), join(dir, file));
+        files++;
+    }
+    return { dir, files };
+}
+/**
+ * Bring a project in from elsewhere: a folder with 形象.json in it, or the
+ * 形象.json itself. It becomes a new project in the materials folder (a new
+ * id if one with its id is there already), with whatever pictures and clips
+ * came along; the prompts are written afresh.
+ */
+export function importProject(path, screen, root = MATERIALS_DIR) {
+    const source = statSync(path).isDirectory() ? path : dirname(path);
+    const file = statSync(path).isDirectory() ? join(path, PROJECT_FILE) : path;
+    if (!existsSync(file))
+        throw new Error(`这个文件夹里没有 ${PROJECT_FILE}`);
+    let project;
+    try {
+        project = validateProject(JSON.parse(readFileSync(file, 'utf8')));
+    }
+    catch (error) {
+        throw new Error(`${basename(file)} 读不懂：${error.message}`);
+    }
+    const existing = findProject(project.id, root);
+    if (existing !== undefined && resolve(existing.dir) === resolve(source))
+        throw new Error('这个项目已经在形象工坊里了');
+    if (existing !== undefined)
+        project = { ...project, id: `p${Date.now().toString(36)}` };
+    mkdirSync(root, { recursive: true });
+    const dir = freeDir(root, safeName(project.name));
+    for (const name of filesOf(source)) {
+        if (name === PROJECT_FILE)
+            continue;
+        mkdirSync(dirname(join(dir, name)), { recursive: true });
+        copyFileSync(join(source, name), join(dir, name));
+    }
+    writeFileSync(join(dir, PROJECT_FILE), `${JSON.stringify(project, null, 2)}\n`);
+    return saveProject(project, screen, root);
+}
+/** Where examples are looked for: the user's own first, then the plugin's. */
+export function exampleDirs(home) {
+    return [join(home, 'examples', 'workshop'), fileURLToPath(new URL('../../examples/workshop/', import.meta.url))];
+}
+/** The file to serve for an example slot, if it has been put in place. */
+export function exampleFile(home, file) {
+    if (!EXAMPLE_FILES.has(file))
+        return undefined;
+    return exampleDirs(home).map(d => join(d, file)).find(f => existsSync(f));
+}
+/** Every card's example slots and whether each is there yet. */
+export function examples(home) {
+    return Object.entries(EXAMPLE_SLOTS).flatMap(([card, slots]) => slots.map(slot => ({ card, ...slot, ready: exampleFile(home, slot.file) !== undefined })));
+}

package/lib/index.js

@@ -0,0 +1,11 @@
+/**
+ * dsh-her — a desktop companion for DSH.
+ *
+ * The brain lives here: her own DSH session, voice, memory, and the body
+ * protocol server. The body (the Electron desktop app) lives in `body/`.
+ * `src/core` never imports DSH; `src/dsh` is the only layer that does.
+ */
+export const name = 'dsh-her';
+export const usage = 'dsh-her: a desktop companion who lives on your real desktop, talks by voice and remembers you. /her talks to her.';
+export { Config } from "./dsh/config.js";
+export { apply } from "./dsh/plugin.js";

package/lib/memory/digest.js

@@ -0,0 +1,119 @@
+/**
+ * The daily digest: once a day, the day's conversation is read back from her
+ * DSH session and a model writes her diary page and picks out what is worth
+ * keeping. This file is the pure part: the transcript, the prompt, and a
+ * forgiving parser for the model's JSON.
+ */
+const MAX_CHARS = 12_000;
+/** Events of her session within one local day, as "you" / "her" lines. Context notes and tags are left out. */
+export function transcriptOf(events, dayStart, dayEnd) {
+    const lines = [];
+    for (const event of events) {
+        const time = event.time ?? 0;
+        if (time < dayStart || time >= dayEnd)
+            continue;
+        if (event.type === 'user/message') {
+            const data = event.data;
+            // Barge-in notes and other context she was given are not things you said.
+            if (data.source?.kind === 'dsh-her-context')
+                continue;
+            const text = (data.content ?? []).filter(b => b.type === 'text').map(b => b.text ?? '').join('').trim();
+            if (text !== '')
+                lines.push({ who: 'you', text, time });
+        }
+        else if (event.type === 'assistant/message') {
+            const data = event.data;
+            const text = (data.message?.content ?? []).filter(b => b.type === 'text').map(b => b.text ?? '').join('').replace(/〔[^〕]*〕/g, '').trim();
+            if (text !== '')
+                lines.push({ who: 'her', text, time });
+        }
+    }
+    // Keep the end of a long day.
+    let total = 0;
+    const kept = [];
+    for (const line of [...lines].reverse()) {
+        total += line.text.length + 4;
+        if (total > MAX_CHARS)
+            break;
+        kept.unshift(line);
+    }
+    return kept;
+}
+export function digestPrompt(name, day, transcript, knownFacts, knownEvents = [], pronoun = '他') {
+    const p = pronoun;
+    const system = [
+        `你是"${name}"，正在睡前整理今天和对方的聊天，写日记，并记下以后用得上的事。提到对方时用"${p}"。`,
+        '只输出一个 JSON 对象，不要任何别的文字：',
+        '{"diary": "第一人称、你自己的口吻，写今天和对方之间发生了什么、你的感受，100 到 200 字",',
+        ` "facts": [{"text": "关于对方的新事实，一句话，比如「${p}不吃香菜」", "sensitive": false}],`,
+        ' "episodes": [{"text": "以后值得提起的具体事情，一句话", "due": "YYYY-MM-DD，有具体日期才写"}]}',
+        '规则：',
+        '- facts 只写关于对方的、长期成立的事（称呼、喜好、忌讳、重要的人、生日）；已经知道的不要重复；没有就给空数组。',
+        '- 涉及健康、钱、证件、他人隐私的事实，sensitive 写 true。',
+        `- episodes 写具体的事（比如"${p}下周三去面试"），把"明天""下周三"换算成具体日期；已经记下的不要重复；没有就给空数组。`,
+        '- 只根据聊天记录，不要编造。',
+    ].join('\n');
+    const user = [
+        `今天是 ${day}。`,
+        knownFacts.length === 0 ? '已经知道的关于对方的事：（还没有）' : `已经知道的关于对方的事：\n${knownFacts.map(f => `- ${f}`).join('\n')}`,
+        knownEvents.length === 0 ? '' : `已经记下的事件：\n${knownEvents.map(e => `- ${e}`).join('\n')}`,
+        '',
+        '今天的聊天：',
+        ...transcript.map(l => `${l.who === 'you' ? '对方' : '我'}：${l.text}`),
+    ].join('\n');
+    return { system, user };
+}
+/**
+ * Right after a talk: what in these few turns is worth keeping, so it shows
+ * on the "她记得的事" page at once (the diary still waits for the day's digest).
+ * Same answer shape as the digest, without the diary; parseDigest reads it.
+ */
+export function notePrompt(name, day, transcript, knownFacts, knownEvents = [], pronoun = '他') {
+    const p = pronoun;
+    const system = [
+        `你是"${name}"，刚和对方聊完几句，正在把以后用得上的事记到小本子上。提到对方时用"${p}"。`,
+        '只输出一个 JSON 对象，不要任何别的文字：',
+        ` {"facts": [{"text": "关于对方的新事实，一句话，比如「${p}不吃香菜」", "sensitive": false}],`,
+        '  "episodes": [{"text": "以后值得提起的具体事情，一句话", "due": "YYYY-MM-DD，有具体日期才写"}]}',
+        '规则：',
+        '- facts 只写关于对方的、长期成立的事（称呼、喜好、忌讳、工作和生活、重要的人、生日）；已经知道的不要重复；没有就给空数组。',
+        '- 涉及健康、钱、证件、他人隐私的事实，sensitive 写 true。',
+        `- episodes 写具体的事（比如"${p}下周三去面试""${p}今晚吃了番茄炒蛋"），把"明天""下周三"换算成具体日期；已经记下的不要重复；没有就给空数组。`,
+        '- 客套话、闲聊里没有信息的不记。只根据这段聊天，不要编造。',
+    ].join('\n');
+    const user = [
+        `今天是 ${day}。`,
+        knownFacts.length === 0 ? '已经知道的关于对方的事：（还没有）' : `已经知道的关于对方的事：\n${knownFacts.map(f => `- ${f}`).join('\n')}`,
+        knownEvents.length === 0 ? '' : `已经记下的事件：\n${knownEvents.map(e => `- ${e}`).join('\n')}`,
+        '',
+        '刚才的聊天：',
+        ...transcript.map(l => `${l.who === 'you' ? '对方' : '我'}：${l.text}`),
+    ].join('\n');
+    return { system, user };
+}
+/** The first JSON object in the model's answer, checked and cleaned; undefined if there is none. */
+export function parseDigest(answer) {
+    const start = answer.indexOf('{');
+    const end = answer.lastIndexOf('}');
+    if (start < 0 || end <= start)
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(answer.slice(start, end + 1));
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const v = value;
+    const list = (x) => (Array.isArray(x) ? x.filter((i) => typeof i === 'object' && i !== null && typeof i.text === 'string') : []);
+    return {
+        diary: typeof v.diary === 'string' ? v.diary : '',
+        facts: list(v.facts).map(f => ({ text: String(f.text).trim(), sensitive: f.sensitive === true })),
+        episodes: list(v.episodes).map(e => ({
+            text: String(e.text).trim(),
+            ...(typeof e.due === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(e.due) ? { due: e.due } : {}),
+        })),
+    };
+}

package/lib/memory/search.js

@@ -0,0 +1,52 @@
+/**
+ * Recall without embeddings (docs/内置记忆.md §3): Chinese is cut into
+ * character bigrams (single characters for one-character runs), Latin text
+ * into lowercase words, scored with BM25, and newer memories weigh a little
+ * more. DeepSeek offers no embedding API and a local embedding model would
+ * add hundreds of MB, so this is enough for one person's memories.
+ */
+const K1 = 1.2;
+const B = 0.75;
+/** A memory this many days old counts half as much as one from today. */
+const HALF_LIFE_DAYS = 60;
+export function tokens(text) {
+    const out = [];
+    for (const run of text.toLowerCase().match(/[\p{Script=Han}]+|[\p{L}\p{N}]+/gu) ?? []) {
+        if (/^\p{Script=Han}+$/u.test(run)) {
+            const chars = [...run];
+            if (chars.length === 1)
+                out.push(run);
+            for (let i = 0; i + 1 < chars.length; i++)
+                out.push(chars[i] + chars[i + 1]);
+        }
+        else {
+            out.push(run);
+        }
+    }
+    return out;
+}
+export function search(docs, query, now, limit = 5) {
+    const terms = [...new Set(tokens(query))];
+    if (terms.length === 0 || docs.length === 0)
+        return [];
+    const docTokens = docs.map(d => tokens(d.text));
+    const avg = docTokens.reduce((sum, t) => sum + t.length, 0) / docs.length || 1;
+    const df = new Map(terms.map(t => [t, docTokens.filter(toks => toks.includes(t)).length]));
+    const scored = docs.map((doc, i) => {
+        const toks = docTokens[i];
+        let score = 0;
+        for (const term of terms) {
+            const n = df.get(term);
+            if (n === 0)
+                continue;
+            const tf = toks.filter(t => t === term).length;
+            if (tf === 0)
+                continue;
+            const idf = Math.log(1 + (docs.length - n + 0.5) / (n + 0.5));
+            score += idf * ((tf * (K1 + 1)) / (tf + K1 * (1 - B + (B * toks.length) / avg)));
+        }
+        const ageDays = Math.max(0, (now - doc.at) / 86_400_000);
+        return { ...doc, score: score * (0.5 + 0.5 * 2 ** (-ageDays / HALF_LIFE_DAYS)) };
+    });
+    return scored.filter(d => d.score > 0).sort((a, b) => b.score - a.score).slice(0, limit);
+}

package/lib/memory/store.js

@@ -0,0 +1,267 @@
+/**
+ * Her built-in memory (docs/内置记忆.md): plain files under
+ * `<home>/characters/<cid>/memory/`, readable and editable by hand.
+ *
+ * - facts.json     about you: name, likes, dislikes, people, dates. Facts she
+ *                  was told to remember are confirmed at once; facts found by
+ *                  the daily digest are candidates, confirmed by you or after
+ *                  7 days, except sensitive ones (health, money, others'
+ *                  privacy), which wait for you.
+ * - episodes.jsonl things worth bringing up later, some with a date: on that
+ *                  day and the day before, they are put in front of her.
+ * - diary/<day>.md her diary, one page a day, written by the digest.
+ *
+ * `MemoryProvider` is the seam where the soul engine (dsh-vael) can replace
+ * all of this later. Writes go to a temporary file first and are renamed.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { search, tokens } from "./search.js";
+const PROFILE_CHARS = 300;
+const RECENT_CHARS = 160;
+const CANDIDATE_DAYS = 7;
+/** Words that make a fact sensitive whatever the model said. */
+/** Two events on the same day sharing this much of their wording are the same event. */
+const SAME_EVENT = 0.5;
+/** A diary sentence holding this much of a forgotten memory's wording goes with it. */
+const REDACT = 0.4;
+function overlap(a, b) {
+    const mine = new Set(tokens(a));
+    const theirs = tokens(b);
+    return theirs.length === 0 ? 0 : theirs.filter(t => mine.has(t)).length / theirs.length;
+}
+const SENSITIVE = /病|药|医院|诊断|抑郁|焦虑|怀孕|工资|收入|存款|贷款|欠|负债|密码|身份证|银行卡|手机号|住址|出轨|离婚/;
+export function dayOf(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+function addDays(day, n) {
+    const [y, m, d] = day.split('-').map(Number);
+    return dayOf(new Date(y, m - 1, d + n));
+}
+export class FileMemory {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+        mkdirSync(join(dir, 'diary'), { recursive: true });
+    }
+    read(file, fallback) {
+        try {
+            return JSON.parse(readFileSync(join(this.dir, file), 'utf8'));
+        }
+        catch {
+            return fallback;
+        }
+    }
+    write(file, text) {
+        // The folder may have been cleared by hand while she runs.
+        mkdirSync(join(this.dir, 'diary'), { recursive: true });
+        const path = join(this.dir, file);
+        writeFileSync(`${path}.tmp`, text);
+        renameSync(`${path}.tmp`, path);
+    }
+    facts() {
+        return this.read('facts.json', []);
+    }
+    saveFacts(facts) {
+        this.write('facts.json', `${JSON.stringify(facts, null, 2)}\n`);
+    }
+    episodes() {
+        try {
+            return readFileSync(join(this.dir, 'episodes.jsonl'), 'utf8').split('\n').filter(Boolean).map(l => JSON.parse(l));
+        }
+        catch {
+            return [];
+        }
+    }
+    saveEpisodes(episodes) {
+        this.write('episodes.jsonl', episodes.map(e => JSON.stringify(e)).join('\n') + (episodes.length > 0 ? '\n' : ''));
+    }
+    diaryDays() {
+        try {
+            return readdirSync(join(this.dir, 'diary')).filter(f => /^\d{4}-\d{2}-\d{2}\.md$/.test(f)).map(f => f.slice(0, 10)).sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    nextId(prefix) {
+        const used = [...this.facts(), ...this.episodes()].map(x => x.id).filter(id => id.startsWith(prefix)).map(id => Number(id.slice(1)) || 0);
+        return `${prefix}${Math.max(0, ...used) + 1}`;
+    }
+    profile() {
+        let out = '';
+        for (const fact of this.facts().filter(f => f.status === 'confirmed').reverse()) {
+            const line = `- ${fact.text}\n`;
+            if (out.length + line.length > PROFILE_CHARS)
+                break;
+            out += line;
+        }
+        return out.trim();
+    }
+    recent(now) {
+        const today = dayOf(now);
+        return this.diaryDays().filter(d => d < today).slice(-2).map(day => {
+            const text = readFileSync(join(this.dir, 'diary', `${day}.md`), 'utf8').replace(/^#.*\n/, '').trim();
+            return `${day}：${text.length > RECENT_CHARS ? `${text.slice(0, RECENT_CHARS)}…` : text}`;
+        }).join('\n');
+    }
+    due(now) {
+        const today = dayOf(now);
+        const tomorrow = addDays(today, 1);
+        return this.episodes().filter(e => e.due !== undefined && e.due >= today && e.due <= tomorrow);
+    }
+    remember(item, now) {
+        const text = item.text.trim();
+        if (text === '')
+            throw new Error('要记住的内容是空的');
+        if (item.kind === 'fact') {
+            const facts = this.facts();
+            const same = facts.find(f => f.text === text);
+            if (same !== undefined)
+                return { id: same.id, kind: 'fact', text, at: same.createdAt };
+            const source = item.source ?? 'remember';
+            const fact = {
+                id: this.nextId('f'), text,
+                // Told to remember: confirmed. Found by the digest: a candidate.
+                status: source === 'remember' ? 'confirmed' : 'candidate',
+                sensitive: item.sensitive === true || SENSITIVE.test(text),
+                source, createdAt: now.toISOString(),
+            };
+            this.saveFacts([...facts, fact]);
+            return { id: fact.id, kind: 'fact', text, at: fact.createdAt };
+        }
+        const due = item.due !== undefined && /^\d{4}-\d{2}-\d{2}$/.test(item.due) ? item.due : undefined;
+        const episode = { id: this.nextId('e'), text, at: now.toISOString(), ...(due === undefined ? {} : { due }) };
+        this.saveEpisodes([...this.episodes(), episode]);
+        return { id: episode.id, kind: 'episode', text, at: episode.at };
+    }
+    recall(query, now, limit = 5) {
+        const docs = [
+            ...this.facts().map(f => ({ id: f.id, kind: 'fact', text: f.text, at: f.createdAt })),
+            ...this.episodes().map(e => ({ id: e.id, kind: 'episode', text: e.due === undefined ? e.text : `${e.text}（${e.due}）`, at: e.at })),
+            ...this.diaryDays().map(day => ({
+                id: `diary:${day}`, kind: 'diary',
+                text: readFileSync(join(this.dir, 'diary', `${day}.md`), 'utf8').replace(/^#.*\n/, '').trim(),
+                at: `${day}T12:00:00`,
+            })),
+        ];
+        const byId = new Map(docs.map(d => [d.id, d]));
+        return search(docs.map(d => ({ id: d.id, text: d.text, at: Date.parse(d.at) })), query, now.getTime(), limit).map(hit => byId.get(hit.id));
+    }
+    list() {
+        return { facts: this.facts(), episodes: this.episodes(), diary: this.diaryDays() };
+    }
+    remove(ids) {
+        const wanted = new Set(ids);
+        const facts = this.facts();
+        const episodes = this.episodes();
+        const keptFacts = facts.filter(f => !wanted.has(f.id));
+        const keptEpisodes = episodes.filter(e => !wanted.has(e.id));
+        let removed = facts.length - keptFacts.length + episodes.length - keptEpisodes.length;
+        this.saveFacts(keptFacts);
+        this.saveEpisodes(keptEpisodes);
+        // Forgotten means forgotten: her diary loses the sentences about it too.
+        const gone = [...facts.filter(f => wanted.has(f.id)), ...episodes.filter(e => wanted.has(e.id))].map(x => x.text);
+        if (gone.length > 0)
+            this.redactDiary(gone);
+        for (const id of wanted) {
+            const day = /^diary:(\d{4}-\d{2}-\d{2})$/.exec(id)?.[1];
+            if (day !== undefined && existsSync(join(this.dir, 'diary', `${day}.md`))) {
+                rmSync(join(this.dir, 'diary', `${day}.md`));
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /** Drop diary sentences that mostly repeat any of these texts. */
+    redactDiary(texts) {
+        for (const day of this.diaryDays()) {
+            const file = join('diary', `${day}.md`);
+            const page = readFileSync(join(this.dir, file), 'utf8');
+            const [head, ...body] = page.split('\n');
+            const sentences = body.join('\n').match(/[^。！？!?\n]+[。！？!?]*|\n/g) ?? [];
+            const kept = sentences.filter(sentence => !texts.some(text => overlap(sentence, text) >= REDACT));
+            if (kept.length !== sentences.length)
+                this.write(file, `${head}\n${kept.join('').replace(/\n{3,}/g, '\n\n')}`);
+        }
+    }
+    confirm(ids) {
+        const wanted = new Set(ids);
+        let changed = 0;
+        const facts = this.facts().map(f => {
+            if (!wanted.has(f.id) || f.status === 'confirmed')
+                return f;
+            changed++;
+            return { ...f, status: 'confirmed' };
+        });
+        this.saveFacts(facts);
+        return changed;
+    }
+    settle(now) {
+        let changed = 0;
+        const limit = now.getTime() - CANDIDATE_DAYS * 86_400_000;
+        const facts = this.facts().map(f => {
+            if (f.status !== 'candidate' || f.sensitive || Date.parse(f.createdAt) > limit)
+                return f;
+            changed++;
+            return { ...f, status: 'confirmed' };
+        });
+        if (changed > 0)
+            this.saveFacts(facts);
+        return changed;
+    }
+    applyDigest(day, digest, now) {
+        if (digest.diary.trim() !== '')
+            this.write(join('diary', `${day}.md`), `# ${day}\n\n${digest.diary.trim()}\n`);
+        const added = this.keep(digest, now);
+        this.write('meta.json', `${JSON.stringify({ lastDigestDay: day, at: now.toISOString() })}\n`);
+        return added;
+    }
+    /** Keep what a digest or a note found: new facts as candidates, events not already written down. */
+    keep(found, now) {
+        let facts = 0;
+        let episodes = 0;
+        const known = new Set(this.facts().map(f => f.text));
+        for (const fact of found.facts) {
+            if (fact.text.trim() === '' || known.has(fact.text.trim()))
+                continue;
+            this.remember({ kind: 'fact', text: fact.text, sensitive: fact.sensitive === true, source: 'digest' }, now);
+            facts++;
+        }
+        for (const episode of found.episodes) {
+            if (episode.text.trim() === '')
+                continue;
+            // Already remembered (she wrote it down during the day): same day, mostly the same words.
+            if (this.episodes().some(e => e.due === episode.due && overlap(e.text, episode.text) >= SAME_EVENT))
+                continue;
+            this.remember({ kind: 'episode', text: episode.text, ...(episode.due === undefined ? {} : { due: episode.due }) }, now);
+            episodes++;
+        }
+        return { facts, episodes };
+    }
+    lastDigestDay() {
+        return this.read('meta.json', {}).lastDigestDay;
+    }
+    exportMarkdown() {
+        const { facts, episodes, diary } = this.list();
+        const lines = ['# 她记得的事', '', '## 关于你', ''];
+        for (const f of facts)
+            lines.push(`- ${f.text}${f.status === 'candidate' ? '（待确认）' : ''}${f.sensitive ? '（敏感）' : ''}`);
+        lines.push('', '## 事件', '');
+        for (const e of episodes)
+            lines.push(`- ${e.at.slice(0, 10)} ${e.text}${e.due === undefined ? '' : `（${e.due}）`}`);
+        lines.push('', '## 日记', '');
+        for (const day of diary)
+            lines.push(readFileSync(join(this.dir, 'diary', `${day}.md`), 'utf8').replace(/^# /, '### ').trim(), '');
+        return `${lines.join('\n').trim()}\n`;
+    }
+    clear() {
+        for (const file of ['facts.json', 'episodes.jsonl', 'meta.json'])
+            rmSync(join(this.dir, file), { force: true });
+        rmSync(join(this.dir, 'diary'), { recursive: true, force: true });
+        mkdirSync(join(this.dir, 'diary'), { recursive: true });
+    }
+}