ksaa 2025.11b1__py3-none-any.whl → 2025.11.post1__py3-none-any.whl

kaa/application/services/update_service.py

@@ -0,0 +1,208 @@
+import logging
+import os
+import subprocess
+import sys
+import json
+import zipfile
+import threading
+import time
+from typing import Optional, List
+from pydantic import BaseModel, Field
+
+from kaa.errors import (
+    UpdateFetchListError, CompatibilityError, UpdateInstallError
+)
+
+logger = logging.getLogger(__name__)
+
+class VersionInfo(BaseModel):
+    """存储版本信息的 Pydantic 模型"""
+    versions: List[str] = Field(default_factory=list)
+    latest: Optional[str] = None
+    installed_version: Optional[str] = None
+    launcher_version: Optional[str] = None
+
+def _compare_versions(version1: str, version2: str) -> int:
+    """
+    比较两个版本字符串。
+
+    :param version1: 第一个版本号
+    :param version2: 第二个版本号
+    :return: -1 表示 version1 < version2, 0 表示 version1 == version2, 1 表示 version1 > version2
+    """
+    if version1 == "0.4.x":
+        version1 = "0.4.0"
+
+    def parse(v):
+        v = v.lstrip('v')
+        parts = v.split('.')
+        base = []
+        pre_release = ''
+        for part in parts:
+            if 'b' in part:
+                base.append(int(part.split('b')[0]))
+                pre_release = ('b', int(part.split('b')[1]))
+                break
+            elif 'a' in part:
+                base.append(int(part.split('a')[0]))
+                pre_release = ('a', int(part.split('a')[1]))
+                break
+            elif 'rc' in part:
+                base.append(int(part.split('rc')[0]))
+                pre_release = ('rc', int(part.split('rc')[1]))
+                break
+            else:
+                base.append(int(part))
+        
+        pre_map = {'a': -2, 'b': -1, 'rc': -0.5}
+        if pre_release:
+            return tuple(base) + (pre_map[pre_release[0]], pre_release[1])
+        return tuple(base) + (0, 0)
+
+    v1_parsed = parse(version1)
+    v2_parsed = parse(version2)
+
+    if v1_parsed < v2_parsed:
+        return -1
+    if v1_parsed > v2_parsed:
+        return 1
+    return 0
+
+class UpdateService:
+    """处理应用程序更新逻辑"""
+
+    def __init__(self, repo_name: str = "ksaa"):
+        self.repo_name = repo_name
+        self.bootstrap_pyz_path = os.path.join(os.getcwd(), "bootstrap.pyz")
+
+    def _get_launcher_version(self) -> Optional[str]:
+        """
+        从 bootstrap.pyz/meta.py 读取启动器版本。
+        
+        :return: 启动器版本字符串，如果无法确定则返回 None。
+        """
+        if not os.path.exists(self.bootstrap_pyz_path):
+            logger.warning("bootstrap.pyz not found.")
+            return None
+
+        try:
+            with zipfile.ZipFile(self.bootstrap_pyz_path, 'r') as zf:
+                if 'meta.py' not in zf.namelist():
+                    logger.warning("meta.py not found in bootstrap.pyz, assuming legacy launcher.")
+                    return "0.4.x"
+
+                meta_content = zf.read('meta.py').decode('utf-8')
+                exec_globals = {}
+                exec_locals = {}
+                exec(meta_content, exec_globals, exec_locals)
+
+                version = exec_locals.get('VERSION')
+                if version and isinstance(version, str):
+                    logger.info(f"Launcher version from meta.py: {version}")
+                    return version.lstrip('v')
+                else:
+                    logger.warning("VERSION not found in meta.py.")
+                    return None
+        except zipfile.BadZipFile:
+            logger.info("bootstrap.pyz is not a valid zip file, assuming legacy launcher.")
+            return "0.4.x"
+        except Exception as e:
+            logger.error(f"Failed to read launcher version: {e}", exc_info=True)
+            return None
+
+    def list_remote_versions(self) -> VersionInfo:
+        """
+        从 PyPI 获取可用版本。
+
+        :return: 包含版本数据的 VersionInfo 对象。
+        :raises UpdateFetchListError: 如果无法获取或解析版本列表。
+        """
+        cmd = [
+            sys.executable, "-m", "pip", "index", "versions", self.repo_name,
+            "--json", "--pre",
+            "--index-url", "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple",
+            "--trusted-host", "mirrors.tuna.tsinghua.edu.cn"
+        ]
+        logger.info(f"Executing: {' '.join(cmd)}")
+
+        try:
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=30,
+                check=False
+            )
+
+            if result.returncode != 0:
+                raise UpdateFetchListError(result.stderr)
+
+            data = json.loads(result.stdout)
+            version_info = VersionInfo(
+                versions=data.get("versions", []),
+                latest=data.get("latest"),
+                installed_version=data.get("installed_version")
+            )
+            version_info.launcher_version = self._get_launcher_version()
+            logger.info(f"Found {len(version_info.versions)} available versions.")
+            return version_info
+
+        except (subprocess.TimeoutExpired, json.JSONDecodeError, Exception) as e:
+            raise UpdateFetchListError(str(e)) from e
+
+    def _check_compatibility(self, target_version: str) -> Optional[str]:
+        """
+        检查启动器是否与目标版本兼容。
+        
+        :raises CompatibilityError: 如果启动器不兼容。
+        :return: 如果有潜在问题，则返回警告消息，否则返回 None。
+        """
+        launcher_version = self._get_launcher_version()
+        if not launcher_version:
+            return "无法获取启动器版本，可以继续安装但可能存在兼容性问题"
+
+        logger.info(f"Launcher version: {launcher_version}, Target version: {target_version}")
+
+        if _compare_versions(launcher_version, "0.5.0") < 0:
+            if _compare_versions(target_version, "2025.9b1") >= 0:
+                raise CompatibilityError(launcher_version, target_version)
+            else:
+                return "启动器版本较低，建议升级到 v0.5.0 以上"
+        return None
+
+    def install_version(self, version: str):
+        """
+        安装应用程序的特定版本。
+
+        :param version: 要安装的版本。
+        :raises CompatibilityError: 如果启动器不兼容。
+        :raises UpdateInstallError: 如果安装过程启动失败。
+        """
+        if not version:
+            raise ValueError("A version must be selected to install.")
+
+        warning = self._check_compatibility(version)
+        if warning:
+            logger.warning(warning)
+
+        def _install_and_exit():
+            try:
+                time.sleep(1)
+                cmd = [sys.executable, self.bootstrap_pyz_path, f"--install-version={version}"]
+                logger.info(f"Starting installation via launcher: {' '.join(cmd)}")
+
+                subprocess.Popen(
+                    cmd,
+                    cwd=os.getcwd(),
+                    creationflags=subprocess.CREATE_NEW_CONSOLE if os.name == 'nt' else 0
+                )
+                logger.info("Installation process started. Exiting current application.")
+                os._exit(0)
+            except Exception as e:
+                logger.critical(f"Failed to launch installation process: {e}", exc_info=True)
+                
+        try:
+            install_thread = threading.Thread(target=_install_and_exit, daemon=True)
+            install_thread.start()
+        except Exception as e:
+            raise UpdateInstallError(str(e)) from e

