# blueassistant

**Repository Path**: kk486/blueassistant

## Basic Information

- **Project Name**: blueassistant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 布鲁小助手

布鲁小助手是一款 Windows 桌面端手游辅助工具，通过 ADB 截图、图像识别和模拟点击执行任务。当前源码版本为 **v1.1.6**。

## 功能

| 分类 | 玩法 |
| --- | --- |
| 日常任务 | 联军试炼、斗祭战场、押镖、生存探险、忍者碎片扫荡、自动泡温泉 |
| 竞技场 | 高阶自定义挂机 |
| 轮转活动 | 幻境探险、封印试炼、羁绊对决、攻防特训、双生试炼、巅峰试炼、冠军试炼 |
| 夏日活动 | 钓鱼、翻牌探险、客栈 |
| 调试中心 | ADB 连接、截图、点击和坐标脚本调试 |
| 工具箱 | 离线点券、组织通灵、神器、家具、勾玉、镇守计算；机制图文搜索与配图放大 |

“蚀刻”支持 0～80 级的任意升级区间、晶片库存缺口、整十级累计属性及性价比查询。数据来自用户提供的两张表；60→70 级按每级 185 晶片计算，与累计表 3800→5650 一致。属性仅在整十级提供，其他等级不插值；性价比按累计获得÷从 0 级开始的累计消耗计算。数据单独保存在 `_internal/assets/toolbox/moment.json`，不会被 Excel 数据提取脚本覆盖。工具箱所有参考表默认展开。

工具箱“图鉴”包含用户提供完整图片中的 127 个条目：火之意志 50、晓的野心 19、忍村暗流 27、忍界纷争 31。输入忍者名字可筛选包含该忍者的图鉴，支持全名/简写和形态关键词（如“佐助 须佐能乎”），可按分类继续筛选。选择图鉴可查看完整成员名单，匹配成员会加粗显示；加成和两列战力/速度数值按原表保留。数据位于 `_internal/assets/toolbox/catalog.json`，维护用转录脚本为 `tools/import_catalog_screenshot.py`，不依赖网络或 Excel。

左侧“帮助”已更名为“工具箱”，使用 PyQt5 原生界面和 Python 计算，无需浏览器、Excel、WPS 或联网。计算表来自原始《火影系统资源分享.xlsx》；组织通灵仅支持 1～211 级。点券日期包含起止当天，绑定收益按跨越的日历月份计数，排位以参考日每 45 天结算并按实际日期区间统计。修正了原表跨年月份、排位区间及低等级通灵边界的计算问题。各页提供原表样例和可展开的参考表。

输入自动保存到 `%LOCALAPPDATA%/BlueAssistant/toolbox.json`，与任务配置分开；“恢复本页样例”仅重置当前计算器。机制资料包含 16 个主题、158 段原表文字和 114 张 WebP 质量 90 的配图（保留原分辨率），支持关键词搜索、点击放大及 25%～200% 缩放，仅加载选中主题的图片。保留原表测试例外与待验证说明，未按当前游戏版本重新验证。

数据和图片位于 `_internal/assets/toolbox/`。维护时运行 `python tools/import_toolbox_workbook.py "原始表格路径.xlsx"` 重新提取（开发环境需要 Pillow），再运行 `python -m unittest discover -s tests -p "test_toolbox*.py"` 校验。应用运行时不读取 Excel 文件。现有发布配置已收集整个 assets 目录，可直接包含这些本地资源。

斗祭战场可复用左侧“战斗逻辑”的技能设置。后手自动撤退，可填写参与场数；留空表示不限制场数。达到指定场数后，脚本在本场结算并返回斗祭界面时停止；连续 10 分钟未进入战斗也会自动停止。

冠军试炼需先手动进入玩法主界面，使用1280×720分辨率。在“轮转活动 → 冠军试炼”启动，技能方式由左侧“战斗逻辑”统一配置，支持“几手断几手”等坐标操作。每轮连续三局两胜，换队后重新执行战斗设置；连续赢四轮夺冠，失败重新挑战。每轮结算后自动领奖并关闭胜负、冠军和奖励弹层，持续运行至手动停止。

两局之间的阵容与“即将开始”倒计时页面只等待其自动消失，不点击退出或释放技能。对手快速撤退时会中断尚未执行完的技能操作；若胜负判定一闪而过，会根据主界面新比分补记本轮结果及晋级进度。

冠军试炼按每次截图识别出的当前页面执行，冠军、奖励及胜负页面优先处理。入场延时、技能间隔和带土监测均不阻塞页面识别；即使流程跨过多个阶段，也会取消旧技能动作并接管当前页面。日志中的“当前画面”可用于核对识别情况。

“战斗逻辑 → 自定义坐标脚本”支持四行可独立启用的技能操作。每行可配置我方手位、断／御及目标手位，并设置入场等待和技能之间的间隔（0～600秒，精确到0.1秒）。关闭的行会直接跳过，全部操作完成后开启自动战斗；旧配置会自动恢复到对应行。

图鉴页“数量排行”按包含图鉴数量从高到低排列，可按具体形态统计或合并同名忍者，每个图鉴对同一忍者只计一次。排行支持搜索和分类筛选，选中后可查看图鉴位置，双击忍者可直接切换至所属图鉴查询。

战斗逻辑使用自定义坐标脚本，支持配置1、配置2、配置3独立自动保存和切换，旧设置迁移到配置1。斗祭战场设置显示本次运行胜利、失败计数，每次启动清零；确认撤退计为失败，同一场结算只记录一次。

## 运行环境

- Windows 和 Python 3.13
- 已安装并启动的安卓模拟器或真机，ADB 可以连接到设备
- 游戏画面分辨率为 **1280 × 720**（斗祭战场脚本按此分辨率识别）

## 从源码启动

在本目录打开 PowerShell，安装依赖：

```powershell
python -m pip install -r requirements.txt
```

双击 `启动BlueAssistant.vbs`。启动后在界面中选择设备与玩法，再点击“开始”。如果系统的 Python 3.13 不在启动脚本中预设的路径，请修改脚本里的 `pythonw` 路径。

可将 `config.example.json` 复制为 `_internal/config.json` 以保存本机 ADB 路径等配置；运行中产生的配置和日志不应提交到仓库。

## 目录

```text
_internal/
  main.py                   程序入口
  src/ui/fluent_ui/         正式界面
  src/ui/shared/            任务分发与设置控件
  src/scripts/              自动化脚本
  assets/templates/         图像识别模板
assets/                     应用图标等资源
tests/                      自动化测试
启动BlueAssistant.vbs        源码启动器
```

应用源码以此目录为准。发布构建在独立的 `_blueassistant_publish/` 工作目录进行，构建配置从这里读取源码和资源。Gitee Releases 中的安装/更新包与本仓库中的源码是两种交付形式。

源码运行版本以 `APP_VERSION` 为准；仓库根目录 `version.json` 是线上自动更新清单，只在对应附件上传完成后更新。本地发行目录内的清单对应其实际打包版本。

## 说明

此项目依赖游戏画面识别。游戏界面、分辨率或模拟器缩放变化时，模板识别可能需要重新校准。使用前请先确认 ADB 已连接，并在对应玩法界面启动任务。