909 lines
40 KiB
TypeScript
909 lines
40 KiB
TypeScript
// This file has been generated by Tauri Specta. Do not edit this file manually.
|
||
|
||
import { invoke as __TAURI_INVOKE } from "@tauri-apps/api/core";
|
||
|
||
/** Commands */
|
||
export const commands = {
|
||
/** 获取当前应用版本 */
|
||
appVersion: () => __TAURI_INVOKE<string>("app_version"),
|
||
/** 检查 Gitea 最新 release，返回版本对比与可用资产 */
|
||
updateCheck: () => __TAURI_INVOKE<UpdateCheckResult>("update_check"),
|
||
/**
|
||
* 更新应用本体（安装阶段）。下载由前端下载模块完成，本命令接收已下载的
|
||
* 安装包路径（便携版 thing_{v}_x64.exe / 安装版 thing_{v}_x64-setup.exe）。
|
||
* 便携版：copy 到临时目录 → update.bat 覆盖重启；
|
||
* 安装版：copy 到临时目录 → 提权静默安装 /S。
|
||
* 调用返回前会触发应用退出。
|
||
*/
|
||
updateInstall: (downloadedPath: string) => __TAURI_INVOKE<null>("update_install", { downloadedPath }),
|
||
/**
|
||
* 应用 ThingHK 内核更新：下载阶段已由下载模块完成，本命令仅做
|
||
* need_stop（等待前端停止监控内核并确认）→ 解压 → 替换。
|
||
* 进度通过 UPDATE_PROGRESS 事件上报，前端据 need_stop 弹出确认对话框。
|
||
*/
|
||
updateThinghkApply: (zipPath: string) => __TAURI_INVOKE<null>("update_thinghk_apply", { zipPath }),
|
||
/** 前端已停止监控内核，确认继续解压替换（唤醒 need_stop 等待） */
|
||
updateThinghkConfirm: () => __TAURI_INVOKE<null>("update_thinghk_confirm"),
|
||
/** 取消 ThingHK 内核更新（need_stop 等待阶段有效：唤醒 apply 以「已取消」返回，zip 保留便于重试） */
|
||
updateThinghkCancel: () => __TAURI_INVOKE<null>("update_thinghk_cancel"),
|
||
proxyActivateProfile: (id: string) => __TAURI_INVOKE<null>("proxy_activate_profile", { id }),
|
||
/** 应用内核更新：下载阶段已由下载模块完成，本方法仅做 need_stop → 解压 → 替换。 */
|
||
proxyApplyKernelUpdate: (zipPath: string) => __TAURI_INVOKE<KernelInfo>("proxy_apply_kernel_update", { zipPath }),
|
||
/** 取消内核下载/安装（设置取消标志，下载循环轮询后中止） */
|
||
proxyCancelKernelInstall: () => __TAURI_INVOKE<null>("proxy_cancel_kernel_install"),
|
||
proxyCheckKernelUpdate: () => __TAURI_INVOKE<KernelUpdateInfo>("proxy_check_kernel_update"),
|
||
proxyClearSystemProxy: () => __TAURI_INVOKE<null>("proxy_clear_system_proxy"),
|
||
proxyCloseConnection: (id: string) => __TAURI_INVOKE<null>("proxy_close_connection", { id }),
|
||
/**
|
||
* 前端确认 mihomo 已停止，唤醒等待中的安装流程继续解压替换。
|
||
* （下载阶段允许 mihomo 运行以便走系统代理，解压替换前必须停止 mihomo，否则 exe 被占用）
|
||
*/
|
||
proxyConfirmInstall: () => __TAURI_INVOKE<null>("proxy_confirm_install"),
|
||
proxyDeleteProfile: (id: string) => __TAURI_INVOKE<null>("proxy_delete_profile", { id }),
|
||
proxyGetSettings: () => __TAURI_INVOKE<ProxySettings>("proxy_get_settings"),
|
||
proxyGetSystemProxy: () => __TAURI_INVOKE<boolean>("proxy_get_system_proxy"),
|
||
proxyImportProfile: (url: string, name: string) => __TAURI_INVOKE<ProfileMeta>("proxy_import_profile", { url, name }),
|
||
proxyKernelInfo: () => __TAURI_INVOKE<KernelInfo>("proxy_kernel_info"),
|
||
proxyRestart: () => __TAURI_INVOKE<ProcessInfo>("proxy_restart"),
|
||
proxySaveSettings: (settings: ProxySettings) => __TAURI_INVOKE<null>("proxy_save_settings", { settings }),
|
||
proxySelectProxy: (group: string, name: string) => __TAURI_INVOKE<null>("proxy_select_proxy", { group, name }),
|
||
proxySetSystemProxy: () => __TAURI_INVOKE<null>("proxy_set_system_proxy"),
|
||
proxyStart: () => __TAURI_INVOKE<ProcessInfo>("proxy_start"),
|
||
proxyStatus: () => __TAURI_INVOKE<ProxyStatus>("proxy_status"),
|
||
proxyStop: () => __TAURI_INVOKE<null>("proxy_stop"),
|
||
proxyTraffic: () => __TAURI_INVOKE<TrafficSnapshot>("proxy_traffic"),
|
||
proxyTestDelay: (name: string, url: string | null, timeout: number | null) => __TAURI_INVOKE<number>("proxy_test_delay", { name, url, timeout }),
|
||
proxyUpdateProfile: (id: string) => __TAURI_INVOKE<ProfileMeta>("proxy_update_profile", { id }),
|
||
/** 读取快速面板设置（快捷键等） */
|
||
quickpanelGetSettings: () => __TAURI_INVOKE<QuickPanelSettings>("quickpanel_get_settings"),
|
||
/**
|
||
* 保存快速面板设置；快捷键变化时自动重新注册 + 预创建窗口，
|
||
* 索引目录变化时闲时自动重建索引。
|
||
*/
|
||
quickpanelSaveSettings: (settings: QuickPanelSettings) => __TAURI_INVOKE<null>("quickpanel_save_settings", { settings }),
|
||
/** 注册（或切换）快速面板全局快捷键 */
|
||
quickpanelRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("quickpanel_register_shortcut", { shortcut }),
|
||
/** 注销快速面板全局快捷键 */
|
||
quickpanelUnregisterShortcut: () => __TAURI_INVOKE<null>("quickpanel_unregister_shortcut"),
|
||
/** 手动触发显示快速面板（供 UI 按钮调用） */
|
||
quickpanelShowPopup: () => __TAURI_INVOKE<null>("quickpanel_show_popup"),
|
||
/** 隐藏快速面板 */
|
||
quickpanelHidePopup: () => __TAURI_INVOKE<null>("quickpanel_hide_popup"),
|
||
/** 显示已创建的弹窗窗口（前端 onMounted 后调用） */
|
||
quickpanelShowWindow: () => __TAURI_INVOKE<null>("quickpanel_show_window"),
|
||
/** 锁定屏幕（Windows: rundll32 user32.dll,LockWorkStation，CREATE_NO_WINDOW 避免黑窗） */
|
||
quickpanelLockScreen: () => __TAURI_INVOKE<null>("quickpanel_lock_screen"),
|
||
/**
|
||
* 初始化文件索引数据库（应用启动时调用）。
|
||
* 若存在上次构建的索引（last_built_dirs 非空），自动恢复 notify 增量监听，
|
||
* 无需重建即可继续自动同步文件变更。
|
||
* 若从未构建过（首次运行），闲时自动建立索引，无需用户手动点"构建索引"。
|
||
*/
|
||
quickpanelInitFileIndex: () => __TAURI_INVOKE<null>("quickpanel_init_file_index"),
|
||
/** 构建文件索引（全量重建，阻塞操作建议在 spawn_blocking 调用） */
|
||
quickpanelBuildFileIndex: () => __TAURI_INVOKE<number>("quickpanel_build_file_index"),
|
||
/** 搜索文件索引（SQLite 查询移出主线程） */
|
||
quickpanelSearchFiles: (query: string, limit: number | null) => __TAURI_INVOKE<FileRecord[]>("quickpanel_search_files", { query, limit }),
|
||
/** 获取索引状态 */
|
||
quickpanelFileIndexStats: () => __TAURI_INVOKE<IndexStats>("quickpanel_file_index_stats"),
|
||
/** 扫描已安装应用（遍历开始菜单/桌面/磁盘，移出主线程） */
|
||
quickpanelScanApps: () => __TAURI_INVOKE<AppRecord[]>("quickpanel_scan_apps"),
|
||
/**
|
||
* 获取应用图标（data URL）。命中内存/磁盘缓存时零 Windows API 调用。
|
||
* 前端按需为可见项调用，避免一次性加载全部图标。
|
||
* 未命中缓存时 SHGetFileInfoW + 编码 + 落盘为阻塞操作，移出主线程。
|
||
*/
|
||
quickpanelGetAppIcon: (path: string) => __TAURI_INVOKE<string | null>("quickpanel_get_app_icon", { path }),
|
||
/** 清理图标缓存（磁盘 + 内存） */
|
||
quickpanelClearAppIconCache: () => __TAURI_INVOKE<null>("quickpanel_clear_app_icon_cache"),
|
||
/** 在资源管理器中显示文件（选中） */
|
||
quickpanelRevealInExplorer: (path: string) => __TAURI_INVOKE<null>("quickpanel_reveal_in_explorer", { path }),
|
||
/**
|
||
* 用系统默认程序打开文件/文件夹。
|
||
* - 目录：explorer.exe 直接打开（修复索引目录点击后未打开的问题）
|
||
* - 文件：ShellExecuteW open，无关联应用时自动 fallback 到「打开方式」对话框（verb: openas）
|
||
*/
|
||
quickpanelOpenFile: (path: string) => __TAURI_INVOKE<null>("quickpanel_open_file", { path }),
|
||
/** 获取 Windows 常用快捷位置（hosts、回收站、此电脑、用户目录、系统管理工具等） */
|
||
quickpanelGetSpecialLocations: () => __TAURI_INVOKE<SpecialLocation[]>("quickpanel_get_special_locations"),
|
||
/** 打开快捷位置（kind: file | shell | cmd） */
|
||
quickpanelOpenSpecial: (kind: string, target: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_open_special", { kind, target, args }),
|
||
/** 删除文件（移到回收站，PowerShell 阻塞等待移出主线程） */
|
||
quickpanelDeleteFile: (path: string) => __TAURI_INVOKE<null>("quickpanel_delete_file", { path }),
|
||
/**
|
||
* 运行自定义命令（执行可执行文件 + 参数）
|
||
* .lnk 快捷方式不能直接 spawn（os error 193），需通过 cmd /C 启动
|
||
*/
|
||
quickpanelRunCustomCommand: (command: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_run_custom_command", { command, args }),
|
||
/**
|
||
* 运行系统命令（不设置 CREATE_NO_WINDOW，使 cmd/powershell/regedit 等显示自身窗口）
|
||
* 适用于内置系统工具：regedit、shutdown、cmd、powershell、taskmgr 等。
|
||
* - 控制台类交互程序（cmd/powershell/pwsh）额外设置 CREATE_NEW_CONSOLE，
|
||
* 否则从 GUI 宿主启动时无可见控制台窗口（表现为"点击没反应"）。
|
||
* - .msc 控制台文件（如 devmgmt.msc）不可被 CreateProcess 直接执行，
|
||
* 改由 mmc 打开（路径解析到 System32，不受当前工作目录影响）。
|
||
*/
|
||
quickpanelRunSystemCommand: (command: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_run_system_command", { command, args }),
|
||
/** 列出目录下的压缩包文件（供批量解压面板使用）。 */
|
||
quickpanelListArchives: (dir: string) => __TAURI_INVOKE<ArchiveInfo[]>("quickpanel_list_archives", { dir }),
|
||
/** 列出目录下的全部条目（供批量重命名/删除面板使用，不含子目录递归）。 */
|
||
quickpanelListDir: (dir: string) => __TAURI_INVOKE<FileEntry[]>("quickpanel_list_dir", { dir }),
|
||
/**
|
||
* 批量解压。`files` 为压缩包路径列表，`dest_dir` 为目标目录，
|
||
* `password` 为统一解压密码（可空），`into_subfolder` 是否解压到同名子文件夹。
|
||
* 每完成一个文件通过 `quickpanel-extract-progress` 事件推送进度。
|
||
*/
|
||
quickpanelBatchExtract: (files: string[], destDir: string, password: string | null, intoSubfolder: boolean) => __TAURI_INVOKE<ExtractResult[]>("quickpanel_batch_extract", { files, destDir, password, intoSubfolder }),
|
||
/**
|
||
* 正则批量重命名预览：对每个文件名应用 `pattern → replacement`，
|
||
* 仅返回有匹配的文件，`newName` 为替换结果。
|
||
*/
|
||
quickpanelPreviewRename: (files: string[], pattern: string, replacement: string) => __TAURI_INVOKE<RenamePreview[]>("quickpanel_preview_rename", { files, pattern, replacement }),
|
||
/** 执行重命名。同一目录下若目标已存在则跳过该项。 */
|
||
quickpanelApplyRename: (items: RenameItem[]) => __TAURI_INVOKE<RenameResult[]>("quickpanel_apply_rename", { items }),
|
||
/**
|
||
* 批量删除文件/目录。`force=false` 时移动至回收站；`force=true` 时先递归清除
|
||
* 只读属性再永久删除（可绕过只读/部分占用导致的删除失败，但被其他进程真正
|
||
* 锁定的文件仍会失败并返回原因）。
|
||
*/
|
||
quickpanelDeleteFiles: (paths: string[], force: boolean) => __TAURI_INVOKE<DeleteResult[]>("quickpanel_delete_files", { paths, force }),
|
||
/**
|
||
* 显示主窗口并强制置为前台。
|
||
* Tauri 的 set_focus 在 Windows 上受前台锁定限制，主窗口被其他应用遮挡时无法到前台；
|
||
* 改用原生 SetForegroundWindow + BringWindowToTop（模拟 Alt 键重置前台锁定）。
|
||
*/
|
||
quickpanelFocusMainWindow: () => __TAURI_INVOKE<null>("quickpanel_focus_main_window"),
|
||
clipboardGetHistory: (limit: number | null, offset: number | null, kind: string | null) => __TAURI_INVOKE<HistoryPage>("clipboard_get_history", { limit, offset, kind }),
|
||
clipboardGetPinned: () => __TAURI_INVOKE<ClipboardItem[]>("clipboard_get_pinned"),
|
||
clipboardSearch: (query: string, limit: number | null, offset: number | null) => __TAURI_INVOKE<HistoryPage>("clipboard_search", { query, limit, offset }),
|
||
clipboardGetItem: (id: number) => __TAURI_INVOKE<({
|
||
/** 文本内容 / 文件列表 JSON */
|
||
content: string | null,
|
||
/** 图片 PNG base64（仅 image 类型） */
|
||
imageBase64: string | null,
|
||
}) & (ClipboardItem) | null>("clipboard_get_item", { id }),
|
||
/** 获取图片缩略图 PNG base64（弹窗悬停预览用，避免加载全尺寸图片） */
|
||
clipboardGetThumb: (id: number) => __TAURI_INVOKE<string | null>("clipboard_get_thumb", { id }),
|
||
clipboardSetPinned: (id: number, pinned: boolean) => __TAURI_INVOKE<boolean>("clipboard_set_pinned", { id, pinned }),
|
||
clipboardDelete: (id: number) => __TAURI_INVOKE<boolean>("clipboard_delete", { id }),
|
||
clipboardClear: () => __TAURI_INVOKE<boolean>("clipboard_clear"),
|
||
clipboardCopyBack: (id: number) => __TAURI_INVOKE<null>("clipboard_copy_back", { id }),
|
||
clipboardCount: () => __TAURI_INVOKE<number>("clipboard_count"),
|
||
clipboardGetSettings: () => __TAURI_INVOKE<ClipboardSettings>("clipboard_get_settings"),
|
||
clipboardSaveSettings: (settings: ClipboardSettings) => __TAURI_INVOKE<null>("clipboard_save_settings", { settings }),
|
||
clipboardStatus: () => __TAURI_INVOKE<ClipboardStatus>("clipboard_status"),
|
||
clipboardStart: () => __TAURI_INVOKE<null>("clipboard_start"),
|
||
clipboardStop: () => __TAURI_INVOKE<null>("clipboard_stop"),
|
||
/** 注册（或切换）快捷弹窗全局快捷键 */
|
||
clipboardRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("clipboard_register_shortcut", { shortcut }),
|
||
/** 注销快捷弹窗全局快捷键 */
|
||
clipboardUnregisterShortcut: () => __TAURI_INVOKE<null>("clipboard_unregister_shortcut"),
|
||
/** 手动触发显示快捷弹窗（供 UI 按钮调用） */
|
||
clipboardShowPopup: () => __TAURI_INVOKE<null>("clipboard_show_popup"),
|
||
/** 隐藏快捷弹窗 */
|
||
clipboardHidePopup: () => __TAURI_INVOKE<null>("clipboard_hide_popup"),
|
||
/** 显示已创建的弹窗窗口（前端 onMounted 后调用） */
|
||
clipboardShowWindow: () => __TAURI_INVOKE<null>("clipboard_show_window"),
|
||
/** 隐藏弹窗并模拟 Ctrl+V 粘贴到原窗口 */
|
||
clipboardPasteToTarget: () => __TAURI_INVOKE<null>("clipboard_paste_to_target"),
|
||
/** 在弹窗旁显示独立预览窗口（悬停/键盘选中时调用） */
|
||
clipboardShowPreview: (id: number) => __TAURI_INVOKE<null>("clipboard_show_preview", { id }),
|
||
/** 隐藏独立预览窗口 */
|
||
clipboardHidePreview: () => __TAURI_INVOKE<null>("clipboard_hide_preview"),
|
||
/**
|
||
* 按内容自适应调整预览窗大小（逻辑像素）。前端加载内容（文本测高、图片按宽高比）后调用，
|
||
* 窗口贴合内容消除留白；后端按弹窗所在屏工作区钳制并重新对齐弹窗。
|
||
* allow_flip：初始落位为 true（优先侧放不下可换侧）；放大/还原为 false（保持原侧）。
|
||
*/
|
||
clipboardResizePreview: (width: number | null, height: number | null, allowFlip: boolean) => __TAURI_INVOKE<null>("clipboard_resize_preview", { width, height, allowFlip }),
|
||
/**
|
||
* 显示已就绪的预览窗口。前端完成内容加载与 resize 后调用，窗口以最终尺寸出现，
|
||
* 消除"先以上次尺寸（可能是放大态大窗）显示再缩回"的闪烁。
|
||
*/
|
||
clipboardRevealPreview: () => __TAURI_INVOKE<null>("clipboard_reveal_preview"),
|
||
/**
|
||
* 预览窗交互锁定：前端预览窗收到 mousedown（放大/缩小、复制、选择文本）时调用。
|
||
* 此后弹窗+预览不因失焦/鼠标离开而关闭，仅当点击外部或弹窗重新聚焦时退出锁定。
|
||
*/
|
||
clipboardPreviewInteracted: () => __TAURI_INVOKE<null>("clipboard_preview_interacted"),
|
||
/** 获取所有任务 */
|
||
downloaderGetTasks: () => __TAURI_INVOKE<DownloadTask[]>("downloader_get_tasks"),
|
||
/** 检查 URL 重复性并探测文件信息（添加下载前调用） */
|
||
downloaderCheckUrl: (url: string, dir: string | null, headers: { [key in string]: string } | null) => __TAURI_INVOKE<CheckUrlResult>("downloader_check_url", { url, dir, headers }),
|
||
/** 添加下载任务 */
|
||
downloaderAddTask: (url: string, filename: string | null, dir: string | null, headers: { [key in string]: string } | null, autoRename: boolean | null, onlyFiles: number[] | null) => __TAURI_INVOKE<string>("downloader_add_task", { url, filename, dir, headers, autoRename, onlyFiles }),
|
||
/** 暂停任务 */
|
||
downloaderPauseTask: (id: string) => __TAURI_INVOKE<null>("downloader_pause_task", { id }),
|
||
/** 恢复任务 */
|
||
downloaderResumeTask: (id: string) => __TAURI_INVOKE<null>("downloader_resume_task", { id }),
|
||
/** 取消任务（置为已取消，清空进度并删除下载文件，但保留记录） */
|
||
downloaderCancelTask: (id: string) => __TAURI_INVOKE<null>("downloader_cancel_task", { id }),
|
||
/** 重新下载已取消/出错的任务 */
|
||
downloaderRedownload: (id: string) => __TAURI_INVOKE<null>("downloader_redownload", { id }),
|
||
/** 移除任务 */
|
||
downloaderRemoveTask: (id: string, deleteFiles: boolean | null) => __TAURI_INVOKE<null>("downloader_remove_task", { id, deleteFiles }),
|
||
/** 获取设置 */
|
||
downloaderGetSettings: () => __TAURI_INVOKE<DownloaderSettings>("downloader_get_settings"),
|
||
/** 保存设置 */
|
||
downloaderSaveSettings: (settings: DownloaderSettings) => __TAURI_INVOKE<null>("downloader_save_settings", { settings }),
|
||
/** 用系统资源管理器打开目录 */
|
||
downloaderOpenDir: (path: string) => __TAURI_INVOKE<null>("downloader_open_dir", { path }),
|
||
/** 用系统默认浏览器打开 URL */
|
||
downloaderOpenUrl: (url: string) => __TAURI_INVOKE<null>("downloader_open_url", { url }),
|
||
/**
|
||
* 将指定 label 的下载窗口显示并强制置为前台。
|
||
* Tauri 的 set_focus 在 Windows 上受前台锁定限制（尤其下载窗口由后台进程创建、
|
||
* 或创建到非主显示器时更明显），改用原生 SetForegroundWindow + BringWindowToTop
|
||
* （模拟 Alt 键重置前台锁定），保证开始/完成下载时窗口能正确定位到前台。
|
||
*/
|
||
downloaderFocusWindow: (label: string) => __TAURI_INVOKE<null>("downloader_focus_window", { label }),
|
||
/** 解析磁力链 / .torrent 文件，返回种子信息（名称 / infohash / 文件列表），供前端做文件勾选 */
|
||
downloaderInspect: (input: string) => __TAURI_INVOKE<TorrentInfo>("downloader_inspect", { input }),
|
||
/** 磁力任务：元数据解析成功后，用户勾选文件并确认开始下载 */
|
||
downloaderSelectBtFiles: (id: string, onlyFiles: number[]) => __TAURI_INVOKE<null>("downloader_select_bt_files", { id, onlyFiles }),
|
||
/**
|
||
* 查询环境状态（Python / musicdl / FFmpeg / 桥接进程），设置页「环境检查」面板调用。
|
||
* 异步命令：子进程探测在阻塞线程池执行，避免冻结主线程/UI。
|
||
*/
|
||
musicEnvStatus: () => __TAURI_INVOKE<MusicEnvStatus>("music_env_status"),
|
||
/** 安装便携 Python + musicdl（幂等），全程推送 music-runtime-install-progress 事件 */
|
||
musicInstallRuntime: () => __TAURI_INVOKE<MusicEnvStatus>("music_install_runtime"),
|
||
/** 取消便携运行时安装/下载 */
|
||
musicCancelRuntimeInstall: () => __TAURI_INVOKE<null>("music_cancel_runtime_install"),
|
||
/** 停止桥接进程 */
|
||
musicStopBridge: () => __TAURI_INVOKE<null>("music_stop_bridge"),
|
||
/** 读取音乐模块设置 */
|
||
musicGetSettings: () => __TAURI_INVOKE<MusicSettings>("music_get_settings"),
|
||
/**
|
||
* 保存音乐模块设置（立即生效）
|
||
*
|
||
* 飞牛音乐**连接相关字段一律以磁盘为准**，不接受前端传值：
|
||
* 连接列表 / 激活连接 / 旧版单连接字段只由 `feiniu_save_connection`、
|
||
* `feiniu_activate_connection`、`feiniu_delete_connection`、`feiniu_login`
|
||
* 等专用命令维护。
|
||
*
|
||
* 原因：前端 `musicStore` 只在 init 时读一次整份设置并长期复用快照，
|
||
* 若允许它整份回写，删除连接后任意一次设置保存（哪怕是切页触发的）
|
||
* 都会把已删除的连接从旧快照里写回来。
|
||
*/
|
||
musicSaveSettings: (settings: MusicSettings) => __TAURI_INVOKE<null>("music_save_settings", { settings }),
|
||
/** 禁用指定窗口（按 label 查找）的显示/隐藏过渡动画，消除覆盖层出现/消失时的缩放动画 */
|
||
screenshotDisableTransitions: (label: string) => __TAURI_INVOKE<null>("screenshot_disable_transitions", { label }),
|
||
/** 一次 IPC 完成指定窗口的显示与聚焦（截图覆盖层显示关键路径，减少串行往返） */
|
||
screenshotShowOverlay: (label: string) => __TAURI_INVOKE<null>("screenshot_show_overlay", { label }),
|
||
/** 注册（或切换）截图全局快捷键。传入空字符串则禁用快捷键。 */
|
||
screenshotRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("screenshot_register_shortcut", { shortcut }),
|
||
/** 注销截图全局快捷键 */
|
||
screenshotUnregisterShortcut: () => __TAURI_INVOKE<null>("screenshot_unregister_shortcut"),
|
||
/**
|
||
* 注册（或切换）贴图全局快捷键。传入空字符串则禁用快捷键。
|
||
* 按下时 emit 'screenshot-pin-shortcut'，由前端切换贴图窗口显示/隐藏。
|
||
*/
|
||
screenshotRegisterPinShortcut: (shortcut: string) => __TAURI_INVOKE<null>("screenshot_register_pin_shortcut", { shortcut }),
|
||
/** 注销贴图全局快捷键 */
|
||
screenshotUnregisterPinShortcut: () => __TAURI_INVOKE<null>("screenshot_unregister_pin_shortcut"),
|
||
/**
|
||
* 捕获整个虚拟屏（多显示器拼接）存入静态，不做 PNG 编码。
|
||
* 同时返回捕获时刻的光标物理坐标（覆盖层据此做初始窗口拾取，省一次 IPC 往返）。
|
||
*/
|
||
screenshotCaptureFullscreen: () => __TAURI_INVOKE<CaptureStart>("screenshot_capture_fullscreen"),
|
||
/** 全屏捕获编码为 PNG base64 并清除（全屏截图直接进编辑器） */
|
||
screenshotFullscreenPng: () => __TAURI_INVOKE<CaptureData>("screenshot_fullscreen_png"),
|
||
/** 清除静态全屏捕获（覆盖层关闭/取消时释放内存） */
|
||
screenshotClearFullscreen: () => __TAURI_INVOKE<null>("screenshot_clear_fullscreen"),
|
||
/** 按物理像素坐标裁剪已存储的全屏捕获 */
|
||
screenshotCropStored: (x: number, y: number, w: number, h: number) => __TAURI_INVOKE<CaptureData>("screenshot_crop_stored", { x, y, w, h }),
|
||
/** 裁剪已存储的全屏捕获并直接写入剪贴板（一次 IPC 完成"裁剪+复制"） */
|
||
screenshotCropCopyStored: (x: number, y: number, w: number, h: number) => __TAURI_INVOKE<CaptureData>("screenshot_crop_copy_stored", { x, y, w, h }),
|
||
/**
|
||
* 枚举可拾取的顶层窗口（Z 序顶→底，排除本进程/不可见/工具窗口）。
|
||
* 前端在截图开始时缓存列表，鼠标移动时在 JS 侧本地命中测试，消除逐帧 IPC 往返。
|
||
*/
|
||
screenshotPickList: () => __TAURI_INVOKE<WindowInfo[]>("screenshot_pick_list"),
|
||
/** 获取当前鼠标物理屏幕坐标（贴图窗口拖动跟随等场景使用） */
|
||
screenshotCursorPos: () => __TAURI_INVOKE<[number, number]>("screenshot_cursor_pos"),
|
||
/** 枚举所有可见顶层窗口 */
|
||
screenshotEnumWindows: () => __TAURI_INVOKE<WindowInfo[]>("screenshot_enum_windows"),
|
||
/** 按 hwnd 捕获指定窗口 */
|
||
screenshotCaptureWindow: (hwnd: number) => __TAURI_INVOKE<CaptureData>("screenshot_capture_window", { hwnd }),
|
||
/**
|
||
* 滚动截图：从窗口当前滚动位置向下拼接到底部，返回超长 PNG。
|
||
* `region` 为 Some 时仅在框选区域（屏幕物理坐标）内捕捉，宽 = 选区宽；
|
||
* 为 None 时捕捉整个客户区。结束后会把窗口滚回起始位置，不打扰用户。
|
||
*/
|
||
screenshotScrollCapture: (hwnd: number, region: {
|
||
x: number,
|
||
y: number,
|
||
width: number,
|
||
height: number,
|
||
} | null) => __TAURI_INVOKE<CaptureData>("screenshot_scroll_capture", { hwnd, region }),
|
||
/** 取消滚动截图会话（不导出）。 */
|
||
screenshotScrollCancel: () => __TAURI_INVOKE<null>("screenshot_scroll_cancel"),
|
||
/** 结束滚动截图会话并导出结果。 */
|
||
screenshotScrollFinish: () => __TAURI_INVOKE<null>("screenshot_scroll_finish"),
|
||
/**
|
||
* 启动滚动截图会话（后台线程持续捕捉拼接，实时推进度事件）。
|
||
* `auto = true` 为自动滚动（线程主动下滚拼到底部）；`false` 为手动（等用户滚动窗口）。
|
||
*/
|
||
screenshotScrollStart: (hwnd: number, region: {
|
||
x: number,
|
||
y: number,
|
||
width: number,
|
||
height: number,
|
||
} | null, auto: boolean) => __TAURI_INVOKE<null>("screenshot_scroll_start", { hwnd, region, auto }),
|
||
/**
|
||
* 滚动模式遮罩挖孔：在截图覆盖层窗口上挖出选区带的真孔（region = None 时复位整窗）。
|
||
*
|
||
* Chromium 系浏览器（Edge/Chrome）的窗口遮挡检测会把被完全覆盖的窗口标记为
|
||
* occluded 并暂停渲染——滚动截图时覆盖层铺满全屏，网页"看起来完全不滚动"。
|
||
* 挖孔后目标窗口仅部分被覆盖，恢复渲染与滚轮响应（详见 capture::set_scroll_hole）。
|
||
* 进入滚动模式时带选区调用，会话结束/新一轮截图开始时必须传 None 复位。
|
||
*/
|
||
screenshotSetScrollHole: (region: {
|
||
x: number,
|
||
y: number,
|
||
width: number,
|
||
height: number,
|
||
} | null) => __TAURI_INVOKE<null>("screenshot_set_scroll_hole", { region }),
|
||
/** 将 PNG base64 写入系统剪贴板（转 CF_DIB） */
|
||
screenshotCopyImage: (pngBase64: string) => __TAURI_INVOKE<null>("screenshot_copy_image", { pngBase64 }),
|
||
/** 将 PNG base64 写入文件 */
|
||
screenshotSavePng: (pngBase64: string, path: string) => __TAURI_INVOKE<null>("screenshot_save_png", { pngBase64, path }),
|
||
/** 将完整 PNG 写入历史缓存目录，返回文件路径 */
|
||
screenshotSaveCache: (pngBase64: string) => __TAURI_INVOKE<string>("screenshot_save_cache", { pngBase64 }),
|
||
/** 从历史缓存目录读取 PNG 并返回 base64（点击历史项复制/保存时一次性加载，不常驻内存） */
|
||
screenshotLoadCache: (path: string) => __TAURI_INVOKE<string>("screenshot_load_cache", { path }),
|
||
/** 删除历史缓存文件（历史项移除/清空时调用，静默忽略不存在文件） */
|
||
screenshotDeleteCache: (path: string) => __TAURI_INVOKE<null>("screenshot_delete_cache", { path }),
|
||
};
|
||
|
||
/* Types */
|
||
export type AppRecord = {
|
||
name: string,
|
||
path: string,
|
||
};
|
||
|
||
export type ArchiveInfo = {
|
||
name: string,
|
||
path: string,
|
||
size: number,
|
||
};
|
||
|
||
/** BT 种子内文件条目（多文件任务用；阶段1下载全部文件，但保留列表供 UI 展示） */
|
||
export type BtFileInfo = {
|
||
/** 文件在种子内的索引 */
|
||
index: number,
|
||
/** 相对种子根目录的路径（如 "sub/file.mkv"） */
|
||
path: string,
|
||
/** 文件大小（字节） */
|
||
size: number,
|
||
};
|
||
|
||
/** 前端可见的捕获数据 */
|
||
export type CaptureData = {
|
||
pngBase64: string,
|
||
width: number,
|
||
height: number,
|
||
};
|
||
|
||
/** 截图启动信息：捕获时刻的光标物理坐标（覆盖层据此做初始窗口拾取，省一次 IPC 往返） */
|
||
export type CaptureStart = {
|
||
cursorX: number,
|
||
cursorY: number,
|
||
};
|
||
|
||
/** check_url 命令返回的结果 */
|
||
export type CheckUrlResult = {
|
||
/** 探测是否成功 */
|
||
ok: boolean,
|
||
/** 错误信息（探测失败时） */
|
||
error: string | null,
|
||
/** 文件名（探测成功时） */
|
||
filename: string | null,
|
||
/** 文件大小（字节） */
|
||
totalSize: number | null,
|
||
/** 是否支持断点续传 */
|
||
supportsResume: boolean,
|
||
/** 重复类型 */
|
||
duplicate: DuplicateKind,
|
||
/** 已存在的任务信息 */
|
||
existing: ExistingTaskInfo | null,
|
||
};
|
||
|
||
/** 列表项（不含大字段，用于历史/搜索结果） */
|
||
export type ClipboardItem = {
|
||
id: number,
|
||
kind: string,
|
||
preview: string,
|
||
size: number,
|
||
pinned: boolean,
|
||
pinnedOrder: number | null,
|
||
createdAt: number,
|
||
};
|
||
|
||
/** 详情（含文本内容或图片 base64） */
|
||
export type ClipboardItemDetail = {
|
||
/** 文本内容 / 文件列表 JSON */
|
||
content: string | null,
|
||
/** 图片 PNG base64（仅 image 类型） */
|
||
imageBase64: string | null,
|
||
} & ClipboardItem;
|
||
|
||
/** 剪贴板设置（持久化到 clipboard/settings.json） */
|
||
export type ClipboardSettings = {
|
||
/** 监听是否启用 */
|
||
enabled?: boolean,
|
||
/** 非固定历史最大条数 */
|
||
maxItems?: number,
|
||
/** 图片大小上限（KB），0 表示不限 */
|
||
maxImageKb?: number,
|
||
recordText?: boolean,
|
||
recordImage?: boolean,
|
||
recordFiles?: boolean,
|
||
/** 去重（相同内容更新时间而非新增） */
|
||
dedup?: boolean,
|
||
/** 快捷弹窗全局快捷键（如 "Alt+V"，空字符串表示禁用） */
|
||
shortcut?: string,
|
||
};
|
||
|
||
export type ClipboardStatus = {
|
||
running: boolean,
|
||
count: number,
|
||
};
|
||
|
||
/** 自定义命令 */
|
||
export type CustomCommand = {
|
||
id: string,
|
||
title: string,
|
||
command: string,
|
||
args?: string[],
|
||
};
|
||
|
||
/** 批量删除单个条目的结果。 */
|
||
export type DeleteResult = {
|
||
name: string,
|
||
path: string,
|
||
ok: boolean,
|
||
error: string,
|
||
};
|
||
|
||
/** 下载任务 */
|
||
export type DownloadTask = {
|
||
/** 任务 ID（自增 hex 字符串） */
|
||
id: string,
|
||
/** 下载地址（HTTP URL 或磁力链接） */
|
||
url: string,
|
||
/** 文件名（HTTP：目标文件名；BT：种子名称） */
|
||
filename: string,
|
||
/** 保存目录（绝对路径） */
|
||
dir: string,
|
||
/** 协议类型 */
|
||
protocol?: TaskProtocol,
|
||
/** BT 种子 infohash（协议=BitTorrent 时存在） */
|
||
infoHash?: string | null,
|
||
/** BT 种子内文件列表（协议=BitTorrent 时存在） */
|
||
btFiles?: BtFileInfo[],
|
||
/** BT 元数据是否已解析就绪（异步添加时：后台解析完成前为 false，调度器跳过） */
|
||
btMetadataReady?: boolean,
|
||
/** 状态 */
|
||
status: TaskStatus,
|
||
/** 文件总大小（字节），0=未知 */
|
||
totalSize: number,
|
||
/** 已下载字节 */
|
||
completedSize: number,
|
||
/** 当前下载速度 bytes/s */
|
||
speed: number,
|
||
/** 服务器是否支持断点续传 */
|
||
supportsResume: boolean,
|
||
/** 分段信息 */
|
||
segments?: Segment[],
|
||
/** 错误信息 */
|
||
error?: string | null,
|
||
/** 创建时间（Unix 时间戳，毫秒） */
|
||
createdAt: number,
|
||
/** 自定义请求头（Cookie / Referer 等） */
|
||
headers?: { [key in string]: string },
|
||
};
|
||
|
||
/** 下载设置 */
|
||
export type DownloaderSettings = {
|
||
/** 下载目录 */
|
||
downloadDir?: string,
|
||
/** 最大同时下载数 */
|
||
maxConcurrent?: number,
|
||
/** 单任务最大连接数（多线程分段数） */
|
||
maxConnections?: number,
|
||
/** 断点续传 */
|
||
continueDownload?: boolean,
|
||
/** 全局速度限制 KB/s（0=不限） */
|
||
globalSpeedLimit?: number,
|
||
/** 扩展 HTTP API 端口 */
|
||
extensionPort?: number,
|
||
/** 扩展认证密钥（空=不认证） */
|
||
extensionSecret?: string,
|
||
/** 删除任务时是否同时删除已下载的文件 */
|
||
deleteFilesOnRemove?: boolean,
|
||
/** 添加下载前检查重复（URL 或文件名重复时询问） */
|
||
checkDuplicate?: boolean,
|
||
/** 下载是否使用代理：true=尊重系统代理（mihomo 开启系统代理时经其转发），false=强制直连 */
|
||
useProxy?: boolean,
|
||
/** BitTorrent 上传限速 KB/s（0=不限） */
|
||
btUploadLimitKb?: number,
|
||
/** BitTorrent 下载完成后是否继续做种上传（false=下载完即停止上传） */
|
||
btSeedAfterDownload?: boolean,
|
||
/** BitTorrent 监听端口（0=自动选择） */
|
||
btListenPort?: number,
|
||
/** BitTorrent 使用代理下载：开启后自动使用代理模块（mihomo）的 SOCKS5 端口；代理不可用时降级直连 */
|
||
btUseProxy?: boolean,
|
||
};
|
||
|
||
/** 重复类型 */
|
||
export type DuplicateKind =
|
||
/** 无重复 */
|
||
"none" |
|
||
/** URL 重复（已有相同链接的任务） */
|
||
"url" |
|
||
/** 文件名重复（已有同名任务下载到同一目录） */
|
||
"filename" |
|
||
/** 磁盘文件已存在 */
|
||
"fileExists";
|
||
|
||
/** 已存在的任务信息（用于前端展示） */
|
||
export type ExistingTaskInfo = {
|
||
id: string,
|
||
filename: string,
|
||
status: TaskStatus,
|
||
};
|
||
|
||
export type ExtractResult = {
|
||
name: string,
|
||
path: string,
|
||
ok: boolean,
|
||
error: string,
|
||
};
|
||
|
||
/** 一条飞牛音乐连接（持久化在 `MusicSettings`）。 */
|
||
export type FeiniuConnection = {
|
||
id: string,
|
||
name: string,
|
||
/** "lan" | "frp" | "fnconnect"（fnconnect 预留） */
|
||
kind: string,
|
||
/** 服务器地址（http://192.168.x.x:5666 或 https://域名） */
|
||
baseUrl: string,
|
||
username: string,
|
||
token: string,
|
||
deviceId: string,
|
||
accessCode: string,
|
||
/** https 遇到自签证书时忽略校验 */
|
||
insecure: boolean,
|
||
/** fnconnect 连接的 fnId（如 fnos.net/<id> 或裸 id） */
|
||
fnId?: string,
|
||
/**
|
||
* 是否经由 FnConnect 中继链路（`<fnId>.fnos.net`）。
|
||
* 中继要求所有请求携带 `Cookie: mode=relay`，否则网关 302 回登录页。
|
||
*/
|
||
relay?: boolean,
|
||
};
|
||
|
||
export type FileEntry = {
|
||
name: string,
|
||
path: string,
|
||
isDir: boolean,
|
||
size: number,
|
||
};
|
||
|
||
/** 单个文件记录（返回给前端） */
|
||
export type FileRecord = {
|
||
path: string,
|
||
name: string,
|
||
ext: string,
|
||
size: number,
|
||
isDir: boolean,
|
||
};
|
||
|
||
/** 历史查询结果（含总数，用于分页） */
|
||
export type HistoryPage = {
|
||
items: ClipboardItem[],
|
||
total: number,
|
||
};
|
||
|
||
/** 索引状态（返回给前端） */
|
||
export type IndexStats = {
|
||
total: number,
|
||
lastBuiltAt: number,
|
||
lastBuiltDirs: string[],
|
||
};
|
||
|
||
export type KernelInfo = {
|
||
path: string,
|
||
exists: boolean,
|
||
version: string | null,
|
||
};
|
||
|
||
export type KernelUpdateInfo = {
|
||
currentVersion: string | null,
|
||
latestVersion: string,
|
||
downloadUrl: string,
|
||
hasUpdate: boolean,
|
||
};
|
||
|
||
/** 环境状态（返回前端，设置页「环境检查」面板展示） */
|
||
export type MusicEnvStatus = {
|
||
/** 系统 Python 版本（如 "3.14.5"），无则 None */
|
||
python: string | null,
|
||
/** python 来源："system" | "bundled" | "none" */
|
||
pythonSource: string,
|
||
/** 便携 Python 可执行文件路径（未安装则 None） */
|
||
bundledPython: string | null,
|
||
/** musicdl 是否可导入 */
|
||
musicdlInstalled: boolean,
|
||
/** musicdl 版本 */
|
||
musicdlVersion: string | null,
|
||
/** 本应用锁定的 musicdl 版本（`MUSICDL_VERSION`）：是否过期、更新到哪个版本都以它为准 */
|
||
musicdlExpected: string,
|
||
/**
|
||
* 已装 musicdl 是否与锁定版本不一致。
|
||
* 未安装时恒为 false（那是「安装」引导的事，不是「更新」）。
|
||
*/
|
||
musicdlOutdated: boolean,
|
||
/** FFmpeg 是否可用（部分音源需要，非必需） */
|
||
ffmpeg: string | null,
|
||
/** 桥接进程是否在运行 */
|
||
bridgeRunning: boolean,
|
||
/** 运行时目录（{app_data_dir}/music） */
|
||
runtimeDir: string,
|
||
};
|
||
|
||
/** 音乐模块设置（settings.json 持久化；变更即时生效） */
|
||
export type MusicSettings = {
|
||
/** 下载保存目录 */
|
||
savedir: string,
|
||
/** 搜索源（musicdl 客户端名，如 NeteaseMusicClient） */
|
||
sources: string[],
|
||
/** 下载时同步保存歌词 */
|
||
lyricDownload: boolean,
|
||
/** 下载时同步保存封面 */
|
||
coverDownload: boolean,
|
||
/** 搜索/下载请求是否走代理模块（mihomo mixed 端口） */
|
||
useProxy: boolean,
|
||
/** 最大并发下载数 */
|
||
maxConcurrent: number,
|
||
/** 下载引擎："musicdl" | "rust"（P2 生效） */
|
||
downloadEngine: string,
|
||
/** 下载时是否弹窗选择音质（默认关；开启后点下载弹出所选歌曲档位并集选择） */
|
||
selectQualityOnDownload: boolean,
|
||
/** 下载时默认音质："" 表示最高；否则为搜索音质档位 label（如 "无损"、"320K"） */
|
||
defaultDownloadQuality: string,
|
||
/**
|
||
* QQ 音乐 Cookie（可选）：用于解析需要登录的歌单（含自己的隐私歌单）与 VIP 音质。
|
||
* 传给 musicdl 的 default_search/parse/download_cookies；空=游客身份。
|
||
*/
|
||
qqCookie?: string,
|
||
/** 飞牛音乐(NAS)连接：服务器地址（如 http://192.168.1.10:5666，空=未配置） */
|
||
feiniuBaseUrl?: string,
|
||
/** 飞牛音乐登录 token（登录成功后保存） */
|
||
feiniuToken?: string,
|
||
/** 飞牛音乐登录账号（展示 + 重新登录回填用） */
|
||
feiniuUsername?: string,
|
||
/** 飞牛音乐设备 ID（32 位 hex，登录签名用，一次生成复用） */
|
||
feiniuDeviceId?: string,
|
||
/** 飞牛音乐访问安全码（可选；仅需访问码的库才填，LAN 通常为空） */
|
||
feiniuAccessCode?: string,
|
||
/** 飞牛音乐连接列表（多连接：局域网 / FnConnect） */
|
||
feiniuConnections?: FeiniuConnection[],
|
||
/** 当前激活连接的 id */
|
||
feiniuActiveId?: string,
|
||
/** 本地曲库扫描目录（默认含音乐下载 savedir） */
|
||
feiniuLocalDirs?: string[],
|
||
/** 播放缓存开关 */
|
||
feiniuCacheEnabled?: boolean,
|
||
/** 缓存上限（GB） */
|
||
feiniuCacheMaxGb?: number,
|
||
/** 播放模式："stream" 直连流式 | "cache" 缓存后播放 */
|
||
feiniuPlayMode?: string,
|
||
/** 飞牛曲库目标目录（NAS 绝对路径，如 vol1/1000/Music；上传到飞牛用） */
|
||
feiniuLibraryNasPath?: string,
|
||
/** 下载完成后自动上传到飞牛曲库 */
|
||
feiniuAutoUpload?: boolean,
|
||
};
|
||
|
||
/** 进程信息（返回给前端） */
|
||
export type ProcessInfo = {
|
||
id: string,
|
||
name: string,
|
||
status: ProcessStatus,
|
||
pid: number | null,
|
||
restartCount: number,
|
||
};
|
||
|
||
/** 进程状态枚举 */
|
||
export type ProcessStatus = "running" | "stopped" | "crashed" | "starting";
|
||
|
||
export type ProfileMeta = {
|
||
id?: string,
|
||
name?: string,
|
||
url?: string,
|
||
addedAt?: string,
|
||
updatedAt?: string,
|
||
size?: number | null,
|
||
};
|
||
|
||
export type ProxySettings = {
|
||
mixedPort?: number,
|
||
externalController?: string,
|
||
secret?: string,
|
||
mode?: string,
|
||
logLevel?: string,
|
||
allowLan?: boolean,
|
||
systemProxy?: boolean,
|
||
autoStart?: boolean,
|
||
autoSystemProxy?: boolean,
|
||
currentProfile?: string | null,
|
||
profiles?: ProfileMeta[],
|
||
autoSwitchEnabled?: boolean,
|
||
autoSwitchInterval?: number,
|
||
autoSwitchGroup?: string,
|
||
autoSwitchRegion?: string,
|
||
/**
|
||
* 内核下载镜像源列表（前缀拼接到 GitHub URL 前）。
|
||
* 空字符串 = 直连 GitHub，其余为镜像站前缀（含尾斜杠）。
|
||
*/
|
||
kernelMirrors?: string[],
|
||
};
|
||
|
||
export type ProxyStatus = {
|
||
running: boolean,
|
||
pid: number | null,
|
||
restartCount: number,
|
||
};
|
||
|
||
/** 快速面板设置 */
|
||
export type QuickPanelSettings = {
|
||
/** 全局快捷键（如 "Alt+Space"），空字符串表示不注册。 */
|
||
shortcut?: string,
|
||
/** 唤起位置：center（鼠标所在显示器中央）| cursor（鼠标位置） */
|
||
popupPosition?: string,
|
||
/** 默认搜索引擎：google | bing | baidu */
|
||
searchEngine?: string,
|
||
/** 文件索引目录列表（空列表表示使用默认：桌面/文档/下载） */
|
||
indexDirs?: string[],
|
||
/** 自定义命令列表 */
|
||
customCommands?: CustomCommand[],
|
||
};
|
||
|
||
export type RenameItem = {
|
||
path: string,
|
||
oldName: string,
|
||
newName: string,
|
||
};
|
||
|
||
export type RenamePreview = {
|
||
path: string,
|
||
oldName: string,
|
||
newName: string,
|
||
error: string,
|
||
};
|
||
|
||
export type RenameResult = {
|
||
oldName: string,
|
||
newName: string,
|
||
ok: boolean,
|
||
error: string,
|
||
};
|
||
|
||
export type ScreenRect = {
|
||
x: number,
|
||
y: number,
|
||
width: number,
|
||
height: number,
|
||
};
|
||
|
||
/** 滚动截图区域（屏幕物理像素坐标，通常为覆盖层框选区平移到屏幕） */
|
||
export type ScrollRegion = {
|
||
x: number,
|
||
y: number,
|
||
width: number,
|
||
height: number,
|
||
};
|
||
|
||
/** 下载分段（多线程 Range 下载 / 断点续传用） */
|
||
export type Segment = {
|
||
/** 分段索引 */
|
||
index: number,
|
||
/** 起始字节（含） */
|
||
start: number,
|
||
/** 结束字节（含） */
|
||
end: number,
|
||
/** 已下载字节 */
|
||
completed: number,
|
||
};
|
||
|
||
/** 快捷位置条目 */
|
||
export type SpecialLocation = {
|
||
id: string,
|
||
title: string,
|
||
subtitle: string,
|
||
keywords: string[],
|
||
/** file: 真实文件/文件夹路径；shell: explorer 打开的 shell 路径；cmd: 可执行命令 */
|
||
kind: string,
|
||
target: string,
|
||
args: string[],
|
||
};
|
||
|
||
/** 任务下载协议类型 */
|
||
export type TaskProtocol =
|
||
/** HTTP/HTTPS 直链 */
|
||
"http" |
|
||
/** BitTorrent（磁力链 / .torrent 文件） */
|
||
"bittorrent";
|
||
|
||
/** 任务状态 */
|
||
export type TaskStatus =
|
||
/** 排队等待（并发数已满） */
|
||
"queued" |
|
||
/** 下载中 */
|
||
"active" |
|
||
/** 已暂停 */
|
||
"paused" |
|
||
/** 已完成 */
|
||
"complete" |
|
||
/** 错误 */
|
||
"error" |
|
||
/** 已取消（用户取消：进度与文件已清除，仅保留记录，只能再次下载） */
|
||
"cancelled";
|
||
|
||
/** 种子信息（inspect 解析结果，供命令返回给前端做文件勾选） */
|
||
export type TorrentInfo = {
|
||
/** 种子名称 */
|
||
name: string,
|
||
/** infohash（hex 小写字符串） */
|
||
infoHash: string,
|
||
/** 种子内全部文件总大小（字节） */
|
||
totalSize: number,
|
||
/** 种子内文件列表 */
|
||
files: BtFileInfo[],
|
||
};
|
||
|
||
/** 实时流量快照（由 /connections 的会话总量差分得出实时速率） */
|
||
export type TrafficSnapshot = {
|
||
/** 本次会话累计下载字节数 */
|
||
downloadTotal: number,
|
||
/** 本次会话累计上传字节数 */
|
||
uploadTotal: number,
|
||
/** 实时下载速率（字节/秒） */
|
||
downloadSpeed: number,
|
||
/** 实时上传速率（字节/秒） */
|
||
uploadSpeed: number,
|
||
/** 当前活跃连接数 */
|
||
activeConnections: number,
|
||
};
|
||
|
||
/** release 中的一个资产 */
|
||
export type UpdateAsset = {
|
||
name: string,
|
||
size: number,
|
||
browserDownloadUrl: string,
|
||
};
|
||
|
||
/** 检查更新的结果 */
|
||
export type UpdateCheckResult = {
|
||
currentVersion: string,
|
||
latestVersion: string,
|
||
hasUpdate: boolean,
|
||
/** portable | installed */
|
||
installType: string,
|
||
releaseName: string,
|
||
releaseBody: string,
|
||
assets: UpdateAsset[],
|
||
};
|
||
|
||
/** 窗口信息（窗口拾取 / 枚举） */
|
||
export type WindowInfo = {
|
||
hwnd: number,
|
||
title: string,
|
||
rect: ScreenRect,
|
||
/** DWM 扩展边框矩形（视觉边界，去掉最大化窗口的隐形缩放边框），命中测试用 rect，高亮用 visual_rect */
|
||
visualRect: ScreenRect | null,
|
||
};
|
||
|