本项目实践管理效果如下：

前言：用 AI Agent 管云存储，这件事的"为什么"比"怎么做"更重要

1. 痛点不是技术问题，是工作流问题

COS 控制台能做的事太多了：上传文件、管理文件夹、设置生命周期规则、配置 CDN……
所以我非常喜欢腾讯云的COS云存储！只需要登录腾讯云控制台在对象存储中就能找到。

但对应游戏资源存储来说，关键不在于"能不能做"，而在于"做完之后还需要多少人工介入"。
举一个真实的场景：策划同学说"帮我把这批 30 张角色立绘加上’ XX 素材库’水印，做成缩略图版本，打包发群里"。这个请求听起来简单，但执行链路是：

• 从文件夹里找出这 30 张图片（设计师可能在不同目录）
• 逐张加文字水印（Photoshop 或在线工具）
• 逐张导出缩略图（重复劳动）
• 上传到某个可分享的地方
• 把下载链接发给策划

这个链路里，真正需要"专业判断"的动作是零。但它仍然要花掉一个策划或运营同学 30-60 分钟时间。
人不应该被绑在"搬运文件"这件事上！
而 AI Agent 的价值，恰恰在于能把这 30-60 分钟变成3 秒：一个自然语言指令 → Agent 自动拆解 → 调用 COS API → 返回结果。你就可以使用WorkBuddy这个聪明的龙虾帮你实现对话式的本地化远程操控，甚至可以用企业微信手机端操作，非常便捷舒适！

2. 为什么选 WorkBuddy操作COS

在动手之前，我调研了三条路：
第一条：纯脚本（直接写 Node.js/Python 脚本）
优点：最简单，5 分钟上手。缺点：每次操作都要改代码/改参数，无法共享，无法对话式使用。脚本的宿命是"写的人会，团队其他人不会"。
第二条：直接用 COS 控制台 + CI API
优点：官方工具，稳定性最好。缺点：仍然是人工操作，需要懂 API 才能自动化。COS 控制台是给人看的，不是给机器看的。
第三条：AI Agent + Skill 系统
优点：自然语言驱动，任何人都能用；Skill 标准化后可复用、可分享、可互操作。缺点：需要构建 Skill 层，前期有一定工作量。
我选了第三条。更准确地说，我选了 WorkBuddy来帮我管理资源这条路。

WorkBuddy 是我现在日常使用的 AI Agent 环境，它的 Skill 系统我可以直接掌控，可以快速迭代、快速验证。
现在我们只需要简单通过对话，就可以直接让WorkBuddy帮我们完成TencentCloud COS Skill安装。展示效果如下：

我们再根据它的提示完成后续配置工作即可。
定位我们日常使用的Bucket以便后续工作直接调用。

3. 腾讯云龙虾（OpenClaw）在这里扮演什么角色

OpenClaw 是一个 AI Agent 技能市场，核心理念是"让 AI 之间的技能可以互操作"。打个比方：如果 WorkBuddy 是一个操作系统，OpenClaw 就是这个操作系统的应用商店。
但 OpenClaw 不仅仅是"上传 Skill 到市场"这么简单。它的 S1 标准定义了一套完整的 Skill 互操作协议：

• Skill 是有明确定义格式的（SKILL.md）
• Skill 的操作是原子化的（每个 Action 做一件事）
• Skill 之间可以编排组合
• 凭证管理是标准化的（支持会话级 ephemeral 凭证）

这意味着，当我把游戏资产管理 Skill 发布到 ClawHub，不只是"别人可以下载使用"——而是任何兼容 S1 的 Agent 都可以理解这个 Skill 能做什么、接受什么参数、返回什么结果，并把它编排进更大的工作流里。

比如另一个 Agent 可以这样说：

“先调用 game-asset-cos Skill 上传素材，然后用 image-process Skill 评估图片质量，最后用 notify Skill 把画廊链接发到企业微信群。”

这才是 Skill 互操作的真正价值——技能像乐高积木一样可以被自由组合。

4. 整个系统想解决的核心问题

