@musnows/scriverse 0.3.11 → 0.4.1

package/dist/store.js

@@ -6,6 +6,72 @@ import { paginated, paginationSql } from "./pagination.js";
 import { currentRequestActor } from "./request-context.js";
 import { classifyWorkModulePermissions, emptyWorkModulePermissions, fullWorkModulePermissions, storedWorkModulePermissions } from "./work-permissions.js";
 import { countWords, documentShortSearchTerms, id, json, normalizeDocumentSearchText, normalizeParagraphSpacing, now, splitDocumentParagraphs } from "./utils.js";
+function settingsFromInput(settingsMarkdown, settings, fallback = []) {
+    if (settingsMarkdown !== undefined)
+        return settingsMarkdown.trim() ? [settingsMarkdown] : [];
+    return settings ?? fallback;
+}
+function settingsMarkdownFromList(settings) {
+    return Array.isArray(settings) ? settings.map(String).filter(Boolean).join("\n\n") : "";
+}
+function knowledgeSectionTitle(contentMarkdown, index) {
+    const heading = contentMarkdown.match(/^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/mu)?.[1]?.trim();
+    return heading || `设定 ${index + 1}`;
+}
+function normalizeKnowledgeSections(sections) {
+    return sections.map((section, index) => {
+        const contentMarkdown = section.contentMarkdown ?? "";
+        return {
+            title: section.title.trim() || knowledgeSectionTitle(contentMarkdown, index),
+            contentMarkdown,
+            summary: section.summary?.trim() ?? "",
+            sortOrder: Number.isFinite(section.sortOrder) ? Math.max(0, Math.trunc(section.sortOrder)) : index
+        };
+    });
+}
+function knowledgeSectionInput(value, index) {
+    if (!isRecord(value))
+        return null;
+    const contentMarkdown = typeof value.contentMarkdown === "string"
+        ? value.contentMarkdown
+        : typeof value.content === "string" ? value.content : "";
+    const title = typeof value.title === "string" ? value.title : "";
+    return {
+        title: title || knowledgeSectionTitle(contentMarkdown, index),
+        contentMarkdown,
+        summary: typeof value.summary === "string" ? value.summary : "",
+        sortOrder: typeof value.sortOrder === "number" ? value.sortOrder : index
+    };
+}
+function knowledgeSectionsFromStored(value, fallback = []) {
+    const parsed = typeof value === "string" ? json(value, []) : value;
+    if (Array.isArray(parsed)) {
+        const sections = parsed.map((item, index) => knowledgeSectionInput(item, index)).filter((item) => item !== null);
+        if (sections.length > 0 || fallback.length === 0)
+            return normalizeKnowledgeSections(sections);
+    }
+    return normalizeKnowledgeSections(fallback.map((contentMarkdown, index) => ({
+        title: knowledgeSectionTitle(contentMarkdown, index),
+        contentMarkdown,
+        sortOrder: index
+    })));
+}
+function knowledgeSectionsFromInput(sections, settingsMarkdown, settings, fallbackSections = []) {
+    if (sections !== undefined)
+        return normalizeKnowledgeSections(sections);
+    if (settingsMarkdown !== undefined || settings !== undefined) {
+        const legacySettings = settingsFromInput(settingsMarkdown, settings);
+        return knowledgeSectionsFromStored(legacySettings.map((contentMarkdown, index) => ({
+            title: knowledgeSectionTitle(contentMarkdown, index),
+            contentMarkdown,
+            sortOrder: index
+        })));
+    }
+    return fallbackSections;
+}
+function settingsFromKnowledgeSections(sections) {
+    return sections.map((section) => section.contentMarkdown).filter((content) => content.trim());
+}
 export const versionedEntityTypes = [
     "work",
     "volume",
@@ -204,6 +270,7 @@ export class Store {
                 parentRaceId: entity.parentRaceId,
                 description: entity.description,
                 settings: entity.settings,
+                settingsSections: entity.settingsSections,
                 memberIds: entity.memberIds
             };
         if (type === "organization")
@@ -211,6 +278,7 @@ export class Store {
                 name: entity.name,
                 description: entity.description,
                 settings: entity.settings,
+                settingsSections: entity.settingsSections,
                 memberIds: entity.memberIds
             };
         if (type === "timeline-track")
@@ -1620,9 +1688,11 @@ export class Store {
     }
     insertSettingWithId(workId, settingId, input, source = "create", sourceRef = null, changeNote = "") {
         const timestamp = now();
+        const content = input.content;
         this.db.transaction(() => {
             this.db.run(`INSERT INTO settings (id, work_id, title, category, content, tags_json, status, locked, evidence_json, scope_json, author_note, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, settingId, workId, input.title, input.category, input.content, JSON.stringify(input.tags ?? []), input.status ?? "draft", input.locked ? 1 : 0, JSON.stringify(input.evidence ?? []), JSON.stringify(input.scope ?? {}), input.authorNote ?? "", timestamp, timestamp);
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, settingId, workId, input.title, input.category, content, JSON.stringify(input.tags ?? []), input.status ?? "draft", input.locked ? 1 : 0, JSON.stringify(input.evidence ?? []), JSON.stringify(input.scope ?? {}), input.authorNote ?? "", timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "setting", settingId, content);
             this.recordEntityVersion("setting", settingId, source, sourceRef, changeNote || "建立世界观设定", timestamp);
             this.audit(workId, source === "restore" ? "setting.restored" : "setting.created", "setting", settingId, {
                 locked: input.locked ?? false,
@@ -1650,10 +1720,12 @@ export class Store {
     }
     updateSetting(settingId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getSetting(settingId);
+        const content = input.content ?? String(current.content);
         this.db.transaction(() => {
             this.assertExpectedVersion("setting", settingId, expectedVersionNo, "设定");
             this.db.run(`UPDATE settings SET title = ?, category = ?, content = ?, tags_json = ?, status = ?, locked = ?,
-         evidence_json = ?, scope_json = ?, author_note = ?, updated_at = ? WHERE id = ?`, input.title ?? String(current.title), input.category ?? String(current.category), input.content ?? String(current.content), JSON.stringify(input.tags ?? current.tags), input.status ?? String(current.status), (input.locked ?? Boolean(current.locked)) ? 1 : 0, JSON.stringify(input.evidence ?? current.evidence), JSON.stringify(input.scope ?? current.scope), input.authorNote ?? String(current.authorNote), now(), settingId);
+         evidence_json = ?, scope_json = ?, author_note = ?, updated_at = ? WHERE id = ?`, input.title ?? String(current.title), input.category ?? String(current.category), content, JSON.stringify(input.tags ?? current.tags), input.status ?? String(current.status), (input.locked ?? Boolean(current.locked)) ? 1 : 0, JSON.stringify(input.evidence ?? current.evidence), JSON.stringify(input.scope ?? current.scope), input.authorNote ?? String(current.authorNote), now(), settingId);
+            this.syncMarkdownAttachmentReferences(String(current.workId), "setting", settingId, content);
             this.recordEntityVersion("setting", settingId, source, sourceRef, changeNote || "更新世界观设定");
             this.audit(String(current.workId), "setting.updated", "setting", settingId, { fields: Object.keys(input), source, sourceRef });
         });
@@ -1664,6 +1736,7 @@ export class Store {
         this.db.transaction(() => {
             this.assertExpectedVersion("setting", settingId, expectedVersionNo, "设定");
             this.recordEntityVersion("setting", settingId, "delete", null, "删除世界观设定");
+            this.clearMarkdownAttachmentReferences("setting", settingId);
             this.db.run("DELETE FROM settings WHERE id = ?", settingId);
             this.audit(String(current.workId), "setting.deleted", "setting", settingId);
         });
@@ -1701,10 +1774,13 @@ export class Store {
         const memberIds = [...new Set(input.memberIds ?? [])];
         this.assertCharactersInWork(workId, memberIds);
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const timestamp = now();
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO races (id, work_id, parent_race_id, name, normalized_name, description, settings_json, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, raceId, workId, parentRaceId, name, normalizedName, input.description ?? "", JSON.stringify(input.settings ?? []), timestamp, timestamp);
+            this.db.run(`INSERT INTO races (id, work_id, parent_race_id, name, normalized_name, description, settings_json, settings_sections_json, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, raceId, workId, parentRaceId, name, normalizedName, input.description ?? "", JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "race", raceId, settingsMarkdownFromList(settings));
             this.replaceRaceMembers(raceId, name, memberIds);
             this.recordMembershipVersions(memberSnapshots, "race", raceId, `设为种族“${name}”`);
             this.recordEntityVersion("race", raceId, source, sourceRef, changeNote || "建立种族档案", timestamp);
@@ -1750,9 +1826,13 @@ export class Store {
             ? [...new Set([...current.memberIds, ...(memberIds ?? [])])]
             : [];
         const memberSnapshots = this.captureCharacterSnapshots(touchedMemberIds);
+        const currentSections = knowledgeSectionsFromStored(current.settingsSections, current.settings);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings, currentSections);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.assertExpectedVersion("race", raceId, expectedVersionNo, "种族");
-            this.db.run(`UPDATE races SET parent_race_id = ?, name = ?, normalized_name = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?`, parentRaceId, name, normalizedName, input.description ?? String(current.description), JSON.stringify(input.settings ?? current.settings), now(), raceId);
+            this.db.run(`UPDATE races SET parent_race_id = ?, name = ?, normalized_name = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?`, parentRaceId, name, normalizedName, input.description ?? String(current.description), JSON.stringify(settings), JSON.stringify(settingsSections), now(), raceId);
+            this.syncMarkdownAttachmentReferences(workId, "race", raceId, settingsMarkdownFromList(settings));
             if (nameChanged)
                 this.db.run("UPDATE characters SET species = ?, updated_at = ? WHERE race_id = ?", name, now(), raceId);
             if (memberIds)
@@ -1774,6 +1854,7 @@ export class Store {
             this.assertExpectedVersion("race", raceId, expectedVersionNo, "种族");
             this.recordEntityVersion("race", raceId, "delete", null, "删除种族档案");
             this.db.run("UPDATE characters SET race_id = NULL, species = '', updated_at = ? WHERE race_id = ?", now(), raceId);
+            this.clearMarkdownAttachmentReferences("race", raceId);
             this.db.run("DELETE FROM races WHERE id = ?", raceId);
             this.recordMembershipVersions(memberSnapshots, "race", raceId, `种族“${String(current.name)}”已删除`);
             this.audit(String(current.workId), "race.deleted", "race", raceId);
@@ -1800,15 +1881,19 @@ export class Store {
             : target.parentRaceId;
         const descriptionParts = [String(target.description).trim(), String(source.description).trim()].filter(Boolean);
         const description = [...new Set(descriptionParts)].join("\n\n");
-        const settings = [...new Set([...target.settings, ...source.settings])];
+        const settingsSections = [...knowledgeSectionsFromStored(target.settingsSections, target.settings), ...knowledgeSectionsFromStored(source.settingsSections, source.settings)]
+            .map((section, index) => ({ ...section, sortOrder: index }));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.recordEntityVersion("race", sourceRaceId, "delete", mergeId, `合并至种族“${String(target.name)}”`, timestamp);
-            this.db.run("UPDATE races SET parent_race_id = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?", targetParentRaceId, description, JSON.stringify(settings), timestamp, targetRaceId);
+            this.db.run("UPDATE races SET parent_race_id = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?", targetParentRaceId, description, JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, targetRaceId);
+            this.syncMarkdownAttachmentReferences(workId, "race", targetRaceId, settingsMarkdownFromList(settings));
             this.db.run("UPDATE characters SET race_id = ?, species = ?, updated_at = ? WHERE race_id = ?", targetRaceId, String(target.name), timestamp, sourceRaceId);
             for (const childRaceId of sourceChildren) {
                 this.db.run("UPDATE races SET parent_race_id = ?, updated_at = ? WHERE id = ?", targetRaceId, timestamp, childRaceId);
                 this.recordEntityVersion("race", childRaceId, "merge", mergeId, `因种族“${String(source.name)}”合并而迁移父种族`, timestamp);
             }
+            this.clearMarkdownAttachmentReferences("race", sourceRaceId);
             this.db.run("DELETE FROM races WHERE id = ?", sourceRaceId);
             this.recordMembershipVersions(memberSnapshots, "race", targetRaceId, `合并种族“${String(source.name)}”`);
             this.recordEntityVersion("race", targetRaceId, "merge", mergeId, `合并种族“${String(source.name)}”`, timestamp);
@@ -1826,6 +1911,8 @@ export class Store {
     mapRace(row) {
         const raceId = requiredString(row, "id");
         const lineage = this.raceLineage(raceId);
+        const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const members = this.db.all("SELECT id, name FROM characters WHERE race_id = ? ORDER BY name", requiredString(row, "id")).map((member) => ({
             characterId: requiredString(member, "id"),
             name: requiredString(member, "name")
@@ -1836,10 +1923,15 @@ export class Store {
             parentRaceId: optionalString(row, "parent_race_id"),
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
-            settings: json(requiredString(row, "settings_json"), []),
+            settings,
+            settingsMarkdown: settingsMarkdownFromList(settings),
+            settingsSections,
             lineage: lineage.map((item) => ({ id: item.id, name: item.name })),
-            effectiveSettings: lineage.flatMap((item, index) => item.settings.map((value) => ({
-                value,
+            effectiveSettings: lineage.flatMap((item, index) => item.settingsSections.map((section) => ({
+                title: section.title,
+                summary: section.summary,
+                sortOrder: section.sortOrder,
+                value: section.contentMarkdown,
                 sourceRaceId: item.id,
                 sourceRaceName: item.name,
                 inherited: index < lineage.length - 1
@@ -1889,13 +1981,15 @@ export class Store {
             if (seen.has(currentId))
                 throw new AppError(500, "RACE_HIERARCHY_INVALID", "种族层级存在循环");
             seen.add(currentId);
-            const row = this.db.get("SELECT id, name, settings_json, parent_race_id FROM races WHERE id = ?", currentId);
+            const row = this.db.get("SELECT id, name, settings_json, settings_sections_json, parent_race_id FROM races WHERE id = ?", currentId);
             if (!row)
                 throw new AppError(500, "RACE_HIERARCHY_INVALID", "种族层级引用了不存在的父种族");
+            const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
             lineage.push({
                 id: requiredString(row, "id"),
                 name: requiredString(row, "name"),
-                settings: json(requiredString(row, "settings_json"), [])
+                settings: settingsFromKnowledgeSections(settingsSections),
+                settingsSections
             });
             currentId = optionalString(row, "parent_race_id");
         }
@@ -1921,10 +2015,13 @@ export class Store {
         const memberIds = [...new Set(input.memberIds ?? [])];
         this.assertCharactersInWork(workId, memberIds);
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const timestamp = now();
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO organizations (id, work_id, name, normalized_name, description, settings_json, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, organizationId, workId, name, normalizedName, input.description ?? "", JSON.stringify(input.settings ?? []), timestamp, timestamp);
+            this.db.run(`INSERT INTO organizations (id, work_id, name, normalized_name, description, settings_json, settings_sections_json, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, organizationId, workId, name, normalizedName, input.description ?? "", JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "organization", organizationId, settingsMarkdownFromList(settings));
             this.replaceOrganizationMembers(organizationId, memberIds);
             this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `加入组织“${name}”`);
             this.recordEntityVersion("organization", organizationId, source, sourceRef, changeNote || "建立组织档案", timestamp);
@@ -1963,9 +2060,13 @@ export class Store {
             this.assertCharactersInWork(workId, memberIds);
         const touchedMemberIds = memberIds ? [...new Set([...current.memberIds, ...memberIds])] : [];
         const memberSnapshots = this.captureCharacterSnapshots(touchedMemberIds);
+        const currentSections = knowledgeSectionsFromStored(current.settingsSections, current.settings);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings, currentSections);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.assertExpectedVersion("organization", organizationId, expectedVersionNo, "组织");
-            this.db.run(`UPDATE organizations SET name = ?, normalized_name = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?`, name, normalizedName, input.description ?? String(current.description), JSON.stringify(input.settings ?? current.settings), now(), organizationId);
+            this.db.run(`UPDATE organizations SET name = ?, normalized_name = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?`, name, normalizedName, input.description ?? String(current.description), JSON.stringify(settings), JSON.stringify(settingsSections), now(), organizationId);
+            this.syncMarkdownAttachmentReferences(workId, "organization", organizationId, settingsMarkdownFromList(settings));
             if (memberIds) {
                 this.replaceOrganizationMembers(organizationId, memberIds);
                 this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `组织“${name}”成员关系变更`);
@@ -1981,6 +2082,7 @@ export class Store {
         this.db.transaction(() => {
             this.assertExpectedVersion("organization", organizationId, expectedVersionNo, "组织");
             this.recordEntityVersion("organization", organizationId, "delete", null, "删除组织档案");
+            this.clearMarkdownAttachmentReferences("organization", organizationId);
             this.db.run("DELETE FROM organizations WHERE id = ?", organizationId);
             this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `组织“${String(current.name)}”已删除`);
             this.audit(String(current.workId), "organization.deleted", "organization", organizationId);
@@ -2002,15 +2104,19 @@ export class Store {
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
         const descriptionParts = [String(target.description).trim(), String(source.description).trim()].filter(Boolean);
         const description = [...new Set(descriptionParts)].join("\n\n");
-        const settings = [...new Set([...target.settings, ...source.settings])];
+        const settingsSections = [...knowledgeSectionsFromStored(target.settingsSections, target.settings), ...knowledgeSectionsFromStored(source.settingsSections, source.settings)]
+            .map((section, index) => ({ ...section, sortOrder: index }));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const sourceMemberships = this.db.all("SELECT character_id, role, note, created_at FROM character_organization_memberships WHERE organization_id = ?", sourceOrganizationId);
         this.db.transaction(() => {
             this.recordEntityVersion("organization", sourceOrganizationId, "delete", mergeId, `合并至组织“${String(target.name)}”`, timestamp);
-            this.db.run("UPDATE organizations SET description = ?, settings_json = ?, updated_at = ? WHERE id = ?", description, JSON.stringify(settings), timestamp, targetOrganizationId);
+            this.db.run("UPDATE organizations SET description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?", description, JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, targetOrganizationId);
+            this.syncMarkdownAttachmentReferences(workId, "organization", targetOrganizationId, settingsMarkdownFromList(settings));
             for (const membership of sourceMemberships) {
                 this.db.run(`INSERT INTO character_organization_memberships (character_id, organization_id, role, note, created_at, updated_at)
            VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(character_id, organization_id) DO NOTHING`, requiredString(membership, "character_id"), targetOrganizationId, requiredString(membership, "role"), requiredString(membership, "note"), requiredString(membership, "created_at"), timestamp);
             }
+            this.clearMarkdownAttachmentReferences("organization", sourceOrganizationId);
             this.db.run("DELETE FROM organizations WHERE id = ?", sourceOrganizationId);
             this.recordMembershipVersions(memberSnapshots, "organization", targetOrganizationId, `合并组织“${String(source.name)}”`);
             this.recordEntityVersion("organization", targetOrganizationId, "merge", mergeId, `合并组织“${String(source.name)}”`, timestamp);
@@ -2019,6 +2125,8 @@ export class Store {
         return { mergeId, target: this.getOrganization(targetOrganizationId), source };
     }
     mapOrganization(row) {
+        const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const members = this.db.all(`SELECT c.id, c.name, m.role, m.note
        FROM character_organization_memberships m
        JOIN characters c ON c.id = m.character_id
@@ -2033,7 +2141,9 @@ export class Store {
             workId: requiredString(row, "work_id"),
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
-            settings: json(requiredString(row, "settings_json"), []),
+            settings,
+            settingsMarkdown: settingsMarkdownFromList(settings),
+            settingsSections,
             memberIds: members.map((member) => member.characterId),
             members,
             versionNo: this.currentEntityVersionNo("organization", requiredString(row, "id")),
@@ -2083,6 +2193,7 @@ export class Store {
         delete profile.sections;
         return {
             name: String(character.name),
+            code: String(character.code),
             aliases: [...character.aliases],
             raceId: character.raceId,
             species: String(character.species),
@@ -2135,9 +2246,9 @@ export class Store {
         const organizationIds = [...new Set(input.organizationIds ?? [])];
         this.assertOrganizationsInWork(workId, organizationIds);
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO characters (id, work_id, name, aliases_json, species, race_id, attributes_json, profile_json, current_state_json,
+            this.db.run(`INSERT INTO characters (id, work_id, name, code, aliases_json, species, race_id, attributes_json, profile_json, current_state_json,
          locked_fields_json, visibility, first_chapter_id, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, characterId, workId, names.name, JSON.stringify(names.aliases), species, raceId, JSON.stringify(input.attributes ?? {}), JSON.stringify(input.profile ?? {}), JSON.stringify(input.currentState ?? {}), JSON.stringify(input.lockedFields ?? []), input.visibility ?? "author", input.firstChapterId ?? null, timestamp, timestamp);
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, characterId, workId, names.name, input.code?.trim() ?? "", JSON.stringify(names.aliases), species, raceId, JSON.stringify(input.attributes ?? {}), JSON.stringify(input.profile ?? {}), JSON.stringify(input.currentState ?? {}), JSON.stringify(input.lockedFields ?? []), input.visibility ?? "author", input.firstChapterId ?? null, timestamp, timestamp);
             this.insertCharacterNames(workId, characterId, names.entries);
             this.replaceCharacterOrganizations(characterId, organizationIds);
             this.insertCharacterVersion(characterId, 1, "create", null, "建立人物档案", timestamp);
@@ -2232,21 +2343,27 @@ export class Store {
     attachmentIdsInMarkdown(contentMarkdown) {
         return [...new Set([...contentMarkdown.matchAll(/attachment:\/\/([A-Za-z0-9_-]{1,300})/gu)].map((match) => String(match[1])))];
     }
-    syncCharacterProfileSectionAttachments(section) {
-        const sectionId = String(section.id);
-        const workId = String(section.workId);
-        const attachmentIds = this.attachmentIdsInMarkdown(String(section.contentMarkdown));
+    syncMarkdownAttachmentReferences(workId, entityType, entityId, contentMarkdown) {
+        const attachmentIds = this.attachmentIdsInMarkdown(contentMarkdown);
         for (const attachmentId of attachmentIds) {
             const attachment = this.getAttachment(attachmentId);
             if (attachment.workId !== workId)
                 throw new AppError(400, "ATTACHMENT_WORK_MISMATCH", "附件不属于当前作品");
         }
-        this.db.run("DELETE FROM attachment_references WHERE entity_type = 'character-section' AND entity_id = ?", sectionId);
+        this.db.run("DELETE FROM attachment_references WHERE entity_type = ? AND entity_id = ?", entityType, entityId);
         for (const attachmentId of attachmentIds) {
             this.db.run(`INSERT INTO attachment_references (attachment_id, work_id, entity_type, entity_id, created_at)
-         VALUES (?, ?, 'character-section', ?, ?)`, attachmentId, workId, sectionId, now());
+         VALUES (?, ?, ?, ?, ?)`, attachmentId, workId, entityType, entityId, now());
         }
     }
+    clearMarkdownAttachmentReferences(entityType, entityId) {
+        this.db.run("DELETE FROM attachment_references WHERE entity_type = ? AND entity_id = ?", entityType, entityId);
+    }
+    syncCharacterProfileSectionAttachments(section) {
+        const sectionId = String(section.id);
+        const workId = String(section.workId);
+        this.syncMarkdownAttachmentReferences(workId, "character-section", sectionId, String(section.contentMarkdown));
+    }
     createCharacterProfileSection(characterId, input, source = "create", sourceRef = null) {
         const character = this.getCharacter(characterId);
         const sectionId = id("characterSection");
@@ -2440,7 +2557,7 @@ export class Store {
         const attachment = this.getAttachment(attachmentId);
         const references = Number(this.db.get("SELECT COUNT(*) AS count FROM attachment_references WHERE attachment_id = ?", attachmentId)?.count ?? 0);
         if (references > 0)
-            throw new AppError(409, "ATTACHMENT_IN_USE", "附件仍被人物档案章节引用，无法删除");
+            throw new AppError(409, "ATTACHMENT_IN_USE", "附件仍被资料引用，无法删除");
         const storageKey = String(attachment.storageKey);
         this.db.transaction(() => {
             this.db.run("DELETE FROM attachments WHERE id = ?", attachmentId);
@@ -2480,8 +2597,8 @@ export class Store {
         this.db.transaction(() => {
             const lockedCurrent = this.getCharacter(characterId);
             this.assertExpectedRevision("character", characterId, expectedVersionNo, "人物", Number(lockedCurrent.versionNo));
-            this.db.run(`UPDATE characters SET name = ?, aliases_json = ?, species = ?, race_id = ?, attributes_json = ?, profile_json = ?, current_state_json = ?,
-         locked_fields_json = ?, visibility = ?, first_chapter_id = ?, updated_at = ? WHERE id = ?`, names.name, JSON.stringify(names.aliases), species, raceId, JSON.stringify(attributes), JSON.stringify(input.profile ?? current.profile), JSON.stringify(input.currentState ?? current.currentState), JSON.stringify(input.lockedFields ?? current.lockedFields), input.visibility ?? String(current.visibility), input.firstChapterId === undefined ? current.firstChapterId : input.firstChapterId, now(), characterId);
+            this.db.run(`UPDATE characters SET name = ?, code = ?, aliases_json = ?, species = ?, race_id = ?, attributes_json = ?, profile_json = ?, current_state_json = ?,
+         locked_fields_json = ?, visibility = ?, first_chapter_id = ?, updated_at = ? WHERE id = ?`, names.name, input.code === undefined ? String(current.code) : input.code.trim(), JSON.stringify(names.aliases), species, raceId, JSON.stringify(attributes), JSON.stringify(input.profile ?? current.profile), JSON.stringify(input.currentState ?? current.currentState), JSON.stringify(input.lockedFields ?? current.lockedFields), input.visibility ?? String(current.visibility), input.firstChapterId === undefined ? current.firstChapterId : input.firstChapterId, now(), characterId);
             this.db.run("DELETE FROM character_names WHERE character_id = ?", characterId);
             this.insertCharacterNames(workId, characterId, names.entries);
             if (organizationIds)
@@ -2550,7 +2667,7 @@ export class Store {
             this.assertExpectedRevision("character", characterId, expectedVersionNo, "人物", this.currentCharacterVersionNo(characterId));
             return this.recreateCharacterFromVersion(characterId, version, snapshot, versionNo);
         }
-        return this.updateCharacter(characterId, snapshot, "restore", requiredString(version, "id"), `恢复至 v${versionNo}`, expectedVersionNo);
+        return this.updateCharacter(characterId, { ...snapshot, code: snapshot.code ?? "" }, "restore", requiredString(version, "id"), `恢复至 v${versionNo}`, expectedVersionNo);
     }
     recreateCharacterFromVersion(characterId, version, snapshot, versionNo) {
         const workId = requiredString(version, "work_id");
@@ -2567,9 +2684,9 @@ export class Store {
         const timestamp = now();
         const nextVersionNo = numberValue(this.db.get("SELECT COALESCE(MAX(version_no), 0) AS version_no FROM character_versions WHERE character_id = ?", characterId) ?? {}, "version_no") + 1;
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO characters (id, work_id, name, aliases_json, species, race_id, attributes_json, profile_json, current_state_json,
+            this.db.run(`INSERT INTO characters (id, work_id, name, code, aliases_json, species, race_id, attributes_json, profile_json, current_state_json,
          locked_fields_json, visibility, first_chapter_id, version_no, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, characterId, workId, names.name, JSON.stringify(names.aliases), species, raceId, JSON.stringify(snapshot.attributes ?? {}), JSON.stringify(snapshot.profile ?? {}), JSON.stringify(snapshot.currentState ?? {}), JSON.stringify(snapshot.lockedFields ?? []), snapshot.visibility ?? "author", snapshot.firstChapterId ?? null, nextVersionNo, timestamp, timestamp);
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, characterId, workId, names.name, snapshot.code ?? "", JSON.stringify(names.aliases), species, raceId, JSON.stringify(snapshot.attributes ?? {}), JSON.stringify(snapshot.profile ?? {}), JSON.stringify(snapshot.currentState ?? {}), JSON.stringify(snapshot.lockedFields ?? []), snapshot.visibility ?? "author", snapshot.firstChapterId ?? null, nextVersionNo, timestamp, timestamp);
             this.insertCharacterNames(workId, characterId, names.entries);
             this.replaceCharacterOrganizations(characterId, organizationIds);
             this.insertCharacterVersion(characterId, nextVersionNo, "restore", requiredString(version, "id"), `恢复至 v${versionNo}`, timestamp, workId);
@@ -2642,6 +2759,7 @@ export class Store {
             id: characterId,
             workId: requiredString(row, "work_id"),
             name: requiredString(row, "name"),
+            code: requiredString(row, "code"),
             aliases: indexedAliases.length > 0 ? indexedAliases : json(requiredString(row, "aliases_json"), []),
             raceId: race ? String(race.id) : null,
             race: race ? {
@@ -2726,6 +2844,7 @@ export class Store {
                     .filter((alias) => normalizeCharacterName(alias) !== normalizeCharacterName(String(target.name)))
                     .map((alias) => [normalizeCharacterName(alias), alias])).values()];
             this.updateCharacter(targetId, {
+                code: String(target.code) || String(source.code),
                 aliases: uniqueAliases,
                 raceId: target.raceId ?? source.raceId,
                 organizationIds: [...new Set([...target.organizationIds, ...source.organizationIds])],
@@ -3492,14 +3611,28 @@ export class Store {
     }
     listTasks(workId) {
         this.getWork(workId);
-        return this.db.all("SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC", workId).map((row) => this.mapTask(row));
+        return this.db.all("SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC", workId).map((row) => this.mapTask(row));
     }
     listTasksPage(workId, pagination) {
         this.getWork(workId);
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => this.mapTask(row)), pagination);
     }
+    listTaskSummariesPage(workId, pagination) {
+        this.getWork(workId);
+        const page = paginationSql(pagination);
+        const rows = this.db.all(`SELECT id, work_id, task_type, scope_json, status, progress, created_at, updated_at
+       FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC${page.sql}`, workId, ...page.params);
+        const chapterSummaries = new Map(this.db.all(`SELECT chapter.id, chapter.title, volume.title AS volume_title
+       FROM chapters chapter JOIN volumes volume ON volume.id = chapter.volume_id
+       WHERE chapter.work_id = ?`, workId).map((row) => [
+            requiredString(row, "id"),
+            `${requiredString(row, "volume_title")} · ${requiredString(row, "title")}`
+        ]));
+        const volumeTitles = new Map(this.db.all("SELECT id, title FROM volumes WHERE work_id = ?", workId).map((row) => [requiredString(row, "id"), requiredString(row, "title")]));
+        return paginated(rows.map((row) => this.mapTaskSummary(row, chapterSummaries, volumeTitles)), pagination);
+    }
     getTask(taskId) {
         const row = this.db.get("SELECT * FROM analysis_tasks WHERE id = ?", taskId);
         if (!row)
@@ -3589,6 +3722,31 @@ export class Store {
             updatedAt: requiredString(row, "updated_at")
         };
     }
+    mapTaskSummary(row, chapterSummaries, volumeTitles) {
+        const scope = json(requiredString(row, "scope_json"), {});
+        return {
+            id: requiredString(row, "id"),
+            workId: requiredString(row, "work_id"),
+            taskType: requiredString(row, "task_type"),
+            scope,
+            scopeSummary: this.taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles),
+            status: requiredString(row, "status"),
+            progress: numberValue(row, "progress"),
+            createdAt: requiredString(row, "created_at"),
+            updatedAt: requiredString(row, "updated_at")
+        };
+    }
+    taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles) {
+        if (typeof scope.chapterId === "string")
+            return chapterSummaries.get(scope.chapterId) ?? "章节已删除";
+        if (scope.type === "volume" && typeof scope.volumeId === "string") {
+            const title = volumeTitles.get(scope.volumeId);
+            return title ? `分卷 · ${title}` : "分卷已删除";
+        }
+        if (scope.type === "book" || Object.keys(scope).length === 0)
+            return "全书";
+        return "未指定范围";
+    }
     taskScopeSummary(workId, scope) {
         if (typeof scope.chapterId === "string") {
             const chapter = this.db.get(`SELECT chapter.title AS title, volume.title AS volume_title