安装 · Pre-alpha
从源码开始。
没有安装包。
当前版本是 0.6.0 基线。Anvil 还没有官方二进制安装包或包管理器 仓库;请从源码构建,并把编辑器与五个伴随程序放在同一目录。
LinuxRust 1.88+Go 1.26.11+Landlock 5.13+
1. 准备环境
需要 Linux、UTF-8 locale、Rust 工具链和 Go。仓库会固定工具链版本。
- Rust 1.88 或更新版本;
rust-toolchain.toml固定仓库版本。 - Go 1.26.11 或更新版本;
go.mod固定版本。 - Landlock 需要 Linux 5.13 或更新内核。缺少 Landlock 时,受限功能会降级或拒绝启动。
- 语言服务器不随 Anvil 分发。按需把
rust-analyzer、gopls、clangd等放到PATH。
2. 构建
在仓库根目录执行标准版构建:
git clone https://github.com/GBLMX/Anvil.git cd Anvil cargo build --release -p anvil-distro-standard -p anvil-ctl -p anvil-mcp -p anvil-plugin-host GOTOOLCHAIN=go1.26.11 go build -o target/release/anvil-gateway ./go/cmd/anvil-gateway GOTOOLCHAIN=go1.26.11 go build -o target/release/anvil-exec-runner ./go/cmd/anvil-exec-runner
默认组合是标准版 / Git-only。需要在本地启用全部官方模块和 web/C/C++ 语法时,使用 --features full。
3. 安装
推荐先生成自包含发布布局,再运行安装器。布局包含全部六个二进制、 官方插件源、桌面入口和图标。
scripts/release-layout.sh "$PWD/dist/anvil" ./dist/anvil/install.sh
安装器默认前缀是 $HOME/.local。它会替换随附包集合,并在存在 已签名包时运行 anvil-gateway -install-bundled;重复执行会原地升级。
如果手动复制,必须把 anvil、anvil-ctl、anvil-mcp、anvil-gateway、anvil-exec-runner、anvil-plugin-host放进同一目录。编辑器默认在自身旁边查找网关。
4. 验证
export PATH="$HOME/.local/bin:$PATH" anvil --version anvil --help anvil doctor --profile installed anvil setup check anvil setup plan
setup check 与 setup plan 只读。doctor 检查完整发布布局、 locale、终端颜色能力、运行时/配置路径、Landlock 和语言服务器。
打开一个工作区并确认基本操作:
cd ~/src/my-project anvil --workspace "$PWD"
- 编辑器能渲染,
:q能退出。 Space e打开文件树;打开和保存文件正常。Space f列出工作区文件,预览后 Enter 打开。:reconnect启动新网关;外部文件变化会刷新文件树。
打开或保存提示网关不可用时,先确认六个二进制在同一目录,并且网关与 编辑器由同一用户启动。
终端与运行时边界
- Kitty、foot、WezTerm 等支持增强键盘协议的终端可以使用完整按键;其他 UTF-8/真彩色终端通常可用,但这不是支持保证。
- 通过 SSH 或 tmux 时,
COLORTERM可能不会转发。使用anvil doctor --json检查,不要仅凭截图强制真彩色。 - 网关是每个编辑器会话的进程,不是全局守护进程或 systemd 服务。
- 网关负责工作区路径约束和
fs.read/fs.write权限检查;它不是插件沙箱。 - 插件宿主需要委派的 cgroup v2 根;没有它时启动失败并关闭。插件不在编辑器进程内加载。
卸载
rm "$HOME/.local/bin/anvil" \ "$HOME/.local/bin/anvil-ctl" \ "$HOME/.local/bin/anvil-mcp" \ "$HOME/.local/bin/anvil-gateway" \ "$HOME/.local/bin/anvil-exec-runner" \ "$HOME/.local/bin/anvil-plugin-host"
编辑器状态、工作区文件和语言服务器缓存不会被卸载器删除。需要时手动检查$XDG_CONFIG_HOME/anvil、$XDG_DATA_HOME/anvil 和$XDG_STATE_HOME/anvil。