【AI插件开发】Notepad++ AI插件开发实践：从Dock窗口集成到功能菜单实现

一、项目背景与技术选型

在上篇文章实现"选中即问AI"功能的基础上，本文重点解决AI对话窗口的集成与核心功能菜单的开发。通过Notepad++插件体系，我们将实现以下功能矩阵：

• AI交互系统：支持自然语言提问与任务执行
• 代码智能处理：代码解释、优化建议、注释生成
• 配置管理系统：AI平台切换与参数调整
• 即时交互体验：选中内容快速提问机制

在Dock窗口的实现方案选择上，经过对原生开发、第三方库集成和源码剥离三种方案的对比评估，最终采用Notepad++源码裁剪方案。该方案既能保持与宿主程序的UI风格一致性，又可避免引入额外依赖，但需要解决源码依赖链过长的问题。通过裁剪非核心模块（如NppDarkMode）和重构关键函数，成功实现了轻量化集成，Notepad++文件引用如下：

注：项目已开源、镜像，欢迎使用及指正

---

二、Dock窗口集成关键技术

2.1 源码裁剪与适配

通过提取Notepad++的窗口管理核心模块，保留以下关键文件：

Common.h
Docking.h 						// 停靠窗口基础定义
DockingDlgInterface.h  			// 对话框接口
dpiManagerV2.h 			 		// DPI自适应管理
StaticDialog.h 					// 静态对话框基类
dockingResource.h
dpiManagerV2.cpp
StaticDialog.cpp
NppDarkMode.cpp
NppDarkMode.h
Window.h

对NppDarkMode.cpp进行深度改造，仅保留版本检测功能，移除主题相关实现，最终获得精简的Windows版本检测模块：

#include "NppDarkMode.h"enum class SystemVersion
{Unknown,Windows10,Windows11
};SystemVersion GetWindowsVersion()
{// 使用RtlGetVersion替代已废弃的GetVersionExtypedef NTSTATUS(WINAPI* RtlGetVersionPtr)(PRTL_OSVERSIONINFOW);OSVERSIONINFOW osInfo = { 0 };HMODULE hMod = GetModuleHandleW(L"ntdll.dll");if (hMod){auto RtlGetVersion = reinterpret_cast<RtlGetVersionPtr>(GetProcAddress(hMod, "RtlGetVersion"));if (RtlGetVersion) {osInfo.dwOSVersionInfoSize = sizeof(osInfo);if (RtlGetVersion(&osInfo) == 0){ // STATUS_SUCCESS// Windows 11的版本号为10.0.22000+if (osInfo.dwMajorVersion == 10 &&osInfo.dwMinorVersion == 0){if (osInfo.dwBuildNumber >= 22000){return SystemVersion::Windows11;}else if (osInfo.dwBuildNumber >= 10240){return SystemVersion::Windows10;}}}}}return SystemVersion::Unknown;
}bool NppDarkMode::isWindows10() { return GetWindowsVersion() == SystemVersion::Windows10; }
bool NppDarkMode::isWindows11() { return GetWindowsVersion() == SystemVersion::Windows11; }
void NppDarkMode::setDarkTitleBar(HWND hwnd) {}

2.2 AI窗口类设计

构建AiAssistWnd继承自DockingDlgInterface，实现以下核心功能：

class AiAssistWnd : public DockingDlgInterface {
public:// 构造/析构AiAssistWnd(HINSTANCE hInst, const NppData& nppData);// 窗口生命周期管理virtual void init();virtual INT_PTR run_dlgProc(UINT message, WPARAM wParam, LPARAM lParam);// 业务功能接口void updateModelList(const std::vector<std::wstring>& models);void appendAnswer(const std::wstring& answer);
};

关键技术实现：

1. DPI自适应布局：通过dpiManagerV2实现控件动态缩放
2. 富文本交互：采用Msftedit.dll的RichEdit 4.1控件支持格式文本
3. 线程安全通信：使用SendMessage进行跨线程UI更新

---

三、核心菜单功能实现与关键技术解析

