用自然语言驱动 Synthetix 的完整知识写作管线

异步任务

文档处理、大纲生成、整篇写作等长任务会返回 taskId，用 get_task_status 轮询（建议 10–30 秒）直到 completed。

• get_task_status轮询异步任务状态，返回实时进度与最终结果。
• cancel_task取消进行中的任务（终态任务不可取消）。
• list_tasks列出任务，可按类型与状态筛选。

文档与知识库

摄入、列出、查询文档，以及带来源追溯的语义检索。

• ingest_document上传本地文件并可选触发处理（分块+向量化+可选图谱），返回 documentId 与 taskId。
• list_documents列出知识库文档，可按状态筛选、分页。
• get_document获取单个文档的详情与处理状态。
• search_knowledge语义知识库检索（向量 + LightRAG），返回带来源的结果。

知识图谱与 Wiki

实体关系图谱，以及 LLM 综合的 Wiki 条目（文档摘要/主题/概念/论断）。

• get_knowledge_graph获取知识图谱（实体关系），可聚焦单个实体或总览。
• list_wiki_entries列出 Wiki 条目，可按类型与全文搜索筛选。
• get_wiki_entry获取单个 Wiki 条目的完整内容。
• synthesize_wiki对已就绪文档触发 Wiki 综合（异步任务）。

头脑风暴与大纲

引导式多轮对话澄清需求，最终生成并维护结构化大纲。

• create_brainstorm_session创建头脑风暴会话——澄清需求、产出大纲的起点。
• brainstorm_message在会话中发送消息并获取 AI 引导回复（含篇幅门槛：未确认篇幅不继续）。
• generate_outline从会话触发大纲生成（异步），完成后存入会话。
• get_outline读取会话中的当前大纲。
• update_outline持久化用户对大纲的编辑。

写作

章节与文档级的生成、双模型 A/B 对比、确认锁定、编辑与预览组装。

• create_draft创建写作草稿（章节与大纲 1:1）；可传 sessionId 自动读大纲，或直接传 outline。
• list_drafts列出草稿及其进度（已确认章节数、字数等）。
• get_draft获取草稿详情，含全部章节的状态、内容与引用。
• generate_section生成单个章节（SSE 流式），生成后进入 reviewing 状态，导出前需 confirm。
• generate_all_sections整篇一次性生成（异步），内部自动确认锁定，生成后可直接导出。
• compare_section用两个不同模型并行生成同一章节（A/B），产出两个候选供你选。
• confirm_section确认（锁定）章节：单章生成后直接锁；对比后需传 selectedSource: a|b。
• edit_section手动编辑章节正文（直接替换内容）。
• assemble_preview把已确认章节组装成完整 Markdown 预览。

导出

把已确认的草稿导出为目标格式。

• export_draft导出草稿为 Markdown / PDF / DOCX；仅 locked/summarized 章节会被导出。

模型管理与用量

Provider 的增删改、默认模型设置、连通性测试与 token 用量查询。

• list_providers列出已配置的模型 Provider 及其模型（API Key 永不回显，仅返回 hasApiKey 布尔）。
• create_provider创建模型 Provider（OpenAI 兼容 / Anthropic / Ollama），Key 加密存储，embedding 维度自动探测。
• update_provider更新 Provider（传 models 会删后重建该 Provider 的全部模型配置）。
• delete_provider删除 Provider（级联删除其模型配置）。
• set_default_model设置某模型为默认（llm / embedding / rerank / image 槽位）。
• test_connection测试 Provider 连通性，并自动探测上下文窗口与 embedding 维度。
• get_token_usage查询 token 用量（按模型/模块聚合 + 近期明细），可按模块与时间窗口筛选。