ksaa 2025.8.17.0__tar.gz → 2025.8.23.0__tar.gz

{ksaa-2025.8.17.0/ksaa.egg-info → ksaa-2025.8.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksaa
-Version: 2025.8.17.0
+Version: 2025.8.23.0
 Summary: Kotones Auto Assistant(kaa) is a script for game 'Gakuen Idol M@ster' that automates the dailies and produces.
 Requires-Python: ~=3.10
 Description-Content-Type: text/markdown
@@ -27,39 +27,58 @@ Requires-Dist: numpy<2.0
 Requires-Dist: pywin32==310
 Requires-Dist: ahk==1.8.3
 Requires-Dist: win11toast==0.35
+Requires-Dist: keyboard==0.13.5
 Dynamic: license-file
 
 # Kotone's Auto Assistant 琴音小助手
 ## 功能
 * 自动日常，包括
-    * 领取礼物（邮件）
-    * 领取活动费
-    * 领取工作奖励并自动重新安排工作
-    * 竞赛挑战
-    * 领取任务奖励
-    * 清理商店
-        * 包括 AP 商店和金币商店
-        * 可以购买推荐商品，或者指定要购买的物品
-* 低配版自动培育
-    * 支持 REGULAR 和 PRO 模式
-    * 支持指定 P 偶像<sup>1</sup>
-    * 支持指定使用增强道具（笔记数量和 Pt 数量提升）
-    * 暂时**只能使用自动编成**回忆和支援卡
-    * 对于非练习周，如果没有推荐休息，暂时只会按顺序执行活动支给（活動支給）、文化课（授業）、外出（おでかけ）、休息这四种，不支持咨询（相談）
-    * 领取技能卡和 P 饮料时，固定领取第一个。若 P 饮料溢出，则不领取
-
-<sup>1</sup> 见后文的注意事项
+  * 领取礼物（邮件）
+  * 领取活动费
+  * 领取工作奖励并自动重新安排工作
+  * 竞赛挑战
+  * 领取任务奖励
+  * 清空商店（AP 商店和金币商店）
+  * 社团奖励
+  * 升级一张支援卡
+* 自动培育
+  * 支持「初」的三种难度
+  * 支持指定偶像
+  * 支持使用增强道具（笔记数量和 Pt 数量提升）
+  * 暂时**只能使用自动编成**回忆和支援卡
 
-## 安装
-### 模拟器要求
-* 分辨率：必须是 1280x720
-* 系统版本：Android 10+（Q，API 29），这是游戏的要求
-* 已开启游戏加速器或代理且网络通畅
+## 免责声明
+**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
+
+### 总则
+本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
+
+### 版权声明
+本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
+
+1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
+
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
+
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
+
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
 
-### 普通用户
-TODO
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
+
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
 
-### 技术用户
+## 安装与使用
+参见[【金山文档】使用手册](https://p.kdocs.cn/s/6IJJBRRBAAAFS)。
+
+如果你想了解技术细节，可以继续往下阅读。如果只是想要使用 kaa，你可以打开上面的使用手册，关掉这个页面了。
+
+## 安装
 琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
 ```bash
 # Python == 3.10
@@ -90,58 +109,11 @@ kaa
 需要注意的是，配置文件 `config.json` 会自动在工作目录下生成。
 因此你最好每次都在同一个地方运行 kaa，否则可能会出现找不到配置文件的情况。
 
-## 使用
-### 配置
-TODO
-
-### 注意事项
-> [!IMPORTANT]
-> 建议**使用亲密度至少为 7 的偶像**进行培育，
-> 因为琴音小助手暂时无法处理亲密度提升事件。
-
-## 开源协议
-kaa 本体及框架（kotonebot 文件夹）、相关辅助脚本（tools 文件夹）使用 **GPLv3 协议**开源。kaa 开发工具（kotonebot-devtool）、启动器（bootstrap 文件夹）以 **MIT 协议**开源。
-
-kaa 的开发主要用到了以下开源项目：
-* [GkmasObjectManager
-](https://github.com/AllenHeartcore/GkmasObjectManager)：用于提取游戏图像资源，以 GPLv3 协议开源。
-* [gakumasu-diff](https://github.com/vertesan/gakumasu-diff)：游戏数据。
-
-kaa 的开发还参考了以下开源项目：
-* [EmulatorExtras](https://github.com/MaaXYZ/EmulatorExtras)：MuMu 与雷电模拟器的截图与控制接口定义。
-* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。
-
-## 免责声明
-**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
-
-### 总则
-本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
-
-### 版权声明
-本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
-
-1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
-
-2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
-
-### 核心风险与责任限制
-1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
-
-> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
-
-> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
-
-2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
-
-3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
-
-**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
-
 ## 开发
 见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)
 
 ## 贡献
-非常欢迎 PR。
+欢迎 PR。
 
 你可以从 Github Issue 中选择一个 Issue 解决，或者从下面的路线图里选一个任务讨论。
 
@@ -150,32 +122,39 @@ kaa 的开发还参考了以下开源项目：
 （带删除线标记的为已完成）
 
 ### 培育
-* 允许指定领取 P 饮料、P 物品、技能卡的领取选择优先级
-* ~~允许指定行动优先级~~
-* 自动使用 P 饮料
-* ~~支持非凡（アノマリー）属性偶像的自动培育~~
-* ~~支持琴音的自动培育~~
+* 基本功能
+  * ~~允许指定行动优先级~~
+  * 考试时使用 P 饮料
+  * ~~支持非凡（アノマリー）属性偶像的自动培育~~
+  * ~~支持琴音的自动培育~~
+* 模式适配
+  * ~~支持 MASTER 培育~~
+  * NIA 培育
 * 允许优先选择活动加成高的偶像进行培育
-* ~~支持 MASTER 培育~~
-* 支持 NIA 培育
+* 爬塔（偶像之路）
+* 智能化培育逻辑
+  * 允许自定义领取 P 饮料、P 物品、技能卡的领取
+  * 复刻一个培育模拟器
+  * 训练并使用 AI 接管培育流程
 
 ### 日常
 * ~~竞赛按分数差距优先选择~~
 * ~~自动硬币扭蛋（コインガシャ）~~
+* 活动
+  * 活动商店购买
+  * 活动扭蛋
 
 ### 调度
 * ~~模拟器启停~~
 * 记录任务执行时间与次数，避免重复执行。例如竞赛每天只执行一次
 * 常驻运行与自动运行
 * ~~命令行接口~~
-* 尝试接入 ALAS
 
 ### UI
 * UI
-    * 使用 Flet/Flutter 重写 UI
-    * 分离脚本与 UI，允许 UI 与脚本分别独立运行
-* 启动器
-    * 使用 C# 替换当前的简易 .bat 文件
+  * 使用 Web 技术重写 UI，替换现在的 Gradio 实现
+  * 分离脚本与 UI，允许 UI 与脚本分别独立运行
+* ~~启动器~~
 
 ### 跨平台
 * Android 支持
@@ -186,12 +165,33 @@ kaa 的开发还参考了以下开源项目：
   - [ ] 使用 Pyjnius 绕过 ADB ，调用无障碍直接控制设备
 * Linux 支持
 
-### 开发工具
-* 使用 Konva.js 重构 ImageAnnotation 工具
-* 将开发工具通过 VSCode 扩展与 VSCode 整合
+### 开发工具与框架
+* 分离框架为一个单独的项目
+* 分离资源管理为一个单独的项目
+  * 重构资源编辑器（ImageAnnotation 工具）
+* 重构 Devtool 工具
+  * 将开发工具通过 VSCode 扩展与 VSCode 整合
 
 ### 其他
 * 适配汉化版
   - [ ] 需要一个合适的方法自动切换不用语言的资源文件
   - [ ] 需要一个合适的工具来辅助替换模板图片文件
   - [ ] 收集汉化版本的截图
+* 挂机优化
+  * 夜间挂机：完成后自动休眠/关机、自动降低屏幕亮度、自动静音
+  * ~~闲置挂机~~
+* 资源记录
+  * 记录并保存历史钻石与金币数据
+  * 展示变化曲线图
+
+## 开源协议
+kaa 本体及框架（kotonebot 文件夹）、相关辅助脚本（tools 文件夹）使用 **GPLv3 协议**开源。kaa 开发工具（kotonebot-devtool）、启动器（bootstrap 文件夹）以 **MIT 协议**开源。
+
+kaa 的开发主要用到了以下开源项目：
+* [GkmasObjectManager
+](https://github.com/AllenHeartcore/GkmasObjectManager)：用于提取游戏图像资源，以 GPLv3 协议开源。
+* [gakumasu-diff](https://github.com/vertesan/gakumasu-diff)：游戏数据。
+
+kaa 的开发还参考了以下开源项目：
+* [EmulatorExtras](https://github.com/MaaXYZ/EmulatorExtras)：MuMu 与雷电模拟器的截图与控制接口定义。
+* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。

{ksaa-2025.8.17.0 → ksaa-2025.8.23.0}/README.md

@@ -1,34 +1,52 @@
 # Kotone's Auto Assistant 琴音小助手
 ## 功能
 * 自动日常，包括
-    * 领取礼物（邮件）
-    * 领取活动费
-    * 领取工作奖励并自动重新安排工作
-    * 竞赛挑战
-    * 领取任务奖励
-    * 清理商店
-        * 包括 AP 商店和金币商店
-        * 可以购买推荐商品，或者指定要购买的物品
-* 低配版自动培育
-    * 支持 REGULAR 和 PRO 模式
-    * 支持指定 P 偶像<sup>1</sup>
-    * 支持指定使用增强道具（笔记数量和 Pt 数量提升）
-    * 暂时**只能使用自动编成**回忆和支援卡
-    * 对于非练习周，如果没有推荐休息，暂时只会按顺序执行活动支给（活動支給）、文化课（授業）、外出（おでかけ）、休息这四种，不支持咨询（相談）
-    * 领取技能卡和 P 饮料时，固定领取第一个。若 P 饮料溢出，则不领取
-
-<sup>1</sup> 见后文的注意事项
+  * 领取礼物（邮件）
+  * 领取活动费
+  * 领取工作奖励并自动重新安排工作
+  * 竞赛挑战
+  * 领取任务奖励
+  * 清空商店（AP 商店和金币商店）
+  * 社团奖励
+  * 升级一张支援卡
+* 自动培育
+  * 支持「初」的三种难度
+  * 支持指定偶像
+  * 支持使用增强道具（笔记数量和 Pt 数量提升）
+  * 暂时**只能使用自动编成**回忆和支援卡
 
-## 安装
-### 模拟器要求
-* 分辨率：必须是 1280x720
-* 系统版本：Android 10+（Q，API 29），这是游戏的要求
-* 已开启游戏加速器或代理且网络通畅
+## 免责声明
+**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
+
+### 总则
+本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
+
+### 版权声明
+本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
+
+1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
+
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
 
-### 普通用户
-TODO
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
 
-### 技术用户
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
+
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
+
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
+
+## 安装与使用
+参见[【金山文档】使用手册](https://p.kdocs.cn/s/6IJJBRRBAAAFS)。
+
+如果你想了解技术细节，可以继续往下阅读。如果只是想要使用 kaa，你可以打开上面的使用手册，关掉这个页面了。
+
+## 安装
 琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
 ```bash
 # Python == 3.10
@@ -59,58 +77,11 @@ kaa
 需要注意的是，配置文件 `config.json` 会自动在工作目录下生成。
 因此你最好每次都在同一个地方运行 kaa，否则可能会出现找不到配置文件的情况。
 
-## 使用
-### 配置
-TODO
-
-### 注意事项
-> [!IMPORTANT]
-> 建议**使用亲密度至少为 7 的偶像**进行培育，
-> 因为琴音小助手暂时无法处理亲密度提升事件。
-
-## 开源协议
-kaa 本体及框架（kotonebot 文件夹）、相关辅助脚本（tools 文件夹）使用 **GPLv3 协议**开源。kaa 开发工具（kotonebot-devtool）、启动器（bootstrap 文件夹）以 **MIT 协议**开源。
-
-kaa 的开发主要用到了以下开源项目：
-* [GkmasObjectManager
-](https://github.com/AllenHeartcore/GkmasObjectManager)：用于提取游戏图像资源，以 GPLv3 协议开源。
-* [gakumasu-diff](https://github.com/vertesan/gakumasu-diff)：游戏数据。
-
-kaa 的开发还参考了以下开源项目：
-* [EmulatorExtras](https://github.com/MaaXYZ/EmulatorExtras)：MuMu 与雷电模拟器的截图与控制接口定义。
-* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。
-
-## 免责声明
-**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
-
-### 总则
-本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
-
-### 版权声明
-本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
-
-1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
-
-2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
-
-### 核心风险与责任限制
-1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
-
-> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
-
-> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
-
-2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
-
-3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
-
-**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
-
 ## 开发
 见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)
 
 ## 贡献
-非常欢迎 PR。
+欢迎 PR。
 
 你可以从 Github Issue 中选择一个 Issue 解决，或者从下面的路线图里选一个任务讨论。
 
@@ -119,32 +90,39 @@ kaa 的开发还参考了以下开源项目：
 （带删除线标记的为已完成）
 
 ### 培育
-* 允许指定领取 P 饮料、P 物品、技能卡的领取选择优先级
-* ~~允许指定行动优先级~~
-* 自动使用 P 饮料
-* ~~支持非凡（アノマリー）属性偶像的自动培育~~
-* ~~支持琴音的自动培育~~
+* 基本功能
+  * ~~允许指定行动优先级~~
+  * 考试时使用 P 饮料
+  * ~~支持非凡（アノマリー）属性偶像的自动培育~~
+  * ~~支持琴音的自动培育~~
+* 模式适配
+  * ~~支持 MASTER 培育~~
+  * NIA 培育
 * 允许优先选择活动加成高的偶像进行培育
-* ~~支持 MASTER 培育~~
-* 支持 NIA 培育
+* 爬塔（偶像之路）
+* 智能化培育逻辑
+  * 允许自定义领取 P 饮料、P 物品、技能卡的领取
+  * 复刻一个培育模拟器
+  * 训练并使用 AI 接管培育流程
 
 ### 日常
 * ~~竞赛按分数差距优先选择~~
 * ~~自动硬币扭蛋（コインガシャ）~~
+* 活动
+  * 活动商店购买
+  * 活动扭蛋
 
 ### 调度
 * ~~模拟器启停~~
 * 记录任务执行时间与次数，避免重复执行。例如竞赛每天只执行一次
 * 常驻运行与自动运行
 * ~~命令行接口~~
-* 尝试接入 ALAS
 
 ### UI
 * UI
-    * 使用 Flet/Flutter 重写 UI
-    * 分离脚本与 UI，允许 UI 与脚本分别独立运行
-* 启动器
-    * 使用 C# 替换当前的简易 .bat 文件
+  * 使用 Web 技术重写 UI，替换现在的 Gradio 实现
+  * 分离脚本与 UI，允许 UI 与脚本分别独立运行
+* ~~启动器~~
 
 ### 跨平台
 * Android 支持
@@ -155,12 +133,33 @@ kaa 的开发还参考了以下开源项目：
   - [ ] 使用 Pyjnius 绕过 ADB ，调用无障碍直接控制设备
 * Linux 支持
 
-### 开发工具
-* 使用 Konva.js 重构 ImageAnnotation 工具
-* 将开发工具通过 VSCode 扩展与 VSCode 整合
+### 开发工具与框架
+* 分离框架为一个单独的项目
+* 分离资源管理为一个单独的项目
+  * 重构资源编辑器（ImageAnnotation 工具）
+* 重构 Devtool 工具
+  * 将开发工具通过 VSCode 扩展与 VSCode 整合
 
 ### 其他
 * 适配汉化版
   - [ ] 需要一个合适的方法自动切换不用语言的资源文件
   - [ ] 需要一个合适的工具来辅助替换模板图片文件
-  - [ ] 收集汉化版本的截图
+  - [ ] 收集汉化版本的截图
+* 挂机优化
+  * 夜间挂机：完成后自动休眠/关机、自动降低屏幕亮度、自动静音
+  * ~~闲置挂机~~
+* 资源记录
+  * 记录并保存历史钻石与金币数据
+  * 展示变化曲线图
+
+## 开源协议
+kaa 本体及框架（kotonebot 文件夹）、相关辅助脚本（tools 文件夹）使用 **GPLv3 协议**开源。kaa 开发工具（kotonebot-devtool）、启动器（bootstrap 文件夹）以 **MIT 协议**开源。
+
+kaa 的开发主要用到了以下开源项目：
+* [GkmasObjectManager
+](https://github.com/AllenHeartcore/GkmasObjectManager)：用于提取游戏图像资源，以 GPLv3 协议开源。
+* [gakumasu-diff](https://github.com/vertesan/gakumasu-diff)：游戏数据。
+
+kaa 的开发还参考了以下开源项目：
+* [EmulatorExtras](https://github.com/MaaXYZ/EmulatorExtras)：MuMu 与雷电模拟器的截图与控制接口定义。
+* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。

{ksaa-2025.8.17.0 → ksaa-2025.8.23.0}/WHATS_NEW.md

@@ -1,5 +1,16 @@
 # 更新日志
 ## kaa
+### v2025.8.23.0
+脚本：
+* [新增] 新增闲置挂机功能（#54e2101）
+* [修复] 再次修复商店刷新后第二次购买会跳过第一行的问题（#b72cdf4）
+* [修复] 修复游戏更新导致的培育时识别编成编号失败（#24d14d4）
+* [修复] 修复培育内周数识别失败的问题（#3a84994）
+* [修复] 培育商店中有时候会因为结束按钮被挡住而卡住（#e93cfa8）
+
+其他：
+* [文档] 更新 README（#841fcf2）
+
 ### v2025.8.17.0
 脚本：
 * [修复] 尝试修复进入每日商店时报错的问题（#e9529b7）

ksaa-2025.8.23.0/kotonebot/kaa/application/core/idle_mode.py

@@ -0,0 +1,172 @@
+import sys
+import time
+import logging
+import threading
+from contextlib import suppress
+from typing import Callable, Optional
+
+with suppress(ImportError):
+    keyboard = None
+    win32api = None
+    win32gui = None
+    win32con = None
+    import keyboard # type: ignore
+    import win32api # type: ignore
+    import win32gui # type: ignore
+    import win32con # type: ignore
+
+from kotonebot.backend.context.context import vars
+from kotonebot.kaa.config.schema import IdleModeConfig
+
+logger = logging.getLogger(__name__)
+
+def _get_system_idle_seconds_windows() -> int:
+    if win32api is None:
+        return 0
+    try:
+        last_input_tick = win32api.GetLastInputInfo()
+        tick_count = win32api.GetTickCount()
+        elapsed_ms = tick_count - last_input_tick
+        return max(0, int(elapsed_ms / 1000))
+    except Exception:
+        logger.exception('win32api.GetLastInputInfo failed')
+        return 0
+
+
+def get_system_idle_seconds() -> int:
+    if sys.platform.startswith('win'):
+        try:
+            return _get_system_idle_seconds_windows()
+        except Exception:
+            logger.exception('GetLastInputInfo failed')
+            return 0
+    return 0
+
+
+class IdleModeManager:
+    def __init__(
+        self,
+        *,
+        get_is_running: Callable[[], bool],
+        get_is_paused: Callable[[], bool],
+        get_config: Callable[[], IdleModeConfig],
+    ) -> None:
+        self._get_is_running = get_is_running
+        self._get_is_paused = get_is_paused
+        self._get_config = get_config
+        self._stop_event = threading.Event()
+        self._thread: Optional[threading.Thread] = None
+        self._keyboard_hook = None
+        self._last_key_ts: float = 0.0
+
+    def start(self) -> None:
+        if self._thread and self._thread.is_alive():
+            return
+        self._stop_event.clear()
+        self._thread = threading.Thread(target=self._loop, name='IdleModeThread', daemon=True)
+        self._thread.start()
+        self._install_keyboard_hook()
+        logger.info('IdleModeManager started')
+
+    def stop(self) -> None:
+        self._remove_keyboard_hook()
+        if self._thread and self._thread.is_alive():
+            self._stop_event.set()
+            self._thread.join(timeout=2.0)
+        logger.info('IdleModeManager stopped')
+
+    def notify_on_start(self) -> None:
+        # 运行态切换时可根据需要做重置
+        self._last_key_ts = 0.0
+
+    def notify_on_stop(self) -> None:
+        self._last_key_ts = 0.0
+
+    def _loop(self) -> None:
+        while not self._stop_event.is_set():
+            conf = self._get_config()
+            if not conf.enabled:
+                time.sleep(0.8)
+                continue
+            try:
+                if self._get_is_paused():
+                    idle_sec = get_system_idle_seconds()
+                    if idle_sec >= max(0, int(conf.idle_seconds)):
+                        logger.info('System idle for %ss while paused. Requesting resume...', idle_sec)
+                        try:
+                            vars.flow.request_resume()
+                        except Exception:
+                            logger.exception('request_resume failed')
+                time.sleep(0.8)
+            except Exception:
+                logger.exception('IdleMode loop error')
+                time.sleep(1.0)
+
+    def _install_keyboard_hook(self) -> None:
+        if keyboard is None:
+            logger.warning('keyboard module not available; key-to-pause disabled')
+            return
+        if self._keyboard_hook is not None:
+            return
+
+        def _on_key_event(_: object) -> None:
+            conf = self._get_config()
+            if not conf.enabled:
+                return
+            now = time.time()
+            if (now - self._last_key_ts) < 0.3:
+                return
+            self._last_key_ts = now
+            try:
+                if self._get_is_running() and not self._get_is_paused():
+                    logger.info('Any key pressed -> pause requested')
+                    vars.flow.request_pause()
+                    if conf.minimize_on_pause:
+                        self._minimize_game_window()
+            except Exception:
+                logger.exception('key handler failed')
+
+        try:
+            self._keyboard_hook = keyboard.on_press(_on_key_event, suppress=False)
+        except Exception:
+            logger.warning('Failed to install keyboard hook; degraded behavior')
+            self._keyboard_hook = None
+
+    def _remove_keyboard_hook(self) -> None:
+        if keyboard is None:
+            return
+        if self._keyboard_hook is None:
+            return
+        try:
+            keyboard.unhook(self._keyboard_hook)
+        except Exception:
+            logger.exception('Failed to remove keyboard hook')
+        finally:
+            self._keyboard_hook = None
+
+    def _minimize_game_window(self) -> None:
+        # Send the window to background (bottom of Z-order) via pywin32
+        if not sys.platform.startswith('win'):
+            return
+        if win32gui is None or win32con is None:
+            logger.warning('pywin32 (win32gui/win32con) not available; skip backgrounding')
+            return
+        try:
+            hwnd = win32gui.FindWindow(None, 'gakumas')  # type: ignore
+            if hwnd:
+                flags = (
+                    win32con.SWP_NOMOVE
+                    | win32con.SWP_NOSIZE
+                    | win32con.SWP_NOACTIVATE
+                    | win32con.SWP_NOOWNERZORDER
+                )
+                win32gui.SetWindowPos(hwnd, win32con.HWND_BOTTOM, 0, 0, 0, 0, flags)
+                try:
+                    win32gui.ShowWindow(hwnd, win32con.SW_SHOWNOACTIVATE)
+                except Exception:
+                    pass
+                logger.info('Sent game window to background (HWND=%s)', hwnd)
+            else:
+                logger.warning('Game window not found; cannot send to background')
+        except Exception:
+            logger.warning('Failed to send game window to background', exc_info=True)