当前位置：首页 > news >正文

CodeWF Toolbox：一个用 Avalonia + Prism 做出来的开发者工具箱

news 2026/5/28 16:03:34

今天这篇文章，站长来聊聊我自己开发的CodeWF Toolbox，CodeWF 工具箱。

熟悉我的朋友一般都叫我“站长”，因为我还有一个网站：CodeWF。这个工具箱也是围绕我平时写代码、维护网站、整理资料、排查问题时反复遇到的需求做出来的。它不是一个只摆几个按钮的 Avalonia Demo，而是一个已经有 100 多个工具入口的本地桌面工具箱。

项目使用C# + Avalonia + Prism + Semi.Avalonia + Ursa，目标很直接：把开发者日常会反复打开的转换、编码、格式化、校验、生成、查询类工具集中到一个本地桌面应用里。

这次我重点不讲空泛的“跨平台 UI 能力”，而是按 CodeWF Toolbox 现在实际能做什么来拆。界面截图也重新做了一版，主窗口尺寸调小了一些，首页加入了常用与推荐工具入口；整体用我个人更喜欢的沙漠主题展示。

先看一段功能巡览 GIF。

首页：不再只是空白欢迎页

新版首页是我这次重点调整的地方之一。以前它更像一个普通欢迎页，现在则更适合作为工具箱入口。

首页上方展示三个核心信息：

当前可用工具数量：117。
当前功能模块数量：12。
当前运行平台：Windows x64。

下面增加了“常用与推荐工具”。如果用户已经使用过工具，就优先显示常用工具；不足 8 个时用推荐工具补齐。第一次打开时也不会显得太空，用户能直接看到时间戳、Base64、GUID、二维码、Hash、日志阅读器这类高频入口。

这个调整虽然不大，但对工具箱体验很关键。我做桌面工具箱时有一个很明确的想法：首页不应该只是宣传页，它应该让用户打开以后马上能开始工作。

转换工具：开发者每天都会用到的小功能

转换工具是 CodeWF Toolbox 里最基础、也最常用的一类能力。

当前转换模块里包含这些独立页面和数据驱动工具：

时间戳转换：Unix 时间戳与本地时间互转，支持秒和毫秒。
Base64 编解码：对 UTF-8 文本进行编码、解码、交换和复制。
GUID 生成器：批量生成 GUID，并控制大小写、格式。
YAML 转 JSON、JSON 转 YAML。
图片转 ICO 图标。
挪车二维码生成器。
Base64 文件转换器。
Base64 字符串编码/解码。
大小写转换。
Color 选择器。
日期时间转换器。
整数进制转换器。
JSON/TOML/XML/YAML 互转。
List 转换器、Markdown to HTML、罗马数字转换等。

比如 Base64 编解码页面，输入文本后直接得到编码结果。

这类功能很小，但它们正是开发者一天里最容易反复打开网页搜索的东西。我把它们做成本地工具箱以后，优点很明显：响应快、离线可用、没有广告，也不需要把临时文本贴到外部站点。

开发工具：格式化、解析、差异对比和命令辅助

开发模块更偏“写代码过程中的辅助工具”。这些工具很多都是我自己日常会用到的，所以放进工具箱时优先级比较高。

现有开发类工具覆盖面很宽：

JSON 格式化、JSON 压缩、JSON 路径提取、JSON 转 CSV。
YAML 格式化。
XML 格式化、XML XPath 测试。
SQL 美化和格式化。
CSV 转 JSON、CSV 转 Markdown 表格。
INI 转 JSON、.env 转 JSON。
HTTP Header 解析。
Data URL 解析。
Docker 镜像标签解析。
Docker Run 转 docker-compose。
Chmod 计算器。
Crontab 表达式生成。
Regex Tester、Regex cheatsheet、正则替换。
Git 备忘录。
Hex dump 查看器。
SemVer 检查与比较。
Markdown 表格生成器。
NanoID、UUID v5、随机端口等生成类工具。

