@musnows/scriverse 0.5.4 → 0.5.6

package/dist/app.js

@@ -27,7 +27,7 @@ import { accountReference, logger, sanitizeError } from "./logger.js";
 import { currentRequestActor, runWithRequestActor } from "./request-context.js";
 import { APP_VERSION } from "./version.js";
 import { fullWorkModulePermissions, proseReplacementPermissionModules } from "./work-permissions.js";
-import { CollaborationPresence, editorPageKey, entityEditorPageKey, modulePageKey, pageLabelForKey, presencePageKinds } from "./collaboration-presence.js";
+import { CollaborationPresence, entityEditorPageKey, presencePageKinds } from "./collaboration-presence.js";
 import { clearSessionCookie, createCliApiScopeMiddleware, createUserSessionMiddleware, createWorkAuthorizationMiddleware, relationshipAnalysisReadModules, setSessionCookie, UserAuthService } from "./user-auth.js";
 const nonEmpty = z.string().trim().min(1);
 const identifier = z.string().trim().min(1).max(200);
@@ -95,7 +95,7 @@ const presenceHeartbeatSchema = z.object({
         z.object({ kind: z.literal(presencePageKinds[0]) }).strict(),
         z.object({ kind: z.literal(presencePageKinds[1]), resourceId: identifier }).strict(),
         z.object({ kind: z.literal(presencePageKinds[2]), module: z.enum(["settings", "characters", "races", "organizations", "timeline", "relationships", "outlines", "reviews", "tasks", "ai-settings"]) }).strict(),
-        z.object({ kind: z.literal(presencePageKinds[3]), module: z.enum(["setting", "character", "race", "organization"]), resourceId: identifier.optional() }).strict(),
+        z.object({ kind: z.literal(presencePageKinds[3]), module: z.enum(["setting", "character", "race", "organization", "relationship"]), resourceId: identifier.optional() }).strict(),
         z.object({ kind: z.literal(presencePageKinds[4]) }).strict()
     ])
 }).strict();
@@ -296,8 +296,18 @@ const modelSchema = z.object({
 const aiPromptSchema = z.object({
     systemPrompt: z.string().max(100_000).optional()
 });
+const aiUsageQuerySchema = z.object({
+    timezoneOffset: z.coerce.number().int().min(-840).max(840).default(0)
+}).strict();
 const platformPageSizesSchema = z.object({
+    settings: z.number().int().min(10).max(100).optional(),
     characters: z.number().int().min(10).max(100).optional(),
+    races: z.number().int().min(10).max(100).optional(),
+    organizations: z.number().int().min(10).max(100).optional(),
+    timeline: z.number().int().min(10).max(100).optional(),
+    outlines: z.number().int().min(10).max(100).optional(),
+    relationships: z.number().int().min(10).max(100).optional(),
+    reviews: z.number().int().min(10).max(100).optional(),
     analysisTasks: z.number().int().min(10).max(100).optional(),
     fileVersions: z.number().int().min(10).max(100).optional()
 }).strict();
@@ -358,12 +368,20 @@ const contextSchema = z.object({
     includeBookSummary: z.boolean().optional()
 });
 const analysisTaskTypeSchema = z.enum(["structure", "chapter-analysis", "character-extraction", "character-summary", "character-identity-audit", "timeline-analysis", "worldview-analysis", "setting-extraction", "consistency-check", "report-update", "book-analysis"]);
+const relationshipSourceRefSchema = z.object({
+    sourceType: z.string().trim().min(1).max(50).regex(/^[a-z][a-z-]*$/u),
+    sourceId: identifier,
+    sourceVersion: z.string().trim().min(1).max(200)
+}).strict();
 const relationshipAnalysisScopeSchema = z.object({
     type: z.enum(["chapter", "book", "settings"]),
     chapterId: identifier.optional(),
     includeAllSettings: z.boolean().optional(),
     additionalPrompt: z.string().trim().max(10_000).optional(),
     characterIds: z.array(identifier).max(20).optional(),
+    preFilterRelationshipSources: z.boolean().optional(),
+    previewRelationshipChanges: z.boolean().optional(),
+    relationshipSourceRefs: z.array(relationshipSourceRefSchema).max(5_000).optional(),
     replaceExistingRelationships: z.boolean().optional()
 }).strict().superRefine((scope, context) => {
     if (scope.type === "chapter" && !scope.chapterId) {
@@ -378,6 +396,18 @@ const relationshipAnalysisScopeSchema = z.object({
     if (scope.replaceExistingRelationships && !scope.characterIds?.length) {
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["replaceExistingRelationships"], message: "覆盖已有关系前必须选择被分析角色" });
     }
+    if (scope.preFilterRelationshipSources !== undefined && !scope.characterIds?.length) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["preFilterRelationshipSources"], message: "来源前置过滤仅支持定向人物关系分析" });
+    }
+    if (scope.relationshipSourceRefs !== undefined && !scope.characterIds?.length) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["relationshipSourceRefs"], message: "预检来源仅支持定向人物关系分析" });
+    }
+    if (scope.relationshipSourceRefs) {
+        const keys = scope.relationshipSourceRefs.map((ref) => `${ref.sourceType}:${ref.sourceId}`);
+        if (new Set(keys).size !== keys.length) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["relationshipSourceRefs"], message: "预检来源不能重复" });
+        }
+    }
 });
 const analysisTaskSchema = z.union([
     z.object({ taskType: z.literal("relationship-analysis"), scope: relationshipAnalysisScopeSchema.optional(), modelId: identifier.optional() }).strict(),
@@ -388,6 +418,15 @@ const analysisTaskSchema = z.union([
         if (input.scope?.additionalPrompt !== undefined) {
             context.addIssue({ code: z.ZodIssueCode.custom, path: ["scope", "additionalPrompt"], message: "额外分析提示仅支持人物关系分析" });
         }
+        if (input.scope?.preFilterRelationshipSources !== undefined) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["scope", "preFilterRelationshipSources"], message: "来源前置过滤仅支持人物关系分析" });
+        }
+        if (input.scope?.previewRelationshipChanges !== undefined) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["scope", "previewRelationshipChanges"], message: "变更预览仅支持人物关系分析" });
+        }
+        if (input.scope?.relationshipSourceRefs !== undefined) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["scope", "relationshipSourceRefs"], message: "预检来源仅支持人物关系分析" });
+        }
         if (input.scope?.characterIds !== undefined || input.scope?.replaceExistingRelationships !== undefined) {
             context.addIssue({ code: z.ZodIssueCode.custom, path: ["scope", "characterIds"], message: "被分析角色仅支持人物关系分析" });
         }
