XAvatarWall

✨ 功能特点

将X头像助手.js这个脚本粘贴进篡改猴，然后打开https://x.com/你的用户名/followers

点击开始采集并滚动到最下面，脚本截获了所有头像之后点击导出为TOML文件（文件名形如 avatar_20260817153000.toml）。刷新页面不会丢记录，可用「清空记录」重新开始。

把 TOML 和可执行文件放进同一个文件夹，直接运行即可。不指定 -config 时会自动选用最新的 avatar_*.toml。

程序读取 TOML 里的头像链接并下载到临时目录，拼完即删。也可用 -input-dir 直接从本地文件夹拼图。

最终图片默认输出到当前目录下的 fans_grid.png，也可以用参数覆盖默认行为。

参数	默认值	说明
`-config`	自动	油猴脚本导出的 TOML；不填则选用最新的 `avatar_*.toml`
`-output`	`fans_grid.png`	输出图片路径（固定输出 PNG）
`-proxy`	空（直连）	下载代理，支持 http 和 socks5。自动识别类型
`-input-dir`	空	从本地目录读取头像并拼图（跳过下载）
`-size`	`200`	每张头像缩略图边长（像素）
`-spacing`	`4`	头像间距（像素）
`-bg`	`#ADD8E6`	背景色，支持 `#RRGGBB` / `#RGB`
`-cols`	`0`（自动）	手动指定列数，不填则自动算最接近正方形的行列数
`-dedupe`	`true`	是否启用感知哈希去重
`-threshold`	`2`	去重的汉明距离阈值，越小越严格（越不容易误判为重复）
`-delete-duplicates`	`false`	删除重复源文件（只对 `-input-dir` 有意义）
`-workers`	`16`	并发下载上限（越大越快但更容易被限流）

头像输入支持：jpg / jpeg / png / bmp / gif / webp；拼图输出固定为 PNG，这是为了最终输出的高清。

go build

与原版一致：cols = ceil(sqrt(n))，rows = ceil(n / cols)，即优先保证接近正方形的整体比例。

感知哈希（pHash）判断两张图片“看起来是否相同”，而不要求文件字节完全一致。 -threshold 是汉明距离阈值：

已知局限：pHash 依赖图片的亮度/结构分布来生成指纹，对高信息熵的真实照片（人脸照片、复杂背景）区分度很好；但如果头像本身就是极简图案（纯色块、简单几何图形、扁平风格头像），不同头像之间的哈希距离可能天然就很近，默认阈值下仍可能出现误判。如果你的头像素材偏卡通/极简风格，建议：

本项目基于Mo公共许可证授权