Agent 运行时沙箱sandbaseai/sandbase-harness

SandBase Harness

GitHub stars
已收录于 deepseek-plugin.org
Release
Official MCP Registry
Discussions
CodeQL
License

面向 AI Agent 的项目元数据：llms.txt · 安装指南

一个本地优先、可自托管的 AI Agent Runtime。它把持久化会话、沙箱工具、
Memory、凭证、审计日志、事件回放和可视化 Console 放在同一个运行时边界中，
并提供原生 DeepSeek Harness stdio MCP 插件。

正在使用 DeepSeek Harness 构建 Agent？可查看独立的 DeepSeek Harness Handbook，其中包含有来源依据的运行时指南、多语言故障排查，以及持续更新的 Agent-first 资源地图。

SandBase Harness 架构

当前稳定版本：v0.3.8

MCP Bridge 容器镜像：GitHub Container Registry。

从使用场景开始

参见场景展示，了解可审计 Coding Agent、以 DeepSeek
Harness 为交互前端，以及 Local、Docker、Kubernetes、自托管沙箱的受控代码执行。

社区实践讨论：

- Codex、Claude Code 与 DSH 的 Memory 迁移
- 第三方插件的沙箱与文件系统防护

官方 MCP Registry：io.github.sandbaseai/sandbase-harness（状态：active）

如果只需要轻量接入而不需要完整 Runtime，可使用 SandBase CLI：
它通过本地 stdio MCP Bridge，将 25 个 AI 客户端目标连接到 2,000+ 模型与 API。
如果它适合你的工作流，欢迎为 SandBase CLI 点个 Star，
帮助更多 Agent 用户发现它。

为什么需要它

模型 SDK 负责调用模型，但生产 Agent 还需要解决另一组问题：

- 会话和产物如何持久化？
- 工具在哪个沙箱中执行？
- 敏感动作如何经过权限与审批？
- 出错后如何查看事件、回放并恢复？
- 不同模型如何通过同一运行时接入？

SandBase Harness 提供这层运行时基础设施。它不是可视化工作流编辑器，
也不替代模型 SDK。

如果它解决了你的真实 Agent 基础设施问题，欢迎
为仓库点 Star，帮助更多开发者发现它。

发现 SandBase Harness

项目也可以通过以下独立生态目录发现：

- 官方 MCP Registry
- deepseek-plugin.org
- DeepseekPlugin
- DSH Plugin Directory
- DSH Plugin Hub
- DSH Directory
- DSH Harness
- DSH Plugin
- DSH Plugin
- dsh.so 信任与发现目录
- DeepSeek Harness Hub — 社区发现页面；当前元数据仍为过期的 v0.3.4，请以官方安装文档为准
- Duink DSH Universe
- DSH Plugin Leaderboard
- Awesome 仓库索引
- Awesome DSH Plugin
- Awesome DeepSeek Harness
- Awesome DeepSeek Harness — 生态列表
- DSHarness 101 插件雷达
- DeepSeekDocs 生态目录
- Awesome Agents
- Sifted Awesome AI Agents — 已验证 Agent Runtime 收录
- Arnon-hs Open Source / AtlasRepo — 已验证 MCP 收录
- Sagargupta16 Awesome MCP Servers — 已合并收录
- Adventure Wave Awesome Agent Security — 已合并收录
- Arnon-hs Open Source — MCP 项目
- SandBase Awesome Agent Runtime
- WalkingLabs Awesome Harness Engineering — 已合并收录
- Awesome Native Agent Platforms — 已合并 Harness 条目
- Yenanjing Awesome Harness Engineering PR #6 — 等待审核
- abordage/awesome-mcp
- cccakeee/awesome-dsh-plugins
- anbeime/skill — Skills 索引
- Awesome DeepSeek Harness Plugins
- Hermes Ecosystem — SandBase 技术栈
- AgentStack
- HVTracker：独立自动生成的 Agent Frameworks 项目档案与排名快照，不代表维护者审核或安全认证。
- MCP Servers Live
- DSH X-Ray
- DSH Plugins
- Awesome DSH Hub
- Awesome DSH Plugins 2026
- MCP Repository
- MCP Server Hub：MCP Server Hub 已公开展示 SandBase Harness 条目。
- MCPFly 提交：仓库已被接口接受并等待审核，尚未宣称已有公开 listing
- MCP Central API：公开的 MCP Registry 下游镜像，返回状态为 active 的 io.github.sandbaseai/sandbase-harness 条目；版本快照可能滞后于当前 release。
- MCPVault
- F8W 中文项目档案
- RepoRank 俄语项目档案
- Agent Plugins Hub — 旧版本快照
- MCP Market
- OpenAgentSkill — code-review
- PluginBench
- DSH Plugin Store
- DSH Hub
- dshbase
- FindHarness
- DSH Market
- DSH Plugins
- DSH Plugin Directory
- DSH Plugin Registry
- dsh-market
- dshplugin.dev

