# 上班搭子桌宠小助手

**Repository Path**: derekgo/work-buddy-mini

## Basic Information

- **Project Name**: 上班搭子桌宠小助手
- **Description**: 一款陪你上班的桌面小工具。工资计时、今日待办与桌宠陪伴三合一，数据全部保存在本地
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-11-13
- **Last Updated**: 2026-11-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 上班搭子桌宠小助手

一只待在桌面角落陪你上班的小桌宠，顺手把工时、待办和专注进度摆到抬眼就能看见的地方。

> 项目仓库 <https://gitee.com/derekgo/work-buddy-mini>。安装包是仓库里的 `installer/上班搭子桌宠小助手_Setup_v1.3.25.exe`。装完之后日常直接双击运行的程序在 `%LOCALAPPDATA%\Programs\上班搭子桌宠小助手\上班搭子桌宠小助手.exe`。

<!-- 配图位 1：产品主视觉，画面说明见文末「配图位置标注」 -->
![【配图 1】桌宠与主面板同框](docs/images/hero.png)

当前版本 1.3.25，主要面向 Windows 10 和 Windows 11。界面是中文，安装包约 19 MB，装好就能用，不需要另外安装 Python。

## 去哪下载、装完从哪打开

| 要找的东西 | 位置 | 怎么用它 |
| --- | --- | --- |
| 项目仓库 | `https://gitee.com/derekgo/work-buddy-mini` | 打开后进入 `installer/` 目录，或者点页面上的「克隆/下载」 |
| 安装包（下载这个） | `installer/上班搭子桌宠小助手_Setup_v1.3.25.exe` | 双击安装，约 19 MB，装到当前用户目录，不需要管理员权限 |
| 装好后的主程序（日常双击这个） | `%LOCALAPPDATA%\Programs\上班搭子桌宠小助手\上班搭子桌宠小助手.exe` | 直接双击启动，不用再运行安装包 |
| 开始菜单入口 | 开始菜单里的「上班搭子桌宠小助手」 | 点一下启动，和上面是同一个程序 |
| 托盘入口 | 屏幕右下角的小图标 | 右键菜单打开主面板、设置、退出 |
| 个人数据 | `%LOCALAPPDATA%\上班鼓励器` | 设置、待办、随手记都存在这里，覆盖安装不会清掉 |

把 `%LOCALAPPDATA%` 换成自己的用户目录即可，通常是 `C:\Users\你的用户名\AppData\Local`。装好后的完整路径长这样：

```text
C:\Users\Administrator\AppData\Local\Programs\上班搭子桌宠小助手\上班搭子桌宠小助手.exe
```

仓库里只提供安装包，没有解压就能运行的绿色版 exe。自己从源码打包会生成 `dist/上班搭子桌宠小助手/上班搭子桌宠小助手.exe`，这个目录不入库，所以 Gitee 页面上找不到它。

## 这是什么

上班的时候，很多小事记不住：今天这一小时算下来值多少、手头该做哪一件、水多久没喝、专注了几个番茄。这个软件把这些信息收进一块可以缩到屏幕边缘的小面板，再让一只桌宠在旁边陪着。

面板默认很安静。拖到屏幕边上会收成一条细边或者窄栏，双击才展开成完整面板；托盘里留一个小图标，任务栏不会多出一排按钮。桌宠会眨眼、跟着鼠标转头，你敲键盘时几只形象会跟着抬手，鼠标停一会儿才慢慢换个姿势。

所有内容都存在你自己的电脑上。设置、待办、随手记、专注记录都写在本机的 JSON 文件里，软件不上传这些数据，也不读取聊天软件里的消息、通讯录或文件。

## 功能特性一览

下表每个图标对应一项功能，第三列是它能替你省下的那点事。想看细节可以跳到后面的「功能细说」。

