SillyTavern 酒馆桥接与四位桌宠角色卡的安装方法见 SILLYTAVERN.md。

wwbs 是一个面向《鸣潮》Windows PC 客户端的图像识别自动点击工具。它会识别游戏窗口中的模板图片，并按照任务配置自动点击目标位置。

当前源码版本：1.5.1（正式版）

• 新增 SillyTavern 酒馆桥接扩展及达妮娅、爱弥斯、景燃、卡提希娅四张角色卡；安装与连接方法见 SILLYTAVERN.md。

• 模型可从下拉框选择：启动时检测 Ollama、LM Studio 常用本地服务与模型目录；DeepSeek / OpenAI 兼容 API 填写地址和密钥后点击“获取服务模型”。本机文件检测不等于服务已经启动，LM Studio 请先载入模型，再获取服务列表选择。

• DeepSeek 接入方式自动填入 https://api.deepseek.com，模型名称以服务返回的列表为准，不写死。其他兼容 API 通常使用 /v1 地址。

• API Key 仅在本次运行中保存，重启需重新填写。远程 API 会把当前聊天及角色设定发送给配置的服务商，可能产生费用；本地 Ollama 仍可离线使用，程序不会自动下载模型。

• 聊天输入框及桌宠右键“查看聊天记录”可查看记录；各角色分别在本机保留最近500条。开启 Agent 后停止随机发言，只回复聊天和任务消息；关闭后恢复主动发言。

• 4C 保留10次快捷入口，原30次入口改为自定义次数（1—9999），重启后自动带出上次输入。

• 设置中移除 ADB 路径、设备 ID、任务配置路径及截图等调试控件，内部默认配置与任务逻辑保留。

• 周常识别达到上限后返回主页，关闭游园，进入周度游历。根据带红点的发光宝箱，从右向左领取并确认对勾；不会固定点击5000或6000。无法确认状态时提示手动检查，并禁止本次自动关机。

• 每日进入索拉指南后会在左侧栏精确识别交叉武器“战斗”按钮，不再依赖固定的菜单序号；即使新手任务尚未完成、左侧多出新手日志入口，也能找到正确按钮。

• 4C技能键、大招键、日常三号位回血和任务完成关机已移到“开始”页左侧的任务设置卡片。键位在选择、回车或离开输入框时自动保存，两个开关点击即保存，重启后自动恢复。

• “快捷任务”页改为圆角整行任务卡，点击卡片即运行；左侧用细滚动条独立滚动，顶部导航与状态栏更紧凑。右侧实时截图缩小，并与运行状态分成两张卡片。所有主题沿用原有配色。

• 按住快捷任务卡左侧三点可上下拖动排序，顺序自动保存；无音区与键位可直接用鼠标滚轮切换。三个选择器及其下拉列表使用圆角样式，键位仍可手动输入；4C 自定义次数改为与主界面一致的输入框和按钮。

• 拖动快捷任务卡时，卡片跟随光标移动，原位置显示落点提示；三点处显示小手光标，松开后保存排序。

• 修复一键日常在索拉指南记住上次的“素材获取”页面时误判为今日日常已完成：现在会先返回活跃度入口确认，再进入无音清剿。

• 修正“战斗”图标模板路径多出一层 daily/ 的问题；进入该分类后，一键日常会识别“无音清剿”文字并点击该行中部，确认选中后才搜索目标无音区。

• 修复圆角下拉菜单在屏幕底部向下展开并阻断其他控件的问题；空间不足时改为向上展开，点击空白处即可关闭，下方开关可正常点击。

• 修复绿色结晶材料使用成功但体力仍不足时提前结束补充的问题。“材料消耗成功”不再等同于“体力已足够”；只要补充窗口仍存在，程序就会继续第二张黄色结晶溶剂，仍不会选择右侧星声。

• 更新器使用带 BOM 的 PowerShell 脚本避免中文路径乱码。退出前校验压缩包大小、CRC、运行库结构，并校验 Release 提供的 SHA-256（若有）；仅替换 wwbs.exe 和 _internal，保留外部用户配置。备份存放在安装目录 .wwbs-update-backup-*，日志在临时目录 wwbs_update_*/update.log。新窗口初始化后须在45秒内确认启动，否则尝试回滚；备份不自动删除。

