用途：管理 OpenDeploy 用户服务的持久卷，使数据在容器重启和重新部署后不丢失。适用于保留 SQLite、持久化上传文件等场景；不适用于构建/端口配置、托管数据库、环境变量与密钥，对象存储暂未作为 OpenDeploy 托管资源提供。
主要能力与命令：列出卷 opendeploy volumes list --service <id> --json；添加 opendeploy volumes add --service <id> --name <name> --mount <path> --size <size> --json；仅扩容 opendeploy volumes resize <volume-id> --size <newSize> --json；软删除（卸载）opendeploy volumes detach <volume-id> --json；恢复 opendeploy volumes restore <volume-id> --json；强制删除 opendeploy volumes delete <volume-id> --force --json。若 volumes 命名空间不可用，可回退到 API，如 opendeploy api get /v1/services/<id>/volumes --json。
限制：存储为节点本地 local-path，单副本、单挂载，无 HA 与跨节点共享；v1 无备份或快照，需自行备份；仅支持扩容不支持缩容；卷存在时副本被固定为 1；请求体字段为 size，值为 5Gi 这类 Kubernetes 数量字符串。操作前会要求结构化确认。
错误处理：如 400 cannot_shrink、403 quota_exceeded、409 duplicate_name、410 orphan_expired、501 volume_workflow_not_wired 等需按返回原样说明，不静默重试。
其余细节和 CLI 版本预检等内容，资料中已有说明，此处不逐条展开。