快捷工具组件（宿主 1.3.0）

8 个工具共享服务和主题，各自使用符合用途的操作布局；既可以从快捷面板直接打开，也可以通过 Code Studio 工程编译为独立工具窗口。内置入口不需要临时编译。核心实现位于本目录。1.1.0 起，发布工程包含私有命名空间的实现快照，不再调用宿主旧版页面；旧宿主安装新工具包也能获得新界面。用 tests/QuickTools.Validation/SynchronizeToolProjects.ps1（PowerShell 7）同步实现快照和版本信息。

1.1.0 专用界面

计算器：24 键数字/运算键盘、结果屏幕、计算历史，单位/进制和日期换算独立分页。
剪贴板：可搜索和筛选的片段库、详情编辑器，隐私设置默认折叠。
屏幕助手：截图/OCR/取色工具栏、暗色像素画布、缩放与结果面板。
端口查询：可排序的进程表、协议/文字筛选、统计与进程检查器。
文本助手：输入/输出双栏，格式编码、正则、差异比较分页。
重命名：规则与改名前后表格并排，预览/执行/撤销工作流。
二维码：生成/识别分页、大预览和独立内容区。
系统操作：音频、麦克风、窗口、防休眠、网络状态各自独立卡片。

工具	EditorWorkspaces 工程	首版功能
剪贴板增强与常用片段	ClipboardPlus	文本历史、搜索、固定片段、纯文本复制/粘贴、图片存储、进程排除
屏幕小助手	ScreenAssistant	框选截图、Windows OCR、贴图、取色、物理像素测量、1–8 倍预览
即时计算与换算	QuickCalculator	安全表达式、单位、2–36 进制、时间戳、日期差
端口占用查询	PortInspector	TCP/UDP IPv4/IPv6、PID、路径、启动时间、确认结束进程
开发者文本助手	DeveloperText	JSON、URL/Unicode/Base64/HTML、GUID、逐行处理、正则、差异、摘要
批量重命名	BatchRenamer	替换、前后缀、编号、扩展名、预览、无覆盖执行、回滚、撤销
二维码工具	QrTool	UTF-8 内容生成、图片/剪贴板识别、复制、PNG 保存
系统快捷操作	SystemShortcuts	默认音频输出、默认通信麦克风静音、窗口置顶、定时防休眠、IP

快捷面板

使用已有快捷键唤起面板，切到“工具与命令”（Ctrl+2），输入名称搜索并打开；也可以固定常用工具。

直接输入下列命令会显示可复制的结果，不打开大窗口。Enter 复制或打开，F5 刷新动态结果。

= 1920/1080
calc sqrt(256)
unit 1 GiB to MiB
time 1700000000
port 8080
json {"name":"XFE","enabled":true}
base64 中文
unbase64 5Lit5paH
url 中文 + 空格
unurl %E4%B8%AD%E6%96%87
uuid
ip
qr 要生成二维码的内容

计算使用有限的表达式语法，不执行 C# 或脚本；表达式内 % 为取余，计算器 % 按键则表示当前值除以 100；三角函数使用弧度。GB 为十进制容量，GiB 为二进制容量。

“携带剪贴板文本”默认关闭，勾选后仅在打开工具时读取一次文本。计算和文本命令不写入搜索历史。文件搜索结果右键可传入重命名工具或计算 SHA256/MD5；本版没有自动读取资源管理器的多选内容，多个文件请在重命名工具中添加或拖入。

数据与安全边界

默认不记录剪贴板。主动开启后，内置入口关闭页面仍会记录，需按“暂停记录”或退出工具箱停止；独立工具进程关闭即停止。普通历史仅在内存，固定片段使用 Windows 当前用户 DPAPI 加密保存。支持应用提供的排除标记、进程排除名单；不能可靠识别所有未标注密码或敏感文本。
数据路径：%LOCALAPPDATA%\XFEToolBox\CrossVersion\QuickTools。固定片段最多 100 项，每项最多 65,536 字符，总序列化容量不超过 8 MiB。失败时不把尚未存储的片段误标为已固定。
截图、OCR、二维码、文本处理均在本机执行，不上传内容。OCR 需要已安装的 Windows OCR 语言包；没有时显示安装提示，不自动下载。
结束进程前确认，并在同一个句柄上重新核对进程启动时间与程序路径。拒绝系统关键进程、本工具和身份不明进程；不结束子进程树。不自动申请管理员权限，权限不足时明确报错。结束后系统端口表可能短暂保留旧记录。
重命名仅处理用户选定的普通文件，不递归处理目录，不覆盖目标。执行前再次核对文件大小/修改时间；这不是密码学文件身份保证。失败尝试回滚并保留恢复记录；断电等中断留下的 .pending.json 不自动重放。恢复记录位于 RenameHistory。
PNG 保存使用新建模式，不覆盖已有图片；同名时请换名保存。识别出的链接不自动打开。
音频切换会修改系统默认输出；麦克风按钮作用于默认通信设备。防休眠有明确时限，退出宿主恢复，不修改电源计划，也不阻止手动睡眠。

验证

运行 tests/QuickTools.Validation；加 --package 会生成图标、打包，通过正式编译器验证 8 个包并逐个打开真正的独立工具窗口；随后加载同一份运行时编译程序集，自动验证真实入口和按钮，保存截图与包哈希证据。另有不可见独立进程验证宿主运行时依赖。测试仅关闭自己启动的进程，仅重命名测试目录中的文件。

完整步骤与未自动操作的系统交互，见 tests/QuickTools.Validation/README.md。