ksaa 2025.9.post2__py3-none-any.whl → 2025.11__py3-none-any.whl

kaa/application/ui/views/status_view.py

@@ -0,0 +1,171 @@
+import gradio as gr
+from kaa.application.ui.facade import KaaFacade, ConfigValidationError
+from kaa.application.ui.common import GradioComponents
+
+class StatusView:
+    def __init__(self, facade: KaaFacade, components: GradioComponents):
+        self.facade = facade
+        self.components = components
+
+    def create_ui(self):
+        """Creates the content for the 'Status' tab."""
+        gr.Markdown("## 状态")
+
+        def _get_end_action_value() -> str:
+            end_game_opts = self.facade.config_service.get_options().end_game
+            if end_game_opts.shutdown:
+                return "完成后关机"
+            if end_game_opts.hibernate:
+                return "完成后休眠"
+            return "完成后什么都不做"
+
+        with gr.Row():
+            run_btn = gr.Button("启动", scale=0, variant='primary', min_width=300)
+            pause_btn = gr.Button("暂停", scale=0)
+            with gr.Column(scale=0):
+                end_action_dropdown = gr.Dropdown(
+                    show_label=False,
+                    choices=["完成后什么都不做", "完成后关机", "完成后休眠"],
+                    value=_get_end_action_value(),
+                    interactive=True,
+                    elem_classes="no-padding-dropdown",
+                )
+
+        self.components.run_btn = run_btn
+        self.components.pause_btn = pause_btn
+        self.components.end_action_dropdown = end_action_dropdown
+
+        gr.Markdown("### 快速设置")
+
+        with gr.Row():
+            select_all_btn = gr.Button("全选", scale=0)
+            unselect_all_btn = gr.Button("清空", scale=0)
+            select_produce_only_btn = gr.Button("只选培育", scale=0)
+            unselect_produce_only_btn = gr.Button("只不选培育", scale=0)
+
+        with gr.Row(elem_classes=["quick-controls-row"]):
+            opts = self.facade.config_service.get_options()
+            purchase_quick = gr.Checkbox(label="商店", value=opts.purchase.enabled, interactive=True)
+            assignment_quick = gr.Checkbox(label="工作", value=opts.assignment.enabled, interactive=True)
+            contest_quick = gr.Checkbox(label="竞赛", value=opts.contest.enabled, interactive=True)
+            produce_quick = gr.Checkbox(label="培育", value=opts.produce.enabled, interactive=True)
+            mission_reward_quick = gr.Checkbox(label="任务", value=opts.mission_reward.enabled, interactive=True)
+            club_reward_quick = gr.Checkbox(label="社团", value=opts.club_reward.enabled, interactive=True)
+            activity_funds_quick = gr.Checkbox(label="活动费", value=opts.activity_funds.enabled, interactive=True)
+            presents_quick = gr.Checkbox(label="礼物", value=opts.presents.enabled, interactive=True)
+            capsule_toys_quick = gr.Checkbox(label="扭蛋", value=opts.capsule_toys.enabled, interactive=True)
+            upgrade_support_card_quick = gr.Checkbox(label="支援卡", value=opts.upgrade_support_card.enabled, interactive=True)
+
+        self.components.quick_checkboxes = [
+            purchase_quick, assignment_quick, contest_quick, produce_quick,
+            mission_reward_quick, club_reward_quick, activity_funds_quick, presents_quick,
+            capsule_toys_quick, upgrade_support_card_quick
+        ]
+
+        if self.facade._kaa.upgrade_msg:
+            gr.Markdown('### 配置升级报告')
+            gr.Markdown(self.facade._kaa.upgrade_msg)
+        gr.Markdown('脚本报错或者卡住？前往"反馈"选项卡可以快速导出报告！')
+
+        if self.facade.config_service.get_current_user_config().keep_screenshots:
+            gr.Markdown(
+                '<div style="color: red; font-size: larger;">当前启用了调试功能「保留截图数据」，调试结束后正常使用时建议关闭此选项！</div>'
+            )
+
+        with gr.Row():
+            task_runtime_text = gr.Textbox(
+                label="任务运行时间",
+                value="未运行",
+                interactive=False,
+                scale=1
+            )
+        self.components.task_runtime_text = task_runtime_text
+
+        task_status_df = gr.Dataframe(headers=["任务", "状态"], label="任务状态")
+        self.components.task_status_df = task_status_df
+
+        # --- Event Handlers ---
+
+        def on_run_click():
+            if self.facade.task_service.is_running_all:
+                self.facade.stop_all_tasks()
+            else:
+                self.facade.start_all_tasks()
+
+        def on_pause_click():
+            self.facade.toggle_pause()
+
+        def save_quick_setting(success_msg: str, failed_msg: str):
+            """保存快速设置并立即应用"""
+            try:
+                # 保存配置
+                msg = self.facade.save_configs()
+                # 尝试热重载配置
+                gr.Success(success_msg)
+            except (ConfigValidationError, RuntimeError) as e:
+                gr.Warning(str(e))
+            except Exception as e:
+                gr.Error(f"保存失败: {e}")
+
+        def update_and_save_quick_setting(field_name: str, value: bool, display_name: str):
+            """更新字段，并保存快速设置并立即应用"""
+            # 更新配置
+            options = self.facade.config_service.get_options()
+            parts = field_name.split('.')
+            obj = options
+            for part in parts[:-1]:
+                obj = getattr(obj, part)
+            setattr(obj, parts[-1], value)
+            save_quick_setting(
+                f"✓ {display_name} 已{'启用' if value else '禁用'}",
+                f"⚠ {display_name} 设置已保存但重载失败"
+            )
+
+        def batch_select(default: bool, produce_only: bool, success_msg: str):
+            opts = self.facade.config_service.get_options()
+            opts.purchase.enabled = default
+            opts.assignment.enabled = default
+            opts.contest.enabled = default
+            opts.produce.enabled = produce_only
+            opts.mission_reward.enabled = default
+            opts.club_reward.enabled = default
+            opts.activity_funds.enabled = default
+            opts.presents.enabled = default
+            opts.capsule_toys.enabled = default
+            opts.upgrade_support_card.enabled = default
+            save_quick_setting(success_msg, "⚠ 数据已保存，但重新加载失败")
+
+        def save_quick_end_action(action: str):
+            opts = self.facade.config_service.get_options().end_game
+            if action == "完成后关机":
+                opts.shutdown = True
+                opts.hibernate = False
+            elif action == "完成后休眠":
+                opts.shutdown = False
+                opts.hibernate = True
+            else: # This covers "完成后什么都不做"
+                opts.shutdown = False
+                opts.hibernate = False
+            save_quick_setting(f"✓ 完成后操作已设置为 {action}", "⚠ 设置已保存，但重新加载失败")
+
+        # --- UI Callbacks ---
+        run_btn.click(fn=on_run_click, outputs=None)
+        pause_btn.click(fn=on_pause_click, outputs=None)
+
+        select_all_btn.click(fn=lambda: batch_select(True, True, "✓ 全选成功"), outputs=None)
+        unselect_all_btn.click(fn=lambda: batch_select(False, False, "✓ 清空成功"), outputs=None)
+        select_produce_only_btn.click(fn=lambda: batch_select(False, True, "✓ 只选培育成功"), outputs=None)
+        unselect_produce_only_btn.click(fn=lambda: batch_select(True, False, "✓ 只不选培育成功"), outputs=None)
+
+        # .input is used to only trigger on user interaction
+        purchase_quick.input(fn=lambda x: update_and_save_quick_setting('purchase.enabled', x, '商店'), inputs=[purchase_quick])
+        assignment_quick.input(fn=lambda x: update_and_save_quick_setting('assignment.enabled', x, '工作'), inputs=[assignment_quick])
+        contest_quick.input(fn=lambda x: update_and_save_quick_setting('contest.enabled', x, '竞赛'), inputs=[contest_quick])
+        produce_quick.input(fn=lambda x: update_and_save_quick_setting('produce.enabled', x, '培育'), inputs=[produce_quick])
+        mission_reward_quick.input(fn=lambda x: update_and_save_quick_setting('mission_reward.enabled', x, '任务奖励'), inputs=[mission_reward_quick])
+        club_reward_quick.input(fn=lambda x: update_and_save_quick_setting('club_reward.enabled', x, '社团奖励'), inputs=[club_reward_quick])
+        activity_funds_quick.input(fn=lambda x: update_and_save_quick_setting('activity_funds.enabled', x, '活动费'), inputs=[activity_funds_quick])
+        presents_quick.input(fn=lambda x: update_and_save_quick_setting('presents.enabled', x, '礼物'), inputs=[presents_quick])
+        capsule_toys_quick.input(fn=lambda x: update_and_save_quick_setting('capsule_toys.enabled', x, '扭蛋'), inputs=[capsule_toys_quick])
+        upgrade_support_card_quick.input(fn=lambda x: update_and_save_quick_setting('upgrade_support_card.enabled', x, '支援卡升级'), inputs=[upgrade_support_card_quick])
+        end_action_dropdown.change(fn=save_quick_end_action, inputs=[end_action_dropdown])

