e-packager

KO | EN

gitlite — search

#javascript #ai #typescript #go #android #machine-learning #deep-learning #docker #nodejs #awesome #awesome-list #security #ios #openai

(★ 55)

实验项目，将易语言 .e 工程文件解包为可读目录，或将目录回包为 .e 文件。让易语言项目享有 Git 版本管理、代码 Diff、AI 辅助编辑等现代开发体验。

e-packager 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# e-packager

将易语言 `.e` / `.ec` 文件解包为可读目录，或将目录回包为 `.e`，让易语言项目享有 Git 版本管理、代码 Diff、AI 辅助编辑等现代开发体验。

> 📖 参考应用：[易语言 × AI Agent 实践白皮书](https://github.com/aiqinxuancai/Awesome-E-Agent)
> 
> 📖 [易语言AutoLinker支持库，提供**无头编译**，用于AI使用本项目编辑代码后的验证编译](https://github.com/aiqinxuancai/AutoLinker)

## 使用

### 解包

```
e-packager unpack <input.e|input.ec> <output-dir>
```

只需要解包主 `.e` / `.ec` 文件，不刷新依赖易模块工作区和支持库公开接口时，可传入 `--main-only`：

```
e-packager unpack MyApp.e MyApp\ --main-only
```

如果源文件设置了打开密码，解包时传入 `--password`：

```
e-packager unpack MyApp.e MyApp\ --password 111222333
```

解包加密文件后，后续回包默认输出为未加密 `.e`，不需要再次提供密码；如果希望回包结果继续带打开密码，可在 `pack` 时传入 `--password`。

也可直接将 `.e` / `.ec` 文件拖放到 `e-packager.exe` 上，自动在源文件所在目录创建同名子目录并解包：

```
e-packager MyApp.e    # 解包到 MyApp\
e-packager MyMod.ec   # 解包到 MyMod\
```

### 支持库公开接口导出

Win32 版可直接读取 x86 `.fne` 支持库，并导出与解包 `.e` 时 `elib/*.txt` 一致的公开接口文本：

```
e-packager decrypt-fne MyLib.fne MyLib.txt
```

也可直接将 `.fne` 文件拖放到 `e-packager.exe` 上，默认在同目录生成同名 `.txt`。x64 版不会加载 x86 支持库，此命令会提示需要 Win32 版。

**解包目录结构：**

| 路径 | 内容 |
| --- | --- |
| `src/` | 源码文件（`.txt`）及窗口界面定义（`.xml`） |
| `project/` | 封包所需元数据；`.e` 解包后还可能含原生快照，**请勿删除** |
| `header/` | 仅 `.ec` 项目生成；公开接口头文件，不参与回包 |
| `ecom/` | 仅 `.e` 项目生成；每个子目录为一个已解包的模块工作区，不参与回包 |
| `elib/` | 依赖支持库的公开接口导出，仅供查阅，不参与回包 |
| `image/` | 图片资源及任意二进制资源，元数据在 `image/list.json` |
| `audio/` | 音频资源及任意二进制资源，元数据在 `audio/list.json` |
| `tool/e-packager.exe` | 随目录自带的封包工具 |
| `info.json` | 来源文件的类型、路径、修改时间、MD5 |
| `AGENTS.md` | 供 AI Agent 阅读的项目结构说明 |

若 `.e` 工程引用了易模块（`.ec`），默认解包时会自动将这些模块同步导出到 `ecom/<模块名>/`，并导出支持库公开接口到 `elib/`。`project/.module.json` 中对应依赖项会额外写入 `resolvedPath`（本机模块完整路径）与 `localWorkspace`（本地工作区目录）两个只读辅助字段，不参与回包。使用 `--main-only` 时不会生成、更新或删除 `ecom/` 与 `elib/`，也不会写入这些派生辅助字段。

### 回包

```
e-packager pack <input-dir> <output.e|output.ec> [--password <text>]
```

或在项目根目录（或 `tool/` 子目录）内直接运行，自动输出到 `pack/` 目录：

```
e-packager
```

> `.ec` 工作区回包的实际输出始终为 `.e` 格式；无参默认回包时输出至 `pack/<原文件名>.ec.e`。

需要为回包结果设置打开密码时：

```
e-packager pack MyApp\ MyApp-protected.e --password 111222333
```

### 回包前预检

可以只读取工作区并执行快速预检，不生成 `.e` 文件：

```
e-packager validate <input-dir>
```

`pack` 和无参默认回包会自动执行同一套预检。发现确定性错误时，命令返回失败并且不会写出目标文件；诊断包含源码文件、行号和错误代码。

当前预检覆盖声明槽位及属性、严格数组维数、自定义数据类型数组成员的零维限制、声明顺序与同作用域重复名称、跨页面类型/资源名称冲突、未知点指令、流程块配对、智能引号和括号配对、缺少赋值左值/右值、误用半角赋值符号、只读目标赋值、窗体 XML 及窗口程序集绑定、控件成员和事件处理器存在性，以及可静态确定的符号、成员、调用签名、返回值和表达式类型错误。例如 `整数变量 ＝ “文本”`、`a ＝`、`#常量 ＝ 1`、`.局部变量 a 整数型` 会被阻止。

声明的行尾空槽可以省略，预检不会强制补齐固定字段数；填写后续属性、数组维数或说明时，中间空槽仍须用逗号保留。例如 `.局部变量 arr, 整数型, , "0"` 合法，不能压缩为 `.局部变量 arr, 整数型, "0"`。`"0"` 可用于动态局部变量或全局变量，但自定义数据类型的数组成员不能包含零维。

预检不是完整的易语言编译器。目前仍未完整覆盖类继承及访问权限、普通程序集方法与类实例方法的调用边界、支持库或易模块的重载和特殊命令规则、变体型及泛型类型流、窗口事件参数签名、全部隐式类型转换和特殊表达式。DLL 入口是否存在以及数组越界、空对象、文件或动态资源缺失等运行期问题也不属于源码预检。依赖元数据缺失或语义无法可靠确定时会标记为未知而不是臆测报错。因此 `errors=0` 表示没有发现当前覆盖范围内的确定性错误，不代表最终编译一定成功。

对已修改或新增的可执行语句，回包器还会要求其能够生成原生语义表达式；编码失败会中止回包，不再静默写入未检查的原始代码。未修改语句继续复用原生快照，注释、空行和屏蔽代码仍可保留。需要 IDE 级别结论时，可使用下面的 `--compile-check`。

### 权威无头编译检查

如果本机安装了易语言和 AutoLinker，可以让封包在提交 `.e` 前执行一次真实编译：

```powershell
tool\e-packager.exe pack . .\pack\checked.e `
  --compile-check `
  --eide "C:\path\to\e.exe" `
  --autolinker-test "D:\git\AutoLinker\bin\fne_release\AutoLinkerTest.exe" `
  --compile-static --compile-timeout 120
```

也可以只对已有 `.e` 文件检查，不生成新的 `.e`：

```powershell
e-packager compile-check checked.e `
  --eide "C:\path\to\e.exe" `
  --autolinker-test "D:\git\AutoLinker\bin\fne_release\AutoLinkerTest.exe"
```

`--eide` 可以省略，封包器会从 `E.Document` 注册表打开命令中查找易语言主程序；`--autolinker-test` 可以省略，封包器会依次尝试环境变量 `E_PACKAGER_AUTOLINKER_TEST`、程序同目录和 `PATH`。也可以用 `E_PACKAGER_EIDE` 提供 IDE 路径。编译失败会输出 AutoLinker 的 IDE 页面、行号和输出窗口内容，并且不会覆盖已有目标文件。`--compile-static` 用于同时验证静态链接；不指定时执行 IDE 的普通编译检查。

这一步依赖当前机器的易语言版本、支持库、易模块和链接器配置，失败时应先修复环境或源码，再交付 `.e`。

### 刷新派生内容

解包后，若依赖的易模块或支持库发生变化，或需要新增图片、音频等二进制资源，可用 `update` 命令刷新 `ecom/` 与 `elib/` 中的派生内容并写入资源索引，无需重新解包整个工程。

```
e-packager update <input-dir>
```

**示例：**

```
# 刷新工作区的所有 ecom/elib 派生内容
e-packager update MyApp\

# 新增一个 .ec 模块到 ecom/，并刷新其导出内容
e-packager update MyApp\ --add-ecom D:\modules\MyLib.ec

# 新增多个 .ec 模块
e-packager update MyApp\ --add-ecom D:\modules\Net.ec --add-ecom D:\modules\UI.ec

# 新增支持库（按文件名 stem，自动在 lib/ 目录中查找 .fne/.fnr/.dll）
# 仅 Win32 版 e-packager 支持此选项
e-packager update MyApp\ --add-elib 互联网支持库

# 也可直接传入 .fne 文件的完整路径
e-packager update MyApp\ --add-elib D:\易语言\lib\互联网支持库.fne

# 同时新增模块与支持库
e-packager update MyApp\ --add-ecom D:\modules\Net.ec --add-elib 互联网支持库

# 新增图片资源，默认使用文件名 stem 作为常量名，代码中写 #logo
e-packager update MyApp\ --add-image D:\res\logo.png

# 新增音频资源，默认使用文件名 stem 作为常量名，代码中写 #notify
e-packager update MyApp\ --add-audio D:\res\notify.wav

# 显式指定资源常量名，代码中写 #启动画面
e-packager update MyApp\ --add-image 启动画面=D:\res\splash.bin
```

`--add-image` 与 `--add-audio` 都写入易语言常量资源表，使用方式与普通常量一致，代码中以 `#资源名` 引用。目录名只是决定资源写入 `image/list.json` 还是 `audio/list.json`，实际内容可以是程序需要携带的任意二进制数据。

### 其他命令

```
# 从 GitHub Release 下载最新 e-packager 并替换当前 exe
e-packager /update

# 查看当前程序版本
e-packager version

# 导出单个 .fne 支持库公开接口（仅 Win32 版）
e-packager decrypt-fne <input.fne> [output.txt]

# 快速检查目录工程，不生成 .e
e-packager validate <input-dir>

# 比较原文件与目录内容是否一致
e-packager compare-bundle <input.e|input.ec> <input-dir> [--password <text>]

# 解包后立即回包（快速验证）
e-packager roundtrip <input.e|input.ec> <work-dir> <output.e|output.ec> [--password <text>]

# 往返并校验字节一致性
e-packager verify-roundtrip <input.e|input.ec> <work-dir> <output.e|output.ec> [--password <text>]
```

`/update` 会启动后台替换脚本：先查询 `aiqinxuancai/e-packager` 的最新 GitHub Release，下载匹配的 Win32 二进制压缩包，等待当前进程退出后替换当前 `e-packager.exe`。当前 GitHub Actions 不上传 x64 包，因此 x64 构建会跳过自更新。若需要在本地开发版或同版本上强制覆盖，可使用 `e-packager /update --force`。

## 注意

**使用前请备份源文件**，作者不对可能的数据损失负任何责任。遇到无法解包或回包的文件，欢迎提交 Issue 并附上文件。

## 致谢

- [OpenEpl/TextECode](https://github.com/OpenEpl/TextECode) — 易语言工程文件与文本代码互转
- [OpenEpl/EProjectFile](https://github.com/OpenEpl/EProjectFile) — 易语言项目文件读写库

e-packager

e-packager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

e-packager

e-packager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README