stubbi/asm

项目介绍

Asm 是面向汇编项目的包注册表加命令行工具。它把高级语言早已具备的工作流引入汇编：带明确机器目标的命名包、可重复构建、依赖锁定、可执行程序安装，以及附带验证证据的发布记录。适合想直接控制指令与内存布局的开发者，以及需要以结构化方式分发汇编产物的团队。0.6.0 版本新增按目标区分的命名实现、独立 Linux 交叉构建和按目标选择的依赖锁。设计思路见 Why Asm，产物检查、构建溯源、形式化证明与智能体审查如何区分可见安全模型。

CLI 本身用汇编编写，汇编、链接、传输和加密校验交给系统工具；Python 负责注册表操作和 MCP 协议适配，JavaScript 支撑网站。

快速使用

Asm 0.6.0 支持 Linux x86-64、Linux ARM64 和 Apple Silicon macOS 15 及以上。先安装 GitHub CLI 2.93.0+：Linux 上 gh 需位于 /usr/bin/gh，并具备 curl 和 /usr/bin 下的 GNU Coreutils；Apple Silicon 上需位于 /opt/homebrew/bin/gh。

curl -qfsS -m120 https://asm.build/install.sh | sh

按安装器提示应用 PATH 命令（或 export PATH="$HOME/.local/bin:$PATH"），再检查版本：

asm version

Apple Silicon 上输出为 asm 0.6.0 (aarch64-macos)。安装脚本源码和自更新要求可供核查。

Linux 上安装 GNU Binutils（Debian/Ubuntu 的 binutils 包），macOS 上执行 xcode-select --install。然后创建并运行项目：

asm doctor &&
asm new hello &&
cd hello &&
asm run &&
asm test

程序输出 Hello from asm!。生成的项目包含 asm.toml、src/main.s 和 tests/main.s；asm build 汇编链接为 build/app，asm run 还会执行它，asm test 构建并运行测试文件，退出码为零即通过。

项目与包

asm.toml 声明包名、版本、源文件和目标；asm new 自动选择本机目标（x86_64-linux、aarch64-linux 或 aarch64-macos）。多目标项目把输入放在 targets/<id>/ 下并用 [target.<id>] 段声明；asm build --target riscv64-linux 生成独立的 Linux 产物，asm test --target riscv64-linux --no-run 只构建测试不执行。跨目标链接本地库暂不支持。

注册表支持搜索、查看版本、下载源码和安装可执行程序：

asm search hello
asm info stubbi/hello
asm versions stubbi/hello
asm fetch stubbi/hello@0.6.0 --target x86_64-linux --kind source
asm install stubbi/hello@0.6.0
asm installed
asm upgrade stubbi/hello
asm uninstall stubbi/hello

asm fetch 校验大小和 SHA-256；asm install 把可执行文件装到 $HOME/.local/bin，--output PATH 可指定新文件路径；同一包身份最多一个受管安装。源码依赖使用精确版本：asm add stubbi/math@0.6.0 --target x86_64-linux 后执行 asm lock。提交 asm.lock，asm sync 恢复依赖，asm build --locked 强制校验锁文件。安装程序的文件检查、恢复和限制见安装程序约定，完整调用示例见包使用示例。

使用约束

Asm 处于早期 alpha。传递依赖、自助发布、账号恢复、隔离的公共构建 worker 和托管形式化验证仍在计划中；当前发布通过提交到注册表的审核型 pull request 完成。托管注册表和 MCP 部署仍处于资格验证阶段。已发布的 0.4.0 二进制不含安装管理命令，升级 Asm 也不会接管此前的安装。CLI 采用 AGPL-3.0-or-later，起始代码和参考示例为 MIT，各包保留自己声明的许可证；可运行 asm license 查看。

HotRepo 点评

项目于 2026-11-05 进入新项目榜，在约两小时的窗口内新增 52 Star，累计 179 Star、0 Fork。这只是一个新仓库的短窗口样本，说明项目早期获得了关注，并不能说明生态或工具链已经得到验证。值得继续观察的是它自述的 alpha 限制：源码依赖仅支持单版本、发布依赖 pull request、托管注册表仍在资格验证中。