Adventure

🌲 桌面悬浮的「目标树 + 键鼠奖励」小部件
Windows 10 / 11 · 本地存档 · 三个小游戏

Latest release License Platform Python

敲键盘、点鼠标、移动光标会累计操作并周期性开奖;奖励先挂在当前目标上,领进背包后才能花。目标像文件夹一样层层拆解,工作时顺手收集金币、钻石、宝箱和字母。

当前正式版:v1.0.8 · 变更说明见 RELEASE_NOTES.md

• 🎬 演示
• ✨ 亮点
• 🧩 功能说明
• 🚀 快速开始
• 🛠️ 开发
• 🖱️ 使用说明
• 🔒 数据与隐私
• 📚 文档
• 📁 项目结构
• ⚖️ 许可

B站地址:https://www.bilibili.com/video/BV1wfbJ6iExF/?spm_id_from=0.0.upload.video_card.click&vd_source=68ce22f01f3c3394fe4f021266842422

• 同一时间只能有一个「进行中」的大目标
• 有子树时必须选中文件并点「开始运行」才会累计;路径会高亮
• 分解:文件 → 新文件夹 + 多个新文件(旧进度可单独保留)
• 暂停 / 关屏 / 休眠 / 约 10 分钟无操作 → 不计时

目标管理 → 本周:七列(周一〜日)×ばつ 0–24 点。

• 换顶层或换叶子会切段;跨午夜按自然日切开
• 图例按身份配色,对照格子颜色
• 独立日志:%APPDATA%\Adventure\runtime_intervals.json

设计细节:周视图规格

• 操作:按键 / 鼠标按下计 1 次(长按不重复);移动约每 80 像素计 1 次;本窗口与虚拟机内也计入
• 开奖:6〜14 操作一轮;金 / 钻独立;命中后约 8% 暴击(倍率右偏);每 10 分钟重抽概率与金额范围
• 挂账:有子树时奖励记在当前叶子;点领取才进背包;顶栏只显示已进背包的金 / 钻
• 缓动条:独立于开奖格;活跃秒 + 操作÷10;258〜342 秒一轮;满格点领宝箱后再解锁倒计时
• 分段条:彩色格 + 距下次开奖 x/y + 有效概率;最近 3 条历史

概率总览与分布图:docs/probability-design.md

• 资产、统计、完整开奖历史、三个游戏入口
• 宝箱解锁:普通 30 分 → 传奇 8 小时;最多 4 个同时解锁(真实时间,关应用也走)
• 开箱:字母数量几何分布(均值约 2);稀有度按箱子加权;伴生货币右偏

公式与调参:docs/chest-opening-probabilities.md

ESC 结算回背包。主程序用子进程 + JSON 会话通信。

相关设计:前排对撞 · 站位与成长

1. 🔗 打开 Releases
2. 📦 下载 Adventure-vX.Y.Z.zip(如 Adventure-v1.0.8.zip)并解压
3. ▶️ 双击 Adventure.exe

SmartScreen:点「更多信息」→「仍要运行」(exe 未签名)。首次启动解压内置依赖会稍慢。

钻石命中 / 缓动条满格的音效不会随仓库或安装包附带,需自己放到 assets/sounds/diamond/(正式版 exe 则放 _internal/assets/sounds/diamond/)。

推荐 Python 3.12 / 3.13。Python 3.14 必须用 pygame-ce(requirements.txt 已指定)。

install.bat
run.bat

小游戏起不来时可再跑 fix_game.bat。右键菜单可勾选开机自启。

手动:

.venv\Scripts\pythonw.exe run.py

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python run.py

python run.py --game pet <session_in.json>
python run.py --game grid <session_in.json>
python run.py --game word <session_in.json>

.venv\Scripts\python.exe -m unittest discover -s tests -v

tests/test_widget_smoke.py 使用 QT_QPA_PLATFORM=offscreen 做 UI 回归。

build.bat

产物:dist\Adventure\Adventure.exe(需根目录 Adventure.spec)。

非 Windows 无「固定到所有虚拟桌面」;macOS 上 pynput 需辅助功能权限。

• 约每 15 秒自动保存,退出时再存一次
• 损坏时尝试 .bak* / .anchor / .snap.* 恢复,并备份为 data.broken.*.json
• 只计次数,不记录按键内容、坐标或前台应用名;数据仅本机,不上传

data.json 主要字段:inventory、tasks[]、total_operations、roll_runtime、ease_chests、roll_history[]、settings。实际开奖以 roll_runtime 为准;settings 里旧 roll 字段仅供迁移。常量见 src/reward_system.py。

仓库不附带钻石音效,要自己加文件才会在钻石命中、缓动条满格时出声:

正式版 exe 把同样路径放到解压目录的 _internal/ 下(即 _internal/assets/sounds/diamond/)。支持 wav / ogg / mp3 等;部分格式需本机 ffmpeg。右键菜单可开关开奖音效。

完整目录见 docs/README.md (概率图、设计规格、实现计划、协作者速查)。

Adventure/
├── run.py / run.bat / install.bat / build.bat / fix_game.bat
├── Adventure.spec · requirements.txt · LICENSE
├── assets/sounds/ # roll_gold.* ;diamond/ 需自备,仓库不附带
├── docs/ # 概率、开箱、设计规格、demo
├── games/
│ ├── pet_arena.py # 小动物竞技场
│ ├── pixel_tactics.py # 像素格子战场
│ └── word_arena.py # 词汇自走棋
├── tests/ # unittest
└── src/
 ├── main.py · widget.py · models.py · storage.py
 ├── task_manager.py · task_dialog.py · inventory_dialog.py
 ├── reward_system.py · chest_opening.py · ui_roll_bar.py
 ├── runtime_intervals.py · ui_week_runtime.py
 ├── input_monitor.py · game_launcher.py · game_protocol.py
 └── ...

可选:install.ps1。run_game.bat 仅提示用,正常从背包进游戏。

• 做操作的音效,挥剑,魔法,防御等
• 挂机小游戏悬浮窗
• 加点画面反馈

平时只开悬浮窗时负载很低(Windows 上定时器轮询键鼠,不装系统钩子)。开着「任务管理」狂打字可能因重建卡片略顿。小游戏在独立子进程,不拖慢主窗。

GNU General Public License v2.0