{"id":33608411,"url":"https://github.com/nikkigallery/whimbox","last_synced_at":"2026-02-05T04:03:51.911Z","repository":{"id":314827906,"uuid":"1056429659","full_name":"nikkigallery/Whimbox","owner":"nikkigallery","description":"奇想盒Whimbox，基于大语言模型和图像识别技术的AI智能体，辅助你游玩无限暖暖！","archived":false,"fork":false,"pushed_at":"2026-01-12T08:30:39.000Z","size":271027,"stargazers_count":222,"open_issues_count":8,"forks_count":17,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-12T17:16:11.720Z","etag":null,"topics":["auto-play-game","automatic","infinity-nikki","infinitynikki"],"latest_commit_sha":null,"homepage":"https://nikkigallery.vip/whimbox/intro","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nikkigallery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-14T04:27:46.000Z","updated_at":"2026-01-12T08:03:12.000Z","dependencies_parsed_at":"2025-10-15T18:41:27.607Z","dependency_job_id":"525f3c1d-6f19-448e-a9ad-31485d350f75","html_url":"https://github.com/nikkigallery/Whimbox","commit_stats":null,"previous_names":["nikkigallery/whimbox"],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/nikkigallery/Whimbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikkigallery%2FWhimbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikkigallery%2FWhimbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikkigallery%2FWhimbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikkigallery%2FWhimbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikkigallery","download_url":"https://codeload.github.com/nikkigallery/Whimbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikkigallery%2FWhimbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28565873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T08:53:44.001Z","status":"ssl_error","status_checked_at":"2026-01-19T08:52:40.245Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-play-game","automatic","infinity-nikki","infinitynikki"],"created_at":"2025-11-30T18:01:28.662Z","updated_at":"2026-02-02T10:18:08.125Z","avatar_url":"https://github.com/nikkigallery.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](/docs/logo.png)\n~~不会画画，先放个红温星在这里凑合一下~~\n# Whimbox · 奇想盒\nWhimbox，基于大语言模型和图像识别技术的AI智能体，辅助你游玩无限暖暖！\\\n想了解更多？请前往[奇想盒主页](https://nikkigallery.vip/whimbox/)\n\n## 如何运行\n（启动器已经上线，也可以通过启动器一键运行，[启动器项目地址](https://github.com/nikkigallery/WhimboxLauncher)）\n1. 本项目仅支持python3.12，请先自行下载安装\n2. 下载Releases中的最新whl包\n3. 一键安装刚刚下载的whl包\n```shell\npip install whimbox-x.x.x-py3-none-any.whl\n```\n4. 运行如下命令，初始化项目，会自动创建configs，scripts文件夹\n```shell\nwhimbox init\n```\n5. 将 [跑图路线仓库](https://github.com/nikkigallery/WhimboxScripts) 中的路线脚本下载下来，放到`scripts`目录里\n6. 打开游戏，将游戏的分辨率设置为标准的16:9，比如：1920x1080、2560x1440（4k分辨率有些功能无法使用）\n7. 用管理员权限运行如下命令，启动奇想盒\n```shell\n# 完整启动奇想盒\nwhimbox\n# 或仅运行一条龙\nwhimbox startOneDragon\n```\n更多使用教程请看[奇想盒使用文档](https://docs.qq.com/doc/DRUJnU0ZPY0VHQ3lD)\n\n## 已有功能\n* 每日任务\n    * 临取小月卡\n    * 美鸭梨挖掘\n    * 完成朝夕心愿\n    * 消耗体力\n    * 收集星海星光结晶\n    * 完成星海拾光\n    * 完成奇迹之冠巅峰赛\n    * 领取大月卡\n* 自动触发\n    * 自动对话、自动采集、自动钓鱼、自动清洁跳过、自动芳间巡游\n* 自动跑图\n    * 跑图路线录制、编辑\n    * 自动跑图（暂时只支持大世界和星海）\n    * 支持采集、捕虫、清洁、钓鱼、变大等等能力\n* 录制宏\n    * 录制操作和播放操作（不支持视角转动的操作）\n* 自动演奏\n    * 将midi转化为宏，进行自动演奏\n* AI对话\n    * 通过自然语言编排以上所有功能\n\n## 未来计划\n1. 全新的UI和agent架构，向更全能的游戏助手进化（开发进度50%）\n2. 支持云电脑、支持远程控制\n3. 自动家园\n\n## 注意事项\n* Whimbox不会修改游戏文件、读写游戏内存，只会截图和模拟鼠标键盘，理论上不会被封号。但游戏的用户条款非常完善，涵盖了所有可能出现的情况。所以使用Whimbox导致的一切后果请自行承担。\n* 由于游戏本身已经消耗PC的大量性能，图像识别还会额外消耗性能，所以目前仅支持中高配PC运行，功能完善后会开发云游戏版本。\n* Whimbox目前仅支持标准16:9和16:10分辨率运行的游戏。\n\n## 致谢\n感谢各个大世界游戏开源项目的先行者，供Whimbox学习参考。\n* [原神小助手·GIA](https://github.com/infstellar/genshin_impact_assistant)\n* [更好的原神·BetterGI](https://github.com/babalae/better-genshin-impact)\n\n感谢chatgpt、cursor、claude等各种AI模型和AI编程工具\n\n## 加入开发\n项目还有大量功能需要开发和适配。如果你对此感兴趣，欢迎加入一起研究。开发Q群：821908945。\n\n### 项目结构\n```\nWhinbox/\n├── whimbox/                        \n│   ├── ability/                  # 能力切换模块\n│   ├── action/                   # 动作模块（拾取、钓鱼、战斗等等）\n│   ├── api/                      # ocr，yolo等第三方模型\n│   ├── assets/                   # 地图、UI截图、游戏图标、配置文件等资源\n│   ├── common/                   # 公共模块（日志、工具等等）\n│   ├── config/                   # 配置模块\n│   ├── dev_tool/                 # 开发工具\n│   ├── ingame_ui/                # 游戏内聊天框\n│   ├── interaction/              # 交互核心模块（截图、操作）\n│   ├── map/                      # 地图模块（小地图识别，大地图操作）\n│   ├── task/                     # 任务模块（各种功能脚本，供mcp调用）\n│   ├── ui/                       # 游戏UI模块（页面、UI）\n│   ├── view_and_move/            # 视角和移动模块\n│   ├── main.py                   # 程序入口\n│   ├── mcp_agent.py              # 大模型agent\n│   └── mcp_server.py             # MCP服务器\n├── configs/                      # 配置文件（首次运行会自动生成）\n│   ├── config.json               # 项目的配置文件\n│   └── prompt.txt                # 大模型提示词\n├── scripts/                      # 自动跑图和宏的脚本仓库（首次运行会自动生成）\n├── logs/                         # 日志文件\n└── build.bat                     # 一键打包\n```\n### MCP工具编写\n可参考`source\\task\\daily_task`内的几个task，并在`source\\mcp_server.py`中注册，就能被大模型调用。\n\n### 跑图路线录制\n详情请查看 [跑图路线仓库](https://github.com/nikkigallery/WhimboxScripts)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikkigallery%2Fwhimbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikkigallery%2Fwhimbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikkigallery%2Fwhimbox/lists"}