1实现原理 · 为什么它能做到
参数决定四种模具：-l 长图（默认）/-f 全文/-c 漫画/-w 白板，各有尺寸与图像角色；未给参数时用 -l。
skills/ljg-card/SKILL.md
| `-l`（默认） | 长图 · 静线叙事 | 1080 × auto | 0–3 幅；有理解增益时用 1 个安静主场景，必要时追加连续视觉拍点 |
这里在做什么：用一张参数表把模具、尺寸与生成图预算绑在一起，是后续所有步骤的分叉点。
十步共同生产线：读输入→锁定来源与事实边界→（知识讲解先定读者任务）→生成校准图→落盘核图→文字归 HTML→读模板替占位符→等字体图片→整图与切片检查→内容审阅。
skills/ljg-card/SKILL.md
6. 将所有可读文字、数字、公式、标签、箭头和来源放入 HTML/CSS；图片承担具体场景、机制动作、条件对比或明确标明的类比。
这里在做什么：规定图与文字的分工：凡有语义的文字、数字、箭头都由 HTML/CSS 写准，图片只画可见动作。
临时目录约束：无论从哪个目录启动，制卡前必须在 /tmp 建本任务独占目录，所有中间产物只能写入该目录。
skills/ljg-card/SKILL.md
无论从哪个目录启动，制卡前都必须在 `/tmp` 下建立本任务独占的临时目录。…全部只能写入该目录。
这里在做什么：用临时目录隔离候选图、渲染输入、QA 切片与日志，避免污染仓库与用户目录。
截图由自带 capture.ts（Playwright）完成，脚本会等待字体与本地图片加载，不得绕过其加载门禁。
skills/ljg-card/SKILL.md
截图脚本会等待字体与本地图片。不要绕过它的加载门禁。
这里在做什么：把「字体与图片就绪」做成截图前置条件，任一图片损坏即停止。
-f 全文模式走有序原文块账本与 verify-full-text.ts：改单字、调序、漏块、重复块四类反例都必须让校验工具退出非 0。
skills/ljg-card/references/mode-full.md
验收反例固定为四类：改单字、调序、漏块、重复块。四类中的任意一种都必须让校验工具退出非 0。
这里在做什么：把「原文一字不改」从肉眼印象变成可执行的校验器合同。
-f 字体优先使用本机 KingHwa_OldSong，禁止为制卡联网下载、临时安装或远程引用；缺失时由本地默认字体栈接管。
skills/ljg-card/SKILL.md
不得为了制卡联网下载、临时安装或远程引用该字体。
这里在做什么：字体策略坚持本地优先、缺失即回退，不引入远程字体依赖。
生成图先建视觉母题表与系列圣经，配统一负向约束（禁图内可读文字/Logo/水印），同系列保持角色、媒介与色彩连续。
skills/ljg-card/references/image-generation.md
写提示词前先完成表格；一行对应一个候选资产：
这里在做什么：把「画面该画什么」先落成表格，避免直接让图片模型猜整篇文章。
-w 白板先建论证账本：每个源章节必须映射到步骤或登记具体省略理由；账本的 source_sections 与独立来源清单 ID、顺序完全一致。
skills/ljg-card/references/mode-whiteboard.md
每个源章节必须二选一，不能静默消失。
这里在做什么：用独立生成的来源清单约束账本，防止漏掉原文再靠账本自证。
知识讲解（-l/-w）用 learning-design 的下上结构：读者要能从解释中指出对象、动作或状态变化、归类特征、关系条件与结果。
skills/ljg-card/references/learning-design.md
读者应能从同一段解释中指出：眼前是什么对象，发生了什么动作或状态变化，哪个特征支持归类，关系靠什么条件成立，最后得到什么结果。
这里在做什么：给出内容审阅的具体判据，而非只检查字段是否填满。
维护自检三命令：audit 查共享协议/四路引用/白板来源对账/全文忠实度与禁用项，test 跑纯函数与反例，fixtures 生成代表 HTML 并实际截图读回 PNG。
skills/ljg-card/SKILL.md
第一条检查共享协议、四路引用、位图槽、白板来源对账、全文忠实度合同与禁用项；第二条运行纯函数与反例测试；第三条在 `/tmp/ljg-card-v7-fixtures/` 生成代表 HTML，运行全文与白板来源校验，随后用 `capture.ts` 实际截图并读回 PNG。
这里在做什么：把模板与模式升级后的回归固化成三条可复跑的自检命令。
2核心能力
01把文本铸成 1080px 长 PNG 卡片（默认 -l 暖纸静线叙事长图）
02-f 原文保真全文排版：可见字句逐块只出现一次，字符与顺序不变，只用字号/字重/留白做编辑设计
03-c 漫画：格数由认知因果拍点决定，短内容不凑格、长内容不删承重关系
04-w 白板纵向论证：单条 .reasoning-spine 主干，chain/branch/timeline/matrix/radial 降为局部工具
05共享图像生成协议：资产身份四分（generated/source/brand/structural）、视觉母题表、系列圣经、提示词骨架、统一负向约束、先样图后批量
06知识讲解下上结构：按读者任务选材料，覆盖对象与问题、判别依据、关系与条件、实例与结果、换案与反馈
07自带 Playwright 截图器 capture.ts，支持指定宽高与 fullpage 长图，并可附带白板来源清单门禁
08维护工具链：audit.ts（协议与忠实度审计）、verify-full-text.ts（全文校验）、prepare-whiteboard-source.ts（来源清单）、build-fixtures.ts（fixture 回归）
09共同品味底线：判断先于装饰、每图必答「让读者看见什么」、版式不平均、收尾停在内容自身
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| package | playwright |
| host-tool | 运行时 image generation 工具 |
| network | Google Fonts（comic_template.html 的 @import，产物期远程字体） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- scripts/: 执行本地脚本或命令: bun assets/capture.ts <html> <png> <width> <height> [fullpage]：Playwright 无
- 网络端点: 声明外部网络访问: comic_template.html 内 @import Google Fonts（产物期远程字体，-c 渲染时浏览器可能拉取 fonts.goog
- 本地工作目录: 文件读写与工件输出: /tmp/<task> 独占工作区：候选图、源图、HTML/CSS、矢量草稿、渲染输入、截图草稿、QA 切片、缓存与日志等全部中间产物。
审计说明： 风险提醒：蓝色，仅本地脚本与本地读写，可合规使用。判级对象＝本 skill 目录（skills/ljg-card/：SKILL.md + 7 references + assets 脚本/模板 + 锁文件）。逐项核实：脚本执行面全为本地 Bun/Playwright（capture/audit/verify-full-text/prepare-whiteboard-source/build-fixtures），写盘集中在独占 /tmp 与最终交付 PNG，零凭证读取。扫描命中的 URL 中，npmjs registry 仅出现在 lockfile，Google Fonts @import 仅存在于 comic_template.html 模板，都属产物期/安装期引用而非 skill 代码的网络请求，故不改档位。image_gen 属运行时宿主能力，其对用户素材的处理由宿主约束；判级只针对本目录自有行为。
5第二遍独立确认
- [ok] 四模具与 mode/模板路由表 — SKILL.md 参数表与 mode 路由表一致（-l/-f/-c/-w 分别对应 long/full/comic/whiteboard 模板）。
- [ok] -f 全文保真与校验器合同 — mode-full.md 规定四类反例必须让 verify-full-text.ts 退出非 0，与 SKILL.md Gotchas 互相印证。
- [ok] -w 来源清单先于账本生成 — mode-whiteboard.md 明确 prepare-whiteboard-source.ts 由本次输入生成，账本 source_sections 必须与其 ID/顺序一致。
- [ok] 网络面核实 — 无 fetch/requests 类代码；扫描命中的 URL 均为 lockfile registry、模板 @import 与测试数据，属产物期或安装期。
- [ok] 判级口径 — 目录内零凭证读取、写盘限于 /tmp 与最终交付物，符合 blue（仅本地脚本/CLI 与本地读写）。
- [ok] meta 核定值未改动 — license/stars/last_push/official_desc 与骨架一致，installs 保持 null（无可定位到本 skill 的安装量）。
6结论
适合： 需要把长文/论文/书籍、技术概念、原文手稿或论证过程铸成 1080px 可读长图，且愿接受「来源锁定 + 校验器 + 像素复核」这套较重流程的用户；也适合做知识讲解卡片（-l/-w）或原文一字不改的全文排版（-f）。
不适合： 只想要一句话或一张随手的普通配图、无法提供可靠来源与事实边界的场景；无法安装 Bun/Playwright 或缺少图像生成能力的环境；以及只翻译一句古文、只写现代文章或通用内容卡片的请求（-f/-c 之外的轻量用途另择）。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload ljg-card.tar.gz
sha256:
Option B · Copy Guide for Agenta574935eb0666759…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 9e75497a95.