近期已核验的社区引用：

- dshbase 已核验插件页
- MCP Repository — 已核验项目页
- DSHarness 101 — 已核验插件雷达条目
- DSH Plugin Leaderboard — 已核验安装条目
- awesome-agent-runtime — 已合并条目
- Awesome Agent Cortex — 已合并条目
- Awesome AI Devtools — 已合并条目
- Awesome Agent Skills — 已合并条目
- WalkingLabs Awesome Harness Engineering — 已合并条目
- awesome-mcp-servers — 已合并 MCP 条目
- Awesome Coding Agents — 已合并 Harness 条目
- Agent Framework Radar — 已核验自动收录
- LLM Agents Radar — 已核验自动收录
- Awesome DSH Plugin — 已核验条目
- Awesome DeepSeek Harness — 已核验条目
- Dominic789654 Awesome DeepSeek Harness — 已核验公开条目
- Zhiyuan-Fan Awesome DeepSeek Harness Plugins — 已核验 Runtime 条目
- Herdeny Awesome DSH Plugins 2026 — 已核验公开条目
- HackSing DSH Plugins — 已核验公开条目
- white0dew Awesome DSH Plugins — 已核验生成条目
- saltbo Awesome Stars — 已核验公开条目
- GitHub Insight Radar — 已核验公开推荐
- Blue-Whale-Harness — 已核验公开目录条目
- DSH Plugin Radar — 已核验自动收录
- Awesome DSH Plugin — 已合并 Harness 条目
- Awesome DeepSeek Harness — 已合并 Runtime 条目
- Awesome Agents — 已合并 Harness 条目
- Awesome AI Engineering — 已合并 Harness 条目
- abordage/awesome-mcp — 已合并 Harness 条目
- Awesome DSH Plugin — 已合并 Harness 条目
- Awesome DeepSeek Harness — 已合并 Harness 条目
- DeepSeek Harness Handbook — 已合并 v0.3.8 bridge 指南

正在等待社区审核：

