摸鱼PPT

摸鱼PPT은(는) 무엇을 하나요?

把内容变成可阅读、可讲述、设计一致的幻灯片。核心设计产物是每页完整的空间定位图；完整制作交付一图一页、文字在图内的 PPTX。保留用户选定的 IP、品牌与风格方向。

{SKILL_DIR} 是本文件所在目录。每套作品用独立工作区 decks/{deck-name}/，建在用户当前项目目录下（用户指定了位置就用指定的）；不要建在 {SKILL_DIR} 里，技能升级会覆盖那里的内容。命令在该工作区执行，路径加引号。决定与状态一律用 python3 "{SKILL_DIR}/scripts/deck_state.py" 写入 deck-state.json：它补时间戳，确认过的内容改变时自动作废旧确认，status 显示进入下一阶段还缺什么。恢复任务或技能升级后先运行 status，再重新读取本文件和当前阶段的 references。

0. 首次使用

每次启动先运行 python3 "{SKILL_DIR}/scripts/configure.py" status。configured 为 true 就直接做事；为 false 时先做一次安装引导，再开始用户的任务（细节见 setup）：

1. 在哪里使用：问用户是在豆包工作、WorkBuddy、Codex 还是别的地方用，用 set-platform 记下。豆包工作和 Codex 直接用平台自带的图像模型，不需要额外配置；其他平台有内置生图工具就用，没有就按 setup 配一个外部生图模型。任何平台都可以改用自己配置的生图模型。
2. 灵感检索：请用户打开 https://app.scrapecreators.com/ 获取 key 并发来，用 set-key scrapecreators 保存；暂时不配就 skip-search，之后不再追问。

保存后不在回复里重复 key。配置完成时按 setup 说一次署名，之后不再提配置。

1. 判断范围

requested_output	做到这里就停
inspiration	有差异的参考、来源与推荐理由
style	风格配置与五角色字体规范；已授权生图时才做字体样张
plans	大纲与全篇空间定位图，不生图
deck	方案、图片、检查与 PPTX
revise	载入已有 deck，只改指定页及受影响的依赖
template	保存、列出、查看或载入本地风格模板，不自动做 PPT

• 按请求和上下文判断：素材来自哪个平台、否定句、中英混合都不是排除理由；“做张知识卡片”和“改上一套 deck 的第 3 页”靠上下文区分。
• 默认 standard，设计决定由用户确认。用户明确说“页数和风格你来定，直接做”“全程不用问我”这类话，才用 delegate --quote --scopes 记下原话和范围，进入 autonomous。“帮我做PPT”、选了一个风格、回复“默认”，都只确认当时展示的那一项。
• 已知信息不重问；已有授权延续到它覆盖的后续步骤。局部请求做到完成条件就停，不自动扩大成付费生成。

2. 五个用户检查点

每个检查点都要让用户看到实际内容并回复，才能往下走；记录规则与门禁见 workflow-gates。autonomous 只免去授权范围内的确认，展示、样页、字体产物和自检照常做。等待回复时可以读素材、整理页型、检查已有资产；依赖回复的搜索和生图等回复后再做。

检查点	给用户看	回复后记录
① 需求	内容骨架（知识型还是演讲型、主线、各部分的要点、几档页数各舍什么）+ 已知项 + 缺失项的一组建议（页数、画幅、受众/用途、图文融合占比、标题排版），同时问整体感觉、喜欢或排斥的样子	artifact content_map → brief（建议先用 --proposed；占比用 --visual-ratio，标题排版用 --title-layout）→ decide intake --quote
② 文案	一份文案稿 page-copy.md：全篇每页的标题和每一行要上屏的文字，一次给全、确认一次。新增的字和引语单独指出来；知识型里引语、金句、总结句和人物署名默认不上屏，用户要留才留	artifact page_copy → decide copy --quote
③ 方向	按门类分组、带编号的高清原图图库：版式一类、风格元素一类（先看本地风格库和模板库里存过的）；agent 看过原图后给两三套搭配建议，每套拼成一张整版（左边版式、右边风格元素），图不删；用户照建议选、混着选或自己挑，再把选定的版式和画风搭配成方向，连同中文标题/正文/数字的字体搭配和局限一起给用户确认	typography、artifact → decide visual --quote
④ 大纲 + 样页	全篇大纲、覆盖表（原文结构 → 页码：上屏、合并、不上屏及理由）和 1–3 张真实样页（实际标题与正文，数据页含数字）。这一步看视觉，文字以②确认的文案稿为准	pilot、artifact pilot_image → decide pilot --quote
⑤ 收藏	交付且检查完成后，拟保存的模板名称与摘要，只问一次	template-offer

