TreeTools 使用说明

Agent 助手

主窗口左侧打开「Agent」标签。按模式描述需求即可；处理在本地完成。已安装且支持 Agent 的插件（如 OCR、PDF、图片编辑、压缩解压、网络诊断、Markdown 等）可被链式调用；未安装时也可能提示自动下载。

模式说明

• 执行任务：用自然语言描述要做的事（如拆分 PDF、加水印、整理文件、Ping 某主机）。Agent 会链式调用已安装插件与内置工具。可勾选「先计划再执行」，先看步骤再运行。
• 创建组件：直接描述想要的功能（例如「做一个倒计时，时间到醒目提醒」）。Agent 会自动生成 Python 插件并部署到插件网格，无需从零写代码。
• 问答：只回答问题、说明用法，不会改文件或调用会写盘的工具。
• 只读工具：可查看目录、读文件、读 PDF 文本、查 DNS / hosts 等，不会写入或执行有副作用的操作。

操作步骤

1. 打开左侧「Agent」面板，在顶部下拉框选择模式。
2. 「执行任务」时可按需勾选「先计划再执行」。
3. 在输入框描述任务或组件需求，发送后等待结果。
4. 若要生成自定义插件，务必切换到「创建组件」再发送；在「执行任务」模式下不会进入创建流程。

配置导入 / 导出

1. 菜单「文件 → Export Agent Config…」导出模型配置与 MCP 等到 JSON 文件。
2. 在另一台电脑用「文件 → Import Agent Config…」导入（会替换当前配置，请先确认）。
3. 也可在 Agent 面板点击「Models」，使用对话框中的 Export / Import。

网页长截图 · 网页批量截图

插件「网页长图截取」：对任意网址做整页长图（分段截取后自动拼接），也支持从 Excel / CSV 清单批量出图。全程本地处理，页面内容不必上传云端。

准备工作

1. 在插件商店安装「网页长图截取」（Web Screenshot）并打开。
2. 确认本机能访问目标网址（内网 / 外网均可，视页面而定）。
3. 若要用 Excel（.xlsx）做批量，本机需安装 Microsoft Excel；否则请先把表格另存为 CSV。

网页长截图（单页）

1. 在界面下方的单页区域填写名称（用于保存文件名）与网页 URL（需含 http/https）。
2. 可按需调整预览视口高度等选项；长图会按视口分段截取再拼接，适合超长页面。
3. 点击截图按钮，等待页面加载与滚动截取完成。
4. 完成后长图会保存到指定输出目录；可在结果区域查看进度与路径。

网页批量截图

1. 准备表格文件（Excel 或 CSV）：至少包含一列名称、一列网址；名称也可多列组合（插件支持多选名称列）。
2. 在插件上方选择「Excel / CSV 文件」，打开你的清单。
3. 在「提取列设置」中指定名称列与 URL 列；若表头规范，可尝试自动识别。
4. 确认输出目录与相关选项后，点击「开始批量」。
5. 进度区会显示已完成 / 总数；全部完成后可在输出目录查看每张长图。

常见注意点

• 需登录才能看的页面：请先在系统浏览器完成登录，或按插件提示处理；部分站点可能限制嵌入截图。
• 动态懒加载、很长的内层滚动区域：插件支持自动展开与内层滚动截取，复杂页可能多等一会儿。
• 批量任务中途失败：可检查对应行的 URL 是否可访问，修正表格后对失败项重跑。
• 无 Microsoft Excel 时：将 .xlsx 导出为 UTF-8 CSV 再导入即可。

文件对比 · 文件夹对比

插件「文件对比」含两个标签页：内容对比与文件夹 MD5 对比。

文件对比

1. 打开「文件对比」标签。
2. 选择或拖入左右两侧文件（可一次拖入两个文件）。支持文本、Word、Excel 及常见代码 / 配置格式。
3. 点击对比；用上一处 / 下一处差异按钮浏览结果。

文件夹对比 (MD5)

1. 切换到「文件夹对比 (MD5)」标签。
2. 选择或拖入左右两个文件夹。
3. 点击「开始对比」；将递归扫描文件并按相对路径比对 MD5。
4. 可勾选「显示相同文件」查看一致项。文件较多时扫描会稍久，界面不会卡住。

TreePDF

图纸 PDF 审阅（MuPDF）：打开、缩放、旋转、翻页。

1. 从插件商店安装「TreePDF」并打开。
2. 打开本地 PDF 文件（适合工程图纸等）。
3. 使用缩放、旋转、翻页浏览；需要文本编辑等增强能力时可安装「TreePDF 增强版」。

