ksaa 2025.11b1__tar.gz → 2025.11b3__tar.gz

ksaa-2025.11b3/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: ksaa
+Version: 2025.11b3
+Summary: Kotones Auto Assistant(kaa) is a script for game 'Gakuen Idol M@ster' that automates the dailies and produces.
+Requires-Python: ~=3.10.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python==4.10.0.84
+Requires-Dist: rapidocr_onnxruntime==1.4.3
+Requires-Dist: av==14.0.1
+Requires-Dist: scikit-image==0.25.0
+Requires-Dist: thefuzz==0.22.1
+Requires-Dist: adbutils==2.8.0
+Requires-Dist: uiautomator2==3.2.8
+Requires-Dist: fastapi==0.115.6
+Requires-Dist: uvicorn==0.34.0
+Requires-Dist: python-multipart==0.0.20
+Requires-Dist: websockets==14.1
+Requires-Dist: psutil==6.1.1
+Requires-Dist: gradio==5.21.0
+Requires-Dist: pydantic==2.10.4
+Requires-Dist: ksaa-res==0.2.0
+Requires-Dist: typing-extensions==4.12.2
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: onnxruntime==1.14.0
+Requires-Dist: numpy<2.0
+Requires-Dist: pywin32==310; sys_platform == "win32"
+Requires-Dist: ahk==1.8.3; sys_platform == "win32"
+Requires-Dist: win11toast==0.35; sys_platform == "win32"
+Requires-Dist: keyboard==0.13.5
+Requires-Dist: kotonebot[android]==0.5.0
+Requires-Dist: kotonebot[windows]==0.5.0; sys_platform == "win32"
+Dynamic: license-file
+
+# Kotone's Auto Assistant 琴音小助手
+## 功能
+* 自动日常，包括
+  * 领取礼物（邮件）
+  * 领取活动费
+  * 领取工作奖励并自动重新安排工作
+  * 竞赛挑战
+  * 领取任务奖励
+  * 清空商店（AP 商店和金币商店）
+  * 社团奖励
+  * 升级一张支援卡
+* 自动培育
+  * 支持「初」的三种难度
+  * 支持指定偶像
+  * 支持使用增强道具（笔记数量和 Pt 数量提升）
+  * 暂时**只能使用自动编成**回忆和支援卡
+
+## 免责声明
+**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
+
+### 总则
+本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
+
+### 版权声明
+本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
+
+1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
+
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
+
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
+
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
+
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
+
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
+
+## 安装与使用
+参见[【金山文档】使用手册](https://p.kdocs.cn/s/6IJJBRRBAAAFS)。
+
+如果你想了解技术细节，可以继续往下阅读。如果只是想要使用 kaa，你可以打开上面的使用手册，关掉这个页面了。
+
+## 安装
+琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
+```bash
+# Python == 3.10
+pip install ksaa
+```
+
+> 琴音小助手的缩写是“kaa”（**K**otone's **A**uto **A**ssist），
+> 但是“kaa”已经被其他包占用了，
+> 因此改用“ksaa”（**K**otone'**s** **A**uto **A**ssist）。
+
+不过为了避免依赖冲突，你最好使用 pipx 来安装：
+```bash
+# 安装 pipx
+scoop install pipx
+pipx ensurepath
+# 安装 kaa
+pipx install ksaa
+```
+（也可以通过 pip 安装 pipx，详见 [pipx 文档](https://github.com/pypa/pipx#on-windows)）
+
+如果你不想使用 pipx，也可以手动创建虚拟环境，并使用普通的 pip 安装。
+
+安装完成后，只需要运行 `kaa` 命令即可启动 GUI 界面：
+```bash
+kaa
+```
+
+需要注意的是，配置文件 `config.json` 会自动在工作目录下生成。
+因此你最好每次都在同一个地方运行 kaa，否则可能会出现找不到配置文件的情况。
+
+## 开发
+环境配置见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)。
+
+开发指南见 [QUICK_START.md](./docs/GUIDE.md)。
+
+## 贡献
+欢迎 PR。你可以从 Github Issue 中选择一个 Issue 解决，或者从下面的路线图里选一个任务讨论。
+
+如果你打算开发或修复的问题没有在 Github Issue、QQ 群或其他地方提出，请先在这些地方提出，让我知道。
+
+main 分支为开发分支与测试版发布分支，release 分支为稳定版发布分支。所有 PR 都应提交到 main 分支。
+其他分支均为临时分支，请不要提交到这些分支。
+
+提交 PR 前建议你先进行覆盖率自测，详见“开发指南 ##测试”。
+
+## 路线图
+下面是待实现的功能：  
+（带删除线标记的为已完成）
+
+### 培育
+* 基本功能
+  * ~~允许指定行动优先级~~
+  * 考试时使用 P 饮料
+  * ~~支持非凡（アノマリー）属性偶像的自动培育~~
+  * ~~支持琴音的自动培育~~
+* 模式适配
+  * ~~支持 MASTER 培育~~
+  * NIA 培育
+* 允许优先选择活动加成高的偶像进行培育
+* 爬塔（偶像之路）
+* 智能化培育逻辑
+  * 允许自定义领取 P 饮料、P 物品、技能卡的领取
+  * 复刻一个培育模拟器
+  * 训练并使用 AI 接管培育流程
+
+### 日常
+* ~~竞赛按分数差距优先选择~~
+* ~~自动硬币扭蛋（コインガシャ）~~
+* 活动
+  * 活动商店购买
+  * 活动扭蛋
+
+### 调度
+* ~~模拟器启停~~
+* 记录任务执行时间与次数，避免重复执行。例如竞赛每天只执行一次
+* 常驻运行与自动运行
+* ~~命令行接口~~
+
+### UI
+* UI
+  * 使用 Web 技术重写 UI，替换现在的 Gradio 实现
+  * 分离脚本与 UI，允许 UI 与脚本分别独立运行
+* ~~启动器~~
+
+### 跨平台
+* Android 支持
+  - [ ] 使用 Python for Android 移植 kaa 到 Android 平台
+    - [ ] 解决 native 依赖编译问题
+    - [ ] 需要一个适合移动端的 UI
+  - [ ] 调用 Shizuku 执行 ADB 命令
+  - [ ] 使用 Pyjnius 绕过 ADB ，调用无障碍直接控制设备
+* Linux 支持
+
+### 开发工具与框架
+* ~~分离框架为一个单独的项目~~
+* 分离资源管理为一个单独的项目
+  * 重构资源编辑器（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)（No License）：MuMu 与雷电模拟器的截图与控制接口定义。
+* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)（GPLv3）：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。
+* [Gakumas_Launcher](https://github.com/a4nqi3n/Gakumas_Launcher)（Unlicense license）：绕开 DMMPlayer 直接启动游戏本体的方式。

ksaa-2025.11b3/README.md

@@ -0,0 +1,173 @@
+# Kotone's Auto Assistant 琴音小助手
+## 功能
+* 自动日常，包括
+  * 领取礼物（邮件）
+  * 领取活动费
+  * 领取工作奖励并自动重新安排工作
+  * 竞赛挑战
+  * 领取任务奖励
+  * 清空商店（AP 商店和金币商店）
+  * 社团奖励
+  * 升级一张支援卡
+* 自动培育
+  * 支持「初」的三种难度
+  * 支持指定偶像
+  * 支持使用增强道具（笔记数量和 Pt 数量提升）
+  * 暂时**只能使用自动编成**回忆和支援卡
+
+## 免责声明
+**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
+
+### 总则
+本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
+
+### 版权声明
+本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
+
+1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
+
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
+
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
+
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
+
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
+
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
+
+## 安装与使用
+参见[【金山文档】使用手册](https://p.kdocs.cn/s/6IJJBRRBAAAFS)。
+
+如果你想了解技术细节，可以继续往下阅读。如果只是想要使用 kaa，你可以打开上面的使用手册，关掉这个页面了。
+
+## 安装
+琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
+```bash
+# Python == 3.10
+pip install ksaa
+```
+
+> 琴音小助手的缩写是“kaa”（**K**otone's **A**uto **A**ssist），
+> 但是“kaa”已经被其他包占用了，
+> 因此改用“ksaa”（**K**otone'**s** **A**uto **A**ssist）。
+
+不过为了避免依赖冲突，你最好使用 pipx 来安装：
+```bash
+# 安装 pipx
+scoop install pipx
+pipx ensurepath
+# 安装 kaa
+pipx install ksaa
+```
+（也可以通过 pip 安装 pipx，详见 [pipx 文档](https://github.com/pypa/pipx#on-windows)）
+
+如果你不想使用 pipx，也可以手动创建虚拟环境，并使用普通的 pip 安装。
+
+安装完成后，只需要运行 `kaa` 命令即可启动 GUI 界面：
+```bash
+kaa
+```
+
+需要注意的是，配置文件 `config.json` 会自动在工作目录下生成。
+因此你最好每次都在同一个地方运行 kaa，否则可能会出现找不到配置文件的情况。
+
+## 开发
+环境配置见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)。
+
+开发指南见 [QUICK_START.md](./docs/GUIDE.md)。
+
+## 贡献
+欢迎 PR。你可以从 Github Issue 中选择一个 Issue 解决，或者从下面的路线图里选一个任务讨论。
+
+如果你打算开发或修复的问题没有在 Github Issue、QQ 群或其他地方提出，请先在这些地方提出，让我知道。
+
+main 分支为开发分支与测试版发布分支，release 分支为稳定版发布分支。所有 PR 都应提交到 main 分支。
+其他分支均为临时分支，请不要提交到这些分支。
+
+提交 PR 前建议你先进行覆盖率自测，详见“开发指南 ##测试”。
+
+## 路线图
+下面是待实现的功能：  
+（带删除线标记的为已完成）
+
+### 培育
+* 基本功能
+  * ~~允许指定行动优先级~~
+  * 考试时使用 P 饮料
+  * ~~支持非凡（アノマリー）属性偶像的自动培育~~
+  * ~~支持琴音的自动培育~~
+* 模式适配
+  * ~~支持 MASTER 培育~~
+  * NIA 培育
+* 允许优先选择活动加成高的偶像进行培育
+* 爬塔（偶像之路）
+* 智能化培育逻辑
+  * 允许自定义领取 P 饮料、P 物品、技能卡的领取
+  * 复刻一个培育模拟器
+  * 训练并使用 AI 接管培育流程
+
+### 日常
+* ~~竞赛按分数差距优先选择~~
+* ~~自动硬币扭蛋（コインガシャ）~~
+* 活动
+  * 活动商店购买
+  * 活动扭蛋
+
+### 调度
+* ~~模拟器启停~~
+* 记录任务执行时间与次数，避免重复执行。例如竞赛每天只执行一次
+* 常驻运行与自动运行
+* ~~命令行接口~~
+
+### UI
+* UI
+  * 使用 Web 技术重写 UI，替换现在的 Gradio 实现
+  * 分离脚本与 UI，允许 UI 与脚本分别独立运行
+* ~~启动器~~
+
+### 跨平台
+* Android 支持
+  - [ ] 使用 Python for Android 移植 kaa 到 Android 平台
+    - [ ] 解决 native 依赖编译问题
+    - [ ] 需要一个适合移动端的 UI
+  - [ ] 调用 Shizuku 执行 ADB 命令
+  - [ ] 使用 Pyjnius 绕过 ADB ，调用无障碍直接控制设备
+* Linux 支持
+
+### 开发工具与框架
+* ~~分离框架为一个单独的项目~~
+* 分离资源管理为一个单独的项目
+  * 重构资源编辑器（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)（No License）：MuMu 与雷电模拟器的截图与控制接口定义。
+* [blue_archive_auto_script](https://github.com/pur1fying/blue_archive_auto_script)（GPLv3）：MuMu 与雷电模拟器的截图与控制接口的 Python 实现，以及各模拟器的控制实现。
+* [Gakumas_Launcher](https://github.com/a4nqi3n/Gakumas_Launcher)（Unlicense license）：绕开 DMMPlayer 直接启动游戏本体的方式。