mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-20 19:11:59 +00:00
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 并注明理由
225 lines
8.8 KiB
Python
225 lines
8.8 KiB
Python
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()
|