最近一直在持续完善自己的开源项目 ToolForge，今天正式发布 v0.2.2！

ToolForge 是一款基于 Rust + Tauri 2 构建的开源桌面工具箱，面向开发者与效率工作者，通过插件化架构整合开发调试、数据转换、文件处理、系统管理和日常效率工具。

从 v0.1.10 引入 WASM 插件市场，到 v0.2.0 实现官网一键安装，再到 v0.2.1 完善插件分发与下载统计，ToolForge 一直在围绕插件生态持续演进。

而这次 v0.2.2，我们开始解决另一个问题：

已经有这么多实用工具了，为什么只能由用户在桌面界面中手动操作？能不能让 AI Agent 和命令行也直接使用这些工具？

因此，本次版本最重要的更新是：

ToolForge 正式引入 CLI 与 MCP 接口，让插件能力可以通过命令行执行，也可以提供给 AI Agent 调用。

与此同时，项目还增加了插件级 AI 授权管理、文件访问范围限制、插件开发指南、公开下载统计面板，并继续扩展在线插件生态。

这意味着 ToolForge 不再只是一个通过图形界面使用的桌面工具箱，而是开始具备面向自动化流程和 AI Agent 提供工具能力的基础。

一、AI Agent 能力正式上线：支持 MCP

这是 v0.2.2 最值得关注的变化。

过去，ToolForge 的工具主要面向桌面用户。

例如，当我们需要格式化 JSON、计算 Hash、转换编码或者处理文件时，通常需要：

1. 打开 ToolForge。

2. 找到对应工具。

3. 输入数据或选择文件。

4. 执行操作。

5. 复制或保存结果。

这种方式对于人工操作来说比较方便，但对于自动化任务和 AI Agent 来说并不理想。

现在，我们希望这些工具不只能通过图形界面使用，还可以被其他程序调用。

1. 新增 MCP 接口

本次新增了通过 MCP（Model Context Protocol）向 AI Agent 提供插件功能的能力。

MCP 是一种用于连接 AI 应用与外部工具、数据源的开放协议。

通过 MCP，AI Agent 可以发现外部工具提供的能力，并在相应的授权和调用机制下执行操作。

ToolForge v0.2.2 新增了：

tfp mcp

通过这一命令，可以将支持对应接口的 ToolForge 插件功能提供给 MCP 客户端。

这让 ToolForge 中的工具开始能够参与 AI Agent 的工作流程。

例如，一个 AI Agent 在处理开发任务时，可能需要：

• 格式化或修复 JSON。

• 查询 JSON 数据。

• 计算文件 Hash。

• 转换文本编码。

• 分析正则表达式。

• 解析 URL。

• 处理 CSV 或 XLSX 数据。

• 执行文件格式转换。

以前，这些操作通常需要用户打开不同的工具手动完成。

现在，随着插件逐步声明 AI Agent 接口，ToolForge 开始能够通过 MCP 向外部 AI 应用提供这些工具能力。

需要说明的是，Agent 实际可以调用哪些功能，取决于插件声明的接口以及对应的授权配置，并不是所有桌面操作都会自动开放。

2. 插件可以声明 Agent 接口

为了实现这一能力，本次对插件系统进行了大规模调整。

插件现在可以声明面向 CLI 和 AI Agent 的函数接口。

这意味着插件除了提供图形界面，还可以描述哪些功能允许通过外部调用执行。

本次已有大量工具加入相应的接口声明，包括：

• JSON Formatter

• JSON Query

• JSON Schema

• HTTP Client

• Hash

• Encoder

• Regex

• PDF

• CSV Viewer

• XLSX Viewer

• Log Viewer

• Hex Viewer

• Image Converter

• SVG Converter

• URL Parser

• UUID

• Text Diff

• Table Converter

• Markdown Editor

• ENV Editor

• Mock Data

• QR Code

• Barcode

以及其他开发者工具。

对于 ToolForge 来说，这是一项重要的架构变化。

插件不再仅仅描述如何展示一个工具界面，还开始描述自身能够向外部提供哪些可调用的功能。

这为后续与 AI Agent、自动化系统和命令行工作流集成提供了基础。

二、新增 CLI：终端也能直接运行插件

除了 MCP，本次还新增了 ToolForge 命令行工具：

tfp

对应的插件执行命令：

tfp

现在可以通过命令行调用支持 CLI 接口的插件函数。

