feat(identify-words): 识别词——全局识别词(MP 语法)+ 作品识别词(季集换算),规则页「识别词」页签

- 新表 identify_words(0094):全局一块 + 每部作品一块原文,带版本与审计;episode_mapping_rule 转成文本行后删表
- 全局识别词移植 MP WordsMatcher(屏蔽 / 替换 / 集数偏移 / 替换+偏移 / {[tmdbid=…]}),所有按标题 / 文件名识别的地方解析前套用,命中的行记在解析结果上;保存后后台按改动行重新识别
- 作品识别词:S02 >> S01 EP+24 / S01E13 >> S00E01 / S01 @组 >> 忽略,解析器 + 打印器 + 编译;发布组繁简视为同一个
- 去掉规则自动停用:算出来对不上季表只待确认,要停用就注释掉那一行
- 集数待确认的采用 / 忽略与智能体 apply_rule 改为往作品识别词追加一行(带来历注释)
- 编辑器可视化 / 文本两种模式改同一份原文,保存前试算;作品页「集数映射」用同一个编辑器

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei

apps/web/app/components/episode-mapping/mapping-panel.tsx

@@ -1,59 +1,19 @@
-import type {
-  EpisodeMappingPreview,
-  EpisodeMappingPreviewInput,
-  EpisodeMappingRuleRow,
-  EpisodeMappingRuleSpec,
-  EpisodeSpecialKind,
-  EpisodeSuggestion,
-} from "@umt/contracts";
-import { Pause, PencilLine, Play, Plus, Trash2, Wand2 } from "lucide-react";
-import { useEffect, useId, useMemo, useRef, useState } from "react";
+import type { EpisodeMappingPreview, EpisodeSuggestion } from "@umt/contracts";
+import { Wand2 } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
 import { useLocation, useSearchParams } from "react-router";
-import { toast } from "sonner";
-import { useEpisodeMappingPreview, useEpisodeMappingRules, useEpisodeMappingWrite } from "~/api/episode-mapping.ts";
-import { ConfirmDialog } from "~/components/console/confirm-dialog.tsx";
+import { useEntityWords, useEpisodeMappingPreview } from "~/api/episode-mapping.ts";
 import { ErrorState, LoadingState } from "~/components/console/empty-state.tsx";
-import { FormField } from "~/components/console/form-field.tsx";
 import { StatusBadge } from "~/components/console/status-badge.tsx";
+import { WordsEditor } from "~/components/identify-words/words-editor.tsx";
 import { Chip, Panel } from "~/components/library/parts.tsx";
 import { Button } from "~/components/ui/button.tsx";
-import { Input } from "~/components/ui/input.tsx";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "~/components/ui/select.tsx";
-import { Textarea } from "~/components/ui/textarea.tsx";
-import { errorMessage } from "~/lib/api.ts";
-import { actorText } from "~/lib/labels.ts";
 import { EpisodeIssuesList } from "./issues.tsx";
-import {
-  agentRuleInfo,
-  disabledReasonText,
-  draftFromSearch,
-  draftOfRule,
-  EMPTY_DRAFT,
-  groupMethodsText,
-  MAPPING_ANCHOR,
-  RULE_KIND_LABEL,
-  type RuleDraft,
-  reresolveToast,
-  ruleText,
-  SPECIAL_LABEL,
-  scopeText,
-  specOfDraft,
-} from "./model.ts";
+import { groupMethodsText, lineFromSearch, MAPPING_ANCHOR } from "./model.ts";
 import { PreviewTable } from "./preview-table.tsx";
 
-// 作品页「集数映射」分区(批次 4):季表摘要、规则列表(增改停删)、草稿规则边改边预览、应用后提示重算了多少条。
-
-/** 草稿改动后等这么久再预览 */
-const PREVIEW_DEBOUNCE_MS = 400;
-
-function useDebounced<T>(value: T, ms: number): T {
-  const [v, setV] = useState(value);
-  useEffect(() => {
-    const t = setTimeout(() => setV(value), ms);
-    return () => clearTimeout(t);
-  }, [value, ms]);
-  return v;
-}
+// 作品页「集数映射」分区:季表摘要、作品识别词(与规则页「识别词」同一个编辑器、同一份数据)、
+// 按发布组的统计与建议、换算不了的资源,以及近期资源按已保存的识别词的判定。
 
 function SeasonSummary({ p }: { p: EpisodeMappingPreview["seasons"] }) {
   const main = p.seasons.filter((s) => s.season >= 1);
@@ -74,215 +34,12 @@ function SeasonSummary({ p }: { p: EpisodeMappingPreview["seasons"] }) {
   );
 }
 
