@musnows/scriverse 0.9.0 → 0.9.2

package/dist/public/styles.css

@@ -1517,9 +1517,16 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
 .record-card { position: relative; border: 1px solid var(--line); background: var(--surface-soft); padding: 18px; min-height: 130px; border-radius: 4px; }
 .record-card.has-card-edit h3 { padding-right: 34px; }
 .record-card.has-favorite-control h3 { padding-right: 70px; }
+.record-card.has-pin-control h3 { padding-right: 106px; }
 .record-card-edit { position: absolute; top: 12px; right: 12px; display: inline-grid; place-items: center; width: 28px; height: 28px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
 .record-card-edit:hover, .record-card-edit:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
 .record-card-edit svg { width: 14px; height: 14px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.7; }
+.character-pin-button { position: absolute; top: 12px; right: 84px; display: inline-grid; place-items: center; width: 28px; height: 28px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
+.character-pin-button:hover, .character-pin-button:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
+.character-pin-button.is-pinned { border-color: color-mix(in srgb, var(--accent) 58%, var(--line)); background: color-mix(in srgb, var(--accent) 10%, var(--surface)); color: var(--accent-dark); }
+.character-pin-button:disabled { cursor: not-allowed; opacity: .5; }
+.character-pin-button svg { width: 15px; height: 15px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.6; }
+.character-pin-button.is-pinned svg { fill: currentColor; }
 .character-favorite-button { position: absolute; top: 12px; right: 48px; display: inline-grid; place-items: center; width: 28px; height: 28px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
 .character-favorite-button:hover, .character-favorite-button:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
 .character-favorite-button.is-favorite { border-color: color-mix(in srgb, var(--accent) 58%, var(--line)); background: color-mix(in srgb, var(--accent) 10%, var(--surface)); color: var(--accent-dark); }
@@ -1533,12 +1540,25 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
 .record-favorite-button:disabled { cursor: not-allowed; opacity: .5; }
 .record-favorite-button svg { width: 15px; height: 15px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.6; }
 .record-favorite-button.is-favorite svg { fill: currentColor; }
+.record-pin-button { display: inline-grid; flex: 0 0 auto; place-items: center; width: 28px; height: 28px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
+.record-pin-button.is-card-control { position: absolute; top: 12px; right: 84px; }
+.record-pin-button:hover, .record-pin-button:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
+.record-pin-button.is-pinned { border-color: color-mix(in srgb, var(--accent) 58%, var(--line)); background: color-mix(in srgb, var(--accent) 10%, var(--surface)); color: var(--accent-dark); }
+.record-pin-button:disabled { cursor: not-allowed; opacity: .5; }
+.record-pin-button svg { width: 15px; height: 15px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.6; }
+.record-pin-button.is-pinned svg { fill: currentColor; }
 .entity-detail-favorite-button { display: inline-grid; flex: 0 0 36px; place-items: center; width: 36px; min-width: 36px; height: 36px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
 .entity-detail-favorite-button:hover, .entity-detail-favorite-button:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
 .entity-detail-favorite-button.is-favorite { border-color: color-mix(in srgb, var(--accent) 58%, var(--line)); background: color-mix(in srgb, var(--accent) 10%, var(--surface)); color: var(--accent-dark); }
 .entity-detail-favorite-button:disabled { cursor: not-allowed; opacity: .5; }
 .entity-detail-favorite-button svg { width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.6; }
 .entity-detail-favorite-button.is-favorite svg { fill: currentColor; }
+.entity-detail-pin-button { display: inline-grid; flex: 0 0 36px; place-items: center; width: 36px; min-width: 36px; height: 36px; padding: 0; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); }
+.entity-detail-pin-button:hover, .entity-detail-pin-button:focus-visible { border-color: var(--accent); color: var(--accent-dark); outline: none; }
+.entity-detail-pin-button.is-pinned { border-color: color-mix(in srgb, var(--accent) 58%, var(--line)); background: color-mix(in srgb, var(--accent) 10%, var(--surface)); color: var(--accent-dark); }
+.entity-detail-pin-button:disabled { cursor: not-allowed; opacity: .5; }
+.entity-detail-pin-button svg { width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.6; }
+.entity-detail-pin-button.is-pinned svg { fill: currentColor; }
 .record-card h3 { font-size: 16px; margin: 5px 0 10px; font-weight: 600; }
 .record-card p { color: var(--muted); font-size: 12px; line-height: 1.55; margin: 0; white-space: pre-wrap; }
 .record-card small { color: var(--accent); font-size: 9px; letter-spacing: .1em; text-transform: uppercase; }
@@ -1573,11 +1593,21 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
 .character-row { grid-template-columns: minmax(140px, .28fr) minmax(0, 1fr) auto; }
 .character-card-heading { display: flex; min-width: 0; align-items: center; gap: 7px; }
 .character-card-heading .character-avatar { width: 32px; height: 32px; font-size: 12px; }
-.character-card-heading h3 { min-width: 0; }
-.record-card.has-card-edit .character-card-heading { padding-right: 70px; }
+.character-card-heading h3 { flex: 1 1 0; min-width: 0; overflow-wrap: anywhere; }
+.record-card.has-card-edit .character-card-heading { padding-right: 70px; transform: translateY(-3px); }
+.record-card.has-card-edit.has-pin-control .character-card-heading { padding-right: 106px; }
 .record-card.has-card-edit .character-card-heading h3 { padding-right: 0; }
+.character-card.has-card-edit > .character-pin-button, .character-card.has-card-edit > .character-favorite-button, .character-card.has-card-edit > .record-card-edit { top: 18px; }
 .module-row .character-favorite-button { position: static; }
+.module-row .character-pin-button { position: static; }
 .module-row .record-favorite-button { position: static; }
+.module-row .record-pin-button { position: static; }
+@media (max-width: 560px) {
+  .character-card-heading h3 { font-size: 15px; }
+}
+@media (max-width: 420px) {
+  .character-card-heading h3 { font-size: 14px; }
+}
 .character-lock-badge { display: inline-flex; flex: 0 0 auto; align-items: center; gap: 3px; min-height: 20px; padding: 2px 6px; border: 1px solid color-mix(in srgb, var(--accent) 42%, var(--line)); border-radius: 10px; background: color-mix(in srgb, var(--accent) 10%, transparent); color: var(--accent-dark); font-size: 9px; font-variant-numeric: tabular-nums; line-height: 1; }
 .entity-lifecycle-badge { display: inline-flex; align-items: center; min-height: 20px; margin-left: 7px; padding: 2px 7px; border: 1px solid color-mix(in srgb, var(--accent) 58%, var(--line)); border-radius: 10px; background: color-mix(in srgb, var(--accent) 13%, var(--surface)); color: var(--accent-dark); font-size: 9px; font-weight: 650; line-height: 1; vertical-align: middle; white-space: nowrap; }
 .character-lock-badge svg { width: 11px; height: 11px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.8; }
@@ -3009,8 +3039,15 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
   animation: toast-appear-top .18s ease;
   pointer-events: auto;
 }
-.toast:not(.toast-confirmation):not(.chapter-insight-toast) { cursor: pointer; }
+.toast:not(.toast-confirmation):not(.chapter-insight-toast):not(.import-progress-toast) { cursor: pointer; }
 .toast.ai-new-conversation-toast { white-space: pre-line; }
+.import-progress-region,
+.import-progress-region:popover-open { top: auto; right: 24px; bottom: 24px; left: auto; }
+.import-progress-toast { display: grid; gap: 8px; width: min(360px, calc(100vw - 48px)); cursor: progress; }
+.import-progress-copy { display: grid; gap: 3px; }
+.import-progress-copy strong { font-size: 12px; }
+.import-progress-status { color: color-mix(in srgb, var(--toast-fg) 78%, transparent); font-size: 10px; }
+.import-progress-toast progress { width: 100%; height: 6px; accent-color: var(--accent); }
 .toast-region[data-position="bottom-right"] .toast { animation-name: toast-appear-bottom; }
 .toast.error {
   border-color: color-mix(in srgb, var(--toast-error-fg) 16%, transparent);
@@ -4066,6 +4103,7 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
   .module-content { padding: 18px 0 56px; }
   .card-grid, .provider-card-grid { grid-template-columns: minmax(0, 1fr); }
   .record-card { padding: 15px; }
+  .character-card.has-card-edit > .character-pin-button, .character-card.has-card-edit > .character-favorite-button, .character-card.has-card-edit > .record-card-edit { top: 8px; }
   .card-actions, .task-row-actions, .module-header-actions { gap: 8px; }
   .card-actions button, .task-row-actions button { flex: 1 1 auto; min-height: 38px; }
   .setting-row, .module-row { padding: 13px; }
@@ -4152,8 +4190,8 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
   .entity-editor-header, .character-editor-header { grid-template-columns: auto minmax(0, 1fr); gap: 8px; padding: 12px var(--mobile-gutter); }
   .entity-editor-mode-actions, .character-editor-header-actions { grid-column: 1 / -1; justify-content: stretch; flex-wrap: wrap; }
   .entity-editor-mode-actions > button, .character-editor-header-actions > button { flex: 1 1 auto; }
-  .entity-editor-mode-actions > .entity-detail-favorite-button, .character-editor-header-actions > .entity-detail-favorite-button { flex: 0 0 40px; width: 40px; min-width: 40px; height: 40px; }
-  .dialog-context-actions .entity-detail-favorite-button { flex-basis: 40px; width: 40px; min-width: 40px; height: 40px; }
+  .entity-editor-mode-actions > .entity-detail-favorite-button, .entity-editor-mode-actions > .entity-detail-pin-button, .character-editor-header-actions > .entity-detail-favorite-button, .character-editor-header-actions > .entity-detail-pin-button { flex: 0 0 40px; width: 40px; min-width: 40px; height: 40px; }
+  .dialog-context-actions .entity-detail-favorite-button, .dialog-context-actions .entity-detail-pin-button { flex-basis: 40px; width: 40px; min-width: 40px; height: 40px; }
   .setting-editor-header { min-height: 0; }
   .setting-editor-content { padding: 12px; }
   .setting-markdown-field { height: 68dvh; }

package/dist/store.js

@@ -1,6 +1,6 @@
 import { CHARACTER_GENDERS, DRAFT_SETTING_MODULES } from "./domain.js";
 import { createHash } from "node:crypto";
-import { ENTITY_VERSION_BASELINE_MIGRATION_VERSION, PLATFORM_AI_WORK_ID } from "./database.js";
+import { ENTITY_VERSION_BASELINE_MIGRATION_VERSION, PLATFORM_AI_WORK_ID, SYSTEM_USER_ID } from "./database.js";
 import { exportWorkDocx } from "./docx-export.js";
 import { createEpubArchive } from "./epub-export.js";
 import { AppError, notFound } from "./errors.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(() => {
@@ -716,11 +800,11 @@ export class Store {
         this.getWork(workId);
         if (type === "work") {
             return this.db.transaction(() => {
-                const ownerUserId = typeof snapshot.ownerUserId === "string" ? snapshot.ownerUserId : null;
+                const ownerUserId = this.resolveWorkOwnerUserId(typeof snapshot.ownerUserId === "string" ? snapshot.ownerUserId : null, true);
                 const timestamp = now();
                 this.db.run(`INSERT INTO works (id, title, author, description, language, cover_url, tags_json, version_no, created_at, updated_at, owner_user_id)
            VALUES (?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?)`, entityId, String(snapshot.title ?? "未命名作品"), String(snapshot.author ?? ""), String(snapshot.description ?? ""), String(snapshot.language ?? "zh-CN"), snapshot.coverUrl ?? null, JSON.stringify(Array.isArray(snapshot.tags) ? snapshot.tags : []), timestamp, timestamp, ownerUserId);
-                if (ownerUserId) {
+                if (ownerUserId !== SYSTEM_USER_ID) {
                     this.db.run("INSERT INTO work_memberships (work_id, user_id, role, invited_by_user_id, created_at) VALUES (?, ?, 'owner', ?, ?)", entityId, ownerUserId, ownerUserId, timestamp);
                 }
                 const versionNo = this.recordEntityVersion("work", entityId, "restore", sourceRef, changeNote, timestamp);
@@ -779,21 +863,29 @@ export class Store {
             }
         }
     }
-    createWork(input) {
+    createWork(input, ownerUserId = null) {
         const workId = id("work");
         const timestamp = now();
-        const actor = currentRequestActor();
+        const resolvedOwnerUserId = this.resolveWorkOwnerUserId(ownerUserId);
         this.db.transaction(() => {
             this.db.run(`INSERT INTO works (id, title, author, description, language, cover_url, tags_json, created_at, updated_at, owner_user_id)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, workId, input.title, input.author ?? "", input.description ?? "", input.language ?? "zh-CN", input.coverUrl ?? null, JSON.stringify(input.tags ?? []), timestamp, timestamp, actor?.userId ?? null);
-            if (actor) {
-                this.db.run("INSERT INTO work_memberships (work_id, user_id, role, invited_by_user_id, created_at) VALUES (?, ?, 'owner', ?, ?)", workId, actor.userId, actor.userId, timestamp);
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, workId, input.title, input.author ?? "", input.description ?? "", input.language ?? "zh-CN", input.coverUrl ?? null, JSON.stringify(input.tags ?? []), timestamp, timestamp, resolvedOwnerUserId);
+            if (resolvedOwnerUserId !== SYSTEM_USER_ID) {
+                this.db.run("INSERT INTO work_memberships (work_id, user_id, role, invited_by_user_id, created_at) VALUES (?, ?, 'owner', ?, ?)", workId, resolvedOwnerUserId, resolvedOwnerUserId, timestamp);
             }
             this.recordEntityVersion("work", workId, "create", null, "建立作品", timestamp);
             this.audit(workId, "work.created", "work", workId);
         });
         return this.getWork(workId);
     }
+    resolveWorkOwnerUserId(ownerUserId = null, allowUnknownFallback = false) {
+        const candidate = ownerUserId ?? currentRequestActor()?.userId ?? null;
+        if (candidate && this.db.get("SELECT 1 AS present FROM users WHERE id = ?", candidate))
+            return candidate;
+        if (candidate && !allowUnknownFallback)
+            throw new AppError(400, "WORK_OWNER_INVALID", "作品 Owner 用户不存在");
+        return SYSTEM_USER_ID;
+    }
     listWorks() {
         const actor = currentRequestActor();
         if (!actor) {
@@ -1618,9 +1710,9 @@ export class Store {
         this.db.transaction(() => { result = this.importNovelInTransaction(workId, fileName, fileType, parsed, mode, expectedVersionNo); });
         return { ...result, tree: this.getWorkDirectory(workId) };
     }
-    createImportedWork(input, fileName, fileType, parsed) {
+    createImportedWork(input, fileName, fileType, parsed, ownerUserId = null) {
         return this.db.transaction(() => {
-            const work = this.createWork(input);
+            const work = this.createWork(input, ownerUserId);
             const imported = this.importNovelInTransaction(String(work.id), fileName, fileType, parsed, undefined, undefined, false);
             return { ...imported, work: this.getWork(String(work.id)) };
         });
@@ -3748,18 +3840,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) {
@@ -3768,22 +3862,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);
@@ -3793,13 +3889,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);
     }
@@ -3841,7 +3954,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"),
@@ -3905,16 +4019,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);
@@ -3924,13 +4041,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);
     }
@@ -3968,7 +4102,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"),
@@ -4282,19 +4417,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);
@@ -4304,13 +4442,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);
     }
@@ -4441,7 +4596,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 }),
@@ -4560,14 +4716,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) {
@@ -5043,7 +5201,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);
@@ -5056,15 +5215,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);
     }
@@ -5342,7 +5519,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,