luolangaga/tubatools

[!WARNING]

近期有许多非官方下载渠道，请注意甄别风险！请仅通过本文档「安装」列出的官方渠道下载。

不懂电脑，也想让 AI 帮你搞定？ 打开内置的「AI 助手」，用中文说一句需求就行——

它能读硬件信息、分析磁盘占用、清理垃圾、读写文件、执行命令、联网搜索，危险操作会先弹窗问你。

---

它能做什么

_{左边：按使用频率推荐的常用页，收藏可拖拽排序 ｜ 右边：Mica 材质、亮暗主题、界面语言、数据备份都在设置里}

左侧导航按分类浏览全部工具，顶部一个搜索框能搜到任何一款工具，觉得好用就点星标收进常用页。 收录的 89 款经典工具 + 内置的 47 款原生工具，共用同一套卡片、收藏、排序与桌面快捷方式——用起来没有「两套东西」的感觉。

功能亮点

• AI 助手 —— 内置智能系统代理：读硬件、分析磁盘、清理垃圾、读写文件、执行命令、联网搜索，28 个 Agent 工具 + 危险操作确认
• 硬件信息与实时监控 —— CPU / GPU / 内存 / 硬盘的温度、频率、功耗实时曲线，支持 CPU-Z 数据覆盖校验
• 性能测试与跑分 —— CPU / GPU / 内存 / 硬盘 / 浏览器全项测试，导出 PDF 报告，社区云端排行榜对比
• 格式转换 —— 图片 / 音视频 / Word / Excel / PPT / PDF 互转，OCR 识别、PDF 合并拆分、批量队列
• 游戏工具箱 —— 可自定义布局的 FPS / 温度 / 负载悬浮层，虚拟局域网一键联机，运行库一键修复
• 系统优化与安全 —— 垃圾清理 / 启动项管理 / 右键菜单管理 / 恶意软件拦截 / 沙盒分析 / 时间同步
• 网络工具 —— 网速测试 / 流量监控 / 端口占用 / Hosts 编辑 / 局域网文件分享
• 原生 Fluent 体验 —— Mica 材质、圆角窗口、亮暗主题、中英双语界面、全局搜索、收藏拖拽排序
• 关窗不误退 —— 点 × 默认最小化到系统托盘继续运行，已加载的硬件信息不用重新检测一遍；双击托盘图标恢复窗口，右键「退出」才是真退出（设置里可关掉）
• 工具清单可扩展 —— 把自己的工具丢进 Tools/ 目录就能被识别，元数据在 Metadata/tools.json 里改
• 干净 —— 便携版解压即用，安装版每用户安装；没有常驻后台服务，托盘右键「退出」即真正结束进程

---

AI 助手

内置的智能系统代理把「让 AI 直接操作电脑」做进工具箱：它不只回答问题，还能调用系统工具——读取硬件信息、分析磁盘占用、清理垃圾、读写文件、执行命令、联网搜索。

_{思考过程流式展示、内联工具调用与危险操作确认；可配置任意 OpenAI 兼容服务商与模型}

• 系统级工具调用 —— 内置 28 个 Agent 工具（硬件信息、磁盘分析、进程管理、文件读写、命令执行、联网搜索等），危险操作先弹窗确认
• 完全访问模式 —— 可开关的「完全访问」权限，放开后无需逐条确认，专家用法一气呵成
• 思考过程可视化 —— 推理链（reasoning）流式展示，长回复自动折叠
• 记忆与技能 —— 跨会话记忆（memory.md）、技能按会话启用，用得越久越懂你的机器
• 模型自由 —— 内置小图吧自带模型开箱即用，也可接入任意 OpenAI 兼容端点（DeepSeek / OpenAI / 本地模型……）
• 防死循环护栏 —— 重复的工具调用会被拦截，思维链与工具结果有长度上限，连续无进展的循环会被主动终止

---

硬件检测与性能

性能测试与跑分排行

CPU / GPU / 内存 / 硬盘 / 浏览器五大项全测，按比例折算「游戏性能 / 办公性能」评分并导出专业 PDF 报告。

_{一键三烤 ｜ 毒蘑菇测试 ｜ 社区跑分排行 ｜ 快速验机向导}