上图里的 JSON 格式化页面比较典型：左侧输入原始 JSON，右侧输出格式化结果，还能控制键名排序和缩进空格。

这类工具很适合被抽象成数据驱动表单：输入字段、输出字段、运行函数、自动运行配置都可以由ToolSpec描述，而不是每个工具都写一套重复 XAML。对我来说，这一点很重要，因为工具数量一多，后期维护成本才是真正的问题。

安全工具：Hash、HMAC、密钥和密码相关能力

安全模块里放的是开发中经常需要临时计算或生成的安全相关内容。

当前已有功能包括：

Bcrypt 哈希与比较。
BIP39 助记词/种子生成。
AES、TripleDES 文本加密解密。
Hash 文本：MD5、SHA1、SHA2、SHA3、RIPEMD160。
HMAC 生成器。
密码强度分析。
PDF 签名检查。
RSA 密钥对生成。
Token 生成器。
ULID 生成器。
UUID v4 生成器。

截图里是 Hash 文本工具。输入CodeWF Toolbox后，工具直接生成摘要值。类似功能虽然可以在命令行里做，但桌面工具更适合临时验证、复制和对比。

Web 工具：HTTP、JWT、URL、MIME、UA 都能处理

Web 模块主要面向前后端联调、接口排查和 Web 元数据处理。站长平时维护网站和写接口时，这类小工具打开频率很高。

现有工具包括：

Basic Auth Header 生成。
当前设备信息查看。
HTML 实体转义/反转义。
HTML WYSIWYG 内容生成。
HTTP 状态码查询。
JWT 解析。
Keycode 信息查看。
Open Graph / Twitter Meta 标签生成。
MIME 类型查询。
OTP 一次性密码生成与验证。
Outlook SafeLink 解码。
Slugify 字符串。
URL 编码/解码。
URL 解析。
User-Agent 解析。
JSON Diff。

这些工具的共同特点是输入输出结构都比较标准，非常适合放进统一的 ToolFramework 里维护。

媒体工具：二维码、WiFi 二维码和 SVG 占位图

媒体模块目前不是剪辑软件那类“大媒体工具”，而是偏开发者日常需要的小型生成工具。

现在已有：

二维码生成器。
WiFi 二维码生成器。
SVG 占位符生成器。

二维码生成器支持输入 URL 或文本，并生成 QR Code。这个功能放在本地工具箱里很方便，尤其是临时把本机地址、文档地址、仓库地址给手机扫的时候。

网络工具：IP、CIDR、MAC 地址

网络模块目前覆盖的是 IP 和 MAC 地址这类基础工具：

IPv4 地址转换器：十进制、二进制、十六进制、IPv6 mapped 等格式。
IPv4 范围扩展：起止 IP 转 CIDR 范围。
IPv4 子网计算器。
IPv6 ULA 生成器。
MAC 地址生成器。
MAC 地址厂商查询。

这些工具对后端、运维、网络排查和本地开发环境配置都很实用。我把它们放进 CodeWF Toolbox，是希望一些零散但常用的查询和换算不再依赖临时搜索。

数学、计量、文本与数据工具

CodeWF Toolbox 不是只做编码转换，它还把一些小计算和文本处理工具也放进来了。

数学类：

ETA 计算器。
数学表达式计算器。
百分比计算器。

计量类：

Benchmark builder。
Chronometer 计时器。
温度转换器。

文本类：

ASCII Art 文本生成器。
Emoji 选择器。
Lorem ipsum 生成器。
Numeronym 生成器。
字符串混淆器。
文本 Diff。
文本统计。

数据类：

IBAN 校验和解析。
电话号码解析与格式化。

这些功能不一定每天都用，但它们都属于“用时临时找工具”的场景。既然我已经在做一个工具箱，就希望它能把这些低频但实用的小能力也收进去。

日志阅读器：不是把大文件一次性读进内存

日志阅读器是我比较喜欢的一个模块方向。

它不是简单地把日志文件ReadAllText()后塞进文本框，而是按可见窗口渲染，面向大日志文件和实时 tail 场景设计。界面上能看到：