@@ -492,6 +531,11 @@ function redactTaskCharacterNames(record, permissions) {
                     return redactedRelationship;
                 });
             }
+            const changePreview = recordValue(taskResult.relationshipChangePreview);
+            if (changePreview) {
+                const { operations: _operations, ...redactedChangePreview } = changePreview;
+                redactedTaskResult.relationshipChangePreview = redactedChangePreview;
+            }
             const analysisTarget = recordValue(taskResult.analysisTarget);
             if (analysisTarget) {
                 const { characterNames: _characterNames, ...redactedAnalysisTarget } = analysisTarget;
@@ -500,6 +544,14 @@ function redactTaskCharacterNames(record, permissions) {
             result.result = redactedTaskResult;
         }
     }
+    if (permissions.relationships === "none") {
+        const taskResult = recordValue(result.result);
+        const changePreview = recordValue(taskResult?.relationshipChangePreview);
+        if (taskResult && changePreview) {
+            const { operations: _operations, ...redactedChangePreview } = changePreview;
+            result.result = { ...taskResult, relationshipChangePreview: redactedChangePreview };
+        }
+    }
     const resultSummary = recordValue(result.resultSummary);
     const characterSensitiveTask = ["character-extraction", "character-summary", "character-identity-audit", "relationship-analysis"]
         .includes(String(result.taskType));
