快速开始

下载 Release 后，将 AutoLinker.fne 放入易语言 lib 目录并启用该支持库。

🔧 AI / MCP 功能配置指南（API Key、中转站、各平台配置） 📊 选择模型前，可查看易语言大模型基准评分，对比真实回包与无头编译成绩。

⭐ 调试 / 编译时动静态 ec 模块自动切换

为同一模块准备一对 ec 文件（动态版 / 静态版），AutoLinker 会在开始调试和开始编译时自动替换工程中已导入的对应模块。典型场景如 VMP SDK、ExDui：编译需 Lib 声明的静态版，调试只能用 Dll 声明的动态版。

在 IDE「工具」菜单打开 AutoLinker EC 模块自动切换设置 维护规则。注意：需先自行引用动/静任一 ec，且成对的两个 ec 必须放在同一文件夹中（替换时只改文件名）。

⭐ 项目级按配置编译

在“工具菜单 → AutoLinker 设置 → 编译配置”中为当前 .e/.ec 工程维护多套输出配置，支持 auto、窗口 EXE、控制台 EXE、DLL、易模块目标、静态编译，以及编译前/后 PowerShell 动作。 保存后从“主菜单 → 编译 → 按配置编译”选择配置；任务会生成当前 IDE 工程快照，在独立隐藏的 e.exe 实例中异步执行。配置保存在源文件旁的 <文件名>.autolinker.json，详细字段和变量见 docs/project-build-menu-integration.md。

⭐ 无头命令行编译

推荐用 AutoLinkerTest headless-compile 启动 e.exe：自动关闭启动期弹窗、隐藏 IDE、调用 compile_with_output_path，并把结果 JSON 输出到控制台。该启动器支持多个进程同时调用：同一 .e 工程按调用顺序排队，不同工程可并行编译；输出路径仍应由调用方自行保持唯一。

.\bin\fne_release\AutoLinkerTest.exe headless-compile `
  "C:\path\to\e571.exe" "D:\demo\demo.e" "D:\demo\build\demo.exe" `
  --target auto --static --result "D:\demo\build\compile-result.json" --timeout 120

target 支持 auto、win_exe、win_console_exe、win_dll、ecom；--static 仅适用于 EXE/DLL。省略 --result 时，每次调用生成独立的 <输出文件>.headless.<invocation-id>.json，并原子更新兼容文件 <输出文件>.headless.json。{易语言目录}\AutoLinker\Log\headless_compile_last.json 也是原子更新的“最近一次结果”，并发调用方不应依赖它区分各自结果。显式传入 --result 时，并发调用方应分别使用不同路径。

也可直接启动主程序（仅负责无头编译，早期弹窗和同一工程的并发启动协调仍建议用启动器）：

"C:\path\to\e571.exe" "D:\demo\demo.e" `
  --autolinker-headless-compile `
  --autolinker-output "D:\demo\build\demo.exe" `
  --autolinker-target auto `
  --autolinker-result "D:\demo\build\compile-result.json" `
  --autolinker-invocation-id "compile-001"

⭐ 不同 .e 源文件使用不同链接器

再也不用手动来回切换链接器。在【工具菜单 → AutoLinker 设置 → 链接器】中添加多组 link.ini 配置，并在【主菜单 → 编译】下切换当前源文件所用的链接器。

客户端配置示例

Claude Code — ~/.claude.json；Gemini CLI — ~/.gemini/settings.json

{
  "mcpServers": {
    "AutoLinker": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:19207/mcp"
    }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.AutoLinker]
url = "http://127.0.0.1:19207/mcp"

Cursor / Windsurf / IDE — MCP 设置页添加：Name AutoLinker，Type http / streamable_http，URL http://127.0.0.1:19207/mcp。

工程源码读写模型

• 内置 AI 每轮请求前以 full 模式自动准备镜像；外部 MCP 会话首次读写前须调用 refresh_workspace_mirror。镜像由 e-packager 解包到 %TEMP%/AutoLinker/workspace-mirror/（含未保存改动），不污染源码目录。mode 支持 auto / main_only / full。
• 仅当用户明确要求解析、查看、参考或复刻外部 .e / .ec 文件时，才调用 e_packager，且当前 MCP 会话必须先成功调用 refresh_workspace_mirror。参数为必填的 file_path（绝对路径，或相对当前工程目录的路径；只接受已存在的普通 .e / .ec 文件），会将文件解包到当前镜像的只读目录 unimported_code/{文件名}/；使用 list_files / search_code 定位文件，再用 read_file / read_files 读取，不对未引用源码使用 read_code_item，也不得使用写工具修改。同名目录仅在解包成功后替换；成功返回 operation="unpack"、output_directory、file_count、新的 mirror_generation 和 read_hint。解包会改变镜像代次，分页读取须从第一页重新开始。
• 读取统一走镜像相对路径（list_files、search_code、read_file、read_files、read_code_item）；大文件返回 next_source_byte_offset 用于续读。续页建议原样回传上一页的非零 mirror_generation；漏传时自动绑定当前镜像代次，显式传入的旧代次游标仍会被拒绝。
• 编辑前用 read_real_file 取分页视图和 code_hash 作为 CAS 基线。写工具（edit_file、multi_edit_file、write_file 等）以 file_path 为目标，映射回 IDE 程序项后直接写回 IDE，不回包编译。
• 写入须带 SHA-256 expected_base_hash（恢复用 expected_current_hash）防止旧基线覆盖新改动；结果仅返回哈希、快照、验证与变更统计，完整结果在 structuredContent。
• src/*.xml 为易语言原生窗口界面文件，仅供读取搜索。当前工具不支持调整窗口或控件的位置、大小、层级和属性，不支持添加、删除控件，也不支持新增、删除或修改控件事件绑定。对应 src/*.txt 中的窗口程序集代码和已有事件处理代码仍可编辑，但新增事件子程序不代表已经建立控件事件绑定。固定表（常量、全局变量、DLL 声明、数据类型）可经对应路径编辑，程序集变量写回会按 IDE 可接受格式处理。
• 同时打开多个 IDE 时，先调用 list_instances 查看目标工程，再用 select_instance 选择实例；选择按 Mcp-Session-Id 隔离，实例退出后不会静默切换。