CarterT27/scion

选用指南

AI 根据 README 整理 · 2026/10/15 14:06:08 · 基于较早版本，请核对最新 README

适用场景

适用于需要服务端存储历史、客户端按需获取对象的版本控制场景，特别是编码代理和 CI 环境。

查看 README 依据

# Scion Source control for always-online clients, coding agents, and CI. Scion is an independent, clean-room Rust implementation inspired by Anthropic's [Redesigning source control](https://www.anthropic.com/engineering/redesigning-source-control). It explores the architecture described in that post: keep history and expensive operations on the server, fetch immutable objects as needed, and check out only the paths a job needs. This repository is not Anthropic's implementation and is not affiliated with Anthropic. ## Benchmarks

使用方式

通过命令行使用，包括登录、检出、状态、提交和落地等操作，支持 JSON 输出。

查看 README 依据

# For a private CA, also set SCION_CA_FILE to its PEM file. ./target/debug/scion login ./target/debug/scion checkout main /tmp/scion-work --sparse crates/scion-core ./target/debug/scion -C /tmp/scion-work status # Edit files in the working copy, then: ./target/debug/scion -C /tmp/scion-work diff ./target/debug/scion -C /tmp/scion-work commit -m "Update core" ./target/debug/scion -C /tmp/scion-work land --ref main ``` Use `login --service NAME` with `SCION_SERVICE_SECRET` for a configured service principal.

To use a node daemon, start `scion-daemon --config /path/to/scion-daemon.toml` and point `SCION_ENDPOINT` at its `unix:///path/to/daemon.sock` endpoint. Commands support `--json` with versioned output schemas in [`schemas/v1`](schemas/v1). Run each command with `--help` for options. ## Test The default suite uses in-memory storage, temporary working copies, and loopback services. It requires no running database or Docker. Tests include an independent reference model, Git differentials, fault injection, concurrency checks, and storage-access complexity gates. ```sh cargo test --workspace

部署要求

需要 Rust 1.98.0 和 protoc 构建，运行服务需要 CockroachDB、S3 兼容存储、TLS 证书、Ed25519 签名密钥和访问策略。

查看 README 依据

code search, and CI orchestration are separate systems outside this repository. Offline operation, Git protocol compatibility, and two-way Git sync are out of scope. See [the specification](SPEC.md) for contracts and [deferred work and known edge cases](SPEC.md#appendix-a-deferred-work-and-known-edge-cases) for current limits. ## Build Install Rust through rustup and ensure the Protocol Buffers compiler (`protoc`) is on your PATH. The repository pins Rust 1.98.0 in [`rust-toolchain.toml`](rust-toolchain.toml). ```sh cargo build --workspace --all-targets ./target/debug/scion --help ```

The workspace builds four executables: `scion`, `scion-server`, `scion-daemon`, and `scion-import`. ## Use Running the service requires CockroachDB, an S3-compatible bucket, TLS certificates, an Ed25519 signing key, and an access policy. Configure the server using [SPEC section 6](SPEC.md#6-configuration-specification), then start it: ```sh ./target/debug/scion-server --config /path/to/scion-server.toml ``` With a configured server and an authorized GitHub account, a typical workflow is: ```sh export SCION_ENDPOINT=https://scion.example.internal:7443

已知限制

当前 v1 仅支持单一 monorepo 和 Unix 客户端（Linux 和 macOS），不支持离线操作、Git 协议兼容和双向 Git 同步。

查看 README 依据

- **Derived indexes.** Eager and lazy derived data support path history, blame, commit-graph queries, and Git mappings. - **Access control and redaction.** GitHub device-flow login, service principals, path/ref policies, and quarantine/purge of blob or metadata contents without rewriting identifiers. - **Git migration.** A one-way importer preserves history and records Git-to-Scion mappings. ## Scope The current v1 targets one monorepo and Unix clients (Linux and macOS). It implements the core source-control service, CLI, daemon, importer, and test infrastructure. Production throughput

code search, and CI orchestration are separate systems outside this repository. Offline operation, Git protocol compatibility, and two-way Git sync are out of scope. See [the specification](SPEC.md) for contracts and [deferred work and known edge cases](SPEC.md#appendix-a-deferred-work-and-known-edge-cases) for current limits. ## Build Install Rust through rustup and ensure the Protocol Buffers compiler (`protoc`) is on your PATH. The repository pins Rust 1.98.0 in [`rust-toolchain.toml`](rust-toolchain.toml). ```sh cargo build --workspace --all-targets ./target/debug/scion --help ```