推荐使用 DistributedStore 一键配置——它同时覆盖 AgentStateStore、BaseStore、SandboxSnapshotSpec、SandboxExecutionGuard。如果只需要单独配置 AgentStateStore，继续阅读本页。
io.agentscope.core.state.AgentStateStore 是 AgentScope 用来持久化 Agent 状态的接口——比如 Memory、Workspace、Plan 等组件都会被序列化为 State 后由 AgentStateStore 落盘，从而支持重启恢复、跨节点共享。
状态通过 (userId, sessionId) 二元组寻址：
sessionId——非空、非空白，标识一次会话 / session。userId——可空。null表示匿名 / 单租户调用方（CLI、测试等）。
AgentStateStore 与 Thread 日志
本页是AgentStateStore 接口参考。启用日志时，HarnessAgent 通过
ThreadJournalStore 恢复；只替换 stateStore 不会迁移或共享 Thread 日志。主 Thread
会读取 AgentScope 2.0 写入的状态，并在 checkpoint 提交后将最新状态镜像回 2.0 的
agent_state 位置，以支持回滚读取；命名 Thread 使用独立状态项。Workspace 的
BaseStore 能保存文件，也不等于具备日志要求的 CAS 和 writer fencing。详见
Thread 执行日志与恢复。