深知可信PPT

解决什么问题

做汇报 PPT 最大的坑通常不在排版，而在内容。凭记忆写的政策名称、凭印象填的业务数据，一旦在评审或公开场合被追问，整份文稿的专业性就会崩塌。另一方面，很多自动化工具生成的是整页图片，拿到手后根本无法微调。

深知可信PPT 针对这两点做了专门设计，内容侧保可信，排版侧保原生。

核心技术方案

Skill 采用双轨架构：

• 内容可信层：接入深知可信搜索，直接检索权威文件库原文（覆盖 600 万篇公开规范性文件、7000 万篇可溯源权威资料，每日更新）。文稿中出现的每一条政策、每一个数字都能溯源到原始出处，交付时附带核验报告。
• 原生生成架构：主 Agent 逐页手写约束 SVG（遵循严格的元素契约与排版纪律，禁止脚本批量生成），确定性编译器再将其转换为 DrawingML，导出产物是原生可编辑的 .pptx——文本框、形状、层级全部真实存在，可以继续编辑。

工作流程与关键规则

1. 任务路由：识别用户意图后分到三种模式——主题模式（先出检索方案过确认门）、材料模式（用户材料为主体，只补事实缺口）、材料免检索模式。
2. 两道确认门：检索方案（地域、query 目的、素材类型、使用边界）必须用户显式确认后才串行执行检索；内容包 + 风格预设确认后才创建项目、开始写 SVG。
3. 质检不过不导出：svg_quality_checker.py 报错必须修复，之后调用 svg_to_pptx.py 导出。
4. 双报告溯源：执行过检索的任务，会在结构确认前交付提纲版核验报告（事前），最终交付时附上成稿版（事后）。

适用边界与注意点

• 权限与 Key：检索需要访问 https://open.dknowc.cn/；素材检索类任务需要配置 API Key（通过手机号验证码两步获取，只注入 DKNOWC_API_KEY 环境变量，不硬编码、不在对话中展示）。用户明确说“不用查，就用我给的材料”时可免 Key 走材料模式。
• 交付物：主交付物是 projects/<id>/exports/ 下的 .pptx；执行过检索时附带两份 HTML 核验报告。不发送 SVG 源文件、内容包草稿等中间产物。
• 修改闭环：任何改动都要走“内容包 → SVG → 重新质检导出”的路径，不要直接改 .pptx。
• 当前版本不做：音频旁白、视频导出；模板壳填充（OOXML 补丁）在路线图中但未实现。
• 第三方组件：SVG→PPTX 编译器抽取自 MIT 许可的开源项目，详见 THIRD_PARTY_NOTICES.md。