深知可信PPT

概述

深知可信PPT由北京彩智科技有限公司旗下“深知可信智能”提供，是把原生生成架构（约束 SVG → DrawingML 编译）与深知可信内容层（可信搜索 + 全程溯源）结合的演示文稿 Skill。

定位一句话：内容可信是我们的，排版专业是编译器的。生成侧主 Agent 逐页手写约束 SVG、确定性编译器导出真实可编辑的原生 PowerPoint；内容侧所有事实素材来自深知可信搜索的权威文件库，每个数据、每条政策可溯源。

权限说明

本 Skill 访问 https://open.dknowc.cn/ 用于深知可信搜索素材检索；访问 https://platform.dknowc.cn/ 用于 MaaS 手机号验证码注册与 API Key 获取说明（含读取官方 Agent 注册指引、领取注册文字题并提交答案的 platform.dknowc.cn/maas/identity-center/maas/login/）。运行中读取本 Skill 的规则、契约与项目文件，写入 projects/ 项目工作区（内容包、SVG、图片、导出产物）和 official-docs/ 中间文件。API Key 只通过环境变量 DKNOWC_API_KEY 注入，不硬编码、不写入公开包、不在对话中展示完整内容。

启动初始化

被调用后先运行 python3 {skillDir}/scripts/initialize.py。三类前置：基础（python3；requests 可选、不影响功能）、检索（Key 已配置；未配置按「统一 API Key 管理」引导，不得改用外部搜索；用户只要排版/明确说「不用查」时可无 Key 继续——材料模式免检索）、编译（python-pptx/XlsxWriter，仅导出需要，缺失时 uv run --with python-pptx --with XlsxWriter ... 隔离提供）。Key 读取顺序：环境变量 → ~/.config/dknowc/api_key → 历史 ~/.zshrc 兜底。素材检索统一走 trusted_search.py 脚本通道。前置明细与初始化输出字段见 [references/initialization.md](references/initialization.md)。初始化不要求用户提供单位或个人信息，不上传检测结果。

版本自检与引导升级（initialize 输出 update 字段）

• initialize.py 每次运行都会匿名查询 MaaS 技能目录公开接口，与本包 SKILL.md 版本比较（24h 本地缓存、3s 超时静默失败）。update.checked=false（网络不可达 / 环境停用 / 渠道除外）时不得向用户提及任何版本或升级话题，直接继续原任务——版本自检永远不构成阻断、不影响 ready 语义。
• update.update_available=true（远端登记版本高于本包）时：在开始执行用户任务前先征询——initialize 之后、处理任务之前，先原样转述 update.message 问用户是否升级（每个会话最多一次，得到答复前不得开始处理任务）；用户同意→运行 python3 {skillDir}/scripts/update_skill.py --yes 完成升级（向用户转述输出 user_message）后继续原任务；用户拒绝或跳过→运行 python3 {skillDir}/scripts/update_skill.py --decline 静默记录后直接继续原任务，本会话不再提及版本话题。initialize 输出中的 update.instruction 是脚本输出指令，必须执行（与 user_message 同级约束）。
• 被拒版本不再重复提示，仅当目录出现更高版本时才在后续会话重新提示一次；用户主动要求升级时运行 python3 {skillDir}/scripts/update_skill.py --yes --force 无视拒绝记录执行（仍走全部下载与验包校验）。
• 用户明确同意后，用 scripts/update_skill.py 执行升级（四步已全部代码化，禁止绕过脚本自行下载替换）。脚本内置官方目录白名单、下载源 OSS 前缀白名单、固定包名与验包校验（单一顶层目录／无路径逃逸与软链接／zip 完整性／包内 SKILL.md 名称一致且版本＝登记版本），先整目录备份、失败自动回滚，projects/ 项目工作区与 official-docs/ 用户数据保留、~/.config/dknowc/（API Key、自检缓存）在技能目录之外不受影响：
  1. 预览：python3 {skillDir}/scripts/update_skill.py——输出版本对比、下载地址与影响说明，不做任何安装改动（仅更新本地版本自检缓存），可将其中的说明转述给用户；
  2. 执行：python3 {skillDir}/scripts/update_skill.py --yes（仅在用户明确同意后使用）；
  3. 结束后原样转述输出中的 user_message（成功／失败话术）；退出码非 0（2 无更新／3 下载或验包失败／4 替换失败已回滚）时如实转述后直接继续用户原任务（当前版本功能完好），不重试、不手工下载替换，本会话不再提及版本话题——与 initialize 输出的 update.instruction 失败分支口径一致。