kaa/application/ui/views/task_view.py

@@ -0,0 +1,102 @@
+import gradio as gr
+from kaa.application.ui.facade import KaaFacade
+from kaa.application.ui.common import GradioComponents
+
+class TaskView:
+    def __init__(self, facade: KaaFacade, components: GradioComponents):
+        self.facade = facade
+        self.components = components
+
+    def create_ui(self):
+        """Creates the content for the 'Task' tab for running single tasks."""
+        gr.Markdown("## 执行任务")
+
+        # Get all tasks from the facade
+        task_names = self.facade.task_service.get_all_task_names()
+        
+        with gr.Row():
+            stop_all_btn = gr.Button("停止任务", variant="stop", scale=1)
+            pause_btn = gr.Button("暂停", scale=1)
+
+        task_result = gr.Markdown("")
+        
+        task_buttons = []
+        for task_name in task_names:
+            with gr.Row():
+                with gr.Column(scale=1, min_width=50):
+                    task_btn = gr.Button("启动", variant="primary", size="sm")
+                    task_buttons.append(task_btn)
+                with gr.Column(scale=7):
+                    gr.Markdown(f"### {task_name}")
+
+        def start_single_task_by_name(task_name: str):
+            """Event handler to start a single task."""
+            try:
+                self.facade.task_service.start_single_task(task_name)
+                gr.Info(f"任务 {task_name} 开始执行")
+            except ValueError as e:
+                gr.Warning(str(e))
+            except Exception as e:
+                gr.Error(f"启动任务失败: {e}")
+
+        def stop_all_tasks():
+            """Event handler to stop the running single task."""
+            self.facade.task_service.stop_tasks()
+            self.facade.idle_mgr.notify_on_stop()
+
+        def on_pause_click():
+            self.facade.toggle_pause()
+
+        # Bind click events
+        for i, task_name in enumerate(task_names):
+            # Use a closure/factory function to capture the correct task_name
+            def create_handler(name):
+                return lambda: start_single_task_by_name(name)
+            task_buttons[i].click(fn=create_handler(task_name), outputs=None)
+
+        stop_all_btn.click(fn=stop_all_tasks, outputs=None)
+        pause_btn.click(fn=on_pause_click, outputs=None)
+        
+        # --- Timers for status updates ---
+
+        def update_task_ui_status():
+            tcs = self.facade.task_service
+            is_running = tcs.is_running_single
+            is_stopping = tcs.is_stopping
+
+            # Update buttons
+            btn_updates = {}
+            if is_running or is_stopping:
+                btn_text = "停止中" if is_stopping else "运行中"
+                for btn in task_buttons:
+                    btn_updates[btn] = gr.Button(value=btn_text, interactive=False)
+            else:
+                for btn in task_buttons:
+                    btn_updates[btn] = gr.Button(value="启动", interactive=True)
+            
+            # Update status message
+            status_msg = ""
+            if is_running:
+                for name, status in tcs.get_task_statuses():
+                    if status == 'running':
+                        status_msg = f"正在执行任务: {name}"
+                        break
+            elif not tcs.run_status or not tcs.run_status.running:
+                 # Task finished, find final status
+                if tcs.run_status and tcs.run_status.tasks:
+                    final_status = tcs.run_status.tasks[0]
+                    status_map = {'finished': '已完成', 'error': '出错', 'cancelled': '已取消'}
+                    status_msg = f"任务 {final_status.task.name} {status_map.get(final_status.status, '已结束')}"
+
+            btn_updates[task_result] = gr.Markdown(value=status_msg)
+
+            # Update pause button
+            pause_status = self.facade.get_pause_button_status()
+            btn_updates[pause_btn] = gr.Button(value=pause_status['text'], interactive=pause_status['interactive'])
+            
+            return btn_updates
+
+        gr.Timer(1.0).tick(
+            fn=update_task_ui_status,
+            outputs=task_buttons + [task_result, pause_btn]
+        )

