本项目仅供学习与技术交流,与《胜利女神:NIKKE》官方无任何关联;使用本工具产生的一切后果由使用者自行承担。 阅读完整声明

使用前必读 快速上手 使用方案 程序组成 功能一览 常见问题 更新日志 下载最新版

开源免费 · 基于 MaaFramework 图像识别

每日任务,
交给 MaaNikke

《胜利女神:NIKKE》国服每日任务自动化工具。从登录奖励到竞技场、从派遣到爬塔 —— 设置一次,每天到点自动完成全部日常,从琐碎的点点点中解放出来,享受人生。

GPL-3.0 开源 WeGame 国服桌面端 Windows 10 / 11(64 位) Python 3.10+
向下滚动

01 · 使用前必读

先确认它适合你

本程序未考虑到过于复杂的场景,定位是免去每日任务的重复操作。花一分钟看完本节,能避开绝大多数问题。

适合

绝大部分「养老号」

功能已解锁、日常稳定的账号,交给它每天自动跑完每日任务即可。

暂缓

开荒阶段请勿使用

仍处于开荒阶段、功能未解锁或关卡打不过的话,建议暂时不要使用。

定位

免去重复,而非代练

若希望培养顶级战力号,还请多上线微操 —— 它只负责把重复劳动收走。

环境要求

  • Windows 10 / 11(64 位),NIKKE 国服桌面端,账号由 WeGame 登录启动。
  • 必须安装 Python 3.10 及以上,安装时务必勾选 "Add Python to PATH",否则 agent 无法启动。下载 Python 3.13.13
  • 首次启动 agent 会自动安装 maafw==5.10.2 与 Pillow(需要联网,网络不佳自动切换清华镜像源;已有其他 5.x 版本 maafw 会直接复用)。
  • MaaNikke.exe 及各启动脚本均需右键以管理员身份运行。
  • 方案 B(全程自动化)还需安装 AutoHotkey 2.0。
日常插画
日常交给它,时间还给你

游戏内设置 · 务必完成

过场动画设置:技能过场动画设定改为播放简化版

设置 1

过场动画简化

技能过场动画设定改为「播放简化版」或「关闭」。

画质设置

设置 2

画质修改 (务必!!)

按图示修改画质。程序基于图像识别工作,画质直接决定识别效果。

动态壁纸播放设置

设置 3

关闭动态壁纸

建议关闭动态壁纸播放,防止莫名其妙的 Bug 出现。

设置 4

先手动完成一次每日

在使用 MaaNikke 前,请先手动完成过一次每日任务。

设置 5

战斗模式默认开启自动

务必确认游戏内战斗模式默认设置为「自动」。

02 · 快速上手

三步,十分钟搞定

完整程序(含 GUI,解压即用)请前往 Releases 下载;GitHub 仓库仅包含自定义层源码,适合二次开发或手动更新。

1

下载并安装

前往 Releases 下载最新版压缩包,解压到任意目录(建议路径不要嵌套太多层)。 随后安装 Python 3.10+,安装时务必勾选 "Add Python to PATH"。

# 解压后的目录(节选)
MaaNikke/
├─ MaaNikke.exe       ← GUI 主程序,右键管理员运行
├─ autoMaaNikke.bat   ← 全自动方案入口
├─ startnikke.ahk     ← WeGame 拉起游戏
├─ agent / resource / interface.json
└─ …

2

完成游戏内设置

程序基于图像识别工作,正确的游戏内设置是稳定运行的关键:过场动画简化、 画质调整、关闭动态壁纸,并先手动完成过一次每日任务、确认战斗模式默认开启自动。

若双击 MaaNikke.exe 无法启动(提示缺少 dll / 运行时),以管理员身份运行 DependencySetup_依赖库安装_win.bat,装完重启电脑再试。

3

选择你的运行方案

想随用随开,选方案 A · 手动版;想彻底躺平、到点自动开工,选方案 B · 全程自动化 —— 配合 Windows 任务计划程序实现定时无人值守。

版本更新方式:替换 agent、interface.json、resource 这三个文件即可(建议先删除原文件再复制)。

03 · 使用方案

两种方案,各取所需

随用随开的手动版,或到点自动开工的全程自动化。

1

启动游戏

自行打开 WeGame,启动 NIKKE 并进入游戏大厅。

2

管理员运行

右键以管理员身份运行 MaaNikke.exe。

3

勾选任务

在任务列表勾选要执行的任务(默认已勾选全部日常项),点击开始。

4

坐等完成

去吃早 / 晚餐,回来后任务即自动完成。