- NeuraLiying Awesome Agent Harnesses Issue #4 — 建议加入 Production Harnesses、SDKs & Frameworks，已补充 v0.3.8、安装/MCP 来源、可选后端及依赖部署的隔离边界核验（核验说明）
- Acuvity MCP Servers Registry Issue #18 — 建议收录 v0.3.8 GHCR stdio Bridge、六个工具及运行时环境变量，已补充维护者核验与依赖后端的隔离边界（核验说明）
- Nexu Harness Engineering Guide Issue #70 — 建议作为有来源依据的 Runtime 资源，覆盖会话、工具治理、审批、凭证、Memory、产物、审计/回放及可选后端（核验说明）
- EvoMap Awesome Agent Evolution Issue #53 — 已按 Agent Development Platforms 提交，附 v0.3.8、安装、MCP、有状态 Runtime 及依赖后端的隔离证据（核验说明）
- Awesome DeepSeek Harness Top 500 Issue #3 — 建议作为 DSH Runtime/Integration 条目，已补充当前版本、Registry、安装及后端隔离边界证据（核验说明）
- Libukai Awesome DeepSeek Harness Issue #94 — 建议作为区别于 SandBase CLI 的独立 DSH Runtime 条目，已补充 v0.3.8 安装/MCP 及后端证据（核验说明）
- E2B Awesome AI SDKs PR #344 — 已有 canonical Harness 条目，当前可合并；CLA 检查仍需贡献者账号完成
- Awesome MCP Servers PR #13240 — canonical MCP 目录条目的 check-submission 已通过，等待维护者/Glama 审核；旧重复 PR #13188 已关闭
- Sunrisepeak dsh-index PR #43 — 将 SandBase Harness descriptor 从 v0.3.7 更新至 v0.3.8，提交版本的构建与 boot 检查已通过，但当前 PR 需要 rebase
- Awesome AI Agents 2026 PR #240 — 已在 Agent Tooling and Infrastructure 中将 SandBase Harness runtime 与现有 CLI 条目区分收录，等待维护者审核；失败的链接检查仅涉及 PR 之外既有的 ofekron/better-agent 404
- E2B Awesome AI Agents Issue #1468 — 请求将 SandBase Harness 与已关闭的 CLI 提交区分，已补充来源证据，等待目录确认范围
- NipunaRanasinghe Awesome AI Agents PR #184 — 使用目录的动态 star badge 将 SandBase Harness 加入 Core Frameworks，等待维护者审核
- Zients Awesome Agent Harness PR #10 — 已将 SandBase Harness 加入 Agent Systems & Harnesses，等待维护者审核
- McpMux Server Registry PR #286
- Mctrinh Awesome MCP Servers PR #105
- Docker MCP Registry PR #4841 — 已完成验证，等待维护者审核
- HabitoAI Awesome MCP Servers PR #37 — 已加入 Developer Tools，PR 状态干净，等待维护者审核
- MCP Hub / mcpdir issue #20 — 与已有 CLI 条目分开的 Harness 收录申请，等待目录审核
- MCP Server Finder evaluation issue #4 — 已申请独立 MCP bridge 评估，不宣称评分或安全认证
- TensorBlock Awesome MCP Servers issue #2067 — issue 与自动 PR #2068 已关闭，并由已合并的 PR #2060 取代；应使用已合并条目/profile，不要使用不完整的自动元数据（历史修正）
- Awesome Agent-Native Services PR #116 — 已获策展批准并提交 v0.3.8 runtime、MCP、session、approval、credential、audit/replay 证据；PR 可合并但被仓库 gate 阻塞，等待策展方合并（核验说明）
- ToolSDK MCP Registry PR #488 — Schema 与 Biome 检查通过，等待维护者审核
- MCP.Directory 提交 — 已提交，等待目录审核
- Hugging Face agent-harness 注册 PR #2432 — 已修正不应将 MANAGED_AGENTS_HOME 当作身份标记的问题，检查通过，等待维护者合并
- Agent Switchboard 收录 PR #44 — 已提交 v0.3.8 更新条目，等待维护者验证
- Awesome AI Agents 2026 PR #16 — 已将 SandBase Harness 加入 Agent Runtimes and Platforms，等待维护者审核
- Awesome AI Agent Engineering PR #1 — 已将 SandBase Harness 加入 Deployment，等待维护者审核
- AI Native Landscape 提交 #18 — 已提交至 platform-infra / sandboxes-runtimes，等待策展审核
- Agentic Community Landscape PR #2 — 已将 SandBase Harness 加入 Agentic → Runtime，等待维护者审核
- MyMCPTools 目录 Issue #8 — 已提交 v0.3.8 MCP bridge 目录申请，等待维护者审核
- mcp.so/mcpso 提交线程 — 已通过公开 GitHub Issue 流程提交 v0.3.8 MCP bridge，等待目录审核
- Collective AI Tools Issue #332 — 已与现有 CLI 条目分开提交 SandBase Harness，等待目录审核
- Awesome Agent Skills PR #79 — 已将 SandBase Harness 加入 MCP runtime 与 infrastructure，等待维护者审核
- Awesome MCP List PR #409 — 已将 SandBase Harness 加入 AI Agents & Frameworks，等待维护者审核
- Best-of MCP Servers Issue #370 — 已提交至 MCP 服务器排行榜，已补充 v0.3.8 bridge 和当前安装元数据，收录/排名仍待审核
- Awesome Agent Runtimes PR #4 — 已按成熟度门槛提交至 watchlist，并在维护者核验中补充当前 v0.3.8、安装、MCP 和 API 证据，等待审核
- DeepYard 提交 — 已通过公开审核表单提交至 Frameworks & SDKs 分类，等待审核，尚未宣称公开收录
- BotMarket MCP 记录 — 公开 API 当前报告一个来自官方 MCP Registry 的 active 记录（102971）；人工提交队列 4 仍单独跟踪
- Awesome Agent Sandbox PR #2 — 已将 SandBase Harness 加入 Related Projects；Sourcery、GitGuardian 和可合并性检查已通过，仍等待维护者合并（交接说明）
- Awesome Agent Infra PR #6 — 已将 SandBase Harness 加入 Runtime and Control Plane，等待维护者审核
- Awesome CLI Coding Agents PR #314 — 已将 SandBase Harness 加入 Runtime & execution backends，等待维护者审核
- Awesome AI Developer Stack PR #2 — 已将 SandBase Harness 加入 MCP Servers 表格，等待维护者审核
- Awesome Agent Cortex PR #74 — 已将 SandBase Harness 加入 Agent Runtime Infrastructure，等待维护者审核
- Awesome Agent Harness PR #29 — 已将 SandBase Harness 加入 Agent Harness 时间线，PR 状态 clean 且可合并，等待维护者审核（核验说明）
- AutoJunjie Awesome Agent Harness issue #59 — 已申请将 SandBase Harness 加入 Agent Runtimes，已提供当前版本、API、DeepSeek 示例、MCP 镜像及后端依赖隔离说明，等待策展审核（核验说明）
- AgentSpot submission #1 — 已提交 GitHub 源码/发布版本及 GHCR MCP bridge 分发信息，并提供 v0.3.8 安装、MCP、DeepSeek 证据，等待免费目录审核（核验说明）
- Awesome Loop Engineering resource suggestion #23 — 已提交基于源码证据的学习资源建议，覆盖 session、工具治理、approval 与 audit/replay，等待维护者策展（核验说明）
- Best of Agent Harnesses PR #99 — 已按生成式排行目录规范提交 v0.3.8 Harness 条目，PR 可合并，等待维护者审核（核验说明）
- Awesome Agent Harnesses PR #5 — 已将 SandBase Harness 加入 coding-agent harness 目录，PR 状态 clean 且可合并，CodeRabbit 检查成功，等待维护者审核（核验说明）
- Awesome Agentic AI 中文 Stage 7 PR #228 — 已于 1cb0406 合并，作为 #213 的无冲突整合版本；三语条目及 1,036 个脚本/31 个定向检查已通过
- Awesome Terminal Agents PR #5 — 已将 SandBase Harness 作为 Engineering-Practice-Tool 加入终端 Agent 专题，等待维护者审核
- Awesome MCP DevTools PR #13 — 已加入 Proxies and Gateways，并在核验说明补充当前 v0.3.8 与安装/MCP 来源，等待审核
- Awesome MCP Collection PR #39 — 已将 SandBase Harness 加入 Development & Version Control，等待维护者审核
- Awesome MCP Issue #99 — 已请求加入 Aggregators & Gateways，等待维护者审核
- Awesome MCP Gateways PR #77 — 已将 SandBase Harness 加入 Open-source MCP Gateways，等待维护者审核及 CLA 检查
- Awesome AI Harness PR #4 — 已将 SandBase Harness 加入 SDKs & runtimes，等待维护者审核
- Awesome AI Coding Sandboxes PR #15 — 已将 SandBase Harness 加入 Adjacent runtimes，等待维护者审核
- Awesome Agent Infrastructure PR #23 — 已将 SandBase Harness 加入 Execution Sandboxes，等待维护者审核
- Awesome Agent Sandboxing PR #2 — 已将 SandBase Harness 加入 Self-hosted Agent Runtimes，等待维护者审核
- Awesome Sandbox PR #27 — 已新增 SandBase Harness runtime/sandbox 专题章节，等待维护者审核
- Awesome AI Agents Security PR #107 — 已加入 Sandboxing & Isolation Environments，已发布核验跟进，PR 可合并，等待维护者审核
- UCSB Awesome Agent Security PR #16 — 已将 SandBase Harness 加入 System-level Runtime Defense，PR 可合并，等待维护者审核
- Awesome DevOps MCP Servers PR #327 — 已加入 Code Execution，已发布核验跟进，PR 可合并，等待维护者审核
- EverWorks Awesome MCP Servers PR #161 — 已加入 Code Execution & Automation，并在核验说明修正过期文档路径，等待审核
- AIAnytime Awesome MCP Server PR #78 — 已独立于 SandBase CLI 加入 MCP bridge 条目，并在维护者核验修正过期文档路径，等待审核
- Collabnix Awesome MCP Lists PR #105 — 已加入 DevOps & Infrastructure，并在核验说明修正过期文档路径，等待审核
- MCP Finder Awesome MCP Servers PR #9 — 已加入 Cloud and DevOps，并在维护者核验确认当前来源与后端依赖隔离，等待审核
- Awesome AI Agent Tools PR #27 — 已合并独立的 SandBase Harness MCP 目录条目和 Docker stdio 安装元数据
- Enterprise AI Atlas Awesome MCP Servers PR #10 — 已将 SandBase Harness 加入 Developer Tools，并添加 Docker stdio 安装元数据，PR 可合并，等待维护者审核
- Awesome-MCP PR #36 — 已新增带 stdio transport 的结构化 SandBase Harness server 条目，PR 可合并，CI 已通过
- Awesome-MCP PR #36 核验 — 已确认当前 v0.3.8、Registry、运行中 API 与后端隔离边界
- bgizdov Awesome MCP Servers PR #17 — 已在 DevOps 分类新增 JSON 条目及 Docker stdio bridge，PR 可合并，等待维护者审核
- Awesome AI Coding Tools PR #665 — 已加入 MCP Servers and Directories，已发布核验跟进，PR 可合并，等待维护者审核
- Awesome AI Developer Tools PR #11 — 已将 SandBase Harness 加入 DevOps & Deployment，PR 可合并，等待维护者审核
- Pipedream Awesome MCP Servers PR #111 — 已加入 Artificial Intelligence MCP server 列表，已发布核验跟进，PR 可合并，等待维护者审核
- Awesome AI & Developer Tools PR #5 — 已将 SandBase Harness 加入 CI/CD & DevOps，PR 可合并，等待维护者审核
- Awesome AI & Developer Tools PR #5 核验 — 已确认当前版本、bridge 镜像、项目范围与后端隔离边界
- LaunchApp Awesome AI Coding Tools PR #34 — 已将 SandBase Harness 加入 MCP 分类，并标注 self-hosted 与 free/open-source，PR 可合并，等待维护者审核
- LaunchApp Awesome AI Coding Tools PR #34 核验 — 已确认当前 v0.3.8、Registry/镜像引用与依赖后端的 sandbox 边界
- AI Agent Sandboxes PR #3 — 已加入带证据链接的结构化 SandBase Harness 元数据，等待维护者审核
- Awesome Agent Sandbox PR #2 — 已将 SandBase Harness 加入 Self-hosted / Open Source 沙箱表格，等待维护者审核
- Awesome Agent Sandboxes PR #9 — 已将 SandBase Harness 加入 Containers，等待维护者审核
- Awesome Agent Sandboxes PR #9 核验 — 已确认当前 v0.3.8 来源与依赖后端的隔离边界
- Awesome Agent Sandbox PR #4 — 已将 SandBase Harness 加入 Container Sandboxes 及对比表，等待维护者审核
- Awesome Agent Sandboxes PR #59 — 已加入结构化 SandBase Harness 沙箱元数据并重新生成目录文件，等待维护者审核
- MeshKore 目录提交 — 已接受审核，提交编号 #14，公开档案待生成
- Awesome Agentic Open-Source Tools PR #1 — 已加入 Agent Frameworks & Orchestration，等待维护者审核
- awesome-ai-agents-2026 PR #2 — 已加入 Local Runtimes & LLM Management，等待维护者审核
- AgentFirst 目录 PR #46 — 已加入 Compute & Sandboxes，enrichment 检查通过，等待维护者审核
- AI Agent Tools 提交 — 已提交至 MCP Servers 分类，等待目录审核
- MCP Server Finder 评估 Issue #4 — 已请求对 MCP bridge 进行独立质量与安全评估，等待审核
- Agentic DevOps MCP PR #42 — 已加入 Kubernetes & Containers，等待维护者审核
- Awesome DevOps AI PR #54 — 已加入 MCP Servers for DevOps，等待维护者审核
- Awesome Platform Engineering PR #63 — 已加入 Internal Developer Platforms，等待维护者审核
- Awesome DevOps Platform PR #4 — 已加入 AI & Automation in DevOps，等待维护者审核
- Awesome Platform Engineering PR #11 — 已加入 AI Platform Engineering & LLMOps，等待维护者审核
- Awesome LLMOps PR #539 — 由项目申请 #538 自动生成，已加入 Runtime / AI Agent，构建通过，等待维护者审核
- TensorChord Awesome LLMOps PR #785 — 已将 SandBase Harness 加入 LLMOps 目录，DCO 已通过，等待维护者审核
- Awesome-LLMSecOps PR #66 — 已将带来源链接的 SandBase Harness 条目加入 Agentic security，PR 状态干净且可合并，等待维护者审核
- Awesome Agent Runtime Security PR #30 — 已将 SandBase Harness 加入 Sandboxing & Isolation，并明确部署/后端限制，PR 状态干净且可合并，等待维护者审核
- Awesome LLM Security PR #313 — 已将 SandBase Harness 作为运行时治理参考加入 Tools，PR 状态干净且可合并，等待维护者审核
- Awesome AI Agents PR #467 — 现有 AI Agent 资源目录收录申请，已添加单行 SandBase Harness 条目，PR 状态干净且可合并，等待维护者审核
- Jenqyang Awesome AI Agents PR #460 — 按该目录的开源与中性描述规范，将 SandBase Harness 加入 Applications → Tools，PR 状态干净且可合并，等待维护者审核
- Slava Awesome AI Agents PR #403 — AI Agent 目录中已有 SandBase Harness 收录申请，PR 状态干净且可合并，等待维护者审核
- Scottcjn Awesome Agents PR #59 — Agent 平台/框架目录中已有 SandBase Harness 收录申请，PR 状态干净且可合并，等待维护者审核
- Awesome Agent Infrastructure PR #21 — 已加入 Execution Sandboxes，条目已更新至当前 MCP 安装文档，等待维护者审核
- Awesome DevOps PR #30 — 已将 SandBase Harness 加入 MCP 工具目录，DCO 已通过，等待维护者审核
- Awesome Self-Hosted Agents PR #6 — 已将 SandBase Harness 加入 self-hosted agent frameworks 列表，PR 状态 clean，等待维护者审核
- Awesome Agent Infra PR #2 — 已将 SandBase Harness 加入机器可读的 runtime catalog，校验、测试和 lint 均通过，等待维护者审核
- Awesome AI Agents PR #1 — 已将 SandBase Harness 加入 Agent infrastructure，PR 状态 clean，等待维护者审核
- Awesome Agent Operating Systems PR #13 — 已将 SandBase Harness 合并加入 Agent Runtimes，并添加日期验证链接
- Awesome Agent Services PR #8 — 已将 SandBase Harness 加入 Sandboxes & Compute，PR 状态 clean，等待维护者审核
- Awesome AI Automation PR #3 — 已将 SandBase Harness 加入 AI agents & LLM automation，PR 状态 clean，等待维护者审核
- Awesome Best Open Source AI Agents 2026 PR #1 — 已加入包含许可证、语言、Stars、活跃度和 Best-for 元数据的 GitHub 验证条目，PR 状态 clean，等待维护者审核
- Awesome AI Agents — Agent Playbook PR #1 — 已将 SandBase Harness 加入 self-hosted frameworks 列表，PR 状态 clean，等待维护者审核
- Discussion #116 — 官方 DevOps runtime 与 MCP bridge 推广介绍
- DeepSeek Harness Showcase 更新 — 双语介绍 gVisor 集成路径与 Hugging Face 归因修复审核状态
- Cline MCP Marketplace Issue #2364 — v0.3.8 MCP bridge 提交，正在审核；参见维护者核验说明和官方双语更新
- MCPSo 提交 Issue #3834
- Awesome Agent Frameworks 架构提案 #6
- Agent Sandbox Taxonomy 档案提案 #5
- Open-Kairox Awesome Agent Harnesses Issue #1 — 建议加入双语 Agent Harness 列表，已补充 v0.3.8、安装/MCP、Runtime 控制及依赖后端的隔离核验（核验说明）
- Awesome Agent Sandboxes PR #9
- Mossaka Awesome Agent Sandboxes PR #1
- dsh-index PR #43 — 已提交当前 SandBase Harness 描述；提交版本检查通过，但 PR 当前需要 rebase
- AgentIndex issue #3 — 提议加入有来源依据的运行时索引，已补充 v0.3.8、安装/MCP、会话治理、审计/回放及依赖后端的隔离范围（核验说明）
- Agent Harness MCP preset issue #47 — 提议基于已发布 bridge 镜像和六个工具增加 MCP preset，等待项目维护者审核（核验说明）
- Discussion #116 更新 — 发布 v0.3.8 安装与已合并集成状态，邀请用户反馈
- Discussion #116 最新更新 — 公布 Awesome Coding Agents 已合并收录，并重申当前安装入口与 TensorBlock 元数据问题
- Discussion #116 推广更新 — 双语汇总 DeepYard 审核提交与 BotMarket 人工审核队列状态
- Discussion #116 BotMarket 状态修正 — 记录来自官方 Registry 的 active MCP 条目，并与人工队列 4 分开说明
- Discussion #116 TensorBlock 更新 — 公布 TensorBlock MCP 条目已合并及公开 profile，并标注当前 v0.3.8 bridge
- AAE Agent Engineering issue #1 — 已提交至精选 Agent Harness 分类，等待策展审核
- HKUST-KnowComp Awesome Agent Harness Issue #8 — 已提交为源链接 runtime 资源，已补充当前 v0.3.8 证据及依赖后端的隔离边界，等待策展审核
- Picrew Awesome Agent Harness issue #82 — 已在 ddbf183 准备 handbook 条目；因现有 fork 历史不相关，等待维护者应用变更
- Awesome AI Engineering PR #4 — 已于 0a308b0 合并，SandBase Harness 已加入开源 Agent Engineering 项目表
- TensorBlock Awesome MCP Servers PR #2060 — 已于 c88cedf 合并，当前 v0.3.8 bridge 条目可通过 TensorBlock profile 查看
- MCPVault 提交 — 公开提交流程需要 GitHub 登录；正常提交返回 401 not_signed_in，因此当前不宣称已有收录
- Awesome Agentic MCP Security PR #28 — 已加入 MCP hosting/runtime，完成 v0.3.8 核验；GitHub 当前为 UNSTABLE
- RoyalPinto Awesome MCP Security PR #4 — 已加入 permission 分类，完成 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核
- Awesome AI Developer Tools PR #11 — 已加入 DevOps & Deployment，并核验当前 Registry/GHCR 与 v0.3.8，等待维护者审核
- LAS-WG Awesome Agent Infrastructure PR #10 — 已加入 Open-Source Projects，并完成 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核
- Awesome Agent Skills PR #79 — 已加入 MCP runtime/infrastructure，完成 v0.3.8 核验；GitHub 当前为 UNSTABLE
- Awesome MCP List PR #409 — 已加入 AI Agents & Frameworks，完成 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核
- Awesome Agent Sandboxes PR #59 — 已加入生成式 sandbox 目录并刷新输出，明确非普适、依赖后端的隔离范围，等待维护者审核
- Awesome Agent Sandbox PR #2 — 已加入 self-hosted sandbox 条目并完成 v0.3.8 来源核验，等待维护者审核
- Awesome Agent Sandbox PR #4 — 已加入容器 sandbox 条目并核验依赖后端的隔离边界，等待维护者审核
- Awesome CLI Coding Agents PR #314 — 已加入 Runtime & execution backends，完成 v0.3.8 来源核验，等待维护者审核
- Awesome Terminal Agents PR #5 — 已加入 Engineering-Practice-Tool runtime 参考，完成 v0.3.8 核验，等待维护者审核
- Awesome AI Agents 2026 PR #16 — 已加入 agent runtimes/platforms，完成 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核
- Awesome Agent Infra PR #6 — 已加入 Runtime and Control Plane，完成 v0.3.8 来源核验；GitHub 当前为 UNSTABLE，等待维护者审核
- Curated MCP Servers PR #9 — 已加入 Developer Tools & Infrastructure，并完成 v0.3.8 来源核验，等待维护者审核
- Awesome Agent Runtimes PR #1 — 已加入 runtime 对比表，补充 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核
- AI Agent Infrastructure List PR #4 — 已新增中英文 Runtime 条目并核验当前 v0.3.8，等待维护者审核
- Skyming Awesome AI Agent PR #19 — 已新增中文 runtime 条目并补充 v0.3.8 来源核验，等待维护者审核
- Awesome Agent Harness PR #58 — 已加入 Agent Runtimes，披露维护者关系并完成事实核验，等待维护者审核
- Awesome Agent Security PR #10 — 已加入 Sandboxed Execution，并明确目录收录不等于安全认证，等待维护者审核
- DevInsight Awesome MCP PR #6 — 已加入 MCP Servers，补充当前 v0.3.8 与依赖后端的隔离边界核验，等待维护者审核

