feat(identity): lazy TMDB lookup and bounded identity pool (DEC-1)

RSS/list releases that match no subscription or local work no longer hit
TMDB or open a pending item; they go to the identity pool as `unmatched`.
TMDB is queried only on a local alias hit, a published new-title rule whose
prefilter passes, manual/Agent retry, search results, or when the new
setting identity.eagerTmdbLookup (default off) is on. Mirrors MoviePilot:
torrents are recognised only when matched to a subscription or searched,
and recognition failures are logged, not alerted.

- Pending items only for related releases (ambiguous after lookup, or
  related to a local work but unresolved); same source + normalized title
  merge into one decision ("来源「X」的 N 条资源待识别"), resolve/dismiss
  applies to the whole group, members detach as they get resolved.
- Pool governance: unmatched reviews capped (daily, 3x), title_alias
  insert trigger wakes similar entries, stale unmatched entries archived
  after identity.poolArchiveDays (30); review idempotency keys include the
  due time.
- Migration 0047_identity_pool: reason/outcome `unmatched`,
  identity_candidate.normalized_title (+trgm index), wake trigger, and
  cleanup of open identity_unresolved items with no related work
  (dismissed, resolution=moved_to_pool).
- Inbox: group by type + work/source with collapse, hide info-only items
  by default (minSeverity=warning), badge counts warning+ only; pool sheet
  gets manual TMDB/local-work assign and dismiss; settings card for the
  new identity settings.
- Runbook docs/runbook/identity.md.

Requires rebuild/restart (migration runs on start).

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

packages/contracts/src/identity.ts

@@ -126,8 +126,11 @@ export type IdentityRevisionCreate = z.infer<typeof IdentityRevisionCreate>;
 
 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"]);
+/**
+ * proposed = 证据足够但自动化关闭/只读,待确认;
+ * unmatched = 惰性识别:本地召回无结果且没有触发 TMDB 查询(不相关的 RSS / 列表资源),只进池、不开待处理
+ */
+export const IdentityCandidateReason = z.enum(["ambiguous", "no_match", "proposed", "lookup_failed", "unmatched"]);
 export type IdentityCandidateReason = z.infer<typeof IdentityCandidateReason>;
 
 /** 待识别池里的一个候选(只存 JSON,不建正式作品) */
@@ -151,6 +154,8 @@ export const IdentityCandidate = EntityBase.extend({
   reason: IdentityCandidateReason,
   /** 解析出的检索条件(标题/年份/季集) */
   query: JsonObject,
+  /** 归一化标题(与 title_alias.normalized 同口径):新增别名时按它唤醒复查,待处理按"来源 + 它"合并 */
+  normalizedTitle: z.string().nullable(),
   candidates: z.array(PoolCandidate),
   evidenceVersion: z.string(),
   attempts: z.number().int().nonnegative(),
@@ -171,6 +176,7 @@ export const ResolutionOutcome = z.enum([
   "lookup_failed",
   "manual",
   "skipped_locked",
+  "unmatched",
 ]);
 export type ResolutionOutcome = z.infer<typeof ResolutionOutcome>;
 

packages/contracts/src/settings.ts

@@ -357,6 +357,19 @@ export const BudgetSettings = z.object({
 });
 export type BudgetSettings = z.infer<typeof BudgetSettings>;
 
+/**
+ * 身份识别(DEC-1 惰性识别,对照 MP:RSS / 列表资源只在匹配订阅或用户搜索时识别)。
+ * eagerTmdbLookup = true 恢复旧行为:每条新观察到的资源都查 TMDB。每条资源约 1–2 次搜索 + 命中时 1 次详情
+ * (识别缓存命中则 0 次);一个每小时 100 条的 RSS 约为每天 2400–7200 次 TMDB 请求,多数是站点独有的短剧 / 综艺,查不到。
+ * 关闭(缺省)时只在命中订阅 / 本地作品别名、已发布的新作品收录规则前置条件通过、用户手动识别或搜索时查询。
+ */
+export const IdentitySettings = z.object({
+  eagerTmdbLookup: z.boolean(),
+  /** 待识别池里 unmatched 条目多少天没有新证据就归档(仍可按状态筛出、可手动指定) */
+  poolArchiveDays: z.number().int().min(1).max(3650),
+});
+export type IdentitySettings = z.infer<typeof IdentitySettings>;
+
 export const GlobalSettings = z.object({
   automation: AutomationSettings,
   cache: CacheSettings,
@@ -368,6 +381,7 @@ export const GlobalSettings = z.object({
   metadata: MetadataSettings,
   sites: SitesSettings,
   naming: NamingSettings,
+  identity: IdentitySettings,
 });
 export type GlobalSettings = z.infer<typeof GlobalSettings>;
 
@@ -438,6 +452,7 @@ export const DEFAULT_SETTINGS: GlobalSettings = {
     userDataMaxSeedingPages: 10,
   },
   naming: { ...DEFAULT_NAMING_TEMPLATES, lockFileNameForBound: false },
+  identity: { eagerTmdbLookup: false, poolArchiveDays: 30 },
 };
 
 /** PATCH /settings:按分组部分更新;服务端与现值合并后用 GlobalSettings 整体再校验 */
@@ -486,6 +501,7 @@ export const GlobalSettingsUpdate = z.object({
     .optional(),
   sites: SitesSettings.partial().optional(),
   naming: NamingSettings.partial().optional(),
+  identity: IdentitySettings.partial().optional(),
 });
 export type GlobalSettingsUpdate = z.infer<typeof GlobalSettingsUpdate>;
 
@@ -510,6 +526,7 @@ export function mergeSettings(current: GlobalSettings, patch: GlobalSettingsUpda
     metadata: { ...current.metadata, ...metadata },
     sites: { ...(current.sites ?? DEFAULT_SETTINGS.sites), ...patch.sites },
     naming: { ...(current.naming ?? DEFAULT_SETTINGS.naming), ...patch.naming },
+    identity: { ...(current.identity ?? DEFAULT_SETTINGS.identity), ...patch.identity },
   };
 }
 
@@ -666,11 +683,12 @@ export const SETTINGS_SECTIONS: readonly SettingsSectionDef[] = [
   {
     id: "metadata",
     label: "元数据",
-    description: "TMDB API Key 与地址、TMDB 缓存、图片代理",
+    description: "TMDB API Key 与地址、TMDB 缓存、资源识别、图片代理",
     legacyTabs: [],
     anchors: [
       { id: "tmdb", label: "TMDB" },
       { id: "tmdb-cache", label: "TMDB 缓存" },
+      { id: "identity", label: "资源识别" },
       { id: "images", label: "图片代理与缓存" },
     ],
     fields: [
@@ -679,6 +697,8 @@ export const SETTINGS_SECTIONS: readonly SettingsSectionDef[] = [
       "cache.tmdbTtlHours",
       "cache.tmdbMaxSize",
       "cache.emptyResultTtlSec",
+      "identity.eagerTmdbLookup",
+      "identity.poolArchiveDays",
       "cache.globalImageCache",
       "cache.globalImageCacheDays",
     ],