Projects

CodeWF.Toolbox

基於 avalonia + prism 的模塊化跨平台桌面工具箱

项目说明

CodeWF.Toolbox

CodeWF.Toolbox

CodeWF.Toolbox 是一个基于 Avalonia + Prism 的模块化桌面工具箱,面向开发者日常效率场景。项目将主程序、公共服务与功能模块解耦,方便后续继续扩展新的工具页,而不会把应用演化成一个难维护的大窗体工程。

特性

  • 基於 avalonia ui 與 semi/ursa 控制項構建跨平台桌面界面。
  • 使用 prism 模塊目錄、依賴注入與 region 導航組織工具頁面。
  • 多语言资源已迁移为 JSON,并接入 Lang.Avalonia.Json
  • 內置 ai、格式轉換、日誌查看、開發輔助、xml 翻譯管理等模塊。
  • 保留面向 native aot 發布的腳本與平台常量配置。
  • 已完善菜單註冊、工具搜索和區域導航邊界處理。

內置工具

分組 說明
日誌查看 快速打開大日誌文件,只渲染當前可見區域,並支持文件持續追加時的 tail 跟隨。
格式轉換 提供 json/yaml、base64、guid、日期時間與圖片轉圖標等工具。
開發輔助 提供 json/yaml 格式化等日常開發小工具。
xml 翻譯管理 用於比對、合併和維護 xml 國際化資源。

目錄結構

src/
  CodeWF.Toolbox/                    桌面应用、主界面、设置与资源
  CodeWF.Core/                       公共抽象、服务与区域定义
  CodeWF.Controls/                   公共控件
  CodeWF.Modules.AI/                 AI 工具模块
  CodeWF.Modules.Converter/          转换工具模块
  CodeWF.Modules.Development/        开发辅助模块
  CodeWF.Modules.LogViewer/          大文件日志查看模块
  CodeWF.Modules.XmlTranslatorManager/ XML 国际化管理模块
  CodeWF.Toolbox.Tests/              单元测试工程
docs/
  assets/                            独立 SVG 图示

快速開始

環境要求:

  • .NET 11 SDK。
  • avalonia 支持的 windows、macos 或 linux 桌面環境。
dotnet restore CodeWF.Toolbox.slnx
dotnet build CodeWF.Toolbox.slnx
dotnet run --project src/CodeWF.Toolbox/CodeWF.Toolbox.csproj

新增模塊流程

  1. src/CodeWF.Modules.* 下创建模块工程。
  2. 实现 IModule
  3. 通过 IToolMenuService 注册分组与工具菜单。
  4. 将页面注册到 RegionNames.ContentRegion
  5. App.ConfigureModuleCatalog 中加入模块。
  6. 補齊本模塊的多語言資源和生成的語言鍵。

倉庫