这些页面由独立目录维护；仓库源码和 release metadata 仍是项目事实来源。

在 Codespaces 中试用

Open in GitHub Codespaces

仓库内置的开发容器会自动安装依赖并构建运行时。终端准备完成后，在转发端口上启动服务：

node dist/index.js start --host 0.0.0.0

打开转发的 SandBase Harness Console 端口，然后在 Settings > Models
中配置模型。GitHub 可能会对 Codespaces 用量计费；下方的本地快速开始仍然免费，
并会把全部运行时数据保存在你的机器上。

核心能力

- Claude Managed Agents 风格的 /v1 API 和本地 Console
- SQLite 会话、Agent、Memory、Skill、文件、凭证和 API Key 元数据
- 可恢复的 Server-Sent Events 与会话事件回放
- OpenAI、Anthropic、MiniMax 和 OpenAI-compatible 模型边界
- Local、Docker、Kubernetes 和自托管 Worker 沙箱
- MCP Toolset、权限策略、内置工具和 Skill Package
- DeepSeek Harness 原生 stdio MCP Bridge
- TypeScript SDK：managed-agents/sdk
- 发布门禁：npm run release:check

从源码启动

npm 上未加 scope 的 managed-agents 不是本项目。请使用带标签的
GitHub 源码，不要运行 npx managed-agents 或 npm install managed-agents。

