**标签：** WorkBuddyClaw实战 · 百万Credits悬赏 · 腾讯版小龙虾 · Tencent Agent Storage


---

我们组上次准备团建，最麻烦的不是「去哪儿」，是前前后后的资料。

地点和集合信息在一个微信群，住宿确认在另一条消息，活动安排发了个 PDF 但没人知道最新版本在哪儿，团建结束后照片散在每个人手机里，最后想做个回顾短片，素材都很难收齐。

这是一个很普通、很真实的协作困境。问题不是"文件没地方放"，而是：

> **IM 能承接一串任务，但它天然承载不了一个跨几天、多人参与、持续演进的文件工作流。**

这篇文章记录的，就是用三个现成能力把这个窟窿填上的过程——从思路到代码，到一个可用的工具。

![Clipboard_Screenshot_1775798431.png](https://developer.qcloudimg.com/http-save/yehe-9021437/cc7e21825e136edd5dbcac1cb92ec3f6.png)

---

## 方案是什么

三层，每层只做一件事：

```
微信 / WorkBuddy Claw        ← 用户说一句话，Agent 接住
         │  调用 MCP 工具
         ▼
   Token Server（本地后端）   ← 持有 library_secret，签发 accessToken
         │  读写目录 / 文件
         ▼
  Tencent Agent Storage（数据层）       ← 团建资料空间 + 六个标准目录
         │  提供 token 给前端
         ▼
  前端 Web UI                 ← 用户点开链接，浏览 / 上传 / 下载
```

一句话总结：**IM 是控制面，Agent Storage 是数据面，Web UI 是体验层。**

没有文件工作台，WorkBuddy Claw 更像一个会聊天的助手；有了文件工作台，它才有机会把一次团建真正接住。

---

## 插件结构

整套能力封装成一个 CodeBuddy 插件，插件名 `team-agent-storage-workbench`：

```
team-agent-storage-workbench-demo/
├── .codebuddy-plugin/
│   └── plugin.json          ← 插件清单，注册 Skills / Agent / MCP
├── .mcp.json                ← 把后端包装成 MCP Server 供 Agent 调用
├── settings.json            ← 用户凭证配置项（IDE 设置里填写）
├── agents/
│   └── team-trip-agent/AGENT.md
├── skills/
│   ├── setup-space/         ← 初始化团建资料空间
│   ├── list-files/          ← 浏览目录
│   ├── query-schedule/      ← 查询活动日程
│   ├── archive-media/       ← 按日期归档照片/视频
│   ├── generate-review-kit/ ← 生成短片素材包
│   └── open-drive/          ← 获取资料包入口链接
├── backend/
│   ├── server.js            ← Token Server（HTTP，供前端调用）
│   └── mcp-server.js        ← MCP Server（stdio，供 Agent 调用）
├── bin/
│   └── start.js             ← 插件激活时自动启动 Token Server
└── frontend/
    └── index.html           ← 文件工作台 Web UI（纯 HTML，零依赖）
```

`plugin.json` 声明插件身份：

```json
{
  "name": "team-agent-storage-workbench",
  "version": "1.0.0",
  "description": "给 WorkBuddy Claw 配一个文件工作台",
  "category": "效率工具",
  "skills": [
    "skills/setup-space",
    "skills/list-files",
    "skills/query-schedule",
    "skills/archive-media",
    "skills/generate-review-kit",
    "skills/open-drive"
  ],
  "agents": ["agents/team-trip-agent"],
  "hooks": "./hooks/hooks.json"
}
```

---

## 核心设计一：Token 安全边界

**前端绝不能持有 `library_secret`**，这是 Agent Storage 接入最重要的安全原则。

所有 accessToken 必须由后端签发，有效期 7200s，Token Server 在本地运行（`localhost:3000`），内部有 cache，快过期时自动刷新：

```js
// backend/server.js — POST /api/token
app.post('/api/token', async (req, res) => {
  const { spaceId } = req.body
  const token = await getSpaceToken(spaceId)  // cache + 自动刷新
  res.json({ accessToken: token, expiresIn: 7200 })
})
```

前端只需要实现一个 `getAccessToken` 函数，传给 Web UI 组件：

```js
async function fetchAccessToken(spaceId) {
  const resp = await fetch('http://localhost:3000/api/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ spaceId }),
  })
  const data = await resp.json()
  return { accessToken: data.accessToken, expiresIn: data.expiresIn }
}
```

Agent 调用的管理接口（目录创建、文件移动、文本写入）则需要 `<ADMIN_TOKEN>` 鉴权，只有后端持有，前端完全拿不到。

---

## 核心设计二：MCP Server 让 Agent 直接操作文件

`backend/mcp-server.js` 通过 stdio 协议运行，`.mcp.json` 声明后 CodeBuddy 会在 Agent 需要时自动拉起：

```json
{
  "mcpServers": {
    "team-agent-storage-workbench": {
      "command": "node",
      "args": ["./backend/mcp-server.js"],
      "env": {
        "STORAGE_LIBRARY_ID": "${STORAGE_LIBRARY_ID}",
        "STORAGE_LIBRARY_SECRET": "${STORAGE_LIBRARY_SECRET}",
        "STORAGE_BASE_PATH": "${STORAGE_BASE_PATH}"
      }
    }
  }
}
```

MCP Server 暴露 6 个工具，对应团建全流程：

| MCP 工具 | 做什么 |
|----------|--------|
| `setup_space` | 在 spaceId 下预建 6 个标准目录，返回 driveUrl |
| `list_files` | 列出指定目录内容 |
| `archive_media` | 批量移动照片/视频到 `大家上传/Day1` 等子目录 |
| `upload_text` | 把 AI 生成的文案写入 Agent Storage（如 `review-kit.md`）|
| `get_download_url` | 获取文件临时链接，用于读取活动安排 |
| `open_drive` | 返回文件工作台入口链接 |

每个 Skill 是一个 `SKILL.md`，用自然语言告诉 Agent 调哪个工具、怎么回复用户。比如 `archive-media/SKILL.md` 的核心：

```markdown
1. 确认对话上下文中的 spaceId，若无则提示先初始化空间
2. 询问用户归档目标（Day1 / Day2 / 自定义日期）
3. 调用 MCP 工具 archive_media，传入 spaceId 和 day
4. 返回归档结果摘要，并附上资料包入口链接
```

---

## 核心设计三：前端 Web UI

文件工作台是一个纯 HTML 页面（`frontend/index.html`），不需要 npm install，不需要构建，用 Python 起一个静态服务就能跑：

```bash
cd frontend && python3 -m http.server 3001
```

Agent 返回的资料包链接格式是：

```
http://localhost:3001/index.html?spaceId=spacexxxx
```

页面从 URL 读取 `spaceId`，向 Token Server 请求 token，然后直接调 Agent Storage API 展示文件列表。
点击目录进入子目录，面包屑导航跟着更新，随时可以点「🏠 根目录」返回。

上传文件有进度条，完成后自动刷新，底部日志实时显示每次 PUT 请求的文件名、大小和结果。

---

## 跑一遍完整流程

### 前提条件

- Node.js >= 18
- 一个 Agent Storage 媒体库：在腾讯云控制台创建，拿到 `libraryId`、`librarySecret` 和专属 API 域名

### Step 1：配置凭证

```bash
cd backend
cp .env.example .env
```

编辑 `.env`：

```bash
STORAGE_LIBRARY_ID=xxx-xxxxx
STORAGE_LIBRARY_SECRET=your_library_secret_here
STORAGE_BASE_PATH=https://XXX.xxx.com
ADMIN_TOKEN=pick-any-string-as-admin-token
DRIVE_BASE_URL=http://localhost:3001
```

### Step 2：启动 Token Server

```bash
npm install && node server.js
```

看到这个输出说明配置正确：

```
✅  Token Server  →  http://localhost:3000
    Library      :  xxx-xxxxx
    Base         :  https://XXX.xxx.com
```

### Step 3：验证连通性

```bash
curl http://localhost:3000/health
# {"ok":true,"lib":"xxx-xxxxx","base":"https://..."}
```

### Step 4：准备 spaceId（两种方式）

`spaceId` 是 Agent Storage 媒体库下一个独立存储空间的 ID，通过接口生成，不需要去控制台手动操作。插件支持两种模式：

**模式 A：自动创建新空间（推荐第一次使用）**

不传 `spaceId`，传一个 `spaceName`，后端会调 Agent Storage API 创建新空间并返回 `spaceId`：

```bash
curl -X POST http://localhost:3000/api/space/setup \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-admin-token" \
  -d '{
    "spaceName": "2026 Q2 团建",
    "dirs": ["00-总览","01-行程安排","02-交通住宿","03-活动当天","04-照片视频","05-报销归档","06-回顾短片素材"]
  }'
```

**模式 B：指定已有空间**

已经有一个 `spaceId`（比如之前建过的）可以直接传入，跳过创建步骤：

```bash
curl -X POST http://localhost:3000/api/space/setup \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-admin-token" \
  -d '{
    "spaceId": "spaceXXXXXX"
  }'
```

两种模式返回结构相同：

```json
{
  "spaceId": "spaceXXXXXX",
  "driveUrl": "http://localhost:3001/index.html?spaceId=spaceXXXXXX"
}
```

> 💡 **`spaceId` 要记下来**，后续所有操作（浏览文件、归档照片、打开工作台）都需要用到它。Agent 会把它存入对话上下文，不需要每次手动传。

### Step 5：打开文件工作台

```bash
cd frontend && python3 -m http.server 3001
# 浏览器打开：http://localhost:3001/index.html?spaceId=your-space-id
```

### Step 7：安装 CodeBuddy 插件

```bash
codebuddy --plugin-dir ./team-agent-storage-workbench-demo
```

然后在 WorkBuddy Claw 里说一句：

```
/team-agent-storage-workbench:setup-space 2026 Q2 团建
```

Agent 调用 MCP 工具，创建空间、预建目录，回复：

> ✅ 已创建 6/6 个目录：前期准备、活动安排、大家上传、精选素材、回顾短片素材、报销归档
> 📂 资料包入口：http://localhost:3001/index.html?spaceId=spaceXXX

---

## 一次完整的团建协同对话

装好插件之后，整个链路是这样的：

**出发前一周**

> 用户：帮我把这次团建的地点、集合信息整理进资料空间，给我打开入口
>
> Agent：✅ 已整理到「前期准备」目录
> 📂 打开资料包：http://localhost:3001/index.html?spaceId=spaceXXX

**活动当天**

> 用户：今天下午几点集合，活动顺序是什么？
>
> Agent：（读取 `活动安排/Day1.md`）今天下午 14:00 在酒店大堂集合：
> - 14:30 出发去景区
> - 16:00 团队挑战赛
> - 18:30 团建晚宴
>
> 📂 完整日程：http://localhost:3001/index.html?spaceId=spaceXXX

> 用户：把刚刚大家发来的照片归到 Day1 目录里
>
> Agent：✅ 已将 23 张照片 / 5 个视频移动至 `大家上传/Day1/`

**活动结束后**

> 用户：整理一个团建回顾短片的素材包
>
> Agent：（扫描精选素材，生成分镜建议）
> ✅ 素材包已整理，保存在 `回顾短片素材/review-kit.md`
> 📂 查看素材包：http://localhost:3001/index.html?spaceId=spaceXXX

整个过程，Agent 始终操作同一个 `spaceId`，资料在同一个空间里持续沉淀，不会随对话结束丢失。**这就是有了 Storage 之后，Agent 能做到、但没有 Storage 时做不到的事情。**

---

## 几个值得注意的细节

**Token cache**：每次调用 Agent Storage 签发接口有成本，`server.js` 按 `spaceId` 缓存 token，剩余 < 60s 才重新签发，避免频繁请求。

**MCP Server 和 Token Server 是两个独立进程**：MCP Server（stdio）只在 Agent 调用时启动；Token Server（HTTP）是常驻服务，前端页面打开时调用。两者都持有 `library_secret`，但职责完全分开。

**`access_token` 用 query param**：在实际验证中，Agent Storage API 用 `?access_token=xxx` 方式最稳定，`Authorization: Bearer` header 在部分接口上行为不一致。

**`409` 是正常状态码**：批量创建目录时，目录已存在返回 409，代码里把 409 也当成功处理（幂等），重复调用 `setup_space` 不会报错。

---

## 下一步还能做什么

这个工具当前还很简单，每一层都还有明显的延伸空间：

**数据层**
- 多人协作：为团队里每个人签发独立的 `userId` token，实现文件操作的归属追踪（谁上传了哪张照片）
- 搜索：Agent Storage 支持全文检索，接入后用户可以直接问"找一下有没有 Day2 的集体照"

**Agent 层**
- 接入 WorkBuddy 的日程能力，让 `query-schedule` 不只是读文件，还能主动在活动当天推送提醒
- 结合腾讯云数智视频，让 `generate-review-kit` 从"输出素材清单"升级到"直接生成一条粗剪短片"

**体验层**
- 前端从纯 HTML 换成 `agent-storage-space-drive` 正式组件，获得网格视图、视频在线预览、临时分享链接等完整能力
- 把文件工作台的链接直接内嵌到 WorkBuddy 消息卡片里，用户不需要单独打开浏览器

---

## 最后

Agent 的价值不只在"回答"，还在"承接"。

当 WorkBuddy Claw 负责把任务接进来，Tencent Agent Storage 负责把资料稳稳接住，Web UI 负责把结果交到用户面前时——一句微信消息，就有机会变成一条真正闭环的工作流。

对团队协作这样的场景来说，这个答案值得验证一次。

---

## 参考资料
- [CodeBuddy 插件开发文档](https://www.codebuddy.ai/docs/zh/cli/plugins)
- [Tencent Agent Storage Skill](https://www.skillhub.cn/skills/tencent-agent-storage)

标签： WorkBuddyClaw实战 · 百万Credits悬赏 · 腾讯版小龙虾 · Tencent Agent Storage

WorkBuddy Claw + Agent Storage：微信一句话，AI 帮我们组织团建

团建资料总是散在群聊、手机和电脑里——这不是"没地方放文件"的问题，而是 IM 天然承载不了一个跨几天持续演进的文件工作流。本文展示了解法：把 WorkBuddy Claw（IM 控制面）、Tencent Agent Storage（存储数据面）和一个纯 HTML 文件工作台（体验层）拼在一起，封装为一个 CodeBuddy 插件

人工智能

职业发展

后端

WorkBuddyClaw团队协作解决方案：通过IM控制面+AgentStorage数据面+WebUI体验层三层架构，实现团建资料一站式管理。提供文件工作台、自动归档、素材整理等功能，解决跨平台协作痛点。支持Token安全鉴权、MCPServer文件操作、纯HTML前端零依赖部署，让团队协作真正闭环。

Python

Agent

JSON

2026采购季 | AI焕新·智启新局

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

WorkBuddy Claw + Agent Storage：微信一句话，AI 帮我们组织团建-腾讯云开发者社区-腾讯云

WorkBuddy Claw + Agent Storage：微信一句话，AI 帮我们组织团建

WorkBuddy Claw + Agent Storage：微信一句话，AI 帮我们组织团建

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