PDF 文件工具

合并、拆分、压缩 PDF；也可交给 Agent 用自然语言描述批量处理。

1. 打开「PDF文件工具」，按需选择合并 / 拆分 / 压缩等功能。
2. 添加本地 PDF，确认输出目录后执行。
3. 处理全程在本机完成；需要更强审阅体验时配合 TreePDF 使用。

屏幕截图

区域 / 全屏 / 延时截取，矩形、箭头、直线、高亮、文字批注，复制或保存 PNG/JPG。

1. 打开「屏幕截图」（TreeShot）。
2. 选择「区域截图」拖动框选，或「全屏截图」；也可使用延时截取。
3. 在预览上使用批注工具（矩形、箭头、直线、高亮、文字）。
4. 「复制」到剪贴板，或「保存」为 PNG / JPG。截取过程中可按 Esc 取消。

屏幕录制

全屏或区域录制为 MP4，支持框选、系统声音与硬件编码。

1. 打开「屏幕录制」，选择全屏或区域；区域模式可点「框选区域」。
2. 按需勾选「录制系统声音」，确认输出相关设置。
3. 点「开始录制」，结束后点「停止录制」；可在右侧预览已保存的 MP4。

证件照

拍摄或导入照片，按人脸排版生成标准证件照；人像抠图换底，边缘可羽化。本地 ONNX 模型推理，无需上传。

1. 打开「证件照」，用摄像头拍摄或导入本地照片。
2. 选择背景（换底或保留原图）、规格与边缘羽化等参数。
3. 点击「生成证件照」，在预览区查看后导出保存。

OCR 识图

图片文字识别，RapidOCR（PP-OCRv4）与 Windows OCR 双引擎，本地运行；支持 Agent 调用。

1. 打开「OCR识图」，导入或粘贴待识别图片。
2. 选择引擎（如可用）后开始识别。
3. 复制或导出识别文本。全程在本机完成，图片不会上传云端。

目标检测

基于 YOLO26 ONNX：摄像头实时检测、图片检测、人像分割、视频检测等，均在本地推理。

1. 从商店安装「目标检测」并打开（首次会加载模型，体积较大）。
2. 选择摄像头 / 图片 / 视频等模式，按界面提示开始检测。
3. 可调整置信度等参数；结果可预览或导出。

图片编辑

轻量本地编辑：旋转、缩放、裁剪、文字水印、去 EXIF。左侧调参、右侧预览；也可由 Agent 调用。

1. 打开「图片编辑」，选择输入图片；输出路径可留空（自动生成如 *_watermarked 等文件名）。
2. 在「操作」中选择：文字水印 / 旋转 / 缩放 / 裁剪 / 去 EXIF。
3. 按操作填写参数（如角度、目标宽高、裁剪矩形、水印文字与位置）。
4. 点击执行，在右侧预览结果后确认保存。

图片转换

图片格式转换、拼图、压缩，以及 PDF 与图片互转；与「图片编辑」互补。

1. 打开图片转换插件，按标签选择转换 / 拼图 / 压缩 / PDF 相关功能。
2. 添加文件，设置输出格式与质量等选项后执行。
3. 支持 Agent 调用，适合批量格式处理。

取色器

图片取色、传图识色、图片叠加，以及网页常用色选择。

1. 打开「取色器」。
2. 导入图片后点击取色，或使用传图识色 / 叠加等功能。
3. 可从网页常用色板中选择颜色并复制色值。

压缩解压

浏览归档内容、解压与打包。ZIP 内置；tar / tar.gz 依赖系统 tar（Windows 10+ 通常自带）；7z 需本机安装 7-Zip。

浏览

1. 打开「压缩解压」→「浏览」标签。
2. 选择 ZIP / 7z / tar / tar.gz 文件，点击「列出内容」查看条目。

解压

1. 切换到「解压」，选择归档与目标目录。
2. 点击「开始解压」；可随时取消。任务失败时请检查格式与是否已安装对应系统工具。

压缩

1. 切换到「压缩」，添加待打包文件 / 文件夹，选择输出格式与路径。
2. 开始压缩；ZIP 随时可用，其他格式以外置工具探测结果为准。

系统工具

批量重命名（模板 / 正则 / 大小写 / 扩展名 / 可撤销）、磁盘占用分析、重复文件查找。

批量重命名

1. 打开「系统工具」→「批量重命名」。
2. 添加文件或文件夹；设置前缀、后缀、查找替换（可勾选正则）、模板（如 {name}_{nn}{.ext}）、大小写与扩展名。
3. 预览新文件名后执行；需要时可撤销上次重命名。