回到本质，我想用这套系统解决三个问题：
问题一：素材版本混乱 → 用签名 URL + 版本管理解决
签名 URL 天然带了时间戳属性，可以追溯"这个链接是什么时候生成的、哪个版本的文件"。结合版本日志，团队可以清晰地知道当前用的是哪个版本。
问题二：重复操作耗时 → 用 CI 实时处理 + 批量流水线解决
一次脚本运行，同时生成所有需要的处理变体（缩略图、水印、WebP、旋转等）。以后每次素材更新，只需要重新跑脚本，不需要手动逐个处理。
问题三：分享和协作困难 → 用 WorkBuddy 自然语言交互解决
不用再打开控制台、不用记 API 参数、不用写脚本。任何团队成员只需要说"帮我把 XX 目录的图片上传并处理"，WorkBuddy Agent 自动完成所有操作。

一、开发场景

游戏开发中会产生大量美术素材——角色立绘、背景图、敌人造型、UI 图标等。这些资产往往需要在不同场景下反复使用不同规格的版本：缩略图用于列表展示、带水印版本用于对外分享、WebP 版本用于网页加载优化、裁剪版本用于宣传海报……
传统做法：

• 用 Photoshop 逐个处理 → 每张图 5-10 分钟
• 多人协作时素材版本混乱
• 格式转换靠截图或手动导出
• 分享链接需要手动上传到图床，等上传完成
• 白屏加载直接用原图，没有骨架屏占位

自动化方案： 利用腾讯云对象存储（COS）的原生能力，配合数据万象（Cloud Infinite，CI）的实时图片处理 API，让程序自动完成所有转换——零人工干预，毫秒级响应。
AI Agent 增强方案（本文进阶）： 在自动化脚本的基础上，进一步引入 WorkBuddy AI Agent + OpenClaw S1 Skill 系统，实现自然语言驱动的素材管理——任何团队成员只需一句话，Agent 自动完成从上传到分发的全链路操作。

---

二、技术架构

2.1 整体架构演进：从脚本到 AI Agent

整个系统的搭建分为三个阶段，对应三种不同的复杂度：
阶段一：纯脚本（本文基础部分）

开发者 → 写 Node.js 脚本 → 运行 → 得到结果

优点：最直接，1 个文件搞定。缺点：每次要改参数要改代码，不适合非技术人员。
阶段二：Web 管理面板（本文进阶部分）

用户 → 浏览器访问 localhost:3000 → Web界面操作 → COS API → 返回结果

优点：可视化操作，不需要记命令。缺点：还是要打开浏览器，路径偏长。
阶段三：WorkBuddy + OpenClaw Skill（推荐方案）

用户 → 自然语言指令 → WorkBuddy Agent → game-asset-cos Skill → COS API → 返回结果

优点：最自然，任何人都能使用；Skill 可复用、可分享、可互操作。缺点：需要构建 Skill 层。

2.2 架构图

2.3 技术选型

技术选型	理由
cos-nodejs-sdk-v5	官方 SDK，支持所有 COS + CI 操作，文档完整
getObjectUrl()	生成带鉴权的访问 URL，支持附加 CI 处理参数，是本文核心方法
数据万象 CI	云端实时图片处理，无需下载本地再上传，零额外存储成本
Signed URL	2小时有效期，无需设置公开访问，签名即安全
CI URL 参数拼接	签名 URL 后直接附加处理参数，无额外 API 调用开销
WorkBuddy Agent	自然语言交互层，降低全链路使用门槛
OpenClaw S1 标准	Skill 互操作标准，一次开发，多 Agent 共用

2.4 WorkBuddy Skill 与 OpenClaw Skill 的异同

维度	WorkBuddySkill	OpenClawS1Skill
定义文件	SKILL.md（Markdown frontmatter）	SKILL.md（YAML frontmatter + JSON Schema）
触发方式	关键词自动加载 / 用户主动调用	指令式安装 + 对话调用
凭证管理	环境变量（临时 / 持久）	secrets + envMapping（支持 ephemeral）
安装路径	~/.workbuddy/skills/	~/.clawhub/skills/ 或 ClawHub 市场
可互操作性	WorkBuddy 专用	兼容所有 S1 标准 Agent
本文的 game-asset-cos Skill 同时兼容两者：WorkBuddy 用户直接使用，OpenClaw 用户从 ClawHub 安装后同样可用。

---

三、实战代码解析

3.1 COS 客户端初始化

const COS = require('cos-nodejs-sdk-v5');
const cos = new COS({
  SecretId: process.env.TENCENT_COS_SECRET_ID,
  SecretKey: process.env.TENCENT_COS_SECRET_KEY,
});

