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 纯逻辑
This commit is contained in:
Yaojia Wang
2026-06-23 20:29:48 +02:00
parent 5d8e619408
commit 1a402f5ccc
18 changed files with 869 additions and 19 deletions

View File

@@ -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>
);
}

View File

@@ -5,7 +5,7 @@ import { useCallback, useEffect, useMemo, useState } from "react";
import { AppShell } from "@/components/AppShell"; import { AppShell } from "@/components/AppShell";
import { useToast } from "@/components/Toast"; import { useToast } from "@/components/Toast";
import { api } from "@/lib/api/client"; 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 { friendlyError } from "@/lib/errors/messages";
import { useJobPoll } from "@/lib/jobs/useJobPoll"; import { useJobPoll } from "@/lib/jobs/useJobPoll";
import type { ProjectResponse } from "@/lib/api/types"; import type { ProjectResponse } from "@/lib/api/types";
@@ -17,8 +17,6 @@ interface ChainPageProps {
project: ProjectResponse; project: ProjectResponse;
} }
const CHAIN_KEY = "draft_volume";
// 多章工作流链页Scope B B1发起链(POST run)→job 轮询进度→interrupt 命中则读该章冲突裁决→ // 多章工作流链页Scope B B1发起链(POST run)→job 轮询进度→interrupt 命中则读该章冲突裁决→
// POST resume 续跑。复用 useJobPoll轮询+ ConflictCard/decisions裁决+ friendlyError文案 // POST resume 续跑。复用 useJobPoll轮询+ ConflictCard/decisions裁决+ friendlyError文案
// 链是后台任务,走 job 轮询而非 SSE。awaiting 时停轮询(后端把 job 置 awaiting_input // 链是后台任务,走 job 轮询而非 SSE。awaiting 时停轮询(后端把 job 置 awaiting_input
@@ -43,14 +41,18 @@ export function ChainPage({ project }: ChainPageProps) {
}, [phase, poll]); }, [phase, poll]);
const onStart = useCallback( const onStart = useCallback(
async (startChapterNo: number, count: number): Promise<void> => { async (
chainKey: ChainKind,
startChapterNo: number,
count: number,
): Promise<void> => {
setStarting(true); setStarting(true);
try { try {
const { data, error } = await api.POST( const { data, error } = await api.POST(
"/projects/{project_id}/chains/{chain_key}/run", "/projects/{project_id}/chains/{chain_key}/run",
{ {
params: { params: {
path: { project_id: project.id, chain_key: CHAIN_KEY }, path: { project_id: project.id, chain_key: chainKey },
}, },
body: { start_chapter_no: startChapterNo, count }, body: { start_chapter_no: startChapterNo, count },
}, },
@@ -89,7 +91,10 @@ export function ChainPage({ project }: ChainPageProps) {
activeNav="chains" activeNav="chains"
> >
<div className="mx-auto flex w-full max-w-3xl flex-col gap-6 p-6"> <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 ? ( {showProgress && result ? (
<ChainProgress phase={phase} progress={poll.progress} result={result} /> <ChainProgress phase={phase} progress={poll.progress} result={result} />

View File

@@ -2,9 +2,11 @@
import { useState } from "react"; import { useState } from "react";
import { CHAIN_KINDS, type ChainKind } from "@/lib/chain/chain";
interface ChainStarterProps { interface ChainStarterProps {
// 发起一条链(起始章 + 章数);父层负责 POST run + 轮询。 // 发起一条链(链类型 + 起始章 + 章数);父层负责 POST run + 轮询。
onStart: (startChapterNo: number, count: number) => void; onStart: (chainKey: ChainKind, startChapterNo: number, count: number) => void;
// 链正在运行/等待裁决时禁用(避免重复发起)。 // 链正在运行/等待裁决时禁用(避免重复发起)。
disabled: boolean; disabled: boolean;
} }
@@ -12,10 +14,12 @@ interface ChainStarterProps {
const DEFAULT_START = 1; const DEFAULT_START = 1;
const DEFAULT_COUNT = 3; const DEFAULT_COUNT = 3;
const MAX_COUNT = 50; const MAX_COUNT = 50;
const DEFAULT_CHAIN: ChainKind = "draft_volume";
// 链发起表单(净新):选起始章号 + 连续写几章 → 调 onStart。 // 链发起表单(净新):选起始章号 + 连续写几章 → 调 onStart。
// count 1..50(对齐后端 ChainRunRequest Field 约束;前端先拦一道,越界后端 422 兜底)。 // count 1..50(对齐后端 ChainRunRequest Field 约束;前端先拦一道,越界后端 422 兜底)。
export function ChainStarter({ onStart, disabled }: ChainStarterProps) { export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
const [chainKey, setChainKey] = useState<ChainKind>(DEFAULT_CHAIN);
const [start, setStart] = useState(String(DEFAULT_START)); const [start, setStart] = useState(String(DEFAULT_START));
const [count, setCount] = useState(String(DEFAULT_COUNT)); const [count, setCount] = useState(String(DEFAULT_COUNT));
@@ -34,7 +38,7 @@ export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
aria-label="发起多章链" aria-label="发起多章链"
onSubmit={(e) => { onSubmit={(e) => {
e.preventDefault(); e.preventDefault();
if (valid && !disabled) onStart(startNo, countNo); if (valid && !disabled) onStart(chainKey, startNo, countNo);
}} }}
> >
<div> <div>
@@ -43,6 +47,33 @@ export function ChainStarter({ onStart, disabled }: ChainStarterProps) {
</p> </p>
</div> </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"> <div className="flex flex-wrap gap-4">
<label className="block text-sm text-ink-soft"> <label className="block text-sm text-ink-soft">

View File

@@ -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>
);
}

View File

@@ -10,11 +10,13 @@ import {
initialFieldValues, initialFieldValues,
missingRequiredFields, missingRequiredFields,
previewRows, previewRows,
templateFillTarget,
type FieldValues, type FieldValues,
type PreviewItem, type PreviewItem,
} from "@/lib/toolbox/toolbox"; } from "@/lib/toolbox/toolbox";
import { ingestTable } from "@/lib/toolbox/ingest"; import { ingestTable, isSingleObjectIngest } from "@/lib/toolbox/ingest";
import { useGenerator } from "@/lib/toolbox/useGenerator"; import { useGenerator } from "@/lib/toolbox/useGenerator";
import { TemplateFiller } from "./TemplateFiller";
interface GeneratorRunnerProps { interface GeneratorRunnerProps {
projectId: string; projectId: string;
@@ -42,6 +44,12 @@ export function GeneratorRunner({
setValues((prev) => ({ ...prev, [name]: value })); setValues((prev) => ({ ...prev, [name]: value }));
}, []); }, []);
// 「从模板填入」的目标字段brief / text无则不渲染
const fillTarget = useMemo(
() => templateFillTarget(tool.input_fields),
[tool.input_fields],
);
const onGenerate = useCallback(async (): Promise<void> => { const onGenerate = useCallback(async (): Promise<void> => {
const missing = missingRequiredFields(tool.input_fields, values); const missing = missingRequiredFields(tool.input_fields, values);
if (missing.length > 0) { if (missing.length > 0) {
@@ -58,7 +66,15 @@ export function GeneratorRunner({
); );
const table = gen.outputKind ? ingestTable(gen.outputKind) : null; 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 => { const toggle = useCallback((idx: number): void => {
setSelected((prev) => { setSelected((prev) => {
@@ -81,14 +97,17 @@ export function GeneratorRunner({
async (acknowledge: boolean): Promise<void> => { async (acknowledge: boolean): Promise<void> => {
if (!gen.outputKind) return; if (!gen.outputKind) return;
const chapterNo = Number(values["chapter_no"]?.trim() || "") || null; const chapterNo = Number(values["chapter_no"]?.trim() || "") || null;
// 单对象产物(拆书):整个 rawPreview 作唯一入库行;行式产物用勾选行。
const ingestRows =
singleObject && gen.rawPreview ? [gen.rawPreview] : selectedRows;
await gen.ingest(projectId, tool.key, { await gen.ingest(projectId, tool.key, {
outputKind: gen.outputKind, outputKind: gen.outputKind,
rows: selectedRows, rows: ingestRows,
chapterNo, chapterNo,
acknowledgeConflicts: acknowledge, acknowledgeConflicts: acknowledge,
}); });
}, },
[gen, projectId, tool.key, selectedRows, values], [gen, projectId, tool.key, selectedRows, values, singleObject],
); );
const generating = gen.genStatus === "generating"; const generating = gen.genStatus === "generating";
@@ -120,6 +139,7 @@ export function GeneratorRunner({
void onGenerate(); void onGenerate();
}} }}
> >
<TemplateFiller targetField={fillTarget} onFill={setField} />
{(tool.input_fields ?? []).map((field) => ( {(tool.input_fields ?? []).map((field) => (
<FormField <FormField
key={field.name} key={field.name}
@@ -141,7 +161,11 @@ export function GeneratorRunner({
<div className="flex flex-col gap-3"> <div className="flex flex-col gap-3">
<h3 className="font-serif text-sm text-ink"> <h3 className="font-serif text-sm text-ink">
{gen.preview.items.length} {gen.preview.items.length}
{canIngest ? "(勾选后可入库)" : null} {canIngest
? singleObject
? "(可入库)"
: "(勾选后可入库)"
: null}
</h3> </h3>
<ul className="flex flex-col gap-2"> <ul className="flex flex-col gap-2">
{gen.preview.items.map((item, i) => ( {gen.preview.items.map((item, i) => (
@@ -149,7 +173,7 @@ export function GeneratorRunner({
key={i} key={i}
item={item} item={item}
index={i} index={i}
selectable={canIngest} selectable={canIngest && !singleObject}
checked={selected.has(i)} checked={selected.has(i)}
onToggle={toggle} onToggle={toggle}
/> />
@@ -160,10 +184,14 @@ export function GeneratorRunner({
<button <button
type="button" type="button"
onClick={() => void runIngest(false)} 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" 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> </button>
) : null} ) : null}

View File

@@ -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>
);
}

View File

@@ -377,6 +377,50 @@ export interface paths {
patch?: never; patch?: never;
trace?: 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 422schema `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": { "/projects/{project_id}/world/generate": {
parameters: { parameters: {
query?: never; query?: never;
@@ -1719,6 +1763,78 @@ export interface components {
*/ */
job_id: string; 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 * TestConnectionRequest
* @description POST /test最小探测请求。 * @description POST /test最小探测请求。
@@ -1861,7 +1977,8 @@ export interface components {
* *
* 仅声明了 `ingest` 的工具可用。按入库表取用对应字段: * 仅声明了 `ingest` 的工具可用。按入库表取用对应字段:
* - world_entities金手指/词条)→ `world_entities`(贴 WorldEntityCardViewtype/name/rules * - world_entities金手指/词条)→ `world_entities`(贴 WorldEntityCardViewtype/name/rules
* - outline细纲→ `chapter_no` + `scenes`(贴 OutlineSceneIngestView * - outline细纲→ `chapter_no` + `scenes`(贴 OutlineSceneIngestView
* - rules拆书→ `teardown`(贴 TeardownIngestViewthemes/archetypes/structure/hooks
* `acknowledge_conflicts`:作者已查看并接受 continuity 预检冲突时置 true 放行(仿 accept gate * `acknowledge_conflicts`:作者已查看并接受 continuity 预检冲突时置 true 放行(仿 accept gate
*/ */
ToolIngestRequest: { ToolIngestRequest: {
@@ -1880,6 +1997,8 @@ export interface components {
* @description outline 入库的场景行(细纲) * @description outline 入库的场景行(细纲)
*/ */
scenes?: components["schemas"]["OutlineSceneIngestView"][]; scenes?: components["schemas"]["OutlineSceneIngestView"][];
/** @description rules 入库的拆书结论F1拍平为可读规则条目 */
teardown?: components["schemas"]["TeardownIngestView"] | null;
/** /**
* Acknowledge Conflicts * Acknowledge Conflicts
* @description 作者已知悉并接受 continuity 冲突 → 放行入库 * @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: { generate_world_projects__project_id__world_generate_post: {
parameters: { parameters: {
query?: never; query?: never;

View File

@@ -13,6 +13,7 @@ import type {
RuleListResponse, RuleListResponse,
SkillListResponse, SkillListResponse,
StyleFingerprintResponse, StyleFingerprintResponse,
TemplateResponse,
ToolboxListResponse, ToolboxListResponse,
WorldEntityListResponse, WorldEntityListResponse,
} from "./types"; } 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含正文供工作台重访重载编辑器 // 已存草稿GET .../draft含正文供工作台重访重载编辑器
// 404尚无草稿新章→ null由调用方当空编辑器处理不抛错。 // 404尚无草稿新章→ null由调用方当空编辑器处理不抛错。
export async function fetchDraft( export async function fetchDraft(

View File

@@ -85,6 +85,11 @@ export type CharacterListResponse =
export type WorldEntityListResponse = export type WorldEntityListResponse =
components["schemas"]["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-flowC3 扩 K1.3)。 // K1 Kimi Code OAuth device-flowC3 扩 K1.3)。
export type OAuthStartResponse = components["schemas"]["OAuthStartResponse"]; export type OAuthStartResponse = components["schemas"]["OAuthStartResponse"];
export type OAuthDisconnectResponse = export type OAuthDisconnectResponse =
@@ -113,3 +118,6 @@ export type ToolIngestRequest = components["schemas"]["ToolIngestRequest"];
export type ToolIngestResponse = components["schemas"]["ToolIngestResponse"]; export type ToolIngestResponse = components["schemas"]["ToolIngestResponse"];
export type OutlineSceneIngestView = export type OutlineSceneIngestView =
components["schemas"]["OutlineSceneIngestView"]; components["schemas"]["OutlineSceneIngestView"];
// F1拆书入库产物themes/archetypes/structure/hooks → 项目 rules 条目)。
export type TeardownIngestView =
components["schemas"]["TeardownIngestView"];

View File

@@ -4,6 +4,7 @@ import { emptyDecisions, setNote, setVerdict } from "@/lib/review/decisions";
import type { JobView } from "@/lib/jobs/job"; import type { JobView } from "@/lib/jobs/job";
import { import {
buildResumeRequest, buildResumeRequest,
CHAIN_KINDS,
chainPhase, chainPhase,
chainResultView, chainResultView,
} from "./chain"; } from "./chain";
@@ -110,3 +111,19 @@ describe("buildResumeRequest", () => {
expect(buildResumeRequest([])).toEqual({ decisions: [] }); 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);
}
});
});

View File

@@ -6,6 +6,29 @@ import type { ChainResumeRequest } from "@/lib/api/types";
import type { JobView, PollStatus } from "@/lib/jobs/job"; import type { JobView, PollStatus } from "@/lib/jobs/job";
import { buildAcceptRequest, type DecisionDraft } from "@/lib/review/decisions"; import { buildAcceptRequest, type DecisionDraft } from "@/lib/review/decisions";
// 内置链类型(对齐后端 SUPPORTED_CHAINSdraft_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/ // 链 job result 的视图模型(与后端 `_chain_result` 字段对齐chain_key/written/completed/
// awaiting_chapter。token/正文绝不入 result不变量 #5 / chain §5故此处只有进度元数据。 // awaiting_chapter。token/正文绝不入 result不变量 #5 / chain §5故此处只有进度元数据。
export interface ChainResultView { export interface ChainResultView {

View File

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

View File

@@ -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();
});
});

View File

@@ -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,
};
}

View File

@@ -1,12 +1,17 @@
import { describe, expect, it } from "vitest"; import { describe, expect, it } from "vitest";
import { buildIngestRequest, ingestTable } from "./ingest"; import {
buildIngestRequest,
ingestTable,
isSingleObjectIngest,
} from "./ingest";
describe("ingestTable", () => { describe("ingestTable", () => {
it("maps ingestable kinds to their target table", () => { it("maps ingestable kinds to their target table", () => {
expect(ingestTable("GoldenFingerResult")).toBe("world_entities"); expect(ingestTable("GoldenFingerResult")).toBe("world_entities");
expect(ingestTable("GlossaryResult")).toBe("world_entities"); expect(ingestTable("GlossaryResult")).toBe("world_entities");
expect(ingestTable("DetailedOutlineResult")).toBe("outline"); expect(ingestTable("DetailedOutlineResult")).toBe("outline");
expect(ingestTable("BookTeardownResult")).toBe("rules");
}); });
it("returns null for non-ingestable kinds", () => { 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", () => { describe("buildIngestRequest", () => {
it("maps golden finger rows into world_entities with merged rules", () => { it("maps golden finger rows into world_entities with merged rules", () => {
const body = buildIngestRequest({ const body = buildIngestRequest({
@@ -81,6 +98,36 @@ describe("buildIngestRequest", () => {
expect(body?.acknowledge_conflicts).toBe(false); 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", () => { it("returns null for non-ingestable output kind", () => {
expect( expect(
buildIngestRequest({ outputKind: "IdeaListResult", rows: [] }), buildIngestRequest({ outputKind: "IdeaListResult", rows: [] }),

View File

@@ -4,6 +4,7 @@
import type { import type {
OutlineSceneIngestView, OutlineSceneIngestView,
TeardownIngestView,
ToolIngestRequest, ToolIngestRequest,
WorldEntityCardView, WorldEntityCardView,
} from "@/lib/api/types"; } 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 { export interface IngestBuildInput {
outputKind: string; outputKind: string;
// 作者勾选要入库的预览行(结构化产物原始记录)。 // 作者勾选要入库的预览行(结构化产物原始记录)。
@@ -72,6 +84,15 @@ export interface IngestBuildInput {
acknowledgeConflicts?: boolean; 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不可入库 // 入库目标表(供 UI 文案 / 判定)。未知 → null不可入库
export function ingestTable(outputKind: string): string | null { export function ingestTable(outputKind: string): string | null {
switch (outputKind) { switch (outputKind) {
@@ -80,6 +101,8 @@ export function ingestTable(outputKind: string): string | null {
return "world_entities"; return "world_entities";
case "DetailedOutlineResult": case "DetailedOutlineResult":
return "outline"; return "outline";
case "BookTeardownResult":
return "rules";
default: default:
return null; return null;
} }
@@ -107,6 +130,12 @@ export function buildIngestRequest(
scenes: input.rows.map((row, i) => rowToScene(row, i)), scenes: input.rows.map((row, i) => rowToScene(row, i)),
acknowledge_conflicts, acknowledge_conflicts,
}; };
case "BookTeardownResult": {
// 单对象产物:取首行(整个拆书结论)作 teardown无产物 → null。
const row = input.rows[0];
if (!row) return null;
return { teardown: rowToTeardown(row), acknowledge_conflicts };
}
default: default:
return null; return null;
} }

View File

@@ -9,6 +9,7 @@ import {
missingRequiredFields, missingRequiredFields,
previewRows, previewRows,
resolveLegacyRoute, resolveLegacyRoute,
templateFillTarget,
} from "./toolbox"; } from "./toolbox";
const field = (over: Partial<ToolInputFieldView> = {}): ToolInputFieldView => ({ const field = (over: Partial<ToolInputFieldView> = {}): ToolInputFieldView => ({
@@ -210,3 +211,20 @@ describe("isLegacyTool", () => {
).toBe(false); ).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();
});
});

View File

@@ -292,6 +292,21 @@ function fallbackItem(row: Record<string, unknown>): PreviewItem {
return { heading, fields, body: null }; 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 工具的 legacy_route 含 {id} 占位(如 /projects/{id}/codex?gen=world→ 替换为真实 projectId。 // legacy 工具的 legacy_route 含 {id} 占位(如 /projects/{id}/codex?gen=world→ 替换为真实 projectId。
export function resolveLegacyRoute( export function resolveLegacyRoute(