UNCUT

这个 Agent 能做什么，适合哪些场景？

UNCUT 是一个用 Go 编写的极简编码 Agent 运行骨架，编译为单个约 7 MB 的静态二进制，没有运行时依赖和第三方 Go 依赖。它只提供一个 Agent 循环、一个 OpenAI 兼容的 Chat Completions 协议适配和四个工具：read_file、write_file、replace、run_command。设计上刻意去掉 TUI、遥测、插件系统、后台 Agent、自动重试和上下文压缩——每次模型调用都发送完整对话历史，文件内容和命令输出从不被 UNCUT 截断。它面向 shell 管道、CI 任务、容器和 Agent 实验，最终文本写到 stdout，加 --json 时输出 NDJSON 事件流，可选 --session 追加式 JSONL 会话可在后续调用中完整恢复。采用 MIT 许可，实现代码约 837 行，便于阅读和分叉修改。

UNCUT 从命令行接收提示词，并把管道输入（例如 git diff 或日志文件）原文追加到提示词后面。它读取工作区根目录的 AGENTS.md（除非传入 --no-agents）并放入系统提示，然后向 UNCUT_BASE_URL 指定的 OpenAI 兼容端点发起非流式 Chat Completions 请求，模型返回的文本和工具调用会被执行。四个工具分别是：读取整个 UTF-8 文本文件的 read_file、写入完整文件内容并创建父目录的 write_file、只替换恰好一处匹配的 replace、以及返回退出码和完整合并 stdout/stderr 的 run_command（Unix 用 /bin/sh -c，Windows 用 cmd.exe /D /S /C）。文件工具被限制在工作区内，但 shell 命令不受此限制。每一步若指定 --session，新消息会追加并同步到 JSONL 文件；最终答案输出到 stdout，--json 时改为输出 user、assistant、assistant_meta、tool 直至 done 或 error 的事件序列。当提供方返回 finish_reason=length 或 max_tokens 时，它以退出码 3 报错而不是把残缺答案当作成功。

1. 在 CI 流水线里加一步自动修复：用 uncut "Run the tests and fix the failure" 让模型读代码、改文件并跑测试，并把退出码 3/4 当作流水线失败信号。
2. 把代码评审塞进 shell 管道：git diff | uncut "Review this diff. Do not edit files." 在终端或脚本里得到纯文本评审结论。
3. 用本地 Ollama（如 qwen3:8b）在离线或私有环境中做仓库解释和轻量改动，不向外部 API 发送源码。
4. 在一次性容器内运行不受信任的任务，借助四个工具完成读文件、改文件、执行命令的闭环，同时用 --session 保留完整过程以便事后审计。
5. 做 Agent 研究时把它当作最小可改造基线：八百多行实现代码、单一提供方协议、单一循环，便于替换模型调用层或增删工具。
6. 用 python bench/proof.py 对自建或代理的模型端点做无损传输验证，检查大文件、大命令输出、会话恢复和截断行为是否符合预期。

如何安装或部署这个 Agent？

从 GitHub Releases 下载对应平台二进制并安装到 PATH。Linux：

VERSION=0.1.1
ARCH=amd64  # ARM64 上使用 arm64
curl -fSLo uncut "https://github.com/Balanov/uncut/releases/download/v${VERSION}/uncut-linux-${ARCH}"
mkdir -p "$HOME/.local/bin"
install -m 0755 uncut "$HOME/.local/bin/uncut"
export PATH="$HOME/.local/bin:$PATH"
uncut --version

macOS：

VERSION=0.1.1
ARCH=arm64  # Intel 机器使用 amd64
curl -fSLo uncut "https://github.com/Balanov/uncut/releases/download/v${VERSION}/uncut-darwin-${ARCH}"
mkdir -p "$HOME/.local/bin"
install -m 0755 uncut "$HOME/.local/bin/uncut"
export PATH="$HOME/.local/bin:$PATH"
uncut --version

Windows PowerShell：

$Version = "0.1.1"
$Arch = "amd64"  # ARM64 上使用 arm64
$Dest = "$env:LOCALAPPDATA\Programs\UNCUT"
New-Item -ItemType Directory -Force $Dest | Out-Null
Invoke-WebRequest -Uri "https://github.com/Balanov/uncut/releases/download/v$Version/uncut-windows-$Arch.exe" -OutFile "$Dest\uncut.exe"
$env:Path = "$Dest;$env:Path"
uncut --version

每个发布版本附 checksums.txt，可校验下载：

VERSION=0.1.1
ARCH=amd64
curl -fSLO "https://github.com/Balanov/uncut/releases/download/v${VERSION}/checksums.txt"
grep "uncut-linux-${ARCH}$" checksums.txt | sha256sum -c -

二进制尚未代码签名，SmartScreen 或 Gatekeeper 可能告警。macOS 校验后仅对该文件解除隔离：

xattr -d com.apple.quarantine "$HOME/.local/bin/uncut"

也可用 Go 1.26+ 安装或从源码构建：

go install github.com/Balanov/uncut/cmd/uncut@latest

git clone https://github.com/Balanov/uncut.git
cd uncut
go build -trimpath -ldflags="-s -w" -o bin/uncut ./cmd/uncut

如何使用这个 Agent？

设置模型和 API 密钥后直接传入提示词：

export UNCUT_API_KEY="your-api-key"
export UNCUT_MODEL="your-model-id"
uncut "Inspect this repository and fix the failing tests"

使用 OpenAI 兼容提供方时再指定 base URL：

export UNCUT_BASE_URL="https://openrouter.ai/api/v1"

本地 Ollama 示例（README 记录以 qwen3:8b 做过冒烟测试，本地端点默认不需要 API key）：

ollama pull qwen3:8b
export UNCUT_BASE_URL="http://localhost:11434/v1"
export UNCUT_MODEL="qwen3:8b"
uncut "Explain this repository"

管道输入会被原样追加到提示词：

git diff | uncut "Review this diff. Do not edit files."
cat failing-test.log | uncut "Find the likely cause"

输出 NDJSON 事件流或使用可恢复会话：

uncut --json "Run the tests and fix the failure"
uncut --session .uncut/work.jsonl "Start the refactor"
uncut --session .uncut/work.jsonl "Continue with the tests"

常用参数：--cwd 指定工作区，--max-steps 限制模型调用次数（默认 32），--max-tokens 设定提供方输出上限，--request-timeout 控制单次请求超时（默认 10m），--no-agents 跳过 AGENTS.md。运行无损契约自检需要 Python 3：

go build -o bin/uncut ./cmd/uncut
python bench/proof.py ./bin/uncut

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.1.1 2026-11-01
   发布说明摘录

   UNCUT 0.1.1 A patch release focused on Windows reliability and reproducible evidence. Fixed - run_command now preserves quoted cmd.exe commands, including executable paths with spaces and quoted arguments. Prove the lossless contract - New dependency-free bench/proof.py drives the real CLI through six scenarios: large UTF-8 input, complete combined stdout/stderr, exact edits, full-history resume, provider truncation, step limits, and invalid UTF-8. - CI runs this proof on Linux, macOS, and Windows. …

   在 GitHub 查看 ↗
2. v0.1.0 2026-11-01
   发布说明摘录

   Full Changelog: https://github.com/Balanov/uncut/commits/v0.1.0

   在 GitHub 查看 ↗

常见问题