ksaa 2025.8.17.0__py3-none-any.whl → 2025.9b1__py3-none-any.whl

kotonebot/kaa/tasks/daily/purchase.py

@@ -12,7 +12,7 @@ from ..actions.scenes import goto_home, goto_shop, at_daily_shop
 
 logger = logging.getLogger(__name__)
 
-@action('购买 Money 物品', screenshot_mode='manual-inherit')
+@action('购买 Money 物品', screenshot_mode='manual')
 def money_items2(items: Optional[list[DailyMoneyShopItems]] = None):
     """
     购买 Money 物品
@@ -59,7 +59,7 @@ def money_items2(items: Optional[list[DailyMoneyShopItems]] = None):
     if items:
         logger.info(f'{len(items)} item(s) not purchased/already purchased: {", ".join([item.to_ui_text(item) for item in items])}')
 
-@action('购买推荐商品', screenshot_mode='manual-inherit')
+@action('购买推荐商品', screenshot_mode='manual')
 def dispatch_recommended_items():
     """
     购买推荐商品
@@ -194,13 +194,11 @@ def purchase():
         if image.find(R.Daily.ButtonRefreshMoneyShop):
             logger.info('Refreshing money shop.')
             device.click()
-            sleep(0.5)
             # 等待刷新完成
             for _ in Loop():
                 if not image.find(R.Daily.ButtonRefreshMoneyShop):
                     break
                 logger.debug('Waiting for money shop refresh...')
-            device.screenshot()
             money_items2()
             sleep(0.5)
     else:

kotonebot/kaa/tasks/produce/cards.py

@@ -9,6 +9,7 @@ from cv2.typing import MatLike
 from kotonebot.kaa.tasks import R
 from kotonebot.kaa.config import conf
 from kotonebot.kaa.game_ui import dialog
+from kotonebot.kaa.tasks.produce.common import acquisition_date_change_dialog
 from kotonebot.kaa.util.trace import trace
 from kotonebot.primitives import RectTuple, Rect
 from kotonebot import action, Interval, Countdown, device, image, sleep, ocr, contains, use_screenshot, color
