Installation Guide

XWorker 安装教程

从零开始安装并运行 XWorker：下载绿色安装包、配置 Java 环境、启动图形界面 / Web 编辑器 / 示例程序，全程无需复杂配置。

📋 教程目录

  1. 下载 XWorker 绿色安装包
  2. 解压安装
  3. 准备 Java 运行环境
  4. （可选）注册文件关联与环境变量
  5. 启动 XWorker
  6. 验证安装是否成功
  7. 常见问题（FAQ）
1

下载 XWorker 绿色安装包

XWorker 提供 Windows 绿色免安装版，下载后解压即可使用，无需安装程序。推荐下载地址：

XWorker 2.0.4b · Windows 绿色版

免安装、解压即用，包含完整动态模型引擎与模型编辑器。

⬇ 下载 xworker2.0.4b.zip
💡 也可以从 Gitee 源码仓库构建最新版：访问 xworker 与 x-meta（动态模型引擎），获取源码自行编译。
2

解压安装

解压到指定目录

将下载的 xworker2.0.4b.zip 解压到本地磁盘。建议解压到不含中文和空格的路径，例如：

推荐解压位置
# 推荐（示例）
C:\xworker\xworker-2.0.4b\

# 请记录你的解压目录，后续步骤会用到（下文以 C:\xworker\xworker-2.0.4b\ 为例）

解压后的目录结构

解压完成后，你会看到类似下面的结构：

XWorker 绿色版目录结构
xworker-2.0.4b/
├── dml.cmd          # 核心启动脚本（运行模型/编辑器）
├── dml.conf.cmd      # JVM 库路径配置
├── swt.cmd           # 启动 SWT 图形界面（桌面版模型编辑器）
├── web.cmd           # 启动 Web 版模型编辑器
├── example.cmd       # 运行示例程序
├── setupenv.cmd      # （可选）注册 .dml 文件关联与环境变量
├── config/           # 配置目录
├── databases/        # 数据库相关
├── lib/              # 依赖库（Jar 包）
├── lib_rap/          # RAP（远程应用平台）库
├── os/               # 平台相关原生库（win32 等）
├── projects/         # 项目目录（模型工程）
├── webroot/          # Web 静态资源
└── work/             # 运行时工作目录
✨ 绿色版无需运行安装程序，也无需注册表写入，解压即完成"安装"。删除整个目录即可彻底卸载。
3

准备 Java 运行环境

检查本机是否已安装 JDK

XWorker 基于 Java 开发，需要 JDK 8 或更高版本。打开命令提示符（Win + R 输入 cmd），执行：

检查 Java 版本
java -version
echo %JAVA_HOME%

如果能看到版本信息（如 java version "1.8.x" 或更高）且 JAVA_HOME 已设置，可跳过本步骤，直接进入 第四步。

若未安装 JDK

  1. 下载并安装 JDK（推荐 JDK 8 或 JDK 11，可从 Oracle 或 Adoptium / Eclipse Temurin 获取）。
  2. 安装完成后设置环境变量 JAVA_HOME 指向 JDK 安装目录，并将 %JAVA_HOME%\bin 加入 PATH。
设置 JAVA_HOME（示例）
# 控制面板 → 系统 → 高级系统设置 → 环境变量
JAVA_HOME = C:\Program Files\Java\jdk1.8.0_xxx

# 并在 PATH 中追加
%JAVA_HOME%\bin
✨ 绿色版可能自带 JRE：如果解压目录下存在 jre 文件夹，XWorker 的 dml.cmd 会优先使用本地 JRE，此时无需手动安装 JDK。
⚠️ 设置环境变量后需重新打开命令提示符（或重启）才能生效。
4

（可选）注册文件关联与环境变量

XWorker 提供了 setupenv.cmd 脚本，可完成两件事：

  • 注册文件关联：让 .dml / .dmw 模型文件双击即可用 XWorker 打开。
  • 设置环境变量：写入 XMETA_HOME 并加入 PATH，方便在任意目录调用 dml.cmd。
⚠️ 需要管理员权限：请以右键 → 以管理员身份运行 setupenv.cmd，否则会提示 "Access is denied"。
以管理员身份运行 setupenv.cmd
# 在解压目录中找到 setupenv.cmd，右键 → 以管理员身份运行

