TreeTools 使用说明

Agent 助手

主窗口左侧打开「Agent」标签。按模式描述需求即可；处理在本地完成。

模式说明

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

操作步骤

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 增强版」。

屏幕截图

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

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

屏幕录制

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

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

证件照

拍摄或导入照片，按人脸排版生成标准证件照；人像抠图换底，边缘可羽化。

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

OCR 识图

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

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

取色器

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

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

磁盘填充

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

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

GIF 制作

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

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

插件商店与安装

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