watercolor-svglisted

# Watercolor SVG 生成手绘水彩质感的矢量插画：纸纹、湿边、颗粒沉淀、断续干边、放射笔触。 ## 核心原则 **算法已经写好并验证过，不要重写。** `scripts/watercolor.js` 是经 6 轮目视迭代收敛的结果——每个 alpha、每个 rim 参数都调过。从零手写 SVG 水彩必然退化成"钢笔描边的色块"。你的工作是**选型、调参、验收**，不是重新发明。 ## 工作流 ```bash # 1. 看有什么 node scripts/watercolor.js --list # 2. 出图（同 seed 永远同一张） node scripts/watercolor.js --form hibiscus --palette indigo --seed 20863 --out flower.svg # 3. 渲染成 PNG —— 必须看图，不看就等于没做 scripts/render.sh flower.svg flower.png 1200 # 没装 Chromium 内核浏览器时脚本会退出码 3 并说明； # 此时直接在浏览器打开 .svg 目视检查，别跳过验收 # 4. 读 PNG，走验收清单。不合格→查对照表调参→回到 2 ``` 挑不定 seed 就一次出几个再选：`--seeds 7,41,20863,4174 --out f.svg` ## 验收清单（读 PNG 逐条核对，缺一条就要调） | # | 要看到 | 不合格的样子 | |---|--------|-------------| | 1 | 边缘线**断续**、两端渐隐、深浅不一 | 一圈均匀的"钢笔描边" | | 2 | 花心深但**有透明感**，能看出结构 | 一坨死黑墨团 | | 3 | 放射笔触止于瓣长 ~70%，外半瓣是干净洗染 | 全长射满 → 像羽毛球/菊花 | | 4 | 纸色留白**含蓄**，只是笔触间的缝 | 刺眼白条 → 车轮辐条 | | 5 | 至少**两个可辨的色层**（背瓣 vs 主瓣） | 通片一个色，平 | | 6 | 纸纹和颗粒沉淀肉眼可见 | 光滑得像填充图形 | | 7 | 花占画面 60–75%，四周有留白 | 撑满出血 / 缩成小点 | ## 症状 → 调什么 | 症状 | 参数 | |------|------| | 花太大/太小 | `--scale 0.85` / `1.1` | | 位置偏 | `--cx --cy`（按 600 基准坐标） | | 整体太深/太脏 | 该花型 ring 的 `wash.alpha`、`center.alpha` 降 20% | | 中心黑洞 | `center.count`↓ `center.alpha`↓，`veinN`↓ | | 星芒太长太密 | `veinLen:[0.25,0.5]`、`veinN:[4,6]` | | 边缘像描边 | `rim` 数量↑而 `rimAlpha`↓（靠叠加不靠加深） | | 想要更"湿" | `wash.bleed`↑、`spread`↑ | 花型/色板都在脚本顶部的 `FORMS` / `PALETTES` 里，直接改或用 `--config x.json` 覆盖。改法与全部参数含义见 [references/tuning.md](references/tuning.md)。 ## 内置 **花型** hibiscus（木槿，5 瓣 + 长蕊柱）· poppy（虞美人，4 褶皱大瓣