~~~bash
git clone --branch v0.3.8 --depth 1 https://github.com/sandbaseai/sandbase-harness.git
cd sandbase-harness
npm ci
npm run build

mkdir ../my-agents && cd ../my-agents
node ../sandbase-harness/dist/index.js init
node ../sandbase-harness/dist/index.js start
~~~

打开 http://127.0.0.1:3000/dashboard，进入 Settings > Models，
配置模型 API Key 后即可创建 Agent 和会话。

接入 DeepSeek Harness

先构建固定版本源码并启动 Runtime：

~~~bash
git clone --branch v0.3.8 --depth 1 https://github.com/sandbaseai/sandbase-harness.git
cd sandbase-harness
npm ci
npm run build:runtime

mkdir ../my-agents && cd ../my-agents
node ../sandbase-harness/dist/index.js init
node ../sandbase-harness/dist/index.js start
~~~

另开终端，把插件安装到 DSH Web Profile：

~~~bash
export MANAGED_AGENTS_URL=http://127.0.0.1:3000
仅在 Runtime 开启认证时设置 MANAGED_AGENTS_API_KEY
从上面创建的 my-agents 目录运行，直接安装固定源码，不解析 npm 同名包
dsh plugin --profile web add -w ../sandbase-harness
Git URL 备选。保持 HTTPS，不要改成 SSH。
dsh plugin --profile web add git+https://github.com/sandbaseai/sandbase-harness.git
dsh web
~~~