• 更新检查仍使用 GitHub 最新正式 Release；支持同版本 beta 升级到正式版。当前修复不会自动改变已发布旧 EXE 的更新器，旧版更新报错时需先完整解压新安装包，不能只替换 EXE。

验证范围：自动化测试、中文路径更新脚本沙盒模拟、提供的游戏截图和多尺寸识别；未操作真实游戏领取奖励，未使用真实 API Key 发起付费调用，也未进行真实 EXE 覆盖升级。

程序顶部的“关于”按钮可查看当前版本，并跳转至作者的 B 站视频 和 GitHub 仓库。

项目地址：https://github.com/ybpan34-prog/WWBS

• 自动检测简体 鸣潮、繁体 鳴潮 和国际服 Steam 版 Wuthering Waves 窗口。
• PC 客户端优先离屏捕获游戏客户区，不受 wwbs 或其他窗口遮挡；不支持时自动置前游戏兜底。
• 按 1920x1080 模板基准进行识别，并实际支持 1600x900、1536x864、1280x720 等 16:9 等比例窗口。
• 显示游戏窗口预览、运行日志和识别结果。
• 支持制作、刷新、删除模板图片。
• 支持模板组：一组 menu1.png 到 menu99.png 图片属于一个完整任务模板组。
• 默认模板组名称为“幻梦游园”。
• 任务可以绑定不同模板组，切换任务时自动切换对应图片组。
• 第一阶段识别并点击 menu1.png，之后按顺序识别 menu2.png 到 menu99.png。
• 每次图像识别点击都会在模板方框内部随机选择安全位置，并保留原有点击偏移。
• 每次点击后的间隔会在任务固定值的 ±0.2 秒 范围内随机。
• 支持“周常拿满奖励”和“周常拿满星声”两种自动停止模式。
• 下一张模板累计识别失败 2 次和 4 次时，会回退确认并补点仍停留在画面的上一张模板。
• 最后一轮会确认末模板已响应点击；仍停留时最多补点 2 次。
• 支持手动停止任务，并在累计 5 次找不到目标模板时自动停止。
• 概率计算支持星声、抽数、角色水位、武器水位、角色大保底和目标数量。
• 支持查看历史更新公告。
• 支持从 GitHub Releases 检查、下载和安装远程更新。
• 加入 Q 版桌宠“达妮娅”“爱弥斯”“景燃”和“卡提希娅”，程序状态会触发待机、检查、等待、运行、完成和失败动画及气泡提示；空闲时按随机间隔触发互动动作，景燃与卡提希娅还会以 16 个方向跟随鼠标观察。
• 右键桌宠可诊断管理员权限、游戏窗口、分辨率、模板，以及是否位于无存档的小漂泊者初始界面。
• 右键桌宠可直接执行拿满奖励、拿满星声和停止任务；由桌宠触发时不再重复弹出开始确认。
• 自动任务无法启动或运行失败时会快速诊断并即时反馈，不再把运行条件问题描述为截图模糊。
• 图像匹配使用 NumPy 内置实现，不再依赖 SciPy。
• 支持全局快捷键 Ctrl + Alt + S 紧急停止当前任务，即使焦点位于游戏窗口也可使用。
• 加入可选“达妮娅主题”“爱弥斯主题”、深色青金“景燃主题”和冰蓝潮汐“卡提希娅主题”；原版简约主题保持默认。选择角色主题时会绑定对应桌宠，但单独选择桌宠不会再改变程序主题。
• 新增“群声共振模拟域”任务：用户选择关卡后，程序会点击开始模拟、在固定镜头下靠近蓝色守岸人并按 F 交互。
• 新增独立“4C刷取”10次与自定义次数循环，支持持续普攻、定时技能、三号位回血连段、每0.5秒首领状态检查、声骸搜索吸收与重新挑战。
• 4C 和日常战斗均每10秒尝试按一次已设置的大招键，按键时暂停普攻；一号位每10次普攻穿插一次约0.8秒的长按左键重击。三号位连段会在按 Q 前后留出收招时间，再切回一号位。
• 4C刷取按钮会直接使用内置4C模板，不需要先在模板管理中切换模板组；吸收阶段会核验“吸收”文字，不会把相同外框的“领取奖励”误判为吸收。
• 新增正式版“一键日常”：滑动选择指定无音区后自动完成两轮挑战、双倍领取、活跃度100宝箱与先约电台免费奖励；体力不足时只使用结晶单质或结晶溶剂，绝不会消耗星声。日常收尾会再次检查周度游历，未完成时自动进入幻梦游园、补选第一个祝福技能并接续15轮“周常拿满奖励”，已有完成勾则跳过。
• 一键日常进入索拉指南后会先检查活跃度页面；若活跃度已满并被游戏自动切页，会提示今日日常已完成并跳过无音区，但仍继续检查周度游历：停在周常页则执行幻梦游园，已跳到后续页面则结束。
• 周常启动只通过中央“＋ / 选择祝福”判断空槽；单独周常与日常衔接周常均会在空槽时自动选择第一个祝福，只要不是加号，任意已装备祝福都可直接开始。
• 日常奖励光球采用0.65最低置信度和分层视角扫描：先搜索当前高度，必要时逐级抬高，搜索循环结束会恢复初始高度，避免镜头过低或过高。
• 设置页可选择是否启用日常三号位回血；默认关闭，开启后会暂停一号位普攻、执行回血连段并自动切回一号位。
• 日常战斗会同时检查清理目标文字、奖励光球和“领取奖励”提示；即使目标文字残留，也会停止攻击并进入奖励搜索。
• 第二轮完成后会安全识别“确认离开”二次提示并点击右侧确认；未出现弹窗时不会盲点固定坐标。
• 补充体力界面会等待资源数字稳定并多帧判断：结晶单质为0时直接选择结晶溶剂；补充后仍不足也会自动改用溶剂，始终不会选择星声。
• 桌宠支持多档大小调整，程序窗口会根据不同屏幕尺寸等比例适配，日志与设置页面支持滚动。
• 四款桌宠会在最终显示尺寸统一处理透明边缘，70%至150%档位不会因缩放重新产生黑边或模糊毛边。
• 景燃与卡提希娅可分别开关鼠标注视和定时跳跃；设置页与桌宠右键菜单会双向同步。跳跃会沿当前朝向向前腾空，空中保持跳跃动画，接地后播放落地缓冲动作。定时跳跃首次使用默认开启，每45至90秒尝试触发一次；用户保存的开关选择始终优先。
• 重做景燃人格与对话，加入怪谈讲述、《寻幽记》写作、离开与归来、休息提醒、程序报错、亲密互动和剧情后的同行者关系；日常保持自然随性，真正危险时会变得简短可靠。
• 景燃现在双击即可立即说出专属台词；自动主动聊天提高到约每12至24秒一次，若当时正在移动会在4至8秒后重试，启动欢迎仍然保留。
• 景燃与卡提希娅双击时会固定触发更高的向前跳跃；腾空阶段锁定真正的跳跃姿态，不再循环到站立帧，落地后继续播放缓冲动作。
• 修复一键日常结束后的周常检查：索拉指南没有自动进入周度游历页时，直接判定本周周常已完成并跳过，不再等待错误页面导致报错。
• 新增四桌宠本地 Agent 试用功能，默认关闭且不会下载模型。达妮娅、爱弥斯、景燃和卡提希娅共享用户部署的 Ollama 服务，但分别载入各自完整人格，可通过自然语言启动受限的日常、周常、4C、停止或诊断任务。
• 桌宠聊天支持明确的本地设置指令，例如“开启三号位回血”“任务结束后自动关机”“关闭定时跳跃”；只允许修改安全白名单内的设置。开始自动任务前，气泡会以“现在执行：具体任务名”再次确认目标。
• “你是谁”“你多大”等稳定人格事实会使用各角色的专属本地回答，不依赖小模型临场猜测；未公开的年龄不会编造，也不会和身份问题重复同一句。
• 本地对话与桌宠融合：右键任意角色后会在其附近打开专属主题输入框，支持回车发送和Shift+Enter换行，回复直接显示为桌宠气泡。输入框打开时会后台预热模型，发送后不再显示等待占位气泡；首次聊天与模型重新载入时都会携带完整角色设定。连续聊天复用模型60秒，取消输入后模型也会按时释放；自动任务开始前和连接检测结束后立即卸载，兼顾回复速度与游戏显存。
• 设置页新增“自动任务正常完成后关机”，默认关闭并自动保存。开启后仅真实任务成功结束会请求 Windows 在30秒后关机；手动停止、运行失败和预演模式均不会触发。
• 一键日常、一键周常与4C刷取按钮旁提供圆圈问号提示；点击后会显示对应的16:9启动页面示例，并提醒先把游戏调整到正确画面。

