super-aide 0.1.1__py3-none-any.whl

super_aide/__init__.py

@@ -0,0 +1,8 @@
+"""Super Aide：Windows 桌面超级助手。"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("super-aide")
+except PackageNotFoundError:  # 没装、直接从源码跑
+    __version__ = "0.0.0"

super_aide/__main__.py

@@ -0,0 +1,3 @@
+from .app import main
+
+raise SystemExit(main())

super_aide/_release/constraints.txt

@@ -0,0 +1,173 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --project D:\a\super-aide\super-aide --frozen --no-dev --no-hashes --no-emit-project --output-file D:\a\super-aide\super-aide\src\super_aide\_release\constraints.txt
+annotated-types==0.8.0
+    # via pydantic
+anyio==4.15.1
+    # via
+    #   claude-agent-sdk
+    #   httpx2
+    #   mcp
+    #   sse-starlette
+    #   starlette
+attrs==26.1.0
+    # via
+    #   jsonschema
+    #   referencing
+cffi==2.1.1 ; platform_python_implementation != 'PyPy'
+    # via cryptography
+claude-agent-sdk==0.2.164
+    # via super-aide
+click==8.5.0 ; sys_platform != 'emscripten'
+    # via uvicorn
+comtypes==1.4.17
+    # via uiautomation
+cryptography==50.0.2
+    # via pyjwt
+flatbuffers==25.12.19
+    # via onnxruntime
+h11==0.16.0 ; sys_platform != 'emscripten'
+    # via
+    #   httpcore2
+    #   uvicorn
+httpcore2==2.13.1 ; sys_platform != 'emscripten'
+    # via httpx2
+httpx2==2.13.1
+    # via mcp
+httpx2-jsfetch==1.0 ; sys_platform == 'emscripten'
+    # via httpx2
+idna==3.20
+    # via
+    #   anyio
+    #   httpx2
+jsonschema==4.26.0
+    # via
+    #   claude-agent-sdk
+    #   mcp
+jsonschema-specifications==2025.9.1
+    # via jsonschema
+mcp==2.3.0
+    # via
+    #   claude-agent-sdk
+    #   super-aide
+mcp-types==2.3.0
+    # via mcp
+mss==10.2.0
+    # via super-aide
+numpy==2.5.3
+    # via
+    #   onnxruntime
+    #   super-aide
+onnxruntime==1.31.0
+    # via super-aide
+openai-codex==0.160.1
+    # via super-aide
+openai-codex-cli-bin==0.160.1
+    # via openai-codex
+opentelemetry-api==1.45.1
+    # via mcp
+packaging==26.3
+    # via
+    #   onnxruntime
+    #   openai-codex
+pillow==12.3.0
+    # via super-aide
+protobuf==7.36.2
+    # via onnxruntime
+psutil==7.2.2
+    # via super-aide
+pycparser==3.0 ; implementation_name != 'PyPy' and platform_python_implementation != 'PyPy'
+    # via cffi
+pydantic==2.13.5
+    # via
+    #   mcp
+    #   mcp-types
+    #   openai-codex
+pydantic-core==2.46.5
+    # via pydantic
+pyjwt==2.15.1
+    # via mcp
+pyside6==6.11.2
+    # via super-aide
+pyside6-addons==6.11.2
+    # via pyside6
+pyside6-essentials==6.11.2
+    # via
+    #   pyside6
+    #   pyside6-addons
+python-multipart==0.0.32
+    # via mcp
+pywin32==312
+    # via
+    #   mcp
+    #   super-aide
+referencing==0.37.0
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+rpds-py==2026.9.1
+    # via
+    #   jsonschema
+    #   referencing
+sentencepiece==0.2.2
+    # via super-aide
+shiboken6==6.11.2
+    # via
+    #   pyside6
+    #   pyside6-addons
+    #   pyside6-essentials
+sniffio==1.3.1
+    # via claude-agent-sdk
+sse-starlette==3.5.0
+    # via mcp
+starlette==1.7.0
+    # via
+    #   mcp
+    #   sse-starlette
+tomli-w==1.2.0
+    # via super-aide
+truststore==0.10.4 ; sys_platform != 'emscripten'
+    # via
+    #   httpcore2
+    #   httpx2
+typing-extensions==4.16.0
+    # via
+    #   anyio
+    #   httpx2
+    #   mcp
+    #   mcp-types
+    #   opentelemetry-api
+    #   pydantic
+    #   pydantic-core
+    #   referencing
+    #   starlette
+    #   typing-inspection
+    #   winrt-runtime
+typing-inspection==0.4.4
+    # via
+    #   mcp
+    #   pydantic
+uiautomation==2.0.29
+    # via super-aide
+uvicorn==0.54.0 ; sys_platform != 'emscripten'
+    # via mcp
+winrt-runtime==3.2.1
+    # via
+    #   super-aide
+    #   winrt-windows-foundation
+    #   winrt-windows-foundation-collections
+    #   winrt-windows-globalization
+    #   winrt-windows-graphics-imaging
+    #   winrt-windows-media-ocr
+    #   winrt-windows-storage-streams
+winrt-windows-foundation==3.2.1
+    # via super-aide
+winrt-windows-foundation-collections==3.2.1
+    # via super-aide
+winrt-windows-globalization==3.2.1
+    # via super-aide
+winrt-windows-graphics-imaging==3.2.1
+    # via super-aide
+winrt-windows-media-ocr==3.2.1
+    # via super-aide
+winrt-windows-storage-streams==3.2.1
+    # via super-aide

super_aide/_release/release.json

@@ -0,0 +1,5 @@
+{
+ "version": "0.1.1",
+ "repo": "typing233/super-aide",
+ "built": "2026-10-09T05:40:11+00:00"
+}

super_aide/app.py

@@ -0,0 +1,414 @@
+"""入口：单实例、前置检查（准备窗口）、托盘、全局快捷键、引擎预热、模型发现，以及设置的实时生效。"""
+
+from __future__ import annotations
+
+import ctypes
+import logging
+import shutil
+import subprocess
+import sys
+import threading
+from logging.handlers import RotatingFileHandler
+
+from PySide6.QtCore import QObject, QTimer, Signal
+from PySide6.QtWidgets import QApplication, QSystemTrayIcon
+
+from . import __version__, autostart, config, history, hotkeys, i18n, paths, update
+from .engines import prompts
+from .engines.hub import EngineHub
+from .i18n import app_name, tr
+from .router import EngineRouter
+from .setup import detect, flow
+from .shell.controller import Controller
+from .shell.history_window import HistoryWindow
+from .shell.settings import SettingsWindow
+from .shell.setup_window import SetupResult, SetupWindow
+from .shell.tray import Tray, orb_icon
+from .snapshot.collector import Collector
+from .snapshot.uia import UiaWorker
+
+log = logging.getLogger("super_aide")
+ERROR_ALREADY_EXISTS = 183
+WAKE_EVENT = "Local\\SuperAideWake"  # 再打开一次时，叫醒正在运行的那个
+EVENT_MODIFY_STATE, INFINITE, WAIT_OBJECT_0 = 0x0002, 0xFFFFFFFF, 0
+kernel32 = ctypes.windll.kernel32
+kernel32.CreateEventW.restype = ctypes.c_void_p
+kernel32.CreateEventW.argtypes = [ctypes.c_void_p, ctypes.c_int, ctypes.c_int, ctypes.c_wchar_p]
+kernel32.OpenEventW.restype = ctypes.c_void_p
+kernel32.OpenEventW.argtypes = [ctypes.c_uint, ctypes.c_int, ctypes.c_wchar_p]
+kernel32.SetEvent.argtypes = [ctypes.c_void_p]
+kernel32.CloseHandle.argtypes = [ctypes.c_void_p]
+kernel32.WaitForSingleObject.argtypes = [ctypes.c_void_p, ctypes.c_uint]
+kernel32.WaitForSingleObject.restype = ctypes.c_uint
+CREATE_NO_WINDOW, CREATE_NEW_CONSOLE, DETACHED_PROCESS = 0x08000000, 0x00000010, 0x00000008
+
+
+def _has_console() -> bool:
+    return bool(ctypes.windll.kernel32.GetConsoleWindow())
+
+
+def _setup_logging() -> None:
+    handler = RotatingFileHandler(paths.LOGS / "super_aide.log", maxBytes=2 * 1024 * 1024,
+                                  backupCount=3, encoding="utf-8")
+    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(name)s: %(message)s"))
+    root = logging.getLogger()
+    root.setLevel(logging.INFO)
+    root.addHandler(handler)
+    if sys.stderr is not None:  # pythonw（开机自启）下没有 stderr
+        root.addHandler(logging.StreamHandler())
+
+
+def _hide_child_consoles() -> None:
+    """没有控制台时（开机自启用 pythonw），两边 SDK 启动的 CLI 和它们再启动的命令行程序
+    会各弹出一个黑窗口：统一加上 CREATE_NO_WINDOW。"""
+    if _has_console():
+        return
+    original = subprocess.Popen.__init__
+
+    def init(self, *args, creationflags=0, **kwargs):
+        if not creationflags & (CREATE_NEW_CONSOLE | DETACHED_PROCESS):
+            creationflags |= CREATE_NO_WINDOW
+        original(self, *args, creationflags=creationflags, **kwargs)
+
+    subprocess.Popen.__init__ = init
+
+
+def _sync_workspace() -> None:
+    """把仓库里的扩展包模板（共享指令、技能）同步到 ~/.super_aide/workspace。"""
+    src = paths.WORKSPACE_TEMPLATE
+    if not src.exists():
+        return
+    for path in src.rglob("*"):
+        if path.is_file():
+            target = paths.WORKSPACE / path.relative_to(src)
+            if not target.exists() or path.stat().st_mtime > target.stat().st_mtime:
+                target.parent.mkdir(parents=True, exist_ok=True)
+                shutil.copy2(path, target)
+
+
+def _single_instance() -> bool:
+    ctypes.windll.kernel32.CreateMutexW(None, False, "Local\\SuperAideSingleton")
+    return ctypes.windll.kernel32.GetLastError() != ERROR_ALREADY_EXISTS
+
+
+def _wake_running() -> None:
+    """已经在运行了（比如你又从开始菜单点了一次）：叫醒它，让它提示一下自己在哪。"""
+    handle = kernel32.OpenEventW(EVENT_MODIFY_STATE, False, WAKE_EVENT)
+    if handle:
+        kernel32.SetEvent(handle)
+        kernel32.CloseHandle(handle)
+
+
+class Wakeup(QObject):
+    """等别的副本来叫醒（Windows 命名事件）。从后台线程发出的信号，Qt 自动排队到主线程。"""
+
+    woken = Signal()
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.handle = kernel32.CreateEventW(None, False, False, WAKE_EVENT)  # 自动复位：叫一次响一次
+        if self.handle:
+            threading.Thread(target=self._wait, name="wakeup", daemon=True).start()
+
+    def _wait(self) -> None:
+        while kernel32.WaitForSingleObject(self.handle, INFINITE) == WAIT_OBJECT_0:
+            self.woken.emit()
+
+
+def _displays(app: QApplication) -> list[dict]:
+    return [{"name": s.name(), "size": [round(s.size().width() * s.devicePixelRatio()),
+                                        round(s.size().height() * s.devicePixelRatio())],
+             "scale": s.devicePixelRatio(), "primary": s == app.primaryScreen()} for s in app.screens()]
+
+
+def _routing(cfg: config.Config) -> tuple:
+    return config.to_dict(cfg)["engines"], cfg.pin_engine
+
+
+def apply_choices(cfg: config.Config, result: SetupResult) -> None:
+    """准备窗口里的选择落到配置上：要用 DSH 就打开它（只开不关：关掉在设置里），
+    你填的模型（填了就只用它，其它的在设置里还能再打开）。"""
+    cfg.setup_done = True
+    if result.use_dsh:
+        cfg.dsh.enabled = True
+    for name, model in result.models.items():
+        flow.only_model(cfg.engine(name), model)
+    config.save(cfg)
+
+
+class SuperAide:
+    """把各部分连起来。设置窗口里的改动经这里落到各部分上，立即生效。"""
+
+    def __init__(self, app: QApplication, cfg: config.Config, report: detect.Report) -> None:
+        self.app, self.cfg = app, cfg
+        self.collector = Collector(UiaWorker(), cfg.blocked_apps, _displays(app))
+        self.router = EngineRouter(cfg)
+        self.router.set_ready(report.usable(cfg.dsh.enabled))  # 没配好模型的引擎不参与
+        self.hub = EngineHub(self.router, prompts.shared_instructions(), cfg.blocklist_enabled)
+        self.ctrl = Controller(cfg, self.collector, self.hub)
+        self.hotkeys = hotkeys.HotkeyManager(self.ctrl.on_hotkey)
+        app.installNativeEventFilter(self.hotkeys)
+        self.tray = Tray(self.ctrl, app, cfg, self.open_settings, self.open_history)
+        self.settings: SettingsWindow | None = None  # 第一次打开时再创建
+        self.history: HistoryWindow | None = None
+        self.setup: SetupWindow | None = None
+        #: 刚在准备窗口里配好的引擎 → 你填的模型（空 = 等发现模型时挑一个它的服务确实提供的）
+        self.fresh: dict[str, str] = {}
+        self.warm_pending = False  # 设置里改了模型：关窗口时再预热，免得每拨一下开关都预热一次
+        self.hub.models_found.connect(self._on_models_found)
+
+    def start(self, announce: bool = False, updated: bool = False) -> None:
+        failed = self._register_hotkeys(self.cfg)
+        if failed:
+            self.tray.showMessage(app_name(), tr("快捷键 {keys} 注册失败（可能被其它程序占用），可以在设置里换一个。",
+                                                 keys=tr("、").join(failed)), QSystemTrayIcon.Warning, 8000)
+        elif announce or updated:
+            self.announce(updated=updated)
+        try:
+            autostart.upgrade()
+        except OSError as e:
+            log.warning("更新开机自启的命令失败：%s", e)
+        self.hub.warm_up()
+        self.hub.discover_models()
+        threading.Thread(target=self._prune_sessions, name="prune", daemon=True).start()
+        log.info("Super Aide 已启动：%s 问答 / %s 操作", self.cfg.hotkey_ask, self.cfg.hotkey_act)
+
+    def announce(self, again: bool = False, updated: bool = False) -> None:
+        """你自己打开 Super Aide 时（开机自启不提示）：它只在托盘里，没有窗口，告诉你它在哪、怎么用。"""
+        if updated:
+            title = tr("{app}已更新到 {version}", app=app_name(), version=__version__)
+        else:
+            title = tr("{app}已经在运行", app=app_name()) if again else tr("{app}已在后台运行", app=app_name())
+        self.tray.showMessage(title, tr("按 {ask} 问答，{act} 操作。右键托盘图标可以打开设置。",
+                                        ask=self.cfg.hotkey_ask, act=self.cfg.hotkey_act),
+                              QSystemTrayIcon.Information, 6000)
+
+    def apply_update(self, release: update.Release | None) -> str:
+        """设置里点了更新：交给安装器（它等 Super Aide 退出后再装），自己退出。返回没能开始的原因。"""
+        try:
+            update.start_update(release)
+        except (update.UpdateError, OSError) as e:
+            log.warning("没能开始更新：%s", e)
+            return str(e)
+        log.info("开始更新到 %s，先退出", release.version if release else "最新版本")
+        QTimer.singleShot(300, self.app.quit)
+        return ""
+
+    def shutdown(self) -> None:
+        self.hotkeys.unregister_all()
+        self.ctrl.esc.stop()
+        self.hub.shutdown()
+        self.collector.close()
+
+    @staticmethod
+    def _prune_sessions() -> None:
+        cleaned = history.prune()
+        if cleaned:
+            log.info("清理了 %d 个 %d 天前的会话（只留下问答记录）", cleaned, history.KEEP_DAYS)
+
+    def open_history(self) -> None:
+        if self.history is None:
+            self.history = HistoryWindow(self.ctrl.theme)
+        self.history.open()
+
+    # ---------- 快捷键 ----------
+
+    def _register_hotkeys(self, cfg: config.Config) -> list[str]:
+        """按 cfg 重新注册，返回没注册上的。"""
+        self.hotkeys.unregister_all()
+        failed = []
+        for name, spec in (("ask", cfg.hotkey_ask), ("act", cfg.hotkey_act)):
+            try:
+                if not self.hotkeys.register(name, spec):
+                    failed.append(spec)
+            except ValueError as e:
+                failed.append(tr("{spec}（{reason}）", spec=spec, reason=e))
+        return failed
+
+    def check_hotkey(self, spec: str) -> str:
+        try:
+            return "" if self.hotkeys.available(spec) else tr("已被其它程序占用")
+        except ValueError as e:
+            return str(e)
+
+    def pause_hotkeys(self) -> None:
+        """设置里录新快捷键时先放开，不然按下现在的快捷键会直接召唤出界面。"""
+        self.hotkeys.unregister_all()
+
+    def resume_hotkeys(self) -> None:
+        if not self.hotkeys.active:
+            self._register_hotkeys(self.cfg)
+
+    # ---------- 设置 ----------
+
+    def open_settings(self) -> None:
+        if self.settings is None:
+            self.settings = SettingsWindow(self)
+        self.settings.open()
+
+    def resolved_theme(self) -> str:
+        return self.ctrl.theme()
+
+    def apply_settings(self, new: config.Config) -> list[str]:
+        """返回没能生效的项。快捷键注册不上时保留原来的。"""
+        errors = []
+        old = self.cfg
+        if (new.hotkey_ask, new.hotkey_act) != (old.hotkey_ask, old.hotkey_act) or not self.hotkeys.active:
+            failed = self._register_hotkeys(new)
+            if failed:
+                errors.append(tr("快捷键 {keys} 注册不上（可能被其它程序占用），还用原来的", keys=tr("、").join(failed)))
+                new.hotkey_ask, new.hotkey_act = old.hotkey_ask, old.hotkey_act
+                self._register_hotkeys(old)
+        routing_changed = _routing(new) != _routing(old)
+        language_changed = new.language != old.language
+        old.update_from(new)
+        self.collector.blocked = {a.lower() for a in old.blocked_apps}
+        if routing_changed:
+            self.hub.reconfigure()
+            self.warm_pending = True
+        config.save(old)
+        if language_changed:
+            self.apply_language()
+        self.tray.refresh(old)
+        self.ctrl.panel.call("setTheme", self.ctrl.theme())
+        return errors
+
+    def apply_language(self) -> None:
+        """设置里换了语言：托盘、回答界面、各个窗口立刻换（设置窗口自己按保存结果重画）。"""
+        i18n.set_language(i18n.resolve(self.cfg.language))
+        self.ctrl.panel.call("setLang", i18n.lang())
+        for window in (self.settings, self.history, self.setup):
+            if window is not None:
+                window.retitle()
+        if self.history is not None and self.history.isVisible():
+            self.history.reopened()
+        if self.setup is not None:
+            self.setup.rescan()  # 检查结果里的说明是按当时的语言写的：重新查一遍
+
+    def settings_closed(self) -> None:
+        self.resume_hotkeys()  # 正在录快捷键时关掉窗口，也要把快捷键恢复
+        if self.warm_pending:
+            self.warm_pending = False
+            self.hub.warm_up()
+
+    def refresh_models(self) -> None:
+        self.hub.discover_models()
+
+    def _on_models_found(self, result: dict) -> None:
+        added, fitted = 0, False
+        for name, ids in result["found"].items():
+            engine = self.cfg.engine(name)
+            added += engine.merge_discovered(ids)
+            if name in self.fresh:
+                fitted |= flow.fit_models(engine, name, ids, self.fresh.pop(name))
+        if added or fitted:
+            config.save(self.cfg)
+            log.info("发现 %d 个新模型，已加入配置（默认关闭）", added)
+        if fitted:
+            self.hub.reconfigure()
+            self.hub.warm_up()
+            if self.settings is not None and self.settings.isVisible():
+                self.settings.reopened()
+        if self.settings is not None:
+            self.settings.models_refreshed({"added": added, "errors": result["errors"]})
+
+    # ---------- 准备窗口（环境检查） ----------
+
+    def adopt_setup(self, window: SetupWindow, result: SetupResult) -> None:
+        """第一次启动时的准备窗口：以后在设置里再打开的就是它。"""
+        self.setup = window
+        window.on_done, window.on_quit = self.apply_setup, None
+        self.fresh.update({name: result.models.get(name, "") for name in result.fresh})
+
+    def open_setup(self) -> None:
+        if self.setup is None:
+            self.setup = SetupWindow(self.cfg, detect.scan(), first_run=False, on_done=self.apply_setup)
+        else:
+            self.setup.show_again()
+
+    def apply_setup(self, result: SetupResult) -> None:
+        """准备窗口点了完成（或关掉）：路由只用配好的引擎；改过登录或服务地址的引擎按新配置重连、重新发现模型。
+        什么都没变就到此为止。"""
+        before = (self.cfg.dsh.enabled, set(self.router.ready or ()))
+        apply_choices(self.cfg, result)
+        ready = result.report.usable(self.cfg.dsh.enabled)
+        if not result.fresh and before == (self.cfg.dsh.enabled, set(ready)):
+            return
+        self.fresh.update({name: result.models.get(name, "") for name in result.fresh})
+        self.hub.reconfigure(ready=ready)
+        if result.fresh:
+            self.hub.refresh(result.fresh)
+        self.hub.warm_up()
+        self.hub.discover_models()
+        if self.settings is not None and self.settings.isVisible():
+            self.settings.reopened()
+
+
+class Startup:
+    """先过准备窗口（需要时：第一次启动，或者一个能用的引擎都没有），再启动 Super Aide。"""
+
+    def __init__(self, app: QApplication, cfg: config.Config, quiet: bool = False) -> None:
+        self.app, self.cfg = app, cfg
+        self.quiet = quiet  # 开机自启：不提示
+        self.aide: SuperAide | None = None
+        self.window: SetupWindow | None = None
+        self.wakeup = Wakeup()
+        self.wakeup.woken.connect(self._woken)
+
+    def _woken(self) -> None:
+        """又打开了一次：准备窗口开着就把它叫到前面，否则提示一下在后台运行。"""
+        if self.window is not None and (self.aide is None or self.window.isVisible()):
+            self.window.open()
+        elif self.aide is not None:
+            self.aide.announce(again=True)
+
+    def run(self) -> None:
+        report = detect.scan()
+        if flow.needs_setup(report, self.cfg.dsh.enabled, self.cfg.setup_done):
+            log.info("先做准备：%s", "；".join(f"{t.title}{'' if t.installed else '没装'}"
+                                             f"{'' if t.configured or not t.installed else '没配模型'}"
+                                             for t in (report.claude, report.codex, report.dsh)))
+            self.window = SetupWindow(self.cfg, report, first_run=True, on_done=self._done, on_quit=self.app.quit)
+            return
+        if not self.cfg.setup_done:
+            self.cfg.setup_done = True  # 本来就都装好、配好了
+            config.save(self.cfg)
+        self._launch(report)
+
+    def _done(self, result: SetupResult) -> None:
+        apply_choices(self.cfg, result)
+        self._launch(result.report, result)
+
+    def _launch(self, report: detect.Report, result: SetupResult | None = None) -> None:
+        self.aide = SuperAide(self.app, self.cfg, report)
+        if result is not None:
+            self.aide.adopt_setup(self.window, result)
+        self.app.aboutToQuit.connect(self.aide.shutdown)
+        # 刚准备完也提示：告诉你怎么用。安装器更新完重新打开时带 --updated
+        self.aide.start(announce=result is not None or not self.quiet, updated="--updated" in sys.argv)
+
+
+def main() -> int:
+    paths.ensure()
+    _setup_logging()
+    _hide_child_consoles()
+    _sync_workspace()
+    if not _single_instance():
+        log.info("已经在运行了")
+        _wake_running()
+        return 0
+    cfg = config.load()
+    i18n.set_language(i18n.resolve(cfg.language))
+
+    app = QApplication(sys.argv)
+    app.setQuitOnLastWindowClosed(False)
+    app.setApplicationName("Super Aide")
+    app.setWindowIcon(orb_icon())
+
+    startup = Startup(app, cfg, quiet=autostart.FLAG in sys.argv)
+    startup.run()
+    return app.exec()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

super_aide/autostart.py

@@ -0,0 +1,49 @@
+"""开机自启：写 HKCU 的 Run 键，用虚拟环境里的 pythonw 启动（不弹控制台窗口）。
+
+自启的命令带 --autostart：开机时安静地在后台起来；你自己打开时才提示一下它在哪、怎么用。
+"""
+
+from __future__ import annotations
+
+import sys
+import winreg
+from pathlib import Path
+
+RUN_KEY = r"Software\Microsoft\Windows\CurrentVersion\Run"
+NAME = "SuperAide"
+FLAG = "--autostart"
+
+
+def command() -> str:
+    exe = Path(sys.executable)
+    windowless = exe.with_name("pythonw.exe")
+    return f'"{windowless if windowless.exists() else exe}" -m super_aide {FLAG}'
+
+
+def _stored() -> str:
+    try:
+        with winreg.OpenKey(winreg.HKEY_CURRENT_USER, RUN_KEY) as key:
+            return str(winreg.QueryValueEx(key, NAME)[0])
+    except OSError:
+        return ""
+
+
+def is_enabled() -> bool:
+    return bool(_stored())
+
+
+def upgrade() -> None:
+    """以前写的自启命令没带 --autostart：是这个 Python 写的就补上（别的副本写的不动，免得被开发版抢走自启）。"""
+    if _stored() == command().removesuffix(f" {FLAG}"):
+        set_enabled(True)
+
+
+def set_enabled(on: bool) -> None:
+    with winreg.OpenKey(winreg.HKEY_CURRENT_USER, RUN_KEY, 0, winreg.KEY_SET_VALUE) as key:
+        if on:
+            winreg.SetValueEx(key, NAME, 0, winreg.REG_SZ, command())
+        else:
+            try:
+                winreg.DeleteValue(key, NAME)
+            except FileNotFoundError:
+                pass