feat(server): W2-B sources, identity resolution, metadata and site workbench

- Sites / accounts / feeds: registry view (/site-definitions), site CRUD with
  enable/disable (history stays queryable, marked site_disabled), accounts and
  feed URLs stored as secrets (only secret_ref / redacted urlDisplay exposed),
  feed enable/disable/reset/fetch; one shared rate limiter + adapter per site.
- Tasks: ingestFeed (FeedFetchState/FeedCursor on feed_source, observation
  feed+guid upsert with digest-change updates, source_release site+id
  aggregation across feeds, auth failure -> account invalid + decision, no
  retry, gap -> feed.gap_suspected -> budgeted backfill snapshot),
  resolveObservation (parseRelease -> local recall via title_alias pg_trgm +
  accepted identities -> TMDB -> resolveIdentity; auto binds entity /
  provisional units / identities / aliases, otherwise identity_candidate pool
  with evidence version and bounded review backoff; manual lock respected),
  refreshMetadata (metadata_field + field_override, user locks win, paths
  untouched), snapshotSite (site_snapshot coverage records).
- Events: feed.due, feed.gap_suspected, release.observed (self-consumed),
  release.resolved, decision.created/updated; scheduler in worker start().
- Identity API: entity detail with redirects, manual mapping correction with
  identity_revision, merge with identity_redirect, pool list/assign/dismiss/
  retry, content unit numbering lock, aliases, external identities.
- Decisions: list/summary (by entity and kind)/detail/resolve; identity
  options executed directly.
- Workbench: /sites/{id}/releases (snapshot first, coalesced live search with
  backoff, origin + freshness) and /sites/{id}/releases/{rid} (volatile field
  recheck times, refresh keeps data on failure).
- Capabilities: catalog.lookup, release.search, release.inspect,
  identity.resolve.
- Migrations 0018-0020: site.adapter api, source_release.resolution_locked,
  site_snapshot, identity_candidate, resolution_attempt, identity_redirect,
  metadata_field, field_override.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/contracts/src/content.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { DateOnly, EntityBase, Id, JsonObject, SERVER_MANAGED, Timestamp } from "./common.ts";
+import { ActorType, DateOnly, EntityBase, Id, JsonObject, SERVER_MANAGED, Timestamp } from "./common.ts";
+import { ExternalIdentity } from "./identity.ts";
 
 // 内容域:本地作品、内容单元、别名(REQ §3.1、§5.1、§5.4、§7.5)
 // 本地 UUID 是主身份;季/集编号、外部 ID 都可修订,不是唯一身份。
