跳到主要内容
anvil / anvilkernel

安装 · 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。

继续阅读