OpenSkillIndex← back to search
claude-codeopenclawproductivity

Skills mac-wallpaper-changer

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/akayj/mwc" ~/.claude/skills/openclaw-skills-mac-wallpaper-changer && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/akayj/mwc" ~/.openclaw/skills/openclaw-skills-mac-wallpaper-changer && rm -rf "$T"
manifest: skills/akayj/mwc/SKILL.md
tags
#macos#automation#wallpaper#scripting#image-management
source content

Mac 壁纸随心换

自动为 macOS 更换高质量壁纸，通过评分学习偏好并智能推荐。

环境要求

  • macOS
  • uv（用于运行 Python 脚本）

脚本一览

脚本作用
scripts/change.py
换壁纸
scripts/recommend.py
推荐壁纸
scripts/preference.py
偏好管理（评分 + 统计）
scripts/loc.py
位置配置
scripts/daily.py
每日自动（cron 用）

图源优先级

Unsplash → Bing → Picsum（可用 

--source
强制指定）

Unsplash 画质更高且支持主题搜索，始终作为首选；Bing 每日精选作为兜底；Picsum 为最终保底。

核心命令

# 换壁纸（Unsplash 随机高清图）
uv run scripts/change.py
# 换壁纸（Unsplash 主题搜索）
uv run scripts/change.py --query "Shanghai rain"
uv run scripts/change.py --category mountain --file ~/Pictures/x.jpg

# 偏好管理（无参数=列出评分）
uv run scripts/preference.py
uv run scripts/preference.py add              # 对当前壁纸评分
uv run scripts/preference.py add path/to.jpg  # 对指定文件评分
uv run scripts/preference.py set 3 9          # 第 3 条改为 9 分
uv run scripts/preference.py del 5            # 删除第 5 条
uv run scripts/preference.py stats            # 完整统计报告

# 推荐壁纸
uv run scripts/recommend.py
uv run scripts/recommend.py -y   # 自动应用
uv run scripts/recommend.py -n   # 仅显示

# 位置
uv run scripts/loc.py
uv run scripts/loc.py --set-location "北京"

数据存储

~/wallpaper-daily/
：
YYYY-MM-DD/
壁纸、
preferences.parquet
评分、
logs/

Cron

30 10 * * * cd /path/to/mac-wallpaper-changer && uv run scripts/change.py

References & Assets

路径说明
references/wallpaper-sources.md
壁纸源配置（Bing/Unsplash/Picsum）
references/embedding-config.md
Embedding 配置 Schema 与提供商说明
assets/embedding-config.template.json
Embedding 配置模板（高级智能推荐用）

高级智能推荐（规划）：基于 embedding 的语义相似度推荐，复制 

assets/embedding-config.template.json
并填入 
api_key
等。

故障排查

  • 壁纸不生效：脚本已处理 Tahoe 26+，使用 killall WallpaperAgent
  • 未刷新：系统设置 > 墙纸 > 在所有空间中显示
  • 日志：
    tail -f ~/wallpaper-daily/logs/change-*.log