ASCII 示意图转 SVG

问题背景

技术文档里常用 Markdown 围栏代码块画 ASCII/Unicode 框线图（流程、架构、时序）。这类图在 GitHub 上可读，但在 PDF、部分 CMS 或窄屏上容易错位；也无法像矢量图一样缩放。若手工改 SVG，维护成本会随文档迭代迅速上升。

技能如何工作

本技能围绕 svgbob 做批量替换：扫描 Markdown 中带特定 info string 的围栏块（如 ascii、diagram、svgbob，也支持 svgbob 后带标题作为图片 alt），调用 PATH 上的 svgbob / svgbob_cli 等可执行文件生成 SVG，再把原代码块换成指向本地资源的 Markdown 图片链接。文件名会结合文档 stem、图序号与内容哈希，降低重名冲突。

提供 Bash、Python、PowerShell 三套入口，选项一致：--dry-run 预览、--recursive 递归目录、--assets-dir 指定旁路资源目录（默认 assets）、--force 覆盖内容变化的 SVG、--keep-source 在图片链接后用 HTML 注释保留原 ASCII。推荐流程是先通读待改文件 → dry-run → 正式替换 → 核对 diff 与生成的 SVG。

适用边界

• 目标机器必须已安装 svgbob 且能在 PATH 中找到；技能不会替你装二进制。
• 不要对 python、bash、json、yaml、mermaid、plantuml 等常规源码块做 aggressive 转换，避免误改日志、表格或真实代码。
• 未标注语言的普通代码块默认不当作示意图；除非用户明确要求，否则应先 dry-run 再写盘。
• Windows 上若 Unicode 框线渲染遇控制台编码问题，优先用 python -X utf8 入口，而非强行走 PowerShell（需本地验证脚本可解析后再用）。