ksaa 2025.7.5.0__tar.gz → 2025.7.9.0__tar.gz

{ksaa-2025.7.5.0/ksaa.egg-info → ksaa-2025.7.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksaa
-Version: 2025.7.5.0
+Version: 2025.7.9.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

{ksaa-2025.7.5.0 → ksaa-2025.7.9.0}/WHATS_NEW.md

@@ -1,5 +1,54 @@
 # 更新日志
 ## kaa
+### v2025.7.9.0
+脚本：
+* [新增] 配置中支持储存多个培育方案并支持来回切换（#41e7c8b）
+* [重构] 将配置数据中的常量移动到单独一个文件中（#4e4b91d）
+* [重构] 配置迁移代码移动到单独的模块（#c7d5cd8）
+* [重构] 将配置文件类从 kotonebot.kaa.common 中移动到专门的模块 kotonebot.kaa.config（#e0549c6）
+* [修复] 尝试修复周数 OCR 失败问题（#e548518）
+* [修复] 修复某些情况下培育会卡在初始饮料技能卡二选一上（#0651d94）
+* [修复] 修复部分日志缺失的问题（#497561c）
+
+* [重构] 配置迁移代码移动到单独的模块（#c7d5cd8）
+* [重构] 将配置文件类从 kotonebot.kaa.common 中移动到专门的模块 kotonebot.kaa.config（#e0549c6）
+* [修复] 尝试修复周数 OCR 失败问题（#e548518）
+* [修复] 修复某些情况下培育会卡在初始饮料技能卡二选一上（#0651d94）
+* [修复] 修复部分日志缺失的问题（#497561c）
+
+* [修复] 修复部分日志缺失的问题（#497561c）
+
+
+界面：
+* [新增] 为新的培育方案增加 UI（#68b0cbd）
+* [新增] 新增快速功能启停（#c3d2401）
+* [修复] 修复修改设置后需要重启才能生效的问题（#6dd2b35）
+
+框架：
+* [新增] ContextOcr 类支持设置 OCR 语言（#a0d3c31）
+
+其他：
+* [单测] 为新的培育方案编写单元测试（#ca83fec）
+* [其他] v5 到 v6 配置迁移脚本（#ef725b4）
+
+### v2025.7.7.0
+脚本：
+* [修复] 修复 AP 商店购买时点击坐标偏移问题（#b8b56bb）
+* [修复] 修复商店购买时无法识别部分偶像碎片的问题（#353fa3f）
+* [修复] 修复 DMM 版购买时无法进入 AP 商店的问题（#f5a4e50）
+* [修复] 修复商店购买有几率卡在确认购买对话框上（#cf1605d）
+* [修复] 修复某些情况下无法自动关闭领取活动费后的弹窗（#3b3aac6）
+* [新增] 金币商店可选使用每日刷新次数（#68dbc48）
+
+界面：
+* [新增] UI 支持向局域网开放（#9b37bcf）
+
+框架：
+* [新增] 新增目标截图间隔功能（#c8fbf80）
+
+其他：
+* [其他] 删除一些无用 Sprite 资源（#03aa2b5）
+
 ### v2025.7.5.0
 脚本：
 * [修复] 修复有几率无法识别到进行中培育的问题（#50d1403）

{ksaa-2025.7.5.0 → ksaa-2025.7.9.0}/kotonebot/backend/bot.py

@@ -145,6 +145,18 @@ class KotoneBot:
         """
         raise NotImplementedError('Implement `_create_device` before using Kotonebot.')
 
+    def _on_init_context(self) -> None:
+        """
+        初始化 Context 的钩子方法。子类可以重写此方法来自定义初始化逻辑。
+        默认实现调用 init_context 而不传入 target_screenshot_interval。
+        """
+        d = self._on_create_device()
+        init_context(
+            config_path=self.config_path,
+            config_type=self.config_type,
+            target_device=d
+        )
+
     def _on_after_init_context(self):
         """
         抽象方法，在 init_context() 被调用后立即执行。
@@ -155,8 +167,7 @@ class KotoneBot:
         """
         按优先级顺序运行所有任务。
         """
-        d = self._on_create_device()
-        init_context(config_path=self.config_path, config_type=self.config_type, target_device=d)
+        self._on_init_context()
         self._on_after_init_context()
         vars.flow.clear_interrupt()
 

{ksaa-2025.7.5.0 → ksaa-2025.7.9.0}/kotonebot/backend/context/context.py

@@ -27,6 +27,7 @@ from cv2.typing import MatLike
 
 from kotonebot.client.device import Device, AndroidDevice, WindowsDevice
 from kotonebot.backend.flow_controller import FlowController
+from kotonebot.util import Interval
 import kotonebot.backend.image as raw_image
 from kotonebot.backend.image import (
     TemplateMatchResult,
@@ -284,11 +285,17 @@ class ContextOcr:
         self.context = context
         self.__engine = jp()
 
-    def raw(self, lang: OcrLanguage = 'jp') -> Ocr:
+    def _get_engine(self, lang: OcrLanguage | None = None) -> Ocr:
+        """获取指定语言的OCR引擎，如果lang为None则使用默认引擎。"""
+        return self.__engine if lang is None else self.raw(lang)
+
+    def raw(self, lang: OcrLanguage | None = None) -> Ocr:
         """
         返回 `kotonebot.backend.ocr` 中的 Ocr 对象。\n
         Ocr 对象与此对象（ContextOcr）的区别是，此对象会自动截图，而 Ocr 对象需要手动传入图像参数。
         """
+        if lang is None:
+            lang = 'jp'
         match lang:
             case 'jp':
                 return jp()
@@ -300,9 +307,11 @@ class ContextOcr:
     def ocr(
         self,
         rect: Rect | None = None,
+        lang: OcrLanguage | None = None,
     ) -> OcrResultList:
         """OCR 当前设备画面或指定图像。"""
-        return self.__engine.ocr(ContextStackVars.ensure_current().screenshot, rect=rect)
+        engine = self._get_engine(lang)
+        return engine.ocr(ContextStackVars.ensure_current().screenshot, rect=rect)
 
     def find(
         self,
@@ -310,9 +319,11 @@ class ContextOcr:
         *,
         hint: HintBox | None = None,
         rect: Rect | None = None,
+        lang: OcrLanguage | None = None,
     ) -> OcrResult | None:
         """检查当前设备画面是否包含指定文本。"""
-        ret = self.__engine.find(
+        engine = self._get_engine(lang)
+        ret = engine.find(
             ContextStackVars.ensure_current().screenshot,
             pattern,
             hint=hint,
@@ -327,9 +338,10 @@ class ContextOcr:
         *,
         hint: HintBox | None = None,
         rect: Rect | None = None,
-
+        lang: OcrLanguage | None = None,
     ) -> list[OcrResult | None]:
-        return self.__engine.find_all(
+        engine = self._get_engine(lang)
+        return engine.find_all(
             ContextStackVars.ensure_current().screenshot,
             list(patterns),
             hint=hint,
@@ -342,6 +354,7 @@ class ContextOcr:
         *,
         rect: Rect | None = None,
         hint: HintBox | None = None,
+        lang: OcrLanguage | None = None,
     ) -> OcrResult:
 
         """
@@ -349,7 +362,8 @@ class ContextOcr:
 
         与 `find()` 的区别在于，`expect()` 未找到时会抛出异常。
         """
-        ret = self.__engine.expect(ContextStackVars.ensure_current().screenshot, pattern, rect=rect, hint=hint)
+        engine = self._get_engine(lang)
+        ret = engine.expect(ContextStackVars.ensure_current().screenshot, pattern, rect=rect, hint=hint)
         self.context.device.last_find = ret.original_rect if ret else None
         return ret
     
@@ -718,8 +732,20 @@ class Forwarded:
 
 T_Device = TypeVar('T_Device', bound=Device)
 class ContextDevice(Generic[T_Device], Device):
-    def __init__(self, device: T_Device):
+    def __init__(self, device: T_Device, target_screenshot_interval: float | None = None):
+        """
+        :param device: 目标设备。
+        :param target_screenshot_interval: 见 `ContextDevice.target_screenshot_interval`。
+        """
         self._device = device
+        self.target_screenshot_interval: float | None = target_screenshot_interval
+        """
+        目标截图间隔，可用于限制截图速度。若两次截图实际间隔小于该值，则会自动等待。
+        为 None 时不限制截图速度。
+        """
+        self._screenshot_interval: Interval | None = None
+        if self.target_screenshot_interval is not None:
+            self._screenshot_interval = Interval(self.target_screenshot_interval)
 
     def screenshot(self, *, force: bool = False):
         """
@@ -734,6 +760,9 @@ class ContextDevice(Generic[T_Device], Device):
             img = current._inherit_screenshot
             current._inherit_screenshot = None
         else:
+            if self._screenshot_interval is not None:
+                self._screenshot_interval.wait()
+
             if next_wait == 'screenshot':
                 delta = time.time() - last_screenshot_time
                 if delta < next_wait_time:
@@ -780,7 +809,8 @@ class Context(Generic[T]):
         self,
         config_path: str,
         config_type: Type[T],
-        device: Device
+        device: Device,
+        target_screenshot_interval: float | None = None
     ):
         self.__ocr = ContextOcr(self)
         self.__image = ContextImage(self)
@@ -788,7 +818,7 @@ class Context(Generic[T]):
         self.__vars = ContextGlobalVars()
         self.__debug = ContextDebug(self)
         self.__config = ContextConfig[T](self, config_path, config_type)
-        self.__device = ContextDevice(device)
+        self.__device = ContextDevice(device, target_screenshot_interval)
 
     def inject(
         self,
@@ -900,6 +930,7 @@ def init_context(
     config_type: Type[T] = dict[str, Any],
     force: bool = False,
     target_device: Device,
+    target_screenshot_interval: float | None = None,
 ):
     """
     初始化 Context 模块。
@@ -911,6 +942,7 @@ def init_context(
     :param force:  是否强制重新初始化。
         若为 `True`，则忽略已存在的 Context 实例，并重新创建一个新的实例。
     :param target_device: 目标设备
+    :param target_screenshot_interval: 见 `ContextDevice.target_screenshot_interval`。
     """
     global _c, device, ocr, image, color, vars, debug, config
     if _c is not None and not force:
@@ -919,6 +951,7 @@ def init_context(
         config_path=config_path,
         config_type=config_type,
         device=target_device,
+        target_screenshot_interval=target_screenshot_interval,
     )
     device._FORWARD_getter = lambda: _c.device # type: ignore
     ocr._FORWARD_getter = lambda: _c.ocr # type: ignore

{ksaa-2025.7.5.0 → ksaa-2025.7.9.0}/kotonebot/config/base_config.py

@@ -50,6 +50,8 @@ class BackendConfig(ConfigBaseModel):
     """Windows 截图方式的 AutoHotkey 可执行文件路径，为 None 时使用默认路径"""
     mumu_background_mode: bool = False
     """MuMu12 模拟器后台保活模式"""
+    target_screenshot_interval: float | None = None
+    """最小截图间隔，单位为秒。为 None 时不限制截图速度。"""
 
 class PushConfig(ConfigBaseModel):
     """推送配置。"""

ksaa-2025.7.9.0/kotonebot/kaa/common.py

@@ -0,0 +1,22 @@
+import os
+import json
+import shutil
+from importlib import resources
+from typing import Literal, TypeVar, Any, Sequence
+from typing_extensions import assert_never
+from enum import IntEnum, Enum
+
+from pydantic import BaseModel, ConfigDict
+
+# TODO: from kotonebot import config (context) 会和 kotonebot.config 冲突
+from kotonebot import logging
+from kotonebot.backend.context import config
+from kotonebot.kaa.config.schema import BaseConfig
+
+logger = logging.getLogger(__name__)
+
+def sprite_path(path: str) -> str:
+    standalone = os.path.join('kotonebot/kaa/sprites', path)
+    if os.path.exists(standalone):
+        return standalone
+    return str(resources.files('kotonebot.kaa.sprites') / path)

ksaa-2025.7.9.0/kotonebot/kaa/config/__init__.py

@@ -0,0 +1,62 @@
+from .schema import (
+    BaseConfig,
+    PurchaseConfig,
+    ActivityFundsConfig,
+    PresentsConfig,
+    AssignmentConfig,
+    ContestConfig,
+    ProduceConfig,
+    MissionRewardConfig,
+    ClubRewardConfig,
+    UpgradeSupportCardConfig,
+    CapsuleToysConfig,
+    TraceConfig,
+    StartGameConfig,
+    EndGameConfig,
+    MiscConfig,
+    conf,
+)
+from .const import (
+    ConfigEnum,
+    Priority,
+    APShopItems,
+    DailyMoneyShopItems,
+    ProduceAction,
+    RecommendCardDetectionMode,
+)
+
+# 配置升级逻辑
+from .upgrade import upgrade_config
+from .migrations import MIGRATION_REGISTRY, LATEST_VERSION
+
+__all__ = [
+    # schema 导出
+    "BaseConfig",
+    "PurchaseConfig",
+    "ActivityFundsConfig",
+    "PresentsConfig",
+    "AssignmentConfig",
+    "ContestConfig",
+    "ProduceConfig",
+    "MissionRewardConfig",
+    "ClubRewardConfig",
+    "UpgradeSupportCardConfig",
+    "CapsuleToysConfig",
+    "TraceConfig",
+    "StartGameConfig",
+    "EndGameConfig",
+    "MiscConfig",
+    "conf",
+    # const 导出
+    "ConfigEnum",
+    "Priority",
+    "APShopItems",
+    "DailyMoneyShopItems",
+    "ProduceAction",
+    "RecommendCardDetectionMode",
+    # upgrade 导出
+    "upgrade_config",
+    "migrations",
+    "MIGRATION_REGISTRY",
+    "LATEST_VERSION",
+]

ksaa-2025.7.9.0/kotonebot/kaa/config/const.py

@@ -0,0 +1,255 @@
+from enum import IntEnum, Enum
+from typing_extensions import assert_never
+
+
+class ConfigEnum(Enum):
+    def display(self) -> str:
+        return self.value[1]
+
+
+class Priority(IntEnum):
+    """
+    任务优先级。数字越大，优先级越高，越先执行。
+    """
+    START_GAME = 1
+    DEFAULT = 0
+    CLAIM_MISSION_REWARD = -1
+    END_GAME = -2
+
+
+class APShopItems(IntEnum):
+    PRODUCE_PT_UP = 0
+    """获取支援强化 Pt 提升"""
+    PRODUCE_NOTE_UP = 1
+    """获取笔记数提升"""
+    RECHALLENGE = 2
+    """再挑战券"""
+    REGENERATE_MEMORY = 3
+    """回忆再生成券"""
+
+
+class DailyMoneyShopItems(IntEnum):
+    """日常商店物品"""
+    Recommendations = -1
+    """所有推荐商品"""
+    LessonNote = 0
+    """レッスンノート"""
+    VeteranNote = 1
+    """ベテランノート"""
+    SupportEnhancementPt = 2
+    """サポート強化Pt 支援强化Pt"""
+    SenseNoteVocal = 3
+    """センスノート（ボーカル）感性笔记（声乐）"""
+    SenseNoteDance = 4
+    """センスノート（ダンス）感性笔记（舞蹈）"""
+    SenseNoteVisual = 5
+    """センスノート（ビジュアル）感性笔记（形象）"""
+    LogicNoteVocal = 6
+    """ロジックノート（ボーカル）理性笔记（声乐）"""
+    LogicNoteDance = 7
+    """ロジックノート（ダンス）理性笔记（舞蹈）"""
+    LogicNoteVisual = 8
+    """ロジックノート（ビジュアル）理性笔记（形象）"""
+    AnomalyNoteVocal = 9
+    """アノマリーノート（ボーカル）非凡笔记（声乐）"""
+    AnomalyNoteDance = 10
+    """アノマリーノート（ダンス）非凡笔记（舞蹈）"""
+    AnomalyNoteVisual = 11
+    """アノマリーノート（ビジュアル）非凡笔记（形象）"""
+    RechallengeTicket = 12
+    """再挑戦チケット 重新挑战券"""
+    RecordKey = 13
+    """記録の鍵 解锁交流的物品"""
+
+    # 碎片
+    IdolPiece_倉本千奈_WonderScale = 14
+    """倉本千奈 WonderScale 碎片"""
+    IdolPiece_篠泽广_光景 = 15
+    """篠泽广 光景 碎片"""
+    IdolPiece_紫云清夏_TameLieOneStep = 16
+    """紫云清夏 Tame-Lie-One-Step 碎片"""
+    IdolPiece_葛城リーリヤ_白線 = 17
+    """葛城リーリヤ 白線 碎片"""
+    IdolPiece_姬崎莉波_clumsy_trick = 18
+    """姫崎薪波 cIclumsy trick 碎片"""
+    IdolPiece_花海咲季_FightingMyWay = 19
+    """花海咲季 FightingMyWay 碎片"""
+    IdolPiece_藤田ことね_世界一可愛い私 = 20
+    """藤田ことね 世界一可愛い私 碎片"""
+    IdolPiece_花海佑芽_TheRollingRiceball = 21
+    """花海佑芽 The Rolling Riceball 碎片"""
+    IdolPiece_月村手毬_LunaSayMaybe = 22
+    """月村手毬 Luna say maybe 碎片"""
+    IdolPiece_有村麻央_Fluorite = 23
+    """有村麻央 Fluorite 碎片"""
+
+    @classmethod
+    def to_ui_text(cls, item: "DailyMoneyShopItems") -> str:
+        """获取枚举值对应的UI显示文本"""
+        match item:
+            case cls.Recommendations:
+                return "所有推荐商品"
+            case cls.LessonNote:
+                return "课程笔记"
+            case cls.VeteranNote:
+                return "老手笔记"
+            case cls.SupportEnhancementPt:
+                return "支援强化点数"
+            case cls.SenseNoteVocal:
+                return "感性笔记（声乐）"
+            case cls.SenseNoteDance:
+                return "感性笔记（舞蹈）"
+            case cls.SenseNoteVisual:
+                return "感性笔记（形象）"
+            case cls.LogicNoteVocal:
+                return "理性笔记（声乐）"
+            case cls.LogicNoteDance:
+                return "理性笔记（舞蹈）"
+            case cls.LogicNoteVisual:
+                return "理性笔记（形象）"
+            case cls.AnomalyNoteVocal:
+                return "非凡笔记（声乐）"
+            case cls.AnomalyNoteDance:
+                return "非凡笔记（舞蹈）"
+            case cls.AnomalyNoteVisual:
+                return "非凡笔记（形象）"
+            case cls.RechallengeTicket:
+                return "重新挑战券"
+            case cls.RecordKey:
+                return "记录钥匙"
+            case cls.IdolPiece_倉本千奈_WonderScale:
+                return "倉本千奈　WonderScale 碎片"
+            case cls.IdolPiece_篠泽广_光景:
+                return "篠泽广　光景 碎片"
+            case cls.IdolPiece_紫云清夏_TameLieOneStep:
+                return "紫云清夏　Tame-Lie-One-Step 碎片"
+            case cls.IdolPiece_葛城リーリヤ_白線:
+                return "葛城リーリヤ　白線 碎片"
+            case cls.IdolPiece_姬崎莉波_clumsy_trick:
+                return "姫崎薪波　clumsy trick 碎片"
+            case cls.IdolPiece_花海咲季_FightingMyWay:
+                return "花海咲季　FightingMyWay 碎片"
+            case cls.IdolPiece_藤田ことね_世界一可愛い私:
+                return "藤田ことね　世界一可愛い私 碎片"
+            case cls.IdolPiece_花海佑芽_TheRollingRiceball:
+                return "花海佑芽　The Rolling Riceball 碎片"
+            case cls.IdolPiece_月村手毬_LunaSayMaybe:
+                return "月村手毬　Luna say maybe 碎片"
+            case cls.IdolPiece_有村麻央_Fluorite:
+                return "有村麻央　Fluorite 碎片"
+            case _:
+                assert_never(item)
+
+    @classmethod
+    def all(cls) -> list[tuple[str, 'DailyMoneyShopItems']]:
+        """获取所有枚举值及其对应的UI显示文本"""
+        return [(cls.to_ui_text(item), item) for item in cls]
+
+    @classmethod
+    def _is_note(cls, item: 'DailyMoneyShopItems') -> bool:
+        """判断是否为笔记"""
+        return 'Note' in item.name and not item.name.startswith('Note') and not item.name.endswith('Note')
+
+    @classmethod
+    def note_items(cls) -> list[tuple[str, 'DailyMoneyShopItems']]:
+        """获取所有枚举值及其对应的UI显示文本"""
+        return [(cls.to_ui_text(item), item) for item in cls if cls._is_note(item)]
+
+    def to_resource(self):
+        from kotonebot.kaa.tasks import R
+        match self:
+            case DailyMoneyShopItems.Recommendations:
+                return R.Daily.TextShopRecommended
+            case DailyMoneyShopItems.LessonNote:
+                return R.Shop.ItemLessonNote
+            case DailyMoneyShopItems.VeteranNote:
+                return R.Shop.ItemVeteranNote
+            case DailyMoneyShopItems.SupportEnhancementPt:
+                return R.Shop.ItemSupportEnhancementPt
+            case DailyMoneyShopItems.SenseNoteVocal:
+                return R.Shop.ItemSenseNoteVocal
+            case DailyMoneyShopItems.SenseNoteDance:
+                return R.Shop.ItemSenseNoteDance
+            case DailyMoneyShopItems.SenseNoteVisual:
+                return R.Shop.ItemSenseNoteVisual
+            case DailyMoneyShopItems.LogicNoteVocal:
+                return R.Shop.ItemLogicNoteVocal
+            case DailyMoneyShopItems.LogicNoteDance:
+                return R.Shop.ItemLogicNoteDance
+            case DailyMoneyShopItems.LogicNoteVisual:
+                return R.Shop.ItemLogicNoteVisual
+            case DailyMoneyShopItems.AnomalyNoteVocal:
+                return R.Shop.ItemAnomalyNoteVocal
+            case DailyMoneyShopItems.AnomalyNoteDance:
+                return R.Shop.ItemAnomalyNoteDance
+            case DailyMoneyShopItems.AnomalyNoteVisual:
+                return R.Shop.ItemAnomalyNoteVisual
+            case DailyMoneyShopItems.RechallengeTicket:
+                return R.Shop.ItemRechallengeTicket
+            case DailyMoneyShopItems.RecordKey:
+                return R.Shop.ItemRecordKey
+            case DailyMoneyShopItems.IdolPiece_倉本千奈_WonderScale:
+                return R.Shop.IdolPiece.倉本千奈_WonderScale
+            case DailyMoneyShopItems.IdolPiece_篠泽广_光景:
+                return R.Shop.IdolPiece.篠泽广_光景
+            case DailyMoneyShopItems.IdolPiece_紫云清夏_TameLieOneStep:
+                return R.Shop.IdolPiece.紫云清夏_TameLieOneStep
+            case DailyMoneyShopItems.IdolPiece_葛城リーリヤ_白線:
+                return R.Shop.IdolPiece.葛城リーリヤ_白線
+            case DailyMoneyShopItems.IdolPiece_姬崎莉波_clumsy_trick:
+                return R.Shop.IdolPiece.姬崎莉波_clumsy_trick
+            case DailyMoneyShopItems.IdolPiece_花海咲季_FightingMyWay:
+                return R.Shop.IdolPiece.花海咲季_FightingMyWay
+            case DailyMoneyShopItems.IdolPiece_藤田ことね_世界一可愛い私:
+                return R.Shop.IdolPiece.藤田ことね_世界一可愛い私
+            case DailyMoneyShopItems.IdolPiece_花海佑芽_TheRollingRiceball:
+                return R.Shop.IdolPiece.花海佑芽_TheRollingRiceball
+            case DailyMoneyShopItems.IdolPiece_月村手毬_LunaSayMaybe:
+                return R.Shop.IdolPiece.月村手毬_LunaSayMaybe
+            case DailyMoneyShopItems.IdolPiece_有村麻央_Fluorite:
+                return R.Shop.IdolPiece.有村麻央_Fluorite
+            case _:
+                assert_never(self)
+
+
+class ProduceAction(Enum):
+    RECOMMENDED = 'recommended'
+    VISUAL = 'visual'
+    VOCAL = 'vocal'
+    DANCE = 'dance'
+    # VISUAL_SP = 'visual_sp'
+    # VOCAL_SP = 'vocal_sp'
+    # DANCE_SP = 'dance_sp'
+    OUTING = 'outing'
+    STUDY = 'study'
+    ALLOWANCE = 'allowance'
+    REST = 'rest'
+    CONSULT = 'consult'
+
+    @property
+    def display_name(self):
+        MAP = {
+            ProduceAction.RECOMMENDED: '推荐行动',
+            ProduceAction.VISUAL: '形象课程',
+            ProduceAction.VOCAL: '声乐课程',
+            ProduceAction.DANCE: '舞蹈课程',
+            ProduceAction.OUTING: '外出（おでかけ）',
+            ProduceAction.STUDY: '文化课（授業）',
+            ProduceAction.ALLOWANCE: '活动支给（活動支給）',
+            ProduceAction.REST: '休息',
+            ProduceAction.CONSULT: '咨询（相談）',
+        }
+        return MAP[self]
+
+
+class RecommendCardDetectionMode(Enum):
+    NORMAL = 'normal'
+    STRICT = 'strict'
+
+    @property
+    def display_name(self):
+        MAP = {
+            RecommendCardDetectionMode.NORMAL: '正常模式',
+            RecommendCardDetectionMode.STRICT: '严格模式',
+        }
+        return MAP[self]

ksaa-2025.7.9.0/kotonebot/kaa/config/migrations/__init__.py

@@ -0,0 +1,28 @@
+from typing import Callable, Any, Dict
+
+# 迁移函数类型：接收单个 user_config(dict)，就地修改并返回提示信息
+Migration = Callable[[dict[str, Any]], str | None]
+
+# 导入各版本迁移实现
+from . import _v1_to_v2
+from . import _v2_to_v3
+from . import _v3_to_v4
+from . import _v4_to_v5
+from . import _v5_to_v6
+
+# 注册表：键为旧版本号，值为迁移函数
+MIGRATION_REGISTRY: Dict[int, Migration] = {
+    1: _v1_to_v2.migrate,
+    2: _v2_to_v3.migrate,
+    3: _v3_to_v4.migrate,
+    4: _v4_to_v5.migrate,
+    5: _v5_to_v6.migrate,
+}
+
+# 当前最新配置版本
+LATEST_VERSION: int = 6
+
+__all__ = [
+    "MIGRATION_REGISTRY",
+    "LATEST_VERSION",
+]