| 图标 | 功能 | 核心优点 | 在哪找 |
| --- | --- | --- | --- |
| 🐾 | 八只桌宠形象 | 右键随手换一只，打字会抬手，点一下弹回来 | 桌宠右键菜单、设置页「宠物形象」 |
| 🧲 | 四种窗口形态 | 拖到屏幕边自动收成细条或横条，双击才展开 | 直接拖窗口 |
| 💰 | 收入主卡 | 按自填时薪随真实时间走，抬眼就看到今日数 | 设置页「工资计算」 |
| ⏳ | 下班倒计时 | 工时进度和剩余时间摆在一起，不用自己算 | 主面板 |
| 🎯 | 攒钱目标 | 设一个目标，本月累计和进度条帮你看距离 | 主面板 |
| ✅ | 今日待办 | 面板上敲一行就加上，勾完成自动记进统计 | 主面板 |
| 📌 | 下一步提醒 | 只推一件「现在该做」，点稍后再来它一定会回来 | 主面板「现在该做」 |
| 🍅 | 番茄专注 | 25 / 5 / 15 分钟节奏，能拿一条待办当本轮目标 | 主面板 |
| 💧 | 喝水打卡 | 记杯数和下次提醒时间，记错可以撤销 | 主面板 |
| 🎨 | 四套配色 | 珊瑚粉、薄荷奶绿、蜜柑橙、靛蓝青年，可跟随系统深浅 | 设置页「外观与提示」 |
| 📝 | 随手记 | 文字、图片、视频都能存，按时间回看 | Alt 加 N、主面板「记一笔」 |
| 🔕 | 免打扰时段 | 开会午休静默所有主动提醒，支持跨午夜 | 设置页「提醒」 |
| 💾 | 备份与周报 | 导出 JSON 和工资明细 CSV，一键生成本周汇总 | 设置页「数据与隐私」 |
| ⌨️ | 一键隐藏窗口 | 全局热键收起所有窗口，投屏前按一下 | 设置页「外观与提示」 |
| 🔐 | 数据留在本机 | 设置和记录只写本地 JSON，不上传、不读聊天消息 | 不用设置 |
| 🧭 | 安静常驻 | 只留托盘小图标，任务栏不添按钮；开机自启不弹窗 | 设置页「关于」 |

## 产品特点

功能之外，几个做法上的取舍，决定了它平时会不会碍事。

| 图标 | 特点 | 具体样子 |
| --- | --- | --- |
| 🪶 | 收得住 | 平时缩在屏幕边上只占一条细边，双击才展开；缩着的时候倒计时、待办剩余和下次喝水时间还在 |
| 📌 | 一次一件 | 「现在该做」只摆一件事，做完自动推下一件，离开工位再回来也会提醒 |
| 🔕 | 提醒有分寸 | 气泡默认轻，免打扰时段全部静默，点「稍后再来」会回来且每多推一次明显一点，每天有次数上限 |
| 🧩 | 模块自己挑 | 主面板显示哪几块在设置页勾选，只影响显示，计算口径不变 |
| 💾 | 数据在你手里 | 全部存本机，导出导入按字段合并，不会清掉没包含的项 |
| 🖥️ | 不进任务栏 | 主面板和桌宠窗都不占任务栏和 Alt 加 Tab 的切换列表，托盘留一个小图标就够了 |

## 功能细说

### 桌宠与陪伴

右键桌宠就能换形象，设置页的「宠物形象」里也能挑，还能随机来一只。八只里有小恐龙、敲键盘的水豚、办公男孩和女孩，以及几只风格统一的 Q 版角色。大小在设置里用滑杆调，以脚下为基准缩放，位置不会跳。

水豚的空闲动作和打字动作现在用的是同一套素材，体型、朝向和画风不会突然变样。点一下桌宠会压扁弹回，拖动时会朝运动方向歪一点，几只整帧动画形象还会跟着键鼠动作做出反应。

<!-- 配图位 2：八只形象拼图 -->
![【配图 2】八只桌宠形象](docs/images/characters.png)

### 一块能屈能伸的主面板

完整面板上有收入主卡、工作时间、目标进度、今日待办、番茄专注与喝水、月度汇总、行情卡片和形象切换入口。收入主卡按你填的时薪、上下班时间和午休时长，随着真实时间一秒一秒地走，同时给出下班倒计时和今日工时进度。请假日、今日支出、攒钱目标都能单独设置。

窗口有四种形态，拖到不同位置会自动切换：

| 形态 | 大概长什么样 | 适合什么时候 |
| --- | --- | --- |
| 贴边细条 | 很窄的一条，只留必要的小圆点和提示 | 完全不想被打扰 |
| 侧边窄栏 | 竖着一条，排几个常驻数字 | 想瞄一眼进度 |
| 底部横条 | 横着一行小卡片 | 屏幕下方还有空位 |
| 完整面板 | 所有模块都在 | 坐下来整理今天的事 |

缩图状态下，专注倒计时、待办剩余、下次喝水提醒仍在，下一步提醒会用一个小红点告诉你「现在该做」有内容。加载时的遮罩也跟着形态变，缩成细条时不会硬塞一整块进度界面进来。

<!-- 配图位 3：主面板完整形态 -->
![【配图 3】主面板完整形态](docs/images/main_window.png)

<!-- 配图位 4：四种窗口形态对比 -->
> 【配图 4】四种窗口形态对比图待补，画面说明见文末。

### 待办、下一步提醒和番茄专注

今日待办可以直接在主面板敲一行加进去，勾完成会记进统计。到点的待办会由桌宠和托盘轻轻提醒一次。

