GLM-. 全面支持与 Gemini CLI 集成：HagiCode 的多模型进化之路

一、项目背景与核心价值

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（视图模型层）：通过ObservableProperty（CommunityToolkit.Mvvm特性）实现属性通知，通过ICommand处理按钮点击、文件选择等UI交互，调用Service层完成核心逻辑；

Service（服务层）：封装核心业务逻辑（解密、文件解析），是项目的「业务核心」，ViewModel仅调用Service，不直接处理业务；

Model（模型层）：定义数据结构，如数据库连接信息、应用配置等，仅承载数据，无业务逻辑。

这种架构的优势在于：UI与业务逻辑完全解耦，后续无论是修改界面样式，还是优化解密算法，都无需改动其他层的代码，可维护性和扩展性大幅提升。

四、核心功能实现解析

1. 密码解密核心算法（AES-128-CBC）

Navicat的密码加密采用固定的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/IV：Navicat所有版本均使用libcckeylibcckey（Key）和libcciv libcciv（IV），这是解密的核心前提；

填充模式：必须使用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.git

or

git clone https://github.com/dingshuanglei/NavicatPassword.git

进入目录

cd NavicatPassword

构建项目

dotnet build -c Release

运行

dotnet run --project NavicatPassword/NavicatPassword.csproj

核心操作流程

选择Navicat的.ncx配置文件，自动解析所有连接；

批量解密/单条解密，查看明文密码；

或手动输入密文，一键解密。统紊湛短