sandbaseai/sandbase-harness

SandBase Harness – 面向AI代理的本地优先运行时

简介 – SandBase Harness是一个自托管运行时，可让您在自有机器或基础设施上安全地运行AI代理（例如：Claude风格的“托管代理”）。它添加了仅靠SDK无法提供的生产级组件：持久会话、沙箱化工具执行、凭据保险库、审计跟踪和用于检查的Web控制台。

主要功能

功能	您获得的内容
与Claude托管代理兼容的API	公开一个/v1 HTTP API，镜像Claude Managed Agents合约，因此现有的Anthropic风格SDK可即插即用。
本地优先存储	所有元数据（代理、会话、环境、内存、文件、API密钥等）存储在workspace内的SQLite文件中——无需外部数据库。
沙箱后端	在隔离环境中运行生成的代码：本地进程、Docker容器（每个会话一个）、Kubernetes kubectl exec/cp或自定义自托管工作队列。
工具治理	MCP风格工具集、权限策略、凭据注入，以及可自动批准或要求人工确认的审批门控。
会话回放与调试	事件记录到追加流中，可通过Server-Sent Events（SSE）流式传输，用于实时调试或稍后回放。
模型无关	支持OpenAI、Anthropic、MiniMax、DeepSeek V4以及任何兼容OpenAI的端点。
Web控制台	内置UI（http://127.0.0.1:3000）显示会话、设置、API参考，并允许实时检查代理的回合。
TypeScript SDK	提供类型化的客户端辅助工具，用于运行时。

如何开始

1. 安装Node 22+、npm 10+（Docker可选）。
2. 克隆存储库，运行npm ci && npm run build。
3. 初始化workspace：node dist/index.js init。
4. 启动服务器：node dist/index.js start。
5. 打开控制台，添加模型提供商的API密钥，选择模型，创建会话。
6. 通过UI或CLI发送消息，例如： node dist/index.js chat agent_assistant --message "hello" --tool-approval allow --tool-approval allow标志预授权代理想要执行的任何工具调用。

为什么重要

• 安全性 – 代理生成的代码在隔离的容器中运行，防止宿主机的意外破坏。
• 可审计性 – 每个事件（模型请求、工具调用、凭据使用）都被记录并可回放。
• 控制 – 细粒度的权限策略让您决定代理可以使用哪些工具以及在什么条件下使用。
• 可移植性 – 因为所有内容都存在于本地文件中，您可以在没有云控制平面的情况下移动workspace、备份或在防火墙后运行。

适用场景 SandBase Harness位于低层模型SDK（仅发送提示）和全方位编排平台之间。非常适合需要持久状态、工具使用和严格安全性，同时希望保持本地的开发人员构建自主代理。

存储库中的链接

• 架构图 – docs/assets/sandbase-harness-architecture.svg
• API规范 – docs/api.md
• 官方TypeScript SDK – managed-agents/sdk
• 兼容性矩阵 – 显示Claude Managed Agents合约的哪些部分完全支持、部分支持或不受支持。
• Codespaces模板 – 快速一键式云开发环境。

---

以上所有细节均直接取自存储库的README；没有推断额外功能。