Files
AgentLab/backend/app/sandbox/manager.py
T
ThearchyHelios 03c18c4d78 界面文案整改:口语改书面、术语统一、不再露出实现细节;修掉几处说错的提示;新增文案检查防回潮
一、文案(前端约 1600 处,后端传到界面的约 880 处)
- 术语统一:工作流层面用「运行」(继续运行、重新运行、试运行),节点和工具层面用「执行」,不再用「跑」;
  总时长 / 执行时长 / 等待审批;服务端;助手;Agent;token;工作流;固定版本;模型接入;系统提示;批准 / 驳回;受管级别
- 口语改书面:取不到、没取回来、读不懂、连不上、多半、照样、兜底、揉成这类说法改成「无法 / 未能 / 失败 / 请」;去掉拟人写法
- 不再露出实现细节:界面上不写 checkpoint、同一拍、哈希(凭证处除外),不写改版历史(「以前…」「老数据」);
  报错、校验、门禁、自动修复里裸写的配置键名和枚举值换成界面上的中文标签,由新的 backend/app/engine/labels.py 统一提供;
  发布弹窗里结论句的选项不再是 off / require_citation
- 同一件事只留一种说法:生成阶段文案、出具档位说明、画布锁定提示各合成一份
- 去掉界面上的工业场景示例(MES、ERP、「张工」「王工」)和真实产品名,换成通用示例

二、说错的提示(都有测试证明)
- 数据库测连接失败时的专用提示以前从不出现(按报错文字全等比较,永远比不上):改为按错误类型判断,不再拼出重复的前缀
- 「设置 → 供应商」改指「设置 → 模型接入」;「在设置里建数据源」改指「数据」页
- 缺少 API Key、模型接入已停用的报错不再夹英文,写明去哪里填
- 两处原因说错(「这种引用在后续版本支持」「这一版还不支持」)改成真实原因
- 节点说明里不准确的说法改正:代码节点在 microVM 或系统沙箱中执行;报告撰写、口径卡的说明不再说过头
- 导出的证据 CSV 里两列同名,第三列改为「片段编号」

三、前后端对齐
- 前端按后端原文识别日志、报错的地方,新旧两种写法都认得(历史运行里存的是旧文字),逐条补了新旧原文的核对
- 后端交回模型的原指令放进单独的 for_model 字段,前端在解析响应时去掉,不会显示到界面上

四、检查
- 检查脚本里按原文匹配的断言改成新文案;改完会变成永远成立的反向断言逐条修正,并做了变异验证
- 新增 check-copy(静态扫描前端界面字符串和后端上界面的文案):再出现「跑」「后端」「多半」「令牌」、
  界面上的 Copilot、裸写的配置键名、半角标点等就报错;确需保留的写进 scripts/copy-allow.json 并注明理由
2026-09-30 08:05:15 +08:00

