用途:把 Markdown/vault 文章或 URL 渲染为图片产物,包括长图(完整内容纵向展开为单张 PNG/JPEG)、信息图(节点+连接+标注)、海报/封面(强排版)以及插画/封面图。
主要能力:默认 visual_dense 模式,保留核心概念、压缩排版,不逐段重复原文;允许信息架构重组(如段落提炼为节点关系图),但不做内容总结。prompt 落盘到 outputs/transform/<YYYY>/<stem>/prompts/ 以保证可重跑,产物输出到 outputs/transform/<YYYY>/<stem>/。
使用方式:先说明来源(URL/vault 路径/本地 Markdown)和目标视觉类型,可选指定 provider(local/open-design/codex-image)、风格与尺寸。URL 来源先 clip 归档再转换。安装命令:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-transform-article-visual -y。本地截图方案需 pip install playwright && playwright install chromium。
provider 依赖:local 零依赖可用;codex-image 依赖当前环境的 image generation 能力;open-design 硬依赖 soia-dev-open-design-ops 及其 Open Design 环境,缺失时停止该 provider 并给出安装与环境检查命令,不静默降级。
验收:文件存在且大于 50KB,宽度 ≥ 750px,目视中文可读、无截断、无方块乱码。位图上文字错误唯一合法修复是改 prompt 重新生成,禁止用 PIL/Canvas/ImageMagick 描字覆盖。
限制:不做内容总结;未指定 provider 时可选本地路径;用户显式选择 open-design 而缺少原子层或环境时停止并说明缺口。Open Design 的环境、daemon、目录与导出原子操作以 soia-dev-open-design-ops/SKILL.md 为单一真源。