refactor(ppt): 工作目录收进隐藏 .build/ + 反卡片映射 + svg_preview 兜底/gate(bump 0.34.0)
累积一批(承接 ppt生成2 验证 + 用户"缺图形/卡片阵太多/文件夹过多"反馈):
- 工作目录重构:<project_dir> 根原本把"持久源 / 交付物 / 可再生构建产物"混摊。
新增 project_utils.build_dir/svg_final_dir/preview_dir/backup_dir 单一事实源,
把 svg_final→.build/svg_final、preview→.build/preview、backup→.build/backup/latest
(只留最新,不再堆时间戳)。.build 是 dotfile → /v1/files 自动隐藏 → 用户可见面
收敛到 源(sources/images/svg_output/notes/两个 spec)+ 交付物(exports)。改动:
finalize_svg / svg_preview(_collect)/ pptx_discovery('final'→.build/svg_final)/
pptx_cli(backup 路径 + rmtree 清旧)+ SKILL 工作目录约定/命令。端到端实测:根目录
只剩 exports/+svg_output/,.build/ 三子目录就位,导出/预览/backup 全正常。
- 反卡片映射(治"大段大段卡片阵"):executor-base §page_rhythm 的 dense 行去掉
"card grid 是 baseline"的背书;加一段硬映射「先看内容关系再选图形」(系统→
hub_spoke/分层、流程→flow、层级→树/金字塔、循环→环、互依→mind_map、对比→象限、
≥3数据→图表),卡片阵封顶 ~1/3 页、连画两页网格下一关系页必须上示意图,指回 page_charts。
- svg_preview 加 cairosvg 兜底:find_browser 改返回 None 不抛错;无 chromium 时回退
cairosvg,渲前用 embed_icons 预展开 <use data-icon> 成真 path(避 INVALID_MATRIX);
修 --screenshot 相对路径静默失败(改绝对路径 + 暴露 chromium stderr)。
- 扁平 gate 计入 circle/polyline:svg_quality_checker 图形图元加 <circle>(node/venn/
timeline 是真图,修 21-circle roadmap 误判);文字密集 deck ≥60% 页无图形 → ERROR。
架构结论(svg 目录):svg_output(可编辑源)与 svg_final(自包含编译产物)是两态、不能
合并成一个文件,但只暴露一个——现 svg_output 可见、svg_final 进 .build。终态(下一议题)
干掉持久化 svg_final、finalize 内存化 + web 按需预览,牵涉 web 层,本次未做。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
caoqianming
5bde2445a0