如果 Plugin Hub 在重复或半途失败的安装后提示
already installed: managed-agents，请先更新 Hub，再只移除已显示的
managed-agents 插件条目，然后使用带标签的 HTTPS Git 源重试：

~~~bash
dsh plugin --profile web update dsh-plugin
dsh plugin --profile web remove managed-agents
dsh plugin --profile web add git+https://github.com/sandbaseai/sandbase-harness.git
~~~

这是 Plugin Hub 的重复安装路径问题，不是 npm 安装路径。如果已安装列表
显示了不同的目标标识，就只移除列表中显示的精确标识。运行成功前请保留
profile 目录和诊断证据；详见已报告的恢复 Issue。

Git 安装需要额外一步 pnpm 构建白名单。第一次 add 会以
ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 失败，并打印对应的精确 key；把该 key
加到 profile 的 pnpm-workspace.yaml 的 allowBuilds: 下，然后重新运行同一条
add 命令。裸包名无法匹配 git-hosted 解析：

~~~yaml
allowBuilds:
"managed-agents@https://codeload.github.com/sandbaseai/sandbase-harness/tar.gz/": true
~~~

第二次运行会通过 prepare 构建 dist/，创建 managed-agents /
managed-agents-mcp 可执行入口，并挂载 Bundle 层。

