AutoLinker AGENTS.md

项目概要

本项目是一个易语言支持库（插件类型），使用VS2026的VC++开发，最终编译产物为AutoLinker.fne（实际是dll类型），在易语言主进程启动时加载，用于简化、帮助易语言的开发流程，提供AI Agent来自动化完成部分工作。

易语言概述

易语言的代码是加密的单文件格式（.e），难以被外部直接编辑，所以本项目基于易语言IDE中实现代码的读写等逻辑。

在易语言的开发世界里，支持库和模块是扩展功能、提高开发效率的两大核心支柱。虽然它们看起来都能让你少写代码，但底层的“血缘”和用法其实大不相同。

简单来说：支持库是易语言的“骨架和内脏”，而模块是易语言的“工具包”。

1. 支持库 (Support Library) 支持库是易语言最底层的扩展方式。它们通常不是用易语言本身写的，而是由 C++ 等底层语言编写，编译成特定的二进制格式（.fne、.fnr），实际上是一个dll文件，通常如果提供功能的话，会把一份代码编译成动态和静态两个（文件后缀：.fne=动态库（开发调试时使用）。.lib=静态库（编译链接时使用））。它是易语言功能的延伸。比如你想将现有的C++功能库封装给易语言使用、或者给易语言增加特定的图形界面组件（如：超级列表框），这些大多通过支持库实现，调用.fne的GetNewInf()可获取其中公开的信息。

2. 模块 (ECOM) 模块是易语言用户最常接触的东西。它本质上就是已经写好的易语言源代码，打包为的独立文件，文件后缀为.ec，其格式和.e十分类似，甚至有黑科技轻微修改.ec的二进制并更改后缀.e后可以用IDE打开。它是“易语言写的工具箱”，你把常用的函数、类、常量打包在一起，给别人（或者未来的自己）直接调用。

项目规范

• 项目的依赖要精简，基于Win32+MFC实现，避免引入vcpkg包。
• 注重项目的可维护性，对于可独立工作的工具类、管理类，应单独封装。
• 避免单文件代码量过于庞大难以维护。
• 必要时使用mcp来对易语言主EXE进行逆向来实现功能。
• 对.h头文件始终添加简单的中文注释。
• 源代码文件保持UTF8+BOM的格式保存，注意中文是否存在乱码并进行修正。
• 源代码文件使用windows下的换行符（CRLF）。
• 项目使用ISO C++20 标准 (/std:c++20)，可使用其特性开发。
• 如果在修复bug时，觉得代码存在过度设计（反复打补丁修bug，然后又有新bug），应该直接过渡设计的问题并提供在设计层面上的优化方案，而非简单的打上补丁修复bug草草了事

编译

请在完成修改后验证fne_release+x86是否可正常编译，

请参考此命令行方法进行编译，不同设备和VS版本的MSBuild.exe的位置可能不同，请注意寻找及确认。

MSBuild.exe ..\\AutoLinker.vcxproj /t:Build "/p:Configuration=fne_release;Platform=Win32" /m

如果编译存在报错，请进行修正，确保功能实现正常的情况下可正常编译。

测试

常规测试

如果需要测试当前支持库，请先将AutoLinker.fne覆盖至"C:\Users\aiqin\OneDrive\e5.6\lib"（需关闭e主程序才能解除AutoLinker.fne的占用），然后执行并调用：

当前主要开发基于："C:\Users\aiqin\OneDrive\e5.6\e5.95.exe" 如果必要的话，测试此版本兼容："C:\Users\aiqin\OneDrive\e5.6\e571.exe"

打开当前代码目录下的"test_a.e"文件。

AutoLinker.fne会在加载进IDE后开启MCP服务端口19207，测试时如传递中文页名，请注意为UTF8编码。

非依赖易语言IDE的功能测试

fne本质是一个dll文件，不分功能需要载入到IDE中测试，但有一些比如模块本地解析方法等，你可以使用AutoLinkerTest项目来完成测试。