Doc to Beautiful MDX · 文档转美观图文解读 MDX
角色与目标
把任意一本「书」或一份「文档」转化为一份深色主题、卡片式、图文解读风格的 MDX 报告，并把成果同时：
1. 落到本地 .mdx 文件（完整美观版，含 Tailwind 样式与 JSX 组件）；
2. 写回腾讯文档（在线可分享版，使用纯 Markdown 渲染，兼容腾讯文档排版）。
编排的四种能力：
- tencent-docs：读取本地 PDF/DOCX（pre_import → COS 上传 → async_import → get_content），以及把成品写回腾讯文档（创建在线文档并写入正文）。
- summarize：对长文做智能摘要、提取核心要点与关键词。
- 朝颜问道 (zhaoyan)：顶级读书分析专家，产出结构化深度看板（核心问题 / 结论 / 道法术器 / 批判 / 行动）。
- vibe-reading-cn：AI 驱动的逐章智能阅读分析，适合 EPUB/TXT 书籍。
> 依赖就绪检查：开始前确认上述四个 skill 均已安装。若 zhaoyan 未安装，先按 references/workflow.md 的“安装朝颜问道”小节从 SkillHub 安装（slug=zhaoyan，纯提示词 skill，可安全安装）。tencent-docs 连接器需处于已连接状态。
何时使用
- 用户提供一本书 / 一篇长文 / 一份报告，希望得到“图文解读版”“书籍分析”“美观 MDX”。
- 用户明确说“保存到腾讯文档”“发到腾讯文档”。
- 触发词：图文解读、书籍分析、MDX、拆书、读书看板、文档提炼、保存到腾讯文档。
标准工作流
第一步 · 接入源材料（Ingest）
按输入类型选择入口：
- 本地 PDF / DOCX 文件 → 用
tencent-docs的导入链路读取：
1.manage.pre_import获取upload_url/file_key/task_id；
2. 用scripts/tdocs_upload.py <本地文件路径>把文件 PUT 到 COS（已封装，规避中文路径问题），脚本会返回task_id/file_key；
3.manage.async_import触发异步导入，manage.import_progress轮询至progress=100；
4.get_content读取正文（大文件首次可能超时，重试一次即可）。 - 腾讯文档链接 → 直接用
tencent-docs打开并get_content。 - 纯文本 / 已粘贴内容 → 跳过读取，直接进入分析。
- EPUB / TXT 书籍 → 用
vibe-reading-cn的导入读取，得到逐章内容。
记录：书名、作者、来源类型、正文规模（字符数 / 页数）。
第二步 · 多引擎分析（Analyze）
并行调用三个分析能力，再合并为统一分析笔记（建议输出为一份临时 JSON / Markdown 大纲）：
- 朝颜问道 (zhaoyan) —— 加载该 skill，用「完整看板模式」或「精髓总结模式」分析，重点获取：
- 一句话总览、核心问题、3–7 条关键结论；
- 全书逻辑地图、道法术器四层、20% 高价值内容；
- 适用边界与批判评价、行动计划。 - summarize —— 对正文做要点抽取，得到执行摘要 + 核心观点 + 关键词，作为快速校验层。
- vibe-reading-cn（仅书籍 / 有章节结构时）—— 逐章拆解，得到章节结构地图与每章结论。
> 合并原则：以 朝颜问道 的结构化看板为骨架，用 summarize 校验要点、用 vibe-reading 补全章节粒度；所有论断必须可追溯至原文，不得编造。
第三步 · 生成美观 MDX（Generate）
- 复制
assets/mdx-template.mdx为工作副本（建议命名<书名>_图文解读版.mdx）。 - 按模板中的
{{占位符}}与注释，把第二步的分析笔记填入对应区块：
- Hero 封面（书名 / 副标题 / 作者 / 原文链接）
- 💡 一句话定位高亮卡
- 书籍档案卡片网格
- 核心主题三问 / 关键论断列表
- 文档结构与逻辑链（识别→理解→疗愈 式三段）
- 主体要点卡片网格（如四类父母、两类应对、核心方法等）
- 潜在问题与改进建议
- 结论 - 严格保持模板的 Tailwind 类名与暗色主题；新增区块沿用同样的
rounded-xl border bg-*卡片风格与 emoji 图标。 - 中文内容直接使用，不要转义；JSX 中字符串用双引号，属性用双引号。
第四步 · 保存（Save）
分两份产出：
- 本地美观 MDX：把填好的
.mdx写入用户工作目录（即当前会话工作区）。这是完整美观版（含 JSX/Tailwind，用支持 MDX 的站点/预览器查看）。 - 腾讯文档在线版：
- 复制assets/markdown-template.md，把同样的内容填入（去掉 JSX 包裹，仅保留标准 Markdown：标题、表格、引用、加粗、emoji 标题），确保腾讯文档能正常渲染；
- 用tencent-docs创建一篇在线文档（doc 类型），将这份 Markdown 正文写入；
- 返回在线文档链接给用户。
> 说明：腾讯文档不渲染 MDX/JSX，故在线版采用纯 Markdown 等价结构（同样含标题、卡片式表格、引用、emoji），美观度略低于本地 MDX，但结构一致、可读性好。
第五步 · 交付
向用户返回：
- 本地 .mdx 文件路径；
- 腾讯文档在线链接；
- 一句话说明本次分析覆盖的维度与关键洞见。
资源文件指引
assets/mdx-template.mdx—— 美观图文解读 MDX 模板（深色 Tailwind 主题，含占位符与分段注释）。生成本地美观版时以此为骨架。assets/markdown-template.md—— 腾讯文档友好版模板（纯 Markdown，结构等价于 MDX 模板）。写回腾讯文档时使用。scripts/tdocs_upload.py—— 本地文件 → 腾讯文档 COS 上传助手。调用tencent-docs的manage.pre_import获取上传凭证后，用 Pythonurllib把文件 PUT 到 COS（规避 Git-Bash/curl 的中文路径问题），再触发async_import并返回task_id/file_key。references/workflow.md—— 详细编排步骤、tencent-docs MCP 命令参考、以及「安装朝颜问道」与「安装 vibe-reading-cn」的具体命令。
质量与边界
- 所有结论必须可追溯至原文；材料不足时显式标注【材料不足，无法确认】。
- MDX 模板的暗色主题与类名不要随意改动配色，保持与示例一致的可视语言。
- 若源文件为扫描版 / OCR 质量差，先提示用户提取文本可能有残留（如占位符、推广水印）。
- 不对中国式家庭、心理健康等敏感内容做越界判断；涉及严重心理风险时，建议在成品中补充“寻求专业帮助”的提示。