适合偶尔使用、人在电脑旁的场景 —— 动动手指,剩下的交给 MaaNikke。

整体启动链

autoMaaNikke.bat / .py

一键全流程入口 · 管理员运行,二选一

startnikke.ahk

定位 WeGame 启动器 → 打开 WeGame → 点击「启动」→ 等待 nikke.exe 出现

nikke.exe

确认游戏在运行

MaaNikke.exe

GUI 自动开始执行你勾选的任务列表

自动战斗插画
电脑开着,每日自动跑完
1

安装 AutoHotkey 2.0

全自动方案依赖 AutoHotkey 启动游戏。注意必须是 v2 版本 —— startnikke.ahk 使用 v2 语法。 前往官网下载 ↗

2

配置 MaaNikke 启动行为

打开 MaaNikke.exe,进入 设置 → 启动设置 → 启动后操作,勾选 「仅启动脚本」。 (因为 NIKKE 必须由 WeGame 启动,此处选择「启动游戏」无效;游戏的拉起由 startnikke.ahk 负责。)

可选 · 更省心:将 「结束后操作」设为 「关闭目标程序和本程序」 —— 任务跑完后 GUI 自动关闭游戏和自己, 脚本检测到退出后随之结束,定时任务完整闭环。

MaaNikke 设置:启动后操作选择仅启动脚本
3

选择启动方式(二选一)

方式一 · 手动直接运行:右键以管理员身份运行 autoMaaNikke.bat(非管理员会直接提示并退出)。

方式二 · 定时自动化(通过 Windows 任务计划程序):

  1. 打开「任务计划程序」(开始 → Windows 管理工具 → 任务计划程序),点击 创建基本任务。
  2. 填写名称 → 勾选 每天 → 设定希望运行的时间 → 选择 启动程序。
  3. 点击「浏览」,选择解压后文件夹内的 autoMaaNikke.bat → 完成。
  4. 右键刚创建的任务 →「属性」→ 勾选 「使用最高权限运行」(必须,否则脚本会因权限不足直接退出)。
右键以管理员身份运行
管理员身份运行
任务计划程序:创建基本任务
创建基本任务
任务属性:勾选使用最高权限运行
勾选最高权限运行
autoMaaNikke.bat 一键全流程入口

使用方式:右键以管理员身份运行(非管理员会直接提示并退出)。执行流程:

  1. 校验管理员权限;
  2. 启动 startnikke.ahk,等待 60 秒让游戏加载;
  3. 之后每 10 秒检查一次 nikke.exe 进程:若游戏没在运行,重新调用 startnikke.ahk 再拉一次;
  4. 确认游戏运行后,启动 MaaNikke.exe,等待 60 秒让其加载;
  5. 之后每 10 秒守候 MaaNikke.exe:进程仍在则继续等待,进程退出(任务执行完毕自动关闭)则脚本结束。

脚本不会主动杀游戏进程;游戏与 GUI 的关闭依赖 GUI 的「结束后操作」设置(见上方步骤 2)。

autoMaaNikke.py bat 的 Python 等价版

行为与 autoMaaNikke.bat 完全一致(管理员校验 → ahk 拉起游戏并轮询 → 守候 MaaNikke.exe 退出),区别仅在于:

  • 进程名为精确匹配(bat 是子串匹配),判定更严谨;
  • 供只接受 .py 脚本的第三方任务调度器(如 OneDragon ScriptChainer)接入任务链。

使用方式:在管理员权限的终端中运行,或直接由你的调度器调用。普通双击 / 任务计划场景请优先使用 bat。

python autoMaaNikke.py
startnikke.ahk 游戏启动脚本 · 一般由 bat / py 自动调用

也可双击单独运行来手动拉起游戏。工作流程:

  1. 游戏已在运行:不做任何启动动作,仅补齐 launcher_cache.txt 路径缓存后静默退出;
  2. 定位 WeGame 启动器,按优先级依次尝试:读取 launcher_cache.txt 缓存(秒开)→ 从运行中的进程路径反查 → 遍历本地硬盘按目录关键字(nikke / 胜利女神等)搜索 → 都失败则弹窗提示,此时在 WeGame 中手动启动一次游戏再点「确定」,脚本检测到后自动记下路径(5 分钟超时);
  3. 拉起游戏:打开启动器 → 把 WeGame 窗口固定到左上角 1600×900 → 按比例位置点击「启动」按钮 → 等待 nikke.exe 出现。点击最多重试 3 次(每次等待 15 秒),整轮失败重启启动器再来一轮(最多 2 轮);检测到「错误 / 更新失败 / 网络异常」弹窗时退出并弹红色托盘提示,需人工处理;
  4. 启动成功或彻底失败后脚本自动退出,结果由托盘气泡提示(蓝色 = 一般提示,红色 = 需要人工介入)。

