feat(web): F1/F2/F3 前端——拆书入库为规则 / 续写式链选择 / 模板库

- gen:api 纳入 /templates、chain continue_volume、teardown rules ingest 端点 - F1：GeneratorRunner 识别拆书为单对象入库（整 preview 作一条 teardown）， ingestTable(BookTeardownResult)=rules，buildIngestRequest 组装 teardown 体，按 isSingleObjectIngest 隐藏勾选框、改文案「入库为规则」 - F2：ChainStarter 加链类型单选（draft_volume 从头写 / continue_volume 续写）， chain_key 作 path 参传给 run（CHAIN_KINDS 对齐后端 SUPPORTED_CHAINS） - F3：模板库页 app/templates + 全局 nav 入口 + TemplatesManager（列/建/删，乐观更新回滚）； GeneratorRunner 加 TemplateFiller「从模板填入」（body 填进 brief/text，纯前端） - vitest 覆盖 templates/ingest teardown/templateFillTarget/CHAIN_KINDS 纯逻辑
2026-06-23 20:29:48 +02:00
parent 5d8e619408
commit 1a402f5ccc
18 changed files with 869 additions and 19 deletions
--- a/apps/web/app/templates/page.tsx
+++ b/apps/web/app/templates/page.tsx
@@ -0,0 +1,32 @@
+import { AppShell } from "@/components/AppShell";
+import { TemplatesManager } from "@/components/templates/TemplatesManager";
+import { fetchTemplates } from "@/lib/api/server";
+import type { TemplateResponse } from "@/lib/api/types";
+
+// 提示词/模板库（F3，全局单用户本地版）。Server Component 预取列表；CRUD 在客户端组件。
+export default async function TemplatesPage() {
+  let initial: TemplateResponse[] = [];
+  let loadError = false;
+  try {
+    initial = await fetchTemplates();
+  } catch {
+    loadError = true;
+  }
+
+  return (
+    <AppShell title="提示词 / 模板库">
+      <div className="mx-auto max-w-3xl px-8 py-10">
+        <p className="mb-6 text-xs text-ink-soft">
+          保存常用提示词，复用时一键填入生成器的 brief / 原文输入。仅本地、单用户，不做分享。
+        </p>
+        {loadError ? (
+          <p className="rounded border border-conflict bg-panel p-6 text-conflict">
+            无法连接后端服务，请确认 API 已启动后刷新。
+          </p>
+        ) : (
+          <TemplatesManager initial={initial} />
+        )}
+      </div>
+    </AppShell>
+  );
+}
--- a/apps/web/components/chain/ChainPage.tsx
+++ b/apps/web/components/chain/ChainPage.tsx
@@ -5,7 +5,7 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 import { AppShell } from "@/components/AppShell";
 import { useToast } from "@/components/Toast";
 import { api } from "@/lib/api/client";
-import { chainPhase, chainResultView } from "@/lib/chain/chain";
+import { chainPhase, chainResultView, type ChainKind } from "@/lib/chain/chain";
 import { friendlyError } from "@/lib/errors/messages";
 import { useJobPoll } from "@/lib/jobs/useJobPoll";
 import type { ProjectResponse } from "@/lib/api/types";
@@ -17,8 +17,6 @@ interface ChainPageProps {
  project: ProjectResponse;
 }

-const CHAIN_KEY = "draft_volume";
-
 // 多章工作流链页（Scope B B1）：发起链(POST run)→job 轮询进度→interrupt 命中则读该章冲突裁决→
 // POST resume 续跑。复用 useJobPoll（轮询）+ ConflictCard/decisions（裁决）+ friendlyError（文案）。
 // 链是后台任务，走 job 轮询而非 SSE。awaiting 时停轮询（后端把 job 置 awaiting_input，