• 一键三烤 —— CPU / GPU / 网卡自由勾选烤机，实时监控温度、频率、功耗与网卡吞吐
• 毒蘑菇测试 —— GPU 分形压力测试：轻松 / 中等 / 变态三档压力，超分辨率渲染 + 实时帧率
• 跑分排行 —— 上传测试报告到社区，查看全球排行榜，与同硬件用户对比性能
• 快速验机 —— 新电脑验机向导：外观 / 硬件 / 硬盘通电 / 屏幕坏点 / 外设 / 摄像头 / 音频一站式

更多硬件工具

_{型号 / 系统 / 处理器 / 内存 / 显卡 / 硬盘 / 网卡一览 + 桌面与笔记本性能天梯图（数据来自 NanoReview）}

• 实时监控 —— CPU / GPU / 内存 / 硬盘温度、频率、功耗曲线，前台显示在页面顶栏，也能做成游戏覆盖层
• 磁盘健康 —— SMART 健康度检测（CrystalDiskInfo 方案）：温度 / 通电时间 / 寿命 / 读写量，支持 SSD TRIM 与机械盘碎片整理
• 电池消耗分析 —— 电池消耗趋势与应用耗电排行，比 Windows 设置更强的电池报告
• 键盘测试 / 屏幕坏点检测 —— 按键高亮检测（可区分左右 Shift / Ctrl / Alt）；全屏纯色与检测图案找坏点、漏光
• 核间延迟查询 —— 查看社区上传的核间延迟热力图，对比不同 CPU 的核心间通信延迟

---

游戏工具箱

游戏监控（覆盖层设计器）

拖拽式设计监控覆盖层：内置多种布局预设，可自由添加 FPS、CPU / GPU 温度与负载、内存占用等组件；游戏中实时显示，也可勾选指标记录数据（最长 2 小时），结束后一次性导出 JSON / Markdown / CSV 报告。

_{拖拽设计覆盖层布局、自动识别游戏窗口 ｜ 邀请码一键入网，不用公网 IP、不用改路由器}

• 游戏联机助手 —— 基于 Tailscale 的三层虚拟局域网，我的世界 / 泰拉瑞亚 / 幻兽帕鲁等 TCP / UDP 游戏都能直连；朋友粘贴邀请码自动装客户端入网，内置防火墙一键放行与网络检测
• 记录查看 —— 解析导出的记录并图表化回放：每个指标一张独立图表、各自纵轴刻度，支持分组切换、区间裁剪与 P1 / P99 统计
• 运行库修复 —— 一键补齐 Visual C++ 2008-2026、.NET Framework、DirectX 旧版游戏组件（微软官方源 + 签名校验）
• 游戏防晕3D —— 屏幕中央准星 + 四边标记辅助，缓解 3D 眩晕

---

系统优化与安全

_{垃圾清理（Winapp2 规则库 4000+ 条）｜ 启动项管理 ｜ 流氓软件的克星（含恢复中心）}

• 恶意软件拦截器 —— 把软件厂商证书加入系统不信任列表，从源头阻止流氓软件安装运行
• 恶意软件沙盒 —— Sandboxie-Plus 沙盒环境，安全运行分析可疑程序，删掉沙盒即可还原
• 右键菜单管理 —— 启用 / 禁用 / 编辑 / 添加 / 删除右键菜单项，覆盖新建 / 发送到 / 打开方式与 WinX 菜单
• 时间同步 —— 一键切换系统 NTP 服务器（阿里云 / 腾讯云 / 国家授时中心…），服务器测速、偏差检测、立即校时与一键修复
• 还有更多 —— 配置修改器 / Windows 隐藏功能 / .NET 环境补全 / 后台节流省电神器 / OptimizerDuck 优化鸭 / Windows 镜像下载

---

网络工具

_{网速测试（浙大 / Ookla / Cloudflare 多节点）｜ 流量监控器 ｜ 端口占用}

• Hosts 编辑 —— 可视化编辑系统 Hosts，支持启用 / 禁用规则和 DNS 刷新
• WiFi 密码 —— 查看本机连接过的 WiFi 网络名称和密码
• 网络优化 —— TCP 参数优化、DNS 延迟测速与配置、公网 IP 查询、网络重置与 DHCP 修复
• 网络调度器 —— 汇聚多网络适配器，智能分配流量，Wi-Fi 有线自动加速
• 局域网文件分享 —— 局域网内 HTTP 文件分享服务，其他设备用浏览器直接访问，支持拖拽上传

---

格式转换