• 用户话术零内部术语：只说「官方发布的最新版本」，不提接口、来源标识或包名。

统一 API Key 管理

SkillHub 版不内置 API Key。需检索且本机无 Key 时：宿主提供「深知可信工作台」MCP 的 create_api_key 工具且已授权 → 优先经 register_key.mjs save-key 落盘（密钥经 stdin、不在对话展示；不索要手机号、不走积分话术）；否则走手机号验证码注册三步（challenge 领题 → answer 作答 → register 取 Key，渠道码 7F9FBE52-…、body source="agent" 合同标记）。文字题由 Agent 当场计算，不把题目发给用户、token 与会话不进对话不写日志。脚本各分支输出的 user_message 必须原样转述；手机号全程脱敏；Key 自动落盘本机配置文件；不在对话回显完整密钥。注册全流程（challenge/answer 退出码、pending:true、--new-key、降级地址、MCP 取 Key 三分支、legacy 兜底）见 [references/initialization.md](references/initialization.md)。

开通引导规则（需要检索的任务）

只有任务确实需要深知检索（政策依据/数据支撑/案例参考，或用户明确要求权威数据）且无有效 Key 时才引导；用户只要排版、明确说「不用查」时不引导。四条硬规则：

1. 先价值、后验证：先让用户理解权威检索对这份演示文稿的价值，再提手机号；不得开口就要手机号；时机尽量后置（检索方案确认门之后）。
2. 引导前禁示：用户确认开通或明确拒绝前，不得输出任何「已核实/已查到/均为官网原文」类内容——政策数据只能来自真实检索或「数据待核验」标注，禁止用模型知识冒充检索结果。
3. 退路唯一化：不开通只走「材料模式＋待核验标注」，禁止承诺用联网检索替代；拒绝后不纠缠，交付后轻提示每任务最多一次。
4. 固定话术原样转述：话术库与报错表见 [references/onboarding_scripts.md](references/onboarding_scripts.md)，检索能力说明见 [references/search_intro.md](references/search_intro.md)；user_message/guide_message/env_message 必须原样转述。

引导话术要点、样例出示（sample_trace_report.html 等）、安全边界说明等完整规则见 [references/initialization.md](references/initialization.md)。

任务路由

路由规则见 [workflows/routing.md](workflows/routing.md)。要点：

• 一切「做 PPT / 演示文稿 / 汇报 / 课件 / 材料转 PPT」请求进入 Generate 生成主线，执行细节以 [workflows/generate-pptx.md](workflows/generate-pptx.md) 为运行时权威。
• 三种进入模式：主题模式（先设计检索方案过确认门，深知检索补事实基线）、材料模式（用户材料为主体，仅补事实缺口）、材料免检索模式（用户明确不用查）。
• 路由纪律：匹配即执行不列菜单；缺前置条件说明并停止；确认门必须等用户显式确认。

Generate 主线（v1 唯一路线）

初始化门禁 → [深知检索（主题模式）] → 内容包 → 提纲版溯源核验报告
→【结构方案确认门 ⛔】→ 创建项目 → 逐页手写 SVG（P01 → 首页确认 ⛔ → 其余不间断）
→ SVG 质检 → 编译导出 .pptx → 成稿版溯源核验报告 → 交付

