官方开发工具包

下载后，让 AI 在本地创建、检查和打包插件。离线开发无需框架源码、Host、管理令牌或游戏连接。

下载

开发工具包 1.1.0 · Python 与 Go SDK · 五平台检查器

按开发机器选择压缩包；每个平台的 tar.gz 与 ZIP 内容相同。

系统与架构	下载
Linux x86-64	tar.gz · ZIP
Linux ARM64	tar.gz · ZIP
Windows x86-64	ZIP · tar.gz
macOS Apple Silicon	tar.gz · ZIP
macOS Intel	tar.gz · ZIP

校验摘要 · 版本与文件信息。

Python CLI 需要 Python 3.10+；开发 Go 插件另需 Go 工具链，见 Go Worker 教程。macOS 程序未签名、未公证，按系统提示审阅可信来源，不需要全局关闭 Gatekeeper。平台安装条件见自行部署。

历史版本

1.0.0 工具包保留供仍使用该 Host 版本的开发环境下载。它不包含 Scope、RemoteBus 或自动投影恢复；需要这些能力时按升级说明使用 1.1.0 配套版本。

系统与架构	下载
Linux x86-64	tar.gz · ZIP
Linux ARM64	tar.gz · ZIP
Windows x86-64	ZIP · tar.gz
macOS Apple Silicon	tar.gz · ZIP
macOS Intel	tar.gz · ZIP

包含什么

内容	用途
`sdk/python/neomega_runtime`	公开 Python SDK，含类型标注。
`sdk/go`	独立 Go Worker SDK，不依赖私有 Host 源码。
`runtime-plugins.py`	创建模板、离线 lint、确定性打包、制品检查和本机调试控制台。
`neomega-plugin-check`	与 Host 同源的制品校验器，按下载目标提供可执行文件；Windows 为 `neomega-plugin-check.exe`。
`examples/`	basic、event-counter、online-service 模板，以及 native-feedback、typed-radius-observer、Lua、持续任务与对应目标的 Go Worker 示例。
`runtime-admin.py` 及辅助模块	获准后连接本机 Host，检查配置、权限、日志及运行状态。

1.1.0 新增资源会话与远程 EP、投影恢复，支持跨调用占用资源和查询原动作结果。

Python SDK 的类、方法与字段见完整 API 目录，按任务查用法见接口参考。

标题和声音反馈可从 examples/native-feedback 开始；读取生成的协议模型可从 examples/typed-radius-observer 开始。两例的权限、打包步骤和结果处理见 Python 能力开发。

四步生成插件

先解压下载文件并进入工具包目录：

tar -xzf neomega-toolkit-1.1.0-linux-amd64.tar.gz
cd neomega-toolkit-1.1.0-linux-amd64

创建源码。

python3 runtime-plugins.py --directory plugins --id example.hello --template basic new hello

检查源码及静态配置。

python3 runtime-plugins.py lint plugins/hello --json

打包清单中的发布文件。

python3 runtime-plugins.py pack plugins/hello hello.zip

再次检查制品。

python3 runtime-plugins.py check hello.zip

后三条命令成功时输出包含 "ok": true。hello.zip 可交给管理员安装；创建源码和打包都不会启动插件。完整修改示例见第一个插件，聊天计数等需求见按任务开发。

ZIP 解压器可能忽略执行权限。若出现检查器无法运行，在工具包目录执行 chmod +x neomega-plugin-check。系统或架构不匹配时下载表中对应包。Windows PowerShell 使用本机 python 命令，检查器使用 .exe 后缀。

让 AI 正确使用

把 AI 开发入口和解压后的工具包目录交给 AI。要求它先读开发指南，再修改插件代码、同步声明、执行 lint 并检查输出中的 skip，最后打包。

IDE 或外部脚本使用 SDK 时，在工具包目录设置导入路径：

export PYTHONPATH="$PWD/sdk/python"
python3 -c 'from neomega_runtime import Plugin, PluginContext; print("SDK ready")'

插件运行时由 Host 提供 SDK，不要把 SDK 复制进插件发布清单。package.files.json 逐项列出要发布的文件，不支持通配符；实际配置、密钥和运行数据不进入 ZIP。

调试插件

lint 检查清单、制品结构、manifest、Python 语法和静态配置。它不执行插件，不判断第三方依赖、动态配置、权限授权或业务效果。check 只检查制品结构与合同，不替代 lint。

获准连接本机 Host 后，可用 runtime-plugins.py 的控制台配置、审阅权限、启动、查日志和重载，详见调试插件。托管环境以平台实际开放的上传和日志入口为准。

SDK 与许可

更新工具包后按升级步骤重新检查插件。SDK 和示例公开供插件开发使用；框架本体保持闭源，本下载不包含核心 Go 源码或 Host 运行程序。

SDK 与工具尚未指定独立开源许可证；可下载源码不代表采用 MIT、Apache 等开源许可。包内保留第三方声明。

官方开发工具包 ​

下载 ​

历史版本 ​

包含什么 ​

四步生成插件 ​

让 AI 正确使用 ​

调试插件 ​

SDK 与许可 ​