kaa/application/ui/common.py

@@ -0,0 +1,123 @@
+from typing import List, Dict, Tuple, Callable, Any, Literal, Optional
+from dataclasses import dataclass, field
+import gradio as gr
+from kaa.config.schema import BaseConfig
+
+# Type hints
+GradioInput = gr.Textbox | gr.Number | gr.Checkbox | gr.Dropdown | gr.Radio | gr.Slider | gr.State
+ConfigKey = Literal[
+    # backend
+    'backend_type', 'adb_ip', 'adb_port',
+    'screenshot_method', 'keep_screenshots',
+    'check_emulator', 'emulator_path',
+    'adb_emulator_name', 'emulator_args',
+    '_mumu_index', '_mumu12v5_index', '_leidian_index',
+    'mumu_background_mode_v4', 'mumu_background_mode_v5', 'target_screenshot_interval',
+
+    # purchase
+    'purchase_enabled',
+    'money_enabled', 'ap_enabled',
+    'ap_items', 'money_items', 'money_refresh',
+    'weekly_enabled',
+    
+    # assignment
+    'assignment_enabled',
+    'mini_live_reassign', 'mini_live_duration',
+    'online_live_reassign', 'online_live_duration',
+    'contest_enabled',
+    'select_which_contestant', 'when_no_set',
+    
+    # produce
+    'produce_enabled', 'selected_solution_id', 'produce_count', 'produce_timeout_cd', 'interrupt_timeout', 'enable_fever_month',
+    'mission_reward_enabled',
+    
+    # club reward
+    'club_reward_enabled',
+    'selected_note',
+    
+    # upgrade support card
+    'upgrade_support_card_enabled',
+    
+    # capsule toys
+    'capsule_toys_enabled', 'friend_capsule_toys_count',
+    'sense_capsule_toys_count', 'logic_capsule_toys_count',
+    'anomaly_capsule_toys_count',
+    
+    # start game
+    'start_game_enabled', 'start_through_kuyo',
+    'game_package_name', 'kuyo_package_name',
+    'disable_gakumas_localify', 'dmm_game_path', 'dmm_bypass',
+
+    # end game
+    'exit_kaa', 'kill_game', 'kill_dmm',
+    'kill_emulator', 'shutdown', 'hibernate',
+    'restore_gakumas_localify',
+    
+    'activity_funds',
+    'presents',
+    'mission_reward',
+    'activity_funds_enabled',
+    'presents_enabled',
+    'trace_recommend_card_detection',
+    
+    # misc
+    'check_update', 'auto_install_update', 'expose_to_lan', 'update_channel', 'log_level',
+
+    # idle
+    'idle_enabled', 'idle_seconds', 'idle_minimize_on_pause',
+
+    '_selected_backend_index'
+    
+]
+ConfigSetFunction = Callable[[BaseConfig, Dict[ConfigKey, Any]], None]
+ConfigBuilderReturnValue = Tuple[ConfigSetFunction, Dict[ConfigKey, GradioInput]]
+
+
+@dataclass
+class GradioComponents:
+    """Dataclass to hold all Gradio UI components that need to be accessed across methods."""
+    
+    # Main tabs
+    tabs: Optional[gr.Tabs] = None
+    
+    # Status tab components
+    run_btn: Optional[gr.Button] = None
+    pause_btn: Optional[gr.Button] = None
+    end_action_dropdown: Optional[gr.Dropdown] = None
+    quick_checkboxes: List[gr.Checkbox] = field(default_factory=list)
+    task_runtime_text: Optional[gr.Textbox] = None
+    task_status_df: Optional[gr.Dataframe] = None
+    
+    # Update tab components
+    update_info_md: Optional[gr.Markdown] = None
+    update_status_text: Optional[gr.Markdown] = None
+    update_version_dropdown: Optional[gr.Dropdown] = None
+    update_install_btn: Optional[gr.Button] = None
+    
+    # Produce tab components
+    produce_tab_solution_dropdown: Optional[gr.Dropdown] = None
+    produce_solution_settings_group: Optional[gr.Group] = None
+    produce_solution_name: Optional[gr.Textbox] = None
+    produce_solution_description: Optional[gr.Textbox] = None
+    produce_mode: Optional[gr.Dropdown] = None
+    produce_idols: Optional[gr.Dropdown] = None
+    produce_auto_set_memory: Optional[gr.Checkbox] = None
+    produce_memory_sets_group: Optional[gr.Group] = None
+    produce_memory_sets: Optional[gr.Dropdown] = None
+    produce_auto_set_support: Optional[gr.Checkbox] = None
+    produce_support_card_sets_group: Optional[gr.Group] = None
+    produce_support_card_sets: Optional[gr.Dropdown] = None
+    produce_use_pt_boost: Optional[gr.Checkbox] = None
+    produce_use_note_boost: Optional[gr.Checkbox] = None
+    produce_follow_producer: Optional[gr.Checkbox] = None
+    produce_self_study_lesson: Optional[gr.Dropdown] = None
+    produce_prefer_lesson_ap: Optional[gr.Checkbox] = None
+    produce_actions_order: Optional[gr.Dropdown] = None
+    produce_recommend_card_detection_mode: Optional[gr.Dropdown] = None
+    produce_use_ap_drink: Optional[gr.Checkbox] = None
+    produce_skip_commu: Optional[gr.Checkbox] = None
+    produce_all_detail_components: List[Any] = field(default_factory=list)
+    
+    # Settings tab components
+    settings_solution_dropdown: Optional[gr.Dropdown] = None
+    save_settings_btn: Optional[gr.Button] = None

