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

今天这篇文章站长来聊聊我自己开发的CodeWF ToolboxCodeWF 工具箱。熟悉我的朋友一般都叫我“站长”因为我还有一个网站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 ListToolField Fields { get; } []; public ListToolOutput Outputs { get; } []; public FuncToolRunContext, CancellationToken, Task RunAsync { get; set; } publicbool AutoRun { get; set; } }这样新增工具时很多情况下只需要补工具 ID。分类。输入字段。输出字段。算法函数。多语言资源。图标。UI 表单可以复用工具逻辑也不会污染主窗口。这也是我希望 CodeWF Toolbox 能继续扩展下去的基础。Prism 模块化让功能持续增加项目入口里通过 Prism 注册模块moduleCatalog.AddModuleMainModule(); moduleCatalog.AddModuleToolFrameworkModule(); moduleCatalog.AddModuleConverterModule(); moduleCatalog.AddModuleDevelopmentModule(); moduleCatalog.AddModuleSecurityModule(); moduleCatalog.AddModuleWebModule(); moduleCatalog.AddModuleMediaModule(); moduleCatalog.AddModuleNetworkModule(); moduleCatalog.AddModuleMathModule(); moduleCatalog.AddModuleMeasurementModule(); moduleCatalog.AddModuleTextModule(); moduleCatalog.AddModuleDataModule(); moduleCatalog.AddModuleLogViewerModule(); moduleCatalog.AddModuleXmlTranslatorManagerModule();每个模块负责注册自己的菜单项和 View。主程序不需要知道每个工具页面内部怎么实现它只负责应用启动。登录窗口。主窗口。主题和语言。公共服务。Prism Region。模块目录。系统托盘和退出行为。这个边界很重要。工具箱这种项目很容易越写越散最后主窗口里全是功能细节。Prism 模块化至少给它提供了一个比较清晰的扩展方向也让我后面继续加工具时不至于把主程序写乱。**问**为什么要在主工程强引用工具模块答Windows AOT发布后托管的模块动态库就不能正常动态加载了依赖于.NET运行时发布成非托管动态库也不支持模块化动态加载未研究过非AOT发布Win7就无法兼容运行。适合学习的点如果你正在学 Avalonia我觉得 CodeWF Toolbox 比单窗口 Demo 更值得看因为它处理了很多真实桌面应用会遇到的问题主窗口和登录窗口。系统托盘。主题切换。多语言资源。模块化导航。ToolFramework 数据驱动工具。文件选择。剪贴板复制。大日志文件查看。用户配置和使用记录。Windows/Linux/macOS 平台差异预留。发布配置。这类工程点往往不是“能不能画出按钮”的问题而是“工具多了以后还能不能维护”的问题。这个项目也是我自己在边做边整理这些工程问题。目前还可以继续打磨的地方CodeWF Toolbox 已经有比较完整的方向但我自己也很清楚它仍有继续打磨空间部分工具页面的控件样式还可以继续统一比如输入框边框、按钮层级、间距。部分中文资源仍带有机器翻译痕迹可以逐步润色。工具数量已经很多后续可以给首页推荐工具做更明确的分类策略。搜索结果可以进一步突出工具分类和最近使用情况。日志阅读器可以加入示例文件或拖拽打开入口。构建仍有预览 SDK 提示、过时 API 和 Avalonia XAML 可达性警告后续可以逐步清理。我这次已经把主窗口默认尺寸调小并把首页补成 8 个快捷入口沙漠主题下整体更像一个日常可用的工具箱而不是一个被拉得过大的桌面壳。最后CodeWF Toolbox 是我自己开发和维护的工具箱。它的价值不在于某一个单独工具有多复杂而在于把很多开发者高频小工具组织成一个可扩展的桌面应用。它现在已经覆盖转换工具。开发工具。安全工具。Web 工具。媒体工具。网络工具。数学工具。计量工具。文本工具。数据工具。日志阅读器。国际化 XML 资源管理。用 C# 写桌面工具并不过时。对文件、本地剪贴板、日志、离线转换、临时生成、格式化和系统集成这些场景来说本地桌面应用依然很有价值。而 Avalonia Prism 给这个方向提供了一条比较现代的路线既能跨平台又能用模块化方式维护大量功能。后面站长还会继续把 CodeWF Toolbox 往“真正日常可用”的方向打磨。比起只做一个演示窗口我更想练的是这种能力如何把不断增加的小工具组织成一个还能长期维护的产品。