1. 请以管理员身份运行软件；Steam 国际服同样需要让 wwbs 与游戏保持一致的权限级别。 点击真实运行按钮时，若检测到 wwbs 尚未使用管理员权限，程序会立即请求管理员权限并重启，不再等到任务报错；请在 Windows 提示中选择“是”。预演模式不会触发提权。
2. 将游戏设置为 1920x1080，或者使用等比例缩放的窗口分辨率。
3. 请先完成周本的新手教程。
4. 将游戏速度调整至 MAX。
5. 让游戏停留在带“开始游戏”按钮的小漂泊者初始界面，并确保没有存档。

推荐普通用户使用 GitHub Release 中的 wwbs-exe.zip：

1. 下载并解压 wwbs-exe.zip。
2. 保持 wwbs.exe 和 _internal 文件夹在同一目录。
3. 右键 wwbs.exe，选择“以管理员身份运行”。
4. 窗口标题保持“自动”，在“开始”页面选择任务；启动任务时程序会自动检测游戏窗口。
5. 点击“周常拿满奖励”或“周常拿满星声”。
6. 需要提前结束时，点击“停止当前任务”，或按全局快捷键 Ctrl + Alt + S。

“一键日常”需要角色先处于可按 Esc 打开终端的大世界。程序会经终端进入索拉指南；请在开始页滑动选择无音区，再点击“一键日常（2轮双倍）”。完成日常领奖后，程序还会从终端检查周度游历：未完成时进入幻梦游园，技能槽为空才选择第一个祝福，然后自动执行15轮；已有完成勾或已有技能时不会重复操作。 设置页可选择是否在日常战斗中启用三号位回血连段；该选项默认关闭，开启并保存后会定时切换三号位，完成回血后自动切回一号位。