对于开发者来说，这意味着不必每次都打开桌面应用才能执行工具操作。

例如，在自动化脚本或者开发流程中，我们可能希望完成：

• 数据格式转换

• JSON 处理

• 文件校验

• 编码转换

• 开发数据生成

过去，这些功能主要通过桌面界面提供。

现在，符合接口声明和配置要求的插件函数也能够通过终端执行。

CLI 与 MCP 使用同一套插件能力

这次设计中，一个值得关注的方向是：

让插件能力同时服务于桌面界面、命令行和 AI Agent，而不是为每种入口重复实现一套工具。

插件负责提供实际功能。

桌面应用负责交互展示。

CLI 负责命令行调用。

MCP 则为 AI Agent 提供标准化的工具访问入口。

这样的设计可以减少重复开发，也让 ToolForge 的插件更容易参与其他工作流程。

应用发布集成命令行工具

本次还调整了应用发布流程，将 tfp 命令行工具作为 Sidecar 随应用打包。

同时，在设置页面新增了创建 tfp 命令的相关功能。

这样用户可以通过应用设置完成命令行入口的配置，而不需要完全依赖手动处理程序路径。

三、Agent 权限管理：不是所有插件都能随意调用

当工具开始支持 AI Agent 调用时，权限管理也变得更加重要。

因为桌面工具与普通的 AI 对话能力不同。

某些工具可能涉及：

• 读取本地文件。

• 写入处理结果。

• 发送网络请求。

• 处理敏感数据。

• 执行文件转换。

• 访问用户选择的目录。

如果缺少调用权限控制，直接将所有能力开放给外部 Agent 并不合适。

因此，本次 v0.2.2 同时增加了一套面向 AI Agent 的访问管理机制。

1. 插件级 Agent 访问控制

现在可以通过 ToolForge 设置页面管理 AI Agent 对插件的访问。

并且支持针对不同工具配置命令行和 AI Agent 的访问方式。

用户可以根据实际需要，决定哪些插件通过对应接口提供服务。

2. 分离 CLI 与 Agent 设置

本次还调整了核心配置结构，支持按调用渠道保存接口设置。

也就是说，CLI 与 AI Agent 的访问配置可以分别管理。

接口设置具有默认启用行为，但实际调用还需要受到相应授权与接口声明约束。

3. Agent 授权与调用来源

为了支持更明确的访问控制，ToolForge 还增加了相关状态管理能力，包括：

• Agent 授权记录。

• Agent 可访问的文件夹信息。

• 工具调用来源。

• 插件声明的可调用接口。

宿主可以结合授权状态与插件接口声明，决定是否允许执行某次 Agent 调用。

4. 限制单次插件调用的文件访问范围

本次 WASM 运行时还增加了一个重要的安全限制：

插件文件访问限制在每次调用对应的授权范围内。

这意味着文件访问能力不应被简单理解为插件可以任意读取整个本地文件系统。

当插件需要读取用户选择的文件时，宿主需要根据调用范围提供对应能力。

同时，本次还增加了 read_to_end，用于支持读取完整的用户选定文件。

对于 ToolForge 后续的 Agent 能力来说，权限管理将是非常重要的基础。

目标不是让 AI Agent 获得尽可能多的权限，而是在明确的接口声明与授权范围内使用工具。

四、大量工具迁移到在线插件市场

除了 AI Agent 能力，本次还继续推进内置工具向在线插件市场迁移。

此前，ToolForge 已经逐步将 HTTP Client、SQL Formatter、SemVer 等工具迁移到在线市场。

v0.2.2 进一步扩大了迁移范围。

本次涉及的工具包括：

数据与格式处理

• JSON Formatter

• JSON Query

• JSON Schema

• JSON to Code

• Format Converter

• Table Converter

• CSV Viewer

• XLSX Viewer

• XML 相关数据处理工具

• Encoder

• Base Converter

文本与开发辅助

• Regex

• Text Tools

• Text Diff

• Unicode

• Markdown Editor

• Cron

• URL Parser

• IP Calculator

• UUID

• Random

• Password

• Number Words

• Color

文件与图像处理

• PDF

• Hex Viewer

• Image Converter

• SVG Converter

• Image Palette

• Image Info

• Log Viewer

其他工具

• ENV Editor

• Mock Data

• Curl Converter

与此同时，二维码、条形码、Hash 等工具也增加了相应的 CLI 或 Agent 接口声明。

