[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KTG196AF2TCKQV24WVNSTT":3,"skill-same:01M6KTG196AF2TCKQV24WVNSTT":118},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":56,"commitSha":57,"skillDirectory":58,"forksCount":13,"repositoryHtmlUrl":59,"repositoryHomepageUrl":6,"ownerHtmlUrl":60,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":61,"install":62,"resources":75},"01M6KTG196AF2TCKQV24WVNSTT","document-illustrator",null,"基于文档内容自动生成配图。AI 智能分析文档结构，归纳核心要点， 为每个主题生成符合特定风格的配图。支持封面图生成和自定义图片比例。 使用场景：当用户需要为文档、文章、笔记生成配图时。 关键词：配图、插图、illustration、generate images、document images","endman100\u002Fskill-router-nexus","endman100","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F31997019?v=4","01M6KPDX17BYDWW4RRB0TNGGMX","01M6KPDX64Y2QBEWVFG5W5PWPF",0,"MIT","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"document","document illustrator","image","python","generate","Bash","文档","生成","关键词","read","write","images","illustration","sonnet","笔记","文章","2026-11-10 10:12:30",false,"---\nname: document-illustrator\ndescription: >\n  基于文档内容自动生成配图。AI 智能分析文档结构，归纳核心要点，\n  为每个主题生成符合特定风格的配图。支持封面图生成和自定义图片比例。\n  使用场景：当用户需要为文档、文章、笔记生成配图时。\n  关键词：配图、插图、illustration、generate images、document images\nallowed-tools:\n  - Read\n  - Write\n  - Bash(python:*)\n  - Glob\n  - AskUserQuestion\nmodel: claude-sonnet-4-5-20250514\n---\n\n# Document Illustrator Skill\n\n基于 AI 智能分析的文档配图生成工具。无需依赖特定格式，自动理解内容并生成专业配图。\n\n## ? 核心特点\n\n- ✨ **AI 智能归纳**：自动理解文档内容，智能提取核心主题\n- ? **格式无关**：支持任何格式的文档（Markdown、纯文本、PDF 等）\n- ? **灵活比例**：支持 16:9（横屏）和 3:4（竖屏）\n- ?️ **封面图可选**：可生成概括全文的封面图\n- ? **三种风格**：渐变玻璃卡片、票据风格、矢量插画\n\n## ? 使用方法\n\n### 直接告诉 Claude\n\n```\n帮我为这个文档生成配图：\u002Fpath\u002Fto\u002Fdocument.md\n```\n\n或者：\n\n```\n我想为这篇文章生成一些配图\n```\n\n## ? 完整工作流程\n\n### 第 1 步：Claude 读取和理解文档\n\n当你请求生成配图时，Claude 会：\n1. 使用 Read 工具读取完整文档\n2. AI 分析理解文档内容和结构\n3. 识别核心主题和要点\n\n**无需担心文档格式**：\n- ✅ 标准 Markdown（##、###）\n- ✅ 分隔线格式（======、------）\n- ✅ 纯文本段落\n- ✅ 任何其他格式\n\n### 第 2 步：配置选项（3 个问题）\n\nClaude 会询问你的偏好：\n\n#### 问题 1：图片比例\n```\n请选择图片比例：\n1. 16:9 (横屏) - 适合演示文稿、幻灯片、横屏展示\n2. 3:4 (竖屏) - 适合社交媒体、手机查看、海报\n\n请选择 (1\u002F2):\n```\n\n#### 问题 2：封面图\n```\n是否生成封面图？\n封面图将概括文档的所有核心信息，作为系列配图的引导。\n\n1. 是 - 生成封面图 + 内容配图\n2. 否 - 仅生成内容配图\n\n请选择 (1\u002F2):\n```\n\n#### 问题 3：内容配图数量\n```\n期望生成多少张内容配图？\n建议范围：3-10 张\n根据文档内容，推荐生成 6 张\n\n请输入数字：\n```\n\n### 第 3 步：Claude 归纳内容并展示\n\n根据你指定的数量，Claude 会智能归纳文档，然后展示给你确认：\n\n```\n? 内容归纳完成\n\n? 封面图内容：（如果选择生成）\n\"AI 编程工具概念演化：从 Rules 到 Skills\"\n- 核心概念：静态上下文 vs 动态上下文\n- 演化路径：Rules → Commands → MCP → Modes → Skills\n- 最佳实践：简化为两个核心工具\n\n? 内容配图（共 6 张）：\n\n1. Rules 的诞生与演化\n   包含：早期模型幻觉问题、rules 文件的作用、静态上下文概念\n\n2. Commands 和工作流打包\n   包含：固定工作流的出现、slash command、团队分享\n\n3. MCP Servers 带来动态能力\n   包含：第三方工具集成、OAuth 认证、上下文膨胀问题\n\n4. Modes 和 Subagents 的登场\n   包含：人设提示词、系统提示词修改、可靠性设计、Hooks 确定性\n\n5. Skills 统一动态上下文\n   包含：Skills 概念、动态加载、编程工具优化\n\n6. 最佳实践与未来展望\n   包含：Rules 使用建议、Skills 探索、核心理念总结\n\n✓ 所有内容已覆盖，无遗漏\n\n确认开始生成配图吗？(Y\u002FN)\n```\n\n**关键保证**：\n- ✅ 内容完整：所有重要信息都会被归入某张图片\n- ✅ 逻辑清晰：按照内容的自然逻辑分段\n- ✅ 用户可控：展示归纳结果，等待用户确认\n\n### 第 4 步：生成配图\n\n确认后，Claude 调用 Python 脚本生成图片：\n\n```\n?️  开始生成配图...\n\n正在生成封面图...\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fcover.png\n\n正在生成第 1\u002F6 张...\n  标题: Rules 的诞生与演化\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fillustration-01.png\n\n正在生成第 2\u002F6 张...\n  标题: Commands 和工作流打包\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fillustration-02.png\n\n...\n\n✨ 完成！共生成 7 张配图（1 张封面 + 6 张内容）\n```\n\n### 第 5 步：输出结果\n\n**输出位置**：文档所在目录下的 `images\u002F` 文件夹\n\n```\n\u002Fpath\u002Fto\u002Fyour\u002Fdocument\u002F\n└── images\u002F\n    ├── cover.png              # 封面图（如果选择生成）\n    ├── illustration-01.png    # 第 1 张内容配图\n    ├── illustration-02.png    # 第 2 张内容配图\n    ├── illustration-03.png\n    ├── illustration-04.png\n    ├── illustration-05.png\n    └── illustration-06.png\n```\n\n## ? 三种风格说明\n\n### 1. 渐变玻璃卡片风格 (gradient-glass)\n\n**特点**：\n- Apple Keynote 风格的极简主义\n- 玻璃拟态（Glassmorphism）设计\n- 深邃虚空黑或纯净陶瓷白基底\n- 流动的极光渐变色\n- 3D 玻璃物体和发光效果\n\n**适用场景**：\n- 科技产品介绍\n- 数据分析报告\n- 未来趋势展望\n- 产品功能演示\n\n### 2. 票据风格 (ticket)\n\n**特点**：\n- 数字极简票券设计\n- 高度对比的黑白配色\n- 类似登机牌、门票的结构\n- 精确的几何分区\n- 中英混排，多向文字布局\n\n**适用场景**：\n- 信息图表\n- 统计数据展示\n- 时间线和流程图\n- 要点总结\n\n### 3. 矢量插画风格 (vector-illustration)\n\n**特点**：\n- 扁平化矢量插画\n- 统一粗细的黑色轮廓线\n- 复古柔和的配色\n- 几何化处理\n- 横向全景式构图\n\n**适用场景**：\n- 故事叙述\n- 概念解释\n- 教育内容\n- 品牌宣传\n\n## ? 使用示例\n\n### 示例 1：完整流程\n\n```\n用户: 帮我为 ~\u002Fblog\u002Fai-tools.md 生成配图，用票据风格\n\nClaude: 好的，让我先读取这个文档...\n        [读取文档，分析内容]\n\n        检测到文档长度约 3000 字，内容涉及 AI 工具演化。\n\n        请选择图片比例：\n        1. 16:9 (横屏)\n        2. 3:4 (竖屏)\n\n用户: 1\n\nClaude: 是否生成封面图？\n        1. 是\n        2. 否\n\n用户: 是\n\nClaude: 期望生成多少张内容配图？\n        建议范围：3-10 张\n        根据文档内容，推荐生成 5 张\n\n用户: 5\n\nClaude: [展示归纳的 5 个主题]\n        确认开始生成配图吗？\n\n用户: Y\n\nClaude: [调用 Python 脚本生成 6 张图片]\n        ✨ 完成！配图已保存到 ~\u002Fblog\u002Fimages\u002F\n```\n\n### 示例 2：纯文本文档\n\n```\n用户: 为这个纯文本笔记生成配图\n\nClaude: [读取笔记，即使没有任何标题也能理解内容]\n        [智能识别 3 个核心主题]\n        [询问配置、展示归纳、生成配图]\n```\n\n### 示例 3：自定义数量\n\n```\n用户: 我想要 8 张图，竖屏的，不要封面\n\nClaude: 好的，16:9 竖屏，不生成封面，8 张内容配图。\n        [将文档归纳为 8 个主题]\n        [展示归纳结果，用户确认后生成]\n```\n\n## ? 技术细节\n\n### 图片规格\n\n| 比例 | 分辨率 | 适用场景 |\n|------|--------|----------|\n| 16:9 | 2560x1440 (2K) | 演示文稿、横屏展示 |\n| 3:4 | 1920x2560 | 社交媒体、竖屏查看 |\n\n可选 4K 分辨率：\n- 16:9 → 3840x2160\n- 3:4 → 2880x3840\n\n### API 调用\n\n- **模型**：Gemini 2.0 Flash Image Preview (Nano Banana Pro)\n- **成本**：每张图片 = 1 次 API 调用\n- **速度**：平均 10-20 秒\u002F张\n\n### 环境要求\n\n**必需**：\n```bash\npip install google-genai pillow python-dotenv\n```\n\n**API 密钥**：\n- 在 `~\u002F.claude\u002Fskills\u002Fdocument-illustrator\u002F.env` 中配置\n- 或设置环境变量 `GEMINI_API_KEY`\n\n## ? 内容归纳原则\n\nClaude 归纳内容时遵循以下原则：\n\n### 1. 完整性优先\n\n- ✅ 所有重要信息都会被包含\n- ✅ 不会遗漏关键概念\n- ✅ 保留原文的核心观点\n\n### 2. 逻辑清晰\n\n- 按照内容的自然逻辑分段\n- 相关内容归为一组\n- 保持叙事的连贯性\n\n### 3. 平衡分配\n\n- 每张图片包含相似的信息量\n- 避免某张过于拥挤或空洞\n- 根据内容重要性调整\n\n### 4. 用户可控\n\n- 展示归纳结果给用户确认\n- 用户可以要求调整\n- 确认后才开始生成\n\n## ? 故障排除\n\n### 问题 1：API 密钥错误\n\n**错误信息**：\n```\nError: Invalid API key\n```\n\n**解决方案**：\n1. 检查 `.env` 文件中的 `GEMINI_API_KEY`\n2. 确保 API 密钥有效且未过期\n3. 获取新密钥：https:\u002F\u002Fmakersuite.google.com\u002Fapp\u002Fapikey\n\n### 问题 2：内容归纳不理想\n\n**问题**：归纳的主题不符合预期\n\n**解决方案**：\n1. 在归纳展示阶段，告诉 Claude 你的期望\n2. Claude 会重新归纳并调整\n3. 确认满意后再开始生成\n\n### 问题 3：图片生成失败\n\n**可能原因**：\n- 网络连接问题\n- API 配额用尽\n- 内容过长超过限制\n\n**解决方案**：\n1. 检查网络连接\n2. 检查 API 配额\n3. 尝试增加图片数量（分散内容）\n\n## ? 成本估算\n\n| 图片数量 | API 调用次数 | 预估成本 |\n|---------|-------------|---------|\n| 无封面 + 3 张 | 3 次 | 低 |\n| 有封面 + 5 张 | 6 次 | 中 |\n| 有封面 + 10 张 | 11 次 | 较高 |\n\n**建议**：\n- 短文档（\u003C1000字）：3-5 张\n- 中等文档（1000-3000字）：5-7 张\n- 长文档（>3000字）：8-10 张\n\n## ? 最佳实践\n\n### 1. 合理选择图片数量\n\n**太少**：\n- 每张图片信息量过大\n- 不容易理解和记忆\n\n**太多**：\n- 内容分散\n- 增加成本和生成时间\n\n**推荐**：\n- 根据文档长度选择\n- 每张图片涵盖 1-2 个核心观点\n\n### 2. 根据用途选择比例\n\n**16:9 适合**：\n- PPT 演示\n- 网站横幅\n- 视频封面\n- 博客配图（桌面端）\n\n**3:4 适合**：\n- 社交媒体（Instagram、小红书）\n- 移动端文章\n- 海报设计\n- 竖屏视频\n\n### 3. 封面图的使用\n\n**建议生成封面图的场景**：\n- 系列文章（作为统一引导）\n- 社交分享（作为预览图）\n- 文档首页（概括全文）\n\n**可以不生成的场景**：\n- 仅内部使用\n- 图片数量已足够\n- 希望降低成本\n\n### 4. 风格选择建议\n\n**技术文档** → 渐变玻璃卡片风格\n**数据报告** → 票据风格\n**教程故事** → 矢量插画风格\n**产品介绍** → 渐变玻璃卡片风格\n\n## ? 工作原理\n\n### 传统方式（已废弃）\n\n```\n[代码] 读取文档 → 识别 ## ### 标题 → 机械切分\n       ↓\n    依赖特定格式\n    容易遗漏内容\n    不够智能\n```\n\n### 新方式（当前实现）\n\n```\n[Claude] 读取文档 → AI 理解内容 → 智能归纳主题\n         ↓\n      格式无关\n      内容完整\n      用户可控\n```\n\n**核心区别**：\n- ❌ 旧方式：依赖代码解析，只能处理标准格式\n- ✅ 新方式：AI 理解内容，任何格式都能处理\n\n## ? 与其他工具的对比\n\n| 功能 | Document Illustrator | 传统 PPT 工具 | AI 图片生成器 |\n|------|---------------------|--------------|--------------|\n| 理解文档内容 | ✅ AI 智能理解 | ❌ 需要手动 | ❌ 需要手动输入 |\n| 格式依赖 | ✅ 格式无关 | ❌ 依赖特定格式 | ✅ 无依赖 |\n| 内容完整性 | ✅ 自动验证 | ⚠️ 手动确保 | ❌ 无法保证 |\n| 批量生成 | ✅ 一次生成多张 | ❌ 逐张制作 | ⚠️ 需要多次输入 |\n| 风格一致性 | ✅ 自动保持 | ⚠️ 手动调整 | ⚠️ 需要重复提示词 |\n\n## ? 获取帮助\n\n如有问题或建议：\n1. 直接在 Claude Code 中询问 Claude\n2. 查看计划文件：`~\u002F.claude\u002Fplans\u002Fshimmering-tickling-seahorse.md`\n3. 检查 Skill 目录：`~\u002F.claude\u002Fskills\u002Fdocument-illustrator\u002F`\n\n---\n\n**让 AI 帮你理解和归纳内容，生成专业配图！** ✨\n","# Document Illustrator Skill\n\n基于 AI 智能分析的文档配图生成工具。无需依赖特定格式，自动理解内容并生成专业配图。\n\n## ? 核心特点\n\n- ✨ **AI 智能归纳**：自动理解文档内容，智能提取核心主题\n- ? **格式无关**：支持任何格式的文档（Markdown、纯文本、PDF 等）\n- ? **灵活比例**：支持 16:9（横屏）和 3:4（竖屏）\n- ?️ **封面图可选**：可生成概括全文的封面图\n- ? **三种风格**：渐变玻璃卡片、票据风格、矢量插画\n\n## ? 使用方法\n\n### 直接告诉 Claude\n\n```\n帮我为这个文档生成配图：\u002Fpath\u002Fto\u002Fdocument.md\n```\n\n或者：\n\n```\n我想为这篇文章生成一些配图\n```\n\n## ? 完整工作流程\n\n### 第 1 步：Claude 读取和理解文档\n\n当你请求生成配图时，Claude 会：\n1. 使用 Read 工具读取完整文档\n2. AI 分析理解文档内容和结构\n3. 识别核心主题和要点\n\n**无需担心文档格式**：\n- ✅ 标准 Markdown（##、###）\n- ✅ 分隔线格式（======、------）\n- ✅ 纯文本段落\n- ✅ 任何其他格式\n\n### 第 2 步：配置选项（3 个问题）\n\nClaude 会询问你的偏好：\n\n#### 问题 1：图片比例\n```\n请选择图片比例：\n1. 16:9 (横屏) - 适合演示文稿、幻灯片、横屏展示\n2. 3:4 (竖屏) - 适合社交媒体、手机查看、海报\n\n请选择 (1\u002F2):\n```\n\n#### 问题 2：封面图\n```\n是否生成封面图？\n封面图将概括文档的所有核心信息，作为系列配图的引导。\n\n1. 是 - 生成封面图 + 内容配图\n2. 否 - 仅生成内容配图\n\n请选择 (1\u002F2):\n```\n\n#### 问题 3：内容配图数量\n```\n期望生成多少张内容配图？\n建议范围：3-10 张\n根据文档内容，推荐生成 6 张\n\n请输入数字：\n```\n\n### 第 3 步：Claude 归纳内容并展示\n\n根据你指定的数量，Claude 会智能归纳文档，然后展示给你确认：\n\n```\n? 内容归纳完成\n\n? 封面图内容：（如果选择生成）\n\"AI 编程工具概念演化：从 Rules 到 Skills\"\n- 核心概念：静态上下文 vs 动态上下文\n- 演化路径：Rules → Commands → MCP → Modes → Skills\n- 最佳实践：简化为两个核心工具\n\n? 内容配图（共 6 张）：\n\n1. Rules 的诞生与演化\n   包含：早期模型幻觉问题、rules 文件的作用、静态上下文概念\n\n2. Commands 和工作流打包\n   包含：固定工作流的出现、slash command、团队分享\n\n3. MCP Servers 带来动态能力\n   包含：第三方工具集成、OAuth 认证、上下文膨胀问题\n\n4. Modes 和 Subagents 的登场\n   包含：人设提示词、系统提示词修改、可靠性设计、Hooks 确定性\n\n5. Skills 统一动态上下文\n   包含：Skills 概念、动态加载、编程工具优化\n\n6. 最佳实践与未来展望\n   包含：Rules 使用建议、Skills 探索、核心理念总结\n\n✓ 所有内容已覆盖，无遗漏\n\n确认开始生成配图吗？(Y\u002FN)\n```\n\n**关键保证**：\n- ✅ 内容完整：所有重要信息都会被归入某张图片\n- ✅ 逻辑清晰：按照内容的自然逻辑分段\n- ✅ 用户可控：展示归纳结果，等待用户确认\n\n### 第 4 步：生成配图\n\n确认后，Claude 调用 Python 脚本生成图片：\n\n```\n?️  开始生成配图...\n\n正在生成封面图...\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fcover.png\n\n正在生成第 1\u002F6 张...\n  标题: Rules 的诞生与演化\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fillustration-01.png\n\n正在生成第 2\u002F6 张...\n  标题: Commands 和工作流打包\n  ✓ 已保存: \u002Fpath\u002Fto\u002Fdocument\u002Fimages\u002Fillustration-02.png\n\n...\n\n✨ 完成！共生成 7 张配图（1 张封面 + 6 张内容）\n```\n\n### 第 5 步：输出结果\n\n**输出位置**：文档所在目录下的 `images\u002F` 文件夹\n\n```\n\u002Fpath\u002Fto\u002Fyour\u002Fdocument\u002F\n└── images\u002F\n    ├── cover.png              # 封面图（如果选择生成）\n    ├── illustration-01.png    # 第 1 张内容配图\n    ├── illustration-02.png    # 第 2 张内容配图\n    ├── illustration-03.png\n    ├── illustration-04.png\n    ├── illustration-05.png\n    └── illustration-06.png\n```\n\n## ? 三种风格说明\n\n### 1. 渐变玻璃卡片风格 (gradient-glass)\n\n**特点**：\n- Apple Keynote 风格的极简主义\n- 玻璃拟态（Glassmorphism）设计\n- 深邃虚空黑或纯净陶瓷白基底\n- 流动的极光渐变色\n- 3D 玻璃物体和发光效果\n\n**适用场景**：\n- 科技产品介绍\n- 数据分析报告\n- 未来趋势展望\n- 产品功能演示\n\n### 2. 票据风格 (ticket)\n\n**特点**：\n- 数字极简票券设计\n- 高度对比的黑白配色\n- 类似登机牌、门票的结构\n- 精确的几何分区\n- 中英混排，多向文字布局\n\n**适用场景**：\n- 信息图表\n- 统计数据展示\n- 时间线和流程图\n- 要点总结\n\n### 3. 矢量插画风格 (vector-illustration)\n\n**特点**：\n- 扁平化矢量插画\n- 统一粗细的黑色轮廓线\n- 复古柔和的配色\n- 几何化处理\n- 横向全景式构图\n\n**适用场景**：\n- 故事叙述\n- 概念解释\n- 教育内容\n- 品牌宣传\n\n## ? 使用示例\n\n### 示例 1：完整流程\n\n```\n用户: 帮我为 ~\u002Fblog\u002Fai-tools.md 生成配图，用票据风格\n\nClaude: 好的，让我先读取这个文档...\n        [读取文档，分析内容]\n\n        检测到文档长度约 3000 字，内容涉及 AI 工具演化。\n\n        请选择图片比例：\n        1. 16:9 (横屏)\n        2. 3:4 (竖屏)\n\n用户: 1\n\nClaude: 是否生成封面图？\n        1. 是\n        2. 否\n\n用户: 是\n\nClaude: 期望生成多少张内容配图？\n        建议范围：3-10 张\n        根据文档内容，推荐生成 5 张\n\n用户: 5\n\nClaude: [展示归纳的 5 个主题]\n        确认开始生成配图吗？\n\n用户: Y\n\nClaude: [调用 Python 脚本生成 6 张图片]\n        ✨ 完成！配图已保存到 ~\u002Fblog\u002Fimages\u002F\n```\n\n### 示例 2：纯文本文档\n\n```\n用户: 为这个纯文本笔记生成配图\n\nClaude: [读取笔记，即使没有任何标题也能理解内容]\n        [智能识别 3 个核心主题]\n        [询问配置、展示归纳、生成配图]\n```\n\n### 示例 3：自定义数量\n\n```\n用户: 我想要 8 张图，竖屏的，不要封面\n\nClaude: 好的，16:9 竖屏，不生成封面，8 张内容配图。\n        [将文档归纳为 8 个主题]\n        [展示归纳结果，用户确认后生成]\n```\n\n## ? 技术细节\n\n### 图片规格\n\n| 比例 | 分辨率 | 适用场景 |\n|------|--------|----------|\n| 16:9 | 2560x1440 (2K) | 演示文稿、横屏展示 |\n| 3:4 | 1920x2560 | 社交媒体、竖屏查看 |\n\n可选 4K 分辨率：\n- 16:9 → 3840x2160\n- 3:4 → 2880x3840\n\n### API 调用\n\n- **模型**：Gemini 2.0 Flash Image Preview (Nano Banana Pro)\n- **成本**：每张图片 = 1 次 API 调用\n- **速度**：平均 10-20 秒\u002F张\n\n### 环境要求\n\n**必需**：\n```bash\npip install google-genai pillow python-dotenv\n```\n\n**API 密钥**：\n- 在 `~\u002F.claude\u002Fskills\u002Fdocument-illustrator\u002F.env` 中配置\n- 或设置环境变量 `GEMINI_API_KEY`\n\n## ? 内容归纳原则\n\nClaude 归纳内容时遵循以下原则：\n\n### 1. 完整性优先\n\n- ✅ 所有重要信息都会被包含\n- ✅ 不会遗漏关键概念\n- ✅ 保留原文的核心观点\n\n### 2. 逻辑清晰\n\n- 按照内容的自然逻辑分段\n- 相关内容归为一组\n- 保持叙事的连贯性\n\n### 3. 平衡分配\n\n- 每张图片包含相似的信息量\n- 避免某张过于拥挤或空洞\n- 根据内容重要性调整\n\n### 4. 用户可控\n\n- 展示归纳结果给用户确认\n- 用户可以要求调整\n- 确认后才开始生成\n\n## ? 故障排除\n\n### 问题 1：API 密钥错误\n\n**错误信息**：\n```\nError: Invalid API key\n```\n\n**解决方案**：\n1. 检查 `.env` 文件中的 `GEMINI_API_KEY`\n2. 确保 API 密钥有效且未过期\n3. 获取新密钥：https:\u002F\u002Fmakersuite.google.com\u002Fapp\u002Fapikey\n\n### 问题 2：内容归纳不理想\n\n**问题**：归纳的主题不符合预期\n\n**解决方案**：\n1. 在归纳展示阶段，告诉 Claude 你的期望\n2. Claude 会重新归纳并调整\n3. 确认满意后再开始生成\n\n### 问题 3：图片生成失败\n\n**可能原因**：\n- 网络连接问题\n- API 配额用尽\n- 内容过长超过限制\n\n**解决方案**：\n1. 检查网络连接\n2. 检查 API 配额\n3. 尝试增加图片数量（分散内容）\n\n## ? 成本估算\n\n| 图片数量 | API 调用次数 | 预估成本 |\n|---------|-------------|---------|\n| 无封面 + 3 张 | 3 次 | 低 |\n| 有封面 + 5 张 | 6 次 | 中 |\n| 有封面 + 10 张 | 11 次 | 较高 |\n\n**建议**：\n- 短文档（\u003C1000字）：3-5 张\n- 中等文档（1000-3000字）：5-7 张\n- 长文档（>3000字）：8-10 张\n\n## ? 最佳实践\n\n### 1. 合理选择图片数量\n\n**太少**：\n- 每张图片信息量过大\n- 不容易理解和记忆\n\n**太多**：\n- 内容分散\n- 增加成本和生成时间\n\n**推荐**：\n- 根据文档长度选择\n- 每张图片涵盖 1-2 个核心观点\n\n### 2. 根据用途选择比例\n\n**16:9 适合**：\n- PPT 演示\n- 网站横幅\n- 视频封面\n- 博客配图（桌面端）\n\n**3:4 适合**：\n- 社交媒体（Instagram、小红书）\n- 移动端文章\n- 海报设计\n- 竖屏视频\n\n### 3. 封面图的使用\n\n**建议生成封面图的场景**：\n- 系列文章（作为统一引导）\n- 社交分享（作为预览图）\n- 文档首页（概括全文）\n\n**可以不生成的场景**：\n- 仅内部使用\n- 图片数量已足够\n- 希望降低成本\n\n### 4. 风格选择建议\n\n**技术文档** → 渐变玻璃卡片风格\n**数据报告** → 票据风格\n**教程故事** → 矢量插画风格\n**产品介绍** → 渐变玻璃卡片风格\n\n## ? 工作原理\n\n### 传统方式（已废弃）\n\n```\n[代码] 读取文档 → 识别 ## ### 标题 → 机械切分\n       ↓\n    依赖特定格式\n    容易遗漏内容\n    不够智能\n```\n\n### 新方式（当前实现）\n\n```\n[Claude] 读取文档 → AI 理解内容 → 智能归纳主题\n         ↓\n      格式无关\n      内容完整\n      用户可控\n```\n\n**核心区别**：\n- ❌ 旧方式：依赖代码解析，只能处理标准格式\n- ✅ 新方式：AI 理解内容，任何格式都能处理\n\n## ? 与其他工具的对比\n\n| 功能 | Document Illustrator | 传统 PPT 工具 | AI 图片生成器 |\n|------|---------------------|--------------|--------------|\n| 理解文档内容 | ✅ AI 智能理解 | ❌ 需要手动 | ❌ 需要手动输入 |\n| 格式依赖 | ✅ 格式无关 | ❌ 依赖特定格式 | ✅ 无依赖 |\n| 内容完整性 | ✅ 自动验证 | ⚠️ 手动确保 | ❌ 无法保证 |\n| 批量生成 | ✅ 一次生成多张 | ❌ 逐张制作 | ⚠️ 需要多次输入 |\n| 风格一致性 | ✅ 自动保持 | ⚠️ 手动调整 | ⚠️ 需要重复提示词 |\n\n## ? 获取帮助\n\n如有问题或建议：\n1. 直接在 Claude Code 中询问 Claude\n2. 查看计划文件：`~\u002F.claude\u002Fplans\u002Fshimmering-tickling-seahorse.md`\n3. 检查 Skill 目录：`~\u002F.claude\u002Fskills\u002Fdocument-illustrator\u002F`\n\n---\n\n**让 AI 帮你理解和归纳内容，生成专业配图！** ✨\n",{"name":5,"model":48,"description":49,"allowed-tools":50},"claude-sonnet-4-5-20250514","基于文档内容自动生成配图。AI 智能分析文档结构，归纳核心要点， 为每个主题生成符合特定风格的配图。支持封面图生成和自定义图片比例。 使用场景：当用户需要为文档、文章、笔记生成配图时。 关键词：配图、插图、illustration、generate images、document images\n",[51,52,53,54,55],"Read","Write","Bash(python:*)","Glob","AskUserQuestion","main","f19b254e8975d0bfddb394686706106930d7964d","Document-Generation\u002Fdocument-illustrator","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus","https:\u002F\u002Fgithub.com\u002Fendman100","2026-11-13 20:29:52",{"source":8,"skillName":5,"commands":63,"prompt":73,"zipAvailable":74},[64,67,70],{"tool":65,"command":66},"npx","npx skills add endman100\u002Fskill-router-nexus --skill document-illustrator",{"tool":68,"command":69},"bunx","bunx skills add endman100\u002Fskill-router-nexus --skill document-illustrator",{"tool":71,"command":72},"pnpm","pnpm dlx skills add endman100\u002Fskill-router-nexus --skill document-illustrator","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002FSKILL.md",true,[76,82,88,92,96,102,106,110,114],{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},".gitignore","OTHER","其他",514,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002F.gitignore",{"path":83,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":86,"sourceHtmlUrl":87},"examples\u002FREADME.md","REFERENCE","参考文档",2221,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fexamples\u002FREADME.md",{"path":89,"resourceType":89,"resourceTypeDesc":90,"sizeBytes":91,"sourceHtmlUrl":15},"LICENSE","许可证",1063,{"path":93,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":94,"sourceHtmlUrl":95},"README.md",15105,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002FREADME.md",{"path":97,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":100,"sourceHtmlUrl":101},"scripts\u002Fgenerate_illustrations.py","SCRIPT","脚本",23225,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fscripts\u002Fgenerate_illustrations.py",{"path":103,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":104,"sourceHtmlUrl":105},"scripts\u002Fgenerate_single_image.py",8232,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fscripts\u002Fgenerate_single_image.py",{"path":107,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":108,"sourceHtmlUrl":109},"styles\u002Fgradient-glass.md",2356,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fstyles\u002Fgradient-glass.md",{"path":111,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":112,"sourceHtmlUrl":113},"styles\u002Fticket.md",2092,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fstyles\u002Fticket.md",{"path":115,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":116,"sourceHtmlUrl":117},"styles\u002Fvector-illustration.md",2061,"https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FDocument-Generation\u002Fdocument-illustrator\u002Fstyles\u002Fvector-illustration.md",[119,139,175,198,207,231],{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":123,"sourceHtmlUrl":124,"categories":125,"keywords":131,"publishedAt":43},"01M6MPCT5BXVER8HQZTW3QE9AS","create-master","基于佛教经典文献，生成特定高僧大德的 AI 教学角色","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FMetaphysics-and-Spirituality\u002FMaster-skill\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FMetaphysics-and-Spirituality\u002FMaster-skill\u002FSKILL.md",[126],{"categoryNo":127,"categoryName":128,"taxonomyType":129,"taxonomyTypeDesc":130},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[132,133,134,34,135,136,137,37,36,138,32],"create master","master","create","true","webfetch","edit","grep",{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":143,"sourceHtmlUrl":144,"categories":145,"keywords":155,"publishedAt":43},"01M6M43AKE95Y64E1JRXEF5QQ3","writing-dna-skill","从至少 20 篇完整文章中蒸馏可复用的写作 DNA，分析语言、文章结构、选题逻辑、素材策略、认知框架和视觉风格，并生成 Writing-DNA.md；按该 DNA 写作时会读取全部蒸馏产物和 5 篇相关原文。用于中英文作者、账号、品牌或出版物的风格分析与一致性写作。 Distill reusable Writing DNA from at least 20 complete articles for Chinese or English authors, publications, brands, and accounts; use for language, structure, topic logic, source strategy, cognitive-frame, and visual-style analysis.","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fwriting-dna-skill\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fwriting-dna-skill\u002FSKILL.md",[146,149,152],{"categoryNo":147,"categoryName":148,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":150,"categoryName":151,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":153,"categoryName":154,"taxonomyType":129,"taxonomyTypeDesc":130},"01JBSEEDCAT000000000000036","内容创作者",[156,157,158,159,160,161,162,163,164,165,166,167,168,34,169,170,171,172,173,174],"writing dna skill","DNA","writing","strategy","english","logic","visual","structure","chinese","reusable","use","style","distill","analysis","frame","source","for","at","complete",{"skillNo":176,"name":177,"nameZh":6,"description":178,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":179,"sourceHtmlUrl":180,"categories":181,"keywords":184,"publishedAt":43},"01M6M428TTCGQ4ME3KY99VN037","stop-slop","Remove AI writing patterns from prose. Use when drafting, editing, or reviewing text to eliminate predictable AI tells.","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fstop-slop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fstop-slop\u002FSKILL.md",[182,183],{"categoryNo":147,"categoryName":148,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":153,"categoryName":154,"taxonomyType":129,"taxonomyTypeDesc":130},[185,186,187,188,189,190,191,192,193,166,194,195,196,172,197,158],"slop","stop slop","stop","drafting","when","drafts","https","patterns","prose","remove","editing","text","content",{"skillNo":199,"name":200,"nameZh":6,"description":201,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":202,"sourceHtmlUrl":203,"categories":204,"keywords":205,"publishedAt":43},"01M6M41X0B7EBX42TK435DMGGR","shuorenhua","检查和清理中英文文本里的 AI 套路，适用于“去 AI 味”“说人话”“自然一点”“别像模板”“先标问题”这类改写和审稿需求；按场景控制力度，同时保留事实、术语、语域和责任主体。","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fshuorenhua\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fshuorenhua\u002FSKILL.md",[],[200,206],"文本",{"skillNo":208,"name":209,"nameZh":6,"description":210,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":211,"sourceHtmlUrl":212,"categories":213,"keywords":214,"publishedAt":43},"01M6M3ZD12WBEW5KXKDM4N6DFG","naming","Name products, SaaS, brands, open source projects, bots, and apps. Use when the user needs to name something, find a brand name, or pick a product name. Metaphor-driven process that produces memorable, meaningful names and avoids AI slop.","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fnaming-main\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fnaming-main\u002FSKILL.md",[],[209,215,216,217,218,219,166,220,36,171,221,222,223,224,32,225,226,227,228,189,229,230,185],"repo","websearch","product name","apps","bots","view","brand","pick","gh","projects","open","saas","open source","product","describe","ai slop",{"skillNo":232,"name":233,"nameZh":6,"description":234,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":235,"sourceHtmlUrl":236,"categories":237,"keywords":239,"publishedAt":43},"01M6M3YVXAFAAWJ7F6JMPFREYE","humanizer-zh","去除文本中的 AI 生成痕迹。适用于编辑或审阅文本，使其听起来更自然、更像人类书写。\n基于维基百科的\"AI 写作特征\"综合指南。检测并修复以下模式：夸大的象征意义、\n宣传性语言、以 -ing 结尾的肤浅分析、模糊的归因、破折号过度使用、三段式法则、\nAI 词汇、否定式排比、过多的连接性短语。","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fhumanizer-zh\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fendman100\u002Fskill-router-nexus\u002Fblob\u002Fmain\u002FWriting-and-Content\u002Fhumanizer-zh\u002FSKILL.md",[238],{"categoryNo":147,"categoryName":148,"taxonomyType":21,"taxonomyTypeDesc":22},[240,241,242,36,37,137,158,34,206,243,185,187],"humanizer","zh","humanizer zh","翻译"]