「下一步提醒」把待办收成唯一一件「现在该做」。到点、手头这件做完、离开工位再回来，都会把它推到眼前；点「稍后再来」它一定会回来，每多推一次提醒的显著度升一级，每天还有次数上限，划走不会永久丢掉。开会或午休可以设置免打扰时段，支持跨午夜，这段时间里所有主动提醒都静默，桌宠也不会被戳得乱动。

番茄专注支持 25 / 5 / 15 分钟的节奏，可以从待办里选一条当本轮目标，专注阶段自然走完才算一个番茄，跳过不计。喝水卡记录今日杯数和下次提醒时间，也能撤销刚记的那一杯。

<!-- 配图位 7：现在该做、待办、番茄与喝水同框 -->
> 【配图 7】待办与提醒模块截图待补，画面说明见文末。

### 四套配色，跟随系统深浅

珊瑚粉、薄荷奶绿、蜜柑橙、靛蓝青年四套主题，点一下设置页、主面板和桌宠气泡一起换。打开「跟随电脑深浅」后，Windows 切到深色模式会自动套用当前主题的暗色板，切回来再还原。

<!-- 配图位 6：四套主题四宫格 -->
> 【配图 6】四套配色对比图待补，画面说明见文末。

### 随手记

按 Alt 加 N，或者点主面板的「记一笔」，会弹出一个小窗口。文字、图片、视频都能放进去，日后按时间回看。列表里点图片会放大查看，点视频先弹一层确认，确认后才交给系统播放器，取消则什么都不会发生。设置页里可以改呼出快捷键，也可以指定附件存放目录。

<!-- 配图位 8：随手记窗口与图片放大层 -->
> 【配图 8】随手记窗口截图待补，画面说明见文末。

### 提醒、备份和周报

设置页「提醒」里能分别开关久坐、护眼、喝水提醒，还能「发一条试试」确认气泡能正常出现。

「数据与隐私」里可以把配置、历史、待办、速记和番茄统计导出成一个 JSON，之后导入按字段合并，不会清掉没包含的项；工资明细可以导出成 Excel 直接打开不乱码的 CSV；「一键生成周报」会汇总本周工时、收入、待办完成、番茄专注和速记，复制到剪贴板。

### 启动和窗口上的小事

开机自启时只把桌宠和托盘准备好，主面板缩在角落不弹出来打扰。启动过程分三段接上：托盘图标先转圈，桌宠淡入打个招呼，主面板窗口内的加载遮罩按当前形态显示进度。

需要会议投屏或者临时整理桌面时，按一个全局热键就能把所有窗口收起来，再按一次恢复。默认是 Alt 加反引号键，在设置页「外观与提示」里可以换成别的组合，也可以关掉。

重复双击图标不会开出第二个实例，已经运行的那一个会被唤起。

## 安装与运行

### 用安装包（推荐）

1. 打开 <https://gitee.com/derekgo/work-buddy-mini>，进入 `installer/` 目录，下载 `上班搭子桌宠小助手_Setup_v1.3.25.exe`。
2. 双击安装，会装到当前用户目录，不需要管理员权限。
3. 装完从开始菜单点「上班搭子桌宠小助手」，或者双击 `%LOCALAPPDATA%\Programs\上班搭子桌宠小助手\上班搭子桌宠小助手.exe`。
4. 屏幕右下角出现托盘小图标，从托盘菜单打开主面板。

升级时直接覆盖安装即可，原来的设置和记录会保留，它们放在 `%LOCALAPPDATA%\上班鼓励器`，不随安装目录一起替换。界面依赖系统的 WebView2 运行库，Windows 10 和 11 上一般已经随 Edge 装好。

### 从源码运行

```bash
git clone https://gitee.com/derekgo/work-buddy-mini.git
cd work-buddy-mini
pip install -r requirements.txt
python app.py
```

依赖只有 `pywebview>=4.0`。仓库里另有 macOS 的运行入口和打包脚本，目前主要维护 Windows 版，macOS 还没有作为正式安装包分发。

本地执行 `python _tools/source_guard.py build` 会在 `dist/上班搭子桌宠小助手/` 生成 `上班搭子桌宠小助手.exe`。`dist/` 不入库，这个 exe 只在本机出现，从 Gitee 下载仓库时看不到。

<!-- 配图位 5：安装完成后的托盘与主面板 -->
> 【配图 5】安装与首次启动截图待补。

## 第一次打开要做的事

1. 从托盘图标打开主面板，再到设置页「工资计算」填上时薪、上下班时间和午休时长。不填也能用，只是收入数字按默认值算。
2. 到「宠物形象」挑一只顺眼的，回桌面点它一下试试。
3. 在主面板加一条今日待办，看看「现在该做」卡片怎么把它摆到最前面。
4. 把窗口拖到屏幕边缘，试试自动收成细条或者横条，再双击展开。
5. 需要的话，在「外观与提示」里换配色、调桌宠大小、改隐藏窗口的热键。
6. 用顺手之后，到「数据与隐私」导出一份 JSON 存着，重装或换电脑时导入就行。

