Tencent Agent Storage

功能概述

Tencent Agent Storage Skill 是一款面向腾讯专属云盘（SMH）的文件管理工具，核心功能包括文件上传、备份、目录浏览、下载链接生成及状态查询。该 Skill 通过 Node.js 脚本与腾讯云 SMH SDK 交互，将本地文件上传至用户专属云空间，并生成带 COS 签名的临时直链供跨端访问。

核心用法

1. 文件上传：通过 upload 命令将本地文件推送到云端，支持单文件与批量处理，默认采用 conflictStrategy: "ask" 策略处理同名冲突
2. 目录管理：list 命令可浏览云端文件结构，支持分页查询
3. 链接生成：info 命令查询文件元数据并重新生成下载链接
4. 智能触发：除显式指令外，当 Agent 检测到任务产出文件需交付、用户暗示跨设备传输等场景时自动激活

显著优点

• 无文件大小限制：小文件单上传、大文件分片上传（>50MB 自动切 5MB 分块），内存友好
• 安全链接机制：返回的下载链接为带签名的 COS 直链（*.tencentsmhuc.cn），不含 accessToken，2 小时有效期可控
• 灵活冲突处理：支持询问/覆盖/重命名三种策略，防止误操作
• 跨平台兼容：支持 OpenClaw 与 Hermes Agent 双框架

局限与风险

• Token 权限敏感：需 space_admin 级别 accessToken，凭证泄露可能导致云盘被完全控制
• 链接时效性：下载链接仅 2 小时有效，需配合 info 命令重新生成
• 网络依赖：上传/下载受腾讯云网络稳定性影响
• 配置复杂度：需手动配置 4 项环境变量，对非技术用户门槛较高

适合人群

• 需频繁在手机/电脑间传输文件的腾讯生态用户
• 依赖 Agent 自动归档任务产出（报告、图片、代码）的自动化工作者
• 对数据主权敏感、倾向私有云存储而非公共网盘的企业用户

安全建议

• 凭证文件设置 600 权限，避免其他用户读取
• 定期轮换 accessToken
• 勿在对话中暴露含 accessToken 的中转链接

核心用法

Tencent Agent Storage（云文件上传备份工具）是专为Agent设计的个人云盘管理技能，打通本地文件与云端存储的桥梁。其核心工作流程涵盖：识别待上传文件路径→执行分片上传（支持多GB大文件）→生成COS签名直链→交付用户跨端访问。支持单文件/批量上传、目录管理、链接重生成等完整操作，通过smh-node-sdk与腾讯云SMH服务深度集成。

使用场景高度自动化：当用户提及"网盘""云盘""龙虾盘"等关键词，或表达"把文件发给我""传到手机"等跨设备传输意图时，Agent自动触发该技能。对于任务产出文件（报告、导出数据、生成内容），Agent可隐式识别交付需求，无需用户重复指令。

显著优点

企业级云存储底座：依托腾讯云SMH（Smart Multi-media Hosting）服务，数据存储具备高可用性与持久性，相比临时文件传输方案更可靠。无上限文件支持：采用5MB分片上传机制，单文件大小无限制，内存占用恒定，轻松处理视频等大型资产。安全凭证管理：SMH访问令牌从用户本地配置文件（~/.tencentAgentStorage/.env等）按需读取，代码零硬编码，符合安全最佳实践。智能冲突处理：默认"询问"策略，同名文件冲突时由用户决策覆盖、重命名或取消，避免误操作。跨端无缝体验：生成的COS签名直链（*.tencentsmhuc.cn）可直接在浏览器、手机、平板打开，2小时有效期平衡安全与便利。

潜在缺点与局限性

网络依赖性强：完全依赖腾讯云SMH服务可用性，网络中断或API限流时功能受阻，无本地降级方案。凭证配置门槛：首次使用需配置4项环境变量（libraryId、accessToken、spaceId、basePath），对非技术用户存在学习成本。链接时效限制：下载链接默认2小时过期，长期分享需用户手动重生成。T3来源可信度：由个人开发者（shawnmzhang）维护，非企业/基金会背书，长期维护承诺与更新频率需社区观察。依赖单一SDK：功能深度绑定smh-node-sdk，若腾讯云调整API或SDK停更，需迁移成本。

适合的目标群体

Agent重度用户：需要将AI生成内容（代码、报告、设计稿）自动归档至个人云盘，实现工作流闭环。多设备办公人群：经常在电脑与手机/平板间传输文件，厌恶微信文件助手等临时方案。内容创作者：管理大量素材、视频、稿件，需要可靠备份与便捷分享链接生成。开发者与知识工作者：熟悉环境变量配置，追求自动化、可脚本化的文件管理流程。

使用风险

凭证泄露风险：配置文件若权限设置不当（非600），可能被系统其他用户读取。建议严格遵循权限加固。Token权限过宽：当前使用space_admin级别accessToken，具备该空间完整管理权限，若泄露后果严重。建议按需申请最小权限。网络超时阻塞：当前实现未配置网络超时，弱网环境下可能长时间挂起。建议生产环境增加超时参数。日志敏感信息：错误处理可能输出完整文件路径，存在隐私泄露风险，建议审查日志脱敏策略。依赖供应链风险：smh-node-sdk的安全更新依赖开发者主动跟进，建议建立季度检查机制。