Arcthis
EN 阅读文档

v0.6.0 · MIT · 已发布

下载 Arcthis。

通过 Cargo、Homebrew、npm 或 pnpm 安装,也可以从 GitHub Release 下载 macOS 与 Linux 编译成品。所有方式默认都包含 MCP。

当前版本:v0.6.0,支持 Cargo、Homebrew、npm、pnpm 与 GitHub Release。
Cargo
cargo install arcthis --locked
Homebrew
brew install mkynyd/tap/arcthis
npm
npm install -g arcthis
pnpm
pnpm add -g arcthis

pnpm 11 遇到 ERR_PNPM_IGNORED_BUILDS 时，在命令末尾加 --allow-build=arcthis，只批准 Arcthis 的安装脚本。依赖代理访问 GitHub 时，为安装命令显式设置 HTTPS_PROXY/HTTP_PROXY。

也可以从 GitHub Release v0.6.0 下载 Apple Silicon macOS、Intel macOS 与 Linux x86_64 压缩包和 SHA-256 校验值。pnpm 11 会暂缓安装发布不足 24 小时的新包;首发当天遇到 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION 时,可在安装命令末尾临时加 --config.minimumReleaseAge=0。

从源码构建 （可选）

  1. 安装 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

  2. 下载源码并编译

    编译完成后,程序位于 target/release/arcthis。默认编译同时包含命令行工具、库和 MCP 功能,与 Cargo、Homebrew、npm、pnpm 安装的命令保持一致。

    build — sh 
    git clone https://github.com/mkynyd/arcthis.git
cd arcthis
cargo build --release --locked
./target/release/arcthis --help

  3. 把源码构建加入 PATH(可选)

    装好后 arcthis 会加入 PATH,在任何目录都能直接运行。

    install — sh 
    cargo install --path . --locked
arcthis --version
# arcthis 0.6.0

  4. 启动 MCP

    本地 MCP 服务已经包含在默认构建中。除非你同时授权输出目录,否则修改类工具不会出现。

    mcp — sh 
    arcthis mcp --allow-root ./archives --allow-output-root ./outputs

平台支持

平台状态说明
macOS支持本地测试加 GitHub 自动化测试,包含完整 MCP 功能
Linux支持本地测试加 GitHub 自动化测试,包含完整 MCP 功能
Windows暂不支持设计上已避免依赖 Unix 专属功能,尚未在 Windows 上建立自动化测试
验证你运行的东西。完整测试套件 cargo test --all-features 和命令行测试数据都随源码一起发布。安全保证和已知限制记录在 docs/SECURITY.md。

Linux 预编译包需要系统 nettle、lzma、lz4、zlib 与 libxml2，以及 libxml2 的 ICU/C++ 运行库依赖。发布验收在 Ubuntu 22.04 和 24.04 上运行。详见 RELEASING.md。