## 常用操作

| 想做什么 | 怎么操作 |
| --- | --- |
| 打开主面板 | 托盘图标的菜单 |
| 换桌宠形象 | 桌宠右键菜单，或设置页「宠物形象」 |
| 收起 / 展开面板 | 拖到屏幕边缘自动收起，双击缩图展开 |
| 临时收起所有窗口 | Alt 加反引号键，组合可改 |
| 记一笔 | 主面板「记一笔」，或 Alt 加 N |
| 换主题配色 | 设置页「外观与提示」 |
| 设置免打扰 | 设置页「提醒」里的免打扰时段 |
| 备份数据 | 设置页「数据与隐私」里的导出 JSON |

数据保存在本机用户目录的 `上班鼓励器` 文件夹里。这个目录名沿用了产品早期名称，升级不会改名，所以旧记录不会丢。

## 配图位置标注

下面按正文里的编号列出每一处配图该放什么。`docs/images/` 里现有的图来自早期版本界面，发布前建议用 1.3.25 的实拍截图替换，避免图文对不上。

| 编号 | 出现位置 | 画面内容（示意图描述） | 建议文件 | 状态 |
| --- | --- | --- | --- | --- |
| 1 | 开头地址块下方 | 桌面右下角，桌宠与主面板同框，浅色桌面，留出上方空白放标题 | `docs/images/hero.png` | 早期图，建议重拍 |
| 2 | 八只桌宠一节 | 八只形象横向排成两行，下方各标名字，背景干净 | `docs/images/characters.png` | 早期图，建议重拍 |
| 3 | 主面板一节 | 完整面板正面截图，收入主卡、待办、番茄喝水、月度汇总都能看清 | `docs/images/main_window.png` | 早期图，建议重拍 |
| 4 | 四种形态表格后 | 四张窗口截图横排，从左到右细条、窄栏、横条、完整面板，底部标形态名 | 待补 | 需新拍 |
| 5 | 安装与运行一节 | 安装完成后的托盘小图标与首次打开的主面板，带右键菜单 | 待补 | 需新拍 |
| 6 | 四套配色一节 | 同一面板在四套主题下的四宫格，浅色深色各一组 | 待补 | 需新拍 |
| 7 | 待办与提醒一节 | 「现在该做」卡片、今日待办、番茄与喝水卡同框，右侧留一个气泡示意 | 待补 | 需新拍 |
| 8 | 随手记一节 | 随手记小窗口，列表里有一张图片缩略图，旁边是点开后的放大层 | 待补 | 需新拍 |

暂时没有截图时，配图 4 可以这样画：一张宽图分四栏，每栏一个窗口轮廓，宽度依次递增，栏内用几根灰色横线代表内容，细条那一栏只画一个小圆点，完整面板那一栏画出几张卡片，栏底写形态名。配图 6 用四个同尺寸面板轮廓，只换主色和底色。这类示意图不需要真实数据，用中性占位数字即可。

### 不同平台的取用方式

Gitee 或 GitHub 上本文可以直接作仓库首页，图片放 `docs/images/`，更新历史放 `CHANGELOG.md`。「功能特性一览」那张表单独截成一张长图，放在开头比纯文字更好扫。公众号适合取「这是什么」「功能特性一览」「安装与运行」三段，配图用 1、2、4，去掉代码块和表格里的技术细节。小红书适合一段场景化开头加三张图（主视觉、四形态、四套配色），正文控制在几百字，不放二维码、外链和行情相关表述。

## 数据与隐私说明

设置、待办、随手记、专注记录、导出的备份都只写在本机。软件不上传这些数据，不读取聊天软件的消息内容、通讯录或本地文件，也不做歌词或播放状态同步。

有两处会访问网络：行情卡片从公开行情接口取数据，「关于」里的检查更新会比对版本号。不使用这两项功能就不会产生对应请求。

## 说明与免责

收入主卡按你自己填的时薪、工时、午休和请假参数估算，用来看看进度，不作为工资、财务或报税依据。行情卡片的数据来自公开接口，可能出现延迟或暂时取不到，仅供查看，不构成投资建议，也不涉及任何交易功能。

一键隐藏请用在会议投屏、临时整理桌面这类场景，并遵守所在单位对设备和软件使用的规定。

桌宠形象是项目自制的图集。在公开平台二次分发时，请自行核对素材授权和各平台的内容规范。

## 反馈与协议

遇到问题可以到 Gitee 仓库提 issue，附上版本号、Windows 版本和一张截图，定位会快很多。

本项目采用木兰宽松许可证第 2 版（MulanPSL-2.0），详见仓库根目录的 `LICENSE`。