DSH 随后可以通过原生 MCP Namespace：

- 列出 Agent
- 创建和运行持久化会话
- 读取会话状态和产物
- 停止正在运行的任务

完整工具列表、兼容性证据、权限边界和卸载方法见
DeepSeek Harness 集成指南。

如果希望从 DSH 开始，按步骤加入这个第三方 Runtime 插件，请阅读
DeepSeek Harness 开发者指南。

官方社区展示：
DeepSeek Harness Discussion #1918。

也可以直接阅读 Handbook 的 SandBase Harness bridge 专题，
查看 DSH 集成契约、验证步骤和常见故障边界。

相关实践：构建可审计的 Research Agent：证据账本、沙箱与回放。
文章展示如何将证据账本、沙箱执行、凭证、审计和回放组合到 SandBase Harness 工作流中。

该文档之外，也可以阅读已更新到 v0.3.8 的中文 DeepSeek Harness 开发者指南，以及英文版本。

添加可移植研究 Skill

在同一个 DSH 项目根目录安装无需 SandBase 账号的 multi-source-search：

~~~bash
npx --yes github:sandbaseai/sandbase-skills add multi-source-search
dsh web
~~~

安装器会把完整 Skill 写入 DSH 的项目级发现目录
.dsh/skills/multi-source-search。当 DSH 已提供网页搜索和页面读取工具时，
该 Skill 不需要 SandBase API。