关于 launcher_cache.txt:首次定位成功后自动保存启动器路径,之后秒级命中。若移动 / 重装了游戏或缓存路径失效,直接删除该文件即可,下次运行自动重建。

高级 · 脚本可调参数(一般无需修改,WeGame 界面大改版时才需要):打开 startnikke.ahk 顶部的「配置区」调整。

参数默认值含义
LAUNCHER_W / LAUNCHER_H1600 / 900固定 WeGame 窗口的尺寸(WeGame 最小窗口即 1600×900,勿改小)
BTN_RATIO_X / BTN_RATIO_Y0.85 / 0.93「启动」按钮中心相对窗口宽 / 高的比例,WeGame 布局改版点不到按钮时调这两个值
MAX_RETRIES3每轮内点击「启动」的重试次数
WAIT_TIME15000每次点击后等待游戏进程出现的毫秒数
MAX_LAUNCHER_RETRIES2启动器整体重启的轮数
DependencySetup_依赖库安装_win.bat 运行库安装 / 修复

仅当 MaaNikke.exe 无法启动(闪退、报缺少 VCRUNTIME*.dll、.NET Runtime 相关错误)时使用:

  1. 右键以管理员身份运行;
  2. 脚本自动识别系统架构(x64 / x86 / ARM64),优先用 winget 安装,不可用时转为直接下载安装:Microsoft Visual C++ Redistributable 与 .NET Desktop Runtime 10.0;
  3. 安装完成后重启电脑,再运行 MaaNikke.exe。

最终效果

只需保持电脑开机,到设定时间后,程序将自动完成每日任务。
真正的解放自己,享受人生吧!

04 · 程序组成

解压后都有什么

与日常使用直接相关的文件一览,看懂每个文件的角色,出问题时不慌。

文件类型作用
MaaNikke.exe GUI 主程序 任务勾选 / 配置界面,每日任务的实际执行者
autoMaaNikke.bat 批处理脚本 一键全流程:拉起游戏 → 运行每日任务 → 守候到结束
autoMaaNikke.py Python 脚本 autoMaaNikke.bat 的等价 Python 版,供只接受 .py 的任务调度器(如 OneDragon ScriptChainer)接入
startnikke.ahk AHK 脚本 自动打开 WeGame 并点击「启动」,把游戏拉起到 nikke.exe 运行
DependencySetup_依赖库安装_win.bat 批处理脚本 安装 VC++ 运行库与 .NET Desktop Runtime 10(MaaNikke.exe 打不开时使用)
launcher_cache.txt 缓存文件 startnikke.ahk 首次定位成功后自动生成的启动器路径缓存,勿手动编辑
interface.json 配置文件 任务清单与选项定义(GUI 启动时读取,普通用户无需改动)
config/、logs/ 目录 GUI 配置与运行日志(出问题时排查用)

GitHub 仓库仅包含自定义层源码(agent / resource / interface),适合二次开发或手动更新;完整程序请前往 Releases 下载。

从登录奖励到竞技场,从派遣到爬塔 —— 每日任务,一站全包。

05 · 功能一览

23 项自动化任务,按需勾选

在 GUI 任务列表中勾选任务后,部分任务会展开可配置选项。按分类筛选查看:

启动游戏

启动

游戏启动后到进入主页大厅的全流程接管。

领取登录奖励

奖励领取

领取月卡及登录奖励。

邮件领取

奖励领取

自动领取邮件附件奖励。

每日每周奖励领取

奖励领取

含反叛之路的每日 / 每周奖励。

PASS 奖励领取

奖励领取

自动领取 PASS 通行证奖励。

付费商店领取

商店

付费商店每日 / 每周 / 每月的免费钻石。

道具商店每日购买

商店

道具商店每日折扣商品购买。

可配置:普通 / 躯体标签 / 废铁商店开关;竞技场通用道具开关(可细选风 / 火 / 电 / 物理 / 水代码、代码手册宝箱、企业装备熔炉)

前哨防御

日常玩法

睡醒了,自动进行前哨防御歼灭。

可配置:是否用钻石一举歼灭(默认关,只用每日免费 1 次);开启后可设连续歼灭次数(1–11,含免费那次)

派遣公告栏

日常玩法

自动领取、自动派遣。

