Balanov/skein

选用指南

AI 根据 README 整理 · 2026/11/3 10:36:18

使用方式

通过命令行运行，使用 `skein run` 执行任务图，`skein stop` 触发紧急停止，`skein status` 查看状态，`skein reset` 重置。

查看 README 依据

Both scripts pick the binary for the current OS and architecture (Linux, macOS, Windows × amd64, arm64), verify it against `SHA256SUMS` and install into a user directory. Set `SKEIN_INSTALL_DIR` to override. Alternatively, download binaries from [releases](https://github.com/Balanov/skein/releases/latest) or build from source with Go 1.26+: ```sh go build -trimpath -o bin/skein ./cmd/skein ``` The binary is static, needs no daemon, database or runtime dependencies. ## Run ```sh skein run --state .skein --workers 2 --include-tasks examples/fanout.json

skein stop --state .skein --reason "manual emergency stop" skein status --state .skein # {"stopped":true,"epoch":2} skein reset --state .skein # inspect first; epoch is never reused ``` A run stores `report.json`, `events.jsonl`, leases and payload data under `.skein/runs/<run-id>/`. Exit codes: `0` success, `3` a task failed, `4` the run was stopped, `1` operational error, `2` usage error.

部署要求

支持 Linux、macOS 和 Windows，提供安装脚本或从源码构建（需要 Go 1.26+）。二进制是静态的，无需守护进程、数据库或运行时依赖。

查看 README 依据

[Architecture](docs/ARCHITECTURE.md) · [Security boundary](SECURITY.md) · [Integration](docs/INTEGRATION.md) · [Benchmarks](BENCHMARKS.md) · [Landing source](site/) ## Install Linux and macOS: ```sh curl -fsSL https://raw.githubusercontent.com/Balanov/skein/main/install.sh | sh ``` Windows PowerShell: ```powershell irm https://raw.githubusercontent.com/Balanov/skein/main/install.ps1 | iex ```

Both scripts pick the binary for the current OS and architecture (Linux, macOS, Windows × amd64, arm64), verify it against `SHA256SUMS` and install into a user directory. Set `SKEIN_INSTALL_DIR` to override. Alternatively, download binaries from [releases](https://github.com/Balanov/skein/releases/latest) or build from source with Go 1.26+: ```sh go build -trimpath -o bin/skein ./cmd/skein ``` The binary is static, needs no daemon, database or runtime dependencies. ## Run ```sh skein run --state .skein --workers 2 --include-tasks examples/fanout.json

已知限制

不覆盖任意命令的沙箱、认证或签名租约、代理输出的语义验证、精确一次的外部副作用、自动崩溃恢复、分布式共识、远程或分离工作，以及已跨越外部边界的副作用。

查看 README 依据

**Not covered:** sandboxing arbitrary commands; authentication or signed leases; semantic validation of agent output; exactly-once external side effects; automatic crash recovery; distributed consensus; remote or detached work, and side effects that already crossed an external boundary. A lease is a fencing token, not a credential — external systems honor it only through a gateway that checks it. Manifest commands keep the OS user's permissions; use an OS sandbox for untrusted workloads. See [SECURITY.md](SECURITY.md). ## Measurements