拖入文件、选目标格式、批量队列逐个转换：图片 / 音视频 / Word / Excel / PPT / PDF / 文本 / JSON 全部互转，单个文件失败不打断批次。

_{支持拖入与多选，批量队列处理，可打包 ZIP 交付；每个目标格式自带可调参数（码率 / 位深 / 采样率 / CRF / 分辨率 / 帧率……）}

• 文档转换 —— Word / Excel / PPT / PDF / Markdown / HTML / JSON 互转；OOXML 文档内置渲染引擎逐页截图导出 PDF / 长图，中文排版零重采样
• 图片 / 音视频 —— FFmpeg + ImageMagick 双引擎，视频可调编码器、码率控制、预设、分辨率与音轨
• OCR 识别 —— 调用 Windows 原生 OCR，图片转文字一步到位
• PDF 工具 —— 合并、拆分、文字层提取表格转 XLSX
• 旧格式兜底 —— .doc / .ppt / .wps 等老格式自动调用本机 Office / WPS 转换，缺失时给出明确提示

---

实用工具

_{时间同步（NTP 服务器测速与一键校时）｜ Windows 镜像下载（UUP Dump 官方 API）｜ 社区工具}

• 电脑使用教程 —— 新电脑开箱指南、基础操作、烤机检测、常识与辟谣
• 常用官网 / 服务网点查询 —— Steam、Epic、UU 加速器等官网一键直达；各大品牌官方服务网点地址
• 正版软件商店 / UniGetUI —— 基于 WinGet 及 winget / scoop / chocolatey / pip / npm 的软件安装与管理
• 电子文盲测试 —— 25 道电脑基础知识选择题，测测你的水平
• 社区工具 —— 社区贡献的工具插件，下载安装即用（仅免安装版提供）

---

内置工具（47 款）

采用 Fluent Design 构建的原生工具体系，不依赖第三方软件，覆盖系统优化、硬件检测、网络诊断、游戏增强等场景。

| 分类 | 数量 | 代表工具 | |:----:|:----:|:---------| | 系统工具 | 13 | 垃圾清理 / 流氓软件的克星 / 恶意软件拦截器 / 启动项管理 / 时间同步 / Windows 镜像 | | 硬件工具 | 12 | 性能测试 / 一键三烤 / 毒蘑菇测试 / 快速验机 / 磁盘健康 / 键盘测试 / 电池分析 | | 网络工具 | 8 | 网速测试 / 流量监控器 / 端口占用 / Hosts 编辑 / 局域网文件分享 / 网络优化 | | 游戏工具 | 5 | 游戏监控 / 记录查看 / 游戏联机助手 / 运行库修复 / 游戏防晕3D | | 实用工具 | 9 | AI 助手 / 格式转换 / 电脑使用教程 / 常用官网 / 正版软件商店 / UniGetUI |

展开完整工具列表

系统工具

• 恶意软件拦截器 - 通过将软件厂商证书加入系统不信任列表，阻止流氓软件安装和运行
• 流氓软件的克星 - 扫描和清理流氓右键菜单、自启动、计划任务、服务、浏览器插件和文件关联残留，含恢复中心
• 恶意软件沙盒 - Sandboxie-Plus 沙盒环境，安全运行和分析可疑程序 / 恶意软件，删除沙盒即可还原系统
• 垃圾清理 - 基于 Winapp2 规则库扫描并清理应用缓存、临时文件与注册表残留（引擎来自 FluentCleaner）
• 启动项管理 - 扫描开机自启动项目（注册表 Run、启动文件夹、计划任务、服务等），隐藏微软条目，快速定位异常自启动
• 右键菜单管理 - 管理 Windows 右键菜单项，支持启用 / 禁用 / 编辑 / 添加 / 删除、新建 / 发送到 / 打开方式及 WinX / 现代 / IE 菜单
• 配置修改器 - 修改注册表中的 CPU、GPU、系统等硬件信息显示，支持一键恢复原始配置
• 后台节流省电神器 - 通过 Windows 11 效率模式（EcoQoS）节流后台进程以省电降温，前台应用保持流畅（基于 Energy Star X 内核）
• .NET 环境补全 - 检测并补全 .NET Runtime / SDK / Framework，从官网获取最新版本，一键下载安装缺失组件
• Windows 隐藏功能 - 查询、启用、禁用、重置 Windows 实验性功能开关（ViVe 引擎移植，毫秒级响应）
• Windows 镜像 - 下载 Windows 原版系统镜像（ISO / ESD），支持 ESD 转 ISO
• 时间同步 - 一键切换系统 NTP 时间服务器，支持服务器测速、偏差检测、立即校时、时间服务修复与恢复系统默认
• OptimizerDuck 优化鸭 - 开源的 Windows 系统优化工具，支持系统清理、性能优化、隐私保护等功能