const BUCKET = 'pandafish-1330971775';
const REGION = 'ap-guangzhou';

生产环境应使用子账号密钥（最小权限），或使用 STS 临时凭证。永远不要把主账号密钥硬编码到代码中。
WorkBuddy 中的凭证管理：在 WorkBuddy 中，可以通过 Skill 的环境变量机制安全地注入凭证，而不必在对话中暴露。凭证默认以 ephemeral（会话级）方式存储，不会落盘。

3.2 Promise 化 SDK 调用

cos-nodejs-sdk-v5 本身是回调风格，为配合 async/await，需要简单包装：

function promiseCOS(method, params) {
  return new Promise((resolve, reject) => {
    cos[method](params, (err, data) => {
      if (err) reject(err);
      else resolve(data);
    });
  });
}

这样即可用优雅的 async/await 语法写出同步感的代码：

// 列出 Bucket 中的图片
const data = await promiseCOS('getBucket', {
  Bucket, Region, Prefix: '', MaxKeys: 50,
});
const images = (data.Contents || []).filter(f =>
  ['png', 'jpg', 'jpeg', 'gif', 'webp'].includes(f.Key.split('.').pop())
);

3.3 完整流水线（5步）

async function main() {
  // 步骤1：扫描原始素材
  const images = await step1_listImages();

  // 步骤2：生成签名访问 URL
  const withUrls = await step2_getSignedUrls(images);

  // 步骤3：为每张图片生成5种处理 URL
  const processed = await step3_processImages(withUrls);

  // 步骤4：构建交互式画廊 HTML（所有处理 URL 内嵌）
  const result = await step4_buildGallery(withUrls, processed);

  // 步骤5：上传画廊到 COS
  await putString(html, 'gallery/game-asset-gallery.html', 'text/html');
}

WorkBuddy 中的执行方式：用户只需说"运行游戏素材流水线"，WorkBuddy Agent 加载 Skill 后，自动解析并依次执行上述 5 个步骤，最终返回画廊链接。无需记住任何命令。

---

四、数据万象 CI 参数速查

操作要点如下：

4.1 基础图片处理

功能	URL参数	示例
缩放	imageMogr2/thumbnail/!{w}x{h}r	imageMogr2/thumbnail/!200x200r
裁剪	imageMogr2/crop/{w}x{h}	imageMogr2/crop/400x300/gravity/center
旋转	imageMogr2/rotate/{度}	imageMogr2/rotate/90
格式转换	imageMogr2/format/{格式}	imageMogr2/format/webp/quality/85

4.2 水印（文字）

watermark=watermark/1/text/{text}/font/{font}/fill/{color}/gravity/{position}/dx/{dx}/dy/{dy}

参数	说明
text	水印文字（需 URL 编码）
font	字体，如 SimHei
fill	文字颜色，十六进制如 FFFFFF
gravity	位置：NorthWest/North/NorthEast/West/Center/East/SouthWest/South/SouthEast
dx/dy	偏移量（像素）

4.3 处理参数叠加

多个处理可以叠加，用 / 分隔：

imageMogr2/thumbnail/!400x400/rotate/90/format/webp/quality/85

WorkBuddy Skill 中的链式构建：在 game_asset_engine.mjs 中封装了 CIParams 链式构建类，可以这样使用：

const ci = new CIParams();
ci.thumbnail(400, 400).rotate(90).format('webp', 85);
// → thumbnail/!400x400r/rotate/90/format/webp/quality/85

这个构建过程对用户透明，WorkBuddy Agent 会自动推断并组合所需的处理操作。

---

五、实战成果

5.1 流水线执行结果

╔══════════════════════════════════════════════╗
║  ✅ 流水线执行完成！                        ║
║  原始素材: 5 张                            ║
║  生成变体: 25 种处理方案                    ║
║  处理类型: 5 种（缩略图/水印/WebP/旋转/裁剪）║
║  耗时: 0.7 秒                              ║
╚══════════════════════════════════════════════╝

生成了交互式游戏资产管理画廊页面，已上传至 COS：

• 🖼️ 支持 6 种视图切换（全部 / 原始 / 水印 / 缩略图 / WebP / 旋转 / 裁剪）
• 🔍 点击放大灯箱查看单图
• 📋 一键复制访问链接
• 📱 响应式布局，移动端可用

我们来动态查看自己的图片资源：

展示效果很好。