建议值只是建议：给出 8–12 页这样的区间也要用户选定，不自行取上限。页数从内容骨架得出：给两到三档并写清每档舍哪些节；用户给定的页数装不下时，说明要舍掉哪些节，由用户选加页还是确认舍弃，不悄悄舍。图文融合占比的建议跟内容类型走（演讲型视觉主导 80/20，知识型 70/30 上下），并说明它是设计预算而非面积测量、文字密的页会按内容调整或拆页；用户可选整体占比（如 80/20、60/40、50/50），也可以说按内容逐页定（per-page）。标题排版二选一，也是建议组的一项：统一版式（内容页标题每页同一位置、同一大小，适合汇报、课件和字多的知识型）或自由构图（标题的位置和排法跟着每页的画面走，只锁配色、字形和画法，适合分享、演讲和插画、游戏这类画面感强的风格）；说明自由构图下标题只能做到字形一致、大小相近，要严格一样大就选统一版式。inspiration 与 style 不写文案稿，到 ③ 结束；plans 在 ③ 之后交付方案即结束。

3. 流程

1. 初始化与需求（①）：init --deck-name … --requested-output …。读完素材先写内容骨架 content-map.md：判断知识型还是演讲型，写主线，逐节写讲者要讲什么、靠什么讲清楚和原文依据（content-structure-method）；content_map.py check 通过后登记。然后把骨架、已知项和缺失项建议一次问完，并记录本次可用的生图与检索能力（intake-and-state）；风格怎么问见 style-discovery。用户说“没想法，你先找”即可开放探索。
2. 文案稿（②）：需求确认后、找灵感和做设计之前，把全篇每页要上屏的文字写成一份 page-copy.md：每页一行 内容来源，再逐行写 上屏：文字｜出处，出处标原文、压缩、新增（写理由）或引语（写理由）。屏幕上的字从这一节的“讲者要讲什么”和“靠什么讲清楚”来；原文没有的总结句、口号不加；知识型里引语、金句和人物署名默认不上屏。选了统一版式时，同类页的标题字数现在就写齐；自由构图不限字数。page_copy.py check 通过后登记，把整份文案稿一次给用户看（不是一页一页问），新增和引语单独指出来，用户确认后记录。之后方案里的可见文字只能是这份文案稿里的字；要改字，先改文案稿并重新确认。见 content-structure-method 第 10 节。
3. 检索与方向（③）：先查本地风格库和模板库，有合适的先给用户挑。要搜时，AI 只负责关键词，分门类写、分开成组（共 6–8 组、每组 3–4 条）。用户点名的风格只搜和它有关的：这个风格的成套演示、用它做的版式（封面、目录、信息图等页面）、它自己的风格元素（界面、图标、场景、纹理、标志），每条关键词都带风格名，叫法写进 brief.style_terms；不带风格名的通用版式（流程图、对比页这类商务模板）和相近的风格都不搜，用户提出才搜。用户没点名时，版式按页型搜，风格元素按感觉拆开搜。关键词写进 inspiration-plan.json（带 brief，先 --validate-plan）。ref_gallery.py build 边搜边做编号图库：每组先搜前两条关键词、放 6 张原图，按 Pinterest 原排序轮流取，不按风格或质量删图，以前看过的照样放；用户要多看某组时先放已搜到的，不够再搜下一条，用户要多搜就照办（--keywords）。拼图不放大，large/ 里有每张图的原始尺寸，用户要看清某张时给原图。图库做好后 agent 先翻拼图、再逐张打开要推荐的原图（large/），给两三套搭配建议（版式编号配风格元素编号、各借什么、短处在哪），每套用 ref_gallery.py combo 拼成一张整版给用户看，不删图；提风格、附参考都用原图，不用拼图。用户照建议选、混着选或自己挑，想存进风格库的另说（ref_gallery.py pick）；agent 再把选定的版式和画风搭配成方向，写入 visual-proposal.md 给用户确认。见 inspiration-search-method。
4. 字体系统：从实际文案、字数密度和选定风格写出 display/title/body/label/data 五个角色；需要表现力的标题用实际短文案生成 T 样张，正文在样页中验证。字形 T 与同画幅字号样板 SZ 分开：T 传笔画，SZ 传墨迹大小和定位；一份 SZ 按组复用，不逐页重做。默认直接设计，不检索字体。见 typography-method、字号控制，配置字段见 style-config-schema。
5. 全篇方案与样页（④）：完整空间定位图写入 design-plans.md，每页用 [内容来源] 对应骨架里的一个节点，可见文字清单照抄已确认的文案稿（多一行少一行拆分都会失败），标题和内容同源，页面不跨章、顺序跟原文；常量块写明锁定项与放开项，每页标节奏档位（稳定/变奏/亮点）；封面、章节页、结尾是展示页：一律按亮点做，各写各的构图，大字不套内容页的字号锁。内容页标题按①选的标题排版做，拆分时脚本检查方案和选择一致。统一版式：标题用字号锁声明，脚本按字数给每行算字框，放不下就先改短或拆成主副标题；同组字数在写文案稿时就定齐（六个字以内每页相同，更长的最多差 2 个字），否则拆分失败。样页确认后，请用户指定字号最对的一页，用 text_lock.py template 剪出字号样板，生产时附给这组的每一页；位置不同的组用 template --as-group 把同一行字放到新位置做样板。自由构图：标题不加锁，每页把标题在哪、怎么排写进构图方式（顶部、压在主体上、场景里的招牌或横幅、竖排、居中、底部都可以），不做字号样板、不测字号；全篇标题都写在同一个位置时拆分会提醒。见 visual-director-method。通过 plans 门禁后机械拆分（方案和骨架不对位、或可见文字和文案稿不一致时拆分失败），只生成 pilot_pages 的代表页，连同全篇大纲和 coverage.md 一起展示。自检通过不等于用户验收。
6. 余页：production 门禁通过后导出或调用生图；内置生图工具同样使用通过门禁的导出包。统一版式的作品首张内容页前可用 text_lock.py guide 做同画幅几何样板；样页认可后用 template 提取真实字号样板。同骨架或明确允许正文重排的页可声明 [编辑底图]，机械导出为编辑任务；T/L 不再竞争带锁标题的尺度和位置。字号仍需测量，不承诺像素锁定；重画由用户决定。见 字号控制、generation-pipeline。
7. 检查与修复：全篇文件、页数、比例；声明了字号锁的作品每批图先用 text_lock.py check 量字高与位置，测量只出报告；重画哪几页由用户看图决定（--feedback … --pages），不自动重画；文字、数据、品牌、二维码页重点看，每种版式看代表页。OCR 只提示疑点。修复时给 target_image，只更新受影响页；已成功且输入未变的结果直接复用，提交状态不明的请求先核对再决定是否重付费。见 quality-and-evaluation。
8. 交付：展示全篇总览、重点页和检查结论；按页序装配满铺 PPTX 并重开验证。保留方案、字体规范与状态，方便之后修改。交付消息的最后加一行署名：“本技能由摸鱼小李开源，公众号「摸鱼小李」获取更新。”每套作品只说这一次，不写进幻灯片图片；用户说不需要就不再出现。
9. 收藏（⑤）：见 template-library。用户事先说过保存或不保存就照办；没有回复就不保存，也不再追问。