硬件工具

• 性能测试 - 全面测试 CPU / GPU / 内存 / 硬盘 / 浏览器性能，按比例计算游戏与办公性能评分，导出专业 PDF 报告
• 跑分排行 - 上传测试报告到社区，查看全球排行榜，与同硬件用户对比性能
• 一键三烤 - CPU / GPU / 网卡压力测试工具，自由勾选烤机项目，网卡烤机支持自定义数据量与速率参考，实时监控温度、频率、功耗与网卡吞吐
• 毒蘑菇测试 - GPU 分形压力测试：轻松 / 中等 / 变态三档压力，超分辨率渲染突破屏幕，实时帧率监控
• 快速验机 - 新电脑验机向导：外观检查、硬件信息、硬盘通电、屏幕坏点、外设测试、摄像头、音频、三烤测试，一站式完成
• 磁盘健康 - SMART 健康度检测（CrystalDiskInfo 方案）：温度 / 通电 / 寿命 / 读写量，支持 SSD TRIM 与机械盘碎片整理
• 电池消耗分析 - 分析电池消耗趋势、应用耗电排行，比 Windows 设置更强大的电池分析工具
• 键盘测试 - 检测键盘按键是否正常，按键后高亮显示，支持大 / 小键盘布局切换，可区分左右 Shift / Ctrl / Alt，支持 Copilot 键
• 屏幕坏点检测 - 全屏播放纯色与检测图案，快速发现屏幕坏点、漏光、色阶问题
• CPU 天梯图 / GPU 天梯图 - 查看桌面 / 笔记本性能天梯图，支持品牌筛选与排序（数据来自 NanoReview）
• 核间延迟查询 - 查看社区上传的核间延迟热力图，对比不同 CPU 的核心间通信延迟

网络工具

• 网速测试 - 原生测试网络延迟、下载与上传速度，支持浙大 / Ookla / Cloudflare 多测速节点切换
• 流量监控器 - 选择网卡实时查看各连接的流量、速度与延迟，整卡吞吐折线统计，支持快照录制与滑条回放
• 端口占用 - 查看系统所有 TCP / UDP 端口占用情况，定位占用进程
• Hosts 编辑 - 可视化编辑系统 Hosts 文件，支持启用 / 禁用规则和 DNS 刷新
• WiFi 密码 - 查看本机已连接过的 WiFi 网络名称和密码
• 网络优化 - TCP 参数优化（拥塞控制 / Chimney / Nagle / 网卡节能）、DNS 延迟测速与配置、公网 IP 查询、网络重置与 DHCP 修复
• 网络调度器 - 汇聚多网络适配器，智能分配流量，Wi-Fi 有线自动加速
• 局域网文件分享 - 在局域网内创建 HTTP 文件分享服务，其他设备可通过浏览器访问和下载文件，支持拖拽上传

游戏工具

• 游戏监控 - 拖拽组件设计监控覆盖层，内置多种布局预设，实时显示 FPS、温度、负载等硬件参数，可勾选指标记录数据并导出 JSON / Markdown / CSV 报告
• 记录查看 - 解析游戏监控导出的 JSON / CSV 记录，回放 FPS、温度、负载等历史数据：每个指标一张独立图表、各自纵轴刻度，支持分组切换、区间裁剪与 P1 / P99 统计
• 游戏联机助手 - 虚拟局域网联机：把两台电脑接进同一个虚拟网络，朋友粘贴邀请码就能进，不需要公网 IP 也不用改路由器
• 运行库修复 - 检测并修复缺失的 Visual C++ 2008-2026、.NET Framework 4.8.1、DirectX 旧版游戏组件，微软官方源下载 + 签名校验
• 游戏防晕3D - 屏幕中央准星 + 四边标记辅助，缓解 3D 眩晕

实用工具

