文档转美观图文解读 MDX

解决什么问题

当你面对一本厚重的书或一份长篇报告，想要提取核心观点并生成一份排版精美的“图文解读”时，往往会遇到两个痛点：一是手动整理耗时且难以结构化；二是最终产出难以同时兼顾“本地高颜值预览”与“在线团队协作分享”。该技能通过编排多个底层能力，将原始文档自动转化为深色主题、卡片式的 Markdown 模块（MDX），并实现本地与腾讯文档的双轨交付。

核心能力与工作流

工作流分为四个关键步骤：

• 接入源材料：利用 tencent-docs 的导入链路处理本地 PDF/DOCX，或直接读取腾讯文档链接与 EPUB/TXT。
• 多引擎分析：并行调用 zhaoyan（朝颜问道）生成结构化看板、summarize 提取执行摘要、vibe-reading-cn 拆解章节，合并为统一分析笔记。
• 生成美观 MDX：基于 assets/mdx-template.mdx 模板填充内容，严格保持 Tailwind 暗色主题与 JSX 组件风格。
• 双轨保存：本地输出完整 MDX 文件；同时生成纯 Markdown 版本，通过 tencent-docs 写回腾讯文档，确保在线端正常渲染。

适用边界与注意点

• 可追溯性：所有论断必须可追溯至原文，若材料不足需显式标注 【材料不足，无法确认】。
• 样式一致性：MDX 模板的暗色主题与类名不可随意改动，需保持可视语言统一。
• 扫描件处理：若源文件为 OCR 质量差的扫描版，需提前提示用户文本可能存在残留水印或占位符。
• 敏感内容：不越界判断涉及心理健康等敏感话题，严重风险时需补充专业求助提示。