流水线第一步。读取 pdf 或 pptx，返回每一页的标题、正文和有没有图。不写讲解，也不写 Notion。

只返回结构骨架和课件摘录，供 Agent 自己写讲解。这不是成品，不会调用模型，也不写入 Notion。Agent 写好 draft 后交给 run_lecture_pipeline。讲解正文由调用方 Agent 撰写，本工具不调用模型。MCP 负责抽课件、给结构骨架、内容审、写入 Notion 和美化。跳步 = Fail。无推导的复杂公式 = Fail。讲解过浅 = Fail。内容未过关就美化 = Fail。口头说可以美化不算过关，只有 gate.pass 为 true 才 bloom。

读课件并给出结构骨架。讲解正文由 Agent 通过 draft（JSON 字符串）提供；不传 draft 则只返回骨架，不写入。传入 draft 后跑内容审。不过关默认不写入、不美化。review 为 true 时把待审稿写入 parentPageId，仍然不美化。apply 为 true 时只在内容审通过之后美化，公式被改坏会回滚。本工具不调用模型。

列出可用的排版主题、各自适合的内容类型、调色板和 callout 语义。改页面前先看这个，选一个主题再审计。

返回完整的排版规范：哪些改动值得做、哪些 API 做不到、每条规则为什么存在。在没有接上 Notion 时也可以单独遵守这份规范。

按标题关键词搜索当前 integration 能访问的页面，返回 page id 和链接。

读取页面并按主题打分。返回五个维度的分数、问题清单，以及每条问题对应的修复建议。只读，不修改页面。讲解正文由调用方 Agent 撰写，本工具不调用模型。MCP 负责抽课件、给结构骨架、内容审、写入 Notion 和美化。跳步 = Fail。无推导的复杂公式 = Fail。讲解过浅 = Fail。内容未过关就美化 = Fail。口头说可以美化不算过关，只有 gate.pass 为 true 才 bloom。

生成美化计划，返回执行前后的对比图和预计分数变化。不写回 Notion。看图之后再决定要不要 apply。对比图是版式和配色的近似渲染，不是像素级的 Notion 截图。讲解正文由调用方 Agent 撰写，本工具不调用模型。MCP 负责抽课件、给结构骨架、内容审、写入 Notion 和美化。跳步 = Fail。无推导的复杂公式 = Fail。讲解过浅 = Fail。内容未过关就美化 = Fail。口头说可以美化不算过关，只有 gate.pass 为 true 才 bloom。

对内置的样例页面出计划和对比图，不需要 Notion token。sampleId 取 payment-spec、reading-notes、weekly-report 三者之一，不传则返回样例清单。

重新读取页面、生成计划并执行。默认 dryRun 为 true，只会报告将要做什么。真正写入前必须已有 handoff_status 的 content_pass（或正在 beautifying）。写入成功后状态变为 beautifying。返回快照，供 rollback 和 diff_after_beautify 使用。讲解正文由调用方 Agent 撰写，本工具不调用模型。MCP 负责抽课件、给结构骨架、内容审、写入 Notion 和美化。跳步 = Fail。无推导的复杂公式 = Fail。讲解过浅 = Fail。内容未过关就美化 = Fail。口头说可以美化不算过关，只有 gate.pass 为 true 才 bloom。

读取页面，检查行内公式、公式块和数据库公式属性。列出每一处无效或破损公式的位置和原因。只读。KaTeX 负责展示公式，数据库公式只做括号配对，并把接口返回的 unsupported 当作损坏。

规则检查：重点和考点有没有用小图标或提示框标出、步骤编号有没有跳步、有没有用「显然 / 略」跳过推导。不强制双语。只报告，不改页面。不判断内容对错。

只读检查版式是否站得住：少用表格、禁止长篇「使用说明 / 写作要求」提示框、文档要有标题层级、要有封面和图标、正文不要挤成一整块。不改页面。

记录 content_pass（内容审通过）、beautifying（美化中）、rereview_pass（复审通过）。只存状态，不指派作者，也不通知任何人。没有 content_pass 时，apply_plan 的真正写入会被拒绝。action=get 只查询。

把 apply_plan 返回的快照和页面现在的内容对照。抓两类问题：读者能读到的事实被改写或删掉，以及公式丢失、改坏或新变成无法解析。拆段、重复已有词语的新标题不算事实改动。只读。

用 apply_plan 返回的快照重建页面。这会删除页面当前的顶层块再按快照写回，块 id 全部改变，评论不会回来。必须传 confirm: true。

读取页面并返回当前样子的渲染图，不做任何修改。用来在修改后复查，或者在审计前先看一眼。