@@ -549,14 +601,14 @@ export function createRuntime(options) {
     mkdirSync(attachmentStorage.temporaryDirectory, { recursive: true, mode: 0o700 });
     const auth = new UserAuthService(database);
     const collaborationPresence = new CollaborationPresence();
-    const publishCollaborativeChange = (workId, pageKey, label = pageLabelForKey(pageKey)) => {
+    const publishRelationshipChange = (workId, relationshipId) => {
         const actor = currentRequestActor();
-        if (!actor || !workId || !pageKey)
+        if (!actor || !workId || !relationshipId)
             return;
-        collaborationPresence.publishChange(workId, pageKey, {
+        collaborationPresence.publishChange(workId, entityEditorPageKey("relationship", relationshipId), {
             userId: actor.userId,
             displayName: actor.displayName
-        }, label);
+        });
     };
     const getDevelopmentUser = () => options.devAuthBypass
         ? auth.listUsers().find((user) => user.status === "active") ?? null
@@ -941,19 +993,22 @@ export function createRuntime(options) {
         const input = parse(z.object({ volumeId: identifier, title: nonEmpty.max(300), content: z.string().max(2_000_000).optional(), chapterType: chapterTypeSchema.optional() }), request.body);
         data(response, store.createChapter(request.params.workId, input), 201);
     });
+    app.get("/api/works/:workId/deleted-chapters", (request, response) => {
+        const pagination = parsePagination(request.query);
+        data(response, pagination
+            ? store.listDeletedChaptersPage(request.params.workId, pagination)
+            : store.listDeletedChapters(request.params.workId));
+    });
     app.get("/api/chapters/:chapterId", (request, response) => data(response, store.getChapter(request.params.chapterId)));
     app.patch("/api/chapters/:chapterId", (request, response) => {
         const input = parse(z.object({ title: nonEmpty.max(300).optional(), content: z.string().max(2_000_000).optional(), excludedFromAnalysis: z.boolean().optional(), chapterType: chapterTypeSchema.optional(), source: z.enum(["manual", "auto"]).optional(), changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const { source, changeNote, expectedVersionNo, ...chapterInput } = input;
         const chapter = store.saveChapter(request.params.chapterId, chapterInput, source ?? "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(chapter.workId), editorPageKey(String(chapter.id)));
         data(response, chapter);
     });
     app.delete("/api/chapters/:chapterId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const chapter = store.getChapter(request.params.chapterId);
         store.deleteChapter(request.params.chapterId, input.expectedVersionNo);
-        publishCollaborativeChange(String(chapter.workId), editorPageKey(String(chapter.id)));
         noContent(response);
     });
     app.get("/api/chapters/:chapterId/versions", (request, response) => {
@@ -964,10 +1019,29 @@ export function createRuntime(options) {
         const pagination = parsePagination(request.query);
         data(response, pagination ? store.listChapterInsightsPage(request.params.chapterId, pagination) : store.listChapterInsights(request.params.chapterId));
     });
+    app.get("/api/chapters/:chapterId/annotations", (request, response) => data(response, store.listChapterAnnotations(request.params.chapterId)));
+    app.post("/api/chapters/:chapterId/annotations", (request, response) => {
+        const input = parse(z.object({
+            kind: z.enum(["note", "todo"]),
+            startLine: z.number().int().positive(),
+            endLine: z.number().int().positive(),
+            note: z.string().trim().min(1).max(2000)
+        }).strict().refine((value) => value.endLine >= value.startLine, { message: "结束行不能早于开始行", path: ["endLine"] }), request.body);
+        data(response, store.createChapterAnnotation(request.params.chapterId, input), 201);
+    });
+    app.patch("/api/chapter-annotations/:annotationId", (request, response) => {
+        const input = parse(z.object({ note: z.string().trim().min(1).max(2000).optional(), status: z.enum(["open", "resolved"]).optional(), expectedVersionNo: expectedVersionNoSchema }).strict().refine((value) => value.note !== undefined || value.status !== undefined, { message: "至少需要修改一项" }), request.body);
+        const { expectedVersionNo, ...update } = input;
+        data(response, store.updateChapterAnnotation(request.params.annotationId, update, expectedVersionNo));
+    });
+    app.delete("/api/chapter-annotations/:annotationId", (request, response) => {
+        const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
+        store.deleteChapterAnnotation(request.params.annotationId, input.expectedVersionNo);
+        noContent(response);
+    });
     app.post("/api/chapters/:chapterId/restore", (request, response) => {
         const input = parse(z.object({ versionNo: z.number().int().positive(), expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const chapter = store.restoreChapter(request.params.chapterId, input.versionNo, input.expectedVersionNo);
-        publishCollaborativeChange(String(chapter.workId), editorPageKey(String(chapter.id)));
         data(response, chapter);
     });
     app.post("/api/chapters/:chapterId/move", (request, response) => {
@@ -975,6 +1049,17 @@ export function createRuntime(options) {
         const { expectedVersionNo, ...moveInput } = input;
         data(response, store.moveChapter(request.params.chapterId, moveInput, expectedVersionNo));
     });
+    app.post("/api/works/:workId/chapters/batch", (request, response) => {
+        const selectedChapters = z.array(z.object({ id: identifier, expectedVersionNo: z.number().int().positive() }).strict()).min(1).max(200);
+        const action = z.discriminatedUnion("type", [
+            z.object({ type: z.literal("move"), volumeId: identifier }).strict(),
+            z.object({ type: z.literal("setType"), chapterType: chapterTypeSchema }).strict(),
+            z.object({ type: z.literal("setAnalysisExclusion"), excludedFromAnalysis: z.boolean() }).strict(),
+            z.object({ type: z.literal("delete") }).strict()
+        ]);
+        const input = parse(z.object({ chapters: selectedChapters, action }).strict(), request.body);
+        data(response, store.batchManageChapters(request.params.workId, input.chapters, input.action));
+    });
     app.get("/api/works/:workId/outlines", (request, response) => {
         const pagination = parsePagination(request.query);
         data(response, pagination ? store.listChapterOutlinesPage(request.params.workId, pagination) : store.listChapterOutlines(request.params.workId));
@@ -983,14 +1068,11 @@ export function createRuntime(options) {
     app.put("/api/chapters/:chapterId/outline", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(chapterOutlineSchema.extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const outline = store.upsertChapterOutline(request.params.chapterId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(outline.workId), modulePageKey("outlines"));
         data(response, outline);
     });
     app.delete("/api/chapters/:chapterId/outline", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const chapter = store.getChapter(request.params.chapterId);
         store.deleteChapterOutline(request.params.chapterId, input.expectedVersionNo);
-        publishCollaborativeChange(String(chapter.workId), modulePageKey("outlines"));
         noContent(response);
     });
     app.get("/api/works/:workId/foreshadows", (request, response) => {
@@ -1005,42 +1087,34 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/foreshadows", (request, response) => {
         const foreshadow = store.createForeshadow(request.params.workId, parse(foreshadowSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("outlines"));
         data(response, foreshadow, 201);
     });
     app.get("/api/foreshadows/:foreshadowId", (request, response) => data(response, store.getForeshadow(request.params.foreshadowId)));
     app.patch("/api/foreshadows/:foreshadowId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(foreshadowSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const foreshadow = store.updateForeshadow(request.params.foreshadowId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(foreshadow.workId), modulePageKey("outlines"));
         data(response, foreshadow);
     });
     app.delete("/api/foreshadows/:foreshadowId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const foreshadow = store.getForeshadow(request.params.foreshadowId);
         store.deleteForeshadow(request.params.foreshadowId, input.expectedVersionNo);
-        publishCollaborativeChange(String(foreshadow.workId), modulePageKey("outlines"));
         noContent(response);
     });
     app.post("/api/foreshadows/:foreshadowId/occurrences", (request, response) => {
         const input = parse(foreshadowOccurrenceSchema.extend({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const { expectedVersionNo, ...occurrenceInput } = input;
         const occurrence = store.createForeshadowOccurrence(request.params.foreshadowId, occurrenceInput, expectedVersionNo);
-        publishCollaborativeChange(String(occurrence.workId), modulePageKey("outlines"));
         data(response, occurrence, 201);
     });
     app.patch("/api/foreshadow-occurrences/:occurrenceId", (request, response) => {
         const input = parse(foreshadowOccurrenceSchema.partial().extend({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const { expectedVersionNo, ...occurrenceInput } = input;
         const occurrence = store.updateForeshadowOccurrence(request.params.occurrenceId, occurrenceInput, expectedVersionNo);
-        publishCollaborativeChange(String(occurrence.workId), modulePageKey("outlines"));
         data(response, occurrence);
     });
     app.delete("/api/foreshadow-occurrences/:occurrenceId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const occurrence = store.getForeshadowOccurrence(request.params.occurrenceId);
         store.deleteForeshadowOccurrence(request.params.occurrenceId, input.expectedVersionNo);
-        publishCollaborativeChange(String(occurrence.workId), modulePageKey("outlines"));
         noContent(response);
     });
     app.get("/api/works/:workId/settings", (request, response) => {
@@ -1050,7 +1124,6 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/settings", (request, response) => {
         const setting = store.createSetting(request.params.workId, parse(settingSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("settings"));
         data(response, setting, 201);
     });
     app.get("/api/works/:workId/settings/context", (request, response) => data(response, store.listSettings(request.params.workId, true)));
@@ -1058,14 +1131,11 @@ export function createRuntime(options) {
     app.patch("/api/settings/:settingId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(settingSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const setting = store.updateSetting(request.params.settingId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(setting.workId), entityEditorPageKey("setting", String(setting.id)));
         data(response, setting);
     });
     app.delete("/api/settings/:settingId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const setting = store.getSetting(request.params.settingId);
         store.deleteSetting(request.params.settingId, input.expectedVersionNo);
-        publishCollaborativeChange(String(setting.workId), entityEditorPageKey("setting", String(setting.id)));
         noContent(response);
     });
     app.get("/api/works/:workId/characters", (request, response) => {
@@ -1083,7 +1153,6 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/characters", (request, response) => {
         const character = store.createCharacter(request.params.workId, parse(characterSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("characters"));
         data(response, redactCharacterLinks(character, requestPermissions(request, request.params.workId)), 201);
     });
     app.get("/api/characters/:characterId", (request, response) => {
@@ -1092,7 +1161,6 @@ export function createRuntime(options) {
     app.patch("/api/characters/:characterId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(characterUpdateSchema.extend({ expectedVersionNo: expectedVersionNoSchema }), request.body);
         const character = store.updateCharacter(request.params.characterId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(character.workId), entityEditorPageKey("character", String(character.id)));
         data(response, redactCharacterLinks(character, requestPermissions(request)));
     });
     app.get("/api/characters/:characterId/versions", (request, response) => {
@@ -1104,14 +1172,11 @@ export function createRuntime(options) {
     app.post("/api/characters/:characterId/restore", (request, response) => {
         const input = parse(z.object({ versionNo: z.number().int().positive(), expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const character = store.restoreCharacter(request.params.characterId, input.versionNo, input.expectedVersionNo);
-        publishCollaborativeChange(String(character.workId), entityEditorPageKey("character", String(character.id)));
         data(response, redactCharacterLinks(character, requestPermissions(request)));
     });
     app.delete("/api/characters/:characterId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const character = store.getCharacter(request.params.characterId);
         store.deleteCharacter(request.params.characterId, input.expectedVersionNo);
-        publishCollaborativeChange(String(character.workId), entityEditorPageKey("character", String(character.id)));
         noContent(response);
     });
     app.post("/api/characters/:characterId/merge", (request, response) => {
@@ -1136,7 +1201,6 @@ export function createRuntime(options) {
     });
     app.post("/api/characters/:characterId/sections", (request, response) => {
         const section = store.createCharacterProfileSection(request.params.characterId, parse(characterProfileSectionSchema, request.body));
-        publishCollaborativeChange(String(section.workId), entityEditorPageKey("character", String(section.characterId)));
         data(response, section, 201);
     });
     app.get("/api/character-sections/:sectionId", (request, response) => {
@@ -1145,14 +1209,11 @@ export function createRuntime(options) {
     app.patch("/api/character-sections/:sectionId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(characterProfileSectionSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const section = store.updateCharacterProfileSection(request.params.sectionId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(section.workId), entityEditorPageKey("character", String(section.characterId)));
         data(response, section);
     });
     app.delete("/api/character-sections/:sectionId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const section = store.getCharacterProfileSection(request.params.sectionId);
         store.deleteCharacterProfileSection(request.params.sectionId, input.expectedVersionNo);
-        publishCollaborativeChange(String(section.workId), entityEditorPageKey("character", String(section.characterId)));
         noContent(response);
     });
     app.get("/api/character-sections/:sectionId/versions", (request, response) => {
@@ -1164,7 +1225,6 @@ export function createRuntime(options) {
     app.post("/api/character-sections/:sectionId/restore", (request, response) => {
         const input = parse(z.object({ versionNo: z.number().int().positive(), expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const section = store.restoreCharacterProfileSection(request.params.sectionId, input.versionNo, input.expectedVersionNo);
-        publishCollaborativeChange(String(section.workId), entityEditorPageKey("character", String(section.characterId)));
         data(response, section);
     });
     app.get("/api/works/:workId/attachments", (request, response) => {
@@ -1221,7 +1281,6 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/races", (request, response) => {
         const race = store.createRace(request.params.workId, parse(raceSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("races"));
         data(response, redactRaceMembers(race, requestPermissions(request, request.params.workId)), 201);
     });
     app.get("/api/races/:raceId", (request, response) => {
@@ -1230,14 +1289,11 @@ export function createRuntime(options) {
     app.patch("/api/races/:raceId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(raceSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const race = store.updateRace(request.params.raceId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(race.workId), entityEditorPageKey("race", String(race.id)));
         data(response, redactRaceMembers(race, requestPermissions(request)));
     });
     app.delete("/api/races/:raceId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const race = store.getRace(request.params.raceId);
         store.deleteRace(request.params.raceId, input.expectedVersionNo);
-        publishCollaborativeChange(String(race.workId), entityEditorPageKey("race", String(race.id)));
         noContent(response);
     });
     app.post("/api/races/:raceId/merge", (request, response) => {
@@ -1255,7 +1311,6 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/organizations", (request, response) => {
         const organization = store.createOrganization(request.params.workId, parse(organizationSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("organizations"));
         data(response, redactOrganizationMembers(organization, requestPermissions(request, request.params.workId)), 201);
     });
     app.get("/api/organizations/:organizationId", (request, response) => {
@@ -1264,14 +1319,11 @@ export function createRuntime(options) {
     app.patch("/api/organizations/:organizationId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(organizationSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const organization = store.updateOrganization(request.params.organizationId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(organization.workId), entityEditorPageKey("organization", String(organization.id)));
         data(response, redactOrganizationMembers(organization, requestPermissions(request)));
     });
     app.delete("/api/organizations/:organizationId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const organization = store.getOrganization(request.params.organizationId);
         store.deleteOrganization(request.params.organizationId, input.expectedVersionNo);
-        publishCollaborativeChange(String(organization.workId), entityEditorPageKey("organization", String(organization.id)));
         noContent(response);
     });
     app.post("/api/organizations/:organizationId/merge", (request, response) => {
@@ -1286,21 +1338,17 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/timeline-tracks", (request, response) => {
         const track = store.createTimelineTrack(request.params.workId, parse(timelineTrackSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("timeline"));
         data(response, track, 201);
     });
     app.get("/api/timeline-tracks/:trackId", (request, response) => data(response, store.getTimelineTrack(request.params.trackId)));
     app.patch("/api/timeline-tracks/:trackId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(timelineTrackSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const track = store.updateTimelineTrack(request.params.trackId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(track.workId), modulePageKey("timeline"));
         data(response, track);
     });
     app.delete("/api/timeline-tracks/:trackId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const track = store.getTimelineTrack(request.params.trackId);
         store.deleteTimelineTrack(request.params.trackId, input.expectedVersionNo);
-        publishCollaborativeChange(String(track.workId), modulePageKey("timeline"));
         noContent(response);
     });
     app.get("/api/works/:workId/timeline", (request, response) => {
@@ -1309,7 +1357,6 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/timeline", (request, response) => {
         const event = store.createTimelineEvent(request.params.workId, parse(timelineSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("timeline"));
         data(response, event, 201);
     });
     app.post("/api/works/:workId/timeline/merge", (request, response) => {
@@ -1323,14 +1370,12 @@ export function createRuntime(options) {
         }).strict(), request.body);
         const { expectedVersionNos, ...mergeInput } = input;
         const merged = store.mergeTimelineEvents(request.params.workId, input.eventIds, mergeInput, expectedVersionNos);
-        publishCollaborativeChange(request.params.workId, modulePageKey("timeline"));
         data(response, merged, 201);
     });
     app.get("/api/timeline/:eventId", (request, response) => data(response, store.getTimelineEvent(request.params.eventId)));
     app.patch("/api/timeline/:eventId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(timelineSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const event = store.updateTimelineEvent(request.params.eventId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(event.workId), modulePageKey("timeline"));
         data(response, event);
     });
     app.post("/api/timeline/:eventId/split", (request, response) => {
@@ -1344,16 +1389,11 @@ export function createRuntime(options) {
             expectedVersionNo: expectedVersionNoSchema
         }).strict(), request.body);
         const split = store.splitTimelineEvent(request.params.eventId, input.parts, input.expectedVersionNo);
-        const first = split[0];
-        if (first)
-            publishCollaborativeChange(String(first.workId), modulePageKey("timeline"));
         data(response, split, 201);
     });
     app.delete("/api/timeline/:eventId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
-        const event = store.getTimelineEvent(request.params.eventId);
         store.deleteTimelineEvent(request.params.eventId, input.expectedVersionNo);
-        publishCollaborativeChange(String(event.workId), modulePageKey("timeline"));
         noContent(response);
     });
     app.get("/api/works/:workId/relationships", (request, response) => {
@@ -1367,21 +1407,20 @@ export function createRuntime(options) {
     });
     app.post("/api/works/:workId/relationships", (request, response) => {
         const relationship = store.createRelationship(request.params.workId, parse(relationshipSchema, request.body));
-        publishCollaborativeChange(request.params.workId, modulePageKey("relationships"));
         data(response, relationship, 201);
     });
     app.get("/api/relationships/:relationshipId", (request, response) => data(response, store.getRelationship(request.params.relationshipId)));
     app.patch("/api/relationships/:relationshipId", (request, response) => {
         const { changeNote, expectedVersionNo, ...input } = parse(relationshipSchema.partial().extend({ changeNote: changeNoteSchema, expectedVersionNo: expectedVersionNoSchema }).strict(), request.body);
         const relationship = store.updateRelationship(request.params.relationshipId, input, "manual", null, changeNote, expectedVersionNo);
-        publishCollaborativeChange(String(relationship.workId), modulePageKey("relationships"));
+        publishRelationshipChange(String(relationship.workId), String(relationship.id));
         data(response, relationship);
     });
     app.delete("/api/relationships/:relationshipId", (request, response) => {
         const input = parse(z.object({ expectedVersionNo: expectedVersionNoSchema }).strict(), request.body ?? {});
         const relationship = store.getRelationship(request.params.relationshipId);
         store.deleteRelationship(request.params.relationshipId, input.expectedVersionNo);
-        publishCollaborativeChange(String(relationship.workId), modulePageKey("relationships"));
+        publishRelationshipChange(String(relationship.workId), String(relationship.id));
         noContent(response);
     });
     app.get("/api/entity-versions/:entityType/:entityId", (request, response) => {
@@ -1434,6 +1473,20 @@ export function createRuntime(options) {
         const permissions = requestPermissions(request, request.params.workId);
         data(response, mapRecords(store.listTaskSummariesPage(request.params.workId, parsePagination(request.query) ?? { page: 1, limit: 30, offset: 0 }), (task) => redactTaskCharacterNames(task, permissions)));
     });
+    app.post("/api/works/:workId/tasks/relationship-source-preview", async (request, response) => {
+        const input = parse(z.object({
+            scope: relationshipAnalysisScopeSchema,
+            modelId: identifier.optional()
+        }).strict(), request.body);
+        const permissions = requestPermissions(request, request.params.workId);
+        const deniedModules = relationshipAnalysisReadModules(input.scope).filter((module) => permissions[module] === "none");
+        if (deniedModules.length > 0) {
+            throw new AppError(403, "WORK_MODULE_READ_DENIED", "你没有读取人物关系来源预检所需资料模块的权限", {
+                modules: deniedModules
+            });
+        }
+        data(response, await ai.previewRelationshipSources(request.params.workId, input.scope, input.modelId));
+    });
     app.post("/api/works/:workId/tasks", (request, response) => {
         const input = parse(analysisTaskSchema, request.body);
         data(response, redactTaskCharacterNames(ai.createTask(request.params.workId, input), requestPermissions(request, request.params.workId)), 201);
@@ -1485,7 +1538,30 @@ export function createRuntime(options) {
             allowAdminAccess: request.authMethod !== "api-key"
         } : undefined), requestPermissions(request)));
     });
+    app.post("/api/tasks/:taskId/rerun", (request, response) => {
+        parse(z.object({}).strict(), request.body ?? {});
+        const task = store.getTask(request.params.taskId);
+        if (task.taskType === "relationship-analysis") {
+            const permissions = requestPermissions(request, String(task.workId));
+            const deniedModules = relationshipAnalysisReadModules(task.scope).filter((module) => permissions[module] === "none");
+            if (deniedModules.length > 0) {
+                throw new AppError(403, "WORK_MODULE_READ_DENIED", "你没有读取本次定向人物关系分析所需资料模块的权限", {
+                    modules: deniedModules
+                });
+            }
+        }
+        data(response, redactTaskCharacterNames(ai.rerunTask(request.params.taskId), requestPermissions(request)), 201);
+    });
     app.post("/api/tasks/:taskId/cancel", (request, response) => data(response, redactTaskCharacterNames(ai.cancelTask(request.params.taskId), requestPermissions(request))));
+    app.post("/api/tasks/:taskId/relationship-changes/apply", (request, response) => {
+        parse(z.object({}).strict(), request.body ?? {});
+        const applied = ai.applyRelationshipChangePreview(request.params.taskId);
+        data(response, redactTaskCharacterNames(applied, requestPermissions(request)));
+    });
+    app.post("/api/tasks/:taskId/relationship-changes/discard", (request, response) => {
+        parse(z.object({}).strict(), request.body ?? {});
+        data(response, redactTaskCharacterNames(ai.discardRelationshipChangePreview(request.params.taskId), requestPermissions(request)));
+    });
     app.get("/api/platform/ai/providers", (request, response) => {
         const pagination = parsePagination(request.query);
         data(response, pagination ? ai.listProvidersPage(pagination) : ai.listProviders());
@@ -1497,12 +1573,39 @@ export function createRuntime(options) {
     });
     app.get("/api/platform/ai/settings", (_request, response) => data(response, store.getPlatformAiSettings()));
     app.patch("/api/platform/ai/settings", (request, response) => data(response, store.updatePlatformAiSettings(parse(aiPromptSchema, request.body))));
+    app.get("/api/platform/ai/usage", (request, response) => {
+        const query = parse(aiUsageQuerySchema, request.query);
+        data(response, ai.getPlatformTokenUsage(query.timezoneOffset));
+    });
     app.get("/api/ui-settings", (_request, response) => data(response, store.getPlatformUiSettings()));
     app.get("/api/platform/ui-settings", (_request, response) => data(response, store.getPlatformUiSettings()));
     app.patch("/api/platform/ui-settings", (request, response) => {
         data(response, store.updatePlatformUiSettings(parse(platformUiSettingsSchema, request.body)));
     });
     app.get("/api/works/:workId/ai-settings", (request, response) => data(response, store.getWorkAiSettings(request.params.workId)));
+    app.get("/api/works/:workId/ai-settings/usage", (request, response) => {
+        const query = parse(aiUsageQuerySchema, request.query);
+        data(response, ai.getWorkTokenUsage(request.params.workId, query.timezoneOffset));
+    });
+    app.get("/api/works/:workId/ai-settings/relationship-search-index", (request, response) => {
+        data(response, ai.getRelationshipSearchIndexStatus(request.params.workId));
+    });
+    app.post("/api/works/:workId/ai-settings/relationship-search-index/sync", (request, response) => {
+        const workId = request.params.workId;
+        const result = ai.syncRelationshipSearchIndex(workId);
+        store.audit(workId, "relationship.search-index.incremental-sync-queued", "work-ai-settings", workId, {
+            queuedSourceCount: result.queuedSourceCount
+        });
+        data(response, result, 202);
+    });
+    app.post("/api/works/:workId/ai-settings/relationship-search-index/rebuild", (request, response) => {
+        const workId = request.params.workId;
+        const result = ai.rebuildRelationshipSearchIndex(workId);
+        store.audit(workId, "relationship.search-index.rebuild-queued", "work-ai-settings", workId, {
+            queuedSourceCount: result.queuedSourceCount
+        });
+        data(response, result, 202);
+    });
     app.patch("/api/works/:workId/ai-settings", (request, response) => {
         const workId = request.params.workId;
         const before = store.getWorkAiSettings(workId);
@@ -1767,6 +1870,15 @@ export function createRuntime(options) {
         const pagination = parsePagination(request.query);
         data(response, pagination ? store.listAuditLogsPage(request.params.workId, pagination) : store.listAuditLogs(request.params.workId));
     });
+    app.get("/api/works/:workId/writing-progress", (request, response) => data(response, store.getWritingProgress(request.params.workId)));
+    app.put("/api/works/:workId/writing-goal", (request, response) => {
+        const input = parse(z.object({
+            dailyGoal: z.number().int().min(0).max(1_000_000),
+            targetTotal: z.number().int().min(0).max(100_000_000),
+            deadline: z.string().date().nullable()
+        }).strict(), request.body);
+        data(response, store.updateWritingGoal(request.params.workId, input));
+    });
     if (options.serveUi ?? true) {
         const publicPath = options.publicPath ?? join(process.cwd(), "src", "public");
         // index.html 按登录态动态下发：未登录时注入 login-route 类，首帧直接渲染登录页；