kaa/application/ui/components/alert.py

@@ -0,0 +1,251 @@
+from typing import Optional, Dict, Any
+
+import gradio as gr
+
+# 图标 SVG 定义
+ICONS: Dict[str, str] = {
+    "success": """<path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd" />""",
+    "info": """<path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z" clip-rule="evenodd" />""",
+    "warning": """<path fill-rule="evenodd" d="M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z" clip-rule="evenodd" />""",
+    "error": """<path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clip-rule="evenodd" />"""
+}
+
+class Alert(gr.HTML):
+    def __init__(
+        self, 
+        value: str = "Alert Content", 
+        title: Optional[str] = None, 
+        variant: str = "info", 
+        action_text: Optional[str] = None, 
+        show_close: bool = True, 
+        visible: bool = True, 
+        elem_id: Optional[str] = None, 
+        **kwargs: Any
+    ):
+        """
+        继承自 gr.HTML 的自定义 Alert 组件。
+        
+        Args:
+            value: Alert 的主要描述文本。
+            title: Alert 的标题（可选）。
+            variant: 样式变体，可选 "success", "info", "warning", "error"。
+            action_text: 底部操作按钮的文本（可选）。
+            show_close: 是否显示关闭按钮。
+            visible: 组件初始可见性。
+            elem_id: HTML 元素 ID。
+            **kwargs: 其他传递给 gr.HTML 的参数。
+        """
+        
+        # 1. 样式模板 (CSS Template)
+        # 修改点：调整了布局，使 actions 包含在 content 内部以实现对齐
+        css = """
+        .alert {
+            display: flex;
+            align-items: flex-start; /* 顶部对齐 */
+            padding: 1rem;
+            border-radius: 0.5rem;
+            border: 1px solid transparent;
+            margin-bottom: 1rem;
+            transition: opacity 0.3s ease;
+        }
+        
+        .alert-icon { 
+            width: 1.25rem; 
+            height: 1.25rem; 
+            margin-right: 0.75rem; 
+            flex-shrink: 0; 
+            margin-top: 0.125rem; /* 微调图标与首行文字对齐 */
+        }
+        
+        .alert-body-wrapper {
+            flex: 1;
+            display: flex;
+            flex-direction: column;
+            gap: 0.25rem; /* 标题、描述、按钮之间的间距 */
+        }
+        
+        .alert-title { 
+            font-weight: 600; 
+            font-size: 0.875rem; 
+        }
+        
+        .alert-description { 
+            font-size: 0.875rem; 
+            line-height: 1.25rem; 
+        }
+        
+        .alert-actions { 
+            display: flex; 
+            align-items: center; 
+            gap: 0.5rem; 
+            margin-top: 0.25rem; /* 按钮与上方文字的额外间距 */
+        }
+        
+        /* Variants Colors */
+        .alert-success { background-color: #ecfdf5; border-color: #a7f3d0; color: #065f46; }
+        .alert-success .alert-icon, .alert-success .action-btn { color: #059669; }
+        
+        .alert-info { background-color: #eff6ff; border-color: #bfdbfe; color: #1e40af; }
+        .alert-info .alert-icon, .alert-info .action-btn { color: #2563eb; }
+        
+        .alert-warning { background-color: #fffbeb; border-color: #fde68a; color: #92400e; }
+        .alert-warning .alert-icon, .alert-warning .action-btn { color: #d97706; }
+        
+        .alert-error { background-color: #fef2f2; border-color: #fecaca; color: #991b1b; }
+        .alert-error .alert-icon, .alert-error .action-btn { color: #dc2626; }
+
+        /* Buttons */
+        .action-btn { 
+            background: transparent; 
+            border: none; 
+            font-weight: 600; 
+            cursor: pointer; 
+            padding: 0; /* 移除 padding 以便像链接一样对齐，或者保留 padding 做成按钮样式 */
+            padding-right: 0.5rem;
+            font-size: 0.875rem;
+            text-align: left;
+        }
+        .action-btn:hover { text-decoration: underline; }
+        
+        .close-btn { 
+            background: transparent; 
+            border: none; 
+            cursor: pointer; 
+            opacity: 0.6; 
+            padding: 0.25rem; 
+            margin-left: 0.75rem; /* 离内容稍微远一点 */
+            flex-shrink: 0;
+            display: flex; 
+        }
+        .close-btn:hover { opacity: 1; }
+        .close-btn svg { width: 1rem; height: 1rem; }
+        """
+
+        # 2. HTML 模板 (HTML Template)
+        # 修改点：重构 HTML 结构，将 button 放入 .alert-body-wrapper 中
+        html_template = """
+        <div class="alert alert-${variant}" role="alert">
+            <svg class="alert-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor">
+                ${ {
+                    'success': `""" + ICONS['success'] + """`,
+                    'info': `""" + ICONS['info'] + """`,
+                    'warning': `""" + ICONS['warning'] + """`,
+                    'error': `""" + ICONS['error'] + """`
+                }[variant] }
+            </svg>
+            
+            <div class="alert-body-wrapper">
+                ${ title ? `<div class="alert-title">${title}</div>` : '' }
+                <div class="alert-description">${value}</div>
+                
+                ${ action_text ? `
+                <div class="alert-actions">
+                    <button class="action-btn">${action_text}</button>
+                </div>` : '' }
+            </div>
+            
+            ${ show_close ? `
+            <button class="close-btn" aria-label="Close">
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor">
+                    <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd" />
+                </svg>
+            </button>` : '' }
+        </div>
+        """
+
+        # 3. JS 加载逻辑 (JS on Load)
+        js = """
+        const actionBtn = element.querySelector('.action-btn');
+        const closeBtn = element.querySelector('.close-btn');
+        const alertBox = element.querySelector('.alert');
+
+        if (actionBtn) {
+            actionBtn.addEventListener('click', (e) => {
+                e.stopPropagation(); // 防止冒泡
+                trigger('click', {
+                    action_text: props.action_text,
+                    variant: props.variant
+                });
+            });
+        }
+
+        if (closeBtn) {
+            closeBtn.addEventListener('click', (e) => {
+                e.stopPropagation();
+                alertBox.style.opacity = '0';
+                setTimeout(() => {
+                    alertBox.style.display = 'none';
+                    // 触发 change 事件通知后端状态变化
+                    trigger('change', { status: 'closed' });
+                }, 300);
+            });
+        }
+        """
+
+        super().__init__(
+            value=value,
+            title=title,
+            variant=variant,
+            action_text=action_text,
+            show_close=show_close,
+            html_template=html_template,
+            css_template=css,
+            js_on_load=js,
+            visible=visible,
+            elem_id=elem_id,
+            **kwargs
+        )
+
+# --- 使用示例 ---
+
+if __name__ == "__main__":
+    with gr.Blocks() as demo:
+        gr.Markdown("### Alert Component with Typed Arguments & Aligned Layout")
+
+        with gr.Row():
+            with gr.Column():
+                # 控制器
+                msg_input = gr.Textbox(label="Alert Message", value="你似乎还没有创建任何培育方案。你需要先到「方案」里创建一个！")
+                title_input = gr.Textbox(label="Title", value="提示")
+                variant_input = gr.Dropdown(["success", "info", "warning", "error"], label="Variant", value="info")
+                action_input = gr.Textbox(label="Action Button Text", value="去创建")
+                update_btn = gr.Button("Update Alert")
+
+            with gr.Column():
+                # 组件实例化
+                alert = Alert(
+                    title="提示",
+                    value="你似乎还没有创建任何培育方案。你需要先到「方案」里创建一个！",
+                    variant="info",
+                    action_text="去创建",
+                    elem_id="my-alert"
+                )
+                
+                # 结果显示框
+                result_box = gr.Textbox(label="Event Log")
+
+        # 1. 更新 Alert 属性
+        def update_props(msg: str, title: str, variant: str, action: str) -> Alert:
+            return Alert(value=msg, title=title, variant=variant, action_text=action)
+        
+        update_btn.click(
+            update_props, 
+            inputs=[msg_input, title_input, variant_input, action_input], 
+            outputs=alert
+        )
+
+        # 2. 处理 Action 按钮点击
+        def on_action_click(evt: gr.EventData) -> str:
+            data: Dict[str, Any] = evt._data # type: ignore
+            return f"Action Clicked! Variant: {data.get('variant')}, Action: {data.get('action_text')}"
+        
+        alert.click(on_action_click, outputs=result_box)
+
+        # 3. 处理 Close 按钮点击
+        def on_close(evt: gr.EventData) -> str:
+            data: Dict[str, Any] = evt._data # type: ignore
+            return f"Alert Closed. Status: {data.get('status')}"
+        
+        alert.change(on_close, outputs=result_box)
+
+    demo.launch()