225 lines
8.8 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
from __future__ import annotations
import asyncio
import sys
from typing import Any
from app.core.config import settings
from app.sandbox.base import ExecResult, Sandbox, SandboxLimits
from app.sandbox.bubblewrap_sandbox import BubblewrapSandbox
from app.sandbox.local_sandbox import LocalSandbox
from app.sandbox.microvm_sandbox import MicroVMSandbox
from app.sandbox.seatbelt_sandbox import SeatbeltSandbox
class DisabledSandbox(Sandbox):
name = "off"
async def run(self, code: str, **kwargs: Any) -> ExecResult: # type: ignore[override]
return ExecResult(
ok=False,
backend=self.name,
error="沙箱已在设置中关闭(AGENTLAB_SANDBOX_BACKEND=off)",
)
async def health(self) -> dict[str, Any]:
return {"backend": self.name, "available": False, "isolated": False, "reason": "已关闭"}
# 按隔离强度从高到低排,auto 模式挑第一个能用的。
# microVM 排在最前:它是唯一能真正限住内存、隔离进程表的一档。
_BACKENDS: list[tuple[str, type[Sandbox]]] = [
("microvm", MicroVMSandbox),
("bubblewrap", BubblewrapSandbox),
("seatbelt", SeatbeltSandbox),
("local", LocalSandbox),
]
class SandboxManager:
"""挑选并持有代码执行后端。
隔离强度从高到低:microVM(独立内核,限额真实生效)→ bubblewrap / Seatbelt
(共享内核的访问控制)→ 裸子进程。
auto 模式挑第一个**已就绪**的,判断比 available() 更严:microVM 还要求
OCI 镜像已经拉到本地(实测首次拉取约 55s)。所以镜像没缓存的机器会安静地
用 Seatbelt,而不是让第一次跑代码的人干等一分钟;拉过一次之后 auto 就会
自动升到 microVM,不用改配置。
显式指定(配置写死 microvm,或节点选了 strict 档)不受这条限制——
那是使用者自己要的硬隔离,该等就等。
"""
def __init__(self) -> None:
self._backend: Sandbox | None = None
self._named: dict[str, Sandbox] = {} # 按名字缓存,供节点级档位使用
self._lock = asyncio.Lock()
self._resolved_from: str = ""
self._reaper: asyncio.Task[None] | None = None
async def get(self, prefer: str | None = None) -> Sandbox:
"""取后端。prefer 指定档位时给那一档,拿不到就退回默认那台。
节点级的"隔离档位"走这条路:strict 要硬件隔离、fast 要低延迟,
而整机默认仍由 auto 决定。
"""
if prefer:
resolved = self._resolve_named(prefer)
if resolved is not None:
return resolved
if self._backend is not None:
return self._backend
async with self._lock:
if self._backend is not None:
return self._backend
self._backend = self._resolve()
self._named[self._backend.name] = self._backend
return self._backend
def _resolve_named(self, prefer: str) -> Sandbox | None:
"""按档位名取一个**已就绪**的后端;不可用时返回 None 让调用方退回默认。"""
# 关掉就是关掉。这条必须在最前面:否则配置里 off 只挡得住默认路径,
# 图里任何一个 isolation=strict 的代码节点照样能跑代码,
# DisabledSandbox 那句"沙箱已在设置中关闭"根本到不了。
if (settings.sandbox_backend or "auto").lower() == "off":
return None
# 只认这两个档位。以前是 alias.get(prefer, prefer) 原样透传,而 isolation
# 是图 JSON 里的自由字符串,于是图里写 isolation="local" 就能点名那个
# 明说了"没有任何访问控制"的兜底后端——档位是用来提高隔离的,不该能降级。
alias = {"strict": "microvm", "fast": "seatbelt" if sys.platform == "darwin" else "bubblewrap"}
name = alias.get(prefer)
if name is None:
return None
if name in self._named:
return self._named[name]
impl = dict(_BACKENDS).get(name)
if impl is None or not getattr(impl, "available", lambda: True)():
return None
backend = impl()
self._named[name] = backend
return backend
def _resolve(self) -> Sandbox:
choice = (settings.sandbox_backend or "auto").lower()
if choice == "off":
self._resolved_from = "配置为关闭"
return DisabledSandbox()
named = dict(_BACKENDS)
if choice in named:
impl = named[choice]
backend = impl()
available = getattr(impl, "available", lambda: True)()
self._resolved_from = (
f"配置指定 {choice}" if available
else f"配置指定 {choice},但当前环境不可用"
)
return backend
for name, impl in _BACKENDS:
if not getattr(impl, "available", lambda: True)():
continue
# auto 模式额外要求"开箱即用":microVM 镜像没拉过就先跳过
warm = getattr(impl, "image_ready", None)
if warm is not None and not warm():
self._resolved_from = f"{name} 可用但镜像未缓存,自动选择时暂不使用"
continue
self._resolved_from = f"自动选择 {name}({_why(name)})"
return impl()
self._resolved_from = "没有可用的隔离方式,已降级为本地子进程"
return LocalSandbox()
async def run(
self,
code: str,
*,
language: str = "python",
limits: SandboxLimits | None = None,
session_id: str | None = None,
env: dict[str, str] | None = None,
files: dict[str, str] | None = None,
backend: str | None = None,
) -> ExecResult:
impl = await self.get(backend)
return await impl.run(
code,
language=language,
limits=limits,
session_id=session_id,
env=env,
files=files,
)
async def start_reaper(self) -> None:
"""起一个后台任务定期回收闲置会话。
以前回收只挂在 run() 里,也就是说"没人再跑代码"时闲置的 microVM
永远不会被收掉,microvm_idle_seconds 形同虚设——几百 MB 一台就这么
挂着。回收本来也不该占着请求路径的时间。
"""
if self._reaper is not None:
return
async def _loop() -> None:
interval = max(30, settings.microvm_idle_seconds // 4)
while True:
try:
await asyncio.sleep(interval)
for impl in list(self._named.values()) + ([self._backend] if self._backend else []):
reap = getattr(impl, "_reap_idle", None)
if reap is not None:
await reap()
except asyncio.CancelledError:
raise
except Exception: # noqa: BLE001 - 回收失败不该让任务停掉
continue
self._reaper = asyncio.create_task(_loop())
async def health(self) -> dict[str, Any]:
backend = await self.get()
info = await backend.health()
info["selected_because"] = self._resolved_from
info["configured"] = settings.sandbox_backend
info["defaults"] = SandboxLimits().model_dump()
info["candidates"] = [
{
"name": name,
"available": getattr(impl, "available", lambda: True)(),
# 可用但没预热的(microVM 镜像未拉取)要单独标出来:
# 它不会被 auto 选中,但显式指定仍然能用
**({} if getattr(impl, "image_ready", None) is None
else {"warm": impl.image_ready()}),
}
for name, impl in _BACKENDS
]
return info
async def cleanup(self, session_id: str) -> None:
# 会话可能落在任意一档上(节点各自选了档位),全部清一遍
for impl in {id(b): b for b in [*self._named.values(), self._backend] if b}.values():
await impl.cleanup(session_id)
async def close(self) -> None:
if self._reaper is not None:
self._reaper.cancel()
self._reaper = None
for impl in {id(b): b for b in [*self._named.values(), self._backend] if b}.values():
await impl.close()
def _why(name: str) -> str:
return {
"microvm": "microsandbox 运行时已就绪,独立内核",
"seatbelt": "macOS 自带 sandbox-exec(microVM 未就绪)",
"bubblewrap": "检测到 bwrap",
"local": "无可用隔离原语",
}.get(name, "")
sandbox_manager = SandboxManager()