这次迁移不仅是调整插件安装位置，更重要的是让这些工具逐步适配新的接口体系。

未来工具可以通过在线市场独立分发，并根据自身能力对外提供可调用函数。

对于用户来说，可以根据自己的需求选择安装相应插件。

对于开发者来说，也有机会通过统一的插件架构，同时面向桌面用户和自动化调用场景提供功能。

五、插件兼容性管理进一步完善

随着在线插件数量持续增长，插件版本与宿主应用之间的兼容性也变得越来越重要。

有些新插件可能依赖更新版本的 ToolForge 运行时。

如果直接安装到旧版本应用中，可能无法正常加载或运行。

因此，本次新增了 minAppVersion 兼容性检查机制。

现在插件安装和加载时会检查最低应用版本要求。

当插件需要更新版本的 ToolForge 时，插件市场可以提示用户更新桌面应用。

这样可以减少插件版本与运行时不兼容带来的问题。

同时，项目也调整了插件 SDK 的版本管理方式，让相关 Crate 的版本维护更加独立。

六、新增公开插件下载统计面板

在 v0.2.1 中，ToolForge 已经上线了统一插件下载统计服务，并开始在官方网站展示插件下载量。

这次 v0.2.2 进一步完善了下载统计功能。

1. 公开下载统计 Dashboard

新增公开的插件下载统计面板。

用户现在可以通过可视化方式查看相关插件下载数据。

相比之前只在插件卡片上展示下载数字，统计面板可以更加集中地展示插件下载情况。

2. 图表交互增强

本次为统计面板增加了：

• 加载状态。

• 柱状图详情展示。

• 统一的应用品牌图标。

让统计数据的展示和交互体验更加完整。

3. 工具详情展示下载量

官方网站的工具详情页面现在也可以展示插件下载次数。

这样用户不仅可以在工具列表中看到下载信息，也可以在插件详情中了解相应数据。

4. 插件版本历史

插件详情页新增版本历史展示。

对于持续更新的插件，可以更加方便地查看版本演进情况。

这些改进让 ToolForge 的插件市场不仅能够完成安装和更新，也开始提供更加完整的插件信息。

七、新增插件开发指南

随着 CLI、MCP 和在线插件能力不断完善，插件开发文档也变得更加重要。

这次正式补充了开发者文档和插件开发指南。

对于希望参与 ToolForge 插件开发的开发者来说，可以通过官方文档了解项目的插件体系。

相关内容也为后续社区贡献提供了更清晰的入口。

同时，官方网站还进行了多项改进，包括：

• 重新构建工具使用文档。

• 优化页面内容宽度。

• 调整导航链接布局。

• 使用自定义样式下拉组件。

• 优化搜索输入框的聚焦效果。

• 改进页面图标与链接布局。

官方网站：

https://toolforge.devlive.org/

八、继续扩展在线工具生态

本次 v0.2.2 除了架构升级，还新增了三项工具能力。

1. HTTP Cache Inspector

新增 HTTP Cache 离线检查工具。

HTTP 缓存机制是前端和 Web 开发中的重要内容。

例如：

• Cache-Control

• ETag

• Expires

• Last-Modified

不同缓存配置会影响浏览器和客户端的资源复用行为。

通过 HTTP Cache Inspector，可以辅助开发者离线分析 HTTP 缓存相关信息。

对于排查浏览器缓存和接口缓存问题具有实用价值。

2. Electricity Cost

新增 Electricity Cost 电费估算功能。

支持根据电价方案进行费用估算。

这也是 ToolForge 向生活效率场景扩展的又一项工具。

3. Plant Care

新增 Plant Care 植物养护记录工具。

支持记录个人植物养护情况。

虽然这类工具与传统开发者工具关系不大，但对于插件化桌面平台来说，工具本身可以覆盖更多不同的使用场景。

九、稳定性与工程优化

除了功能更新，本次还进行了一系列工程改进。

1. 插件运行时

• 调整已安装插件的加载逻辑，将相关能力整合到 tf-host。

• 修复原生构建环境下文件不存在时的错误类型。

• 优化插件 SDK 版本管理。

• 完善文件访问与调用接口相关实现。

2. 命令行工具

• 完善不同平台下命令行路径的测试。

• 将 tfp 命令行工具集成到发布包中。

3. 插件构建

• 固定打包工具使用的 Rust 编译器版本。

• 优化插件构建输入变更检测。

• 对只影响宿主的 SDK 修改跳过不必要的插件重新发布。

