ecloud-eos

移动云 EOS 技能通过 Node.js SDK 脚本管理移动云对象存储。

首次使用 — 自动设置 当用户首次要求操作 EOS 时，按以下流程操作：

步骤 1：检查当前状态 检测操作系统并运行相应的检查脚本： Windows 系统： {baseDir}\scripts\setup.ps1 -CheckOnly Linux/macOS 系统： {baseDir}/scripts/setup.sh --check-only 检查脚本会验证以下内容： 基础环境：Node.js 和 npm 是否已安装 Node.js SDK：相关 Node.js SDK 依赖是否已安装 环境变量配置：检查以下环境变量是否已设置且有值： EOS_ACCESS_KEY — 移动云对象存储 API 密钥 ID EOS_SECRET_KEY — 移动云对象存储 API 密钥 Key EOS_REGION — 存储桶区域 EOS_BUCKET — 存储桶名称 EOS_ENDPOINT — 存储桶公网域名 判断标准： 所有检查项都显示 OK：配置已完成，可以直接使用 EOS 操作 部分环境变量缺失但可继续操作：如果仅缺失 EOS_BUCKET，仍可执行部分操作： list-buckets（列出所有存储桶） create-bucket（创建新存储桶，需要手动指定桶名） delete-bucket（删除存储桶，需要手动指定桶名） 其他环境变量缺失：进入步骤 2，引导用户配置

如果输出显示一切 OK（Node.js SDK 已安装、环境变量已配置），跳到「执行策略」。

步骤 2：如果未配置，引导用户提供凭证 方式一：直接提供凭证信息 我需要您的移动云凭证来连接 EOS 存储服务。请提供： AccessKey — 移动云对象存储 API 密钥 ID SecretKey — 移动云对象存储 API 密钥 Key Region — 存储桶区域 Bucket — 存储桶名称 Endpoint — 存储桶公网域名 您可以参考移动云控制台-首页订购对象存储。 您可以参考移动云控制台-创建认证信息获取 AK/SK 认证信息。 您可以参考移动云控制台-地域和访问域名获取最新的地域和域名信息。 方式二：使用配置文件 告诉用户：您也可以提供一个配置文件，包含凭证信息。配置文件格式如下：

accessKey=your-access-key
secretKey=your-secret-key
region=anhui1 # 请根据最新地域列表选择合适的 region
bucket=your-bucket-name
endpoint=https://eos-anhui-1.cmecloud.cn # 请根据最新地域列表选择对应 endpoint

配置文件模板位于：references/config_template.properties 请将配置文件路径提供给我，我会使用它来设置环境。

步骤 3：用户提供凭证后，运行自动设置 方式一：使用命令行参数 Windows 系统： {baseDir}\scripts\setup.ps1 -AccessKey "" -SecretKey "" -Region "" -Bucket "" -Endpoint "" Linux/macOS 系统： {baseDir}/scripts/setup.sh --access-key "" --secret-key "" --region "" --bucket "" --endpoint "" 方式二：使用配置文件 Windows 系统： {baseDir}\scripts\setup.ps1 -CopyConfigFile "" Linux/macOS 系统： {baseDir}/scripts/setup.sh --copy-config-file "" 脚本会自动： 检查并安装 Node.js SDK（如果未安装） 从配置文件读取凭证并设置环境变量 验证 EOS 连接 重要说明： 您提供的配置文件不会被修改 环境变量会持久化保存（Windows 设置为 User 级别，Linux/macOS 写入 shell 配置文件） 重新打开终端后无需重新设置，新会话会自动使用这些环境变量 agent 必须更新自己的 process.env：调用 setup.ps1 后，agent 应该根据传递的参数更新自己的 process.env，以便后续子进程能够读取到最新的环境变量：

// agent 更新自己的 process.env
process.env.EOS_ACCESS_KEY = accessKey;
process.env.EOS_SECRET_KEY = secretKey;
process.env.EOS_REGION = region;
process.env.EOS_BUCKET = bucket;
process.env.EOS_ENDPOINT = endpoint;

步骤 4：执行策略 配置完成后，按照以下策略执行 EOS 操作： 检查配置状态：每次执行 EOS 操作前，先运行环境检查脚本确认配置正常 直接执行操作：确认配置正常后，直接执行相应的 EOS 操作命令 环境变量管理： 所有操作凭证从环境变量读取 切换桶操作通过 setup 脚本更新环境变量 环境变量已持久化，新会话会自动使用 方式一：Node.js SDK 脚本 官方文档：https://ecloud.10086.cn/op-help-center/doc/outline/56247 通过 scripts/eos_node.mjs 执行存储操作。凭证从环境变量读取。 常用命令 以下省略 node {baseDir}/scripts/eos_node.mjs 前缀。完整格式：node {baseDir}/scripts/eos_node.mjs [options] list-buckets # 列出所有存储桶 create-bucket --bucket my-new-bucket # 创建桶（需要手动指定桶名） delete-bucket --bucket my-old-bucket # 删除桶（需要手动指定桶名，注意：桶必须为空才能删除） empty-bucket --bucket my-bucket --confirm # 清空桶（删除桶内所有文件，高危操作，必须使用 --confirm 参数确认） generate-url --key remote/path/file.jpg # 生成文件共享外链（默认过期时间 3600 秒） generate-url --key remote/path/file.jpg --expires 7200 # 生成文件共享外链（自定义过期时间，单位：秒） 所有命令输出 JSON 格式，success: true 表示成功，退出码 0。

图片处理说明 图片处理扩展能力见下方“图片处理能力（新增）”