阅读文档

v0.5.0 · MIT · 源码构建

下载 Arcthis。

Arcthis 使用锁定的 Rust 工具链从源码构建。构建可复现(--locked)、依赖克制,并在 macOS 与 Linux 上经过 CI 测试。

如实说明:v0.5.0 尚未发布 crates.io 包或预编译二进制。下面的命令就是当前完整的安装路径,没有遗漏。

安装 Rust 与系统依赖

仓库通过 rust-toolchain.toml 锁定 Rust 1.98.0,在检出目录内 rustup 会自动选择。RAR 支持会静态链接 libarchive,因此源码构建需要它及其编解码依赖。
macOS — Homebrew
```
brew install libarchive libb2 bzip2 lz4 xz zstd
```
Debian / Ubuntu — apt
```
sudo apt install libarchive-dev libb2-dev libbz2-dev \
  liblz4-dev liblzma-dev libxml2-dev libzstd-dev zlib1g-dev
```
克隆并构建

锁定的 release 构建会在 target/release/arcthis 生成 CLI。默认构建只包含 CLI 与 library,不含 MCP 依赖。
build — sh
```
git clone https://github.com/mkynyd/arcthis.git
cd arcthis
cargo build --release --locked
./target/release/arcthis --help
```
安装到 Cargo 的 bin 目录

可选,但它会把 arcthis 放进 PATH,让 Agent 和 shell 在任何目录都能找到。
install — sh
```
cargo install --path . --locked
arcthis --version
# arcthis 0.5.0
```
可选:MCP 前端

本地 stdio MCP server 是显式的 feature 构建。除非同时声明输出策略,否则变更工具不会出现。
mcp — sh
```
cargo build --release --locked --features mcp
arcthis mcp --allow-root ./archives --allow-output-root ./outputs
```

平台支持

平台	状态	说明
macOS	支持	本地测试加 GitHub Actions,含全 feature MCP 覆盖
Linux	支持	本地测试加 GitHub Actions,含全 feature MCP 覆盖
Windows	暂不支持	架构上避免了 Unix 专属公开接口,但 v0.5 未将 Windows 纳入 CI

验证你运行的东西。完整测试套件 cargo test --all-features 与动态 CLI fixture 都随仓库发布。安全保证与已知限制记录在 docs/SECURITY.md。