Repository navigation
Releases
Elang-AiTools v1.4.0
无头编译进程隔离:编译进程不再能拖慢你的键盘鼠标
起因:无头编译被强杀或卡住时,e.exe 加载的 IDE 插件(iDraw / CeTools 等)装的全局低级键鼠钩子会让整机键鼠迟钝、嘟嘟响。
这一版:elaunch.py / ecompile.py 默认把 e.exe 关进私有隐藏桌面 + 作业对象。
| 项 | 之前 | v1.4.0 |
|---|---|---|
| 插件的键鼠钩子/窗口/焦点 | 挂在用户桌面 | 只在隐藏桌面里,碰不到用户桌面 |
| 调用方被强杀 | e.exe 可能残留,lib\\elang_addin.fne 残留 |
内核立即收掉 e.exe 及子进程;看守进程补删 fne |
| 资源 | 无上限 | CPU 硬上限 50%(ELANG_AI_CPU_PCT)、单进程 3 GiB / 整体 4 GiB 内存、≤ 32 个进程、BelowNormal |
| 窗口隐藏 | TIME_CRITICAL 线程 + 3 ms 一轮 EnumWindows | 不再需要 |
--isolation {desktop,job,none}:desktop 默认;job(--visible 自动选)窗口显示在用户桌面,插件钩子仍在用户输入链上,只用于排障;none 旧行为。隐藏桌面/作业对象建不起来时自动降级,原因写在结果 JSON 的 isolation.fallbackReason。ecompile.py --doctor 新增隔离能力与残留 fne 检查。
验证(本机,真实易语言 IDE)
tools/selftest-isolation.py6/6:隐藏桌面里的卡死钩子不影响真实桌面输入(SendInput 与基线持平;对照组放到真实桌面则每次 314 ms);强杀后子进程 0.01 s 消失;CPU 25% 上限实测 25.4%;内存上限、UI 限制生效。ecompile --check、真编译(含链接器子进程)、调试运行、--visible均通过,收尾后作业内活动进程为 0。- 编译到第 9 秒强杀 elaunch:1.5 秒内 e.exe 消失,
lib\\elang_addin.fne被看守进程删除。 verify-release.py114 项通过 / 0 失败;selftest-ipc.py70/0。
说明与已知限制
- 更正:旧版文档说「e.exe 在独立桌面 0.04 秒就退出」,复测不成立;也更正了此前对 fne 窗口守护的错误判断(它按 PID 过滤,不会动其他进程的窗口)。
- 作业对象本身管不住钩子,隔开键鼠靠隐藏桌面;
job/none模式不提供这层保护。 - 调用规则:工具调用时限必须大于
--timeout+ 60 秒,否则用后台任务跑ecompile.py(已写入两个技能的 SKILL.md)。 - 本机没有隔离编译时也会出现 300 ms 级的输入停顿簇(背景原因未定位),所以输入延迟按「与同机基线对比」验收,没有使用绝对阈值。
elang_addin.fne未重编:当前 msys2 工具链重编同一份源码得到的哈希与仓库不同,且 desktop 模式不需要改它。- 剪贴板仍与用户共享;CPU 上限对单线程的 e.exe 本体影响很小。
详见 docs/修复-无头编译隔离桌面与作业对象(2026-11-14).md。更新技能:解压 Elang-AiTools.zip 后运行 安装技能.cmd(或 python install-skills.py)。
Elang-AiTools v1.3.9
弹窗决策从「宿主内置规则」升级为「Agent 决策」
v1.3.8 之前 elang_addin.fne 只能单向写事件文件:弹窗 Agent 看不见,只能靠宿主自己猜着点。这次给 fne 加了一条双向命名管道,弹窗在进程内被捕获后直接问 Agent,答不上来再退回宿主安全规则。
| 项 | 之前 | 现在(v1.3.9) |
|---|---|---|
| 弹窗来源 | EnumWindows 全量轮询(2/12ms) |
WinEvent 进程内事件(创建/显示/对话框开始) |
| 决策方 | 宿主内置规则(单按钮 / IDOK / 取消) | Agent 经 IPC 指定点哪个按钮;超时 1500ms 回退内置规则 |
n_enum / 5 分钟会话 |
上万次 | < 2000 |
| 决策往返 p95 | — | < 50ms(同进程实测 ~1ms) |
| 非 AI 模式 | 无影响 | 无影响(未开 AI 模式不建线程、不写文件) |
协议
- 传输:Windows 命名管道(双工、字节流),JSONL 帧;管道名按
{pid}展开,128bit 随机 token 握手。 - 编码:帧内所有文本是 GBK 原始字节的 hex —— 易语言侧全程 GBK,不做 UTF-8 假设。
- 消息:
hello/event/dialog/result/ack/decide/policy/ping/pong。 - 全文:
docs/方案-宿主事件总线与双向IPC协议.md;验收记录:docs/验收报告-宿主事件总线与双向IPC.md。
安全兜底
- 决策超时 / 坏帧 / 断线 → 立刻退回宿主内置安全规则,绝不吊死编译器。
- 保存框(含「另存 / Save As / 覆盖 / 已存在」)与编译保存框不参与 IPC 决策,仍由原填充线程处理。
observe策略下只上报、结果标how=skip,不点任何按钮。- 管道 ACL:受限令牌下自动放宽为
Everyone读写(管道名自带 48bit 随机 tag + pid,且要求 token 握手);ELANG_AI_PIPE_SDDL可强制严格 ACL。
验证
| 测试 | 结果 |
|---|---|
tools/selftest-ipc.py(假 fne ↔ 真 PipeBridge) |
PASS 70 / FAIL 0(0.79s) |
| fne 重编可复现(同源两次构建逐字节一致) | sha256 386ca623…,101888 B |
| 进程内集成(真 fne 逻辑 + 真桥) | 两个弹窗经 IPC 点掉,往返 ~1ms |
| 超时回退 | 2.5s 决策 → 1.5s 超时 → how=fallback,迟到 decide 丢弃 |
已知限制
fill/fillclick(让 Agent 直接填文本框)本次只定义协议,宿主侧未实现,暂回退内置规则。- 只覆盖本进程弹窗;UAC、其他进程的「文件被占用」框不在进程内
WinEvent视野里(WER 异常框已用SetErrorMode抑制)。 - 受限沙箱无法写
D:\ides\e\lib\,真实宿主端到端(ecompile --check全样本)未在本次会话内跑完 —— 复验步骤见验收报告 §复验命令。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装。
要回到旧路径:elaunch.py --no-ipc。
Elang-AiTools v1.3.8
规则⑥ 收窄到隐藏块尾回退场景
按独立验收意见,规则⑥只保留 A、B 都是隐藏块尾(.如果结束 / .如果真结束)且 B 更浅、中间没有 A 同缩进空行的实证场景。这正是 格式化字节数 的 KB/MB 两段。
- 保留:
.如果结束@8 紧贴.如果真结束@4 → 1 条错误;补 8 空格空行后通过。 - 不再判错:
.计次循环尾/.判断循环尾/.循环判断尾→ 更浅隐藏尾。此类有 8 条基线、2 条 demo 和 9 条旧工程命中,但没有逐处 IDE 证据,且技能正文把显式块尾紧贴块尾列为合法写法。 - 多空行:隐藏 A 已有空行时由
check_hidden_tail_gap检查,每一条空行都必须等于 A;无空行由规则⑥补上。 - 编译门禁:未修复
.e走ecompile.py --check返回 3,branchGate.ok=false、2 条错误、无编译器日志;全量修复.e门禁 0 错误通过。
文件级回归
| 样本 | 结果 |
|---|---|
修复前 .e |
2 错误(均在 格式化字节数) |
已修 2 处后的 .e |
0 错误 |
全量修复 .e |
0 错误 |
| 大项目基线 | 规则⑥ 0;流程分支 14 错误;总 180 / 56 |
| demos 01/02 | 规则⑥ 0 |
| 隐藏 A 无空行 / 8 空格空行 / 4 空格空行 | 1 / 0 / 1 |
| 显式循环尾 → 更浅隐藏尾 | 0(不纳入规则⑥) |
稳定验收材料:re/规则⑥验收证据/(含 README、JSON、exit code 与 gate 记录)。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装。
Elang-AiTools v1.3.7
规则⑥:统一多空行缩进口径
- 显式块尾 A 与更浅的隐藏块尾 B 之间若有多条空行,现在要求每一条空行都与 A 同缩进;隐藏 A 仍委托
check_hidden_tail_gap按同一口径检查,消除两套松紧不一致。 - 42 个内存交叉用例(7 种 A 尾 × 2 种 B 隐藏尾 × 无空行/仅 B 缩进/A 缩进)全部符合预期;最新混合空行用例显式 A 与隐藏 A 均拒绝
[8, 4],双空行都为 8 时通过。 - 文件级回归保持:修复前 11 条、已修 2 处后 9 条、全量修复 0 条;未修复
.e走ecompile.py --check仍返回 3、不启动编译器。 - 大项目基线的 8 条同形态命中按规则判错;未逐处做 IDE 截图,这里不宣称每一处都有独立 IDE 证据。全量修复版已全部补 A 缩进空行并 0 命中。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装;elang-build 依赖 elang-ai-coding 的 echeck.py。
Elang-AiTools v1.3.6
新增流程分支门禁:块尾紧贴更浅隐藏块尾
- 新增规则⑥
check_unwind_tail_gap。 当块尾 A(.判断结束/.如果结束/.如果真结束/.计次循环尾/.判断循环尾等)后面紧贴一个更浅的隐藏块尾 B(.如果真结束/.如果结束)时,A、B 之间必须有与 A 同缩进的空行;否则按流程分支错误处理。 - 「格式化字节数」的 KB/MB 两段即此缺陷:
.如果结束(8 空格)紧贴.如果真结束(4 空格),IDE 把外层隐藏块尾的收口挂到内层最后的返回上,红线串到后面。补 8 空格空行后恢复。 - 不解决不允许编译:
ecompile.py编译前强制运行echeck.py --branch-only;规则⑥ 命中即返回 3,不启动易语言编译器。未修复.e实测branchGate.ok=false、11 条错误、无编译器日志;全量修复.e门禁 0 错误通过。 - 规则只按「块尾 + 更浅隐藏块尾 + 空行缩进」判定,不匹配子程序名。反方向「隐藏尾 → 显式尾」紧贴仍按 2026-10-20 的合法嵌套收口放行。
验证
- 修复前工程:规则⑥ 11 处命中(含
格式化字节数2 处)。 - 用户先修 2 处后的工程:规则⑥ 9 处命中。
- 全量修复工程:规则⑥ 0 处;129 处该形态全部带 A 同缩进空行。
- 大项目基线
QAQ-ETool/tests/baseline/大项目测试/en:规则⑥ 8 处(同一工程旧版未修的同类缺陷),流程分支 22 错误(14 条子程序尾 + 8 条规则⑥),总错误 188 / 总警告 56。 - 最小样本:坏样本 1 错误 / 好样本 0;反向「隐藏尾 → 显式尾」合法样本 0。
pack-skill.py四个技能包全部通过 Agent Skills 规范校验。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装;elang-build 依赖 elang-ai-coding 的 echeck.py。
Elang-AiTools v1.3.5
最高优先级变更:流程分支错误级硬门禁
echeck.py不再产生流程分支警告。check_blocks/check_hidden_tail_gap/check_sub_tail_gap/check_empty_branch_gap/check_if_needs_else/check_loop_head_args六类流程分支检查现在全部只进errors;显式块尾、子程序中段缺同缩进空行等原来的 warning 档全部升为 error。- 输出行改为
流程分支: ✓ 0 错误/✗ 错误 N,不再出现「流程分支警告」;--branch-only只跑这组门禁,退出码只由流程分支决定。 ecompile.py编译前无条件跑echeck.py --branch-only。 任何流程分支错误立即返回 3,不启动易语言编译器,没有旁路开关;echeck.py缺失也 fail closed。输入是.e时先用 QAQ-ETool 拆包,拆包不完整同样拒绝编译。- 旧产物保护:门禁失败时不再先删除已有的输出文件。
验证
- 大项目基线
QAQ-ETool/tests/baseline/大项目测试/en:branch: 14 errors / 0 warnings(旧口径为 0 errors / 14 warnings);全量检查总错误 180、非流程警告 56。 - 正反样本:缺尾空行 /
.如果缺.否则/ 中段标记缩进错 → 均 exit 1、0 warnings;补齐后 exit 0。 ecompile.py门禁实测:坏样本branchGate.ok=false、exit 3,编译器未启动。pack-skill.py四个技能包全部通过 Agent Skills 规范校验。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装;elang-build 现在运行期依赖 elang-ai-coding 的 echeck.py。
Elang-AiTools v1.3.4
修复
- 新建按钮事件无效的根因修复:易模块记录段声明的模块方法数与实际方法表不一致时,后续模块窗口会错位并吞掉方法表末尾的新按钮方法。新增
EModFix:check:逐模块核对DefinedIds声明与实际实体数量,列出缺失 Id 和被累计窗口错吞的主工程方法;restore:从完整供体恢复缺失的模块方法,恢复所属程序集ClassInfo.Methods,并同步0x0D007319的FileNames并行数组。
- 修复了 yyJson 模块缺失 10 个方法导致的按钮事件问题;补回后,方法表末尾的 IDE 新建按钮事件实测正常。
- 移除了不正确的“搬方法表/压低 Mem/重建单个 handler”修复思路,相关旧脚本不再随包分发。
验证
EModFix check:完整源码无缺口,退出码 0。- 用补回模块方法的源码编译运行,按钮 1/2/3/4 全部能弹出事件消息框。
- 修复前后程序段和
0x0D007319按预期变化,其他段保持不变。 - Release 包内包含
EModFix的源码、bin运行文件和lib/EProjectFile.dll。
安装
解压 Elang-AiTools.zip,运行 安装技能.cmd(或 install-skills.py)。四个技能需成套安装。
- 包:
Elang-AiTools.zip
Elang-AiTools v1.3.3
修复
- elang-ai-coding / echeck.py:流程分支升级为硬门禁。 输出里的「流程分支」行现在必须 0 错误 0 警告,任一非零即退出码 1(旧行为只是警告,
✓ 通过照跑——「报了,但没拦住」)。新增:子程序最后一行是隐藏块尾(.如果真结束/.如果结束)时,其后必须留一条同缩进的空行;漏了 IDE 会弹「控制块有格式错误」并把流程线拉到窗口底,而这是纯渲染层缺陷,编译照样通过,四个现有工具全看不见。空分支「.否则 / .默认」缺占位空行、隐藏块尾紧贴中段标记,一并判 error。 - 删除规则①(相邻块尾紧贴):真实语料 0 命中,只在本项目两个已用 IDE 剪贴板逐行验证过的样例上误报;删除后 A/B 对照样例回到 0 错误 0 警告。
- 技能描述瘦身:
elang-ai-coding的 frontmatterdescription由 1105 字符压到 953(Agent Skills 规范上限 1024),门禁正文保留在SKILL.md首节,触发词不受影响。 使用说明.md增补交付门禁小节:通过/不通过的样子、以及为什么echeck之外的工具都看不出这类缺陷。
验证
- 门禁矩阵实跑:修好的样例
✓ 0 错误 0 警告退出 0;未修的样例✗退出 1,错误与警告两种形态都覆盖。 tools/verify-release.py:105 项通过,0 项失败(发布区与全部本机安装点逐文件 md5 一致,技能包纯净度、规范符合性、安装器、dist 全部通过)。- 整包回验:38 个文件逐个解压比对 md5 全等;
Elang-AiTools.zip= 30,443,577 B,sha2563f4d632a06e819963bbff264b6d7de8f8edcd00b208fb0fe1b8ba2d501c68999。
安装
下载 Elang-AiTools.zip 解包,运行 安装技能.cmd(或 install-skills.py),也可用 skills-manager 从解包目录安装。四个技能需成套安装(elang-build 运行期依赖 elang-debug 与 qaq-etool-cli)。
Elang-AiTools v1.3.2
修复
- elang-build / ecompile.py:无头编译不再弹出易语言窗口。 此前
ecompile.py从不传--headless,落到elaunch的编译默认off⇒ IDE 窗口全程可见(能看到它自动编译、自动填写编译输出路径、再自动关窗)。现默认显式--headless hide(隐藏 + 移出屏幕,无任务栏、无 Alt+Tab);排障要看界面时用--visible或--headless park。 - elang-build / ecompile.py:收尾 NameError 修复。
finally里引用了未初始化的变量,任何一次调用(含成功)都会在收尾抛异常并吞掉 JSON 结果。 - elang-build:新增版本资源门禁与补写。 免打包(易包)工程走无头静态编译时一律不写 RT_VERSION,产物的「软件信息」全空——旧判据(产物存在 + 大小 + mtime)看不见这个问题。现在可
--require-versioninfo/--expect-version 3.1.3做门禁,--stamp-version-info用 Windows 官方资源 API 补写,并要求写完pever.py复查。 - 新增脚本:
scripts/pever.py(零依赖解析/校验 PE 版本资源)、scripts/versionize.py(走BeginUpdateResource/UpdateResource写标准版本资源,产物是正常 PE,不是打补丁)。 - elang-build SKILL.md 新增 §2.2:「软件信息全空」的根因与排除项表。
- 工程侧配套:
tools/sync-release.sh与tools/verify-release.py的 elang-build 脚本名单补上这两个新脚本,同步与总检不再漏项。
验证
- 端到端实跑(官方样例工程 → 无头静态编译):
ok=true/eExitCode=0,产物正常生成,全程 0 个可见 IDE 窗口、0 个弹窗,投放的.fne收尾自动清理。 tools/verify-release.py:113 项通过,0 项失败(含发布区与 10 个本机安装点逐文件 md5 一致)。
安装
下载 Elang-AiTools.zip,运行 安装技能.cmd / install-skills.py,或用 skills-manager 从解包目录安装。四个技能需成套安装(elang-build 运行期依赖 elang-debug 与 qaq-etool-cli)。
Elang-AiTools v1.3.1
修复
- elang-build / ecompile.py:
--check编译即检查收尾时清理用于填充保存框的占位产物,失败现场不再残留无意义可执行文件。 - elang-build SKILL.md:新增「临时文件与工作区边界(强制)」——禁止在用户源码目录创建
.tmp/、tmp/等工作目录,中间文件统一走系统临时目录或ecompile_<随机>工作目录。 - elang-ai-coding SKILL.md:新增「临时目录边界(强制)」,任务结束前必须清点并删除本次创建的临时目录与中间文件。
- 安装器(安装技能.cmd / install-skills.py):检测到本机装有 Skills Manager 时,先询问是否直接安装到公共技能库(一份入库、各工具共享,无需挨个装到每个工具目录);可
--sm no跳过。同时修复本地目录安装必须显式--local(Windows 盘符路径会被 CLI 判为歧义 ref)的问题。
背景
会话排查确认:源码工程里残留的 .tmp 目录来自代理侧临时工作区,不是 elang_addin.fne 运行时产物;本次从工具链收尾与技能提示词两层同时加固。
安装
下载 Elang-AiTools.zip,运行 安装技能.cmd / install-skills.py,或用 skills-manager 从解包目录安装。