核心用法
Tencent Agent Storage Skill 是一套面向腾讯专属网盘(SMH)的文件管理工具,通过 Node.js 脚本实现本地文件与云端的双向交互。核心功能包括:文件上传(支持单文件/批量/任意大小)、云端目录浏览、文件信息查询与下载链接生成、以及同名文件冲突的智能处理。上传完成后自动生成带签名的 COS 直链,有效期约 2 小时,可直接在浏览器或手机端预览下载。
显著优点
1. 无文件大小限制:采用分片上传机制,大文件(>50MB)按 5MB 分块流传输,不占用内存峰值
2. 灵活的冲突策略:支持 ask(默认询问)、overwrite(覆盖)、rename(自动重命名)三种模式,防止误操作
3. 多重凭证配置:支持 OpenClaw/Hermes 配置文件、环境变量、命令行参数三种方式,兼顾便捷性与临时覆盖需求
4. 跨平台兼容:提供 macOS、Linux、Windows 的 Node.js 安装指南及 npm 全局/本地两种依赖安装方案
5. 隐式触发机制:智能识别"发给我""传到手机"等隐含上传需求的指令,无需用户重复表述
潜在缺点与局限性
- 依赖 Node.js 运行时:要求 Node ≥ 14,首次使用需完成环境检测与 npm 包安装,对非技术用户存在门槛
- Token 权限要求高:必须持有
space_admin级别 accessToken,普通用户可能需向管理员申请 - 链接有效期有限:下载链接仅 2 小时有效,长期分享需重复生成或使用其他方案
- 无文件版本管理:覆盖操作不可逆,无回收站或历史版本恢复机制
- 国内服务依赖:基于腾讯云 SMH 服务,境外网络环境可能存在延迟或访问限制
适合人群
- 需要频繁在手机与电脑间传输文件的跨设备用户
- 希望快速生成临时分享链接、避免使用微信/邮件传文件的场景
- 有自动化备份需求的技术用户或 Agent 工作流集成场景
- 已开通腾讯企业网盘/专属空间的企业成员
常规风险
- 凭证泄露风险:accessToken 具有管理员权限,需妥善保管,避免提交到代码仓库
- 同名误覆盖:虽然默认启用
ask策略,但用户若选择覆盖则无法恢复 - 链接时效误判:用户可能因链接过期而产生"文件丢失"的误解
- 网络稳定性:大文件上传中断后需重新发起,暂不支持断点续传