@@ -43,14 +41,18 @@ export function ChainPage({ project }: ChainPageProps) {
  }, [phase, poll]);

  const onStart = useCallback(
-    async (startChapterNo: number, count: number): Promise<void> => {
+    async (
+      chainKey: ChainKind,
+      startChapterNo: number,
+      count: number,
+    ): Promise<void> => {
      setStarting(true);
      try {
        const { data, error } = await api.POST(
          "/projects/{project_id}/chains/{chain_key}/run",
          {
            params: {
-              path: { project_id: project.id, chain_key: CHAIN_KEY },
+              path: { project_id: project.id, chain_key: chainKey },
            },
            body: { start_chapter_no: startChapterNo, count },
          },
@@ -89,7 +91,10 @@ export function ChainPage({ project }: ChainPageProps) {
      activeNav="chains"
    >
      <div className="mx-auto flex w-full max-w-3xl flex-col gap-6 p-6">
-        <ChainStarter onStart={(s, c) => void onStart(s, c)} disabled={busy} />
+        <ChainStarter
+          onStart={(k, s, c) => void onStart(k, s, c)}
+          disabled={busy}
+        />

        {showProgress && result ? (
          <ChainProgress phase={phase} progress={poll.progress} result={result} />
--- a/apps/web/components/chain/ChainStarter.tsx
+++ b/apps/web/components/chain/ChainStarter.tsx
@@ -2,9 +2,11 @@

 import { useState } from "react";

+import { CHAIN_KINDS, type ChainKind } from "@/lib/chain/chain";
+
 interface ChainStarterProps {
-  // 发起一条链（起始章 + 章数）；父层负责 POST run + 轮询。
-  onStart: (startChapterNo: number, count: number) => void;
+  // 发起一条链（链类型 + 起始章 + 章数）；父层负责 POST run + 轮询。
+  onStart: (chainKey: ChainKind, startChapterNo: number, count: number) => void;
  // 链正在运行/等待裁决时禁用（避免重复发起）。
  disabled: boolean;
 }
@@ -12,10 +14,12 @@ interface ChainStarterProps {
 const DEFAULT_START = 1;
 const DEFAULT_COUNT = 3;
 const MAX_COUNT = 50;
+const DEFAULT_CHAIN: ChainKind = "draft_volume";

 // 链发起表单（净新）：选起始章号 + 连续写几章 → 调 onStart。
 // count 1..50（对齐后端 ChainRunRequest Field 约束；前端先拦一道，越界后端 422 兜底）。
 export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
+  const [chainKey, setChainKey] = useState<ChainKind>(DEFAULT_CHAIN);
  const [start, setStart] = useState(String(DEFAULT_START));
  const [count, setCount] = useState(String(DEFAULT_COUNT));

@@ -34,7 +38,7 @@ export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
      aria-label="发起多章链"
      onSubmit={(e) => {
        e.preventDefault();
-        if (valid && !disabled) onStart(startNo, countNo);
+        if (valid && !disabled) onStart(chainKey, startNo, countNo);
      }}
    >
      <div>
@@ -43,6 +47,33 @@ export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
          从指定章起循环「写章 → 四审 → 验收」；遇未决冲突会暂停等你裁决再续跑。
        </p>
      </div>
+      <fieldset className="flex flex-col gap-2">
+        <legend className="text-sm text-ink-soft">链类型</legend>
+        <div className="flex flex-wrap gap-4">
+          {CHAIN_KINDS.map((kind) => (
+            <label
+              key={kind.key}
+              className="flex items-start gap-2 text-sm text-ink"
+            >
+              <input
+                type="radio"
+                name="chain-kind"
+                value={kind.key}
+                checked={chainKey === kind.key}
+                onChange={() => setChainKey(kind.key)}
+                className="mt-1"
+                aria-label={kind.label}
+              />
+              <span>
+                <span className="block">{kind.label}</span>
+                <span className="block text-xs text-ink-soft">
+                  {kind.description}
+                </span>
+              </span>
+            </label>
+          ))}
+        </div>
+      </fieldset>
      <div className="flex flex-wrap gap-4">
        <label className="block text-sm text-ink-soft">
          起始章号
--- a/apps/web/components/templates/TemplatesManager.tsx
+++ b/apps/web/components/templates/TemplatesManager.tsx
@@ -0,0 +1,181 @@
+"use client";
+
+import { useCallback, useState } from "react";
+
+import { useToast } from "@/components/Toast";
+import { api } from "@/lib/api/client";
+import type { TemplateResponse } from "@/lib/api/types";
+import {
+  buildTemplateCreateRequest,
+  EMPTY_TEMPLATE_DRAFT,
+  isTemplateDraftValid,
+  type TemplateDraft,
+} from "@/lib/templates/templates";
+
+interface TemplatesManagerProps {
+  // 初始模板列表（Server Component 预取；失败给空数组 + loadError 文案）。
+  initial: TemplateResponse[];
+}
+
+// 提示词/模板库管理（F3，单用户本地版）：列出 / 新建 / 删除。
+// 列表本地维护（乐观更新失败回滚）；CRUD 走 OpenAPI 客户端。分享/市场不做（需多租户）。
+export function TemplatesManager({ initial }: TemplatesManagerProps) {
+  const toast = useToast();
+  const [templates, setTemplates] = useState<TemplateResponse[]>(initial);
+  const [draft, setDraft] = useState<TemplateDraft>(EMPTY_TEMPLATE_DRAFT);
+  const [creating, setCreating] = useState(false);
+
+  const setField = useCallback(
+    (field: keyof TemplateDraft, value: string): void => {
+      setDraft((prev) => ({ ...prev, [field]: value }));
+    },
+    [],
+  );
+
+  const onCreate = useCallback(async (): Promise<void> => {
+    if (!isTemplateDraftValid(draft)) {
+      toast("请填写标题与正文。", "error");
+      return;
+    }
+    setCreating(true);
+    try {
+      const { data, error } = await api.POST("/templates", {
+        body: buildTemplateCreateRequest(draft),
+      });
+      if (error || !data) {
+        toast("新建模板失败，请重试。", "error");
+        return;
+      }
+      setTemplates((prev) => [data, ...prev]);
+      setDraft(EMPTY_TEMPLATE_DRAFT);
+      toast("已新建模板。", "success");
+    } catch {
+      toast("新建模板请求异常，请检查网络。", "error");
+    } finally {
+      setCreating(false);
+    }
+  }, [draft, toast]);
+
+  const onDelete = useCallback(
+    async (id: string): Promise<void> => {
+      const prev = templates;
+      // 乐观删除：先移除，失败回滚。
+      setTemplates((cur) => cur.filter((t) => t.id !== id));
+      try {
+        const { error } = await api.DELETE("/templates/{template_id}", {
+          params: { path: { template_id: id } },
+        });
+        if (error) {
+          setTemplates(prev);
+          toast("删除模板失败，请重试。", "error");
+          return;
+        }
+        toast("已删除模板。", "success");
+      } catch {
+        setTemplates(prev);
+        toast("删除模板请求异常，请检查网络。", "error");
+      }
+    },
+    [templates, toast],
+  );
+
+  return (
+    <div className="flex flex-col gap-6">
+      <form
+        className="flex flex-col gap-3 rounded border border-line bg-panel p-5"
+        aria-label="新建模板"
+        onSubmit={(e) => {
+          e.preventDefault();
+          void onCreate();
+        }}
+      >
+        <h2 className="font-serif text-lg text-ink">新建模板</h2>
+        <label className="block text-sm text-ink-soft">
+          标题 *
+          <input
+            type="text"
+            value={draft.title}
+            onChange={(e) => setField("title", e.target.value)}
+            className="mt-1 w-full rounded border border-line bg-bg px-3 py-2 text-sm text-ink"
+            aria-label="标题"
+          />
+        </label>
+        <label className="block text-sm text-ink-soft">
+          正文 *（一键填入生成器的 brief/原文）
+          <textarea
+            value={draft.body}
+            onChange={(e) => setField("body", e.target.value)}
+            rows={4}
+            className="mt-1 w-full resize-y rounded border border-line bg-bg px-3 py-2 text-sm text-ink"
+            aria-label="正文"
+          />
+        </label>
+        <div className="flex flex-wrap gap-4">
+          <label className="block text-sm text-ink-soft">
+            分类（可选）
+            <input
+              type="text"
+              value={draft.category}
+              onChange={(e) => setField("category", e.target.value)}
+              className="mt-1 w-48 rounded border border-line bg-bg px-3 py-2 text-sm text-ink"
+              aria-label="分类"
+            />
+          </label>
+          <label className="block text-sm text-ink-soft">
+            关联生成器 key（可选）
+            <input
+              type="text"
+              value={draft.toolKey}
+              onChange={(e) => setField("toolKey", e.target.value)}
+              className="mt-1 w-48 rounded border border-line bg-bg px-3 py-2 text-sm text-ink"
+              aria-label="关联生成器 key"
+            />
+          </label>
+        </div>
+        <button
+          type="submit"
+          disabled={creating || !isTemplateDraftValid(draft)}
+          className="self-start rounded bg-cinnabar px-4 py-2 text-sm text-white disabled:opacity-50"
+        >
+          {creating ? "新建中…" : "新建模板"}
+        </button>
+      </form>
+
+      <section className="flex flex-col gap-3" aria-label="模板列表">
+        <h2 className="font-serif text-lg text-ink">已存模板（{templates.length}）</h2>
+        {templates.length === 0 ? (
+          <p className="text-sm text-ink-soft">（暂无模板，先新建一个吧。）</p>
+        ) : (
+          <ul className="flex flex-col gap-2">
+            {templates.map((t) => (
+              <li
+                key={t.id}
+                className="flex items-start justify-between gap-4 rounded border border-line bg-bg p-3 text-sm"
+              >
+                <div className="min-w-0 flex-1">
+                  <p className="font-serif text-base text-ink">{t.title}</p>
+                  {t.category || t.tool_key ? (
+                    <p className="text-xs text-ink-soft">
+                      {[t.category, t.tool_key].filter(Boolean).join(" · ")}
+                    </p>
+                  ) : null}
+                  <p className="mt-1 whitespace-pre-wrap text-ink-soft">
+                    {t.body}
+                  </p>
+                </div>
+                <button
+                  type="button"
+                  onClick={() => void onDelete(t.id)}
+                  className="shrink-0 rounded border border-line px-3 py-1 text-ink-soft hover:text-conflict"
+                  aria-label={`删除模板 ${t.title}`}
+                >
+                  删除
+                </button>
+              </li>
+            ))}
+          </ul>
+        )}
+      </section>
+    </div>
+  );
+}
--- a/apps/web/components/toolbox/GeneratorRunner.tsx
+++ b/apps/web/components/toolbox/GeneratorRunner.tsx
@@ -10,11 +10,13 @@ import {
  initialFieldValues,
  missingRequiredFields,
  previewRows,
+  templateFillTarget,
  type FieldValues,
  type PreviewItem,
 } from "@/lib/toolbox/toolbox";
-import { ingestTable } from "@/lib/toolbox/ingest";
+import { ingestTable, isSingleObjectIngest } from "@/lib/toolbox/ingest";
 import { useGenerator } from "@/lib/toolbox/useGenerator";
+import { TemplateFiller } from "./TemplateFiller";

 interface GeneratorRunnerProps {
  projectId: string;
@@ -42,6 +44,12 @@ export function GeneratorRunner({
    setValues((prev) => ({ ...prev, [name]: value }));
  }, []);

+  // 「从模板填入」的目标字段（brief / text；无则不渲染）。
+  const fillTarget = useMemo(
+    () => templateFillTarget(tool.input_fields),
+    [tool.input_fields],
+  );
+
  const onGenerate = useCallback(async (): Promise<void> => {
    const missing = missingRequiredFields(tool.input_fields, values);
    if (missing.length > 0) {
@@ -58,7 +66,15 @@ export function GeneratorRunner({
  );

  const table = gen.outputKind ? ingestTable(gen.outputKind) : null;
-  const canIngest = tool.ingestable && table !== null && rows.length > 0;
+  // 单对象产物（如拆书）：整个 preview 即一条入库项，无逐行勾选；行式产物按勾选入库。
+  const singleObject = gen.outputKind
+    ? isSingleObjectIngest(gen.outputKind)
+    : false;
+  const hasPreview = (gen.preview?.items.length ?? 0) > 0;
+  const canIngest =
+    tool.ingestable &&
+    table !== null &&
+    (singleObject ? hasPreview : rows.length > 0);

  const toggle = useCallback((idx: number): void => {
    setSelected((prev) => {
@@ -81,14 +97,17 @@ export function GeneratorRunner({
    async (acknowledge: boolean): Promise<void> => {
      if (!gen.outputKind) return;
      const chapterNo = Number(values["chapter_no"]?.trim() || "") || null;
+      // 单对象产物（拆书）：整个 rawPreview 作唯一入库行；行式产物用勾选行。
+      const ingestRows =
+        singleObject && gen.rawPreview ? [gen.rawPreview] : selectedRows;
      await gen.ingest(projectId, tool.key, {
        outputKind: gen.outputKind,
-        rows: selectedRows,
+        rows: ingestRows,
        chapterNo,
        acknowledgeConflicts: acknowledge,
      });
    },
-    [gen, projectId, tool.key, selectedRows, values],
+    [gen, projectId, tool.key, selectedRows, values, singleObject],
  );

  const generating = gen.genStatus === "generating";
@@ -120,6 +139,7 @@ export function GeneratorRunner({
          void onGenerate();
        }}
      >
+        <TemplateFiller targetField={fillTarget} onFill={setField} />
        {(tool.input_fields ?? []).map((field) => (
          <FormField
            key={field.name}
@@ -141,7 +161,11 @@ export function GeneratorRunner({
        <div className="flex flex-col gap-3">
          <h3 className="font-serif text-sm text-ink">
            预览（{gen.preview.items.length}）
-            {canIngest ? "（勾选后可入库）" : null}
+            {canIngest
+              ? singleObject
+                ? "（可入库）"
+                : "（勾选后可入库）"
+              : null}
          </h3>
          <ul className="flex flex-col gap-2">
            {gen.preview.items.map((item, i) => (
@@ -149,7 +173,7 @@ export function GeneratorRunner({
                key={i}
                item={item}
                index={i}
-                selectable={canIngest}
+                selectable={canIngest && !singleObject}
                checked={selected.has(i)}
                onToggle={toggle}
              />
@@ -160,10 +184,14 @@ export function GeneratorRunner({
            <button
              type="button"
              onClick={() => void runIngest(false)}
-              disabled={ingesting || selected.size === 0}
+              disabled={ingesting || (!singleObject && selected.size === 0)}
              className="self-start rounded border border-cinnabar px-4 py-2 text-sm text-cinnabar disabled:opacity-50"
            >
-              {ingesting ? "入库中…" : `入库选中（${selected.size}）至 ${table}`}
+              {ingesting
+                ? "入库中…"
+                : singleObject
+                  ? `入库为规则至 ${table}`
+                  : `入库选中（${selected.size}）至 ${table}`}
            </button>
          ) : null}

--- a/apps/web/components/toolbox/TemplateFiller.tsx
+++ b/apps/web/components/toolbox/TemplateFiller.tsx
@@ -0,0 +1,102 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+
+import { useToast } from "@/components/Toast";
+import { api } from "@/lib/api/client";
+import type { TemplateResponse } from "@/lib/api/types";
+
+interface TemplateFillerProps {
+  // 可填入的目标输入字段名（如 brief / text）；空 → 不渲染（无可填字段）。
+  targetField: string | null;
+  // 选定模板 → 把其 body 填进目标字段（纯前端，不改生成器后端）。
+  onFill: (field: string, body: string) => void;
+}
+
+// 「从模板填入」（F3，纯前端）：进场懒加载模板库，选一个把 body 填进生成器的 brief/原文输入。
+// 与生成器后端解耦——只读 /templates 并回写本地表单值。无模板/无目标字段则不渲染。
+export function TemplateFiller({ targetField, onFill }: TemplateFillerProps) {
+  const toast = useToast();
+  const [templates, setTemplates] = useState<TemplateResponse[] | null>(null);
+  const [open, setOpen] = useState(false);
+
+  const load = useCallback(async (): Promise<void> => {
+    try {
+      const { data, error } = await api.GET("/templates", {});
+      if (error || !data) {
+        toast("加载模板失败。", "error");
+        setTemplates([]);
+        return;
+      }
+      setTemplates(data);
+    } catch {
+      toast("加载模板请求异常，请检查网络。", "error");
+      setTemplates([]);
+    }
+  }, [toast]);
+
+  useEffect(() => {
+    if (open && templates === null) void load();
+  }, [open, templates, load]);
+
+  if (!targetField) return null;
+  const field = targetField;
+
+  if (!open) {
+    return (
+      <button
+        type="button"
+        onClick={() => setOpen(true)}
+        className="self-start rounded border border-line px-3 py-1 text-sm text-ink-soft hover:text-ink"
+      >
+        从模板填入
+      </button>
+    );
+  }
+
+  return (
+    <div
+      className="flex flex-col gap-2 rounded border border-line bg-bg p-3"
+      aria-label="从模板填入"
+    >
+      <div className="flex items-center justify-between">
+        <span className="text-sm text-ink-soft">选一个模板填入「{field}」</span>
+        <button
+          type="button"
+          onClick={() => setOpen(false)}
+          className="text-xs text-ink-soft hover:text-ink"
+        >
+          收起
+        </button>
+      </div>
+      {templates === null ? (
+        <p className="text-sm text-ink-soft">加载中…</p>
+      ) : templates.length === 0 ? (
+        <p className="text-sm text-ink-soft">（暂无模板，去模板库新建。）</p>
+      ) : (
+        <ul className="flex flex-col gap-1">
+          {templates.map((t) => (
+            <li key={t.id}>
+              <button
+                type="button"
+                onClick={() => {
+                  onFill(field, t.body);
+                  setOpen(false);
+                  toast(`已填入模板「${t.title}」。`, "success");
+                }}
+                className="w-full rounded border border-line px-3 py-2 text-left text-sm text-ink hover:border-cinnabar"
+              >
+                <span className="font-serif">{t.title}</span>
+                {t.tool_key ? (
+                  <span className="ml-2 text-xs text-ink-soft">
+                    {t.tool_key}
+                  </span>
+                ) : null}
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}
--- a/apps/web/lib/api/schema.d.ts
+++ b/apps/web/lib/api/schema.d.ts
@@ -377,6 +377,50 @@ export interface paths {
        patch?: never;
        trace?: never;
    };
+    "/templates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Templates
+         * @description 列出当前用户（stub）的模板。
+         */
+        get: operations["list_templates_templates_get"];
+        put?: never;
+        /**
+         * Create Template
+         * @description 新建模板（201）。title/body 空 → FastAPI 422（schema `min_length=1`）。
+         */
+        post: operations["create_template_templates_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/templates/{template_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Template
+         * @description 删除模板（204）。不存在 → 404 NOT_FOUND。
+         */
+        delete: operations["delete_template_templates__template_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
    "/projects/{project_id}/world/generate": {
        parameters: {
            query?: never;
@@ -1719,6 +1763,78 @@ export interface components {
             */
            job_id: string;
        };
+        /**
+         * TeardownIngestView
+         * @description 拆书入库产物（贴 ww_agents.BookTeardownResult；落 rules 表）。F1。
+         */
+        TeardownIngestView: {
+            /**
+             * Themes
+             * @description 核心主题/立意清单
+             */
+            themes?: string[];
+            /**
+             * Archetypes
+             * @description 人物原型/角色模板清单
+             */
+            archetypes?: string[];
+            /**
+             * Structure
+             * @description 叙事结构概述
+             * @default
+             */
+            structure: string;
+            /**
+             * Hooks
+             * @description 抓人钩子/爽点套路清单
+             */
+            hooks?: string[];
+        };
+        /**
+         * TemplateCreateRequest
+         * @description POST /templates：新建一条提示词模板。
+         */
+        TemplateCreateRequest: {
+            /**
+             * Title
+             * @description 模板标题
+             */
+            title: string;
+            /**
+             * Body
+             * @description 模板正文（一键填入生成器的 brief/text）
+             */
+            body: string;
+            /**
+             * Category
+             * @description 可选分类
+             */
+            category?: string | null;
+            /**
+             * Tool Key
+             * @description 可选关联生成器（NULL=通用）
+             */
+            tool_key?: string | null;
+        };
+        /**
+         * TemplateResponse
+         * @description 模板视图（列出/创建后回显；snake_case）。
+         */
+        TemplateResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Title */
+            title: string;
+            /** Body */
+            body: string;
+            /** Category */
+            category?: string | null;
+            /** Tool Key */
+            tool_key?: string | null;
+        };
        /**
         * TestConnectionRequest
         * @description POST /test：最小探测请求。
@@ -1861,7 +1977,8 @@ export interface components {
         *
         *     仅声明了 `ingest` 的工具可用。按入库表取用对应字段：
         *     - world_entities（金手指/词条）→ `world_entities`（贴 WorldEntityCardView：type/name/rules）；
-         *     - outline（细纲）→ `chapter_no` + `scenes`（贴 OutlineSceneIngestView）。
+         *     - outline（细纲）→ `chapter_no` + `scenes`（贴 OutlineSceneIngestView）；
+         *     - rules（拆书）→ `teardown`（贴 TeardownIngestView：themes/archetypes/structure/hooks）。
         *     `acknowledge_conflicts`：作者已查看并接受 continuity 预检冲突时置 true 放行（仿 accept gate）。
         */
        ToolIngestRequest: {
@@ -1880,6 +1997,8 @@ export interface components {
             * @description outline 入库的场景行（细纲）
             */
            scenes?: components["schemas"]["OutlineSceneIngestView"][];
+            /** @description rules 入库的拆书结论（F1；拍平为可读规则条目） */
+            teardown?: components["schemas"]["TeardownIngestView"] | null;
            /**
             * Acknowledge Conflicts
             * @description 作者已知悉并接受 continuity 冲突 → 放行入库
@@ -2866,6 +2985,88 @@ export interface operations {
            };
        };
    };
+    list_templates_templates_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TemplateResponse"][];
+                };
+            };
+        };
+    };
+    create_template_templates_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TemplateCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TemplateResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_template_templates__template_id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                template_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
    generate_world_projects__project_id__world_generate_post: {
        parameters: {
            query?: never;
--- a/apps/web/lib/api/server.ts
+++ b/apps/web/lib/api/server.ts
@@ -13,6 +13,7 @@ import type {
  RuleListResponse,
  SkillListResponse,
  StyleFingerprintResponse,
+  TemplateResponse,
  ToolboxListResponse,
  WorldEntityListResponse,
 } from "./types";
@@ -149,6 +150,16 @@ export async function fetchOutline(
  }
 }

+// 提示词/模板库列表（GET /templates，全局只读；裸数组）。
+// 任何错误（含后端未上线）降级为空列表，模板页照常渲染（进页不阻塞）。
+export async function fetchTemplates(): Promise<TemplateResponse[]> {
+  try {
+    return await getJson<TemplateResponse[]>("/templates");
+  } catch {
+    return [];
+  }
+}
+
 // 已存草稿（GET .../draft，含正文，供工作台重访重载编辑器）。
 // 404（尚无草稿，新章）→ null，由调用方当空编辑器处理，不抛错。
 export async function fetchDraft(
--- a/apps/web/lib/api/types.ts
+++ b/apps/web/lib/api/types.ts
@@ -85,6 +85,11 @@ export type CharacterListResponse =
 export type WorldEntityListResponse =
  components["schemas"]["WorldEntityListResponse"];

+// F3 提示词/模板库（单用户本地版；GET/POST/DELETE /templates）。
+export type TemplateResponse = components["schemas"]["TemplateResponse"];
+export type TemplateCreateRequest =
+  components["schemas"]["TemplateCreateRequest"];
+
 // K1 Kimi Code OAuth device-flow（C3 扩 K1.3）。
 export type OAuthStartResponse = components["schemas"]["OAuthStartResponse"];
 export type OAuthDisconnectResponse =
@@ -113,3 +118,6 @@ export type ToolIngestRequest = components["schemas"]["ToolIngestRequest"];
 export type ToolIngestResponse = components["schemas"]["ToolIngestResponse"];
 export type OutlineSceneIngestView =
  components["schemas"]["OutlineSceneIngestView"];
+// F1：拆书入库产物（themes/archetypes/structure/hooks → 项目 rules 条目）。
+export type TeardownIngestView =
+  components["schemas"]["TeardownIngestView"];
--- a/apps/web/lib/chain/chain.test.ts
+++ b/apps/web/lib/chain/chain.test.ts
@@ -4,6 +4,7 @@ import { emptyDecisions, setNote, setVerdict } from "@/lib/review/decisions";
 import type { JobView } from "@/lib/jobs/job";
 import {
  buildResumeRequest,
+  CHAIN_KINDS,
  chainPhase,
  chainResultView,
 } from "./chain";
@@ -110,3 +111,19 @@ describe("buildResumeRequest", () => {
    expect(buildResumeRequest([])).toEqual({ decisions: [] });
  });
 });
+
+describe("CHAIN_KINDS", () => {
+  it("exposes both built-in chain kinds aligned with backend SUPPORTED_CHAINS", () => {
+    expect(CHAIN_KINDS.map((k) => k.key)).toEqual([
+      "draft_volume",
+      "continue_volume",
+    ]);
+  });
+
+  it("gives each kind a non-empty label and description", () => {
+    for (const kind of CHAIN_KINDS) {
+      expect(kind.label.length).toBeGreaterThan(0);
+      expect(kind.description.length).toBeGreaterThan(0);
+    }
+  });
+});
--- a/apps/web/lib/chain/chain.ts
+++ b/apps/web/lib/chain/chain.ts
@@ -6,6 +6,29 @@ import type { ChainResumeRequest } from "@/lib/api/types";
 import type { JobView, PollStatus } from "@/lib/jobs/job";
 import { buildAcceptRequest, type DecisionDraft } from "@/lib/review/decisions";

+// 内置链类型（对齐后端 SUPPORTED_CHAINS）：draft_volume=从 start 章按记忆量产；
+// continue_volume=续写式（每章以上一章 accepted 正文末尾作前文引子，比纯 digest 更顺）。
+export type ChainKind = "draft_volume" | "continue_volume";
+
+export interface ChainKindOption {
+  key: ChainKind;
+  label: string;
+  description: string;
+}
+
+export const CHAIN_KINDS: readonly ChainKindOption[] = [
+  {
+    key: "draft_volume",
+    label: "从头写",
+    description: "按记忆与大纲量产，每章独立写。",
+  },
+  {
+    key: "continue_volume",
+    label: "续写",
+    description: "每章以上一章已验收正文末尾作前文引子，承接更顺。",
+  },
+];
+
 // 链 job result 的视图模型（与后端 `_chain_result` 字段对齐：chain_key/written/completed/
 // awaiting_chapter）。token/正文绝不入 result（不变量 #5 / chain §5），故此处只有进度元数据。
 export interface ChainResultView {
--- a/apps/web/lib/nav/items.ts
+++ b/apps/web/lib/nav/items.ts
@@ -22,6 +22,7 @@ export interface NavItem {

 export const GLOBAL_NAV_ITEMS: readonly NavItem[] = [
  { href: "/", label: "作品库" },
+  { href: "/templates", label: "模板库" },
  { href: "/settings/providers", label: "设置" },
 ];

--- a/apps/web/lib/templates/templates.test.ts
+++ b/apps/web/lib/templates/templates.test.ts
@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  buildTemplateCreateRequest,
+  EMPTY_TEMPLATE_DRAFT,
+  isTemplateDraftValid,
+  type TemplateDraft,
+} from "./templates";
+
+const draft = (over: Partial<TemplateDraft>): TemplateDraft => ({
+  ...EMPTY_TEMPLATE_DRAFT,
+  ...over,
+});
+
+describe("isTemplateDraftValid", () => {
+  it("returns true when title and body are both non-empty", () => {
+    expect(isTemplateDraftValid(draft({ title: "标题", body: "正文" }))).toBe(
+      true,
+    );
+  });
+
+  it("returns false when title is blank", () => {
+    expect(isTemplateDraftValid(draft({ title: "  ", body: "正文" }))).toBe(
+      false,
+    );
+  });
+
+  it("returns false when body is blank", () => {
+    expect(isTemplateDraftValid(draft({ title: "标题", body: "" }))).toBe(false);
+  });
+
+  it("returns false for the empty draft", () => {
+    expect(isTemplateDraftValid(EMPTY_TEMPLATE_DRAFT)).toBe(false);
+  });
+});
+
+describe("buildTemplateCreateRequest", () => {
+  it("trims title and body and includes optional fields", () => {
+    const body = buildTemplateCreateRequest(
+      draft({
+        title: "  脑洞模板  ",
+        body: "  写一个穿越故事  ",
+        category: " 脑洞 ",
+        toolKey: " idea ",
+      }),
+    );
+    expect(body).toEqual({
+      title: "脑洞模板",
+      body: "写一个穿越故事",
+      category: "脑洞",
+      tool_key: "idea",
+    });
+  });
+
+  it("nulls out blank category and tool_key", () => {
+    const body = buildTemplateCreateRequest(
+      draft({ title: "t", body: "b", category: "  ", toolKey: "" }),
+    );
+    expect(body.category).toBeNull();
+    expect(body.tool_key).toBeNull();
+  });
+});
--- a/apps/web/lib/templates/templates.ts
+++ b/apps/web/lib/templates/templates.ts
@@ -0,0 +1,39 @@
+// 提示词/模板库前端纯逻辑（F3）：新建表单值校验 + 请求体组装。
+// 纯逻辑（无 React / 无 fetch），便于 node 环境单测。后端 title/body 非空校验为权威（422 兜底），
+// 前端先拦一道给即时反馈（守边界：不信输入，提交前 trim 判空）。
+
+import type { TemplateCreateRequest } from "@/lib/api/types";
+
+// 新建模板的草稿表单值（受控输入原始值）。
+export interface TemplateDraft {
+  title: string;
+  body: string;
+  category: string;
+  toolKey: string;
+}
+
+export const EMPTY_TEMPLATE_DRAFT: TemplateDraft = {
+  title: "",
+  body: "",
+  category: "",
+  toolKey: "",
+};
+
+// 草稿是否可提交（title/body 去空白后非空）。
+export function isTemplateDraftValid(draft: TemplateDraft): boolean {
+  return draft.title.trim().length > 0 && draft.body.trim().length > 0;
+}
+
+// 草稿 → 创建请求体：trim title/body；空 category/toolKey 省略为 null（后端可空）。
+export function buildTemplateCreateRequest(
+  draft: TemplateDraft,
+): TemplateCreateRequest {
+  const category = draft.category.trim();
+  const toolKey = draft.toolKey.trim();
+  return {
+    title: draft.title.trim(),
+    body: draft.body.trim(),
+    category: category.length > 0 ? category : null,
+    tool_key: toolKey.length > 0 ? toolKey : null,
+  };
+}
--- a/apps/web/lib/toolbox/ingest.test.ts
+++ b/apps/web/lib/toolbox/ingest.test.ts
@@ -1,12 +1,17 @@
 import { describe, expect, it } from "vitest";

-import { buildIngestRequest, ingestTable } from "./ingest";
+import {
+  buildIngestRequest,
+  ingestTable,
+  isSingleObjectIngest,
+} from "./ingest";

 describe("ingestTable", () => {
  it("maps ingestable kinds to their target table", () => {
    expect(ingestTable("GoldenFingerResult")).toBe("world_entities");
    expect(ingestTable("GlossaryResult")).toBe("world_entities");
    expect(ingestTable("DetailedOutlineResult")).toBe("outline");
+    expect(ingestTable("BookTeardownResult")).toBe("rules");
  });

  it("returns null for non-ingestable kinds", () => {
@@ -15,6 +20,18 @@ describe("ingestTable", () => {
  });
 });

+describe("isSingleObjectIngest", () => {
+  it("flags teardown as single-object ingest", () => {
+    expect(isSingleObjectIngest("BookTeardownResult")).toBe(true);
+  });
+
+  it("treats row-based kinds as not single-object", () => {
+    expect(isSingleObjectIngest("GoldenFingerResult")).toBe(false);
+    expect(isSingleObjectIngest("DetailedOutlineResult")).toBe(false);
+    expect(isSingleObjectIngest("unknown")).toBe(false);
+  });
+});
+
 describe("buildIngestRequest", () => {
  it("maps golden finger rows into world_entities with merged rules", () => {
    const body = buildIngestRequest({
@@ -81,6 +98,36 @@ describe("buildIngestRequest", () => {
    expect(body?.acknowledge_conflicts).toBe(false);
  });

+  it("maps teardown single object to a teardown body", () => {
+    const body = buildIngestRequest({
+      outputKind: "BookTeardownResult",
+      rows: [
+        {
+          themes: ["逆袭", "成长"],
+          archetypes: ["废柴主角"],
+          structure: "三幕式",
+          hooks: ["开局打脸"],
+        },
+      ],
+      acknowledgeConflicts: true,
+    });
+    expect(body).toEqual({
+      teardown: {
+        themes: ["逆袭", "成长"],
+        archetypes: ["废柴主角"],
+        structure: "三幕式",
+        hooks: ["开局打脸"],
+      },
+      acknowledge_conflicts: true,
+    });
+  });
+
+  it("returns null for teardown with no rows", () => {
+    expect(
+      buildIngestRequest({ outputKind: "BookTeardownResult", rows: [] }),
+    ).toBeNull();
+  });
+
  it("returns null for non-ingestable output kind", () => {
    expect(
      buildIngestRequest({ outputKind: "IdeaListResult", rows: [] }),
--- a/apps/web/lib/toolbox/ingest.ts
+++ b/apps/web/lib/toolbox/ingest.ts
@@ -4,6 +4,7 @@

 import type {
  OutlineSceneIngestView,
+  TeardownIngestView,
  ToolIngestRequest,
  WorldEntityCardView,
 } from "@/lib/api/types";
@@ -63,6 +64,17 @@ function rowToScene(
  };
 }

+// 拆书结构化产物 → TeardownIngestView（贴后端 schema；后端再拍平为可读 rules 条目）。
+// 单对象产物：整个 preview 对象即一条入库项（无逐行勾选）。
+function rowToTeardown(row: Record<string, unknown>): TeardownIngestView {
+  return {
+    themes: asStringArray(row["themes"]),
+    archetypes: asStringArray(row["archetypes"]),
+    structure: asString(row["structure"]),
+    hooks: asStringArray(row["hooks"]),
+  };
+}
+
 export interface IngestBuildInput {
  outputKind: string;
  // 作者勾选要入库的预览行（结构化产物原始记录）。
@@ -72,6 +84,15 @@ export interface IngestBuildInput {
  acknowledgeConflicts?: boolean;
 }

+// 单对象入库的 output_kind：整个 preview 即一条入库项（无逐行勾选）。
+// 当前仅拆书（结构化结论拍平为 rules）。行式产物（金手指/词条/细纲）不在此列。
+const SINGLE_OBJECT_INGEST_KINDS = new Set(["BookTeardownResult"]);
+
+// 该产物是否「单对象入库」（UI 据此隐藏勾选框、改文案、用整个 rawPreview 作唯一行）。
+export function isSingleObjectIngest(outputKind: string): boolean {
+  return SINGLE_OBJECT_INGEST_KINDS.has(outputKind);
+}
+
 // 入库目标表（供 UI 文案 / 判定）。未知 → null（不可入库）。
 export function ingestTable(outputKind: string): string | null {
  switch (outputKind) {
@@ -80,6 +101,8 @@ export function ingestTable(outputKind: string): string | null {
      return "world_entities";
    case "DetailedOutlineResult":
      return "outline";
+    case "BookTeardownResult":
+      return "rules";
    default:
      return null;
  }
@@ -107,6 +130,12 @@ export function buildIngestRequest(
        scenes: input.rows.map((row, i) => rowToScene(row, i)),
        acknowledge_conflicts,
      };
+    case "BookTeardownResult": {
+      // 单对象产物：取首行（整个拆书结论）作 teardown；无产物 → null。
+      const row = input.rows[0];
+      if (!row) return null;
+      return { teardown: rowToTeardown(row), acknowledge_conflicts };
+    }
    default:
      return null;
  }
--- a/apps/web/lib/toolbox/toolbox.test.ts
+++ b/apps/web/lib/toolbox/toolbox.test.ts
@@ -9,6 +9,7 @@ import {
  missingRequiredFields,
  previewRows,
  resolveLegacyRoute,
+  templateFillTarget,
 } from "./toolbox";

 const field = (over: Partial<ToolInputFieldView> = {}): ToolInputFieldView => ({
@@ -210,3 +211,20 @@ describe("isLegacyTool", () => {
    ).toBe(false);
  });
 });
+
+describe("templateFillTarget", () => {
+  it("prefers brief when present", () => {
+    expect(
+      templateFillTarget([field({ name: "brief" }), field({ name: "text" })]),
+    ).toBe("brief");
+  });
+
+  it("falls back to text when brief absent", () => {
+    expect(templateFillTarget([field({ name: "text" })])).toBe("text");
+  });
+
+  it("returns null when no fillable field exists", () => {
+    expect(templateFillTarget([field({ name: "count" })])).toBeNull();
+    expect(templateFillTarget(undefined)).toBeNull();
+  });
+});
--- a/apps/web/lib/toolbox/toolbox.ts
+++ b/apps/web/lib/toolbox/toolbox.ts
@@ -292,6 +292,21 @@ function fallbackItem(row: Record<string, unknown>): PreviewItem {
  return { heading, fields, body: null };
 }

+// —— 模板填入目标 ——
+// 模板 body 一键填入的目标输入字段：优先 brief（多数生成器主输入），否则 text（原文输入类）。
+// 都没有则 null（不渲染「从模板填入」）。F3：纯前端，不改生成器后端。
+const TEMPLATE_FILL_FIELDS = ["brief", "text"] as const;
+
+export function templateFillTarget(
+  fields: readonly ToolInputFieldView[] | undefined,
+): string | null {
+  const names = new Set((fields ?? []).map((f) => f.name));
+  for (const candidate of TEMPLATE_FILL_FIELDS) {
+    if (names.has(candidate)) return candidate;
+  }
+  return null;
+}
+
 // —— legacy 路由解析 ——
 // legacy 工具的 legacy_route 含 {id} 占位（如 /projects/{id}/codex?gen=world）→ 替换为真实 projectId。
 export function resolveLegacyRoute(