PolarDB Agent LakeBase 目录克隆（Clone）

通过OpenAPI执行Clone

OpenAPI方式无需挂载，直接指定源路径与目标路径即可发起Clone，适合在Agent调度、自动化编排等服务端场景中使用。

执行Clone：ClonePolarFsBasicSnapshot - 克隆文件。

通过命令行工具执行Clone

curl -o lakebase-client https://lakebase-client.oss-cn-beijing.aliyuncs.com/lakebase-client-latest
chmod +x lakebase-client

lakebase-client clone <SRC> <DST>

lakebase-client clone /mnt/pfs/templates/project-base /mnt/pfs/project-x

版本管理与状态回滚

Agent在多轮任务中不断修改工作空间，需要在关键节点保存可回退的版本。通过Clone为工作空间目录创建秒级快照，即可在后续误操作或需要对比时回到任意历史版本。由于Clone仅复制元数据、不占用额外存储，可以低成本地为每个重要节点留存快照。

# 在关键节点为工作空间打一份快照
lakebase-client clone /mnt/pfs/agents/agent-x/workspace /mnt/pfs/agents/agent-x/snapshots/v1

工作空间快速初始化（模板克隆）

新Agent上线时需要快速准备工作环境，例如项目模板、Skill文件、预装依赖等。将预先构建好的模板目录Clone给新Agent，即可秒级完成初始化。仅复制元数据、无需拷贝实际数据，大幅降低启动延迟与存储开销。

# 由模板秒级初始化新Agent的工作空间
lakebase-client clone /mnt/pfs/templates/agent-base /mnt/pfs/agents/agent-x

公共依赖 + 运行时额外安装

存在一套常用的依赖包集合（如node_modules），但各Agent在运行期还要各自安装额外的包，且改动需相互隔离。此时使用Clone：由模板工程Clone出独立副本，公共依赖与基座共享、不重复占用存储，且各Agent在副本上安装增量时，只有新增或改动的部分写入新数据块，互不影响。

操作步骤：

1. 管理员构建模板工程（一次性操作）。

   lakebase-client mount <META_URL> <MOUNT_POINT>
   mkdir -p <MOUNT_POINT>/shared/npm-template/v1
   cd <MOUNT_POINT>/shared/npm-template/v1 && npm install next ...
   lakebase-client umount <MOUNT_POINT>

2. Agent以--subdir挂载后Clone模板工程。由于Agent以--subdir挂载、看不到位于subdir之外的模板目录，Clone有两种执行方式：

   1. 方式一：通过OpenAPI执行Clone

      直接通过ClonePolarFsBasicSnapshot - 克隆文件指定源路径与目标路径完成Clone。

   2. 方式二：先Bind进来，再本地Clone

      lakebase-client mount <META_URL> <MOUNT_POINT> --subdir /agents/agent-x \
          --bind /shared/npm-template/v1:/agents/agent-x/.npm-template
      lakebase-client clone <MOUNT_POINT>/.npm-template <MOUNT_POINT>/project-x

      说明

      Clone的是整个模板工程目录，而不仅是node_modules，否则后续npm install无manifest可用。

3. Agent在Clone出的副本上安装额外依赖。

   cd <MOUNT_POINT>/project-x && npm install <额外包>