工作区结构

~~~text
my-agents/
├── agents/                  # YAML Agent 定义
├── skills/                  # 启动时导入的 Skill
└── .managed-agents/         # Runtime 状态（应加入 gitignore）
├── config.yaml
├── data.db
├── logs/
├── files/
├── skills/
├── snapshots/
└── sandbox/
~~~

安全边界

- API Key 应只通过环境变量或受控配置传入，不要写入 Prompt 或提交到 Git。
- 默认 Local Sandbox 以当前操作系统用户执行命令，适合可信开发环境。
- 需要更强隔离时使用 Docker 或 Kubernetes Sandbox。
- DSH MCP 子进程只连接 MANAGED_AGENTS_URL，有效权限由
MANAGED_AGENTS_API_KEY 决定，Bridge 不持久化凭证。

安全问题请使用仓库的
Security 页面，
不要在公开 Issue 中附带 API Key、工作区数据或会话产物。

文档

- 机器可读项目元数据
- Agent / MCP 安装指南
- 安装
- 使用指南
- API
- Skill
- 部署示例
- DeepSeek V4
- MiniMax
- 系统设计

开发与验证

~~~bash
npm ci
npm run typecheck
npm test
npm run build
npm run release:check
~~~

项目采用 Apache-2.0 许可证。欢迎通过
Issues 和
Discussions
反馈问题、分享集成经验或参与贡献。

引用信息见 Citation metadata。推广入口和审核状态见推广状态台账；可复用的事实型
推广联系模板供维护者发送给人工审核渠道。