[English](README_EN.md) | 中文
> [!WARNING]
> 近期有许多非官方下载渠道，请注意甄别风险！请仅通过本文档「[安装](#安装)」列出的官方渠道下载。
> **不懂电脑，也想让 AI 帮你搞定？** 打开内置的「[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 修复 |
完整工具列表详见 [官网文档](https://tubawinui3.cn)。
---
## 快速开始
### 系统要求
* 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](https://github.com/luolangaga/tubatools/releases/latest) 下载最新版本，提供两种形式：
* **便携版（ZIP）** —— 解压即用，无需安装，也可以放进 U 盘随身带
* **安装版（Inno Setup）** —— 传统安装程序，可选安装位置与快捷方式
发布产物的签名策略见 [Code signing policy](#code-signing-policy)。
#### GitCode Releases（国内镜像）
国内网络可从 [GitCode 镜像](https://gitcode.com/luolangaga/tubatool) 下载，速度更快。
#### Winget
```powershell
winget install luolangaga.tubatools
```
#### Scoop
```powershell
# 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](https://github.com/luolangaga/scoop-tubatools)。
#### Microsoft Store
### 从源码构建
```powershell
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](https://dotnet.microsoft.com/download/dotnet/10.0)
- [Visual Studio 2022 17.14+](https://visualstudio.microsoft.com/) 或 [VS Code](https://code.visualstudio.com/)（配合 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](https://atomgit.com) 官方评审取得毕业认证（编号 No.0614，2026.07.24），欢迎关注 [atomgit.com/luolangaga/tubatool](https://atomgit.com/luolangaga/tubatool)
* **HelloGitHub 收录推荐** —— 在 [HelloGitHub](https://hellogithub.com/repository/luolangaga/tubatools) 项目库中获得推荐
* **Trendshift 收录** —— 在 [Trendshift](https://trendshift.io/repositories/51042) 上登过 C# 分类日榜与月榜
---
## 相关链接
* 官网与文档：[tubawinui3.cn](https://tubawinui3.cn)
* 下载：[GitHub Releases](https://github.com/luolangaga/tubatools/releases) · [GitCode 镜像](https://gitcode.com/luolangaga/tubatool)
* 包管理器：[Winget](https://winget.run/pkg/luolangaga/tubatools) · [Scoop 源仓库](https://github.com/luolangaga/scoop-tubatools)
* 问题反馈：[Issues](https://github.com/luolangaga/tubatools/issues) · [讨论区](https://github.com/luolangaga/tubatools/discussions)
* 安卓安装助手：[android-tuba-installer](android-tuba-installer)
* 交流群：QQ **485079194**
---
## Code signing policy
> Free code signing provided by [SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation](https://signpath.org).
由 [SignPath.io](https://about.signpath.io) 提供免费代码签名，证书由 [SignPath Foundation](https://signpath.org) 颁发。签名在自动化构建流程中完成，因此签名代表该二进制是由本仓库源码自动构建产生的 —— 构建须通过可信构建系统（GitHub Actions）校验来源，并经 Approver 人工批准后才会签名。
- **Committers / Reviewers**: [@luolangaga](https://github.com/luolangaga)
- **Approvers**: [@luolangaga](https://github.com/luolangaga)
- **隐私政策 / Privacy policy**: [PrivacyPolicy.txt](PrivacyPolicy.txt)
---
## 许可证
本项目采用 **GPL-3.0** 开源协议。
- 源代码可自由使用、修改和分发
- 衍生作品必须以相同协议开源
- 详见 [LICENSE](LICENSE)；附带的 [License.txt](License.txt) 为软件使用须知与网络/隐私声明，不构成对 GPL-3.0 的附加限制
---
## 捐赠支持
如果这个工具箱对你有帮助，欢迎请我喝杯奶茶 ☕ 感谢每一位支持者！
---
**如果觉得有用，给个 Star 吧！**
WinUI 3 · .NET 10 · Windows App SDK · GPL-3.0
