saragordic/window-sweaters
# Window Sweaters 学习卡
一、一句话定位
一款给 Mac 窗口“织毛衣”的趣味美化工具，用针织风格边框和手调配色让桌面更温馨。
二、核心技术/架构亮点
- 基于 JankyBorders 构建，使用私有 macOS 窗口 API 绘制边框。
- 内置 37+ 应用的手调配色方案，按应用名匹配规则自动套用。
- 菜单栏图标控制样式（By App / Zigzag）、边框粗细、针脚大小。
- 支持配置文件（apps.conf + charts/）自定义规则和替换针织图案。
- 构建脚本简单，提供测试、目录渲染和基准测试命令。
三、适用场景与目标用户
- 喜欢个性化桌面的 Mac 用户，追求“ cozy”视觉体验。
- 对 macOS 窗口管理、私有 API 或桌面增强工具感兴趣的开发者。
- 想从趣味项目入手理解系统级 UI 绘制的学习者。
四、可动手动作
- 克隆仓库：`git clone https://github.com/saragordic/window-sweaters.git`。
- 自行构建安装：执行 `./scripts/build-app.sh` 和 `python3 scripts/install-local.py`。
- 修改 `~/Library/Application Support/Knit Borders/apps.conf`，按 `AppName = #颜色 图案名` 添加规则。
- 运行 `make test`、`make catalogue` 或 `make bench` 体验开发流程。
- 也可直接通过 Homebrew 安装体验。
五、学习优先级
- P0（本周动手）：clone 并自行构建运行，边玩边读源码，项目小、上手快。
- P1（排期）：精读 JankyBorders 源码，理解窗口边框渲染原理。
- P2（观念了解）：了解 macOS 私有 API 和 Accessibility 权限的合规边界，避免滥用。
- P3（略读）：翻阅配色目录，作为 UI 配色灵感即可。⌂