3.1 功能菜单架构设计

// PluginDefinition.h
const int nbFunc = 6;  // 定义6个功能命令// 功能原型声明
void PluginConfig();       // 参数配置
void OpenAiAssistWnd();    // 窗口控制
void ReadCode();           // 代码解读
void OptimizeCode();       // 代码优化
void AddCodeComment();     // 注释生成
void AskBySelectedText();  // 选中提问

关键技术要点：

1. 命令标识体系：nbFunc常量定义菜单项总数，保证命令索引的严格对应
2. 功能隔离设计：每个功能对应独立函数，符合单一职责原则
3. 动态加载机制：通过commandMenuInit实现按需初始化

---

3.2 菜单初始化实现

// PluginDefinition.cpp
//
// Initialization of your plugin commands
// You should fill your plugins commands here
void commandMenuInit()
{//--------------------------------------------////-- STEP 3. CUSTOMIZE YOUR PLUGIN COMMANDS --////--------------------------------------------//// with function :// setCommand(int index,                      // zero based number to indicate the order of command//            TCHAR *commandName,             // the command name that you want to see in plugin menu//            PFUNCPLUGINCMD functionPointer, // the symbol of function (function pointer) associated with this command. The body should be defined below. See Step 4.//            ShortcutKey *shortcut,          // optional. Define a shortcut to trigger this command//            bool check0nInit                // optional. Make this menu item be checked visually//            );// 初始化数据g_pNppImp = new NppImp(g_nppData);// 初始化菜单ShortcutKey* pSck = new ShortcutKey[nbFunc];g_pShortcutKeys = pSck;size_t nCid = 0;setCommand(nCid, L"参数配置", PluginConfig, NULL, false); ++nCid;pSck[nCid] = { false, true, false, 'K' };setCommand(nCid, L"显示窗口", OpenAiAssistWnd, pSck + nCid, false); ++nCid;pSck[nCid] = { false, true, false, 'J' };setCommand(nCid, L"解读代码", ReadCode, pSck + nCid, false); ++nCid;pSck[nCid] = { false, true, false, 'Y' };setCommand(nCid, L"优化代码", OptimizeCode, pSck + nCid, false); ++nCid;pSck[nCid] = { false, true, false, 'Z' };setCommand(nCid, L"代码注释", AddCodeComment, pSck + nCid, false); ++nCid;pSck[nCid] = { false, true, false, 'A' };setCommand(nCid, L"选中即问", AskBySelectedText, pSck + nCid, false); ++nCid;
}

关键技术解析：

1. setCommand参数详解：

   • index：菜单项位置索引（0-based）
   • commandName：菜单显示文本（支持多语言）
   • functionPointer：功能函数地址
   • shortcut：快捷键组合指针
   • check0nInit：初始选中状态

2. 快捷键数据结构：

struct ShortcutKey {bool isCtrl;bool isAlt;bool isShift;UCHAR key;
};

3. 内存管理：使用new动态分配快捷键数组，需在插件卸载时释放

---

3.3 窗口控制实现

// PluginDefinition.cpp
// 打开Ai助手窗口
void OpenAiAssistWnd() {if (!g_pAiWnd) {g_pAiWnd = new AiAssistWnd((HINSTANCE)g_hModule, g_nppData);g_pAiWnd->init();}g_pAiWnd->display(true);  // 显示/激活窗口
}

关键技术要点：

1. 单例模式：通过全局指针g_pAiWnd确保窗口唯一性
2. 资源绑定：
   • g_hModule：插件DLL模块句柄
   • g_nppData：Notepad++核心数据结构
3. 显示控制：display(true)调用API实现窗口显示

---

四、功能扩展与效果展示

4.1 插件菜单效果

4.2 AI交互窗口

---

五、总结说明

当前实现已构建起AI辅助开发的基础框架，后续可通过扩展AI引擎接口、优化交互流程、增强代码理解能力等方向持续演进，最终打造智能化的代码辅助工具。开发者可根据实际需求，参考本文提供的技术路径进行功能扩展和深度定制。