# 脚本会执行（示例输出）：
echo set file association
assoc .dml=DynamicModel
assoc .dmw=DynamicModelWindow
ftype DynamicModel=C:\xworker\xworker-2.0.4b\dml.cmd %%1 %%*
ftype DynamicModelWindow=C:\xworker\xworker-2.0.4b\dmw.cmd %%1 %%*

echo set XMETA_HOME
SetX  XMETA_HOME C:\xworker\xworker-2.0.4b\ /M
SetX /M PATH "%PATH%;C:\xworker\xworker-2.0.4b\
💡 注意：setupenv.cmd 中的路径默认指向其自身所在目录。若你解压到了其它位置，脚本会自动使用当前目录，一般无需修改；如遇路径不符，可直接手动编辑脚本中的路径。

如果你不需要双击打开 .dml 文件，或不想改动系统环境变量，可以完全跳过本步骤——直接进入下一步启动 XWorker。

5

启动 XWorker

XWorker 提供多种启动方式，按需选择：

🖥️

SWT 桌面版（推荐）

启动桌面图形界面模型编辑器，支持完整的模型树编辑、属性编辑与预览。

swt.cmd 双击 swt.cmd 即可
🌐

Web 编辑器

启动内置 Web 服务器与 Web 版模型编辑器，可通过浏览器访问编辑。

web.cmd 双击 web.cmd，浏览器打开提示的地址
🧪

示例程序

运行 XWorker 自带的示例，快速体验动态模型的运行效果。

example.cmd 双击 example.cmd

通过命令行启动（高级）

所有启动脚本最终都是调用核心脚本 dml.cmd 并传入要运行的模型路径，你也可以在命令提示符中手动执行：

命令行启动方式
# 进入解压目录
cd /d C:\xworker\xworker-2.0.4b

# 启动 SWT 图形界面模型编辑器
dml.cmd xworker.thingeditor.SwtThingEditor run

# 启动 Web 版模型编辑器
dml.cmd xworker.webthingeditor.WebThingEditor run

# 运行示例
dml.cmd xworker.example.ExampleMain run
💡 关于 dml.cmd：它是 XWorker 的通用启动器，格式为 dml.cmd <模型路径> run，可直接运行任意可执行的动态模型。
6

验证安装是否成功

启动成功后，请按以下清单逐项确认：

  • ✓SWT 编辑器窗口正常打开，左侧显示模型树，右侧为属性编辑器。
  • ✓Web 编辑器启动后控制台显示访问地址（如 http://localhost:端口/），浏览器可正常打开。
  • ✓示例程序能正常运行并展示演示界面，说明引擎执行链路正常。
  • ✓控制台无 ClassNotFoundException 或 UnsatisfiedLinkError 等致命错误。

若以上均正常，说明 XWorker 已成功安装并可以开始使用。接下来可以：

  • 在模型编辑器中新建模型，体验动态模型的创建与编辑。
  • 加入官方 QQ 群与其他用户交流。
💬 加入 XWorker 官方 QQ 群

与开发者、模型封装者、AI 研究者一起交流动态模型与 AGI 最新进展。

🐧 312989786
?

常见问题（FAQ）

Q1：双击 swt.cmd 后窗口一闪而过，怎么办？

通常是 JAVA_HOME 未设置或 JDK 未安装。请先按第三步配置 Java 环境，然后在命令提示符中手动执行 swt.cmd 查看具体报错信息。

Q2：提示 "JAVA_HOME is not set. Unexpected results may occur."？

这是提示你未设置 JAVA_HOME。设置后重新打开命令行即可；若解压目录内含 jre，XWorker 会自动使用本地 JRE，可忽略此提示。

Q3：运行 setupenv.cmd 提示 "Access is denied"？

写入环境变量（SetX /M）需要管理员权限。请右键 → 以管理员身份运行。如果不需要文件关联与环境变量，也可以跳过此步骤。

Q4：如何彻底卸载 XWorker？

绿色版无需卸载程序：直接删除解压目录即可。若曾运行过 setupenv.cmd，可手动删除 XMETA_HOME 环境变量与 .dml/.dmw 文件关联。

Q5：XWorker 与 x-meta 是什么关系？

x-meta 是动态模型引擎（核心运行时），xworker 是基于该引擎开发的完整平台（模型库、IDE、Web 组件等）。绿色安装包已包含两者，无需单独安装。