磁盘分析 / 重复文件

1. 「磁盘分析」：选择目录，查看占用分布。
2. 「重复文件」：扫描指定范围，按内容哈希找出重复项，按提示处理。

网络诊断

本机网卡地址、外网 IP、下行测速、Ping、TCP 端口探测、DNS 解析、hosts 查看与编辑。支持 Agent（含只读模式部分能力）。

1. 打开「网络诊断」。
2. 本机地址：刷新网卡列表，或查询外网 IP。
3. 测速：选择测试大小后开始测速（结果受服务器与线路影响，仅供参考）。
4. Ping / 端口 / DNS：填写主机或域名后执行探测。
5. hosts：查看与编辑本机 hosts；写入可能需要管理员权限，请谨慎修改。

Markdown 笔记

左右分栏：左侧编辑、右侧即时预览；可打开 / 保存 .md，并导出 HTML 或 PDF（不依赖 WebEngine）。

1. 打开「Markdown 笔记」。
2. 直接输入 Markdown，或点「打开」载入已有文件。
3. 用「保存 / 另存为」写回 .md；需要分享时用「导出 HTML」或「导出 PDF」。

二维码工具

生成与扫码 QR：支持文本、Wi-Fi、名片、邮件等内容模板，可加中心 Logo，单条或批量导出 PNG；扫码基于 zxing-cpp。

1. 从商店安装「二维码工具」（Python 插件）并打开。
2. 生成：选择模板并填写字段，或直接输入文本；可设纠错级别与 Logo，导出 PNG。
3. 批量：按界面清单一次生成多张。
4. 扫码：选择本地图片识别二维码内容。

磁盘填充

模拟磁盘剩余空间：快速占位或真实写入，一键取消恢复。

1. 打开「磁盘填充」，选择目标磁盘与填充方式（快速占位 / 真实写入）。
2. 开始填充后，可用一键取消恢复空间。
3. 请确认目标盘与空间需求，避免误操作影响重要数据分区。

GIF 制作

视频转 GIF，或图片序列转 GIF（基于 FFmpeg，可复用 AVToolbox 的 ffmpeg）。

1. 打开「GIF 制作」。
2. 选择视频文件或图片序列，设置尺寸、帧率等参数。
3. 开始转换并保存生成的 GIF。

音视频工具箱

基于 FFmpeg / libVLC：剪辑、格式转换、裁切、音视频 / 字幕提取、压缩等。

1. 安装并打开「AVToolbox」。
2. 按任务选择对应功能页，添加媒体文件并设置参数。
3. 开始处理后在输出目录查看结果；GIF 制作可复用本插件的 ffmpeg。

更多常用插件

商店中还有更多工具，下面按用途速览（细节以插件界面为准）。

• 文档扫描：批量 OCR，扫描文件夹中的图片并导出 TXT，可选合并。
• 文档格式转换（office2pdf）：基于 LibreOffice，Office / HTML / 文本等与 PDF 互转。
• Toolkit：综合文本、JSON、哈希等通用处理，面向 Agent 任务。
• DevTools：JSON、JWT 验签、Base64URL、正则预设、时间戳时区，以及 URL / Cookie / curl / HTML 等爬虫辅助。
• 数据加解密：加密、解密与哈希计算。
• 剪贴板：剪贴板历史，快速回填。
• 文件下载：多任务下载管理。
• 快捷启动：管理并启动 TreeTools 外部程序、文件与常用目录。
• 宏录制：录制并回放键鼠 / UI Automation 操作。
• 语音转文字：Whisper 转写、字幕嵌/软硬字幕、系统麦 / 扬声器等（Python）。
• 视频翻译配音：识别字幕 → 翻译 → 配音 / 字幕合成一体化流程（Python）。
• 网络收音机 / 电视直播 / 内置浏览器：媒体收听与浏览类插件。

插件商店与安装

1. 主界面打开插件商店，浏览可见插件并一键安装 / 更新 / 卸载。
2. 自定义插件：菜单「插件 → 导入自定义插件」安装 .zip；也可把 zip 拖到插件网格。
3. Agent「创建组件」生成的插件会自动部署到网格，之后可像普通插件一样打开使用。
4. 导出共享：选中自定义插件 →「插件 → 导出自定义插件」，把 .zip 发给同事 / 朋友即可导入使用。
5. Agent 配置：菜单「文件 → Export / Import Agent Config」可在多机间同步模型与 MCP 设置。