Harnessix Code

本地运行、模型自选、每一步都受控的 Coding Agent。

Harnessix Code 在你的终端里读代码、改代码、跑测试。改动要你批准，命令默认进沙箱，崩溃后能恢复，全过程可审计。模型由你选择，可以是云服务，也可以是你自己部署的模型。

当前是预览版，不是正式商用版本，不提供任何担保。 请在可以通过 Git 回退的仓库里使用。

快速开始

需要 macOS 或 Linux、Python 3.12 以上，以及 uv。

# 1. 安装（国内可加 --index-url https://mirrors.huaweicloud.com/repository/pypi/simple）
uv tool install harnessix

# 2. 配置模型
export MODEL_API_KEY=你的Key
harnessix code configure --provider-kind openai_chat \
  --base-url https://api.deepseek.com/v1 --model deepseek-v4-pro --non-interactive

# 3. 检查并启动
harnessix code doctor /path/to/repo --probe-model
harnessix code /path/to/repo

• 安装、配置、使用和全部功能的完整说明，见用户手册。
• 使用百炼等其他服务，或简要的上手说明，见 Beta 快速上手。
• 使用自己部署的模型（vLLM、Ollama，同机或局域网），见接入自托管模型。
• 无人值守运行：harnessix exec --trust-workspace --prompt "..." --approval-mode auto-edit。

它能做什么

还没有： Hooks，IDE 插件，Web 搜索，子代理，图片输入，自动更新。

安全边界

• 沙箱内的命令不能联网，不能写 .git 和工作区以外的位置，也读不到 ~/.ssh 等凭据目录。
• 沙箱外的命令每条都需要你批准。
• 首次打开目录时需要确认信任。
• API Key 只从环境变量读取，并在输出和记录中按机密保护。

沙箱内命令能读取拒读清单以外的文件，这些内容可能发送给模型服务商。完整说明和已知限制见 SECURITY.md。

数据去向： 代码和对话只发送给你配置的模型服务商。Harnessix 没有遥测，不向项目方发送任何数据。详见隐私说明。

评测结果

使用同一个本地模型（Qwen3.8-Flash-Next），在 SWE-bench Verified 的 49 题留出集上单次运行，官方判分：

这个结果目前只能说明两者接近，mini-swe-agent 还需要在断网条件下重跑。此外，这 49 题在调优过程中都被用于诊断，结果偏乐观；评测配置使用了 SWE-bench 任务模板；单次运行的波动也不小。SWE-bench 也不代表你的真实项目。

文档

• 用户手册：安装、配置、使用步骤和全部功能
• Beta 快速上手：安装、配置、反馈
• 配置参考、诊断、状态备份与恢复
• 架构、设计文档索引、路线图
• 威胁模型
• 更新记录
• 项目早期的里程碑记录

参与和许可

社区版按照 AGPL-3.0-only 发布。闭源使用见商业许可说明，品牌规则见 TRADEMARKS.md，第三方依赖见 THIRD_PARTY_NOTICES.md。

贡献代码前请阅读贡献指南。发现安全问题请按 SECURITY.md 私下报告，不要公开提 Issue。