本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

sandbase-harness

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add --allow-build=managed-agents github:sandbaseai/sandbase-harness

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

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

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装这个插件后我需要额外启动什么服务吗？

需要。插件本身只是把 managed-agents-mcp 桥接进程注册进 DSH Web Profile，你必须先在另一台终端用 managed-agents start 启动底层运行时（默认监听 http://127.0.0.1:3000），DSH 才能通过 MCP 工具访问到 Agent 和会话。

这个插件和 DSH 官方的 AI 能力是什么关系？

它是一个独立的本地 Agent 运行时（基于 SQLite + 多沙箱后端），不是 DSH 内置模型的替代品。DSH 通过 mcp__sandbase__* 命名空间把它当作外部 MCP 服务调用，由它去调度 OpenAI、Anthropic 或任意 OpenAI 兼容端点。

会话、产物、凭证这些数据存在哪里？

全部存在你 managed-agents init 时创建的工作区下的 .managed-agents/ 目录中（SQLite 文件 data.db、文件字节 files/、技能包 skills/、沙箱快照 snapshots/）。Bridge 进程不持久化任何凭证。

支持哪些模型供应商？

Settings V2 里配置一个活跃的模型供应商边界，覆盖 OpenAI、Anthropic 以及任何 OpenAI 兼容端点（README 中以 DeepSeek V4 为例）。Agent YAML 里指定具体模型 ID（如 gpt-4o、claude-sonnet-4-20250514、openai/gpt-5.5）。

必须装 Docker 才能用吗？

不是。默认 Local 沙箱就用当前操作系统用户执行命令，不依赖 Docker。只有当你在 Dashboard 里把 Environment 的沙箱后端切到 docker 或 kubernetes 时才需要 docker CLI 或 kubectl 可用。

如何卸载？

先停掉 DSH，然后执行 dsh plugin --profile web remove managed-agents，即可同时移除 profile 依赖和 bundle 注入层。运行时的工作区数据不会自动删除，需要手动清理 .managed-agents/ 目录。

启动时报 "MCP startup failed" 怎么办？

说明 managed-agents-mcp 不在 PATH 上。重新走一次源码构建（npm ci && npm run build:runtime）并执行 npm link，或在 DSH 启动日志里确认是否看到 mcp-sandbase-harness 节点。

报 401 或 403 错误怎么排查？

这是运行时认证没对上。检查环境变量 MANAGED_AGENTS_API_KEY 是否与 Runtime 端配置的 API Key 一致，没有认证的 Runtime 默认是开放的（不需要这个变量）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则