Repository navigation
Releases
Releases · 78/moben-sdk
Moben SDK 0.7.2
Moben SDK 0.7.2 is a patch release for @moben-ai/app-sdk.
- Fix loading CommonJS TypeScript App entries through the app’s tsx loader.
- When an explicit USB port is not a candidate, show the detected candidate ports before attempting the connection.
- Clarify Windows, macOS and Linux shell and credential handling in the App guide and generated templates.
- Make SDK builds independent of the Cloud checkout; shared server helpers are imported only through the explicit sync command.
Validation: SDK tests, TypeScript checks, production package build and clean packed-package installation.
Moben SDK 0.7.1
Moben SDK 0.7.1 将 App 开发与 USB 实机调试能力发布到 npm。包含 0.7.0 已验收的功能,以及精简 README 和独立文档指南。
安装
npm install @moben-ai/app-sdk@^0.7.1
npx moben --version纯 CLI 用户可使用 npm install -g @moben-ai/app-sdk@^0.7.1。GitHub 附件提供同一安装包及 SHA-256 校验值。
内容
- 保留
defineApp()/connect()等 App API,新增 USB 设备 CLI 与connectDevice()/listDevices()。 - 支持身份与电源诊断、按键、PANEL/L8 截图、整页 Markdown/正文/链接/焦点导出、测试文本与实时日志。
- 串口依赖可选、按需加载,普通 App 功能可在未安装串口模块时使用。
- README 保留快速入口,App、USB 和维护说明位于
docs/并随包分发。
验证与边界
- 54 项 SDK 测试、类型检查、独立源码构建及安装包检查通过。
- macOS + ESP32-S3 的连接、输入、截图、全量快照、中断重连和低功耗切换已实机验证。Windows 10/11、Linux 实机验收仍待进行;不支持 Windows 7。
- 使用 USB 前关闭设备低功耗模式;测试文本需要云端设备白名单。
- 0.7.0 的 GitHub 安装包保持原样。
Moben SDK 0.7.0
Moben SDK 0.7.0 增加 USB 实机调试 CLI 与 JS/TS 接口,保留原有远程 Markdown App 能力。此版本先通过 GitHub Release 分发,npm 暂未更新。
仓库名为 moben-sdk,npm 包名保持 @moben-ai/app-sdk;App 开发与设备调试是同一 SDK 的两类能力,现有导入路径不变。
安装
gh release download v0.7.0 --repo 78/moben-sdk --pattern 'moben-ai-app-sdk-0.7.0.tgz'
npm install ./moben-ai-app-sdk-0.7.0.tgz
npx moben --version纯 CLI 用途可改用 npm install -g ./moben-ai-app-sdk-0.7.0.tgz。SHA256SUMS 附有安装包校验值。
新增能力
moben device list / doctor / hello / status / tasks / open / key / screenshot / snapshot / text / logs,支持 JSON 输出。listDevices()、connectDevice()与设备客户端,串口依赖按需加载,无需 Python 或 ESP-IDF。- 产品身份握手与低功耗诊断;PANEL/L8 截图、CRC 校验及原子保存。
- 全量已加载 Markdown、正文、链接及当前选择导出;实时日志与二进制数据分离。
- 测试文本沿用设备语音流程;安全取消、异常关闭与中断传输后的握手恢复。
- CLI 版本和新建项目依赖从包版本读取,修正版本不同步。
验证
- 54 项 SDK 测试、TypeScript 类型检查通过。
- 独立安装包验证:普通 App 功能不依赖可选串口模块;CLI 版本、模板依赖及缺失串口模块诊断正确;Linux 串口原生模块加载通过。
- macOS + ESP32-S3 实机通过身份识别、按键、截图、文本及取消、1653 链接/93 屏导出、传输中断重连、连续开关串口及低功耗切换验收。
使用边界
- USB 调试前需在设备上关闭低功耗,并连接 USB 数据线。
- 新快照与文本取消能力需使用声明相应 HELLO 能力的设备固件(本轮验收为 1.8.6)。旧 PSG1 固件仅允许调用其已声明能力,品牌缺失时显示兼容提示。
- 文本测试需云端精确设备白名单;完成仅代表提交,不代表 App 回复完成。
- Windows 10/11 和 Linux 实机测试仍待进行;不支持 Windows 7。