ksaa 2025.11__py3-none-any.whl → 2025.11b3__py3-none-any.whl

kaa/application/ui/views/status_view.py

@@ -1,171 +0,0 @@
-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

@@ -1,102 +0,0 @@
-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

@@ -1,106 +0,0 @@
-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/util/reactive.py

@@ -1,182 +0,0 @@
-from typing import TypeVar, Generic, Any, Callable, Optional, cast
-
-# T: 原始对象的类型 (Root)
-# V: 属性值的类型 (Leaf)
-T = TypeVar("T")
-V = TypeVar("V")
-
-class PathRecorder(Generic[T]):
-    """
-    记录路径操作（属性访问 或 索引访问）
-    """
-    # FIX: 显式声明 path 可以为 None
-    def __init__(self, root: Any = None, path: Optional[list[tuple[str, Any]]] = None):
-        self._root = root
-        # path 存储操作记录: ('attr', 'name') 或 ('item', 'key')
-        self._path: list[tuple[str, Any]] = path if path is not None else []
-
-    def __getattr__(self, name: str) -> "PathRecorder":
-        # 记录 .attr 操作
-        return PathRecorder(self._root, self._path + [('attr', name)])
-    
-    def __getitem__(self, key: Any) -> "PathRecorder":
-        # 记录 [key] 操作
-        return PathRecorder(self._root, self._path + [('item', key)])
-
-    # 内部接口
-    def _get_recorder_info(self) -> tuple[Any, list[tuple[str, Any]]]:
-        return self._root, self._path
-
-def of(obj: T) -> T:
-    """
-    Proxy 入口。类型标记返回 T 以获得 IDE 提示，运行时返回 Recorder。
-    """
-    return cast(T, PathRecorder(root=obj))
-
-def _traverse(target: Any, path: list[tuple[str, Any]]) -> tuple[Any, str, Any]:
-    """
-    辅助函数：遍历路径，返回 (parent_container, last_op_type, last_key)
-    """
-    current = target
-    
-    # 遍历直到倒数第二个节点（获取父容器）
-    for op_type, key in path[:-1]:
-        if op_type == 'attr':
-            current = getattr(current, key)
-        elif op_type == 'item':
-            current = current[key]
-    
-    # 获取最后一个操作的信息
-    last_op, last_key = path[-1]
-    return current, last_op, last_key
-
-def getter(proxy: V) -> Callable[[], V]:
-    """
-    创建一个 getter 函数。
-    """
-    # 运行时检查
-    if not isinstance(proxy, PathRecorder):
-        raise TypeError("getter argument must be a proxy object created by of()")
-
-    # 显式转换类型以通过静态检查
-    recorder = cast(PathRecorder, proxy)
-    root, path = recorder._get_recorder_info()
-    
-    if not path:
-        return lambda: cast(V, root)
-
-    def _getter_impl() -> V:
-        parent, last_op, last_key = _traverse(root, path)
-        
-        if last_op == 'attr':
-            return getattr(parent, last_key)
-        elif last_op == 'item':
-            return parent[last_key]
-        
-        # FIX: 抛出异常而不是返回 None，以满足返回类型 V
-        raise ValueError(f"Unknown operation type: {last_op}")
-
-    return _getter_impl
-
-def setter(proxy: V) -> Callable[[V], None]:
-    """
-    创建一个 setter 函数。
-    """
-    if not isinstance(proxy, PathRecorder):
-        raise TypeError("setter argument must be a proxy object created by of()")
-
-    recorder = cast(PathRecorder, proxy)
-    root, path = recorder._get_recorder_info()
-    
-    if not path:
-        raise ValueError("Cannot set root object directly")
-
-    def _setter_impl(value: V) -> None:
-        parent, last_op, last_key = _traverse(root, path)
-        
-        if last_op == 'attr':
-            setattr(parent, last_key, value)
-        elif last_op == 'item':
-            parent[last_key] = value
-        else:
-             raise ValueError(f"Unknown operation type: {last_op}")
-
-    return _setter_impl
-
-class Ref(Generic[T]):
-    """
-    持有对特定数据路径的引用，支持读写。
-    Ref 接收一个 path recorder 代理对象。
-    """
-    def __init__(self, proxy: T):
-        self._getter_fn = getter(proxy)
-        self._setter_fn = setter(proxy)
-
-    @property
-    def value(self) -> T:
-        return self._getter_fn()
-    
-    @value.setter
-    def value(self, new_value: T) -> None:
-        self._setter_fn(new_value)
-
-def ref(proxy: T) -> Ref[T]:
-    """
-    创建一个引用对象 (Ref)，用于直接读写路径记录器的目标值。
-    
-    Example:
-        name_ref = ref(of(user).name)
-        name_ref.value = "Bob"
-    """
-    return Ref(proxy)
-
-if __name__ == "__main__":
-    class Address:
-        def __init__(self, city):
-            self.city = city
-        def __repr__(self):
-            return f"Address(city='{self.city}')"
-
-    class User:
-        def __init__(self, name, city):
-            self.name = name
-            self.addresses = {"home": Address(city)}
-        def __repr__(self):
-            return f"User(name='{self.name}', addresses={self.addresses})"
-
-    data = User("Alice", "New York")
-    print(f"Original Data: {data}")
-
-    # 1. 测试 Getter (混合 属性 和 字典索引)
-    get_city = getter(of(data).addresses["home"].city)
-    print(f"Getter result: {get_city()}")  # Output: New York
-
-    # 2. 测试 Setter
-    set_city = setter(of(data).addresses["home"].city)
-    set_city("San Francisco")
-    print(f"After Setter: {data.addresses['home'].city}")  # Output: San Francisco
-
-    # 3. 测试 Ref (引用)
-    print("-" * 30)
-    print("Testing Ref...")
-    
-    # 创建一个指向 user.name 的 Ref
-    name_ref = ref(of(data).name)
-    
-    print(f"Ref initial value: {name_ref.value}") # Alice
-
-    # 修改 Ref，应该影响原始对象
-    name_ref.value = "Bob"
-    print(f"Ref value set to 'Bob'.")
-    print(f"Original object name: {data.name}") # Bob
-    
-    # 修改原始对象，Ref 应该能感知
-    data.name = "Charlie"
-    print(f"Original object name set to 'Charlie'.")
-    print(f"Ref value: {name_ref.value}") # Charlie
-
-    # 复杂路径 Ref
-    city_ref = ref(of(data).addresses["home"].city)
-    print(f"City Ref value: {city_ref.value}") # San Francisco
-    city_ref.value = "Tokyo"
-    print(f"City Ref set to 'Tokyo'. Original: {data.addresses['home'].city}")