• AI 助手 - 智能系统代理，可诊断问题、优化配置、读写文件、执行命令、联网搜索并执行操作
• 格式转换 - 图片 / 音视频 / Word / Excel / PPT / PDF / 文本互转，OCR 识别、PDF 合并拆分、任意文件打包 ZIP，批量队列、拖入即用
• 电脑使用教程 - 新电脑开箱指南、基础操作、烤机检测、常识与辟谣，手把手教你用好电脑
• 常用官网 - 收录 Steam、Epic、UU 加速器等常用软件官方网站，一键直达
• 服务网点查询 - 查询各大品牌笔记本 / 台式机官方服务网点地址
• 正版软件商店 - 浏览并安装正版软件，基于 WinGet 软件源
• UniGetUI 包管理器 - 开源的 Windows 包管理器 GUI，支持 winget / scoop / chocolatey / pip / npm 等多种包管理器
• 电子文盲测试 - 测试你的电脑基础知识水平：25 道选择题，满分 100 分
• 社区工具 - 来自社区贡献的工具插件，下载安装即可使用，支持提交和删除工具（仅免安装版提供）

---

收录工具（89 款）

随包收录 89 款经典第三方工具，覆盖硬件检测全场景，一键启动、无需安装；也可以把自己的工具放进 Tools/ 目录自动识别。

| 类别 | 数量 | 代表工具 | |:----:|:----:|:--------| | 处理器工具 | 9 | CPU-Z / Core Temp / ThrottleStop / LinX / Prime95 / Superpi / wPrime / C2CLatency | | 显卡工具 | 9 | GPU-Z / DDU / GpuTest / dxvachecker / nvidiaProfileInspector / AMD·NVIDIA 驱动下载 | | 硬盘工具 | 22 | CrystalDiskMark / CrystalDiskInfo / DiskGenius / HDTune / WizTree / finaldata / URWTEST | | 内存工具 | 7 | MemTest / MemTest64 / TM5 / Thaiphoon Burner / ZenTimings / 魔方内存盘 | | 综合检测 | 5 | AIDA64 / HWiNFO / HWMonitor / Speccy / RWEverything | | 外设工具 | 7 | Keyboard Test / Mouse Rate / MouseTester / KeyTweak / 在线外设测试中心 | | 显示器工具 | 3 | 色域检测 / UFO 测试 / Windows HDR Calibration | | 烤鸡工具 | 1 | FurMark 烤机版 | | 其他工具 | 26 | Everything / Dism++ / Rufus / Ventoy / Autoruns / ProcessMonitor / BlueScreenView / DirectX 修复 |

完整工具列表详见 官网文档。

---

快速开始

系统要求

• Windows 10 1809（build 17763）或更高版本，Windows 11 完全支持
• x64 / x86 / ARM64 三种架构，安装包自包含：.NET 10 运行时与 Windows App SDK 都在包里，不用另外装
• 安装版为每用户安装，装完即用；程序运行时需要管理员权限的功能会统一请求提权（详见常见问题）

| Windows 版本 | 支持状态 | |:------------:|:--------:| | Windows 11 | ✅ 完全支持 | | Windows 10 21H2+ | ✅ 完全支持 | | Windows 10 1809+ | ✅ 最低支持 |

| 平台 | 支持状态 | |:----:|:--------:| | x64（Intel / AMD 64 位） | ✅ 完全支持 | | x86（Intel / AMD 32 位） | ✅ 完全支持 | | ARM64（高通骁龙等） | ✅ 原生支持 |

安装

GitHub Releases（推荐）

到 Releases 下载最新版本，提供两种形式：

• 便携版（ZIP） —— 解压即用，无需安装，也可以放进 U 盘随身带
• 安装版（Inno Setup） —— 传统安装程序，可选安装位置与快捷方式

发布产物的签名策略见 Code signing policy。

GitCode Releases（国内镜像）

国内网络可从 GitCode 镜像 下载，速度更快。

Winget

winget install luolangaga.tubatools

Scoop

# 1. 添加图吧工具箱CE bucket
scoop bucket add tubatools https://github.com/luolangaga/scoop-tubatools
2. 安装（自动根据系统架构选择 x64 / arm64 便携版）
scoop install tubatools/tubatool

更新到最新版：scoop update tubatool。Scoop 源仓库：luolangaga/scoop-tubatools。

Microsoft Store

从源码构建