@@ -127,3 +128,82 @@ export const TitleAliasCreate = TitleAlias.pick({
 export type TitleAliasCreate = z.infer<typeof TitleAliasCreate>;
 export const TitleAliasUpdate = TitleAliasCreate.omit({ mediaEntityId: true }).partial();
 export type TitleAliasUpdate = z.infer<typeof TitleAliasUpdate>;
+
+// ── W2-B:字段级元数据(REQ §7.3)与作品详情 ──
+
+export const MetadataSource = z.enum(["tmdb", "user", "agent", "nfo", "site", "import"]);
+export type MetadataSource = z.infer<typeof MetadataSource>;
+
+/** 某来源给出的一个候选字段值(刷新只写这里,不直接改最终展示值) */
+export const MetadataField = EntityBase.extend({
+  mediaEntityId: Id.nullable(),
+  contentUnitId: Id.nullable(),
+  field: z.string().min(1),
+  value: z.unknown(),
+  language: z.string().nullable(),
+  source: MetadataSource,
+  sourceRevision: z.string().nullable(),
+  fetchedAt: Timestamp,
+});
+export type MetadataField = z.infer<typeof MetadataField>;
+
+/** 字段覆盖:用户锁定优先于任何自动刷新 */
+export const FieldOverride = EntityBase.extend({
+  mediaEntityId: Id.nullable(),
+  contentUnitId: Id.nullable(),
+  field: z.string().min(1),
+  value: z.unknown(),
+  locked: z.boolean(),
+  source: MetadataSource,
+  reason: z.string().nullable(),
+  actorType: ActorType,
+  actorId: z.string().nullable(),
+});
+export type FieldOverride = z.infer<typeof FieldOverride>;
+
+/** 可覆盖/锁定的作品字段;title/originalTitle/year 同时投影到 media_entity 列 */
+export const EntityMetadataField = z.enum([
+  "title",
+  "originalTitle",
+  "year",
+  "overview",
+  "releaseDate",
+  "originalLanguage",
+  "originCountry",
+  "posterPath",
+]);
+export type EntityMetadataField = z.infer<typeof EntityMetadataField>;
+
+export const FieldOverrideInput = z.object({
+  value: z.unknown(),
+  lock: z.boolean().default(true),
+  reason: z.string().max(2000).optional(),
+});
+export type FieldOverrideInput = z.infer<typeof FieldOverrideInput>;
+
+/** media_entity.metadata 中每个最终字段的形状 */
+export const FinalFieldValue = z.object({
+  value: z.unknown(),
+  source: MetadataSource,
+  language: z.string().nullable(),
+  at: Timestamp,
+  locked: z.boolean(),
+});
+export type FinalFieldValue = z.infer<typeof FinalFieldValue>;
+
+/** 作品详情:外部身份、别名、内容单元、字段来源与覆盖 */
+export const MediaEntityDetail = z.object({
+  entity: MediaEntity,
+  /** 请求的是已合并的旧 ID 时,指向跳转后的实体 */
+  redirectedFrom: Id.nullable(),
+  identities: z.array(ExternalIdentity),
+  aliases: z.array(TitleAlias),
+  contentUnits: z.array(ContentUnit),
+  metadataFields: z.array(MetadataField),
+  overrides: z.array(FieldOverride),
+});
+export type MediaEntityDetail = z.infer<typeof MediaEntityDetail>;
+
+/** 合并重复作品(保留旧 ID 跳转) */
+export const MediaEntityMerge = z.object({ intoId: Id, reason: z.string().max(2000).optional() });
+export type MediaEntityMerge = z.infer<typeof MediaEntityMerge>;

packages/contracts/src/events.ts

@@ -4,7 +4,7 @@ import { Id, NonNegInt, Timestamp } from "./common.ts";
 import { DownloadStatus, PauseReason, TaskKind, TaskStatus } from "./execution.ts";
 import { EvidenceLevel } from "./identity.ts";
 import { OrganizationStatus } from "./organization.ts";
-import { FeedHealth } from "./sources.ts";
+import { FeedDuePayload, FeedGapSuspectedPayload, FeedHealth, ReleaseObservedPayload } from "./sources.ts";
 
 /** SSE 事件信封:seq 在进程内单调递增,客户端断线后用 ?after=<seq> 补读 */
 export const EventEnvelope = z.object({
@@ -41,7 +41,10 @@ export const EventType = {
 
   feedFetched: "feed.fetched",
   feedHealthChanged: "feed.health_changed",
+  feedDue: "feed.due",
+  feedGapSuspected: "feed.gap_suspected",
 
+  releaseObserved: "release.observed",
   releaseResolved: "release.resolved",
 
   decisionCreated: "decision.created",
@@ -175,6 +178,9 @@ export const EVENT_PAYLOADS = {
   "agent.tool_call": AgentToolCallPayload,
   "feed.fetched": FeedFetchedPayload,
   "feed.health_changed": FeedHealthChangedPayload,
+  "feed.due": FeedDuePayload,
+  "feed.gap_suspected": FeedGapSuspectedPayload,
+  "release.observed": ReleaseObservedPayload,
   "release.resolved": ReleaseResolvedPayload,
   "decision.created": DecisionCreatedPayload,
   "decision.updated": DecisionUpdatedPayload,

packages/contracts/src/identity.ts

@@ -119,3 +119,142 @@ export const IdentityRevisionCreate = IdentityRevision.pick({
   reason: true,
 }).partial({ fromStatus: true, toStatus: true, before: true, actorId: true, reason: true });
 export type IdentityRevisionCreate = z.infer<typeof IdentityRevisionCreate>;
+
+// ── W2-B:待识别池、识别尝试、合并跳转与人工纠错(REQ §7.2、§7.5) ──
+
+export const IdentityCandidateStatus = z.enum(["pending", "resolved", "dismissed", "archived"]);
+export type IdentityCandidateStatus = z.infer<typeof IdentityCandidateStatus>;
+/** proposed = 证据足够但自动化关闭/只读,待确认 */
+export const IdentityCandidateReason = z.enum(["ambiguous", "no_match", "proposed", "lookup_failed"]);
+export type IdentityCandidateReason = z.infer<typeof IdentityCandidateReason>;
+
+/** 待识别池里的一个候选(只存 JSON,不建正式作品) */
+export const PoolCandidate = z.object({
+  provider: z.string(),
+  entityType: z.enum(["movie", "tv"]),
+  externalId: z.string(),
+  title: z.string(),
+  year: z.number().int().nullable(),
+  /** 本地候选的作品 ID */
+  localEntityId: Id.nullable(),
+  level: z.enum(["rule_confirmed", "multi_evidence", "needs_confirm", "rejected"]),
+  evidence: z.array(z.string()),
+});
+export type PoolCandidate = z.infer<typeof PoolCandidate>;
+
+/** 待识别池条目:每条 source_release 至多一条;失败原因、证据版本与下一次复查时间 */
+export const IdentityCandidate = EntityBase.extend({
+  sourceReleaseId: Id,
+  status: IdentityCandidateStatus,
+  reason: IdentityCandidateReason,
+  /** 解析出的检索条件(标题/年份/季集) */
+  query: JsonObject,
+  candidates: z.array(PoolCandidate),
+  evidenceVersion: z.string(),
+  attempts: z.number().int().nonnegative(),
+  lastAttemptAt: Timestamp.nullable(),
+  nextReviewAt: Timestamp.nullable(),
+  decisionId: Id.nullable(),
+  resolvedMediaEntityId: Id.nullable(),
+  resolvedBy: z.string().nullable(),
+  resolvedAt: Timestamp.nullable(),
+});
+export type IdentityCandidate = z.infer<typeof IdentityCandidate>;
+
+export const ResolutionOutcome = z.enum([
+  "auto",
+  "proposed",
+  "ambiguous",
+  "no_match",
+  "lookup_failed",
+  "manual",
+  "skipped_locked",
+]);
+export type ResolutionOutcome = z.infer<typeof ResolutionOutcome>;
+
+/** 一次识别尝试(只追加) */
+export const ResolutionAttempt = EntityBase.extend({
+  sourceReleaseId: Id,
+  observationId: Id.nullable(),
+  outcome: ResolutionOutcome,
+  reason: z.string().nullable(),
+  evidenceVersion: z.string(),
+  candidateCount: z.number().int().nonnegative(),
+  mediaEntityId: Id.nullable(),
+  best: JsonObject.nullable(),
+  error: JsonObject.nullable(),
+  actorType: ActorType,
+  actorId: z.string().nullable(),
+});
+export type ResolutionAttempt = z.infer<typeof ResolutionAttempt>;
+
+/** 作品合并后的旧 ID 跳转 */
+export const IdentityRedirect = EntityBase.extend({
+  fromEntityId: Id,
+  toEntityId: Id,
+  reason: z.string().nullable(),
+  actorType: ActorType,
+  actorId: z.string().nullable(),
+});
+export type IdentityRedirect = z.infer<typeof IdentityRedirect>;
+
+/** 外部身份引用(provider + 类型 + ID) */
+export const ExternalRef = z.object({
+  provider: IdentityProvider,
+  entityType: z.enum(["movie", "tv"]),
+  externalId: z.string().min(1),
+});
+export type ExternalRef = z.infer<typeof ExternalRef>;
+
+/**
+ * 人工指定来源资源的身份:本地作品 / 外部身份(未登记时按外部详情建档)/ 池内候选序号,三选一。
+ * 指定后加人工锁,自动识别不再改写。
+ */
+export const ReleaseIdentityAssign = z
+  .object({
+    mediaEntityId: Id.optional(),
+    external: ExternalRef.optional(),
+    candidateIndex: z.number().int().min(0).optional(),
+    /** 同时关联到某个内容单元(季/集);缺省按解析出的季集建临时单元 */
+    contentUnitId: Id.nullable().optional(),
+    lock: z.boolean().default(true),
+    reason: z.string().max(2000).optional(),
+  })
+  .refine((v) => [v.mediaEntityId, v.external, v.candidateIndex].filter((x) => x !== undefined).length === 1, {
+    message: "mediaEntityId / external / candidateIndex 必须且只能给一个",
+  });
+export type ReleaseIdentityAssign = z.infer<typeof ReleaseIdentityAssign>;
+
+/** 改作品的外部映射:旧的同 provider+类型 accepted 映射退役(留修订),新映射 accepted + 人工锁 */
+export const EntityIdentitySet = ExternalRef.extend({
+  reason: z.string().max(2000).optional(),
+  /** 默认加人工锁 */
+  lock: z.boolean().default(true),
+});
+export type EntityIdentitySet = z.infer<typeof EntityIdentitySet>;
+
+export const IdentityPoolQuery = z.object({
+  status: IdentityCandidateStatus.optional(),
+  reason: IdentityCandidateReason.optional(),
+  /** 按原始标题/解析标题检索(已观察到的资源必须能从待识别入口找回) */
+  q: z.string().trim().min(1).max(200).optional(),
+  siteId: Id.optional(),
+  cursor: z.string().min(1).optional(),
+  limit: z.coerce.number().int().min(1).max(200).default(50),
+});
+export type IdentityPoolQuery = z.infer<typeof IdentityPoolQuery>;
+
+/** 待识别池列表条目:附来源资源摘要 */
+export const IdentityPoolItem = IdentityCandidate.extend({
+  release: z.object({
+    id: Id,
+    siteId: Id,
+    siteReleaseId: z.string(),
+    title: z.string(),
+    subtitle: z.string().nullable(),
+    categoryRaw: z.string().nullable(),
+    firstSeenAt: Timestamp,
+    resolutionStatus: z.string(),
+  }),
+});
+export type IdentityPoolItem = z.infer<typeof IdentityPoolItem>;

packages/contracts/src/sources.ts

@@ -4,7 +4,8 @@ import { EntityBase, Id, JsonObject, NonNegInt, SERVER_MANAGED, Timestamp } from
 // 来源域:站点、站点账号、Feed、站点资源、观察(REQ §4)
 // 含 passkey 的 Feed URL 只以 urlSecretRef 保存,对外只给脱敏的 urlDisplay。
 
-export const SiteAdapter = z.enum(["nexusphp", "mteam_api", "generic_rss"]);
+/** api = MP 专用 API spider(Haidan/HDDolby/RousiPro/SunnyPT/TNode/TorrentLeech/Yema) */
+export const SiteAdapter = z.enum(["nexusphp", "mteam_api", "api", "generic_rss"]);
 export type SiteAdapter = z.infer<typeof SiteAdapter>;
 export const SiteHealth = z.enum(["unknown", "healthy", "degraded", "failing", "disabled"]);
 export type SiteHealth = z.infer<typeof SiteHealth>;
@@ -180,6 +181,8 @@ export const SourceRelease = EntityBase.extend({
   resolutionEvidence: JsonObject,
   availability: ReleaseAvailability,
   raw: JsonObject,
+  /** 人工确认的身份关联:自动识别/复查不得改写 mediaEntityId/contentUnitId */
+  resolutionLocked: z.boolean(),
 });
 export type SourceRelease = z.infer<typeof SourceRelease>;
 /** 由适配器/任务写入(按 siteId+siteReleaseId upsert) */
@@ -209,6 +212,7 @@ export const SourceReleaseCreate = SourceRelease.omit({
   resolutionEvidence: true,
   availability: true,
   raw: true,
+  resolutionLocked: true,
 });
 export type SourceReleaseCreate = z.infer<typeof SourceReleaseCreate>;
 export const SourceReleaseUpdate = SourceReleaseCreate.omit({ siteId: true, siteReleaseId: true }).partial();
@@ -259,3 +263,143 @@ export const ObservationUpdate = Observation.pick({
   lastError: true,
 }).partial();
 export type ObservationUpdate = z.infer<typeof ObservationUpdate>;
+
+// ── W2-B:站点快照、调度事件与站点工作台 ──
+
+export const SiteSnapshotKind = z.enum(["periodic", "backfill", "live_search", "manual"]);
+export type SiteSnapshotKind = z.infer<typeof SiteSnapshotKind>;
+export const SiteSnapshotStatus = z.enum(["running", "ok", "partial", "failed"]);
+export type SiteSnapshotStatus = z.infer<typeof SiteSnapshotStatus>;
+
+/** 一次列表快照 / 实时补查 / 补漏的覆盖范围与结果(不把一次分页伪称全站快照,REQ §4.6) */
+export const SiteSnapshot = EntityBase.extend({
+  siteId: Id,
+  kind: SiteSnapshotKind,
+  query: z.string().nullable(),
+  filters: JsonObject,
+  /** 实际抓取的页码(1 起) */
+  pages: z.array(z.number().int().positive()),
+  itemCount: NonNegInt,
+  newCount: NonNegInt,
+  status: SiteSnapshotStatus,
+  error: JsonObject.nullable(),
+  definitionVersion: z.string().nullable(),
+  startedAt: Timestamp,
+  finishedAt: Timestamp.nullable(),
+});
+export type SiteSnapshot = z.infer<typeof SiteSnapshot>;
+
+/** 站点注册表条目(随产品发布的适配器定义)+ 是否已在本系统登记 */
+export const SiteDefinitionView = z.object({
+  key: z.string(),
+  name: z.string(),
+  adapter: SiteAdapter,
+  baseUrl: z.string(),
+  /** 定义是否随产品启用(未实测站点为 false) */
+  shippedEnabled: z.boolean(),
+  definitionVersion: z.string(),
+  capabilities: z.object({
+    list: z.boolean(),
+    search: z.boolean(),
+    detail: z.boolean(),
+    download: z.boolean(),
+    rss: z.boolean(),
+  }),
+  defaultRateLimit: z.object({ minIntervalMs: NonNegInt, burst: z.number().int().positive() }),
+  authSupported: z.array(z.string()),
+  /** 已登记的 site 行 ID;未登记为 null */
+  siteId: Id.nullable(),
+});
+export type SiteDefinitionView = z.infer<typeof SiteDefinitionView>;
+
+/** Feed 到期(调度器发出,outbox 路由到 ingestFeed) */
+export const FeedDuePayload = z.object({ feedId: Id, reason: z.enum(["schedule", "manual"]) });
+/** 新的 source_release 被观察到(或同一资源标题更新),outbox 路由到 resolveObservation */
+export const ReleaseObservedPayload = z.object({
+  sourceReleaseId: Id,
+  observationId: Id.nullable(),
+  siteId: Id,
+  isNew: z.boolean(),
+});
+/** Feed 窗口与上次零重叠:疑似缺口,路由到有预算的列表补漏(snapshotSite backfill) */
+export const FeedGapSuspectedPayload = z.object({
+  feedId: Id,
+  siteId: Id.nullable(),
+  previousFetchedAt: Timestamp.nullable(),
+  detectedAt: Timestamp,
+});
+
+/** 站点工作台列表查询(整理视图):快照优先,必要时实时补查 */
+export const WorkbenchReleaseQuery = z.object({
+  q: z.string().trim().min(1).max(200).optional(),
+  category: z.string().max(100).optional(),
+  /** 只看某类促销(free/2xfree/50%…) */
+  promotion: z.string().max(20).optional(),
+  resolution: ResolutionStatus.optional(),
+  /** true = 强制实时补查;false = 只看本地快照;缺省 = 本地无结果或快照过期时补查 */
+  live: z.enum(["true", "false"]).optional(),
+  cursor: z.string().min(1).optional(),
+  limit: z.coerce.number().int().min(1).max(200).default(50),
+});
+export type WorkbenchReleaseQuery = z.infer<typeof WorkbenchReleaseQuery>;
+
+/** 数据来源:快照 / Feed 观察 / 实时补查 */
+export const ReleaseOrigin = z.enum(["snapshot", "feed", "live", "unknown"]);
+export type ReleaseOrigin = z.infer<typeof ReleaseOrigin>;
+
+/**
+ * 工作台条目:source_release + 来源标注 + 本地实体关联。
+ * 库存叠加(已有资产/Slot/下载状态)由前端按 mediaEntityId 二次查询 W2-C 端点,不在这里猜。
+ */
+export const WorkbenchRelease = SourceRelease.extend({
+  origin: ReleaseOrigin,
+  /** 本条数据最近一次被站点确认的时间(快照/Feed/实时) */
+  dataUpdatedAt: Timestamp,
+  observedByFeeds: NonNegInt,
+  entity: z.object({ id: Id, title: z.string(), year: z.number().int().nullable(), kind: z.string() }).nullable(),
+});
+export type WorkbenchRelease = z.infer<typeof WorkbenchRelease>;
+
+export const WorkbenchCoverage = z.object({
+  siteEnabled: z.boolean(),
+  lastSnapshotAt: Timestamp.nullable(),
+  /** 快照过期(超过 2 个周期或从未快照) */
+  stale: z.boolean(),
+  fromSnapshot: z.boolean(),
+  live: z.boolean(),
+  liveError: z.string().nullable(),
+  /** 同一搜索正在进行时合并到已有请求 */
+  coalesced: z.boolean(),
+});
+export type WorkbenchCoverage = z.infer<typeof WorkbenchCoverage>;
+
+export const WorkbenchReleasePage = z.object({
+  items: z.array(WorkbenchRelease),
+  nextCursor: z.string().nullable(),
+  coverage: WorkbenchCoverage,
+});
+export type WorkbenchReleasePage = z.infer<typeof WorkbenchReleasePage>;
+
+export const WorkbenchReleaseDetail = z.object({
+  release: WorkbenchRelease,
+  observations: z.array(
+    z.object({
+      observationId: Id,
+      feedId: Id,
+      feedName: z.string(),
+      firstSeenAt: Timestamp,
+      lastSeenAt: Timestamp,
+    }),
+  ),
+  /** 易变字段的复核时间:缓存命中不能替代下载前复核(REQ §4.6) */
+  volatile: z.object({
+    promotionObservedAt: Timestamp.nullable(),
+    promotionExpiresAt: Timestamp.nullable(),
+    peersObservedAt: Timestamp,
+    detailFetchedAt: Timestamp.nullable(),
+    recheckBeforeDownload: z.literal(true),
+  }),
+  /** 刷新详情失败时保留既有数据并给出原因 */
+  refreshError: z.string().nullable(),
+});
+export type WorkbenchReleaseDetail = z.infer<typeof WorkbenchReleaseDetail>;

packages/contracts/test/db-sync.test.ts

@@ -79,6 +79,13 @@ const ROWS: Record<string, { row: Obj; dbOnly?: string[]; apiOnly?: string[] }>
   Subscription: { row: C.Subscription },
   Task: { row: C.Task },
   TitleAlias: { row: C.TitleAlias },
+  // W2-B 来源/身份/元数据(0018–0020)
+  FieldOverride: { row: C.FieldOverride },
+  IdentityCandidate: { row: C.IdentityCandidate },
+  IdentityRedirect: { row: C.IdentityRedirect },
+  MetadataField: { row: C.MetadataField },
+  ResolutionAttempt: { row: C.ResolutionAttempt },
+  SiteSnapshot: { row: C.SiteSnapshot },
 };
 
 /** 引擎自有表(@umt/tasks 内部使用,不经 API 暴露),不要求 Row schema */
@@ -186,6 +193,17 @@ const ENUMS: Record<string, z.ZodEnum> = {
   TaskStatus: C.TaskStatus,
   TitleAliasKind: C.AliasKind,
   TitleAliasSource: C.AliasSource,
+  // W2-B(0018–0020)
+  FieldOverrideSource: C.MetadataSource,
+  FieldOverrideActorType: C.ActorType,
+  IdentityCandidateStatus: C.IdentityCandidateStatus,
+  IdentityCandidateReason: C.IdentityCandidateReason,
+  IdentityRedirectActorType: C.ActorType,
+  MetadataFieldSource: C.MetadataSource,
+  ResolutionAttemptOutcome: C.ResolutionOutcome,
+  ResolutionAttemptActorType: C.ActorType,
+  SiteSnapshotKind: C.SiteSnapshotKind,
+  SiteSnapshotStatus: C.SiteSnapshotStatus,
 };
 
 describe("contracts ⇔ db 表结构同步", () => {

packages/contracts/test/schemas.test.ts

@@ -91,6 +91,7 @@ const OVERRIDES: Record<string, (v: Record<string, unknown>) => Record<string, u
   CatalogLookupInput: (v) => v,
   IdentityResolveInput: (v) => v,
   AssetLocationCreate: (v) => v,
+  ReleaseIdentityAssign: (v) => ({ ...v, external: undefined, candidateIndex: undefined }),
   CacheSettings: (v) => ({ ...v, hardThresholdPercent: 90, resumePercent: 85, cleanupTargetPercent: 80 }),
   GlobalSettings: () => C.DEFAULT_SETTINGS,
   EngineStats: (v) => ({ ...v, byStatus: { pending: 1 } }),

packages/db/README.md

@@ -29,6 +29,9 @@ PostgreSQL 访问层:Kysely 客户端与连接池、表类型(`src/types.ts`)、
 | `0012_organization` | organization_record(change_seq 序列 + 触发器)、organization_file_result;回填 asset_operation.organization_record_id |
 | `0013_tasks_tables` | 并入 @umt/tasks 自有表:tasks_run_meta、tasks_fact、tasks_op_ledger(if not exists,可接管 W1 旧库) |
 | `0014_agent_run_event` | agent_run_event:Agent 运行事件,主键 (run_id, seq),删 run 级联 |
+| `0018_sources_snapshot` | site.adapter 增加 `api`;source_release.resolution_locked(人工锁);site_snapshot(快照/补漏/实时补查的覆盖范围) |
+| `0019_identity_pool` | identity_candidate(待识别池)、resolution_attempt(识别尝试)、identity_redirect(合并跳转) |
+| `0020_metadata_fields` | metadata_field(来源候选字段)、field_override(用户覆盖与锁定) |
 
 ## 表清单(45 张)
 
@@ -59,6 +62,11 @@ PostgreSQL 访问层:Kysely 客户端与连接池、表类型(`src/types.ts`)、
 | `title_alias` | 原名/译名/简称/站点原标题;`normalized` 上建 gin trgm 索引做模糊召回 |
 | `external_identity` | 本地对象 ↔ 外部 ID;**`(provider, entity_type, external_id)` 对 accepted 部分唯一**,同一本地对象每个 provider+type 只有一个 accepted;候选(proposed/conflicted)可并存;404/超时只记 `verify_status` |
 | `identity_revision` | 身份每次变更的修订历史,`(external_identity_id, revision)` 唯一,只追加 |
+| `identity_candidate` | 待识别池:每条 source_release 至多一条;候选只存 JSON(不建正式作品),保存原因/证据版本/复查时间(有界退避) |
+| `resolution_attempt` | 每次识别尝试的结果与证据版本,只追加 |
+| `identity_redirect` | 作品合并后的旧 ID 跳转,`from_entity_id` 唯一 |
+| `metadata_field` | 各来源的候选字段值(来源/语言/时间/来源修订);刷新只写这里 |
+| `field_override` | 用户字段覆盖与锁定,优先于自动来源;目标 + 字段唯一 |
 
 ### 来源
 | 表 | 用途与关键不变量 |
@@ -68,6 +76,7 @@ PostgreSQL 访问层:Kysely 客户端与连接池、表类型(`src/types.ts`)、
 | `feed_source` | RSS/列表/查询入口;真实 URL(含 passkey)只在 `url_secret_ref`,对外只给 `url_display`;按 `next_fetch_at` 调度 |
 | `source_release` | 站点资源;**`(site_id, site_release_id)` 唯一**,多 Feed 观察汇到同一行;`source_published_at`/`first_seen_at` 分开 |
 | `observation` | 一次原始观察;**`(feed_id, guid)` 唯一**,`content_digest` 变化即条目更新 |
+| `site_snapshot` | 一次列表快照 / 补漏 / 实时补查:页码、条目数、状态与错误(新鲜度来源) |
 
 ### 文件
 | 表 | 用途与关键不变量 |

packages/db/migrations/0018_sources_snapshot.ts

@@ -0,0 +1,51 @@
+import type { Kysely } from "kysely";
+import { dropTables, entityTable, execDdl, oneOf } from "../src/migration-helpers.ts";
+
+// W2-B 来源补充(REQ §4.5、§4.6、§7.5):
+// - site.adapter 增加 api(MP 专用 API spider:Haidan/HDDolby/RousiPro/…,见 adapters/sites/spiders);
+// - source_release.resolution_locked:人工确认的身份关联,自动识别不得改写;
+// - site_snapshot:每次列表快照/实时补查/补漏的覆盖范围与新鲜度(不把一次分页伪称全站快照)。
+
+// biome-ignore lint/suspicious/noExplicitAny: 迁移不依赖应用表类型
+export async function up(db: Kysely<any>): Promise<void> {
+  await execDdl(
+    db,
+    `
+alter table site drop constraint site_adapter_check;
+alter table site add constraint site_adapter_check ${oneOf("adapter", ["nexusphp", "mteam_api", "api", "generic_rss"])};
+
+alter table source_release add column resolution_locked boolean not null default false;
+
+${entityTable(
+  "site_snapshot",
+  `
+  site_id uuid not null references site (id) on delete cascade,
+  kind text not null ${oneOf("kind", ["periodic", "backfill", "live_search", "manual"])},
+  query text,
+  filters jsonb not null default '{}'::jsonb,
+  pages jsonb not null default '[]'::jsonb,
+  item_count integer not null default 0,
+  new_count integer not null default 0,
+  status text not null default 'running' ${oneOf("status", ["running", "ok", "partial", "failed"])},
+  error jsonb,
+  definition_version text,
+  started_at timestamptz not null default now(),
+  finished_at timestamptz`,
+)}
+create index site_snapshot_site_idx on site_snapshot (site_id, started_at desc);
+`,
+  );
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: 同上
+export async function down(db: Kysely<any>): Promise<void> {
+  await execDdl(
+    db,
+    `
+${dropTables(["site_snapshot"])}
+alter table source_release drop column if exists resolution_locked;
+alter table site drop constraint site_adapter_check;
+alter table site add constraint site_adapter_check ${oneOf("adapter", ["nexusphp", "mteam_api", "generic_rss"])};
+`,
+  );
+}

packages/db/migrations/0019_identity_pool.ts

@@ -0,0 +1,74 @@
+import type { Kysely } from "kysely";
+import { dropTables, entityTable, execDdl, oneOf } from "../src/migration-helpers.ts";
+
+// W2-B 待识别池与身份治理(REQ §7.2、§7.5):
+// - identity_candidate:每条 source_release 至多一条待识别记录,候选只存 JSON,不逐个建为正式作品;
+//   失败保存原因、证据版本与下一次复查时间(有界退避),新证据到来时重试;
+// - resolution_attempt:每次识别尝试的结果与证据版本(只追加);
+// - identity_redirect:作品合并后的旧 ID 跳转历史(与 media_entity.merged_into_id 一致,可修订)。
+
+const ACTOR = ["user", "agent", "system", "api_key"] as const;
+
+// biome-ignore lint/suspicious/noExplicitAny: 迁移不依赖应用表类型
+export async function up(db: Kysely<any>): Promise<void> {
+  await execDdl(
+    db,
+    `
+${entityTable(
+  "identity_candidate",
+  `
+  source_release_id uuid not null references source_release (id) on delete cascade,
+  status text not null default 'pending' ${oneOf("status", ["pending", "resolved", "dismissed", "archived"])},
+  reason text not null ${oneOf("reason", ["ambiguous", "no_match", "proposed", "lookup_failed"])},
+  query jsonb not null default '{}'::jsonb,
+  candidates jsonb not null default '[]'::jsonb,
+  evidence_version text not null,
+  attempts integer not null default 0,
+  last_attempt_at timestamptz,
+  next_review_at timestamptz,
+  decision_id uuid references decision (id) on delete set null,
+  resolved_media_entity_id uuid references media_entity (id) on delete set null,
+  resolved_by text,
+  resolved_at timestamptz,
+  constraint identity_candidate_release_key unique (source_release_id)`,
+)}
+create index identity_candidate_review_idx on identity_candidate (next_review_at) where status = 'pending';
+create index identity_candidate_status_idx on identity_candidate (status, updated_at desc);
+
+${entityTable(
+  "resolution_attempt",
+  `
+  source_release_id uuid not null references source_release (id) on delete cascade,
+  observation_id uuid references observation (id) on delete set null,
+  outcome text not null ${oneOf("outcome", ["auto", "proposed", "ambiguous", "no_match", "lookup_failed", "manual", "skipped_locked"])},
+  reason text,
+  evidence_version text not null,
+  candidate_count integer not null default 0,
+  media_entity_id uuid references media_entity (id) on delete set null,
+  best jsonb,
+  error jsonb,
+  actor_type text not null default 'system' ${oneOf("actor_type", ACTOR)},
+  actor_id text`,
+)}
+create index resolution_attempt_release_idx on resolution_attempt (source_release_id, created_at desc);
+
+${entityTable(
+  "identity_redirect",
+  `
+  from_entity_id uuid not null references media_entity (id) on delete cascade,
+  to_entity_id uuid not null references media_entity (id) on delete cascade,
+  reason text,
+  actor_type text not null ${oneOf("actor_type", ACTOR)},
+  actor_id text,
+  constraint identity_redirect_from_key unique (from_entity_id),
+  constraint identity_redirect_not_self check (from_entity_id <> to_entity_id)`,
+)}
+create index identity_redirect_to_idx on identity_redirect (to_entity_id);
+`,
+  );
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: 同上
+export async function down(db: Kysely<any>): Promise<void> {
+  await execDdl(db, dropTables(["identity_redirect", "resolution_attempt", "identity_candidate"]));
+}

packages/db/migrations/0020_metadata_fields.ts

@@ -0,0 +1,54 @@
+import type { Kysely } from "kysely";
+import { dropTables, entityTable, execDdl, oneOf } from "../src/migration-helpers.ts";
+
+// W2-B 字段级元数据协调(REQ §7.3):
+// - metadata_field:各来源的候选字段值(来源/语言/时间/来源修订),刷新只写这里;
+// - field_override:用户(或 Agent 生成并确认)的字段覆盖与锁定,优先于任何自动来源;
+// 最终展示值投影到 media_entity.metadata / content_unit.metadata。路径绑定不受元数据刷新影响。
+
+const SOURCE = ["tmdb", "user", "agent", "nfo", "site", "import"] as const;
+const target = "constraint {t}_target_check check (num_nonnulls(media_entity_id, content_unit_id) = 1)";
+
+// biome-ignore lint/suspicious/noExplicitAny: 迁移不依赖应用表类型
+export async function up(db: Kysely<any>): Promise<void> {
+  await execDdl(
+    db,
+    `
+${entityTable(
+  "metadata_field",
+  `
+  media_entity_id uuid references media_entity (id) on delete cascade,
+  content_unit_id uuid references content_unit (id) on delete cascade,
+  field text not null,
+  value jsonb,
+  language text,
+  source text not null ${oneOf("source", SOURCE)},
+  source_revision text,
+  fetched_at timestamptz not null default now(),
+  ${target.replace("{t}", "metadata_field")}`,
+)}
+create unique index metadata_field_key on metadata_field (media_entity_id, content_unit_id, field, source, language) nulls not distinct;
+
+${entityTable(
+  "field_override",
+  `
+  media_entity_id uuid references media_entity (id) on delete cascade,
+  content_unit_id uuid references content_unit (id) on delete cascade,
+  field text not null,
+  value jsonb,
+  locked boolean not null default true,
+  source text not null default 'user' ${oneOf("source", SOURCE)},
+  reason text,
+  actor_type text not null ${oneOf("actor_type", ["user", "agent", "system", "api_key"])},
+  actor_id text,
+  ${target.replace("{t}", "field_override")}`,
+)}
+create unique index field_override_key on field_override (media_entity_id, content_unit_id, field) nulls not distinct;
+`,
+  );
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: 同上
+export async function down(db: Kysely<any>): Promise<void> {
+  await execDdl(db, dropTables(["field_override", "metadata_field"]));
+}

packages/db/src/types.ts

@@ -117,6 +117,11 @@ export type ExternalIdentityVerifyStatus = "unverified" | "ok" | "not_found" | "
 export type FeedSourcePurpose = "movie" | "series" | "variety" | "promotion" | "search" | "generic";
 export type FeedSourceKind = "rss" | "atom" | "list" | "query";
 export type FeedSourceHealthStatus = "unknown" | "healthy" | "degraded" | "failing" | "circuit_open" | "disabled";
+export type FieldOverrideSource = "tmdb" | "user" | "agent" | "nfo" | "site" | "import";
+export type FieldOverrideActorType = "user" | "agent" | "system" | "api_key";
+export type IdentityCandidateStatus = "pending" | "resolved" | "dismissed" | "archived";
+export type IdentityCandidateReason = "ambiguous" | "no_match" | "proposed" | "lookup_failed";
+export type IdentityRedirectActorType = "user" | "agent" | "system" | "api_key";
 export type IdentityRevisionAction =
   | "created"
   | "status_changed"
@@ -136,6 +141,7 @@ export type MediaEntityKind = "movie" | "series" | "variety" | "collection" | "o
 export type MediaEntityStatus = "provisional" | "active" | "merged" | "archived";
 export type MediaServerInstanceKind = "emby" | "jellyfin";
 export type MediaServerInstanceHealthStatus = "unknown" | "healthy" | "degraded" | "offline";
+export type MetadataFieldSource = "tmdb" | "user" | "agent" | "nfo" | "site" | "import";
 export type ObservationStatus = "new" | "linked" | "ignored" | "error";
 export type OrganizationFileResultRole = "main" | "subtitle" | "audio" | "bluray_dir" | "nfo" | "image" | "other";
 export type OrganizationFileResultMode = "copy" | "move" | "rename" | "relocate" | "hardlink";
@@ -158,6 +164,15 @@ export type PreferenceTagStatus = "active" | "disabled" | "deleted";
 export type ReconcileRunKind = "identity" | "metadata" | "asset" | "acquisition" | "server";
 export type ReconcileRunMode = "normal" | "read_only";
 export type ReconcileRunStatus = "queued" | "running" | "succeeded" | "partial" | "failed" | "cancelled";
+export type ResolutionAttemptOutcome =
+  | "auto"
+  | "proposed"
+  | "ambiguous"
+  | "no_match"
+  | "lookup_failed"
+  | "manual"
+  | "skipped_locked";
+export type ResolutionAttemptActorType = "user" | "agent" | "system" | "api_key";
 export type SecretPurpose =
   | "site_cookie"
   | "site_passkey"
@@ -171,11 +186,13 @@ export type SecretPurpose =
   | "other";
 export type ServerMappingItemType = "movie" | "series" | "season" | "episode" | "other";
 export type ServerMappingMatchStatus = "matched" | "ambiguous" | "unmatched" | "stale";
-export type SiteAdapter = "nexusphp" | "mteam_api" | "generic_rss";
+export type SiteAdapter = "nexusphp" | "mteam_api" | "api" | "generic_rss";
 export type SiteHealthStatus = "unknown" | "healthy" | "degraded" | "failing" | "disabled";
 export type SiteCircuitState = "closed" | "open" | "half_open";
 export type SiteAccountAuthKind = "cookie" | "passkey" | "api_key" | "password";
 export type SiteAccountStatus = "unknown" | "active" | "invalid" | "expired";
+export type SiteSnapshotKind = "periodic" | "backfill" | "live_search" | "manual";
+export type SiteSnapshotStatus = "running" | "ok" | "partial" | "failed";
 export type SourceReleaseResolutionStatus = "unresolved" | "resolved" | "ambiguous" | "unidentifiable" | "rejected";
 export type SourceReleaseAvailability = "active" | "site_disabled" | "expired" | "unknown";
 export type SubscriptionMediaKind = "movie" | "series" | "variety";
@@ -573,6 +590,51 @@ export interface FeedSourceTable {
   updated_at: GeneratedTimestamptz;
 }
 
+export interface FieldOverrideTable {
+  id: Generated<string>;
+  media_entity_id: string | null;
+  content_unit_id: string | null;
+  field: string;
+  value: Json | null;
+  locked: Generated<boolean>;
+  source: Generated<FieldOverrideSource>;
+  reason: string | null;
+  actor_type: FieldOverrideActorType;
+  actor_id: string | null;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
+export interface IdentityCandidateTable {
+  id: Generated<string>;
+  source_release_id: string;
+  status: Generated<IdentityCandidateStatus>;
+  reason: IdentityCandidateReason;
+  query: Generated<Json>;
+  candidates: Generated<Json>;
+  evidence_version: string;
+  attempts: Generated<number>;
+  last_attempt_at: Timestamptz | null;
+  next_review_at: Timestamptz | null;
+  decision_id: string | null;
+  resolved_media_entity_id: string | null;
+  resolved_by: string | null;
+  resolved_at: Timestamptz | null;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
+export interface IdentityRedirectTable {
+  id: Generated<string>;
+  from_entity_id: string;
+  to_entity_id: string;
+  reason: string | null;
+  actor_type: IdentityRedirectActorType;
+  actor_id: string | null;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
 export interface IdentityRevisionTable {
   id: Generated<string>;
   external_identity_id: string;
@@ -665,6 +727,20 @@ export interface MediaServerInstanceTable {
   updated_at: GeneratedTimestamptz;
 }
 
+export interface MetadataFieldTable {
+  id: Generated<string>;
+  media_entity_id: string | null;
+  content_unit_id: string | null;
+  field: string;
+  value: Json | null;
+  language: string | null;
+  source: MetadataFieldSource;
+  source_revision: string | null;
+  fetched_at: GeneratedTimestamptz;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
 export interface ObservationTable {
   id: Generated<string>;
   feed_id: string;
@@ -855,6 +931,23 @@ export interface ReconcileRunTable {
   updated_at: GeneratedTimestamptz;
 }
 
+export interface ResolutionAttemptTable {
+  id: Generated<string>;
+  source_release_id: string;
+  observation_id: string | null;
+  outcome: ResolutionAttemptOutcome;
+  reason: string | null;
+  evidence_version: string;
+  candidate_count: Generated<number>;
+  media_entity_id: string | null;
+  best: Json | null;
+  error: Json | null;
+  actor_type: Generated<ResolutionAttemptActorType>;
+  actor_id: string | null;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
 export interface SecretTable {
   id: Generated<string>;
   name: string;
@@ -929,6 +1022,24 @@ export interface SiteAccountTable {
   updated_at: GeneratedTimestamptz;
 }
 
+export interface SiteSnapshotTable {
+  id: Generated<string>;
+  site_id: string;
+  kind: SiteSnapshotKind;
+  query: string | null;
+  filters: Generated<Json>;
+  pages: Generated<Json>;
+  item_count: Generated<number>;
+  new_count: Generated<number>;
+  status: Generated<SiteSnapshotStatus>;
+  error: Json | null;
+  definition_version: string | null;
+  started_at: GeneratedTimestamptz;
+  finished_at: Timestamptz | null;
+  created_at: GeneratedTimestamptz;
+  updated_at: GeneratedTimestamptz;
+}
+
 export interface SourceReleaseTable {
   id: Generated<string>;
   site_id: string;
@@ -959,6 +1070,7 @@ export interface SourceReleaseTable {
   raw: Generated<Json>;
   created_at: GeneratedTimestamptz;
   updated_at: GeneratedTimestamptz;
+  resolution_locked: Generated<boolean>;
 }
 
 export interface SseEventTable {
@@ -1082,12 +1194,16 @@ export interface DB {
   downloader_instance: DownloaderInstanceTable;
   external_identity: ExternalIdentityTable;
   feed_source: FeedSourceTable;
+  field_override: FieldOverrideTable;
+  identity_candidate: IdentityCandidateTable;
+  identity_redirect: IdentityRedirectTable;
   identity_revision: IdentityRevisionTable;
   library_root: LibraryRootTable;
   login_attempt: LoginAttemptTable;
   media_asset: MediaAssetTable;
   media_entity: MediaEntityTable;
   media_server_instance: MediaServerInstanceTable;
+  metadata_field: MetadataFieldTable;
   observation: ObservationTable;
   organization_file_result: OrganizationFileResultTable;
   organization_record: OrganizationRecordTable;
@@ -1098,11 +1214,13 @@ export interface DB {
   preference_suppression: PreferenceSuppressionTable;
   preference_tag: PreferenceTagTable;
   reconcile_run: ReconcileRunTable;
+  resolution_attempt: ResolutionAttemptTable;
   secret: SecretTable;
   server_mapping: ServerMappingTable;
   settings: SettingsTable;
   site: SiteTable;
   site_account: SiteAccountTable;
+  site_snapshot: SiteSnapshotTable;
   source_release: SourceReleaseTable;
   sse_event: SseEventTable;
   subscription: SubscriptionTable;
@@ -1173,6 +1291,15 @@ export type ExternalIdentityUpdate = Updateable<ExternalIdentityTable>;
 export type FeedSourceRow = Selectable<FeedSourceTable>;
 export type NewFeedSource = Insertable<FeedSourceTable>;
 export type FeedSourceUpdate = Updateable<FeedSourceTable>;
+export type FieldOverrideRow = Selectable<FieldOverrideTable>;
+export type NewFieldOverride = Insertable<FieldOverrideTable>;
+export type FieldOverrideUpdate = Updateable<FieldOverrideTable>;
+export type IdentityCandidateRow = Selectable<IdentityCandidateTable>;
+export type NewIdentityCandidate = Insertable<IdentityCandidateTable>;
+export type IdentityCandidateUpdate = Updateable<IdentityCandidateTable>;
+export type IdentityRedirectRow = Selectable<IdentityRedirectTable>;
+export type NewIdentityRedirect = Insertable<IdentityRedirectTable>;
+export type IdentityRedirectUpdate = Updateable<IdentityRedirectTable>;
 export type IdentityRevisionRow = Selectable<IdentityRevisionTable>;
 export type NewIdentityRevision = Insertable<IdentityRevisionTable>;
 export type IdentityRevisionUpdate = Updateable<IdentityRevisionTable>;
@@ -1191,6 +1318,9 @@ export type MediaEntityUpdate = Updateable<MediaEntityTable>;
 export type MediaServerInstanceRow = Selectable<MediaServerInstanceTable>;
 export type NewMediaServerInstance = Insertable<MediaServerInstanceTable>;
 export type MediaServerInstanceUpdate = Updateable<MediaServerInstanceTable>;
+export type MetadataFieldRow = Selectable<MetadataFieldTable>;
+export type NewMetadataField = Insertable<MetadataFieldTable>;
+export type MetadataFieldUpdate = Updateable<MetadataFieldTable>;
 export type ObservationRow = Selectable<ObservationTable>;
 export type NewObservation = Insertable<ObservationTable>;
 export type ObservationUpdate = Updateable<ObservationTable>;
@@ -1221,6 +1351,9 @@ export type PreferenceTagUpdate = Updateable<PreferenceTagTable>;
 export type ReconcileRunRow = Selectable<ReconcileRunTable>;
 export type NewReconcileRun = Insertable<ReconcileRunTable>;
 export type ReconcileRunUpdate = Updateable<ReconcileRunTable>;
+export type ResolutionAttemptRow = Selectable<ResolutionAttemptTable>;
+export type NewResolutionAttempt = Insertable<ResolutionAttemptTable>;
+export type ResolutionAttemptUpdate = Updateable<ResolutionAttemptTable>;
 export type SecretRow = Selectable<SecretTable>;
 export type NewSecret = Insertable<SecretTable>;
 export type SecretUpdate = Updateable<SecretTable>;
@@ -1236,6 +1369,9 @@ export type SiteUpdate = Updateable<SiteTable>;
 export type SiteAccountRow = Selectable<SiteAccountTable>;
 export type NewSiteAccount = Insertable<SiteAccountTable>;
 export type SiteAccountUpdate = Updateable<SiteAccountTable>;
+export type SiteSnapshotRow = Selectable<SiteSnapshotTable>;
+export type NewSiteSnapshot = Insertable<SiteSnapshotTable>;
+export type SiteSnapshotUpdate = Updateable<SiteSnapshotTable>;
 export type SourceReleaseRow = Selectable<SourceReleaseTable>;
 export type NewSourceRelease = Insertable<SourceReleaseTable>;
 export type SourceReleaseUpdate = Updateable<SourceReleaseTable>;

packages/db/test/schema.test.ts

@@ -68,6 +68,13 @@ const EXPECTED_TABLES = [
   "tasks_fact",
   "tasks_op_ledger",
   "agent_run_event",
+  // W2-B 来源/身份/元数据(0018–0020)
+  "site_snapshot",
+  "identity_candidate",
+  "resolution_attempt",
+  "identity_redirect",
+  "metadata_field",
+  "field_override",
   // 登录门禁(0015)与 SSE 多进程总线(0016)
   "admin_user",
   "admin_session",

packages/mapping/test/convert.test.ts

@@ -258,6 +258,7 @@ describe("SiteRelease ↔ source_release", () => {
       resolutionStatus: "unresolved",
       resolutionEvidence: {},
       availability: "active",
+      resolutionLocked: false,
     };
     expect(C.SourceRelease.safeParse(row).success).toBe(true);
     const { downloadUrl: _d, ...expected } = site;