Semifold
开始使用

安装 Semifold

安装最新发布的 Semifold 命令行工具,并确认 smif 命令可以使用。

安装后可以使用 smif 和 semifold 两个等价的命令名称。本文档统一使用较短的 smif。

除非需要复现旧环境,否则建议始终安装最新版本。安装脚本会查询 GitHub Releases,并选择标签符合 semifold-vX.Y.Z 的最新已发布稳定二进制 Release。脚本不会使用仓库级 latest 指针,因为它可能指向 Semifold monorepo 中的其他软件包。

推荐方式:安装脚本

curl -L https://semifold.noctisynth.org/install/install.sh | sh

脚本默认安装到 $HOME/.local/bin。如果这个目录尚未加入 PATH,请在 shell 配置中添加它。

如需修改安装目录,可以向下载后的脚本传入参数:

curl -L https://semifold.noctisynth.org/install/install.sh | \
  sh -s -- --install-dir "$HOME/bin"

安装指定版本

只有需要复现特定环境时才需要传入版本。0.3.1 和 v0.3.1 都会解析到 GitHub Release semifold-v0.3.1:

curl -L https://semifold.noctisynth.org/install/install.sh | \
  sh -s -- 0.3.1

默认安装不会选择预发布版本;如确实需要,请显式传入完整的预发布版本号。

通过软件包管理器安装

也可以选择当前环境已经信任的软件包仓库:

cargo install semifold

从源码编译时请使用较新的稳定版 Rust 工具链;预编译 CLI 和 npm 包不要求安装 Rust。在 Windows 上安装本仓库的 Bun workspace 或生成 N-API 产物时,请使用 NTFS 等支持目录链接和硬链接的文件系统;这些工具无法在 exFAT 上创建所需链接。这不影响预编译 Semifold CLI 访问 exFAT 上的共享仓库。

npm 包要求 Node.js 20 或更高版本,并会在安装时选择 macOS、Windows 或基于 glibc 的 Linux 所对应的 x64/arm64 N-API binding。该包暂不支持 Linux musl 发行版,请在这些环境中使用安装脚本或 Cargo。

验证命令

修改 PATH 后请打开一个新 shell,再运行:

smif --version

命令输出已安装的 Semifold 版本且没有报错,就表示安装成功。

现在可以继续完成第一次发布,也可以先阅读Semifold 管理什么。

Git 仓库与共享盘

Semifold 使用内嵌的 Rust gix 库完成本地仓库发现、状态检查、历史查询和发布提交。这些操作不要求安装 Git 可执行文件。所有权检查仍然启用:共享仓库需要在受保护的系统或全局 Git 配置中显式授权,例如:

[safe]
    directory = E:/Projects/*

Linux 请使用挂载路径,例如 /shared/projects/*。同时支持精确仓库路径、* 和用于重置先前信任列表的空配置项。仓库不能通过自身的局部配置为自己授予信任。gix 的目录前缀规则也包含前缀目录自身的仓库,因此应把配置根目录限定在可信仓库范围内。Semifold 不修改用户的全局 Git 配置。

smif ci 的远程 push 仍使用 libgit2。仅配置目录通配规则时,push 预检仍可能拒绝本地 gix 操作可以访问的共享仓库;该检查会在修改发布文件或引用之前执行。普通 status、version、publish 和 MCP 操作不使用此 push 适配器。工作流边界见持续集成。配置中的发布命令、凭据 helper 和属性过滤器仍可能需要各自的外部工具。

本页内容