DEVELOPER DOCUMENTATION

SpaceSDK for Windows

SpaceSDK 是 ZERA AI OS 面向第三方业务空间的适配层 SDK。ZERA AI OS 是产品与业务空间操作系统，HERMES 是 Agent Runtime 底座，LUMII 是面向用户提供帮助的助手；现有 @lumii 包名是兼容技术标识，不代表底座归属。

0.1.0-preview.1 · Developer API 1 · Windows · 开发预览版

通过 Windows Host，将你的业务工作台接入已有 Agent、Team、聊天及业务处理器。业务界面、逻辑、权限和数据仍由你的应用拥有。

下载与安装

• 下载 Windows SDK 安装包（约 60 KB）
• 下载完整文档与工作台示例
• SHA-256 校验文件
• 版本元数据

npm install --save-exact ./lumii-spacesdk-0.1.0-preview.1.tgz

import { createNativeApplicationRuntimeContext } from '@lumii/spacesdk';
import { mountApplicationChat } from '@lumii/spacesdk/chat';

const { platform } = await createNativeApplicationRuntimeContext();

开发文档

• Windows 接入指南：应用形态、安装引用、岗位、聊天、业务处理器与发行流程。
• API 与权限参考：公开方法、权限、错误码、幂等、恢复与取消。
• 版本说明与支持边界：验证范围及尚需实机验收的部分。

SpaceSDK 的包名是 @lumii/spacesdk。它不等同于 Gateway SDK、Plugin SDK 或模型服务 SDK。本次通过服务器下载分发，没有发布到公共 npm Registry。

当前支持边界

运行入口是经可信安装、登记并准入的 ZERA AI OS Windows Host 业务空间，由 HERMES 提供 Agent Runtime 能力。普通网页或任意独立 EXE 不能仅靠导入此包获得接入身份。

此版本已通过 SDK 独立离线安装、类型检查、浏览器打包和模拟 Host 协议验证；真实签名安装、模型调用及业务数据操作仍需应用与 Host 联调验收。应用后台任务执行暂不支持；KBrain 为可选扩展。