kaa/application/ui/views/update_view.py

@@ -0,0 +1,106 @@
+import gradio as gr
+import logging
+from typing import Generator, Tuple
+from kaa.application.ui.facade import KaaFacade
+from kaa.application.ui.common import GradioComponents
+from kaa.errors import UpdateServiceError, UpdateFetchListError
+
+logger = logging.getLogger(__name__)
+
+class UpdateView:
+    def __init__(self, facade: KaaFacade, components: GradioComponents):
+        self.facade = facade
+        self.components = components
+
+    def create_ui(self):
+        """Creates the content for the 'Update' tab."""
+        with gr.Tab("更新"):
+            gr.Markdown("## 版本管理")
+            
+            with gr.Accordion("更新日志", open=False):
+                try:
+                    from kaa.metadata import WHATS_NEW
+                    gr.Markdown(WHATS_NEW)
+                except ImportError:
+                    gr.Markdown("更新日志不可用")
+            
+            load_info_btn = gr.Button("载入信息", variant="primary")
+            status_text = gr.Markdown("")
+            version_dropdown = gr.Dropdown(
+                label="选择要安装的版本",
+                choices=[],
+                value=None,
+                visible=False,
+                interactive=True
+            )
+            install_selected_btn = gr.Button("安装选定版本", visible=False)
+            
+            # Store components for later access
+            self.components.update_status_text = status_text
+            self.components.update_version_dropdown = version_dropdown
+            self.components.update_install_btn = install_selected_btn
+
+            def on_load_info():
+                """使用 UpdateService 加载版本信息。"""
+                yield (
+                    "正在载入版本信息...",
+                    gr.Button(value="载入中...", interactive=False),
+                    gr.Dropdown(visible=False),
+                    gr.Button(visible=False)
+                )
+                try:
+                    versions_data = self.facade.update_service.list_remote_versions()
+                except UpdateFetchListError as e:
+                    gr.Error(str(e))
+                    yield (
+                        str(e),
+                        gr.Button(value="载入信息", interactive=True),
+                        gr.Dropdown(visible=False),
+                        gr.Button(visible=False)
+                    )
+                    return
+
+                status_info = [
+                    f"**当前安装版本:** {versions_data.installed_version or '未知'}",
+                    f"**最新版本:** {versions_data.latest or '未知'}",
+                ]
+                if versions_data.launcher_version:
+                    if versions_data.launcher_version == "0.4.x":
+                        status_info.append("**启动器版本:** < v0.5.0 (旧版本)")
+                    else:
+                        status_info.append(f"**启动器版本:** v{versions_data.launcher_version}")
+                else:
+                    status_info.append("**启动器版本:** 未知")
+                
+                status_info.append(f"**找到 {len(versions_data.versions)} 个可用版本**")
+                status_message = "\n\n".join(status_info)
+
+                yield (
+                    status_message,
+                    gr.Button(value="载入信息", interactive=True),
+                    gr.Dropdown(choices=versions_data.versions, value=versions_data.versions[0] if versions_data.versions else None, visible=True),
+                    gr.Button(visible=True)
+                )
+
+            def on_install_selected(selected_version: str):
+                """使用 UpdateService 安装所选版本。"""
+                if not selected_version:
+                    gr.Warning("请先选择一个版本。")
+                    return
+
+                try:
+                    self.facade.update_service.install_version(selected_version)
+                    gr.Info(f"正在启动器中安装版本 {selected_version}，程序将自动重启...")
+                except UpdateServiceError as e:
+                    gr.Error(str(e))
+
+            load_info_btn.click(
+                fn=on_load_info,
+                outputs=[status_text, load_info_btn, version_dropdown, install_selected_btn]
+            )
+
+            install_selected_btn.click(
+                fn=on_install_selected,
+                inputs=[version_dropdown],
+                outputs=[] 
+            )