-function RuleRow({
-  rule,
-  editing,
-  onEdit,
-  write,
-}: {
-  rule: EpisodeMappingRuleRow;
-  editing: boolean;
-  onEdit: () => void;
-  write: ReturnType<typeof useEpisodeMappingWrite>;
-}) {
-  const reason = disabledReasonText(rule);
-  const agent = agentRuleInfo(rule);
-  const run = (vars: Parameters<typeof write.mutateAsync>[0], verb: string) =>
-    write.mutateAsync(vars).then(
-      (r) => toast.success(reresolveToast(r.reresolve, verb)),
-      (e) => {
-        toast.error(errorMessage(e));
-        throw e;
-      },
-    );
-  return (
-    <li className="flex flex-wrap items-start gap-x-3 gap-y-1.5 border-t border-border/60 py-2.5 first:border-t-0">
-      <div className="min-w-0 flex-1">
-        <div className="flex flex-wrap items-center gap-2">
-          <span className="text-caption font-medium text-foreground">{scopeText(rule.season, rule.releaseGroup)}</span>
-          <StatusBadge tone={rule.status === "active" ? "success" : "neutral"}>
-            {rule.status === "active" ? "启用" : "停用"}
-          </StatusBadge>
-          {agent ? <Chip>{agent.label}</Chip> : null}
-          {editing ? <span className="text-meta text-muted-foreground">修改中</span> : null}
-        </div>
-        <div className="mt-0.5 text-meta text-muted-foreground">
-          {RULE_KIND_LABEL[rule.kind]}：<span className="font-mono text-foreground">{ruleText(rule)}</span>
-          {agent ? null : (
-            <>
-              {" · "}
-              {actorText(rule.createdById ? `${rule.createdByType}:${rule.createdById}` : rule.createdByType)}
-            </>
-          )}
-        </div>
-        {agent?.reasons.length ? (
-          <div className="mt-0.5 text-meta text-muted-foreground">依据：{agent.reasons.join("；")}</div>
-        ) : null}
-        {reason ? <div className="mt-0.5 text-meta text-muted-foreground">{reason}</div> : null}
-      </div>
-      <div className="flex flex-wrap items-center gap-1.5">
-        <Button variant="outline" size="sm" onClick={onEdit}>
-          <PencilLine />
-          修改
-        </Button>
-        {rule.status === "active" ? (
-          <Button
-            variant="outline"
-            size="sm"
-            disabled={write.isPending}
-            onClick={() =>
-              void run({ op: "update", id: rule.id, body: { status: "disabled" } }, "已停用").catch(() => {})
-            }
-          >
-            <Pause />
-            停用
-          </Button>
-        ) : (
-          <Button
-            variant="outline"
-            size="sm"
-            disabled={write.isPending}
-            onClick={() =>
-              void run({ op: "update", id: rule.id, body: { status: "active" } }, "已启用").catch(() => {})
-            }
-          >
-            <Play />
-            启用
-          </Button>
-        )}
-        <ConfirmDialog
-          trigger={
-            <Button variant="ghost" size="sm" aria-label="删除规则">
-              <Trash2 />
-            </Button>
-          }
-          title="删除这条规则？"
-          description={`删除后按作品重算：「${scopeText(rule.season, rule.releaseGroup)}」的资源回到自动判定。不能恢复。`}
-          confirmLabel="删除"
-          destructive
-          onConfirm={() => run({ op: "delete", id: rule.id }, "已删除")}
-        />
-      </div>
-    </li>
-  );
-}
+const pad = (n: number) => String(n).padStart(2, "0");
 