• 左键拖动可移动达妮娅、爱弥斯、景燃或卡提希娅，双击可触发互动动作。
• 右键可运行诊断、执行自动任务、停止任务、开关漫游或隐藏桌宠；景燃与卡提希娅还能直接开关鼠标注视和定时跳跃。
• 使用任意桌宠时，右键选择“和角色聊天”，在角色专属配色的输入框中打字；生成完成后，桌宠直接用气泡回答。首次使用请在“设置 → 桌宠 Agent”中选择接入方式和检测到的模型，保存并测试连接。大型本地模型首次载入可能需要1至3分钟。
• 使用 Ollama 时聊天推理保留在本机；选择远程 API 时将发送至配置的服务商。wwbs 不会自动下载模型。普通对话不会启动任务，只有“帮我做日常”“运行30次4C”等明确指令才会匹配本地白名单。
• 桌宠隐藏状态会自动保存并在下次启动时恢复；自动任务和一键操作的状态提示不会把已隐藏的桌宠重新显示。
• 四位桌宠会使用各自的人格台词，并自然地称呼你为“漂泊者”；卡提希娅会使用“即便身处命运的漩涡，我也有想要坚持的事。”等专属台词。自动任务执行期间会暂停漫游，避免遮挡模板位置。
• 卡提希娅日常人格以明亮坦率的流浪骑士为主，主要称呼为“义人”，认真时使用“漂泊者”；芙露德莉斯只在明确触发的严肃场景短暂出现。
• 气泡姓名徽章会根据角色名自动调整宽度并保留顶部空间，四字姓名不会再被遮挡。
• “帮我诊断”会检查权限、窗口比例、截图、配置、模板和正确起始界面，并把详细结果写入日志。