我们来连接到手机上的龙虾来远程操作一下：

效果如下：

资源加载情况如下：

可以看到手机上也能操控自如！

5.2 在 WorkBuddy 中使用 game-asset-cos Skill

WorkBuddy 用户只需加载 Skill，即可用自然语言完成所有操作：

用户：
"帮我把 ~/game-assets 目录下的所有图片上传到 COS，
然后批量加水印（文字：Pandafish素材库），
生成缩略图版本，
最后做一个深色主题的画廊"

WorkBuddy Agent：
1. 加载 game-asset-cos Skill
2. 扫描本地目录，识别所有图片文件
3. 逐个上传到 COS
4. 为每张图片生成水印签名 URL（CI 实时处理）
5. 为每张图片生成缩略图签名 URL
6. 构建深色主题 HTML 画廊
7. 上传画廊到 COS
8. 返回画廊链接

耗时：约 1.2 秒

WorkBuddy Skill 触发方式：在 WorkBuddy 中，只要对话中出现以下关键词，Agent 会自动加载 game-asset-cos Skill。Skill 加载后，Agent 会自动解析意图并执行对应 Action，无需用户手动指定命令。

5.3 在 OpenClaw 生态中使用（腾讯云龙虾）

OpenClaw（原名"龙虾"，ClawHub 上的 OpenClaw 生态）是腾讯云推出的 AI Agent 技能平台。game-asset-cos Skill 遵循 OpenClaw S1 标准，天然兼容。
安装方式一：对话式安装（推荐）
在支持 OpenClaw 的 Agent（如 Clawdbot、云上 OpenClaw）中输入：

帮我安装腾讯云 COS Skill（TencentCloudCOS Skill），
下载链接是 https://clawhub.ai/ShawnMinh/tencentcloud-cos

Agent 会自动下载并安装 Skill，然后引导配置凭证。
安装方式二：命令行安装

npx clawhub@latest install tencentcloud-cos

5.4 Skill 互操作价值

举一个具体的互操作场景：
假设一个游戏团队同时使用多个 AI Agent：

• 策划助手 Agent：负责需求文档、活动配置
• 美术资产 Agent：负责素材管理（即 game-asset-cos）
• 运营 Agent：负责活动配置发布、用户触达
• 客服 Agent：负责问题解答、活动查询

当策划同学说"新活动的素材要上线了"时，策划助手 Agent 可以自动调用美术资产 Agent 上传新素材，再调用运营 Agent 发布活动配置——整个链路是自动化的，无需人工在多个系统之间切换。
这就是 Skill 互操作的意义：每个 Agent 专注做好自己的事，通过标准化的 Skill 接口实现跨 Agent 协作。

扩展方向如下：

扩展方向	说明	与WorkBuddy的结合
触发式处理	利用 COS 触发器，当新素材上传时自动触发流水线	WorkBuddy 可监控触发事件并通知团队
水印模板库	预设多种水印模板（游戏 LOGO、平台标识、尺寸标注），一键切换	WorkBuddy 自然语言切换模板
CDN 预热	处理完成后自动刷新 CDN 缓存，确保各节点立即可用	Skill 内置 CDN 预热 Action
MetaInsight 检索	利用数据万象的图搜图能力，以图搜相似素材、以文搜素材	WorkBuddy 对话式搜图
工作流编排	配合 COS Workflow，实现素材上传 → 审核 → 转码 → 分发的全链路自动化	OpenClaw Skill 编排多个 Action
多 Agent 协作	美术资产 Agent + 运营 Agent + 客服 Agent 跨 Agent 联动	OpenClaw S1 互操作标准

总结

通过腾讯云 COS + 数据万象 CI + WorkBuddy AI Agent + OpenClaw S1 标准，我们实现了一套零人工、秒级响应、自然语言驱动的游戏资产管理流水线：

• 所有处理在 COS CDN 节点完成，无额外存储开销，
• 签名 URL 保证安全性，支持设置过期时间，
• 画廊页面已直接托管在 COS，无需自建服务器，
• WorkBuddy 自然语言交互，非技术人员也能轻松使用。

利用COS云存储能极大提高图片加载效率，通过skill完美实现本地化自动流水线控制，尤其是我在手机上随时可以通过对话就监控操作的腾讯龙虾，真的非常方便！
把图片处理交给腾讯云，把操作交给 WorkBuddy——你只管做游戏就好！