打开日志。
重新加载。
跳到末尾。
跟随尾部。
当前文件路径。
可见内容区域。

这类功能对桌面工具来说很有价值。很多时候我只是想快速看一个几百 MB 的日志，不想打开 IDE，也不想让普通文本编辑器卡住。

国际化资源管理：XML 翻译文件的合并与管理

项目里还有一个CodeWF.Modules.XmlTranslatorManager模块，用来处理 XML 语言资源管理。

它包含：

合并 XML 文件。
管理 XML 文件。
多语言属性和语言类模型。

这个模块算是 CodeWF Toolbox 自己反过来服务自己的一个例子。工具多了以后，多语言资源、模块菜单、资源合并都需要被工具化；如果这些事情全靠手动维护，时间长了很容易出错。

**注：**当前版本使用Json做为多语言文件，Xml格式见分支i18n-xml。

主题与语言：沙漠主题确实更耐看

这次截图我主要用了沙漠主题。整体观感比纯浅色更有辨识度，又不像深色主题那样压暗内容。

主题切换效果可以看这个 GIF：

当前主题列表包括：

跟随系统。
浅色模式。
深色模式。
水生。
沙漠。
黄昏。
夜空。

语言资源包括：

简体中文。
繁体中文。
English。
日语。

这里值得注意的是，主题和语言不是简单地换几个字符串。桌面应用要长期可用，主题、控件库、字体、窗口尺寸、列表宽度、下拉框宽度都要一起看。比如这次主窗口就从偏大的启动尺寸收到了更适合日常桌面的比例，同时首页卡片也做了更紧凑的 4 列布局。

它是怎么组织这么多工具的

如果每个小工具都写一个完整页面，后期维护会很痛苦。CodeWF Toolbox 现在大致有两种工具组织方式。

第一类是独立页面工具。

例如：

时间戳转换。
Base64 编解码。
GUID 生成器。
图片转 ICO。
日志阅读器。
XML 翻译资源管理。

这类工具有更具体的交互和状态，所以单独写 View 和 ViewModel 更合适。

第二类是数据驱动工具。

例如：

JSON 格式化。
JWT 解析。
Hash 文本。
URL 编码。
MIME 查询。
MAC 地址查询。
二维码生成。
数学计算。
文本统计。

这些工具的输入输出模式更标准，可以用ToolSpec描述：

public classToolSpec { publicstring Id { get; set; } publicstring Category { get; set; } publicstring Name { get; set; } publicstring Description { get; set; } public List<ToolField> Fields { get; } = []; public List<ToolOutput> Outputs { get; } = []; public Func<ToolRunContext, CancellationToken, Task> RunAsync { get; set; } publicbool AutoRun { get; set; } }

这样新增工具时，很多情况下只需要补：

工具 ID。
分类。
输入字段。
输出字段。
算法函数。
多语言资源。
图标。

UI 表单可以复用，工具逻辑也不会污染主窗口。这也是我希望 CodeWF Toolbox 能继续扩展下去的基础。

Prism 模块化让功能持续增加

项目入口里通过 Prism 注册模块：

moduleCatalog.AddModule<MainModule>(); moduleCatalog.AddModule<ToolFrameworkModule>(); moduleCatalog.AddModule<ConverterModule>(); moduleCatalog.AddModule<DevelopmentModule>(); moduleCatalog.AddModule<SecurityModule>(); moduleCatalog.AddModule<WebModule>(); moduleCatalog.AddModule<MediaModule>(); moduleCatalog.AddModule<NetworkModule>(); moduleCatalog.AddModule<MathModule>(); moduleCatalog.AddModule<MeasurementModule>(); moduleCatalog.AddModule<TextModule>(); moduleCatalog.AddModule<DataModule>(); moduleCatalog.AddModule<LogViewerModule>(); moduleCatalog.AddModule<XmlTranslatorManagerModule>();

每个模块负责注册自己的菜单项和 View。主程序不需要知道每个工具页面内部怎么实现，它只负责：