需游戏内已解锁自动派遣。

咨询和送礼

日常玩法

批量咨询送礼。

需手动咨询的 3 个妮姬请收藏至顶端。

装备升级

日常玩法

自动升级装备。

无法指定装备,仓库需至少有一件未满级装备。

好友点数收取赠送

日常玩法

好友点数自动收取与赠送。

社交点招募

日常玩法

为完成更生馆任务和每日任务。

模拟室

副本挑战

一键快速模拟。

需已通关最后一个模拟室、解锁快速模拟。

竞技场

副本挑战

纯自动战斗。

可配置:特殊竞技场只领取奖励(开启后不战斗)

拦截战

副本挑战

自动拦截战。

可配置:周一手操 Boss 战开关;特殊拦截战 Boss 选择(默认克拉肯)

其他 Boss 识别失败率较高,谨慎选择。

爬塔

副本挑战

无限之塔 + 企业塔。

可配置:无限之塔开关及每日次数(建议别太高,会拉长耗时);企业塔开关、是否每天打满 3 次、四个企业(朝圣者 / 超标准、泰特拉、米西利斯、极乐净土)单独开关

未选「打满」时,每天只按优先级爬一个开启中的企业塔(朝圣者 / 超标准 > 泰特拉 > 米西利斯 > 极乐净土),未开启时段自动跳到下一个。

协同作战

副本挑战

打满三次。

可能不稳定,出错不影响其他每日。

单人突击

副本挑战

自动完成单人突击。

联盟突袭 Beta

副本挑战

不稳定,默认不勾选。

出错不影响其他每日。

更生馆 识别困难

副本挑战

如无必要建议不勾选。

特定节点会弹对话,识别耗时较长属正常现象。

同步器和循环室

基地养成

同步器与循环室的自动化管理。

可配置:是否使用时间盒子道具(关闭则保持游戏内原状态)

限时活动

大型活动

随版本开放的活动(如 p5、juveniledays),不定时随版本更新。

商店兑换暂定:专票、普票、红眼盒子 2h、红眼

06 · 常见问题

踩坑预警

运行前看一遍,能省下不少排查时间。

以管理员身份运行 DependencySetup_依赖库安装_win.bat,它会自动安装 VC++ 运行库与 .NET Desktop Runtime 10,装完重启电脑再试。

确认安装 Python 时勾选了 "Add Python to PATH";在终端执行 python --version 能输出版本号才行。

按弹窗提示在 WeGame 里手动启动一次游戏,脚本检测到后会自动缓存路径;之后秒级定位。

删除 launcher_cache.txt,下次运行时脚本会自动重建缓存。

调整 startnikke.ahk 配置区的 BTN_RATIO_X / BTN_RATIO_Y(详见方案 B · 脚本详解中的高级参数表)。

游戏加载期不产帧,属正常现象,进大厅后自愈,不用处理。

先看游戏窗口是否被最小化 / 遮挡、画质设置是否被改动。日志在 logs/ 目录:log-*.log 为 GUI 日志,maafw.log 为底层识别日志,vision/ 存识别截图 —— 排查时请提供这些文件。

不要(例如开发版与正式版双开)—— 多实例会互踩文件锁导致异常。

NIKKE 游戏窗口以较高权限运行,普通权限下的程序无法对其进行截图和模拟键鼠操作。请右键 MaaNikke.exe(或 autoMaaNikke.bat),选择「以管理员身份运行」。

首次启动 agent 时会自动安装 maafw==5.10.2 和 Pillow(需要联网;网络不佳会自动切换清华镜像源)。如果已安装其他 5.x 版本的 maafw 会直接复用,不重复安装。

07 · 更新日志

持续迭代中

重大更新

main 分支重构 · 新增 Python agent

对齐 2.x 开发目录:agent / resource / interface 置于根目录,仓库仅保留自定义层源码;Python 要求放宽至 3.10+,首次启动自动安装 maafw 5.10.2 与 Pillow,支持清华镜像源;项目正式以 GPL-3.0 开源。

新增任务

PASS 奖励、协同作战、限时活动等

PASS 奖励领取、协同作战、限时活动等新任务上线;道具商店扩展为多商店兑换。

体验优化

优化模拟室流程

优化模拟室自动化流程,提升稳定性。

活动商店

限时活动新增商店奖励领取

暂定兑换:专票、普票、红眼盒子、红眼。

清理

移除已结束的 beautifullshot 活动任务

删除大型活动 beautifullshot 相关任务。

完整更新记录请查看 GitHub Releases