老板与员工：分钟理解 Subagent 架构颂

一、项目背景与核心价值1. 解决的核心痛点Navicat的数据库连接密码并非明文存储而是通过AES算法加密后写入.ncx格式的XML配置文件中。一旦用户忘记密码常规方式只能重新配置连接效率极低。本项目只作为学习研究使用不做其他使用。2. 项目核心价值跨平台运行基于Avalonia与.NET 8支持Windows、macOS、Linux全平台多场景解密支持配置文件批量解析、单条连接解密、手动输入密文解密三种模式易用性拉满现代化UI界面支持深色模式操作流程极简轻量高效无需复杂依赖基于.NET原生能力实现核心算法解密速度毫秒级。二、技术栈选型与考量NavicatPassword的技术栈选择围绕「跨平台、低耦合、高性能」三个核心目标具体选型如下技术领域 选型 选型考量前端UI框架 Avalonia UI 替代WPF的跨平台UI框架API与WPF高度兼容原生支持多平台、深色模式、响应式布局后端开发语言 C# (.NET 8) .NET 8跨平台能力强性能优异原生支持加密算法、XML解析等核心能力架构模式 MVVM (CommunityToolkit.Mvvm) 解耦UI与业务逻辑简化数据绑定、命令管理提升代码可维护性加密算法 AES-128-CBC 匹配Navicat官方的加密标准保证解密准确性数据存储 SQLite 轻量级嵌入式数据库用于保存用户的解密设置、历史记录等配置文件解析 .NET XmlDocument/XDocument 原生XML解析能力高效处理Navicat的.ncx配置文件三、项目架构设计MVVM项目严格遵循MVVM架构模式代码目录结构与职责划分清晰核心目录如下对应项目NavicatPassword/目录NavicatPassword/├── Views/ # 视图层UI界面Axaml文件仅负责展示无业务逻辑│ ├── MainView.axaml # 主界面解密操作核心页面├── ViewModels/ # 视图模型层连接View与Model处理UI交互逻辑│ ├── MainViewModel.cs # 主界面逻辑文件选择、批量解密、单条解密├── Services/ # 服务层核心业务逻辑封装│ ├── SystemService.cs # 密码解密核心服务├── Utils/ # 工具层解密方法└── App.axaml.cs # 应用入口全局配置各层核心职责View视图层仅通过Axaml定义UI结构通过数据绑定绑定ViewModel的属性和命令无任何业务代码ViewModel视图模型层通过ObservablePropertyCommunityToolkit.Mvvm特性实现属性通知通过ICommand处理按钮点击、文件选择等UI交互调用Service层完成核心逻辑Service服务层封装核心业务逻辑解密、文件解析是项目的「业务核心」ViewModel仅调用Service不直接处理业务Model模型层定义数据结构如数据库连接信息、应用配置等仅承载数据无业务逻辑。这种架构的优势在于UI与业务逻辑完全解耦后续无论是修改界面样式还是优化解密算法都无需改动其他层的代码可维护性和扩展性大幅提升。四、核心功能实现解析1. 密码解密核心算法AES-128-CBCNavicat的密码加密采用固定的Key和IV这是解密的关键。项目的核心解密代码如下且完全基于.NET原生System.Security.Cryptography实现using System.Security.Cryptography;using System.Text;namespace NavicatPassword.Services;public static class NavicatDecryptService{// Navicat固定的Key和IV核心private static readonly byte[] _key Encoding.UTF8.GetBytes(libcckeylibcckey);private static readonly byte[] _iv Encoding.UTF8.GetBytes(libcciv libcciv );////// 解密Navicat加密的密码字节数组//////加密后的字节数组///明文密码///解密失败时抛出异常public static string DecryptNavicatPassword(byte[] cipherBytes){if (cipherBytes null || cipherBytes.Length 0){throw new ArgumentException(加密字节数组不能为空, nameof(cipherBytes));}try{using Aes aes Aes.Create();// 匹配Navicat的加密模式CBC PKCS7填充aes.Mode CipherMode.CBC;aes.Padding PaddingMode.PKCS7;aes.Key _key;aes.IV _iv;// 创建解密器并执行解密ICryptoTransform decryptor aes.CreateDecryptor(aes.Key, aes.IV);byte[] plainBytes decryptor.TransformFinalBlock(cipherBytes, 0, cipherBytes.Length);// 转换为UTF8明文return Encoding.UTF8.GetString(plainBytes);}catch (Exception ex){throw new ArgumentException(解密失败可能是密文格式错误, ex);}}////// 重载解密Base64编码的密文字符串//////Base64密文/// 明文密码public static string DecryptNavicatPassword(string cipherBase64){byte[] cipherBytes Convert.FromBase64String(cipherBase64);return DecryptNavicatPassword(cipherBytes);}}关键细节说明固定Key/IVNavicat所有版本均使用libcckeylibcckeyKey和libcciv libccivIV这是解密的核心前提填充模式必须使用PKCS7而非PKCS5否则解密结果会出现乱码异常处理针对空值、格式错误等场景做了容错保证用户体验。2. .ncx配置文件解析Navicat的.ncx文件是XML格式核心是节点包含连接名称、地址、加密密码等信息。解析逻辑封装在NcxFileParserService中核心步骤如下using System.Xml.Linq;using NavicatPassword.Models;namespace NavicatPassword.Services;public class NcxFileParserService{////// 解析.ncx配置文件提取所有数据库连接信息//////配置文件路径/// 数据库连接列表public List ParseNcxFile(string filePath){if (!File.Exists(filePath)){throw new FileNotFoundException(配置文件不存在, filePath);}XDocument doc XDocument.Load(filePath);var connections new List();// 遍历所有Connection节点foreach (var connNode in doc.Descendants(Connection)){var connection new NavicatConnection{Name connNode.Attribute(Name)?.Value ?? string.Empty,Host connNode.Element(Host)?.Value ?? string.Empty,Port connNode.Element(Port)?.Value ?? string.Empty,Database connNode.Element(Database)?.Value ?? string.Empty,// 加密密码是Base64编码的字符串CipherPassword connNode.Element(Password)?.Value ?? string.Empty};// 自动解密可选if (!string.IsNullOrEmpty(connection.CipherPassword)){try{connection.PlainPassword NavicatDecryptService.DecryptNavicatPassword(connection.CipherPassword);}catch{connection.PlainPassword 解密失败;}}connections.Add(connection);}return connections;}}解析逻辑的核心是提取节点的属性和子节点值并自动调用解密方法生成明文密码最终封装为NavicatConnection模型返回给ViewModel由View展示。五、跨平台适配要点基于Avalonia和.NET 8项目的跨平台适配几乎「零成本」但仍有几个关键细节需要注意文件路径适配需要自己手动导出文件打开Navicat-文件-导出连接-导出密码(一定要勾选弹框底部导出密码否则解析不到密码修正路径.ncx)UI适配Avalonia的布局系统原生支持响应式通过Grid、StackPanel等布局控件保证在不同分辨率、不同系统下的UI一致性深色模式通过Avalonia的ThemeVariant实现无需单独开发。发布打包通过.NET Publish命令可一键打包不同平台的可执行文件# Windows (x64)dotnet publish -c Release -r win-x64 --self-contained true -o publish/win# macOS (x64)dotnet publish -c Release -r osx-x64 --self-contained true -o publish/macos# Linux (x64)dotnet publish -c Release -r linux-x64 --self-contained true -o publish/linux六、使用场景与落地效果1. 核心使用场景开发人员找回密码忘记Navicat连接密码快速解析配置文件找回运维批量管理批量解析服务器上的Navicat配置文件统一管理数据库连接密码测试环境核查验证测试环境数据库密码是否符合规范提升安全合规性已通过测试版本Navicat Premium Lite (Free) 17.3.6版本。附项目快速上手从源码构建# 克隆仓库git clone https://gitee.com/dingshuanglei/NavicatPassword.gitorgit clone https://github.com/dingshuanglei/NavicatPassword.git# 进入目录cd NavicatPassword# 构建项目dotnet build -c Release# 运行dotnet run --project NavicatPassword/NavicatPassword.csproj核心操作流程选择Navicat的.ncx配置文件自动解析所有连接批量解密/单条解密查看明文密码或手动输入密文一键解密。伦烁屏挤