4. 设计原则

• 先读懂，再提炼：页面呈现讲者真正要讲的东西。每页的主体是这一节的主张和它的展开；原文没有的总结句和口号不加，知识型里引语、金句和人物署名默认不上屏，用户要留才留在原文所在的那一节。知识型把知识结构放上屏，演讲型一页一个观点。任何一节不上屏都写明理由并让用户知道。
• 内容保真：每页一个主要表达任务。人名、数字、单位、日期、否定、条件、不确定性和因果强度原样保留；引语逐字；简繁按原文；来源没有的事实标为待补。
• 阅读优先：字形正确、可读性、信息层级排在装饰之前。颜色、字体、栅格、图表与资产共同构成设计系统。
• 视觉预算：以①确认的图文融合占比为全篇基准（未记录时视觉主导 80/20），它是设计预算而非面积测量。下限默认比基准低 5 点；每页 [融合比] 不低于下限，低于基准写原因，除封面、章节页、结尾页外至少三分之二的页达到基准。文字放不下就写短或拆页，不缩字号。每页比例写进提示词，由模型安排画面；留白单独描述。
• 统一靠系统，变化有节奏：配色、字体角色、栅格、材质全篇锁定；构图、视角、主视觉隐喻按页放开。稳定页只用于同口径比较和逐步讲解；新论点默认是变奏页，可以改一到两项。封面、章节页、结尾是展示页，要大胆，彼此的构图也不能一样：字可以当主体、放进场景、竖排或压底，景别可以换，可以满版出血；锁住的只是配色、字形、材质和画法。创意和实用都要：内容页把知识讲清楚，展示页让人记住。每页写 [承接与递进]（承接上页、本页变化、铺垫下页），它只用于规划、不进提示词；变奏、亮点页的变化要写进本页的构图方式（主体在哪、重心在哪），稳定页可以同骨架。标题排版由用户选：统一版式时内容页标题用字号锁保证每页一样大，不写字号百分比（模型按给它的区域定字的大小，标题长短不同就会画出不同字号，所以同组字数要统一，变奏、亮点页还要附字号样板）；自由构图时不锁标题，标题跟着每页的画面走，只要求字形一致、大小相近。文字由生图模型画，不改用叠加的文本框。样页确认后生成风格板，变奏与亮点页附风格板而不是锚定页。
• 只画确认过的字：每页的可见文字清单照抄用户确认的文案稿，不增不减；emoji、页码、说明文字只在用户提供时出现；图像版 PPTX 不加可编辑文字层。
• 参考各司其职：[S] 风格、[L] 版式、[T-role] 字形、[C] 品牌；方案写稳定 ID，图片序号由脚本生成；编辑必须提供待修图。见 image-prompt-method。
• 借画法不复刻：用户点名某部作品或某款游戏的风格时，借它的画法与版式语言；不出现官方标志、官方角色与原版素材，角色与图形自己原创，除非用户说明已获授权。
• 字形样张是参考图，不是字体文件，不保证任意汉字精确复现；正文的可读性优先于标题效果。

5. 产物

范围	产物
inspiration	搜索简报、稳定编号的候选、来源、差异与推荐理由；没有搜索时说明依据的已有参考或缺口
style	assets/style-configs/{id}.json 与必要的 S/L/T 资产；未生成的样张标为计划
plans	content-map.md：内容骨架；page-copy.md：文案稿；design-plans.md：全篇常量、逐页空间定位图、可见文字清单；coverage.md：覆盖表
deck	以上 + images/pXX.png + quality-report.json + {deck-name}.pptx
revise	修订方案、版本化图片、受影响页与检查记录；按请求更新 PPTX
template	用户确认后写入独立本地库，返回名称/id/版本；默认不保存原稿、逐字稿或客户资产

每个任务都有 deck-state.json；外部生图另有 run-state.json。密钥只在用户本机的配置目录里，作品目录与状态文件里不存密钥。

首次回复

首次使用且未配置：先做第 0 节的安装引导。没有素材：请用户提供材料和用途。有素材：先读完素材写内容骨架，再列已知项，给出内容类型的判断、页数档位和缺失项的一组建议（含图文融合占比和标题排版），并问整体感觉；用户可以逐项修改，也可以回复“按这组建议”。字体方案始终是展示给用户的视觉方案，不只写在配置文件里。