Window Sweaters 是一款 macOS 菜单栏应用，能给每个窗口织上针织毛衣边框，让桌面更有温度。除了点击菜单栏图标，它还隐藏了一个强力的sweatersrc启动脚本：一份脚本就能批量设置针织风格、纱线颜色、边框宽度与应用黑白名单，不必再逐项点选菜单。

sweatersrc 启动脚本的工作机制

每次启动时，Window Sweaters 会依次在两个位置寻找启动脚本：

1. ~/.config/window-sweaters/sweatersrc（优先）
2. ~/.sweatersrc

找到后即用sh执行，相关实现在 src/misc/helpers.h 中，有三个值得注意的细节：

• 文件没有可执行权限时会自动补上，无需手动chmod +x；
• 脚本运行时长被限制为 60 秒，避免拖慢启动；
• 如果你是用命令行参数启动应用的，脚本会被跳过，调用点在 src/main.c。

一句话概括：sweatersrc 就是你希望每天打开 Window Sweaters 时自动生效的那份"开机设置"。

批量下发参数：命令行与菜单是同一套参数

所有菜单功能在 src/parse.c 中都被解析为key=value参数，比如：

"/Applications/Window Sweaters.app/Contents/MacOS/WindowSweaters" \ width=14 \ active_color=0xffd58561 \ chart=zigzag \ whitelist=Firefox,Slack

三个关键行为：

• 已有实例在运行时：新进程会把参数通过内部 Mach 消息转发给运行中的实例然后退出，所以"重复启动"不会出错，运行中的实例会直接重新绘制；
• 没有任何实例时：会带着这些设置直接启动（可执行文件名为WindowSweaters，见 AppInfo.plist）；
• 应用已在运行却没传有效参数：会提示A Window Sweaters instance is already running and no valid arguments were provided。

应用黑白名单：最常用的两个参数

• 多个应用用英文逗号分隔，按应用进程名匹配；
• 两个参数可同时使用，先判白名单再判黑名单；
• 设置会立即重建所有边框，保存后马上生效。

提示：菜单栏Apps里的勾选和命令行黑白名单是两套独立的过滤，一个窗口必须同时通过两层检查才会被套上毛衣，说明见 CONTRIBUTING.md。

一份完整的 sweatersrc 示例

把下面内容存到~/.config/window-sweaters/sweatersrc，下次打开 Window Sweaters 即自动完成"只给 Firefox 和 Slack 织毛衣、12 点宽边框、非聚焦窗口稍作压暗"：

#!/bin/sh SWEATER="/Applications/Window Sweaters.app/Contents/MacOS/WindowSweaters" # 参数会转发给运行中的实例，无需先退出应用 "$SWEATER" \ whitelist=Firefox,Slack \ chart=zigzag \ width=12 \ dim=0.4

修改后重启 Window Sweaters 即可应用；也可以不写脚本，在终端里临时执行上面这段参数完成一次性调整。

常用参数速查

内置图案包括by-app、zigzag、picnic、twinkle等，完整毛线样式集可翻阅 docs/COLLECTION.md；你还可以把自制的 PNG 图表放进~/Library/Application Support/Knit Borders/charts/，再用charts=reload加载。

颜色的最终优先级：apps.conf里的规则永远优先，例如Claude = #D58561 atelier-claude；规则名按应用名前缀匹配、不区分大小写、最长匹配获胜（见 src/misc/apps.h）。

动手前的 3 个注意事项

1. sweatersrc 只在启动时执行一次，且当天未传命令行参数时才会运行，不会在运行中途重放；
2. 参数是"推送"模型：编辑脚本后重启应用，或在终端临时下发参数即可，两者都不需要杀掉进程重装；
3. 脚本有 60 秒时限，保持脚本轻量，重活留给其它工具。

至此，Window Sweaters 的命令行进阶就这些：一份sweatersrc搞定批量设置，一行whitelist=/blacklist=搞定应用黑白名单，窗口毛衣从此完全由你掌控。 🧶