-function DraftEditor({
-  draft,
-  onChange,
-  error,
-  groups,
-}: {
-  draft: RuleDraft;
-  onChange: (d: RuleDraft) => void;
-  error: string | null;
-  groups: string[];
-}) {
-  const id = useId();
-  const f = (k: string) => `${id}-${k}`;
-  const set = (patch: Partial<RuleDraft>) => onChange({ ...draft, ...patch });
-  return (
-    <div className="grid gap-x-3 sm:grid-cols-2 lg:grid-cols-4">
-      <FormField label="来源季" htmlFor={f("season")} hint="空着 = 任意季">
-        <Input
-          id={f("season")}
-          inputMode="numeric"
-          value={draft.season}
-          onChange={(e) => set({ season: e.target.value })}
-        />
-      </FormField>
-      <FormField label="发布组" htmlFor={f("group")} hint="空着 = 任意发布组">
-        <Input
-          id={f("group")}
-          list={f("groups")}
-          value={draft.releaseGroup}
-          onChange={(e) => set({ releaseGroup: e.target.value })}
-        />
-        <datalist id={f("groups")}>
-          {groups.map((g) => (
-            <option key={g} value={g} />
-          ))}
-        </datalist>
-      </FormField>
-      <FormField label="类型" htmlFor={f("kind")}>
-        <Select value={draft.kind} onValueChange={(v) => set({ kind: v as RuleDraft["kind"] })}>
-          <SelectTrigger id={f("kind")} className="w-full">
-            <SelectValue />
-          </SelectTrigger>
-          <SelectContent>
-            {(Object.keys(RULE_KIND_LABEL) as RuleDraft["kind"][]).map((k) => (
-              <SelectItem key={k} value={k}>
-                {RULE_KIND_LABEL[k]}
-              </SelectItem>
-            ))}
-          </SelectContent>
-        </Select>
-      </FormField>
-      {draft.kind === "expression" ? (
-        <FormField label="目标季" htmlFor={f("target")} hint="空着 = 来源季">
-          <Input
-            id={f("target")}
-            inputMode="numeric"
-            value={draft.targetSeason}
-            onChange={(e) => set({ targetSeason: e.target.value })}
-          />
-        </FormField>
-      ) : draft.kind === "special" ? (
-        <FormField label="映射为" htmlFor={f("special")}>
-          <Select value={draft.special} onValueChange={(v) => set({ special: v as EpisodeSpecialKind })}>
-            <SelectTrigger id={f("special")} className="w-full">
-              <SelectValue />
-            </SelectTrigger>
-            <SelectContent>
-              {(Object.keys(SPECIAL_LABEL) as EpisodeSpecialKind[]).map((k) => (
-                <SelectItem key={k} value={k}>
-                  {SPECIAL_LABEL[k]}
-                </SelectItem>
-              ))}
-            </SelectContent>
-          </Select>
-        </FormField>
-      ) : (
-        <div />
-      )}
-      {draft.kind === "expression" ? (
-        <FormField
-          label="偏移表达式"
-          htmlFor={f("expr")}
-          className="sm:col-span-2 lg:col-span-4"
-          error={error}
-          hint="EP 是来源集号：EP-12 表示减 12，EP*2-1 表示双集拆分"
-        >
-          <Input
-            id={f("expr")}
-            className="font-mono"
-            value={draft.expression}
-            onChange={(e) => set({ expression: e.target.value })}
-            aria-invalid={!!error}
-          />
-        </FormField>
-      ) : draft.kind === "table" ? (
-        <FormField
-          label="对照表"
-          htmlFor={f("table")}
-          className="sm:col-span-2 lg:col-span-4"
-          error={error}
-          hint="每行一条：26=S02E01，区间写 27-28=S02E02"
-        >
-          <Textarea
-            id={f("table")}
-            className="font-mono"
-            rows={4}
-            value={draft.table}
-            onChange={(e) => set({ table: e.target.value })}
-            aria-invalid={!!error}
-          />
-        </FormField>
-      ) : error ? (
-        <p className="text-meta text-destructive sm:col-span-2 lg:col-span-4">{error}</p>
-      ) : null}
-    </div>
-  );
+/** 建议规则写成作品识别词的一行 */
+export function suggestionLine(s: EpisodeSuggestion): string {
+  const scope = `${s.season == null ? "*" : `S${pad(s.season)}`}${s.releaseGroup ? ` @${s.releaseGroup}` : ""}`;
+  return `${scope} >> S${pad(s.targetSeason)} ${s.expression}`;
 }
 
 function GroupStats({
@@ -290,7 +47,7 @@ function GroupStats({
   onUseSuggestion,
 }: {
   groups: EpisodeMappingPreview["groups"];
-  onUseSuggestion: (s: EpisodeSuggestion) => void;
+  onUseSuggestion: (line: string) => void;
 }) {
   if (!groups.length) return null;
   return (
@@ -300,9 +57,9 @@ function GroupStats({
           <span className="text-foreground">{groupMethodsText(g)}</span>
           {g.pending ? <StatusBadge tone="warning">待确认 {g.pending} 条</StatusBadge> : null}
           {g.suggestion ? (
-            <Button variant="ghost" size="sm" onClick={() => onUseSuggestion(g.suggestion!)}>
+            <Button variant="ghost" size="sm" onClick={() => onUseSuggestion(suggestionLine(g.suggestion!))}>
               <Wand2 />
-              试试建议 {g.suggestion.expression} → 第 {g.suggestion.targetSeason} 季
+              试试「{suggestionLine(g.suggestion)}」
             </Button>
           ) : null}
         </li>
@@ -314,139 +71,64 @@ function GroupStats({
 export function EpisodeMappingPanel({ entityId }: { entityId: string }) {
   const [sp] = useSearchParams();
   const location = useLocation();
-  const rules = useEpisodeMappingRules(entityId);
-  const write = useEpisodeMappingWrite(entityId);
-  const [draft, setDraft] = useState<RuleDraft | null>(() => draftFromSearch(sp));
-  const [editingId, setEditingId] = useState<string | null>(null);
+  const words = useEntityWords(entityId);
+  const preview = useEpisodeMappingPreview(entityId, {});
+  const [draft, setDraft] = useState<string | null>(null);
   const ref = useRef<HTMLDivElement>(null);
+  const saved = words.data?.block.text ?? "";
+  const text = draft ?? saved;
 
-  // 从待处理「修改」跳来:预填草稿并滚到这里
-  useEffect(() => {
-    const d = draftFromSearch(sp);
-    if (d) {
-      setDraft(d);
-      setEditingId(null);
-    }
-    if (location.hash === `#${MAPPING_ANCHOR}`) ref.current?.scrollIntoView({ block: "start" });
-  }, [sp, location.hash]);
-
-  const parsed = useMemo(() => (draft ? specOfDraft(draft) : { spec: null, error: null }), [draft]);
-  const input: EpisodeMappingPreviewInput = useMemo(() => {
-    const spec = parsed.spec;
-    if (!draft) return {};
-    return {
-      ...(spec ? { draft: spec, season: spec.season ?? null, releaseGroup: spec.releaseGroup ?? null } : {}),
-      ...(editingId ? { replaceRuleId: editingId } : {}),
-    };
-  }, [draft, parsed.spec, editingId]);
-  const debounced = useDebounced(input, PREVIEW_DEBOUNCE_MS);
-  const preview = useEpisodeMappingPreview(entityId, debounced);
-  const groupNames = useMemo(
-    () => (preview.data?.groups ?? []).map((g) => g.releaseGroup).filter((g): g is string => !!g),
-    [preview.data],
-  );
-
-  const startNew = () => {
-    setEditingId(null);
-    setDraft({ ...EMPTY_DRAFT });
-  };
-  const cancel = () => {
-    setDraft(null);
-    setEditingId(null);
-  };
-  const apply = (spec: EpisodeMappingRuleSpec) =>
-    write
-      .mutateAsync(editingId ? { op: "update", id: editingId, body: spec } : { op: "create", entityId, body: spec })
-      .then(
-        (r) => {
-          toast.success(reresolveToast(r.reresolve));
-          cancel();
-        },
-        (e) => toast.error(errorMessage(e, "应用失败")),
-      );
-  const adoptSuggestion = (s: EpisodeSuggestion) => {
-    setEditingId(null);
-    setDraft({
-      ...EMPTY_DRAFT,
-      season: s.season != null ? String(s.season) : "",
-      releaseGroup: s.releaseGroup ?? "",
-      expression: s.expression,
-      targetSeason: String(s.targetSeason),
+  /** 把一行追加进草稿(建议、集数待确认的「修改」、从别处跳来带的一行) */
+  const append = (line: string) => {
+    setDraft((cur) => {
+      const base = (cur ?? saved).replace(/\n*$/, "");
+      if (base.split("\n").some((l) => l.trim() === line.trim())) return cur ?? saved;
+      return `${base ? `${base}\n` : ""}${line}\n`;
     });
+    ref.current?.scrollIntoView({ block: "start", behavior: "smooth" });
   };
 
-  const list = rules.data?.items ?? [];
+  // 从集数待确认「修改」跳来:把那一行放进草稿并滚到这里
+  const fromLink = lineFromSearch(sp);
+  // biome-ignore lint/correctness/useExhaustiveDependencies: 识别词加载好之后只处理一次地址里带的行
+  useEffect(() => {
+    if (fromLink && words.isSuccess) append(fromLink);
+    if (location.hash === `#${MAPPING_ANCHOR}`) ref.current?.scrollIntoView({ block: "start" });
+  }, [fromLink, words.isSuccess, location.hash]);
+  // 保存后草稿归零(编辑器已拿到新版本)
+  useEffect(() => {
+    if (draft !== null && draft === saved) setDraft(null);
+  }, [draft, saved]);
+
   return (
     <div id={MAPPING_ANCHOR} ref={ref} className="scroll-mt-4">
       <Panel
         title="集数映射"
-        description="发布者写的季集对不上作品季表时，按规则换成媒体库用的季集"
-        actions={
-          draft ? null : (
-            <Button variant="outline" size="sm" onClick={startNew}>
-              <Plus />
-              新建规则
-            </Button>
-          )
-        }
+        description="发布者写的季集对不上作品季表时，用作品识别词换成媒体库用的季集"
         bodyClassName="space-y-4"
       >
         {preview.data ? <SeasonSummary p={preview.data.seasons} /> : null}
-
-        {rules.isPending ? (
-          <LoadingState rows={2} />
-        ) : rules.isError ? (
-          <ErrorState plain error={rules.error} onRetry={() => rules.refetch()} />
-        ) : list.length ? (
-          <ul>
-            {list.map((r) => (
-              <RuleRow
-                key={r.id}
-                rule={r}
-                editing={editingId === r.id}
-                write={write}
-                onEdit={() => {
-                  setEditingId(r.id);
-                  setDraft(draftOfRule(r));
-                }}
-              />
-            ))}
-          </ul>
+        {words.isPending ? (
+          <LoadingState rows={3} />
+        ) : words.isError ? (
+          <ErrorState plain error={words.error} onRetry={() => words.refetch()} />
         ) : (
-          <p className="text-caption text-muted-foreground">
-            还没有规则。资源的集数先按原号、绝对集号和播出日期自动判定，换算不了的在这里列出原因。
-          </p>
+          <WordsEditor
+            scope="entity"
+            entityId={entityId}
+            block={words.data.block}
+            knownGroups={words.data.knownGroups}
+            draft={text}
+            onDraftChange={setDraft}
+          />
         )}
-
-        {draft ? (
-          <div className="rounded-xl border border-border/60 px-4 pt-3 pb-2">
-            <div className="mb-2 text-caption font-medium text-foreground">{editingId ? "修改规则" : "新建规则"}</div>
-            <DraftEditor draft={draft} onChange={setDraft} error={parsed.error} groups={groupNames} />
-            <div className="flex flex-wrap items-center gap-2 pb-1">
-              <Button
-                size="sm"
-                disabled={!parsed.spec || write.isPending}
-                onClick={() => parsed.spec && void apply(parsed.spec)}
-              >
-                应用
-              </Button>
-              <Button variant="outline" size="sm" onClick={cancel}>
-                取消
-              </Button>
-              {preview.data && parsed.spec ? (
-                <span className="text-meta text-muted-foreground">预览里 {preview.data.changed} 条会变化</span>
-              ) : null}
-            </div>
-          </div>
-        ) : null}
-
-        {preview.data ? <GroupStats groups={preview.data.groups} onUseSuggestion={adoptSuggestion} /> : null}
-        <EpisodeIssuesList entityId={entityId} />
+        {preview.data ? <GroupStats groups={preview.data.groups} onUseSuggestion={append} /> : null}
+        <EpisodeIssuesList entityId={entityId} onEdit={append} />
       </Panel>
       <Panel
         className="mt-3"
-        title={draft ? "模拟预览" : "近期资源"}
-        description={draft ? "按草稿规则试算，不会保存；应用后才按作品重算" : "最近 100 条已绑定资源按当前规则的判定"}
+        title="近期资源"
+        description="最近 100 条已绑定资源按已保存的识别词的判定"
         bodyClassName="p-0 sm:p-0"
       >
         {preview.isPending ? (
@@ -458,7 +140,7 @@ export function EpisodeMappingPanel({ entityId }: { entityId: string }) {
             <ErrorState plain error={preview.error} onRetry={() => preview.refetch()} />
           </div>
         ) : (
-          <PreviewTable items={preview.data.items} hasDraft={!!input.draft} />
+          <PreviewTable items={preview.data.items} hasDraft={false} />
         )}
       </Panel>
     </div>