Tencent Agent Storage

Tencent Agent Storage 云文件管理工具

核心功能

Tencent Agent Storage 是一款面向 Tencent Agent 生态的云存储管理工具，基于腾讯云智能媒资托管（SMH）服务构建，为用户提供个人专属的云端文件空间。核心功能包括：

• 文件上传与备份：支持本地文件一键上传至云端，自动处理同名冲突（默认重命名策略）
• 智能链接生成：上传完成后自动生成带 COS 签名的直链下载地址，有效期约2小时
• 跨端文件访问：生成的链接可直接在手机、平板、电脑浏览器中打开预览或下载
• 文件管理操作：支持文件列表查询、文件信息获取、下载链接重新生成
• 无限制文件传输：采用分片上传技术，支持多GB大文件，小文件（≤50MB）直传，大文件流式分块处理

显著优点

1. 零配置门槛：凭证从标准配置文件自动读取，支持多种配置来源（~/.tencentAgentStorage/.env、~/.openclaw/openclaw.json、~/.hermes/.env）
2. 安全链接机制：输出带签名的COS直链（*.tencentsmhuc.cn），杜绝 accessToken 泄露风险
3. 智能冲突处理：默认 rename 策略自动重命名同名文件，确保上传成功率；仅在用户明确要求时才覆盖或询问
4. 触发机制完善：覆盖显式关键词（网盘/云盘/上传/备份等）及隐式场景（任务产出文件需交付、跨设备传输意图）
5. 输出规范严格：强制完整输出下载链接，禁止截断；强制附加"有效期2小时"执行通知

潜在局限

• 链接时效性：下载链接有效期约2小时，过期后需重新调用 info 命令生成新链接
• 权限依赖：需 space_admin 级别 accessToken，用户需提前完成腾讯云 SMH 服务配置
• Node.js 环境依赖：运行前需检测并可能安装 Node.js ≥14 及 smh-node-sdk npm包
• 单线程批量处理：多文件上传按顺序执行，非并行，大规模批量传输效率受限
• 配置分散风险：凭证可从多个位置读取，若多配置文件共存可能导致预期外行为

适合人群

• 跨设备办公用户：需要在手机与电脑间快速传输文件、生成临时分享链接
• 自动化工作流用户：Agent 任务产出报告/导出文件后，自动上传云端并交付链接
• 腾讯云生态用户：已使用 Tencent Agent、OpenClaw、Hermes 等配套工具的个人或团队
• 大文件传输需求者：需上传视频、设计稿等多GB级文件，突破传统邮件/即时通讯大小限制

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 凭证泄露 | accessToken 若配置不当可能被脚本误读 | 脚本仅读取 `smh_` 前缀变量，绝不输出含 token 的链接 |

| 链接截断 | 下载链接含签名参数极长，易被误截断 | 强制完整输出规范，禁止 `...` 或 `<省略>` |

| 非预期覆盖 | 用户未明确要求时误用 `overwrite` 策略 | 默认 `rename` 策略，覆盖需显式用户授权 |

| 隐私文件上传 | Agent 可能未经用户确认上传个人文件 | 明确禁止"未经用户主动要求上传本地个人文件" |

| 配置缺失故障 | Node.js 或 SDK 未安装导致执行失败 | 脚本内置环境检测，提供多平台安装指引 |

安全设计亮点

• 最小权限读取：脚本仅访问 smh_* 配置项，隔离其他敏感字段
• 签名直链隔离：对外暴露 COS 签名链接，API 中转链接（含 token）绝不外发
• 失败透明化：所有错误以 JSON 返回，Agent 必须明确告知用户失败原因及选项

核心用法

Tencent Agent Storage Skill 是专为腾讯云智能媒资托管(SMH)打造的客户端工具，主要服务于个人云盘场景。用户通过自然语言触发关键词（如"上传文件"、"生成下载链接"、"看看网盘"等）即可激活该技能，完成本地文件到云端的传输。核心命令包括 upload（上传并返回签名直链）、info（查询文件状态并重置链接）、list（浏览云端目录）。

操作流程遵循四步闭环：识别本地文件路径 → 执行上传脚本 → 提取带COS签名的下载链接 → 交付用户并附加有效期说明。脚本支持智能冲突处理（自动重命名/覆盖/询问），单文件与批量上传均可，且对大文件采用分片传输机制，理论上无大小限制。

显著优点

跨端无缝体验是最大亮点。上传完成后自动生成的签名直链（.tencentsmhuc.cn域名）可在浏览器、手机、平板直接访问，无需安装客户端，真正实现"上传一次，随处下载"。安全设计规范：凭证从用户主目录配置文件读取，禁止硬编码；返回用户的链接均为COS签名URL而非含accessToken的中转链接，降低凭证泄露风险。技术实现成熟*：依赖腾讯云官方smh-node-sdk，网络行为仅限于官方API通信，代码结构清晰，错误处理完善。

潜在缺点与局限性

环境依赖较重：强制要求Node.js ≥14及npm环境，首次使用需完成SDK安装与凭证配置，对非技术用户门槛不低。来源可信度中等：作者为个人开发者(shawnmzhang)，属T3级别社区项目，非企业级官方出品。链接时效性：下载链接有效期约2小时，长期存档需重复获取。路径安全风险：用户输入路径缺乏严格规范化验证，存在路径遍历隐患（尽管实际利用难度较高）。Token权限要求高：需space_admin级别accessToken，最小权限原则难以落实。

适合的目标群体

该技能最适合已有腾讯云SMH服务的个人开发者、内容创作者及跨设备办公人群。对于频繁生成报告、设计稿、视频素材且需要在手机与电脑间流转的用户尤为实用。技术背景用户可快速完成环境配置，非技术用户建议在指导下完成首次设置。不适合对数据主权极度敏感的企业级场景，或完全无Node.js环境的封闭系统。

使用风险

性能风险：大文件分片上传依赖本地磁盘I/O与网络稳定性，中断后无断点续传机制。依赖风险：smh-node-sdk版本更新可能导致兼容性问题；npm全局安装模式可能引发权限冲突。凭证管理风险：accessToken存储于本地明文配置文件，多用户系统存在被其他进程读取的可能。网络风险：虽仅访问腾讯云官方API，但链接生成失败时的回退方案曾存在URL参数传递凭证的隐患（建议已提出）。合规风险：Skill本身不涉及内容审查，用户需自行确保上传内容符合法律法规。