• 默认继续使用原版简约主题。
• 可在“设置 → 程序主题”中启用“达妮娅主题”“爱弥斯主题”“景燃主题”或“卡提希娅主题”，切换后程序会自动重启。
• 选择角色主题时会切换到同名桌宠，但之后仍可单独改选其他桌宠，程序重启后不会被主题强制改回。
• 四款角色主题都使用独立压缩资源；卡提希娅主题采用用户提供的命运漩涡头图、冰蓝深海配色与专属台词。

“先预演一次”只识别模板，不会实际点击，适合开始前检查模板是否正确。

模板图片位于 templates/ 文件夹中。

默认模板组直接使用 templates/ 根目录中的图片：

templates/menu1.png
templates/menu2.png
templates/menu3.png
...
templates/menu99.png

其他任务模板组使用独立文件夹：

templates/
  幻梦游园/
    menu1.png
    menu2.png
    ...
  其他任务/
    menu1.png
    menu2.png
    ...

在“模板”页面中可以：

• 新建模板组。
• 选择模板组并制作图片。
• 将当前模板组绑定到“开始”页面选中的任务。
• 删除当前模板组。

模板最好包含按钮文字、图标、边框等稳定特征，不建议只截取纯色背景。

“概率”页面支持填写：

• 星声数量，或者抽数，二者会自动同步。
• 角色水位。
• 武器水位。
• 是否拥有角色大保底。
• 想要获得的 UP 角色数量。
• 想要获得的 UP 武器数量。

换算规则为 160 星声 = 1 抽。抽数最多允许 1000 抽。复杂计算会在后台执行，避免界面卡死。

角色池按 50% 和大保底计算；武器池按当前设定默认 5 星即为 UP。角色和武器目标同时填写时，程序默认先计算角色目标，再用剩余抽数计算武器目标。

环境要求：

• Windows
• Python 3.10 或更高版本

安装依赖：

pip install -r requirements.txt

启动：

python app.py

也可以双击：

启动 wwbs.bat

• app.py：主界面、任务执行、概率计算和远程更新。
• windows_client.py：Windows 游戏窗口检测、截图和鼠标点击。
• image_matcher.py：模板图像识别。
• desktop_pet.py：桌宠窗口、动画、气泡和右键菜单。
• daniya_persona.py：达妮娅的人格台词与事件语言。
• aemeath_persona.py：爱弥斯的人格台词、欢迎与事件语言。
• cartethyia_persona.py：卡提希娅的人格台词与事件语言。
• pet-assets/：桌宠运行时动画帧。
• optional-themes/：可选程序主题包。
• weekly_tasks.json：任务和循环配置。
• templates/：默认模板组和其他模板组。
• wwbs.ico：程序图标。

程序会检查以下 GitHub Releases 地址：

https://github.com/ybpan34-prog/WWBS/releases

每个正式 Release 必须上传一个名称完全相同的文件：

wwbs-exe.zip

用户点击程序顶部的“检查更新”后，程序会：

1. 查询最新 Release。
2. 对比当前版本号。
3. 下载新的 wwbs-exe.zip。
4. 关闭当前程序。
5. 替换程序文件并自动重启。

源码模式只能检查版本，自动替换功能需要使用打包后的 wwbs.exe。

1. 修改 app.py 中的 APP_VERSION。
2. 重新生成 wwbs-exe.zip。
3. 创建新的 Git 标签，例如 v1.4。
4. 在 GitHub 创建同名 Release。
5. 将 wwbs-exe.zip 上传到该 Release。
6. 在 Release 描述中填写本次更新内容。

不要修改发布文件名，否则客户端无法找到更新包。

• 本工具只对当前桌面上的游戏窗口执行图像识别和鼠标操作。
• 请先使用“先预演一次”确认模板位置正确。
• 不要在游戏新手教程尚未完成时启动自动任务。
• 识别异常时可以查看“日志”页面，并使用模板组功能重新制作图片。