soia-pkm-transform-article-visuallisted
Install: claude install-skill soia-team/soia-open-skills
# soia-pkm-transform-article-visual
把已归档或指定文章转换为视觉产物:长图、信息图、海报、封面或插画。
## 客户可读说明
### 这个技能可以做什么
把 Markdown / vault 文章或 URL 渲染为图片产物:
- **长图**:完整文章内容纵向展开为单张 PNG/JPEG
- **信息图**:核心概念可视化,节点 + 连接 + 标注
- **海报 / 封面**:单张设计稿,强排版重视觉
- **插画 / 封面图**:可选 Codex imagegen 生成配图
| 客户想要 | 技能会做 | 客户能看到 |
|---|---|---|
| 生成长图 | HTML/CSS 渲染截图,prompt 落盘可重跑 | 图片路径、像素尺寸、预览 |
| 指定 provider | 走对应 provider 流程 | provider 日志 |
| 执行完成 | 验收文件存在、尺寸合理、中文可读 | 完成回执 |
### 客户如何使用
1. 说明来源(URL / vault 路径 / 本地 Markdown)和目标视觉类型(长图/信息图/海报/封面,可选)。
2. 可选:指定 provider(`local` / `open-design` / `codex-image`)、风格、尺寸。
3. URL 来源先 clip 归档再转换。
### 依赖与安装
```bash
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-transform-article-visual -y
```
- 本地截图方案:`pip install playwright && playwright install chromium`
- Open Design(可选强化依赖):安装 `soia-dev-open-design-ops` 后才可使用 `provider=open-design`;见 [references/provider-open-design.md](references/provider-open-design.md)
- Codex image / imagegen(可选):见 [references/prompt-codex-image.md](references/prompt-codex-image.md)
| 路径 | 依赖 | 缺失时行为 |
|---|---|---|
| `local` | 无 | 零依赖可用 |
| `codex-image` | 当前环境的 image generation 能力 | 仅该 provider 停在工具可用性闸门 |
| `open-design` | `soia-dev-open-design-ops`(该路径硬依赖)及其 Open Design 环境 | 停止该 provider,给出安装与环境检查命令;不把它冒充为 Open Design 结果 |
`soia-dev-open-design-ops` 在本技能 frontmatter 中标为 `optional`,因为 `local` 和 `codex-image` 路径不依赖它;一旦用户选择 `provider=open-design`,它就是该次执行的硬依赖。
### 日志与完成回执
```markdown
完成:<一句话>。
日志摘要:
- source: <路径或 URL>
- visual_