SimoneScoop / Stardew-Desk

# Stardew Desk 🌱
把《星露谷物语》的农场铺到电脑桌面上（Mac 和 Windows）：季节跟着真实月份走，天气是实时的，有昼夜、动物、会长大的作物、来访的村民。
桌面图标照常点、照常拖；闲置一会儿，农场铺满全屏当屏保。
*A living Stardew Valley farm as your macOS or Windows desktop wallpaper and screensaver. Real-time seasons, live weather,
day and night, animals, growing crops, visiting villagers, a pomodoro "focus farming" mode and the game's seasonal music.
It ships no game assets: on first launch it reads them from your own copy of the game. UI in Chinese.*
> **这是粉丝自制的非官方小工具，和 ConcernedApe 无关。** 仓库里只有代码和几张运行截图，不含任何从游戏里取出的贴图、地图或音乐文件，
> 需要你电脑上装着正版《星露谷物语》（Steam / App Store / GOG 均可）。
 春 · 夏（下雨）· 秋（大风）· 冬夜（下雪） 
---
## 能做什么
| | |
|---|---|
| 🗓 **四季与昼夜** | 季节跟随真实月份，光照按日出日落变化，晚上窗户和路灯会亮 |
| 🌦 **实时天气** | 取所在城市的实时天气（Open-Meteo），晴、阴、雨、雷雨、雪、雾、大风；断网时按季节随机。城市在 天气 › 更换城市… 里自己输入，没设置时按时区自动选（中国默认杭州） |
| 🐔 **动物与小动物** | 鸡、牛白天出来吃草；蝴蝶、鸟、萤火虫、青蛙、松鼠，鼠标靠近会被惊动 |
| 🐶 **宠物** | 6 种猫、6 种狗可选；鼠标在桌面上停下时，宠物会跑过去坐在旁边 |
| 🌾 **按游戏规则长的作物** | 生长阶段、再生、季节都取自游戏数据；洒水器、稻草人按游戏的覆盖范围自动布置 |
| 🧑‍🌾 **来访村民** | 刘易斯、罗宾、皮埃尔、艾米丽、威利、莱纳斯会不时走进农场 |
| 🍅 **专注种田** | 25 / 50 分钟番茄钟：专注期间一块田从种子长到成熟，结束时收获并计入当天的出货 |
| 📋 **公告板** | 农场上的公告板贴着今日待办；填上上下班时间（和日薪）后，常驻显示「下班倒计时」和「今日已挣」，下班时发通知 |
| 📬 **新文件提醒** | 桌面或「下载」里出现新文件时，信箱上方冒出信封（只比对文件名，不读内容） |
| 🛠 **自己布置** | 拖动农舍、鸡舍、畜棚、马厩、作物田、树和小物件；新增或删除作物田；画石板路、围栏、路灯 |
| 🐴 **马厩里的「马」** | 把一个文件夹图标换成马，放进马厩的棚子里，看起来就像马站在马厩里 |
| 🖥 **屏保** | 闲置后农场铺满全屏，镜头慢慢巡游，右上角是游戏原版时钟面板 |
| 🎵 **四季配乐** | 可选，播放游戏本身的春夏秋冬配乐，和游戏里一样一首放完安静一会儿再放下一首 |
## 安装
> 下面先讲 Mac，Windows 版见 Windows 版。
### 方式一：下载做好的 App（推荐，不用碰代码）
1. 在本仓库的 Releases 页面下载 `Stardew-Desk-Mac.zip`，解压。
2. 把 **Stardew Desk.app** 拖进「应用程序」。
3. 第一次打开：右键点它 →「打开」→ 再点「打开」。
 macOS 15 及以后：先双击一次（会提示无法打开），然后去 **系统设置 → 隐私与安全性**，在最下面点「仍要打开」。
 App 没有经过 Apple 公证，所以 macOS 会问这一次，以后双击就行。
4. 弹出的设置窗口会自动找到星露谷，从游戏里读取画面（约 2 MB，半分钟左右）；找不到的话按提示选一下游戏位置。
5. 勾一下要不要四季配乐，点「开始」。
### 方式二：从源码安装
不需要 Xcode、Node 或 Homebrew，只用 macOS 自带的工具（`osacompile`、`codesign`）。
1. 点本页右上角的 **Code → Download ZIP** 下载并解压，或者 `git clone`。
2. 双击 **安装或更新.command**。它会把 App 打包到 `~/Applications/Stardew Desk.app` 并启动。
 - 第一次双击如果提示「无法打开」，右键 →「打开」即可（macOS 15：去「隐私与安全性」点「仍要打开」）。
 - 如果提示没有权限执行，在「终端」里进到这个文件夹运行 `sh mac/install.sh`，效果一样。
3. 之后改了代码，再双击一次就是更新；也可以在菜单栏叶子菜单 → 更多 →「更新到最新版本」。
想发给朋友：双击 **打包分享版.command**，桌面上会出现 `Stardew-Desk-Mac.zip`，里面只有 App 和一份使用说明，不含任何游戏素材。
## Windows 版
和 Mac 版是同一个农场、同样的功能（季节、天气与城市、宠物、屏保、公告板、专注种田、四季配乐），
控制菜单在任务栏右下角的 🍃 图标里（左键右键都行；看不到的话点任务栏上的「^」）。
1. 在 Releases 页面下载 `Stardew-Desk-win.zip`（约 110 MB，里面是程序本身，不含游戏素材），解压到一个固定的文件夹。
2. 双击 **Stardew Desk.exe**。第一次如果弹出蓝色的「Windows 已保护你的电脑」，点「更多信息」→「仍要运行」
 （没有买代码签名证书，只会问这一次）。
3. 设置窗口会自动在 Steam / GOG 的常见位置找到星露谷，读取画面约半分钟；找不到就点按钮选一下游戏文件夹。
4. 叶子菜单 → 天气 → 更换城市…，输入你所在的城市。
- 需要 Windows 10 / 11（64 位）和 Steam 或 GOG 版的星露谷；Xbox / 微软商店版的游戏文件被系统锁着，可能读不到。
- 画面、设置、日志在 `%APPDATA%\Stardew Desk`；叶子菜单 → 更多 →「打开日志文件夹」。
- **Windows 版刚发布，测试过的机器还不多。** 如果桌面上看不到农场或者是黑的，先试 叶子菜单 → 更多 → 桌面显示方式 →「兼容模式」；
 还不行的话欢迎在 Issues 里附上日志反馈。
## 使用
农场铺在系统壁纸之上、桌面图标之下，系统壁纸本身不会被改动。🍃 是控制菜单（Mac 在菜单栏右上角，Windows 在任务栏右下角）：
 [code] 
**设置窗口**里是同一个农场，按屏幕比例显示，改动会实时同步到桌面：
- **布置 → 调整布局**：拖动建筑、作物田、树和小物件（按格吸附，绿框