kaa/config/schema.py

@@ -3,6 +3,7 @@ from pydantic import BaseModel, ConfigDict
 
 from kotonebot import config
 from kaa.config.produce import ProduceSolution, ProduceSolutionManager
+from kaa.errors import NoProduceSolutionSelectedError
 from .const import (
     ConfigEnum,
     Priority,
@@ -30,6 +31,8 @@ class PurchaseConfig(ConfigBaseModel):
     """是否启用AP购买"""
     ap_items: Sequence[Literal[0, 1, 2, 3]] = []
     """AP商店要购买的物品"""
+    weekly_enabled: bool = False
+    """是否启用周免费礼包购买"""
 
 
 class ActivityFundsConfig(ConfigBaseModel):
@@ -77,6 +80,16 @@ class ProduceConfig(ConfigBaseModel):
     """培育的次数。"""
     produce_timeout_cd: int = 60
     """推荐卡检测用时上限；若超时，则随机选择卡片打出。单位为秒，最少为20sec，DMM用户可以设置为30sec"""
+    interrupt_timeout: int = 90
+    """检测超时时间。单位秒。"""
+    enable_fever_month: Literal['on', 'off', 'ignore'] = 'ignore'
+    """
+    是否自动启用强化月间。
+
+    * on: 自动启用
+    * off: 自动禁用
+    * ignore: 不改变当前状态
+    """
 
 class MissionRewardConfig(ConfigBaseModel):
     enabled: bool = False
@@ -125,21 +138,24 @@ class StartGameConfig(ConfigBaseModel):
 
     kuyo_package_name: str = 'org.kuyo.game'
     """Kuyo包名"""
-    
+
     disable_gakumas_localify: bool = False
     """
     自动检测并禁用 Gakumas Localify 汉化插件。
-    
+
     （目前仅对 DMM 版有效。）
     """
-    
+
     dmm_game_path: str | None = None
     """
     DMM 版游戏路径。若不填写，会自动检测。
-    
+
     例：`F:\\Games\\gakumas\\gakumas.exe`
     """
 
+    dmm_bypass: bool = False
+    """绕过 DMM 启动器直接启动游戏（实验性）"""
+
 class EndGameConfig(ConfigBaseModel):
     exit_kaa: bool = False
     """退出 kaa"""
@@ -157,7 +173,7 @@ class EndGameConfig(ConfigBaseModel):
     """
     恢复 Gakumas Localify 汉化插件状态至启动前。通常与
     `disable_gakumas_localify` 配对使用。
-    
+
     （目前仅对 DMM 版有效。）
     """
 
@@ -188,6 +204,10 @@ class MiscConfig(ConfigBaseModel):
     * release: 只使用稳定版。
     * beta: 包含预发布版本（如 alpha/beta/rc）。
     """
+    log_level: Literal['debug', 'verbose'] = 'debug'
+    """
+    日志等级。
+    """
 
 class IdleModeConfig(ConfigBaseModel):
     enabled: bool = False
@@ -253,6 +273,6 @@ def produce_solution() -> ProduceSolution:
     """获取当前培育方案"""
     id = conf().produce.selected_solution_id
     if id is None:
-        raise ValueError("No produce solution selected")
+        raise NoProduceSolutionSelectedError()
     # TODO: 这里需要缓存，不能每次都从磁盘读取
     return ProduceSolutionManager().read(id)

kaa/errors.py

@@ -1,4 +1,5 @@
 import os
+import platform
 from kotonebot.errors import UserFriendlyError
 
 
@@ -19,6 +20,58 @@ class KaaUserFriendlyError(UserFriendlyError, KaaError):
     def __str__(self):
         return f'【发生错误】{self.message}。访问 {self.help_link} 以获取更多帮助。'
 
+class ServiceError(KaaUserFriendlyError):
+    """Base class for service-related errors."""
+    def __init__(self, message: str, help_link: str):
+        super().__init__(message, help_link)
+
+class UpdateServiceError(ServiceError):
+    """Base class for update service errors."""
+    pass
+
+class UpdateFetchListError(UpdateServiceError):
+    def __init__(self, reason: str):
+        super().__init__(
+            f'Failed to fetch version list: {reason}',
+            '' # TODO
+        )
+
+class CompatibilityError(UpdateServiceError):
+    def __init__(self, launcher_version: str, target_version: str):
+        super().__init__(
+            f"❌ 版本兼容性错误\n\n"
+            f"启动器版本: {launcher_version}\n"
+            f"要安装的版本: {target_version}\n\n"
+            f"v2025.9b1 及以上版本需要**启动器 v0.5.0*** 或更高版本支持。\n"
+            f"请先升级启动器到 v0.5.0 以上版本。",
+            ''
+        )
+
+class UpdateInstallError(UpdateServiceError):
+    def __init__(self, reason: str):
+        super().__init__(
+            f'Failed to start installation process: {reason}',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=some-link' # TODO
+        )
+
+class FeedbackServiceError(ServiceError):
+    """Base class for feedback service errors."""
+    pass
+
+class ReportCreationError(FeedbackServiceError):
+    def __init__(self, reason: str):
+        super().__init__(
+            f'Failed to create bug report: {reason}',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=some-link' # TODO
+        )
+
+class UploadError(FeedbackServiceError):
+    def __init__(self, reason: str):
+        super().__init__(
+            f'Failed to upload bug report: {reason}',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=some-link' # TODO
+        )
+
 class ProduceSolutionNotFoundError(KaaUserFriendlyError):
     def __init__(self, solution_id: str):
         self.solution_id = solution_id
@@ -63,4 +116,26 @@ class GameUpdateNeededError(KaaUserFriendlyError):
         super().__init__(
             '游戏本体需要更新。kaa 暂不支持自动更新，请前往 Play Store 手动更新游戏。',
             'https://www.baidu.com/s?wd=%E5%BF%AB%E5%8E%BB%E6%9B%B4%E6%96%B0%E6%B8%B8%E6%88%8F%E5%95%8A%EF%BC%8C%E8%BF%98%E7%82%B9%E4%BB%80%E4%B9%88%E6%89%93%E5%BC%80%E5%B8%AE%E5%8A%A9'
+        )
+
+class NoProduceSolutionSelectedError(KaaUserFriendlyError):
+    def __init__(self):
+        super().__init__(
+            '未选择培育方案。请前往「设置」，在「当前使用的培育方案」选择一个培育方案后再重新运行。',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=LasxpznR6b'
+        )
+
+class DmmGameLaunchError(KaaUserFriendlyError):
+    def __init__(self, reason: str):
+        self.reason = reason
+        super().__init__(
+            f'绕过 DMM 启动器失败，原因：{reason}',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=pSw7QcH1Kx'
+        )
+
+class WindowsOnlyError(KaaUserFriendlyError):
+    def __init__(self, feature_name: str):
+        super().__init__(
+            f'此功能（{feature_name}）仅在 Windows 上可用。当前系统为 {platform.system()}。请不要使用此功能，或在 Windows 上运行 kaa。',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=LbvACPfiCw'
         )

kaa/main/dmm_host.py

@@ -1,60 +1,60 @@
-from typing_extensions import override
-
-from kotonebot.client import Device
-from kotonebot.client.host import HostProtocol, Instance
-from kotonebot.client.host.windows_common import WindowsRecipes, WindowsHostConfigs, CommonWindowsCreateDeviceMixin
-
-
-DmmHostConfigs = WindowsHostConfigs
-DmmRecipes = WindowsRecipes
-
-# TODO: 可能应该把 start_game 和 end_game 里对启停的操作移动到这里来
-class DmmInstance(CommonWindowsCreateDeviceMixin, Instance[DmmHostConfigs]):
-    def __init__(self):
-        super().__init__('dmm', 'gakumas')
-
-    @override
-    def refresh(self):
-        raise NotImplementedError()
-
-    @override
-    def start(self):
-        raise NotImplementedError()
-
-    @override
-    def stop(self):
-        raise NotImplementedError()
-
-    @override
-    def running(self) -> bool:
-        raise NotImplementedError()
-
-    @override
-    def wait_available(self, timeout: float = 180):
-        raise NotImplementedError()
-
-    @override
-    def create_device(self, impl: DmmRecipes, host_config: DmmHostConfigs) -> Device:
-        """为 DMM 实例创建 Device。"""
-        return super().create_device(impl, host_config)
-
-class DmmHost(HostProtocol[DmmRecipes]):
-    instance = DmmInstance()
-    """DmmInstance 单例。"""
-
-    @staticmethod
-    def installed() -> bool:
-        # TODO: 应该检查 DMM 和 gamkumas 的安装情况
-        raise NotImplementedError()
-
-    @staticmethod
-    def list() -> list[Instance]:
-        raise NotImplementedError()
-
-    @staticmethod
-    def query(*, id: str) -> Instance | None:
-        raise NotImplementedError()
-
-    @staticmethod
-    def recipes() -> 'list[DmmRecipes]':
-        return ['windows', 'remote_windows']
+from typing_extensions import override
+
+from kotonebot.client import Device
+from kotonebot.client.host import HostProtocol, Instance
+from kotonebot.client.host.windows_common import WindowsRecipes, WindowsHostConfigs, CommonWindowsCreateDeviceMixin
+
+
+DmmHostConfigs = WindowsHostConfigs
+DmmRecipes = WindowsRecipes
+
+# TODO: 可能应该把 start_game 和 end_game 里对启停的操作移动到这里来
+class DmmInstance(CommonWindowsCreateDeviceMixin, Instance[DmmHostConfigs]):
+    def __init__(self):
+        super().__init__('dmm', 'gakumas')
+
+    @override
+    def refresh(self):
+        raise NotImplementedError()
+
+    @override
+    def start(self):
+        raise NotImplementedError()
+
+    @override
+    def stop(self):
+        raise NotImplementedError()
+
+    @override
+    def running(self) -> bool:
+        raise NotImplementedError()
+
+    @override
+    def wait_available(self, timeout: float = 180):
+        raise NotImplementedError()
+
+    @override
+    def create_device(self, impl: DmmRecipes, host_config: DmmHostConfigs) -> Device:
+        """为 DMM 实例创建 Device。"""
+        return super().create_device(impl, host_config)
+
+class DmmHost(HostProtocol[DmmRecipes]):
+    instance = DmmInstance()
+    """DmmInstance 单例。"""
+
+    @staticmethod
+    def installed() -> bool:
+        # TODO: 应该检查 DMM 和 gamkumas 的安装情况
+        raise NotImplementedError()
+
+    @staticmethod
+    def list() -> list[Instance]:
+        raise NotImplementedError()
+
+    @staticmethod
+    def query(*, id: str) -> Instance | None:
+        raise NotImplementedError()
+
+    @staticmethod
+    def recipes() -> 'list[DmmRecipes]':
+        return ['windows', 'remote_windows']