@@ -188,6 +189,8 @@ def do_cards(
             device.double_click(Rect(xywh=card_rect[:4]))
             sleep(2)
             timeout_cd.reset()
+        # 日期变更检测
+        acquisition_date_change_dialog()
         # 结束条件
         if card_count == 0 and end_predicate():
             if not break_cd.started:

kotonebot/kaa/tasks/produce/common.py

@@ -11,6 +11,7 @@ from kotonebot import (
     Interval,
 )
 from kotonebot.kaa.config.schema import produce_solution
+from kotonebot.kaa.tasks.start_game import wait_for_home
 from kotonebot.primitives import Rect
 from kotonebot.kaa.tasks import R
 from .p_drink import acquire_p_drink
@@ -150,6 +151,63 @@ def handle_skill_card_removal():
             break
     logger.debug("Handle skill card removal finished.")
 
+@action('继续当前培育.进入培育', screenshot_mode='manual-inherit')
+def resume_produce_pre() -> tuple[Literal['regular', 'pro', 'master'], int]:
+    """
+    继续当前培育.进入培育\n
+    该函数用于处理‘日期变更’等情况；单独执行此函数时，要确保代码已经处于培育状态。
+
+    前置条件：游戏首页，且当前有进行中培育\n
+    结束状态：培育中的任意一个页面
+    """
+    device.screenshot()
+    # 点击 プロデュース中
+    # [res/sprites/jp/daily/home_1.png]
+    logger.info('Click ongoing produce button.')
+    device.click(R.Produce.BoxProduceOngoing)
+    btn_resume = image.expect_wait(R.Produce.ButtonResume)
+    # 判断信息
+    mode_result = image.find_multi([
+        R.Produce.ResumeDialogRegular,
+        R.Produce.ResumeDialogPro,
+        R.Produce.ResumeDialogMaster
+    ])
+    if not mode_result:
+        raise ValueError('Failed to detect produce mode.')
+    if mode_result.index == 0:
+        mode = 'regular'
+    elif mode_result.index == 1:
+        mode = 'pro'
+    else:
+        mode = 'master'
+    logger.info(f'Produce mode: {mode}')
+    retry_count = 0
+    max_retries = 5
+    current_week = None
+    while retry_count < max_retries:
+        week_text = ocr.ocr(R.Produce.BoxResumeDialogWeeks, lang='en').squash().regex(r'\d+/\d+')
+        if week_text:
+            weeks = week_text[0].split('/')
+            logger.info(f'Current week: {weeks[0]}/{weeks[1]}')
+            if len(weeks) >= 2:
+                current_week = int(weeks[0])
+                break
+        retry_count += 1
+        logger.warning(f'Failed to detect weeks. week_text="{week_text}". Retrying... ({retry_count}/{max_retries})')
+        sleep(0.5)
+        device.screenshot()
+    
+    if retry_count >= max_retries:
+        raise ValueError('Failed to detect weeks after multiple retries.')
+    if current_week is None:
+        raise ValueError('Failed to detect current_week.')
+    # 点击 再開する
+    # [kotonebot-resource/sprites/jp/produce/produce_resume.png]
+    logger.info('Click resume button.')
+    device.click(btn_resume)
+
+    return mode, current_week
+
 AcquisitionType = Literal[
     "PDrinkAcquire", # P饮料被动领取
     "PDrinkSelect", # P饮料主动领取
@@ -167,7 +225,31 @@ AcquisitionType = Literal[
     "NetworkError", # 网络中断弹窗
     "SkipCommu", # 跳过交流
     "Loading", # 加载画面
+    "DateChange", # 日期变更
 ]
+
+def acquisition_date_change_dialog() -> AcquisitionType | None:
+    """
+    检测是否执行了日期变更。\n
+    如果出现了日期变更，则对日期变更直接进行处理（返回标题、进入游戏、重进培育）\n
+    注：不更新屏幕截图。
+    """
+
+    # 日期变更（可以考虑加入版本更新，但因为我目前没有版本更新的720x1080素材，所以没法加）
+    logger.debug("Check date change dialog...")
+    if image.find(R.Daily.TextDateChangeDialog):
+        logger.info("Date change dialog found.")
+        # 点击确认
+        device.click(image.expect(R.Daily.TextDateChangeDialogConfirmButton))
+        # 进入游戏
+        # 注：wait_for_home()里的Loop类第一次进入循环体时，会自动执行device.screenshot()
+        wait_for_home()
+        # 重进培育
+        resume_produce_pre()
+        return "DateChange"
+
+    return None
+
 @measure_time()
 @action('处理培育事件', screenshot_mode='manual')
 def fast_acquisitions() -> AcquisitionType | None:
@@ -264,6 +346,12 @@ def fast_acquisitions() -> AcquisitionType | None:
             return "PItemSelect"
     device.click(10, 10)
 
+    # 日期变更
+    result = acquisition_date_change_dialog()
+    if result is not None:
+        return result
+    device.click(10, 10)
+
     return None
 
 def until_acquisition_clear():

kotonebot/kaa/tasks/produce/in_purodyuusu.py

@@ -760,7 +760,7 @@ def hajime_from_stage(stage: ProduceStage, type: Literal['regular', 'pro', 'mast
     开始 Regular 培育。
     """
     if stage == 'action':
-        texts = ocr.ocr(rect=R.InPurodyuusu.BoxWeeksUntilExam)
+        texts = ocr.ocr(rect=R.InPurodyuusu.BoxWeeksUntilExam, lang='en')
         # 提取周数
         remaining_week = texts.squash().replace('ó', '6').numbers()
         if not remaining_week:
@@ -781,10 +781,10 @@ def hajime_from_stage(stage: ProduceStage, type: Literal['regular', 'pro', 'mast
                 function = hajime_master
             case _:
                 assert_never(type)
-        if texts.where(contains('中間')):
+        if image.find(R.InPurodyuusu.TextMidExamRemaining):
             week = MID_WEEK - remaining_week[0]
             function(start_from=week)
-        elif texts.where(contains('最終')):
+        elif image.find(R.InPurodyuusu.TextFinalExamRemaining):
             week = FINAL_WEEK - remaining_week[0]
             function(start_from=week)
         else:

kotonebot/kaa/tasks/produce/non_lesson_actions.py

@@ -242,12 +242,18 @@ def is_rest_available():
 def rest():
     """执行休息"""
     logger.info("Rest for this week.")
-    (SimpleDispatcher('in_produce.rest')
-        # 点击休息
-        .click(R.InPurodyuusu.Rest)
-        # 确定
-        .click(R.InPurodyuusu.RestConfirmBtn, finish=True)
-    ).run()
+
+    # 部分设备上，第二次click（确定）点击速度过快，导致卡死，所以这里需要添加一个sleep
+    device.click(image.expect(R.InPurodyuusu.Rest))
+    sleep(0.5)
+    device.click(image.expect(R.InPurodyuusu.RestConfirmBtn))
+    # 原方案
+    # (SimpleDispatcher('in_produce.rest')
+    #     # 点击休息
+    #     .click(R.InPurodyuusu.Rest)
+    #     # 确定
+    #     .click(R.InPurodyuusu.RestConfirmBtn, finish=True)
+    # ).run()
 
 @action('判断是否处于行动页面')
 def at_action_scene():

kotonebot/kaa/tasks/produce/produce.py

@@ -3,6 +3,7 @@ from typing import Optional, Literal
 from typing_extensions import assert_never
 
 from kotonebot.kaa.config.schema import produce_solution
+from kotonebot.kaa.tasks.produce.common import resume_produce_pre
 from kotonebot.ui import user
 from kotonebot.kaa.tasks import R
 from kotonebot.kaa.config import conf
@@ -118,60 +119,23 @@ def select_set(index: int):
             logger.warning(f'Failed to navigate to set #{index}. Current set is #{final_current}. Retrying... ({retry_count}/{max_retries})')
     
     logger.error(f'Failed to navigate to set #{index} after {max_retries} retries.')
-    
-@action('继续当前培育', screenshot_mode='manual-inherit')
-def resume_produce():
+
+@action('继续当前培育.继续培育', screenshot_mode='manual-inherit')
+def resume_produce_lst(
+    mode: Literal['regular', 'pro', 'master'],
+    current_week: int
+):
     """
-    继续当前培育
+    继续当前培育.继续培育\n
+    该函数正常情况不应该被单独调用。
 
-    前置条件：游戏首页，且当前有进行中培育\n
+    前置条件：培育中的任意一个页面\n
     结束状态：游戏首页
+
+    :param mode: 培育模式
+    :param current_week: 培育的周数
     """
-    device.screenshot()
-    # 点击 プロデュース中
-    # [res/sprites/jp/daily/home_1.png]
-    logger.info('Click ongoing produce button.')
-    device.click(R.Produce.BoxProduceOngoing)
-    btn_resume = image.expect_wait(R.Produce.ButtonResume)
-    # 判断信息
-    mode_result = image.find_multi([
-        R.Produce.ResumeDialogRegular,
-        R.Produce.ResumeDialogPro,
-        R.Produce.ResumeDialogMaster
-    ])
-    if not mode_result:
-        raise ValueError('Failed to detect produce mode.')
-    if mode_result.index == 0:
-        mode = 'regular'
-    elif mode_result.index == 1:
-        mode = 'pro'
-    else:
-        mode = 'master'
-    logger.info(f'Produce mode: {mode}')
-    retry_count = 0
-    max_retries = 5
-    current_week = None
-    while retry_count < max_retries:
-        week_text = ocr.ocr(R.Produce.BoxResumeDialogWeeks, lang='en').squash().regex(r'\d+/\d+')
-        if week_text:
-            weeks = week_text[0].split('/')
-            logger.info(f'Current week: {weeks[0]}/{weeks[1]}')
-            if len(weeks) >= 2:
-                current_week = int(weeks[0])
-                break
-        retry_count += 1
-        logger.warning(f'Failed to detect weeks. week_text="{week_text}". Retrying... ({retry_count}/{max_retries})')
-        sleep(0.5)
-        device.screenshot()
-    
-    if retry_count >= max_retries:
-        raise ValueError('Failed to detect weeks after multiple retries.')
-    if current_week is None:
-        raise ValueError('Failed to detect current_week.')
-    # 点击 再開する
-    # [kotonebot-resource/sprites/jp/produce/produce_resume.png]
-    logger.info('Click resume button.')
-    device.click(btn_resume)
+
     match mode:
         case 'regular':
             resume_regular_produce(current_week)
@@ -181,6 +145,19 @@ def resume_produce():
             resume_master_produce(current_week)
         case _:
             assert_never(mode)
+    
+@action('继续当前培育', screenshot_mode='manual-inherit')
+def resume_produce():
+    """
+    继续当前培育
+
+    前置条件：游戏首页，且当前有进行中培育\n
+    结束状态：游戏首页
+    """
+
+    mode, current_week = resume_produce_pre()
+
+    resume_produce_lst(mode, current_week)
 
 @action('执行培育', screenshot_mode='manual-inherit')
 def do_produce(
@@ -198,10 +175,10 @@ def do_produce(
     :param idol_skin_id: 要培育的偶像。如果为 None，则使用配置文件中的偶像。
     :param mode: 培育模式。
     :return: 是否因为 AP 不足而跳过本次培育。
-    :raises ValueError: 如果 `memory_set_index` 不在 [1, 10] 的范围内。
+    :raises ValueError: 如果 `memory_set_index` 不在 [1, 20] 的范围内。
     """
-    if memory_set_index is not None and not 1 <= memory_set_index <= 10:
-        raise ValueError('`memory_set_index` must be in range [1, 10].')
+    if memory_set_index is not None and not 1 <= memory_set_index <= 20:
+        raise ValueError('`memory_set_index` must be in range [1, 20].')
 
     if not at_home():
         goto_home()
@@ -209,9 +186,13 @@ def do_produce(
     device.screenshot()
     # 点击培育按钮，然后判断是新开还是再开培育
     for _ in Loop(interval=0.6):
-        if image.find(R.Produce.TitleIconProudce):
+        if image.find(R.Produce.LogoHajime): # Hajime培育界面
             # 新开
             break
+        elif image.find(R.Produce.LogoNia): # NIA培育界面
+            device.click(R.Produce.PointNiaToHajime)
+            sleep(0.5)
+            continue
         elif image.find(R.Produce.ButtonResume):
             # 再开
             resume_produce()
@@ -250,7 +231,7 @@ def do_produce(
             # [kotonebot-resource\sprites\jp\produce\screenshot_no_enough_ap_3.png]
             logger.info('AP insufficient. Try to use AP drink.')
             for _ in Loop():
-                if image.find(R.Produce.ButtonUse):
+                if image.find(R.Produce.ButtonUse, colored=True):
                     device.click()
                 elif image.find(R.Produce.ButtonRefillAP):
                     device.click()

{ksaa-2025.8.17.0.dist-info → ksaa-2025.9b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksaa
-Version: 2025.8.17.0
+Version: 2025.9b1
 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**、**万代南梦宫娱乐**或其相关权利方所有。
 
-### 普通用户
-TODO
+2.  **非官方性质**：本项目为非官方、非商业性质的开源项目。本项目的开发者与 **QualiArts** 及 **万代南梦宫娱乐**没有任何形式的关联、合作或官方授权。
+
+### 核心风险与责任限制
+1.  **账号封禁风险**：**您必须清楚地认识到，使用任何形式的第三方自动操作脚本（包括本项目）都有违反《学园偶像大师》的用户协议（利用規約）的潜在风险。游戏运营商有权对使用此类脚本的账号采取惩罚措施，包括但不限于临时或永久封禁账号。对于因使用本脚本而导致的任何账号损失（如封号、数据回滚等），项目作者概不负责。**
+
+> ・对本服务的服务器等进行非法访问、窃取数据、使用使软件进行非法处理的程序、使用工具等获取信息或使用工具等不正当推进游戏的行为。
+
+> ・本サービスのサーバー等への不正アクセス行為、データ窃取行為、ソフトウェアに不正な処理を行わせるプログラムを使用する行為、ツール等を使用して情報を取得する行為またはツール等を使用して不正にゲームを有利に進める行為
+
+2.  **使用限制**：本项目的全部内容**严禁用于任何商业用途或恶意破坏游戏平衡的行为**。任何将本项目用于此类活动的行为，均可能构成对版权方的侵权和对游戏运营商的违约，由此产生的一切法律责任由使用者自行承担。
 
-### 技术用户
+3.  **无担保与责任限制**：本项目按“原样”提供，不附带任何形式的明示或暗示担保，包括其功能的稳定性、准确性或持续可用性。对于因使用或无法使用本项目而导致的任何直接、间接、偶然、特殊或继发性损害（**包括但不限于账号封禁**），项目作者概不负责。
+
+**继续下载、安装或使用本项目，即表示您已完全阅读、理解并同意承担以上所有风险和条款。如果您不同意，请立即停止使用并删除本项目的所有相关文件。**
+
+## 安装与使用
+参见[【金山文档】使用手册](https://p.kdocs.cn/s/6IJJBRRBAAAFS)。
+
+如果你想了解技术细节，可以继续往下阅读。如果只是想要使用 kaa，你可以打开上面的使用手册，关掉这个页面了。
+
+## 安装
 琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
 ```bash
 # Python == 3.10
@@ -90,58 +109,13 @@ 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)
+环境配置见 [DEVELOPMENT.md](./docs/DEVELOPMENT.md)。
+
+开发指南见 [QUICK_START.md](./docs/GUIDE.md)。
 
 ## 贡献
-非常欢迎 PR。
+欢迎 PR。
 
 你可以从 Github Issue 中选择一个 Issue 解决，或者从下面的路线图里选一个任务讨论。
 
@@ -150,32 +124,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 +167,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 实现，以及各模拟器的控制实现。