- 伏笔账本:纯函数状态机(OPEN/PARTIAL/CLOSED/OVERDUE) + ForeshadowLedger repo;验收后到期扫描(BackgroundTask 自建 session 置 OVERDUE);登记/状态变更端点 - 节奏 + 三审齐:foreshadow-analyst + pace-checker 并入 LangGraph 并行审(REVIEW_SPECS),collect 分列落 chapter_reviews(conflicts/foreshadow_sug/pace),review SSE 加 foreshadow/pace 事件 - 大纲:outliner Agent 产 OutlineResult(含 foreshadow_windows),POST /outline 逐章 upsert outline 表;GET /foreshadow?status= 看板 - 前端:伏笔四泳道看板(OVERDUE 琥珀) + 大纲编辑器(窗口徽标) + 节奏节拍图(▁▃▅) + 审稿页消费 foreshadow/pace SSE - bugfix(T3.8):并行三审共用请求 session 记账触发 'Session is already flushing' → foreshadow/pace 静默丢失;SqlAlchemyLedgerSink.record 改 add-only(靠端点/事务 commit),加并发回归测试 - M3 E2E:真实 DB + mock 网关零 token 走通 埋设→进展→验收后扫描 OVERDUE→看板 + 大纲含窗口 + 三审齐 SSE/留痕;E2E 暴露并钉住上述 bug - 门禁绿:mypy 111 / pytest 228(0 xfailed) / alembic 无漂移;前端 gen:api/lint/tsc/vitest 69/build
64 lines
2.0 KiB
TypeScript
64 lines
2.0 KiB
TypeScript
"use client";
|
||
|
||
import { useCallback, useState } from "react";
|
||
|
||
import { api } from "@/lib/api/client";
|
||
import { useToast } from "@/components/Toast";
|
||
import type { OutlineChapterView } from "@/lib/api/types";
|
||
|
||
export type OutlineStatus = "idle" | "generating" | "ready" | "error";
|
||
|
||
export interface OutlineError {
|
||
code: string;
|
||
message: string;
|
||
}
|
||
|
||
export interface UseOutline {
|
||
chapters: OutlineChapterView[];
|
||
status: OutlineStatus;
|
||
error: OutlineError | null;
|
||
generate: (projectId: string, volume: number) => Promise<void>;
|
||
}
|
||
|
||
// 生成大纲:POST .../outline(body {volume})。无凭据/网关失败 → 503 LLM_UNAVAILABLE
|
||
// (流前 JSON 信封),经 error 检出、引导去设置(同 draft/review 范式)。
|
||
export function useOutline(initial: OutlineChapterView[]): UseOutline {
|
||
const [chapters, setChapters] = useState<OutlineChapterView[]>(initial);
|
||
const [status, setStatus] = useState<OutlineStatus>(
|
||
initial.length > 0 ? "ready" : "idle",
|
||
);
|
||
const [error, setError] = useState<OutlineError | null>(null);
|
||
const toast = useToast();
|
||
|
||
const generate = useCallback<UseOutline["generate"]>(
|
||
async (projectId, volume) => {
|
||
setStatus("generating");
|
||
setError(null);
|
||
const { data, error: apiError } = await api.POST(
|
||
"/projects/{project_id}/outline",
|
||
{
|
||
params: { path: { project_id: projectId } },
|
||
body: { volume },
|
||
},
|
||
);
|
||
if (apiError || !data) {
|
||
const env = apiError as
|
||
| { error?: { code?: string; message?: string } }
|
||
| undefined;
|
||
const code = env?.error?.code ?? "OUTLINE_FAILED";
|
||
const message = env?.error?.message ?? "大纲生成失败,请重试。";
|
||
setError({ code, message });
|
||
setStatus("error");
|
||
toast(message, "error");
|
||
return;
|
||
}
|
||
setChapters(data.chapters ?? []);
|
||
setStatus("ready");
|
||
toast("大纲已生成", "success");
|
||
},
|
||
[toast],
|
||
);
|
||
|
||
return { chapters, status, error, generate };
|
||
}
|