• 减少不必要的插件构建任务。

4. 官方网站

• 优化页面布局。

• 修复部分链接图标换行问题。

• 改进工具开发指南的展示。

• 修复部分 Git 标签获取行为。

这些改进主要是为了让 ToolForge 的插件开发、构建、运行和发布流程更加稳定。

十、从工具箱到 AI Agent 工具平台

回顾最近几个版本，ToolForge 的演进路线已经逐渐清晰。

版本	主要变化
v0.1.7	文件、PDF、Hex、文本编码等基础开发工具
v0.1.8	文档、表格、数据处理和效率工具扩展
v0.1.9	插件后台服务能力
v0.1.10	WASM 插件运行时与在线插件市场
v0.2.0	官网一键安装插件，增强网络与流式处理能力
v0.2.1	插件下载统计与大规模工具生态扩展
v0.2.2	CLI、MCP、AI Agent 授权与插件函数接口

最初开发 ToolForge 时，我想解决的是开发者日常工具过于分散的问题。

后来，随着工具数量增加，我们开始建设在线插件市场，让工具可以独立安装和更新。

而现在，又出现了一个新的需求：

工具不应该只能由人通过界面操作，也应该能够成为 AI Agent 和自动化流程的一部分。

例如，当 AI Agent 在处理一个实际任务时，可能需要完成多个步骤：

1. 读取用户授权的数据文件。

2. 对数据进行格式转换。

3. 使用 JSON Schema 检查数据结构。

4. 计算结果文件的 Hash。

5. 将处理结果写入指定位置。

这些步骤中的部分功能，ToolForge 已经通过现有插件提供。

现在，通过 CLI 与 MCP 接口，相关插件功能开始具备被外部 Agent 调用的条件。

不过，这并不意味着 ToolForge 已经成为一个完整的自主 Agent 系统。

ToolForge 更希望提供可靠、可扩展、可授权的工具执行能力，让外部 AI Agent 根据需要调用。

AI Agent 负责理解任务、规划步骤。

ToolForge 负责提供具体工具和执行接口。

这种分工，也更符合我希望 ToolForge 长期发展的方向。

十一、项目地址与下载

项目名称： ToolForge

当前版本： v0.2.2

技术栈： Rust + Tauri 2

核心能力：

• 开源桌面工具箱

• 在线插件市场

• WASM Component 运行时

• 命令行工具

• MCP 接口

• AI Agent 插件授权管理

• 插件独立分发

• 插件下载统计

GitHub：

https://github.com/devlive-community/toolforge

官方网站：

https://toolforge.devlive.org/

版本下载：

https://github.com/devlive-community/toolforge/releases

完整版本对比：

https://github.com/devlive-community/toolforge/compare/v0.2.1...v0.2.2

欢迎大家下载体验。

如果你已经在使用 ToolForge，可以升级到 v0.2.2，体验新的 CLI 与 MCP 能力。

如果你对插件开发、WASM 或 AI Agent 工具集成感兴趣，也欢迎阅读项目文档，一起参与开发。

十二、最后

对于我来说，v0.2.2 是 ToolForge 开发过程中非常重要的一个版本。

因为这次我们没有单纯追求新增多少工具，而是开始思考已有工具可以通过哪些方式被使用。

同一个工具，既可以通过桌面界面交互，也可以通过命令行执行，还可以通过 MCP 提供给 AI Agent。

这让 ToolForge 的插件不再完全依赖图形界面。

同时，Agent 授权管理、调用来源记录和文件访问范围限制，也让这套机制开始具备更明确的权限边界。

我希望未来的 ToolForge 不只是一个工具数量很多的桌面应用，而是一个真正开放、可扩展、能够融入 AI 工作流的工具平台。

当然，目前仍然有许多需要继续完善的地方，包括插件接口覆盖范围、Agent 调用体验、权限控制以及开发者文档等。

如果 ToolForge 对你有所帮助，欢迎在 GitHub 点个 Star。

也欢迎通过 Issue 和 Pull Request 提出建议、反馈问题，或者参与插件开发。

最后想和大家讨论一个问题：

如果 AI Agent 可以直接调用 ToolForge 的插件，你最希望它帮你自动完成哪些开发任务？

欢迎交流！

---

GitHub： https://github.com/devlive-community/toolforge

官网： https://toolforge.devlive.org/

Releases： https://github.com/devlive-community/toolforge/releases