@musnows/scriverse 0.8.8 → 0.9.1

package/dist/store.js

@@ -209,6 +209,13 @@ export const versionedEntityTypes = [
     "chapter-outline",
     "foreshadow"
 ];
+const bookEntityTypes = ["character", "draft", "setting", "organization"];
+const legacyFavoriteTables = {
+    character: "characters",
+    draft: "drafts",
+    setting: "settings",
+    organization: "organizations"
+};
 export const AI_CONVERSATION_STREAM_REQUEST_LEASE_MS = 3 * 60_000;
 export const aiConversationTaskTypes = ["chat", "roleplay", "continue", "polish"];
 export function defaultAiConversationTitle(prompt) {
@@ -329,6 +336,83 @@ export class Store {
         this.migrateEntityVersionBaselines();
         this.purgeExpiredRecycleBin();
     }
+    entityPreferenceProjection(entityType, alias) {
+        const actor = currentRequestActor();
+        if (!actor) {
+            return {
+                columns: `${alias}.is_favorite AS user_is_favorite,
+          EXISTS (
+            SELECT 1 FROM work_entity_pins pin
+            WHERE pin.work_id = ${alias}.work_id
+              AND pin.entity_type = '${entityType}'
+              AND pin.entity_id = ${alias}.id
+              AND pin.is_pinned = 1
+          ) AS is_pinned`,
+                orderBy: "is_pinned DESC, user_is_favorite DESC",
+                params: []
+            };
+        }
+        return {
+            columns: `
+        EXISTS (
+          SELECT 1 FROM work_entity_favorites favorite
+          WHERE favorite.work_id = ${alias}.work_id
+            AND favorite.entity_type = '${entityType}'
+            AND favorite.entity_id = ${alias}.id
+            AND favorite.user_id = ?
+            AND favorite.is_favorite = 1
+        ) AS user_is_favorite,
+        EXISTS (
+          SELECT 1 FROM work_entity_pins pin
+          WHERE pin.work_id = ${alias}.work_id
+            AND pin.entity_type = '${entityType}'
+            AND pin.entity_id = ${alias}.id
+            AND pin.is_pinned = 1
+        ) AS is_pinned`,
+            orderBy: "is_pinned DESC, user_is_favorite DESC",
+            params: [actor.userId]
+        };
+    }
+    mapEntityFavorite(row) {
+        return Object.hasOwn(row, "user_is_favorite")
+            ? booleanValue(row, "user_is_favorite")
+            : booleanValue(row, "is_favorite");
+    }
+    mapEntityPin(row) {
+        return booleanValue(row, "is_pinned");
+    }
+    setEntityFavorite(workId, entityType, entityId, isFavorite, legacyFavorite) {
+        const actor = currentRequestActor();
+        const previousFavorite = actor
+            ? this.db.get("SELECT is_favorite FROM work_entity_favorites WHERE work_id = ? AND entity_type = ? AND entity_id = ? AND user_id = ?", workId, entityType, entityId, actor.userId)
+            : undefined;
+        const previous = actor ? booleanValue(previousFavorite ?? {}, "is_favorite") : legacyFavorite;
+        if (previous === isFavorite)
+            return previous;
+        const timestamp = now();
+        if (actor) {
+            this.db.run(`INSERT INTO work_entity_favorites (work_id, entity_type, entity_id, user_id, is_favorite, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(work_id, entity_type, entity_id, user_id)
+         DO UPDATE SET is_favorite = excluded.is_favorite, updated_at = excluded.updated_at`, workId, entityType, entityId, actor.userId, isFavorite ? 1 : 0, timestamp, timestamp);
+        }
+        else {
+            this.db.run(`UPDATE ${legacyFavoriteTables[entityType]} SET is_favorite = ? WHERE id = ?`, isFavorite ? 1 : 0, entityId);
+        }
+        return previous;
+    }
+    setEntityPin(workId, entityType, entityId, isPinned) {
+        const previousPin = this.db.get("SELECT is_pinned FROM work_entity_pins WHERE work_id = ? AND entity_type = ? AND entity_id = ?", workId, entityType, entityId);
+        const previous = booleanValue(previousPin ?? {}, "is_pinned");
+        if (previous === isPinned)
+            return previous;
+        const timestamp = now();
+        this.db.run(`INSERT INTO work_entity_pins (work_id, entity_type, entity_id, is_pinned, pinned_by_user_id, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(work_id, entity_type, entity_id)
+       DO UPDATE SET is_pinned = excluded.is_pinned, pinned_by_user_id = excluded.pinned_by_user_id, updated_at = excluded.updated_at`, workId, entityType, entityId, isPinned ? 1 : 0, currentRequestActor()?.userId ?? null, timestamp, timestamp);
+        return previous;
+    }
     purgeExpiredRecycleBin(referenceTime = new Date()) {
         const cutoff = new Date(referenceTime.getTime() - RECYCLE_BIN_RETENTION_DAYS * 24 * 60 * 60_000).toISOString();
         return this.db.transaction(() => {
@@ -572,8 +656,16 @@ export class Store {
         const versionNo = latest ? numberValue(latest, "version_no") + 1 : 1;
         this.db.run(`INSERT INTO entity_versions (id, work_id, entity_type, entity_id, version_no, snapshot_json, source, source_ref, change_note, created_at, created_by_user_id)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("entityVersion"), type === "work" ? entityId : String(entity.workId), type, entityId, versionNo, snapshotJson, source, sourceRef, changeNote.trim(), timestamp ?? now(), currentRequestActor()?.userId ?? null);
+        if (type === "setting") {
+            this.recordSyncChange(String(entity.workId), "setting", entityId, source === "delete" ? "delete" : "upsert", versionNo, timestamp);
+        }
         return versionNo;
     }
+    recordSyncChange(workId, entityType, entityId, operation, versionNo, timestamp) {
+        this.db.run(`INSERT INTO sync_changes (
+         work_id, entity_type, entity_id, operation, version_no, changed_by_user_id, changed_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?)`, workId, entityType, entityId, operation, versionNo, currentRequestActor()?.userId ?? null, timestamp ?? now());
+    }
     backfillEntityVersionBaselines() {
         const entities = [
             ...this.db.all("SELECT id, updated_at FROM works").map((row) => ["work", requiredString(row, "id"), requiredString(row, "updated_at")]),
@@ -788,7 +880,7 @@ export class Store {
     }
     listWorks() {
         const actor = currentRequestActor();
-        if (!actor || (actor.role === "admin" && actor.authentication !== "api-key")) {
+        if (!actor) {
             return this.mapWorks(this.db.all("SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC"));
         }
         return this.mapWorks(this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
@@ -799,7 +891,7 @@ export class Store {
     listWorksPage(pagination) {
         const actor = currentRequestActor();
         const page = paginationSql(pagination);
-        const rows = !actor || (actor.role === "admin" && actor.authentication !== "api-key")
+        const rows = !actor
             ? this.db.all(`SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC${page.sql}`, ...page.params)
             : this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
          WHERE COALESCE(work.is_internal, 0) = 0 AND work.deleted_at IS NULL
@@ -815,7 +907,7 @@ export class Store {
     }
     listDeletedWorks() {
         const actor = currentRequestActor();
-        const actorRestricted = Boolean(actor && !(actor.role === "admin" && actor.authentication !== "api-key"));
+        const actorRestricted = Boolean(actor);
         const rows = this.db.all(`SELECT work.*,
         (SELECT COUNT(*) FROM volumes volume WHERE volume.work_id = work.id) AS volume_count,
         (SELECT COUNT(*) FROM chapters chapter WHERE chapter.work_id = work.id) AS chapter_count,
@@ -1108,6 +1200,18 @@ export class Store {
         });
         return this.getWork(workId);
     }
+    setWorkOfflineAccess(workId, enabled) {
+        this.db.transaction(() => {
+            const current = this.getWork(workId);
+            if (Boolean(current.offlineAccessEnabled) === enabled)
+                return;
+            const timestamp = now();
+            this.db.run("UPDATE works SET offline_access_enabled = ?, version_no = version_no + 1, updated_at = ? WHERE id = ?", enabled ? 1 : 0, timestamp, workId);
+            this.recordEntityVersion("work", workId, "manual", null, enabled ? "允许 Desktop 离线访问" : "禁止 Desktop 离线访问", timestamp);
+            this.audit(workId, enabled ? "work.offline-access.enabled" : "work.offline-access.disabled", "work", workId, { enabled });
+        });
+        return this.getWork(workId);
+    }
     deleteWork(workId, expectedVersionNo) {
         return this.db.transaction(() => {
             const current = this.getWork(workId);
@@ -1903,10 +2007,12 @@ export class Store {
         };
     }
     insertChapterVersionRow(input) {
+        const timestamp = input.timestamp ?? now();
         this.db.run(`INSERT INTO chapter_versions (
          id, work_id, chapter_id, version_no, title, content, volume_id, sort_order, chapter_type,
          source, source_ref, change_note, created_at, created_by_user_id
-       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("chapterVersion"), input.workId, input.chapterId, input.versionNo, input.title, input.content, input.volumeId, input.sortOrder, input.chapterType, input.source, input.sourceRef, input.changeNote.trim(), input.timestamp ?? now(), currentRequestActor()?.userId ?? null);
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("chapterVersion"), input.workId, input.chapterId, input.versionNo, input.title, input.content, input.volumeId, input.sortOrder, input.chapterType, input.source, input.sourceRef, input.changeNote.trim(), timestamp, currentRequestActor()?.userId ?? null);
+        this.recordSyncChange(input.workId, "chapter", input.chapterId, input.source === "delete" ? "delete" : "upsert", input.versionNo, timestamp);
     }
     listChapterVersions(chapterId) {
         const rows = this.findChapterVersionRows(chapterId);
@@ -1998,7 +2104,7 @@ export class Store {
         if (!hasTextChange && !hasOtherChange)
             return current;
         const timestamp = now();
-        const versionNo = Number(current.versionNo) + (hasTextChange ? 1 : 0);
+        const versionNo = Number(current.versionNo) + (hasTextChange || hasTypeChange ? 1 : 0);
         this.db.transaction(() => {
             const lockedCurrent = this.getChapter(chapterId);
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(lockedCurrent.versionNo));
@@ -2006,7 +2112,9 @@ export class Store {
          excluded_from_analysis = ?, updated_at = ? WHERE id = ?`, nextTitle, nextContent, nextChapterType, countWords(nextContent), versionNo, hasTextChange || hasTypeChange ? "expired" : String(current.analysisStatus), nextExcluded ? 1 : 0, timestamp, chapterId);
             if (hasTextChange)
                 this.syncChapterParagraphSearch(String(current.workId), chapterId, nextContent);
-            if (hasTextChange) {
+            else if (hasTypeChange)
+                this.syncChapterParagraphSearchVersion(chapterId, versionNo);
+            if (hasTextChange || hasTypeChange) {
                 this.insertChapterVersionRow({
                     workId: String(current.workId),
                     chapterId,
@@ -2018,7 +2126,7 @@ export class Store {
                     chapterType: nextChapterType,
                     source,
                     sourceRef,
-                    changeNote: changeNote || "更新章节正文",
+                    changeNote: changeNote || (hasTextChange ? "更新章节正文" : "更新章节类型"),
                     timestamp
                 });
             }
@@ -2530,9 +2638,28 @@ export class Store {
             }
             else if (action.type === "setType") {
                 for (const chapter of currentChapters) {
-                    this.db.run("UPDATE chapters SET chapter_type = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", action.chapterType, timestamp, String(chapter.id));
-                    this.invalidateChapter(workId, String(chapter.id), Number(chapter.versionNo));
-                    this.audit(workId, "chapter.saved", "chapter", String(chapter.id), { chapterType: action.chapterType, batch: true });
+                    if (chapter.chapterType === action.chapterType)
+                        continue;
+                    const chapterId = String(chapter.id);
+                    const versionNo = Number(chapter.versionNo) + 1;
+                    this.db.run("UPDATE chapters SET chapter_type = ?, version_no = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", action.chapterType, versionNo, timestamp, chapterId);
+                    this.syncChapterParagraphSearchVersion(chapterId, versionNo);
+                    this.insertChapterVersionRow({
+                        workId,
+                        chapterId,
+                        versionNo,
+                        title: String(chapter.title),
+                        content: String(chapter.content),
+                        volumeId: String(chapter.volumeId),
+                        sortOrder: Number(chapter.sortOrder),
+                        chapterType: action.chapterType,
+                        source: "manual",
+                        sourceRef: null,
+                        changeNote: "批量更新章节类型",
+                        timestamp
+                    });
+                    this.invalidateChapter(workId, chapterId, versionNo);
+                    this.audit(workId, "chapter.saved", "chapter", chapterId, { chapterType: action.chapterType, versionNo, batch: true });
                 }
             }
             else if (action.type === "setAnalysisExclusion") {
@@ -2956,6 +3083,7 @@ export class Store {
                 ? `/api/works/${encodeURIComponent(workId)}/cover?v=${encodeURIComponent(requiredString(cover, "updated_at"))}`
                 : optionalString(row, "cover_url"),
             tags: json(requiredString(row, "tags_json"), []),
+            offlineAccessEnabled: numberValue(row, "offline_access_enabled") === 1,
             versionNo: numberValue(row, "version_no") || this.currentEntityVersionNo("work", workId),
             ownerUserId,
             accessRole,
@@ -3704,18 +3832,20 @@ export class Store {
     }
     listDrafts(workId, draftType, includeContent = false) {
         this.getWork(workId);
-        return this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
+        const preferences = this.entityPreferenceProjection("draft", "draft");
+        return this.db.all(`SELECT draft.*, volume.title AS volume_title, ${preferences.columns} FROM drafts draft
        LEFT JOIN volumes volume ON volume.id = draft.volume_id
        WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
-       ORDER BY draft.is_favorite DESC, draft.updated_at DESC, draft.title`, workId, draftType ?? null, draftType ?? null).map((row) => this.mapDraft(row, includeContent));
+       ORDER BY ${preferences.orderBy}, draft.updated_at DESC, draft.title`, ...preferences.params, workId, draftType ?? null, draftType ?? null).map((row) => this.mapDraft(row, includeContent));
     }
     listDraftsPage(workId, pagination, draftType, includeContent = false) {
         this.getWork(workId);
+        const preferences = this.entityPreferenceProjection("draft", "draft");
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
+        const rows = this.db.all(`SELECT draft.*, volume.title AS volume_title, ${preferences.columns} FROM drafts draft
        LEFT JOIN volumes volume ON volume.id = draft.volume_id
        WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
-       ORDER BY draft.is_favorite DESC, draft.updated_at DESC, draft.title${page.sql}`, workId, draftType ?? null, draftType ?? null, ...page.params);
+       ORDER BY ${preferences.orderBy}, draft.updated_at DESC, draft.title${page.sql}`, ...preferences.params, workId, draftType ?? null, draftType ?? null, ...page.params);
         return paginated(rows.map((row) => this.mapDraft(row, includeContent)), pagination);
     }
     searchDrafts(workId, query, draftType, limit = 20) {
@@ -3724,22 +3854,24 @@ export class Store {
         const normalizedQuery = query.normalize("NFKC").trim();
         const escapedQuery = escapeSqlLikePattern(normalizedQuery);
         const pattern = `%${escapedQuery}%`;
+        const preferences = this.entityPreferenceProjection("draft", "draft");
         const rows = normalizedQuery
-            ? this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
+            ? this.db.all(`SELECT draft.*, volume.title AS volume_title, ${preferences.columns} FROM drafts draft
            LEFT JOIN volumes volume ON volume.id = draft.volume_id
            WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
              AND (draft.title LIKE ? ESCAPE '\\' COLLATE NOCASE OR draft.content LIKE ? ESCAPE '\\' COLLATE NOCASE)
-           ORDER BY CASE WHEN draft.title LIKE ? ESCAPE '\\' COLLATE NOCASE THEN 0 ELSE 1 END, draft.updated_at DESC
-           LIMIT ?`, workId, draftType ?? null, draftType ?? null, pattern, pattern, pattern, safeLimit)
-            : this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
+           ORDER BY ${preferences.orderBy}, CASE WHEN draft.title LIKE ? ESCAPE '\\' COLLATE NOCASE THEN 0 ELSE 1 END, draft.updated_at DESC
+           LIMIT ?`, ...preferences.params, workId, draftType ?? null, draftType ?? null, pattern, pattern, pattern, safeLimit)
+            : this.db.all(`SELECT draft.*, volume.title AS volume_title, ${preferences.columns} FROM drafts draft
            LEFT JOIN volumes volume ON volume.id = draft.volume_id
            WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
-           ORDER BY draft.updated_at DESC, draft.title LIMIT ?`, workId, draftType ?? null, draftType ?? null, safeLimit);
+           ORDER BY ${preferences.orderBy}, draft.updated_at DESC, draft.title LIMIT ?`, ...preferences.params, workId, draftType ?? null, draftType ?? null, safeLimit);
         return rows.map((row) => this.mapDraft(row, true));
     }
     getDraft(draftId) {
-        const row = this.db.get(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
-       LEFT JOIN volumes volume ON volume.id = draft.volume_id WHERE draft.id = ?`, draftId);
+        const preferences = this.entityPreferenceProjection("draft", "draft");
+        const row = this.db.get(`SELECT draft.*, volume.title AS volume_title, ${preferences.columns} FROM drafts draft
+       LEFT JOIN volumes volume ON volume.id = draft.volume_id WHERE draft.id = ?`, ...preferences.params, draftId);
         if (!row)
             throw notFound("想法");
         return this.mapDraft(row, true);
@@ -3749,13 +3881,30 @@ export class Store {
         if (!draft)
             throw notFound("想法");
         const workId = requiredString(draft, "work_id");
-        const previousFavorite = booleanValue(draft, "is_favorite");
         this.db.transaction(() => {
-            this.db.run("UPDATE drafts SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, draftId);
-            this.audit(workId, "draft.favorite-updated", "draft", draftId, {
-                previousFavorite,
-                isFavorite
-            });
+            const previousFavorite = this.setEntityFavorite(workId, "draft", draftId, isFavorite, booleanValue(draft, "is_favorite"));
+            if (previousFavorite !== isFavorite) {
+                this.audit(workId, "draft.favorite-updated", "draft", draftId, {
+                    previousFavorite,
+                    isFavorite
+                });
+            }
+        });
+        return this.getDraft(draftId);
+    }
+    setDraftPin(draftId, isPinned) {
+        const draft = this.db.get("SELECT id, work_id FROM drafts WHERE id = ?", draftId);
+        if (!draft)
+            throw notFound("想法");
+        const workId = requiredString(draft, "work_id");
+        this.db.transaction(() => {
+            const previousPin = this.setEntityPin(workId, "draft", draftId, isPinned);
+            if (previousPin !== isPinned) {
+                this.audit(workId, "draft.pin-updated", "draft", draftId, {
+                    previousPin,
+                    isPinned
+                });
+            }
         });
         return this.getDraft(draftId);
     }
@@ -3797,7 +3946,8 @@ export class Store {
             volumeTitle: optionalString(row, "volume_title"),
             settingModule: optionalString(row, "setting_module"),
             title: requiredString(row, "title"),
-            isFavorite: booleanValue(row, "is_favorite"),
+            isFavorite: this.mapEntityFavorite(row),
+            isPinned: this.mapEntityPin(row),
             ...(includeContent ? { content } : { contentPreview: content.replace(/\s+/gu, " ").trim().slice(0, 320) }),
             versionNo: this.currentEntityVersionNo("draft", requiredString(row, "id")),
             createdAt: requiredString(row, "created_at"),
@@ -3861,16 +4011,19 @@ export class Store {
     }
     listSettings(workId, includeContent = true) {
         this.getWork(workId);
-        return this.db.all("SELECT * FROM settings WHERE work_id = ? ORDER BY is_favorite DESC, locked DESC, category, title", workId).map((row) => this.mapSetting(row, includeContent));
+        const preferences = this.entityPreferenceProjection("setting", "setting");
+        return this.db.all(`SELECT setting.*, ${preferences.columns} FROM settings setting WHERE setting.work_id = ? ORDER BY ${preferences.orderBy}, setting.locked DESC, setting.category, setting.title`, ...preferences.params, workId).map((row) => this.mapSetting(row, includeContent));
     }
     listSettingsPage(workId, pagination, includeContent = true) {
         this.getWork(workId);
+        const preferences = this.entityPreferenceProjection("setting", "setting");
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM settings WHERE work_id = ? ORDER BY is_favorite DESC, locked DESC, category, title${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT setting.*, ${preferences.columns} FROM settings setting WHERE setting.work_id = ? ORDER BY ${preferences.orderBy}, setting.locked DESC, setting.category, setting.title${page.sql}`, ...preferences.params, workId, ...page.params);
         return paginated(rows.map((row) => this.mapSetting(row, includeContent)), pagination);
     }
     getSetting(settingId) {
-        const row = this.db.get("SELECT * FROM settings WHERE id = ?", settingId);
+        const preferences = this.entityPreferenceProjection("setting", "setting");
+        const row = this.db.get(`SELECT setting.*, ${preferences.columns} FROM settings setting WHERE setting.id = ?`, ...preferences.params, settingId);
         if (!row)
             throw notFound("设定");
         return this.mapSetting(row);
@@ -3880,13 +4033,30 @@ export class Store {
         if (!setting)
             throw notFound("设定");
         const workId = requiredString(setting, "work_id");
-        const previousFavorite = booleanValue(setting, "is_favorite");
         this.db.transaction(() => {
-            this.db.run("UPDATE settings SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, settingId);
-            this.audit(workId, "setting.favorite-updated", "setting", settingId, {
-                previousFavorite,
-                isFavorite
-            });
+            const previousFavorite = this.setEntityFavorite(workId, "setting", settingId, isFavorite, booleanValue(setting, "is_favorite"));
+            if (previousFavorite !== isFavorite) {
+                this.audit(workId, "setting.favorite-updated", "setting", settingId, {
+                    previousFavorite,
+                    isFavorite
+                });
+            }
+        });
+        return this.getSetting(settingId);
+    }
+    setSettingPin(settingId, isPinned) {
+        const setting = this.db.get("SELECT id, work_id FROM settings WHERE id = ?", settingId);
+        if (!setting)
+            throw notFound("设定");
+        const workId = requiredString(setting, "work_id");
+        this.db.transaction(() => {
+            const previousPin = this.setEntityPin(workId, "setting", settingId, isPinned);
+            if (previousPin !== isPinned) {
+                this.audit(workId, "setting.pin-updated", "setting", settingId, {
+                    previousPin,
+                    isPinned
+                });
+            }
         });
         return this.getSetting(settingId);
     }
@@ -3924,7 +4094,8 @@ export class Store {
             tags: json(requiredString(row, "tags_json"), []),
             status: requiredString(row, "status"),
             locked: booleanValue(row, "locked"),
-            isFavorite: booleanValue(row, "is_favorite"),
+            isFavorite: this.mapEntityFavorite(row),
+            isPinned: this.mapEntityPin(row),
             evidence: json(requiredString(row, "evidence_json"), []),
             scope: json(requiredString(row, "scope_json"), {}),
             authorNote: requiredString(row, "author_note"),
@@ -4238,19 +4409,22 @@ export class Store {
     }
     listOrganizations(workId, includeMarkdown = true) {
         this.getWork(workId);
-        const rows = this.db.all("SELECT * FROM organizations WHERE work_id = ? ORDER BY is_favorite DESC, name", workId);
+        const preferences = this.entityPreferenceProjection("organization", "organization");
+        const rows = this.db.all(`SELECT organization.*, ${preferences.columns} FROM organizations organization WHERE organization.work_id = ? ORDER BY ${preferences.orderBy}, organization.name`, ...preferences.params, workId);
         const batch = this.organizationListBatch(rows);
         return rows.map((row) => this.mapOrganization(row, includeMarkdown, batch));
     }
     listOrganizationsPage(workId, pagination, includeMarkdown = true) {
         this.getWork(workId);
+        const preferences = this.entityPreferenceProjection("organization", "organization");
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM organizations WHERE work_id = ? ORDER BY is_favorite DESC, name${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT organization.*, ${preferences.columns} FROM organizations organization WHERE organization.work_id = ? ORDER BY ${preferences.orderBy}, organization.name${page.sql}`, ...preferences.params, workId, ...page.params);
         const batch = this.organizationListBatch(rows);
         return paginated(rows.map((row) => this.mapOrganization(row, includeMarkdown, batch)), pagination);
     }
     getOrganization(organizationId) {
-        const row = this.db.get("SELECT * FROM organizations WHERE id = ?", organizationId);
+        const preferences = this.entityPreferenceProjection("organization", "organization");
+        const row = this.db.get(`SELECT organization.*, ${preferences.columns} FROM organizations organization WHERE organization.id = ?`, ...preferences.params, organizationId);
         if (!row)
             throw notFound("组织");
         return this.mapOrganization(row);
@@ -4260,13 +4434,30 @@ export class Store {
         if (!organization)
             throw notFound("组织");
         const workId = requiredString(organization, "work_id");
-        const previousFavorite = booleanValue(organization, "is_favorite");
         this.db.transaction(() => {
-            this.db.run("UPDATE organizations SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, organizationId);
-            this.audit(workId, "organization.favorite-updated", "organization", organizationId, {
-                previousFavorite,
-                isFavorite
-            });
+            const previousFavorite = this.setEntityFavorite(workId, "organization", organizationId, isFavorite, booleanValue(organization, "is_favorite"));
+            if (previousFavorite !== isFavorite) {
+                this.audit(workId, "organization.favorite-updated", "organization", organizationId, {
+                    previousFavorite,
+                    isFavorite
+                });
+            }
+        });
+        return this.getOrganization(organizationId);
+    }
+    setOrganizationPin(organizationId, isPinned) {
+        const organization = this.db.get("SELECT id, work_id FROM organizations WHERE id = ?", organizationId);
+        if (!organization)
+            throw notFound("组织");
+        const workId = requiredString(organization, "work_id");
+        this.db.transaction(() => {
+            const previousPin = this.setEntityPin(workId, "organization", organizationId, isPinned);
+            if (previousPin !== isPinned) {
+                this.audit(workId, "organization.pin-updated", "organization", organizationId, {
+                    previousPin,
+                    isPinned
+                });
+            }
         });
         return this.getOrganization(organizationId);
     }
@@ -4397,7 +4588,8 @@ export class Store {
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
             isDissolved: booleanValue(row, "is_dissolved"),
-            isFavorite: booleanValue(row, "is_favorite"),
+            isFavorite: this.mapEntityFavorite(row),
+            isPinned: this.mapEntityPin(row),
             ...(includeMarkdown
                 ? { settings, settingsMarkdown: settingsMarkdownFromList(settings), settingsSections }
                 : { settings: [], settingsCount: settingsSections.length }),
@@ -4516,14 +4708,16 @@ export class Store {
     }
     listCharacters(workId, includeProfileSections = false, includeMerged = false, includeRaceMarkdown = true) {
         this.getWork(workId);
-        return this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY is_favorite DESC, name`, workId)
+        const preferences = this.entityPreferenceProjection("character", "character");
+        return this.db.all(`SELECT character.*, ${preferences.columns} FROM characters character WHERE character.work_id = ?${includeMerged ? "" : " AND character.merged_into_character_id IS NULL"} ORDER BY ${preferences.orderBy}, character.name`, ...preferences.params, workId)
             .map((row) => this.mapCharacter(row, includeProfileSections, includeRaceMarkdown));
     }
     listCharactersPage(workId, pagination, includeProfileSections = false, includeMerged = false, includeRaceMarkdown = true) {
         this.getWork(workId);
+        const preferences = this.entityPreferenceProjection("character", "character");
         const page = paginationSql(pagination);
         const count = this.db.get(`SELECT COUNT(*) AS count FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"}`, workId);
-        const rows = this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY is_favorite DESC, name${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT character.*, ${preferences.columns} FROM characters character WHERE character.work_id = ?${includeMerged ? "" : " AND character.merged_into_character_id IS NULL"} ORDER BY ${preferences.orderBy}, character.name${page.sql}`, ...preferences.params, workId, ...page.params);
         return paginated(rows.map((row) => this.mapCharacter(row, includeProfileSections, includeRaceMarkdown)), pagination, Number(count?.count ?? 0));
     }
     mapCharacterProfileSection(row) {
@@ -4999,7 +5193,8 @@ export class Store {
         return { storageKey, cleanupQueued: !this.attachmentStorageKeyInUse(storageKey) };
     }
     getCharacter(characterId) {
-        const row = this.db.get("SELECT * FROM characters WHERE id = ?", characterId);
+        const preferences = this.entityPreferenceProjection("character", "character");
+        const row = this.db.get(`SELECT character.*, ${preferences.columns} FROM characters character WHERE character.id = ?`, ...preferences.params, characterId);
         if (!row)
             throw notFound("角色");
         return this.mapCharacter(row);
@@ -5012,15 +5207,33 @@ export class Store {
             throw new AppError(409, "CHARACTER_ALREADY_MERGED", "已合并角色不能收藏");
         }
         const workId = requiredString(character, "work_id");
-        const previousFavorite = booleanValue(character, "is_favorite");
-        if (previousFavorite === isFavorite)
-            return this.getCharacter(characterId);
         this.db.transaction(() => {
-            this.db.run("UPDATE characters SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, characterId);
-            this.audit(workId, "character.favorite-updated", "character", characterId, {
-                previousFavorite,
-                isFavorite
-            });
+            const previousFavorite = this.setEntityFavorite(workId, "character", characterId, isFavorite, booleanValue(character, "is_favorite"));
+            if (previousFavorite !== isFavorite) {
+                this.audit(workId, "character.favorite-updated", "character", characterId, {
+                    previousFavorite,
+                    isFavorite
+                });
+            }
+        });
+        return this.getCharacter(characterId);
+    }
+    setCharacterPin(characterId, isPinned) {
+        const character = this.db.get("SELECT id, work_id, merged_into_character_id FROM characters WHERE id = ?", characterId);
+        if (!character)
+            throw notFound("角色");
+        if (optionalString(character, "merged_into_character_id")) {
+            throw new AppError(409, "CHARACTER_ALREADY_MERGED", "已合并角色不能置顶");
+        }
+        const workId = requiredString(character, "work_id");
+        this.db.transaction(() => {
+            const previousPin = this.setEntityPin(workId, "character", characterId, isPinned);
+            if (previousPin !== isPinned) {
+                this.audit(workId, "character.pin-updated", "character", characterId, {
+                    previousPin,
+                    isPinned
+                });
+            }
         });
         return this.getCharacter(characterId);
     }
@@ -5298,7 +5511,8 @@ export class Store {
             profileSectionCount,
             currentState: json(requiredString(row, "current_state_json"), {}),
             isDead: booleanValue(row, "is_dead"),
-            isFavorite: booleanValue(row, "is_favorite"),
+            isFavorite: this.mapEntityFavorite(row),
+            isPinned: this.mapEntityPin(row),
             avatarUrl: avatarSha256
                 ? `/api/characters/${encodeURIComponent(characterId)}/avatar?v=${encodeURIComponent(avatarSha256)}`
                 : null,
@@ -6967,8 +7181,9 @@ export class Store {
                 scope.targetCharacters = targetCharacters;
         }
         const sourceVersions = this.analysisTaskSourceVersions(workId, scope);
-        this.db.run(`INSERT INTO analysis_tasks (id, work_id, model_id, task_type, scope_json, status, source_versions_json, created_at, updated_at, created_by_user_id)
-       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)`, taskId, workId, input.modelId ?? null, input.taskType, JSON.stringify(scope), JSON.stringify(sourceVersions), timestamp, timestamp, currentRequestActor()?.userId ?? null);
+        const actor = currentRequestActor();
+        this.db.run(`INSERT INTO analysis_tasks (id, work_id, model_id, task_type, scope_json, status, source_versions_json, created_at, updated_at, created_by_user_id, created_via_api_key)
+       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?, ?)`, taskId, workId, input.modelId ?? null, input.taskType, JSON.stringify(scope), JSON.stringify(sourceVersions), timestamp, timestamp, actor?.userId ?? null, actor?.authentication === "api-key" ? 1 : 0);
         this.audit(workId, "task.created", "analysis-task", taskId, {
             taskType: input.taskType,
             scope,