Maka npm launcher

English

rust-preview 是独立的实验性预览分发,不是 Apache 软件基金会正式发行版,也未经 ASF 批准、背书或支持。

npm install --global @maka-agent/cli@rust-preview

启动器选择匹配的原生可执行文件,转发参数、标准 I/O 和退出状态。精确版本的可选依赖携带 CLI(内置 maka terminal-shell),以及桌面 shell 和应用。macOS 上桌面 shell 和应用位于 Maka.app 内;其他平台携带 maka-desktop-shell 及其相邻的 app/ 应用目录。预览版支持 macOS arm64、使用 glibc 的 Linux x64 和 Windows x64。WSL 使用 Linux 可执行文件,通过匹配的 Windows helper 提供 Computer Use。

latest 标签仍为空占位包,包括独立的 maka-agent 包;它们没有 CLI、运行时、依赖或安装脚本。占位源码见 placeholder,预览产物必须使用 rust-preview。

运行 maka 打开 NSH 终端工作台,自动发现或启动 ~/.maka/application/host 的 Host。--root HOST_ROOT 指定其他 Host,--session SESSION_ID 打开已有会话。maka --help 列出自动化命令。组合和安装方式见产品指南。

通过 maka desktop --root HOST_ROOT 启动桌面。这个必填路径选择业务 Host:缺失的 Root 初始化为标准只读 Host,已有 Root 使用已保存的部署。启动器在 shell 退出前保留经过校验的 Host 客户端;其他已连接客户端会继续保留 Host。打包的 shell 从可执行文件旁加载 app,不依赖工作目录。直接开发命令见 desktop-shell。

通过 maka terminal-shell 启动 NSH 终端工作台,自动发现或启动 ~/.maka/application/host 的 Host。--root HOST_ROOT 可指定其他 Root,--session SESSION_ID 可打开已有会话。maka terminal-shell --help 可查看参数。源码构建见 terminal-shell。

构建与发布

通过 just source <version> 从已提交修订创建源码候选包。各平台使用同一归档构建:

just package <source.tar.gz> <target> <build-id> native-preview

收集三个平台的原生包与回执,以及源码归档和 SHA-512 文件,然后执行:

just release-prepare native-preview
just release-check native-preview
just publish native-preview

release-check 离线安装并运行已准备产物,每个目标平台都要执行。发布先上传原生组件,再上传启动器,并验证频道标签。中断后重试相同产物。npm 标签不支持条件更新,每个频道同时只运行一个发布者。

发布工作流以 publish=false 构建和验证。非官方发布在 M4n5ter/maka-agent 的 feat/runtime-host-rust 分支运行,需要显式 publish=true,使用独立 npm-rust-preview 环境,不从 ASF 仓库发布。

依赖、V8 缓存和 notices 见原生构建工具;归档校验与签名见源码发布。