Menú
维护、开发、扩展、调试与打包测试 EAiCoding 易语言 MCP 服务（eaicoding-mcp.exe）。当需要修改 JSON-RPC 协议、增加新的 MCP Tools、调试易语言文本工程解析与回编机制时，激活此 Skill。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | eaicoding-mcp-development |
| description | 维护、开发、扩展、调试与打包测试 EAiCoding 易语言 MCP 服务（eaicoding-mcp.exe）。当需要修改 JSON-RPC 协议、增加新的 MCP Tools、调试易语言文本工程解析与回编机制时，激活此 Skill。 |
本 Skill 指导 AI 开发助手如何正确维护、扩展和调试 eaicoding-mcp Rust MCP 服务。服务目前已完全重构为标准的 SSE (Server-Sent Events) HTTP 协议规范，便于进行本地或跨电脑远程/局域网调用。
789/ <- 项目根目录
├── src/
│ ├── main.rs <- MCP 入口：HTTP SSE 服务路由 + Tool Schema + 异步派发
│ ├── lib.rs <- 模块声明（pub mod 列表）
│ ├── eagent_tools.rs <- 工具链路径检测 + 自动安装逻辑
│ ├── ecode_parser.rs <- .e/.ec 解析、export_ecode、generate_efile、compile_efile
│ ├── easy_language_sdk.rs <- 易语言安装目录扫描（scan_env）
│ ├── jingyi_search.rs <- 精易模块 API 语义检索
│ ├── local_files.rs <- GBK<->UTF-8 文件读写（read/write_ecode_file）
│ ├── patch.rs <- Search-Replace 差分修补（patch_file）
│ └── analyze.rs <- 静态诊断分析（analyze_project）
├── resources/
│ └── eagent-tools/ <- 本地工具链（EBuild/e2txt/ecl/eparser32/ECodeParser/templates）
├── data/
│ └── jingyi-raw.json <- 精易模块 API 原始数据（jingyi_search.rs 的数据源）
├── docs/ <- 项目文档
├── .agents/
│ ├── mcp_config.json <- MCP 客户端 SSE 连接配置
│ └── skills/eaicoding_mcp_development/SKILL.md
├── Cargo.toml <- 项目版本、依赖管理
├── build.rs <- 空占位构建脚本
└── package.ps1 <- 一键编译+打包+SHA256 校验脚本
GET /sse 以维持 Event-Stream。服务端必须在连接建立后，向流中立刻写入第一个 endpoint 事件，通知用于交互的 POST 地址：
event: endpoint
data: /message?connectionId=conn_xxx\n\n
POST /message?connectionId=conn_xxx。服务端处理该 POST 请求应立即响应 202 Accepted，并在后台使用 tokio::spawn 异步并发运行 Tool，执行结束后将 JSON-RPC 响应结果通过先前和该 connectionId 绑定的 SSE 长连接推送回客户端。Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type, X-File-Name
易语言源码（.e.txt）在本地以 GBK 编码保存，LLM 与 JSON-RPC 只支持 UTF-8。
read_text_file_for_agent（local_files.rs）自动探测编码，GBK 自动转 UTF-8 后返回。write_text_file（local_files.rs），第三个参数传 Some("gbk".to_string())，自动将 UTF-8 转 GBK 写入。易语言编译器（e.exe/ecl.exe）强依赖 Windows CRLF（\r\n）。写入源码文件时必须调用 normalize_line_endings_for_path 统一为 \r\n。
新增工具必须同步修改以下三处：
在 src/main.rs 的 get_mcp_tools_schema() 末尾追加：
{
"name": "your_tool_name",
"description": "清晰描述工具用途，大模型依此进行语义路由",
"inputSchema": {
"type": "object",
"properties": {
"param_1": { "type": "string", "description": "参数说明" }
},
"required": ["param_1"]
}
}
在 src/main.rs 的 execute_tool() match 中添加：
"your_tool_name" => {
let param_1 = args.get("param_1")
.and_then(|v| v.as_str())
.ok_or_else(|| "参数缺失: param_1".to_string())?;
let result = your_module::your_function(param_1.to_string()).await?;
Ok(result)
}
在 src/ 对应 .rs 中编写逻辑，注意：
eprintln! 输出至终端。src/lib.rs 声明 pub mod。# 编译
cargo build
本指南详述如何使用 eaicoding-mcp 对易语言二进制程序（如 .e / .ec 文件）进行高速度、高强度的逆向解构、静态安全审查、功能结构拆解，以及生成用于跨语言复刻（Python/Go/Rust等）的保真设计蓝图。
在处理大型易语言程序（例如总子程序数 >3000）时，反编译导出为文本工程的 IO 开销与分析开销会显著增长。必须落实以下提速规范：
导出增量缓存检查 (Cache Check)
.e 反编译导出文本工程（export_ecode）耗时通常达 5s-15s。若二进制文件未发生修改，应直接复用已有的导出代码。.e 文件的修改时间（mtime）或 SHA256 哈希值与 ecode_output/<项目名>/ 目录的生成记录。若匹配则自动跳过反编译步骤，直接进入静态分析，从而让暖启动分析耗时降至 1s 以内。全量源码并行检索 (Parallel Scan)
.e.txt 模块。单线程串行读取匹配性能瓶颈明显。代码/*.e.txt 全量文本的特征正则挖掘（如 URL 过滤、敏感词搜索）时，使用多线程（如 concurrent.futures.ThreadPoolExecutor）进行并发文件读取与正则匹配，以压榨 CPU 多核性能。暖机连接与状态持久化
eaicoding-mcp.exe SSE HTTP 服务，避免每次分析都重新拉起新进程。在调用 MCP 前，通过检测 8765 端口的响应状态（发送轻量请求如 inspect_env）进行健康检查。易语言工程在编码、表单配置导出过程中存在诸多与现代工具链不兼容的异构设计，需要执行以下稳定性加固策略：
UTF-8 BOM (utf-8-sig) 严格兼容
窗口/*.form.json 带有 UTF-8 字节顺序标记 (BOM, 字节头为 \xef\xbb\xbf)。若在 Python 中直接使用普通 open(..., encoding='utf-8') 并调用 json.load()，会直接触发 JSONDecodeError 崩溃。encoding='utf-8-sig'。GBK 宽松转码安全网 (Transcoding Fallback)
UnicodeDecodeError 导致分析中断。open(file, 'r', encoding='utf-8', errors='ignore') 或 errors='replace'。Windows 路径深度转义与命令行沙箱绕过
\。在命令行中拼装 JSON 参数并调用 CLI 时，极易因未正确转义（如 \u 误认为 unicode 字符，或空格路径截断）引发解析失败。\ 统一替换为 /，或者在拼接 JSON 前使用 json.dumps() 自动对路径进行标准 JSON 转义。为确保生成的 analysis_report.md 具有极高的迁移实用性，报告必须能够自底向上还原整个程序的物理世界模型：
界面交互与核心事件关联树 (UI & Event Correlation)
*.form.json 中完整遍历并列出关键的控件（按钮 按钮、表格 超级列表框/高级表格、输入框 编辑框、单选/复选框、选择夹 选择夹 等）的名称、类型与在表单中的几何定位。*.form.e.txt，匹配如 _按钮_登录_被单击、_高级表格_数据被改变 等事件处理子程序。将控件的物理展示与它对应的业务入口代码紧密关联，构建 UI 动作驱动逻辑图谱。程序全局状态机与配置流审计 (Global State & Config)
全局变量.e.txt，重点挖掘存储 Session、Token、当前用户、运行状态（如 运行线程数、是否停止、打标列表）的全局标识。读配置项 与 写配置项 命令，提取对应的配置文件路径（通常是 .ini 格式）、小节名 (Section, 如 users)、键名 (Key, 如 login_password) 以及缺省参数。在新项目中以此重新构建健壮的配置管理类。多线程并发安全与许可证追踪 (Concurrency & Mutex Locks)
启动线程 命令，找出传入的子程序指针（线程执行体）和传递的参数。创建进入许可证、进入许可、退出许可、删除进入许可证 的使用逻辑。分析程序在访问共享资源（如全局列表、多线程写日志）时所采用的加锁范围与锁变量，并映射为异构语言的同步设计。本地持久化与数据库模型扫描 (SQLite & Db Schema)
打开数据库、打开 操作。执行SQL 等指令，查找嵌入其中的 CREATE TABLE、INSERT、SELECT 等 SQL 模板，准确还原本地 SQLite3 的表结构、索引与字段定义。嵌入式 JS 加密与外挂计算引擎 (Embedded JS/Signature Logic)
#常量_sign_js）。类_脚本组件 / 类_V8 或 执行脚本 的核心逻辑，指出 JS 引擎加载的文本常量名称，并还原传参方式（如 V8.运行 ("getSign", param)）。在复刻与迁移易语言工程时，建议对照以下核心功能的技术栈映射清单进行异构语言重构：
| 功能模块 | 易语言原版命令 / 常用模块 | Python 迁移推荐 | Go 迁移推荐 | Rust 迁移推荐 |
|---|---|---|---|---|
| GUI 窗口界面 | Windows 窗口、精易皮肤模块 | PyQt6 / PySide6 (支持 QML/动态交互); 网页端 React / Vue | Fyne / walk (Windows 原生); 网页端前后端分离 | Tauri (Web 技术栈界面); slint / egui (轻量原生) |
| HTTP 请求 | 网页_访问_对象、网页_访问 (精易模块/WinHttp) | httpx.Client() (支持异步异步调用); requests.Session() | go-resty/resty (链式调用); 原生 net/http | reqwest::Client (强大的异步底层 HTTP 客户端) |
| 并发与多线程 | 启动线程、精易线程池 | threading.Thread、concurrent.futures.ThreadPoolExecutor | go func() (协程机制，比线程轻量数倍) | tokio::spawn (异步 Runtime 执行体) |
| 线程锁 / 许可证 | 创建进入许可证、进入许可、退出许可 | threading.Lock / asyncio.Lock | sync.Mutex / sync.RWMutex | std::sync::Mutex / tokio::sync::Mutex |
| INI 配置读写 | 读配置项、写配置项 | configparser 库 | go-ini/ini 库 | rust-ini / toml 库 (推荐升级为更安全的 TOML) |
| 本地 SQLite 库 | Sqlite数据库 类、Sqlite表 类 | sqlite3 内置模块 | modernc.org/sqlite (纯 Go 实现); github.com/mattn/go-sqlite3 | rusqlite (同步); sqlx (异步生态) |
| 嵌入式 JS 计算 | 类_脚本组件、类_V8 (精易模块) | quickjs (极速轻量); PyExecJS | quickjs-go (绑定原生 QuickJS); robertkrimen/otto (纯 Go) | quickjs / deno_core (集成 V8 引擎) |
| 编码与字符串 | GBK 字符集、编码_Utf8到Ansi、文本_取出中间文本 | 默认 UTF-8 生态; 用正则或 str.split 替代“取中间” | 默认 UTF-8 生态; 用正则或内置 string 切片处理 | 默认 UTF-8 生态; 使用 regex 包或模式匹配安全切割 |
[!IMPORTANT] 所有的逆向审计报告、迁移设计书、架构拆解蓝图等，必须统一输出并保存至项目根目录下的
docs/目录中（例如docs/analysis_report.md，或者以项目命名的docs/<项目名>_analysis.md），严禁散落保存在根目录、临时文件夹或桌面等其他非标准位置，以保障项目开发文档的集中管理和团队 Git 版本追踪。
导出的 docs/analysis_report.md 报告应始终包含以下结构，帮助开发人员一目了然地吃透项目结构：
# 易语言程序 `[程序名称]` 逆向解构与跨语言迁移蓝图
## 一、 项目总体架构与规模度量
* 包含项目基本信息：源程序文件数、子程序总数、硬编码 URL 数量、敏感字段变量数量统计。
* 依赖的支持库与外部模块（如 精易模块、SQLite3支持库等）。
## 二、 窗口 UI 控件布局与事件流逆向映射
* 遍历所有的主窗口，以表格/列表输出控件名、类型、物理坐标。
* 明确列出每一个控件与其绑定的事件子程序（如 `_按钮_登录_被单击`），并贴出不超过25行的核心关键中文逻辑（Ansi到Utf8转码呈现）。
## 三、 硬编码 URL 与 API 通讯边界
* 分组呈现每一个 URL 的调用位置（文件名、行号）与发起网络访问时的参数序列化结构（协议头、Body 字段）。
## 四、 全局状态机、持久化配置与本地数据库
* 全局变量清单及其承担的全局状态属性。
* 读写配置项（INI 文件）的 Section、Key 定义以及对应的缺省值表。
* 本地 SQLite 数据表结构还原（表名、字段类型、关联查询逻辑）。
## 五、 并发同步锁与关键安全防护
* 线程创建入口与共享资源保护许可证锁（Mutex）的逻辑分布。
* 安全限制分析（如设定 DEP 保护、窗口防多开等）。
* JS 算法解密常量还原（说明加密 JS 代码在常量表中的标识与引擎调用点）。
## 六、 异构语言迁移与高保真复刻指南
* 针对该项目的业务特点，详细输出迁移到新语言的模块化解耦建议（例如：如何将易语言中耦合在按钮单击事件中的网络请求与 UI 逻辑剥离开，重构为标准的三层架构/MVC模式）。
* 提供各模块在新语言中的最佳第三方框架组合及核心代码转换逻辑。
## 七、 项目日常维护、版本管理与一键构建指南
* 明确 plain-text 双重追踪规范（ecode 导出目录作为 Git 核心跟踪）。
* 记录“编辑 -> generate_efile -> compile_efile”的一键构建流水线操作。
* 列出外部依赖的 `.ec` 模块以及对应的第三方依赖项。
除了向新语言的迁移外，保留和维护现有易语言项目同样至关重要。必须遵循以下日常维护与自动化构建规范：
二进制与文本的双重版本控制 (Git & Collaboration)
.e 文件无法在 Git 中进行 Diff 或 Merge，团队协作时极易产生代码冲突且无法进行代码评审（Code Review）。export_ecode 将工程导出为 plain-text 文本工程（ecode_output/<项目名>/）并提交至 Git。所有的分支合并、比对与 Code Review 均在 ecode_output 目录下进行。.e 二进制文件可以作为阶段性产物忽略，或仅在发布 Tag 时进行归档。一键式“修改 - 回编 - 编译”闭环 (Continuous Integration / Daily Builds)
.e.txt）使用 patch_file 补丁工具或 write_ecode_file 接口进行快速的局部 Search-Replace 修改，防止因文件过大引发的网络超时。generate_efile，将 ecode_output/<项目名> 目录反向生成为对应的二进制 .e 文件。compile_efile，自动拉起易语言命令行编译器，将生成的 .e 二进制编译为最终的成品 .exe。build.ps1），在开发调试时进行一键回编与测试，确保 plain-text 的任何修改都能正确回编且无编译错误。模块化依赖 (.ec / .fne) 的规范管理
精易模块[v11.1.5].ec）集中存放在项目根目录下的 libs/ 或 modules/ 文件夹中，严禁分散在系统各处。compile_efile 的 module_paths 参数中显式传入这些模块的本地路径，保证编译环境的隔离性与一致性。在通过 MCP 或文本工程格式（ecode）动态生成或重构易语言 GUI （窗口）应用程序时，必须遵循以下硬性规范，否则程序将出现编译失败、闪退或“载入启动窗口失败”等运行时报错。
*.form.json 中遗漏或错误配置了以下字段，程序可以成功编译，但在运行时双击启动会抛出 运行时出错！ 错误信息：载入启动窗口失败 <Id>, 0 的对话框。"Id"（例如 "Id": 1375797249）、"UnknownAfterId"（例如 "UnknownAfterId": 14765456）和 "UnknownBeforeClass"（例如 "UnknownBeforeClass": 1968236）。窗口 Id + 1（如 1375797250）。如果随机或置空这些 ID，编译器将无法建立 UI 与代码的关联。推荐直接复用工作模板或原版导出的 ID 字段。Class 名称由 "启动窗口程序集" 更改为其他名字，或重命名其源文件名，都会导致编译器无法生成启动窗口入口。"Class": "启动窗口程序集"。启动窗口.form.e.txt，且文件内声明 .程序集 启动窗口程序集。排序.list.txt 必须首行指向该文件。ExtensionData 的对齐偏移量与还原ExtensionData 是易语言用于序列化控件高级属性（如标题、字体、颜色）的十六进制数据块。若在此数据块中发生哪怕 1 字节（2 个十六进制字符）的对齐错位，易语言 IDE 打开源码时便会报错 Invalid data in the file!（文件数据损坏）。00000000 结尾。"ExtensionData" 设为 ""（空字符串）。易语言编译器在回编时会自动以默认系统属性补全，从而彻底避开二进制对齐和字节偏移量错位的问题。e2txt / ebuild 工具在将 ecode 文本工程回编为 .e 文件时，要求 支持库.config.json、*.form.json 窗体文件以及所有 .e.txt 源码文件必须以 UTF-8 with BOM 格式保存。若写入时遗漏了 BOM 标识，回编工具可能会将其误判为 ANSI/GBK，进而引发中文字符乱码或 JSON 解析失败。encoding='utf-8-sig'。支持库.config.json 中残留了未使用的第三方库（例如 CnCalendar 或 vclbase），但编译服务器上缺失该支持库的静态链接库（.lib/.obj 位于 static_lib 中），使用 static_link: true 进行编译会报错 静态链接失败 (退出码 -10)。compile_efile 时将 static_link 参数设置为 false（动态独立编译），确保在不依赖静态 .lib 的情况下生成可运行的 EXE 程序。krnln）项目推荐使用 static_link: true，以生成绿色便携的单文件 EXE 软件。在日常开发与持续构建流水线中，通常需要使用 Python 脚本自动化调用 MCP 服务的编译/回编接口，或对导出的控件元数据进行深度诊断。为保证此类脚本编写效率与健壮性，必须执行以下规范：
import os
import json
import urllib.request
import threading
import time
BASE_URL = "http://127.0.0.1:8765"
def listen_sse(event_container, stop_event):
"""后台线程：实时监听并缓存 SSE 推送的消息"""
req = urllib.request.Request(f"{BASE_URL}/sse")
try:
with urllib.request.urlopen(req) as response:
for line in response:
if stop_event.is_set():
break
line = line.decode('utf-8').strip()
if line.startswith("event:"):
current_event = line[6:].strip()
elif line.startswith("data:"):
data = line[5:].strip()
event_container.append((line, data))
except Exception:
pass
def call_mcp_tool(tool_name, arguments, rpc_id, timeout_sec=20):
"""标准 RPC 工具调用封装：自动处理握手、消息推送与响应匹配"""
event_container = []
stop_event = threading.Event()
t = threading.Thread(target=listen_sse, args=(event_container, stop_event))
t.daemon = True
t.start()
# 1. 等待 SSE 流建立并推送 endpoint 路径
post_path = None
for _ in range(30):
for raw, data in list(event_container):
if "endpoint" in raw or "/message" in data:
post_path = data
break
if post_path:
break
time.sleep(0.1)
if not post_path:
stop_event.set()
raise RuntimeError("无法连接至 MCP SSE 终结点")
# 2. 推送 JSON-RPC 请求到 message POST 路由
rpc_req = {
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": tool_name,
"arguments": arguments
},
"id": rpc_id
}
data_bytes = json.dumps(rpc_req).encode('utf-8')
req = urllib.request.Request(f"{BASE_URL}{post_path}", data=data_bytes, headers={'Content-Type': 'application/json'})
urllib.request.urlopen(req)
# 3. 阻塞等待并匹配对应的响应 ID
response_data = None
start_time = time.time()
while time.time() - start_time < timeout_sec:
for event, data in list(event_container):
try:
parsed = json.loads(data)
if parsed.get("id") == rpc_id:
response_data = parsed
break
except Exception:
pass
if response_data:
break
time.sleep(0.1)
stop_event.set()
if not response_data:
raise TimeoutError(f"等待工具 [{tool_name}] 响应超时")
return response_data
ExtensionData 的十六进制对比与调试规范ExtensionData 的特定区段进行提取和十六进制值对比。# 提取某十六进制字段的前缀、长度、内容和后缀，进行 GBK 解码测试
def inspect_extension_data(hex_str, prefix_len_bytes):
prefix_len_chars = prefix_len_bytes * 2
prefix = hex_str[:prefix_len_chars]
length_hex = hex_str[prefix_len_chars:prefix_len_chars + 8]
# 易语言采用 32 位小端整型保存文本长度
# 例如 "06000000" 代表长度为 6 字节 (3个汉字)
length_val = int.from_bytes(bytes.fromhex(length_hex), byteorder='little')
content_hex = hex_str[prefix_len_chars + 8 : prefix_len_chars + 8 + (length_val * 2)]
suffix = hex_str[prefix_len_chars + 8 + (length_val * 2):]
decoded_text = bytes.fromhex(content_hex).decode('gbk', errors='replace')
print("--- 元数据分析 ---")
print(f"前缀: {prefix}")
print(f"长度值: {length_val} 字节 (Hex: {length_hex})")
print(f"内容文本: {decoded_text}")
print(f"后缀: {suffix}")
.e 及 .exe 后，若立刻调用系统级强力清除（如 rmtree）可能会导致后续依赖这些中间产物的分析程序崩溃。temp_project（当前构建目录）直到编译程序 ecl.exe 彻底退出并生成目标文件。verify_form_content.py 的后置检验函数，对生成好的 _启动窗口.form.json 等文本资产做一致性断言，并在主构建任务全部完成后再清理临时目录。