PinnedSandboxFilesystem
public final class PinnedSandboxFilesystem extends SandboxBackedFilesystemio/agentscope/harness/agent/filesystem/sandbox/PinnedSandboxFilesystem.java:34–45Pinned 沙箱文件系统，承载智能体的部署、调度与服务化运行。位于 io.agentscope.harness.agent.filesystem.sandbox 包，继承自 SandboxBackedFilesystem。核心成员包括 clearSandboxIfCurrent、PinnedSandboxFilesystem。
SandboxBackedFilesystem that holds a fixed Sandbox reference for the lifetime of
the instance.
Used by asynchronous session mirrors so uploads can complete after the agent call releases
its per-call binding on the shared agent proxy. Unlike the agent-level SandboxBackedFilesystem, #clearSandboxIfCurrent is a no-op — clearing the call proxy
must not unpin this mirror filesystem.
Safe for DataAgent-style user-managed sandboxes that stay alive across acquire/release. Self-managed sandboxes that stop on release may still fail if the async upload races past shutdown.
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public PinnedSandboxFilesystem(Sandbox sandbox) | 初始化 `PinnedSandboxFilesystem` 实例。 Creates a new instance. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public synchronized void clearSandboxIfCurrent(Sandbox expected)synchronized | 清空沙箱 If 当前。 Clears the sandbox if current. |
构造器详情Constructor Detail
PinnedSandboxFilesystem
public PinnedSandboxFilesystem(Sandbox sandbox)初始化 PinnedSandboxFilesystem 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sandbox | Sandbox | 沙箱（类型 `Sandbox`）。The sandbox. |
io/agentscope/harness/agent/filesystem/sandbox/PinnedSandboxFilesystem.java:36–39方法详情Method Detail
clearSandboxIfCurrent
public synchronized void clearSandboxIfCurrent(Sandbox expected)清空沙箱 If 当前。
Clears the sandbox if current.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
expected | Sandbox | expected（类型 `Sandbox`）。The expected. |
io/agentscope/harness/agent/filesystem/sandbox/PinnedSandboxFilesystem.java:41–44