1. 项目缘起从“手动搬运”到“自动化流水线”的蜕变作为一名独立游戏开发者我过去几年最头疼的事情之一就是游戏资源的管理。美术资源、音频文件、配置文件、版本构建包……这些文件散落在本地硬盘、同事的电脑、甚至临时的网盘链接里。每次需要给测试人员发包或者同步给远程协作的美术、策划都是一场混乱的“手动搬运”大战压缩、上传、发链接、等对方下载、再解压。版本一多文件名混乱空间占用激增协作效率低到令人发指。我管这个状态叫“资源管理石器时代”。直到我遇到了一个组合拳腾讯云对象存储 COS、WorkBuddy以及它的Skill机制。这个组合让我构建起一套全自动的游戏资源管理流水线我戏称为“龙虾”系统——不是因为爱吃而是取“龙”的自动化与“虾”的精细触角之意意指它能自动、精准地处理海量资源。今天我就来拆解这套系统的搭建全过程分享如何利用这些工具将令人头疼的资源管理变成“一键发布、自动归档”的轻松事。2. 核心组件拆解COS、WorkBuddy与Skill各自扮演什么角色在动手之前必须搞清楚这三个核心组件分别解决了什么问题以及它们是如何协同工作的。这就像搭积木知其所以然才能搭得稳固。2.1 腾讯云 COS稳定可靠的云端资源仓库腾讯云对象存储 COS是整个系统的基石扮演着“最终仓库”的角色。对于游戏项目来说它有几个不可替代的优势海量存储与低成本游戏资源尤其是高清纹理、动画、音频动辄几十GB甚至上百GB。COS 的存储成本远低于自建服务器并且按量付费没有闲置浪费。高可靠与持久性COS 提供多副本冗余存储数据可靠性高达 99.9999999999%12个9。这意味着你的游戏资源几乎不可能因为硬盘损坏而丢失对于项目资产这种数字财富来说是底线保障。高速上传下载与 CDN 加速通过简单的配置可以为 COS 存储桶绑定腾讯云 CDN。这样无论是团队成员在各地下载资源还是最终玩家从游戏内更新资源包都能获得极快的速度这对提升协作和用户体验至关重要。精细的权限管理你可以通过 CAM 访问管理为不同的团队成员如美术、策划、测试创建子账号并分配只读、读写等不同权限的存储桶实现安全可控的访问。在我的“龙虾”系统里COS 被规划为三个核心存储桶dev-assets存放开发中的原始资源PSD、FBX等供美术和策划随时上传更新。build-pipeline存放 CI/CD 流水线产出的各个版本的游戏构建包APK/IPA/EXE。release-public存放对外发布的最终稳定版资源包和热更新包并开启 CDN 加速。2.2 WorkBuddy自动化流程的“大脑”与调度中心WorkBuddy 是一个新兴的 AI Agent 开发与应用平台。你可以把它理解为一个高度可定制、具备一定 AI 推理能力的自动化机器人。它不直接替代你的代码或工具而是作为“胶水”和“调度器”将不同的工具、API 和服务连接起来按照你设定的逻辑自动执行任务。在资源管理场景下WorkBuddy 的核心价值在于事件监听与触发它可以监听多种事件源例如 Git 仓库的推送Push、钉钉/飞书群消息、Webhook 调用甚至是定时任务。这为自动化流程提供了启动信号。流程编排通过可视化的蓝图或代码Skill你可以设计复杂的业务流程。例如“当 Git 出现新的 Tag 时触发构建服务器打包打包完成后将文件上传至 COS 特定目录并发送通知到钉钉群。”AI 增强决策结合大语言模型能力WorkBuddy 可以处理一些非结构化的任务。比如自动分析提交信息判断本次构建是测试版还是预发布版从而决定上传到 COS 的哪个路径。2.3 Skill让 WorkBuddy 拥有“专业技能”的插件Skill 是 WorkBuddy 平台的能力扩展单元。如果说 WorkBuddy 是大脑那么 Skill 就是让它学会各种技能的手和脚。一个 Skill 通常封装了对某个特定服务或工具的操作能力。对于我们的“龙虾”系统最关键的是需要一个能够与腾讯云 COS API交互的 Skill。幸运的是WorkBuddy 社区通常已经提供了丰富的官方和第三方 Skill。我们需要的就是一个COS Skill它应该包含以下核心能力文件上传将本地或构建服务器上的文件上传到指定的 COS 存储桶和路径。文件列表/查询查询存储桶中特定前缀的文件列表用于版本比对或资源索引生成。文件下载从 COS 下载文件到本地可用于自动拉取依赖资源。文件删除清理旧版本或临时文件管理存储空间。如果社区没有现成的我们就需要基于腾讯云 COS 的 SDK如 Python、Node.js SDK自己开发一个。这本质上是将 COS 的 API 调用封装成 WorkBuddy 可以识别和调用的标准化动作。3. “龙虾”系统架构设计与工作流全景理解了组件我们来设计整个自动化流程。目标是将游戏资源从本地或构建服务器自动、有序地同步到腾讯云 COS并触发后续通知或部署动作。整个系统架构如下图所示概念图[本地/Git] --(提交/推送)-- [CI/CD 服务器] --(构建完成)-- [WorkBuddy] | | (调用 COS Skill) V [钉钉/飞书] --(发送通知)-- [WorkBuddy] --(上传文件)-- [腾讯云 COS] | V [CDN 加速] -- [终端用户/测试员]具体的工作流可以拆解为以下几个核心场景3.1 场景一每日构建资源自动归档这是最基础也是最常用的流程。每天开发结束后CI 服务器如 Jenkins、GitLab CI会执行一次每日构建。触发CI 服务器构建成功生成资源包如AssetBundles和版本号如v1.0.0_20240515。调用CI 服务器通过调用 WorkBuddy 提供的 Webhook URL传递构建信息版本号、构建路径、构建类型等。处理WorkBuddy 接收到 Webhook启动对应的处理流程Skill。该 Skill 会解析传入的参数。使用 COS Skill将构建产物从 CI 服务器的路径上传到 COS 的build-pipeline/daily/2024-05-15/目录下。按照游戏名_版本号_平台_日期.zip的规范重命名文件。通知上传成功后WorkBuddy 调用消息推送 Skill向指定的钉钉或飞书群发送一条消息“每日构建 v1.0.0_20240515 已完成资源已归档至[COS 文件链接]”。清理可选步骤Skill 可以设置规则自动清理超过 30 天的旧每日构建包释放 COS 存储空间。3.2 场景二版本发布自动化当我们在 Git 上打上一个正式的 Release Tag如v1.2.0时触发全自动发布流程。触发Git 仓库的 Tag Push 事件。这可以通过 Git 提供的 Webhook 直接通知 WorkBuddy或者由 CI 服务器检测到 Tag 后触发更复杂的构建流程再通知 WorkBuddy。构建与打包此步骤可能在 CI 内完成WorkBuddy 负责协调。它接收到 Tag 事件后可以触发一个“发布构建”任务CI 会进行更严格的代码检查和优化构建。上传与分发构建完成后WorkBuddy 的发布流程 Skill 会将最终的游戏安装包上传至release-public/installer/v1.2.0/。将热更新资源包上传至release-public/patch/v1.2.0/。同时刷新腾讯云 CDN 缓存这可能需要调用额外的 CDN API Skill确保全球玩家能立刻获取到最新资源。多渠道通知WorkBuddy 同步完成以下通知内部测试群发布完成通知。项目管理系统如 Trello、Jira自动关闭相关的发布任务单。甚至可以将发布信息写入数据库用于游戏内公告或官网更新。3.3 场景三美术资源同步与预览美术同学经常需要提交和共享资源。传统方式是发文件或传网盘版本混乱。触发美术同学将资源文件如图片、模型放置到一个指定的本地共享文件夹或提交到 Git 的特定分支。监控与处理WorkBuddy 部署一个常驻的监控 Skill定时扫描该文件夹或监听 Git 提交。智能处理当发现新文件时Skill 会自动将文件上传到dev-assets/raw/[美术姓名]/[日期]/目录。对于图片文件可以调用额外的“图片处理 Skill”生成缩略图并上传到同目录。自动在内部的资源预览网站上生成该资源的预览页面和链接。通知将资源预览链接直接 相关策划和客户端程序员大家点击即可查看无需下载数 GB 的原始文件。4. 实战搭建从零开始配置“龙虾”系统理论讲完我们进入实战环节。假设你已经拥有腾讯云账号和 WorkBuddy 的访问权限。4.1 第一步腾讯云 COS 基础配置创建存储桶登录腾讯云控制台进入 COS 服务。根据前述规划创建三个存储桶dev-assets-[appid],build-pipeline-[appid],release-public-[appid]。注意存储桶名称全局唯一建议加上 appid 或项目名后缀。配置权限在“权限管理”中为每个桶设置合适的公有读私有写或私有读写策略。release-public通常设为公有读如果资源需公开下载其他两个设为私有。在“访问管理 CAM”中创建子用户如workbuddy-agent并为其创建一组SecretId和SecretKey。这是 WorkBuddy 访问 COS 的凭证。为该子用户分配策略。最精细的做法是自定义策略授权其对特定存储桶的特定操作如PutObject,GetObject,ListBucket等。最小权限原则是安全的基础。配置 CDN 加速可选但推荐对于release-public桶在 COS 控制台开启“默认 CDN 加速域名”或绑定自定义域名。这将极大提升终端用户的下载速度。4.2 第二步在 WorkBuddy 中安装与配置 COS Skill这是连接 WorkBuddy 和 COS 的关键一步。寻找或开发 Skill首先在 WorkBuddy 的 Skill 市场搜索 “Tencent Cloud COS” 或 “对象存储”。如果存在官方或社区维护的 Skill直接安装。配置 Skill 连接安装后你需要配置这个 Skill。关键配置项包括SecretIdSecretKey填入上一步为子用户创建的密钥。Region存储桶所在地域如ap-beijing。Bucket默认操作的存储桶名称可以在流程中动态覆盖。通常还需要一个“连接名称”如MyTencentCOS以便在后续流程中引用。测试连接大多数 Skill 会提供一个“测试连接”功能点击后如果返回成功说明凭证和配置正确WorkBuddy 已经具备了操作你 COS 的能力。注意保管好你的SecretId和SecretKey它们等同于密码。永远不要将其硬编码在代码或公开的配置文件中。WorkBuddy 通常提供安全的凭证存储方式。4.3 第三步编排第一个自动化流程——构建后上传我们以最常见的“CI 构建后上传”为例在 WorkBuddy 中创建一个自动化流程。创建新流程在 WorkBuddy 中创建一个新的 “Flow” 或 “Automation”命名为 “Game Build Upload to COS”。设置触发器选择 “Webhook” 触发器。WorkBuddy 会生成一个唯一的 URL如https://api.workbuddy.com/webhook/your-unique-id。复制这个 URL。配置你的 CI到你的 Jenkins 或 GitLab CI 配置中在构建后步骤Post-build Actions里添加一个 “HTTP Request” 步骤。将上一步的 Webhook URL 填入并选择POST方法。在请求体中以 JSON 格式传递构建信息例如{ event: build_success, project: MyAwesomeGame, version: ${env.BUILD_VERSION}, build_path: /var/jenkins/workspace/build/output, platform: Android }${env.BUILD_VERSION}是 Jenkins 的环境变量你需要确保它在构建过程中被正确赋值。在 WorkBuddy 中设计流程节点1接收 Webhook。这个节点会自动解析 CI 发来的 JSON 数据将里面的字段如version,build_path转化为流程变量。节点2使用 COS Skill上传文件。从技能库拖入配置好的 COS Skill 的 “Upload File” 动作。配置参数本地文件路径填入{{build_path}}/*.apk假设上传 APK。这里可以使用通配符也可以循环上传一个文件夹。目标存储桶填入build-pipeline-[appid]。目标 COS 路径填入versions/{{platform}}/{{version}}/。这样文件会自动上传到类似versions/Android/v1.0.0_20240515/的目录下结构非常清晰。节点3使用消息推送 Skill。拖入一个钉钉或飞书机器人 Skill 的 “发送消息” 动作。配置消息模板引用上传成功后的文件 URL通常 COS Skill 的上传动作会返回文件的访问地址。消息内容可以是“ 构建成功版本{{version}}已上传至 COS。下载链接[{{file_url}}]”保存并启用流程保存整个流程并将其状态设置为“启用”。现在每当你的 CI 构建成功并调用那个 Webhook这个流程就会自动运行完成上传和通知。4.4 第四步进阶配置与优化基础流程跑通后可以考虑以下优化点让“龙虾”系统更智能版本管理与清理策略在 COS Skill 的“列表文件”动作后可以接一个“条件判断”节点。列出build-pipeline/daily/目录下的所有文件按日期排序如果数量超过 30 个则触发“删除文件”动作清理最旧的几个。这需要你编写一些简单的逻辑来判断文件名中的日期。上传前压缩如果构建产物是大量小文件直接上传效率低。可以在 WorkBuddy 流程中增加一个“执行命令行”节点在上传前调用zip或tar命令将文件夹打包然后再上传压缩包。失败重试与告警在流程的关键节点如上传后设置“错误处理”分支。如果上传失败不是默默结束而是触发一个更紧急的告警如电话或短信并记录错误日志到数据库方便排查。多环境支持通过流程变量区分开发、测试、生产环境。Webhook 传递一个environment字段流程根据这个字段决定上传到哪个存储桶如cos-dev,cos-prod实现一套流程多处复用。5. 避坑指南与实战心得在搭建和运行这套系统的过程中我踩过不少坑也积累了一些宝贵经验。5.1 权限配置的“最小化”陷阱最初我给 WorkBuddy 的子用户赋予了 COS 的全局管理权限QcloudCOSFullAccess心想省事。结果有一次流程脚本出错循环上传文件差点把存储桶塞满并产生巨额费用。教训与方案必须遵循最小权限原则。在 CAM 中创建自定义策略只授予必要的操作和资源。例如只允许对build-pipeline-[appid]这个存储桶的PutObject,GetObject,ListBucket操作。这样即使流程出错影响范围也被限制在单个桶内。5.2 文件命名与路径设计的艺术早期我们上传文件用了简单的build_{timestamp}.zip命名。时间一长根本分不清哪个版本对应什么内容。最佳实践设计一套包含丰富元数据的命名规范。例如{项目名}_{版本号}_{平台}_{构建类型}_{Git提交短哈希}_{日期}.zip-MyGame_v1.2.0_Android_Release_a1b2c3d_20240515.zip。同时利用 COS 的“文件夹”概念实际上是 key 的前缀来组织如platformAndroid/typeRelease/date2024-05-15/。这样无论是在控制台查看还是通过程序列表都一目了然。5.3 网络与稳定性考量我们的构建服务器在海外直接上传文件到国内的腾讯云 COS 有时速度不稳定。解决方案启用传输加速腾讯云 COS 提供了全球传输加速功能对跨境上传有显著优化。分块上传与断点续传对于大文件如超过 100MB务必使用 SDK 的分块上传功能。幸运的是大多数成熟的 COS Skill 底层都会调用 SDK 的此功能。确保你的流程在上传大文件时启用了这个选项它能有效应对网络波动。设置超时与重试在 WorkBuddy 的流程节点配置或调用 SDK 时显式设置合理的超时时间如 300 秒和重试次数如 3 次。避免单次网络抖动导致整个流程失败。5.4 WorkBuddy Skill 的选型与自定义社区 Skill 可能不完全符合你的需求。比如你可能需要在上传后将文件信息记录到自己的项目数据库。应对策略优先使用官方 Skill通常最稳定兼容性最好。善用“HTTP Request”通用 Skill如果某个操作没有现成 Skill但对方提供了 RESTful API比如你自己的后端服务那么 WorkBuddy 自带的“HTTP Request”技能就是万能钥匙。你可以用它调用任何 API。自行开发 Skill如果操作非常复杂或频繁可以考虑自己开发。WorkBuddy 通常提供了 Skill 开发框架本质上是一个封装了特定 API 调用的模块。开发完成后可以在团队内共享一劳永逸。5.5 监控与日志让自动化流程“看得见”自动化流程跑起来后最怕的就是它 silently fails静默失败。你可能过了好几天才发现版本没有上传。必须建立的监控点流程执行日志WorkBuddy 平台会记录每次流程执行的详细日志包括每个节点的输入输出。定期查看尤其是失败的执行。COS 访问日志在腾讯云 COS 控制台开启存储桶的访问日志。这些日志会记录每一个上传、下载请求包括请求者 IP、时间、操作、文件大小等。可用于审计和安全分析。自定义健康检查可以建立一个最简单的监控流程每周一早上尝试从 COS 下载一个已知的小文件如果失败则发送严重告警。这检查了从 WorkBuddy 到 COS 的整个链路是否通畅。这套“龙虾”系统运行半年多以来我们团队已经完全告别了手动管理游戏资源的时代。新同事入职不再需要给他传几个 G 的资源包美术更新了一个图标策划和程序能立刻在预览链接上看到效果每次版本发布都是一次安静、可靠、可追溯的自动化过程。技术的价值正是将人从重复、繁琐的劳动中解放出来去从事更有创造性的工作。希望我的这套实践能为你打开一扇自动化项目资源管理的大门。
1. 项目缘起从“手动搬运”到“自动化流水线”的蜕变作为一名独立游戏开发者我过去几年最头疼的事情之一就是游戏资源的管理。美术资源、音频文件、配置文件、版本构建包……这些文件散落在本地硬盘、同事的电脑、甚至临时的网盘链接里。每次需要给测试人员发包或者同步给远程协作的美术、策划都是一场混乱的“手动搬运”大战压缩、上传、发链接、等对方下载、再解压。版本一多文件名混乱空间占用激增协作效率低到令人发指。我管这个状态叫“资源管理石器时代”。直到我遇到了一个组合拳腾讯云对象存储 COS、WorkBuddy以及它的Skill机制。这个组合让我构建起一套全自动的游戏资源管理流水线我戏称为“龙虾”系统——不是因为爱吃而是取“龙”的自动化与“虾”的精细触角之意意指它能自动、精准地处理海量资源。今天我就来拆解这套系统的搭建全过程分享如何利用这些工具将令人头疼的资源管理变成“一键发布、自动归档”的轻松事。2. 核心组件拆解COS、WorkBuddy与Skill各自扮演什么角色在动手之前必须搞清楚这三个核心组件分别解决了什么问题以及它们是如何协同工作的。这就像搭积木知其所以然才能搭得稳固。2.1 腾讯云 COS稳定可靠的云端资源仓库腾讯云对象存储 COS是整个系统的基石扮演着“最终仓库”的角色。对于游戏项目来说它有几个不可替代的优势海量存储与低成本游戏资源尤其是高清纹理、动画、音频动辄几十GB甚至上百GB。COS 的存储成本远低于自建服务器并且按量付费没有闲置浪费。高可靠与持久性COS 提供多副本冗余存储数据可靠性高达 99.9999999999%12个9。这意味着你的游戏资源几乎不可能因为硬盘损坏而丢失对于项目资产这种数字财富来说是底线保障。高速上传下载与 CDN 加速通过简单的配置可以为 COS 存储桶绑定腾讯云 CDN。这样无论是团队成员在各地下载资源还是最终玩家从游戏内更新资源包都能获得极快的速度这对提升协作和用户体验至关重要。精细的权限管理你可以通过 CAM 访问管理为不同的团队成员如美术、策划、测试创建子账号并分配只读、读写等不同权限的存储桶实现安全可控的访问。在我的“龙虾”系统里COS 被规划为三个核心存储桶dev-assets存放开发中的原始资源PSD、FBX等供美术和策划随时上传更新。build-pipeline存放 CI/CD 流水线产出的各个版本的游戏构建包APK/IPA/EXE。release-public存放对外发布的最终稳定版资源包和热更新包并开启 CDN 加速。2.2 WorkBuddy自动化流程的“大脑”与调度中心WorkBuddy 是一个新兴的 AI Agent 开发与应用平台。你可以把它理解为一个高度可定制、具备一定 AI 推理能力的自动化机器人。它不直接替代你的代码或工具而是作为“胶水”和“调度器”将不同的工具、API 和服务连接起来按照你设定的逻辑自动执行任务。在资源管理场景下WorkBuddy 的核心价值在于事件监听与触发它可以监听多种事件源例如 Git 仓库的推送Push、钉钉/飞书群消息、Webhook 调用甚至是定时任务。这为自动化流程提供了启动信号。流程编排通过可视化的蓝图或代码Skill你可以设计复杂的业务流程。例如“当 Git 出现新的 Tag 时触发构建服务器打包打包完成后将文件上传至 COS 特定目录并发送通知到钉钉群。”AI 增强决策结合大语言模型能力WorkBuddy 可以处理一些非结构化的任务。比如自动分析提交信息判断本次构建是测试版还是预发布版从而决定上传到 COS 的哪个路径。2.3 Skill让 WorkBuddy 拥有“专业技能”的插件Skill 是 WorkBuddy 平台的能力扩展单元。如果说 WorkBuddy 是大脑那么 Skill 就是让它学会各种技能的手和脚。一个 Skill 通常封装了对某个特定服务或工具的操作能力。对于我们的“龙虾”系统最关键的是需要一个能够与腾讯云 COS API交互的 Skill。幸运的是WorkBuddy 社区通常已经提供了丰富的官方和第三方 Skill。我们需要的就是一个COS Skill它应该包含以下核心能力文件上传将本地或构建服务器上的文件上传到指定的 COS 存储桶和路径。文件列表/查询查询存储桶中特定前缀的文件列表用于版本比对或资源索引生成。文件下载从 COS 下载文件到本地可用于自动拉取依赖资源。文件删除清理旧版本或临时文件管理存储空间。如果社区没有现成的我们就需要基于腾讯云 COS 的 SDK如 Python、Node.js SDK自己开发一个。这本质上是将 COS 的 API 调用封装成 WorkBuddy 可以识别和调用的标准化动作。3. “龙虾”系统架构设计与工作流全景理解了组件我们来设计整个自动化流程。目标是将游戏资源从本地或构建服务器自动、有序地同步到腾讯云 COS并触发后续通知或部署动作。整个系统架构如下图所示概念图[本地/Git] --(提交/推送)-- [CI/CD 服务器] --(构建完成)-- [WorkBuddy] | | (调用 COS Skill) V [钉钉/飞书] --(发送通知)-- [WorkBuddy] --(上传文件)-- [腾讯云 COS] | V [CDN 加速] -- [终端用户/测试员]具体的工作流可以拆解为以下几个核心场景3.1 场景一每日构建资源自动归档这是最基础也是最常用的流程。每天开发结束后CI 服务器如 Jenkins、GitLab CI会执行一次每日构建。触发CI 服务器构建成功生成资源包如AssetBundles和版本号如v1.0.0_20240515。调用CI 服务器通过调用 WorkBuddy 提供的 Webhook URL传递构建信息版本号、构建路径、构建类型等。处理WorkBuddy 接收到 Webhook启动对应的处理流程Skill。该 Skill 会解析传入的参数。使用 COS Skill将构建产物从 CI 服务器的路径上传到 COS 的build-pipeline/daily/2024-05-15/目录下。按照游戏名_版本号_平台_日期.zip的规范重命名文件。通知上传成功后WorkBuddy 调用消息推送 Skill向指定的钉钉或飞书群发送一条消息“每日构建 v1.0.0_20240515 已完成资源已归档至[COS 文件链接]”。清理可选步骤Skill 可以设置规则自动清理超过 30 天的旧每日构建包释放 COS 存储空间。3.2 场景二版本发布自动化当我们在 Git 上打上一个正式的 Release Tag如v1.2.0时触发全自动发布流程。触发Git 仓库的 Tag Push 事件。这可以通过 Git 提供的 Webhook 直接通知 WorkBuddy或者由 CI 服务器检测到 Tag 后触发更复杂的构建流程再通知 WorkBuddy。构建与打包此步骤可能在 CI 内完成WorkBuddy 负责协调。它接收到 Tag 事件后可以触发一个“发布构建”任务CI 会进行更严格的代码检查和优化构建。上传与分发构建完成后WorkBuddy 的发布流程 Skill 会将最终的游戏安装包上传至release-public/installer/v1.2.0/。将热更新资源包上传至release-public/patch/v1.2.0/。同时刷新腾讯云 CDN 缓存这可能需要调用额外的 CDN API Skill确保全球玩家能立刻获取到最新资源。多渠道通知WorkBuddy 同步完成以下通知内部测试群发布完成通知。项目管理系统如 Trello、Jira自动关闭相关的发布任务单。甚至可以将发布信息写入数据库用于游戏内公告或官网更新。3.3 场景三美术资源同步与预览美术同学经常需要提交和共享资源。传统方式是发文件或传网盘版本混乱。触发美术同学将资源文件如图片、模型放置到一个指定的本地共享文件夹或提交到 Git 的特定分支。监控与处理WorkBuddy 部署一个常驻的监控 Skill定时扫描该文件夹或监听 Git 提交。智能处理当发现新文件时Skill 会自动将文件上传到dev-assets/raw/[美术姓名]/[日期]/目录。对于图片文件可以调用额外的“图片处理 Skill”生成缩略图并上传到同目录。自动在内部的资源预览网站上生成该资源的预览页面和链接。通知将资源预览链接直接 相关策划和客户端程序员大家点击即可查看无需下载数 GB 的原始文件。4. 实战搭建从零开始配置“龙虾”系统理论讲完我们进入实战环节。假设你已经拥有腾讯云账号和 WorkBuddy 的访问权限。4.1 第一步腾讯云 COS 基础配置创建存储桶登录腾讯云控制台进入 COS 服务。根据前述规划创建三个存储桶dev-assets-[appid],build-pipeline-[appid],release-public-[appid]。注意存储桶名称全局唯一建议加上 appid 或项目名后缀。配置权限在“权限管理”中为每个桶设置合适的公有读私有写或私有读写策略。release-public通常设为公有读如果资源需公开下载其他两个设为私有。在“访问管理 CAM”中创建子用户如workbuddy-agent并为其创建一组SecretId和SecretKey。这是 WorkBuddy 访问 COS 的凭证。为该子用户分配策略。最精细的做法是自定义策略授权其对特定存储桶的特定操作如PutObject,GetObject,ListBucket等。最小权限原则是安全的基础。配置 CDN 加速可选但推荐对于release-public桶在 COS 控制台开启“默认 CDN 加速域名”或绑定自定义域名。这将极大提升终端用户的下载速度。4.2 第二步在 WorkBuddy 中安装与配置 COS Skill这是连接 WorkBuddy 和 COS 的关键一步。寻找或开发 Skill首先在 WorkBuddy 的 Skill 市场搜索 “Tencent Cloud COS” 或 “对象存储”。如果存在官方或社区维护的 Skill直接安装。配置 Skill 连接安装后你需要配置这个 Skill。关键配置项包括SecretIdSecretKey填入上一步为子用户创建的密钥。Region存储桶所在地域如ap-beijing。Bucket默认操作的存储桶名称可以在流程中动态覆盖。通常还需要一个“连接名称”如MyTencentCOS以便在后续流程中引用。测试连接大多数 Skill 会提供一个“测试连接”功能点击后如果返回成功说明凭证和配置正确WorkBuddy 已经具备了操作你 COS 的能力。注意保管好你的SecretId和SecretKey它们等同于密码。永远不要将其硬编码在代码或公开的配置文件中。WorkBuddy 通常提供安全的凭证存储方式。4.3 第三步编排第一个自动化流程——构建后上传我们以最常见的“CI 构建后上传”为例在 WorkBuddy 中创建一个自动化流程。创建新流程在 WorkBuddy 中创建一个新的 “Flow” 或 “Automation”命名为 “Game Build Upload to COS”。设置触发器选择 “Webhook” 触发器。WorkBuddy 会生成一个唯一的 URL如https://api.workbuddy.com/webhook/your-unique-id。复制这个 URL。配置你的 CI到你的 Jenkins 或 GitLab CI 配置中在构建后步骤Post-build Actions里添加一个 “HTTP Request” 步骤。将上一步的 Webhook URL 填入并选择POST方法。在请求体中以 JSON 格式传递构建信息例如{ event: build_success, project: MyAwesomeGame, version: ${env.BUILD_VERSION}, build_path: /var/jenkins/workspace/build/output, platform: Android }${env.BUILD_VERSION}是 Jenkins 的环境变量你需要确保它在构建过程中被正确赋值。在 WorkBuddy 中设计流程节点1接收 Webhook。这个节点会自动解析 CI 发来的 JSON 数据将里面的字段如version,build_path转化为流程变量。节点2使用 COS Skill上传文件。从技能库拖入配置好的 COS Skill 的 “Upload File” 动作。配置参数本地文件路径填入{{build_path}}/*.apk假设上传 APK。这里可以使用通配符也可以循环上传一个文件夹。目标存储桶填入build-pipeline-[appid]。目标 COS 路径填入versions/{{platform}}/{{version}}/。这样文件会自动上传到类似versions/Android/v1.0.0_20240515/的目录下结构非常清晰。节点3使用消息推送 Skill。拖入一个钉钉或飞书机器人 Skill 的 “发送消息” 动作。配置消息模板引用上传成功后的文件 URL通常 COS Skill 的上传动作会返回文件的访问地址。消息内容可以是“ 构建成功版本{{version}}已上传至 COS。下载链接[{{file_url}}]”保存并启用流程保存整个流程并将其状态设置为“启用”。现在每当你的 CI 构建成功并调用那个 Webhook这个流程就会自动运行完成上传和通知。4.4 第四步进阶配置与优化基础流程跑通后可以考虑以下优化点让“龙虾”系统更智能版本管理与清理策略在 COS Skill 的“列表文件”动作后可以接一个“条件判断”节点。列出build-pipeline/daily/目录下的所有文件按日期排序如果数量超过 30 个则触发“删除文件”动作清理最旧的几个。这需要你编写一些简单的逻辑来判断文件名中的日期。上传前压缩如果构建产物是大量小文件直接上传效率低。可以在 WorkBuddy 流程中增加一个“执行命令行”节点在上传前调用zip或tar命令将文件夹打包然后再上传压缩包。失败重试与告警在流程的关键节点如上传后设置“错误处理”分支。如果上传失败不是默默结束而是触发一个更紧急的告警如电话或短信并记录错误日志到数据库方便排查。多环境支持通过流程变量区分开发、测试、生产环境。Webhook 传递一个environment字段流程根据这个字段决定上传到哪个存储桶如cos-dev,cos-prod实现一套流程多处复用。5. 避坑指南与实战心得在搭建和运行这套系统的过程中我踩过不少坑也积累了一些宝贵经验。5.1 权限配置的“最小化”陷阱最初我给 WorkBuddy 的子用户赋予了 COS 的全局管理权限QcloudCOSFullAccess心想省事。结果有一次流程脚本出错循环上传文件差点把存储桶塞满并产生巨额费用。教训与方案必须遵循最小权限原则。在 CAM 中创建自定义策略只授予必要的操作和资源。例如只允许对build-pipeline-[appid]这个存储桶的PutObject,GetObject,ListBucket操作。这样即使流程出错影响范围也被限制在单个桶内。5.2 文件命名与路径设计的艺术早期我们上传文件用了简单的build_{timestamp}.zip命名。时间一长根本分不清哪个版本对应什么内容。最佳实践设计一套包含丰富元数据的命名规范。例如{项目名}_{版本号}_{平台}_{构建类型}_{Git提交短哈希}_{日期}.zip-MyGame_v1.2.0_Android_Release_a1b2c3d_20240515.zip。同时利用 COS 的“文件夹”概念实际上是 key 的前缀来组织如platformAndroid/typeRelease/date2024-05-15/。这样无论是在控制台查看还是通过程序列表都一目了然。5.3 网络与稳定性考量我们的构建服务器在海外直接上传文件到国内的腾讯云 COS 有时速度不稳定。解决方案启用传输加速腾讯云 COS 提供了全球传输加速功能对跨境上传有显著优化。分块上传与断点续传对于大文件如超过 100MB务必使用 SDK 的分块上传功能。幸运的是大多数成熟的 COS Skill 底层都会调用 SDK 的此功能。确保你的流程在上传大文件时启用了这个选项它能有效应对网络波动。设置超时与重试在 WorkBuddy 的流程节点配置或调用 SDK 时显式设置合理的超时时间如 300 秒和重试次数如 3 次。避免单次网络抖动导致整个流程失败。5.4 WorkBuddy Skill 的选型与自定义社区 Skill 可能不完全符合你的需求。比如你可能需要在上传后将文件信息记录到自己的项目数据库。应对策略优先使用官方 Skill通常最稳定兼容性最好。善用“HTTP Request”通用 Skill如果某个操作没有现成 Skill但对方提供了 RESTful API比如你自己的后端服务那么 WorkBuddy 自带的“HTTP Request”技能就是万能钥匙。你可以用它调用任何 API。自行开发 Skill如果操作非常复杂或频繁可以考虑自己开发。WorkBuddy 通常提供了 Skill 开发框架本质上是一个封装了特定 API 调用的模块。开发完成后可以在团队内共享一劳永逸。5.5 监控与日志让自动化流程“看得见”自动化流程跑起来后最怕的就是它 silently fails静默失败。你可能过了好几天才发现版本没有上传。必须建立的监控点流程执行日志WorkBuddy 平台会记录每次流程执行的详细日志包括每个节点的输入输出。定期查看尤其是失败的执行。COS 访问日志在腾讯云 COS 控制台开启存储桶的访问日志。这些日志会记录每一个上传、下载请求包括请求者 IP、时间、操作、文件大小等。可用于审计和安全分析。自定义健康检查可以建立一个最简单的监控流程每周一早上尝试从 COS 下载一个已知的小文件如果失败则发送严重告警。这检查了从 WorkBuddy 到 COS 的整个链路是否通畅。这套“龙虾”系统运行半年多以来我们团队已经完全告别了手动管理游戏资源的时代。新同事入职不再需要给他传几个 G 的资源包美术更新了一个图标策划和程序能立刻在预览链接上看到效果每次版本发布都是一次安静、可靠、可追溯的自动化过程。技术的价值正是将人从重复、繁琐的劳动中解放出来去从事更有创造性的工作。希望我的这套实践能为你打开一扇自动化项目资源管理的大门。
