fix(qa): 实施 4 组设计型 QA 项——规则删除/codex 角色/大纲卷过滤/文风回炉锚点

#5 规则 DELETE + id：暴露 RuleView.id（PK）；新增 DELETE /projects/{id}/rules/{rule_id} （项目/规则不存在→404，成功→204，按 (id,project_id) 限定）；rule_repo 加 list_for_project/delete；RulesPage 每条加删除（乐观删+回滚+toast）。assemble 侧 RuleView（缓存前缀）不动，列表另立 RuleListItemView。 #7 codex 角色 relations：写侧本已持久化、读端点 _existing_characters 硬编码 []。加 _relations_from_jsonb 解析 {name,kind,note}，CodexPage 渲染关系 chip。 #8 角色入库幂等：SqlCharacterWriteRepo.create 改 (project_id,name) app 层 upsert—— 重复入库改更新而非插入；不加 UNIQUE/迁移（线上已有重复行会让约束迁移失败）。 #1 大纲卷过滤：GET /outline 支持可选 ?volume（无参=全部，向后兼容）；OutlineEditor 加「查看：全部/卷N」筛选，与生成目标卷解耦。 H3/#9 文风回炉锚点：StyleDriftSegment 加 text（逐字命中段），style.md 指示审稿输出；前端按内容锚点定位回炉目标（idx 仅排序），命中失败 → 提示「无法定位该段」而非静默 no-op。style golden fixture 已重生成。契约变更已 pnpm gen:api（RuleView.id / DELETE rules / outline ?volume）。无迁移（alembic 无漂移）。门禁绿：ruff/mypy(210)/alembic/pytest 760 · 前端 tsc/lint/vitest 329。
2026-06-25 12:53:03 +02:00
parent e60eff7aa1
commit bf39f50b2f
33 changed files with 907 additions and 99 deletions
--- a/apps/web/components/codex/CodexPage.tsx
+++ b/apps/web/components/codex/CodexPage.tsx
@@ -87,13 +87,28 @@ export function CodexPage({
                  已入库人物（{characters.length}）
                </h3>
                {characters.length > 0 ? (
-                  <ul className="flex flex-wrap gap-2">
+                  <ul className="flex flex-col gap-2">
                    {characters.map((c, i) => (
                      <li
                        key={`${c.name}-${i}`}
-                        className="rounded bg-bg px-2 py-1 text-xs text-ink-soft"
+                        className="rounded bg-bg px-2 py-1.5 text-xs text-ink-soft"
                      >
-                        {c.name}（{c.role}）
+                        <span className="text-ink">
+                          {c.name}（{c.role}）
+                        </span>
+                        {c.relations && c.relations.length > 0 ? (
+                          <ul className="mt-1 flex flex-wrap gap-1">
+                            {c.relations.map((r, j) => (
+                              <li
+                                key={`${r.name}-${r.kind}-${j}`}
+                                className="rounded bg-panel px-1.5 py-0.5 text-[11px]"
+                                title={r.note ?? undefined}
+                              >
+                                {r.kind} · {r.name}
+                              </li>
+                            ))}
+                          </ul>
+                        ) : null}
                      </li>
                    ))}
                  </ul>
--- a/apps/web/components/outline/OutlineEditor.tsx
+++ b/apps/web/components/outline/OutlineEditor.tsx
@@ -4,7 +4,12 @@ import { useMemo, useState } from "react";

 import { AppShell } from "@/components/AppShell";
 import type { OutlineChapterView, ProjectResponse } from "@/lib/api/types";
-import { groupByVolume } from "@/lib/outline/outline";
+import {
+  distinctVolumes,
+  filterByViewVolume,
+  groupByVolume,
+  type ViewVolume,
+} from "@/lib/outline/outline";
 import { useOutline } from "@/lib/outline/useOutline";
 import { OutlineChapterRow } from "./OutlineChapterRow";

@@ -21,7 +26,13 @@ export function OutlineEditor({
 }: OutlineEditorProps) {
  const { chapters, status, error, generate } = useOutline(initialChapters);
  const [volume, setVolume] = useState(1);
-  const volumes = useMemo(() => groupByVolume(chapters), [chapters]);
+  // 视图卷过滤（"全部" 或某卷）——只影响展示，与生成的目标卷 `volume` 解耦。
+  const [viewVolume, setViewVolume] = useState<ViewVolume>("all");
+  const availableVolumes = useMemo(() => distinctVolumes(chapters), [chapters]);
+  const volumes = useMemo(
+    () => groupByVolume(filterByViewVolume(chapters, viewVolume)),
+    [chapters, viewVolume],
+  );
  const generating = status === "generating";

  return (
@@ -34,7 +45,32 @@ export function OutlineEditor({
      <div className="flex h-[calc(100vh-var(--chrome,4rem))] flex-col p-6">
        <div className="mb-4 flex items-center gap-3">
          <h1 className="font-serif text-lg text-ink">大纲</h1>
-          <label htmlFor="vol" className="ml-auto text-xs text-ink-soft">
+          {availableVolumes.length > 0 ? (
+            <label htmlFor="view-vol" className="ml-auto text-xs text-ink-soft">
+              查看
+              <select
+                id="view-vol"
+                value={viewVolume === "all" ? "all" : String(viewVolume)}
+                onChange={(e) =>
+                  setViewVolume(
+                    e.target.value === "all" ? "all" : Number(e.target.value),
+                  )
+                }
+                className="ml-1 rounded border border-line bg-bg px-2 py-1 text-sm text-ink focus:border-cinnabar focus:outline-none"
+              >
+                <option value="all">全部</option>
+                {availableVolumes.map((v) => (
+                  <option key={v} value={String(v)}>
+                    卷 {v}
+                  </option>
+                ))}
+              </select>
+            </label>
+          ) : null}
+          <label
+            htmlFor="vol"
+            className={`text-xs text-ink-soft${availableVolumes.length > 0 ? "" : " ml-auto"}`}
+          >
            卷号
          </label>
          <input
@@ -74,7 +110,9 @@ export function OutlineEditor({
        <div className="min-h-0 flex-1 overflow-auto">
          {volumes.length === 0 ? (
            <p className="rounded border border-dashed border-line p-6 text-sm text-ink-soft">
-              暂无大纲。点「✦ AI 排大纲」生成逐章节拍与伏笔窗口。
+              {chapters.length > 0 && viewVolume !== "all"
+                ? `卷 ${viewVolume} 暂无大纲。切到「全部」查看其它卷，或点「✦ AI 排大纲」为本卷生成。`
+                : "暂无大纲。点「✦ AI 排大纲」生成逐章节拍与伏笔窗口。"}
            </p>
          ) : (
            volumes.map((group) => (
--- a/apps/web/components/review/ReviewReport.tsx
+++ b/apps/web/components/review/ReviewReport.tsx
@@ -36,6 +36,7 @@ import { useRefine } from "@/lib/style/useRefine";
 import { useReviewStream } from "@/lib/review/useReviewStream";
 import type { ReviewConflict, StyleDriftSegment } from "@/lib/review/sse";
 import { normalizeStyleDrift } from "@/lib/style/style";
+import { locateDriftSegment } from "@/lib/style/locateSegment";
 import { useToast } from "@/components/Toast";
 import { ThinkingIndicator } from "@/components/ThinkingIndicator";
 import { AcceptPanel } from "./AcceptPanel";
@@ -80,10 +81,8 @@ export function ReviewReport({
  const [rewriting, setRewriting] = useState<Set<number>>(new Set());
  // 可编辑终稿 textarea 引用：供「跳转」/采纳后在正文里选中定位问题区域。
  const editorRef = useRef<HTMLTextAreaElement>(null);
-  // 回炉中的漂移段（null=未打开 RefineView）。
-  const [refineSegment, setRefineSegment] = useState<StyleDriftSegment | null>(
-    null,
-  );
+  // 回炉中漂移段在终稿里定位到的原文（null=未打开 RefineView）。内容锚定位，非位置 idx。
+  const [refineText, setRefineText] = useState<string | null>(null);
  const seededRef = useRef(false);

  // 进页一次性把历史留痕（冲突 + 伏笔建议 + 节奏）种入流状态（无需重审即可裁决/查看）。
@@ -342,8 +341,17 @@ export function ReviewReport({

  // 终稿按空行切段（大文本：仅在 finalText 变化时重算，不在每次 render split）。
  const finalParas = useMemo(() => finalText.split(/\n{2,}/), [finalText]);
-  // 漂移段 idx → 终稿对应段正文（越界则空串）。
-  const segmentText = (idx: number): string => finalParas[idx]?.trim() ?? "";
+
+  // 一键回炉：用漂移段自带原文在终稿里做内容匹配定位（内容锚），定位不到则就 #9
+  // 给出明确提示而非静默 no-op；定位到才打开 RefineView。
+  const onRefineSegment = (segment: StyleDriftSegment): void => {
+    const located = locateDriftSegment(finalParas, segment);
+    if (located === null) {
+      toast("无法定位该段（原文可能已改动），请手动选择要回炉的段落。", "error");
+      return;
+    }
+    setRefineText(located);
+  };

  // 采纳：把重写段替换终稿中的原段（首个匹配），合入终稿（经既有 draft 路径）。
  const onAdopt = (original: string, refined: string): void => {
@@ -355,7 +363,7 @@ export function ReviewReport({
      }
      return prev.slice(0, idx) + refined + prev.slice(idx + original.length);
    });
-    setRefineSegment(null);
+    setRefineText(null);
    toast("已合入终稿，记得验收时复核。", "success");
  };

@@ -523,15 +531,15 @@ export function ReviewReport({
            <StylePanel
              style={style}
              incomplete={sectionStatus("style") === "incomplete"}
-              onRefine={setRefineSegment}
+              onRefine={onRefineSegment}
            />
-            {refineSegment !== null ? (
+            {refineText !== null ? (
              <RefineView
                projectId={project.id}
                chapterNo={chapterNo}
-                segment={segmentText(refineSegment.idx)}
+                segment={refineText}
                onAdopt={onAdopt}
-                onClose={() => setRefineSegment(null)}
+                onClose={() => setRefineText(null)}
              />
            ) : null}
          </div>
--- a/apps/web/components/rules/RulesPage.tsx
+++ b/apps/web/components/rules/RulesPage.tsx
@@ -19,7 +19,7 @@ interface RulesPageProps {

 // 规则页（UX §7）：四级规则列表 + 新增（乐观 + 回滚）。
 export function RulesPage({ project, initialRules }: RulesPageProps) {
-  const { items, busy, add } = useRules(initialRules);
+  const { items, busy, add, remove } = useRules(initialRules);
  const [level, setLevel] = useState<RuleLevel>("project");
  const [content, setContent] = useState("");
  const groups = useMemo(() => groupByLevel(items), [items]);
@@ -88,12 +88,23 @@ export function RulesPage({ project, initialRules }: RulesPageProps) {
                <p className="text-xs text-ink-soft">（暂无）</p>
              ) : (
                <ul className="flex flex-col gap-2">
-                  {groups[lv].map((rule, i) => (
+                  {groups[lv].map((rule) => (
                    <li
-                      key={i}
-                      className="rounded border border-line bg-panel px-3 py-2 text-sm text-ink"
+                      key={rule.id}
+                      className="flex items-start justify-between gap-3 rounded border border-line bg-panel px-3 py-2 text-sm text-ink"
                    >
-                      {rule.content}
+                      <span className="min-w-0 flex-1 break-words">
+                        {rule.content}
+                      </span>
+                      <button
+                        type="button"
+                        disabled={busy}
+                        onClick={() => void remove(project.id, rule.id)}
+                        aria-label="删除规则"
+                        className="shrink-0 text-xs text-ink-soft hover:text-cinnabar disabled:opacity-50"
+                      >
+                        删除
+                      </button>
                    </li>
                  ))}
                </ul>