1实现原理 · 为什么它能做到
先做“深度内容分析”再画：按分析框架产出 analysis.md（受众、价值主张、核心主题、人物与故事弧、内容信号），据信号推荐 art/tone/layout 与页数。
skills/baoyu-comic/references/analysis-framework.md
Deep analysis framework for transforming source content into effective visual storytelling.
注：篇幅按内容复杂度定档（短篇 5-8 页、中等 9-15 页、完整传记 16-25 页），并把推荐值写进 analysis.md 的 front matter，供后续步骤引用。
风格是 art(6) × tone(7) × layout(7) 三维，加上 preset 层：preset 不只是 art+tone 的别名，还带额外规则（如 ohmsha 禁“说话头”、必须有视觉隐喻）。
skills/baoyu-comic/references/workflow.md
**Preset vs Art+Tone**: Presets include special rules beyond art+tone.
注：art-styles/、tones/、layouts/、presets/ 四个目录各自按需加载定义文件；ohmsha preset 还预置了大雄/哆啦A梦等默认角色，用户没指定就不许自造角色。
角色一致性靠“角色设定表 + 参考图”工程化：先生成 characters/characters.png 作为跨页 --ref，后端不支持 --ref 时降级为把角色描述写进每页 prompt。
skills/baoyu-comic/SKILL.md
| Exists | Supported | Pass sheet as `--ref` on every page |
注：还有失败恢复链：先用 sips/pngquant 压缩参考图避免 payload 失败 → 重试 → 仍失败则丢掉 --ref 改为文案内嵌。
分页生成有严格的依赖顺序与批次策略：先出角色表，再按批派发页面；每页 prompt 必须先落盘才允许调用后端。
skills/baoyu-comic/SKILL.md
Honor workflow dependencies first: generate `characters/characters.png` before pages that use it as a reference.
注：同段还写死 Never start the first page batch until all selected page prompt files exist on disk；批量失败只重试失败项。
自带一个可执行脚本把页面合并成 PDF：用 bun 跑 merge-to-pdf.ts，pdf-lib 建文档、按图片实际尺寸建页、Bun.write 落盘。
skills/baoyu-comic/scripts/merge-to-pdf.ts
const pdfDoc = await PDFDocument.create();
注：脚本按文件名里的 NN 前缀排序（00-cover-*.png, 01-page-*.png …），找不到页面直接报错退出；输出默认是 <dir>/<dirName>.pdf。
局部工作流避免整套重跑：只出分镜、只出 prompt、只出图、或指定页重生成。
skills/baoyu-comic/SKILL.md
| `--regenerate N` | Regenerate specific page(s) only (e.g., `3` or `2,5,8`) |
注：与 --storyboard-only/--prompts-only/--images-only 组合使用，细节在 references/partial-workflows.md。
重生成前必须备份：已有 prompt 与图片统一改名加 -backup-YYYYMMDD-HHMMSS 后缀，保留可比较的旧版本。
skills/baoyu-comic/references/workflow.md
**Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
注：同规则适用于 pages 与 prompts；生成失败/重做不覆盖原始文件。
交互语言贯穿全流程：分镜、prompt、选项与进度反馈都用用户输入语言或保存的偏好语言。
skills/baoyu-comic/SKILL.md
**Rule**: Use user's input language or saved language preference for ALL interactions:
注：技术术语保留英文；语言优先级 --lang > EXTEND.md > 会话语言 > 素材语言。
2核心能力
01深度内容分析 → analysis.md（受众/价值/主题/人物弧/内容信号）
02storyboard + 角色设定（storyboard.md、characters/characters.md），可先评审再出图
03art×tone×layout×preset 选型与自动推荐（含 ohmsha/wuxia/shoujo/concept-story/four-panel）
04角色跨页一致性（character sheet 作 --ref / 描述内嵌两套降级方案）
05页面批量生成 + 单次重试 + 依赖排序（角色表先于页面）
06本地合并 PDF（bun + pdf-lib，按 NN 前缀排序）
07局部重跑（--images-only / --prompts-only / --storyboard-only / --regenerate N）与备份规则
08产物压缩以适配 --ref payload（sips / pngquant）
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | bun / npx（${BUN_X} 运行时，跑 scripts/merge-to-pdf.ts） |
| package | pdf-lib（脚本内 import，用于建 PDF） |
| cli | sips / pngquant（压缩角色表，避免 --ref payload 失败） |
| cli | codex CLI / baoyu-image-gen（图像生成后端，codex-imagegen 分支） |
| api | Codex 原生 imagegen / Cursor GenerateImage / Hermes image_generate（宿主原生图像工具） |
4风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 素材与整本分镜 prompt 出网到第三方生成后端（orange 档主因） — 传记/教程原文、角色设定、逐页 prompt 都会发往 Codex imagegen / baoyu-image-gen 等后端；多页漫画按批生成，账号额度消耗与内容外发量都大，涉密素材不可用。
- PDF 脚本的依赖靠外部解析 — merge-to-pdf.ts import pdf-lib，但 skill 目录无 package.json；若运行环境里 Bun/Node 解析不到该包（或 Bun 触发运行时自动安装），最后一步“合并 PDF”会失败或从 registry 拉包。[INFERENCE] 依赖仓库根 workspace 或全局环境。
- 流程重、交互多 — 九步流程、两道可选评审门、确认问题 5 个；想快速出一张图会显得繁琐（对比 four-panel 这类轻量 preset 才划算）。
- 角色表压缩依赖系统工具 — sips（macOS）或 pngquant（其它平台）缺失时，--ref payload 失败会迫使流程降级为“描述内嵌”，一致性随之下降。
- 素材文本构成注入面 — 素材内容经分析/分镜原样进入 prompt；恶意文本理论上可影响 agent 拼 prompt 与文件命名的决策（宿主级通用风险，非本 skill 特有）。
风险提醒：橙色，评估后使用。(a) SKILL.md 点名外部图像生成后端：'**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' 与 'route through `baoyu-image-gen --provider codex-cli` (preferred)'；照 SKILL.md 执行后，用户素材（传记/教程原文）与整本分镜 prompt 会出网到第三方图像模型，且多页批量会显著消耗用户账号额度。(b) 本地写盘量大：comic/ 目录下的素材、analysis、storyboard、characters、prompts、页面图、PDF，以及 EXTEND.md。(c) 自带脚本 scripts/merge-to-pdf.ts 仅本地（pdf-lib 建 PDF + Bun.write），无网络无凭证，故这一部分属 blue 特征；红档要件（逆向 API/冒充客户端/绕过防护/任意代码执行）均不满足。对照先例：ai-image-generation / seedance 等“素材送生成后端”一律 orange。
5第二遍独立确认
- [ok] 自带脚本只有 merge-to-pdf.ts，且仅本地行为 — 逐行核对：import fs/path/pdf-lib，createPdf() 里 readFileSync 页面图 → embedPng/embedJpg → Bun.write(outputPath)；无网络调用、无 env 读取、无子进程。
- [ok] pdf-lib 依赖来源（无自带 package.json） — skill 目录确无 package.json；依赖靠仓库根 workspace 的 dependencies（pdf-lib ^1.17.1）或运行环境解析。这一点写进 risks，不影响档位。
- [ok] SKILL.md 点名单一生成后端（orange 依据） — Codex imagegen / codex CLI (baoyu-image-gen --provider codex-cli) / Cursor GenerateImage / Hermes image_generate 均在 SKILL.md 正文，且 7.2 要求“生成任何页面前先读后端 SKILL.md 判断 --ref 能力”。
- [ok] 角色一致性三策略与失败恢复 — SKILL.md 7.2 表（Exists/Supported、Exists/Not supported、Skipped）与 workflow.md 的 Strategy A/B/C 一一对应，另有 --ref 失败时的压缩→重试→降级链。
- [ok] 预设与默认角色 — workflow.md 列出 ohmsha 默认四角色（大雄/哆啦A梦/胖虎/静香）并写明不得为 ohmsha 自造角色；presets/ 5 个文件均在盘。
- [ok] 备份与局部重跑规则 — workflow.md 7.1 备份规则、SKILL.md Partial Workflow Options 表与 partial-workflows.md 均存在。
- [ok] meta 元数据 — GitHub API：MIT、25926 stars、pushed_at 2026-09-10T15:13:43Z；本地 HEAD 与任务 pin 1567581c26ec… 一致。
6结论
适合：适合把长文/传记/教程改造成教育漫画的个人或团队，尤其需要跨页角色一致性与可交付 PDF 的场景；也适合研究“分镜→prompt→图”管线设计的 skill 作者参考。
不适合：不适合只想要单张插图（应用 baoyu-article-illustrator）；不适合严格离线/禁止素材外发的环境；不适合不愿意走多轮确认、追求一次成型的快速草稿场景。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 baoyu-comic.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent0b7b74a684ebd49d…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库JimLiu / JimLiu/baoyu-skills
原始 GitHubJimLiu/baoyu-skills ↗
Stars25926
最近推送2026-09-10
本 skill commit
1567581c26许可MIT（仓库根 LICENSE，Copyright (c) 2026 Jim Liu；GitHub API license.spdx_id=MIT）
本站信息
收录日期2026-09-06
分类设计
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。