git clone https://github.com/luolangaga/tubatools.git
cd tubatools
dotnet build        # 编译（RuntimeIdentifier 自动匹配当前架构）
dotnet run          # 以 Unpackaged 模式运行（会请求管理员权限）
dotnet test         # 跑 xUnit 测试

主程序是 TubaWinUi3.WinUI3/TubaWinUi3.csproj；想在真实包身份下自测打包形态，用 .\run-msix.ps1 注册一个开发包再启动。

环境要求

• .NET 10 SDK
• Visual Studio 2022 17.14+ 或 VS Code（配合 C# Dev Kit）
• 最低支持 Windows 10 1809，支持 x86 / x64 / ARM64

---

架构

TubaWinUi3.WinUI3/            主程序（WinUI 3 / .NET 10 / Windows App SDK）
  App.xaml.cs                 启动、提权、全局异常兜底
  MainWindow.xaml             自定义标题栏 + NavigationView + Frame，AI 吉祥物常驻顶栏
  Pages/                      各工具页（内置工具、设置、搜索、时间同步、镜像下载……）
  Services/
    BuiltinTools/             47 款内置工具实现（IBuiltinTool + BuiltinToolRegistry）
    Ai/                       AI 助手适配层（TubaChatProvider / AgentToolAdapter / 防死循环护栏）
    GameTunnel/               游戏联机（Tailscale 封装、邀请码、防火墙、端口探测）
    JunkCleaner/              垃圾清理引擎（FluentCleaner.Core 移植 + Winapp2 规则库）
    TimeSync/                 时间同步（w32tm 封装、SNTP 探测、预设服务器）
    ToolCatalog.cs            扫描 Tools/ + tools.json，合并架构变体，生成工具卡片
    HardwareInfoService.cs    WMI / CPU-Z 硬件信息（P/Invoke）
    LiteMonitorService.cs     LibreHardwareMonitor 实时监控（单例）
  Assets/
    BuiltinIcons/             内置工具的彩色矢量图标（按 Fluent System Icons 规范手绘）
    DocEngine/                WebView2 文档引擎（markdown-it / pdf.js / SheetJS / pdf-lib）
  Strings//             界面语言资源（zh-CN / en-US）
  Metadata/tools.json         工具元数据的单一事实源（描述 / 排序 / 跨分类 / 内置工具挂载）
TubaWinUI3.BackEnd/           NativeAOT 辅助进程（主动拦截）
TubaWinUi3.Compatible/        .NET Framework 4.8 WinForms 兼容版（旧系统）
TubaWinUi3.Tests/             xUnit 测试（工具目录 / 时间同步 / 联机 / 垃圾清理 / 本地化……）
Tools/                        随包收录的第三方工具（按中文分类目录存放）
installer*.iss · Launcher/    Inno Setup 安装脚本与原生启动器
website-winui3/ · android-tuba-installer/ · file-transfer-web/ · cloudflare-worker/
                              官网 / 安卓安装助手 / 局域网传输 / 联机信令（各自独立工具链）

几个值得一提的实现细节：

• 工具清单是数据驱动的 —— Metadata/tools.json 是唯一事实源：描述、卡片顺序、跨分类副本、内置工具挂载全在里面；目录本身或其中任一可执行文件被 match 命中才会收录，未收录的目录不会展示。
• 只扫描一次，多架构合并成一张卡 —— x64 / x86 / ARM64 变体合并展示，并按当前系统自动选中合适的架构。
• 图标三选一图层 —— 内置工具优先用彩色矢量 SVG，缺图就回退到字体字形，卡片模板三层并存、按需显隐，所以漏配图标只会退回旧样式、不会开天窗。
• CPU 温度 / 频率 / 功耗走 MSR —— 依赖 PawnIO 驱动：检测到「已安装但没加载」会自动补启动，仍不可用时给出官方安装引导；FPS 覆盖层则走 ETW 的 DxgKrnl Present 事件，不需要驱动。
• AI 助手有会话级护栏 —— 同会话重复的工具调用第二次直接拦截，思维链与工具结果有长度上限，连续 6 轮纯工具调用且无进展会注入终止指令（AgentToolLoopGuard），两套引擎共用。
• 文档转换四引擎逐级回退 —— OfficeCLI 原生渲染逐页截图 → WebView2 文档引擎（pdf.js / SheetJS）→ 纯 C# 转换器 → 本机 Office / WPS COM。
• 垃圾清理是规则库驱动 —— 内置 Winapp2.ini / Winappx.ini 两个规则库，两阶段执行（只读分析 → 真删），离线开箱即用，也能一键更新规则库。
• 快捷方式不用 PowerShell 生成 —— 开始菜单搜索与「发送到桌面」共用进程内的 WScript.Shell COM，避免中文路径经子进程命令行变成乱码。
• 界面多语言即时生效 —— 资源在 Strings/，工具元数据用 Metadata/Tools_<语言>.json 覆盖层，切换语言不用重启。

