Windows 桌面陪伴与护眼助手。 一只可以互动的白鼬伙伴，加上 Windows 夜间模式入口、软件调暗、休息提醒和专注工具，陪你学习、写作和办公。
无需账号，核心功能离线运行。免费开源，支持 Windows 10 / 11。
A Windows desktop companion with Windows Night Light access, independent screen dimming and break reminders.
当前体验版：v0.10.0b14。新增“继续计时并提醒”和“暂停计时”两种全屏休息行为；手动调暗默认关闭，色温由 Windows 夜间模式管理。保留新版界面、低亮度休息场景和右键菜单；宠物除“摸摸头”“玩一会儿”外，恢复 v0.9 的动作。需要稳定版可下载 v0.9.0「百变衣橱」。测试版不替代稳定版。
伙伴小屋把休息操作、屏幕状态和常用工具放在一起。亮色采用灰蓝与灰绿底面，休息提醒有单独的低亮度场景。
截图由当前版本的真实 Qt 控件离屏渲染，倒计时和显示状态为演示数据。
看看暗色界面和休息场景
主窗口与休息截图由当前版本的真实 Qt 控件离屏渲染；倒计时和显示状态为演示数据，不表示物理屏幕效果已开启。
“摸摸头”和“玩一会儿”保留新版动作；其他姿态沿用 v0.9，右键打开功能菜单。
| 场景 | 功能 |
|---|---|
| 想让桌面有一点陪伴 | 白鼬“鼬鼬”会回应点击与拖动；右键可互动、重置位置或关闭伙伴，衣橱提供 13 套完整造型。 |
| 长时间盯着屏幕 | 配置短休息、长休息与活动加权节奏，选择渐进、全屏或严格提醒；可开始、延后或跳过本次休息。 |
| 夜间阅读或办公 | 从软件打开 Windows 夜间模式，强度与定时在系统设置中调整；软件调暗需要手动开启和调整。 |
| 需要专心一段时间 | 使用专注计时和背景暗化；全屏、演示、锁屏等情境下按规则暂停或让出。 |
| 需要降低屏幕亮度 | 手动开启调暗并调整滑块；不会随时间或应用切换明暗，退出后移除软件遮罩。 |
| 全屏使用时 | 自己选择继续计时并提醒，或暂停计时；退出全屏后接着剩余时间继续。 |
| 随手处理小事 | 从托盘打开倒计时、本地便签和电脑状态。 |
- 在 版本发布页 选择安装版或便携版。安装版可创建快捷方式；便携 ZIP 解压后运行
OpenCareEyes.exe。 - 首次启动按欢迎流程选择桌面伙伴、休息节奏和开机自启。全部设置之后都可以调整。
- 程序驻留托盘：左键图标打开或收起伙伴小屋，右键访问休息、暂停、伙伴和小工具。
宠物操作：单击互动，长按或移动后拖动，右键打开菜单。选择“关闭桌面伙伴”后，可以在托盘重新勾选“显示桌面伙伴”；休息提醒仍继续计时。
发布页附有 SHA256SUMS.txt，可核对下载文件：
Get-FileHash .\OpenCareEyes_Setup_0.10.0b14.exe -Algorithm SHA256
Get-Content .\SHA256SUMS.txt首次运行可能出现 Windows SmartScreen 提示。请核对项目发布页和校验值；校验值不能代替代码签名。详细安装、设置与排错步骤见 使用说明。
- 色温交给 Windows：移除自定义色温滑块，屏幕页、首页、托盘和原色温快捷键打开系统夜间模式。旧色温设置及失败回退不再写入屏幕色彩曲线。
- 调暗手动控制：默认关闭，只保留开关和滑块；时间与应用切换不会改变调暗。关闭软件显示效果不修改系统夜间模式。
- 动作选择回归：原版与蓝围巾的“摸摸头”“玩一会儿”保持 b10 的画面和节奏；其他动作取回 v0.9 原始素材与时序，撤下新版多方向注视、阅读、挥手与懒腰造型。
- 右键保留菜单：互动、重置位置、关闭伙伴及键盘操作继续可用，不恢复旧右键动画。
- 原版图标恢复：继续使用 v0.9 蓝色眼睛图标；安装器为桌面和开始菜单使用独立图标文件名，避开此前设计使用的旧路径。
- 保留界面升级：四项导航、柔和配色、首页常用操作、按需展开的设置和低亮度休息场景继续保留。
全屏休息说明 · 手动调暗说明 · 色温调整说明 · 动作回滚说明 · 界面与操作说明 · 完整更新记录
关闭宠物，会停止休息提醒吗？
不会。关闭伙伴只隐藏桌面角色；休息节奏和屏幕偏好单独控制。需要暂时停止所有效果和提醒，可从托盘使用“暂停全部”。
现在怎样调整色温？
打开“屏幕与休息 → 屏幕”，点击“打开 Windows 夜间模式”，在系统页面设置开启状态、暖色强度和定时。自 v0.10.0b12 起停止软件自己的 Gamma 调色；暂停或退出软件也不改变 Windows 夜间模式。
可以导入其他宠物或用 Live2D 吗？
当前版本使用随软件发布的官方 PNG 图集宠物包，不提供第三方宠物导入或 Live2D 运行时。衣橱可切换内置完整造型；缺少某个动作的造型会禁用对应互动。
- 不创建账号，不含广告或遥测；不保存鼠标轨迹、窗口标题、前台应用历史或宠物互动次数。
- 核心功能离线运行；屏幕调暗不使用定时任务或应用例外自动切换。
- 只有主动点击“检查更新”才访问 GitHub，不在启动或后台检查，不自动下载安装。
- 便签本地保存，正文不进入运行日志或诊断包；应用例外只保存 EXE 文件名。
OpenCareEyes 用于屏幕舒适度调节和休息习惯提醒，不是医疗器械，不承诺治疗眼病或减少蓝光伤害。安全问题请按 SECURITY.md 报告，不要在公开 Issue 中附上个人信息。
准备 Python 3.10 或更新版本，在 Windows 上执行：
git clone --branch main https://github.com/Odyphus/OpenCareEyes.git
cd OpenCareEyes
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .
python -m opencareyes开发与构建：
python -m pip install -e ".[dev,build]"
python -m ruff check src tests scripts
python -m pytest
build.bat项目采用 src/ 布局，先安装包再运行。pyproject.toml 是版本与运行依赖的唯一来源；仅构建便携程序可用 build.bat --exe-only，安装器需要 Inno Setup 6。
| 部分 | 实现 |
|---|---|
| 桌面界面 | Python、PySide6 / Qt Widgets |
| 宠物 | 声明式 JSON、透明 PNG / 2x 图集、有界缓存 |
| 显示与情境 | Windows 夜间模式入口、Win32 原生事件、透明遮罩 |
| 日程与配置 | Astral、本地 QSettings，配置 schema v7 |
| 打包 | PyInstaller、Inno Setup、GitHub Actions |
贡献前请阅读 CONTRIBUTING.md。深入了解可查看 产品说明、设计规范 和 发布指南。main 是当前源码分支，master 仅保留迁移提示。
项目采用 Apache License 2.0。Windows 二进制包含的第三方组件、素材来源与随附许可见 THIRD_PARTY_NOTICES.md。