技能介绍

你要解决的其实是“蒙版语义”问题

做词云并不难，难的是形状词云一上手就翻车：给了一个爱心/星形/文字蒙版，结果词偏偏不落在形状内部，或者出来只剩一圈空心轮廓。根因在 wordcloud 1.9.x 对蒙版的消费方式：它把蒙版当基线偏移，采样器会偏好“累积占用最低”的区域，导致词实际落在 mask==0。这个技能把规则固化成默认行为：形状内部设为 0、外部设为 255。

它如何工作：输入、形状、配色、密度

输入：--input 支持 .json（[{"word","weight","category"?}]、{词: 权重} 或 {词: {weight, category}}）与 .txt（原始文本自动分词计数，有 jieba 用分词，否则正则切分）。
形状：--shape 内置 14 种模板（heart/circle/star、几何图形、ring/cloud/drop/arrow、text 文字蒙版、rect 矩形、custom 自定义图片蒙版）。custom 用 --mask-mode auto|light|dark|alpha 判断朝向。
配色：带 category 时用 --colors（类别→[r,g,b]）或 --theme；无分类则走 --colormap/--theme。
密度：词少时用 --repeat 让小字补空隙；词云内部文字覆盖率约 30% 即可成形，不是实心块。
照片蒙版：给普通照片时加 --auto-cutout，先抠图成透明 PNG 再当蒙版；模型首次运行会下载缓存。

适用边界与注意点

中文 CJK 文字蒙版受笔画宽度限制，成品多为细小杂点；要做“德恒无锡/腾讯/阿里巴巴”这类品牌词云，推荐 --shape rect 或 circle，用极高权重呈现大字，而不是把字当形状挖空。
.txt 的 --stopwords 与 --userdict 只在分词模式下生效；.json 是显式词表，不做过滤。
输入容错会跳过缺 word、非数字或非正 weight 的条目并告警；--colormap 非法时回退 tab10。