---

常见问题

Q：为什么一打开就弹 UAC？ 烤机、FPS 覆盖层、垃圾清理、时间同步这些功能要读传感器或写系统设置，必须提权。非打包版启动时会统一请求管理员权限；微软商店版按包身份运行，不强制提权。

Q：里面收录的工具是官方的吗？ 89 款第三方工具版权归各自作者所有，随包分发仅供学习交流，请支持正版；内置的 47 款是本项目原生实现，源码就在这个仓库里。

Q：能放在 U 盘里随身带吗？ 可以。便携版解压即用，配置默认写在 %LocalAppData%\TubaWinUi3\；想在移动硬盘上带着数据走，就在程序目录放一个 .config_location 标记文件，配置会改写进程序目录的 Data\。

Q：杀毒软件报警怎么办？ 部分工具具备系统级操作能力（驱动、注册表、清理），可能被启发式引擎误报。官方发布产物由 SignPath 签名，请只从官方渠道下载。

Q：会不会拖慢电脑？ 没有常驻后台服务：硬件监控只在打开对应页面或游戏覆盖层时运行，监控覆盖层与联机助手退出即结束， 不常驻、不偷跑。默认「关闭窗口 = 最小化到系统托盘」只是让程序留在托盘、免得重开时再检测一遍硬件； 托盘右键「退出」就是彻底结束，不想要这个行为可以在「设置 → 常规」里关掉。

Q：工具打不开 / 提示缺 DLL？ 用「运行库修复」一键补齐 Visual C++ 2008-2026、.NET Framework、DirectX；老格式文档转换需要本机装有 Office / WPS，没装会给出明确提示。

Q：AI 助手要用哪家的模型？ 内置小图吧自带模型开箱即用，也可以填任意 OpenAI 兼容端点（DeepSeek / OpenAI / 本地模型……），API Key 只保存在本机。

Q：日志在哪里？ 默认在 %LocalAppData%\TubaWinUi3\（便携模式为程序目录的 Data\）：agent-debug.log 是 AI 助手日志；启动阶段崩溃会记录到 %TEMP%\app_crash.log。

---

交流群聊

欢迎加入 QQ 群交流讨论：485079194

---

贡献者

感谢所有为本项目做出贡献的开发者！

---

荣誉与认可

• AtomGit G-Star 毕业项目 —— 通过 AtomGit 官方评审取得毕业认证（编号 No.0614，2026.07.24），欢迎关注 atomgit.com/luolangaga/tubatool
• HelloGitHub 收录推荐 —— 在 HelloGitHub 项目库中获得推荐
• Trendshift 收录 —— 在 Trendshift 上登过 C# 分类日榜与月榜

---

相关链接

• 官网与文档：tubawinui3.cn
• 下载：GitHub Releases · GitCode 镜像
• 包管理器：Winget · Scoop 源仓库
• 问题反馈：Issues · 讨论区
• 安卓安装助手：android-tuba-installer
• 交流群：QQ 485079194

---

Code signing policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

由 SignPath.io 提供免费代码签名，证书由 SignPath Foundation 颁发。签名在自动化构建流程中完成，因此签名代表该二进制是由本仓库源码自动构建产生的 —— 构建须通过可信构建系统（GitHub Actions）校验来源，并经 Approver 人工批准后才会签名。

• Committers / Reviewers: @luolangaga
• Approvers: @luolangaga
• 隐私政策 / Privacy policy: PrivacyPolicy.txt

---

许可证

本项目采用 GPL-3.0 开源协议。

• 源代码可自由使用、修改和分发
• 衍生作品必须以相同协议开源
• 详见 LICENSE；附带的 License.txt 为软件使用须知与网络/隐私声明，不构成对 GPL-3.0 的附加限制

---

捐赠支持

如果这个工具箱对你有帮助，欢迎请我喝杯奶茶 ☕ 感谢每一位支持者！

---