ksaa 2025.5.23.2__py3-none-any.whl → 2025.6.8.0__py3-none-any.whl

kotonebot/kaa/tasks/produce/non_lesson_actions.py

@@ -277,7 +277,7 @@ def enter_outing():
     buttons = ui.all()
     if not buttons:
         raise UnrecoverableError("Failed to find any buttons.")
-    target_btn = buttons[1]
+    target_btn = buttons[min(1, len(buttons) - 1)]
     logger.debug('Clicking "%s".', target_btn.description)
     if target_btn.selected:
         device.click(target_btn)

kotonebot/kaa/tasks/start_game.py

@@ -1,4 +1,5 @@
 """启动游戏，领取登录奖励，直到首页为止"""
+import json
 import os
 import ctypes
 import logging
@@ -14,6 +15,37 @@ from kotonebot import task, action, sleep, device, image, ocr, config
 
 logger = logging.getLogger(__name__)
 
+def locate_game_path() -> str | None:
+    """自动获取 DMM 版游戏路径。"""
+    logger.info('Locating DMM game path...')
+    app_data = os.getenv('APPDATA')
+    if not app_data:
+        logger.info('APPDATA not found. Location failed.')
+        return None
+    dmm_config_path = os.path.join(app_data, 'dmmgameplayer5', 'dmmgame.cnf')
+    if not os.path.exists(dmm_config_path):
+        logger.warning('DMM config does not exist. Location failed.')
+        return None
+    with open(dmm_config_path, 'r', encoding='utf-8') as f:
+        dmm_config = json.load(f)
+    for content in dmm_config.get('contents', []):
+        if content.get('productId') == 'gakumas':
+            game_path = content.get('detail', {}).get('path')
+            if game_path:
+                break
+    else:
+        logger.warning('Game "gakumas" not found in DMM config.')
+        return None
+    logger.info(f'Game path: {game_path}')
+    if game_path:
+        game_path = os.path.join(game_path, 'gakumas.exe')
+    if game_path and not conf().start_game.dmm_game_path:
+        logger.info('Saving game path to config...')
+        conf().start_game.dmm_game_path = game_path
+        config.save()
+    return game_path
+
+
 @action('启动游戏.进入首页', screenshot_mode='manual-inherit')
 def wait_for_home():
     """
@@ -106,7 +138,23 @@ def windows_launch():
         is_admin = ctypes.windll.shell32.IsUserAnAdmin() != 0
     if not is_admin:
         raise PermissionError("Please run as administrator.")
-
+    
+    # 处理汉化插件
+    if conf().start_game.disable_gakumas_localify:
+        logger.info('Disabling Gakumas Localify...')
+        game_path = conf().start_game.dmm_game_path or locate_game_path()
+        logger.debug('Game path: %s', game_path)
+        if not game_path:
+            raise ValueError('dmm_game_path unset and auto-locate failed.')
+        
+        plugin_path = os.path.join(os.path.dirname(game_path), 'version.dll')
+        logger.debug('Plugin path: %s', plugin_path)
+        if not os.path.exists(plugin_path):
+            logger.warning('Gakumas Localify not found. Skipped disable.')
+        else:
+            os.rename(plugin_path, plugin_path + '.disabled')
+            logger.info('Gakumas Localify disabled.')
+    
     from ahk import AHK
     from importlib import resources
     ahk_path = str(resources.files('kaa.res.bin') / 'AutoHotkey.exe')

{ksaa-2025.5.23.2.dist-info → ksaa-2025.6.8.0.dist-info}/METADATA

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: ksaa
-Version: 2025.5.23.2
+Version: 2025.6.8.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
+License-File: LICENSE
 Requires-Dist: opencv-python==4.10.0.84
 Requires-Dist: rapidocr_onnxruntime==1.4.3
 Requires-Dist: av==14.0.1
@@ -25,6 +26,7 @@ Requires-Dist: onnxruntime==1.14.0
 Requires-Dist: numpy<2.0
 Requires-Dist: pywin32==310
 Requires-Dist: ahk==1.8.3
+Dynamic: license-file
 
 # Kotone's Auto Assistant 琴音小助手
 ## 功能
@@ -96,6 +98,41 @@ TODO
 > 建议**使用亲密度至少为 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)：游戏数据。
+
+
+## 免责声明
+**请在使用本项目前仔细阅读以下内容。使用本脚本将带来包括但不限于账号被封禁的风险。**
+
+### 总则
+本项目（琴音小助手）是一个为游戏 **《学园偶像大师》（学園アイドルマスター）** 设计的自动操作脚本。本项目的创建目的仅为技术学习与研究，并非为了提供商业服务或鼓励不正当的游戏行为。
+
+### 版权声明
+本项目所使用的部分资源文件，包括但不限于图像、音频、模型等，其版权归属于其原始权利人。该游戏的开发商为 **QualiArts**，发行商为**万代南梦宫娱乐（Bandai Namco Entertainment Inc.）**。
+
+1.  **权利归属**：本项目中使用的所有相关游戏资源文件的版权、商标权及其他一切知识产权，均归 **QualiArts**、**万代南梦宫娱乐**或其相关权利方所有。
+
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
+
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
+
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
+
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
+
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
+
 ## 开发
 见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)