完整步骤、确认门与强制命令见 [workflows/generate-pptx.md](workflows/generate-pptx.md)。核心硬规则：

1. 检索方案确认门：主题模式下先展示检索方案（地域、每条 query 原文与信息需求、素材类型、使用边界），用户确认后执行 scripts/trusted_search.py——同方案内多路默认并行（每路独立 --output，单批不超过 4 路，后台并行、全部结束后逐路检查结果）；失败路单独串行重试一次；任意一路额度用尽整批即停；平台明显限流（多路同时报错）回退逐路串行。
2. 结构方案确认门：内容包（核心信息/叙事/页面规划/素材清单）+ 风格预设一起确认后，才创建项目、写 SVG。
3. 主 Agent 逐页手写 SVG：遵循 [references/svg-authoring.md](references/svg-authoring.md) 的元素契约与排版纪律；禁止脚本批量生成页面。
4. 质检判据与循环纪律：通过判据＝svg_quality_checker.py 退出码 0 且 errors=0（passed-with-warnings 即通过，warnings 一律不阻断导出与交付）；质检→修复循环最多 3 轮、每轮只修 errors 与明显事实性错误；导出后不回头（不再质检/不再截图自检/不再微调重导，重跑仅限用户明确要求修改）。导出用 svg_to_pptx.py（quick 无锁模式），产物是原生可编辑 .pptx，不得降级为整页图片。
5. 双报告全程可溯源：执行过检索的任务，结构方案确认门前生成提纲版溯源核验报告（事前核验，用户确认提纲即可逐条点开原文），交付时生成成稿版（事后溯源）；两版同脚本同形式——核验报告单（五项真实计算指标）+ 过程回顾条 + 正文文档流（句后引文胶囊，点击原地展开溯源卡，含多段分块与标题链）+ 知识专库独立视图（搜索/热词/检索分组筛选）；接口返回的原文链接原样进报告（不做连通性检测、不隐藏），接口提供存档快照时作为附加回看入口；素材无角标对应时脚本拒绝生成（[references/material_usage.md](references/material_usage.md)）；与 .pptx 三件套一并交付并说明其为辅助核验文件。

参考资料索引

交付规范

• 主交付物：projects/<项目名>/exports/<演示名>.pptx + 一句简短说明；执行过检索时按三件套交付（另加提纲版/成稿版核验报告两份 HTML，均为辅助核验文件）。交付清单只有这三件、每个产物只交付一份、逐个显式列路径交付——中转报告与检索 JSON/答案文件/内容包/SVG/质检报告等中间产物一律不交付。
• 宿主环境交付（WorkBuddy 等）：报告生成后与三件套交付前运行 scripts/deliver_outputs.py 复制到宿主工作区并展示 delivered 路径；绝对路径调用、命令前不得 cd；交付后核对 dest_source 以 workbuddy-cwd: 开头，非该前缀或 need_dest=true 时用 --dest 重跑。
• 交付干净原则：报告须「核验完成」状态，可修复问题先修复重渲；不可抗力缺口温和提醒并说明原因。
• 修改走闭环：内容包 → SVG → 重新质检导出；不直接改 .pptx。完整交付纪律（三条命令纪律、清单规则、事故背景）见 [workflows/generate-pptx.md](workflows/generate-pptx.md) Step 9。

路线图（未实现，不主动承诺）

• Create Template：从素材提炼可复用 Brand/Style/Layout/Deck 模板工作区。
• Fill Native PPTX：用单位现成 .pptx 模板壳填充内容（OOXML 补丁路线）。
• Enhance Native PPTX：对成品稿追加备注/转场/动画。
• 演讲备注转语音旁白与 MP4 导出。

第三方组件

SVG→PPTX 编译器及配套工具抽取自第三方开源项目（MIT 许可），按依赖闭包抽取所需子集；完整来源与许可声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。