核心功能
Tencent Agent Storage 是基于腾讯云存储（Tencent SMH）的官方 SDK 封装工具，专为 Agent 场景设计，提供本地文件到云端的一站式上传、备份与管理能力。核心命令覆盖单文件/整目录上传、文件信息查询、目录列表、关键词搜索及文件夹创建，满足从个人文档备份到批量数据归档的多元需求。
显著优点
1. 无文件大小限制：采用分片上传机制（>50MB 自动分 5MB 块传输），内存友好，支持 GB 级视频等大文件
2. 智能冲突处理：默认 rename 策略自动规避同名覆盖风险，确保上传成功率；同时支持 overwrite 强制覆盖与 ask 交互确认
3. 安全直链生成：通过 COS 签名生成临时直链（*.tencentsmhuc.cn），有效期可控（默认 2 小时），避免 accessToken 泄露
4. 跨平台兼容：Node.js ≥14 环境即可运行，支持 macOS/Linux/Windows 多系统一键安装
潜在局限
- 依赖 Node.js 环境：首次使用需完成 Node.js 及
smh-node-sdk依赖安装，对纯前端环境不够友好 - 搜索能力有限：仅支持文件名匹配，无全文内容检索
- 链接时效性：下载链接默认 2 小时过期，需重新生成（可通过
info命令刷新） - 单线程顺序上传：批量任务非并行处理，大目录同步效率受限
适合人群
- 需要跨设备文件同步的个人用户
- 需自动化备份报告/生成内容的 Agent 开发者
- 对数据主权敏感、偏好私有云存储的企业用户
常规风险
1. 凭证泄露风险：配置文件中 accessToken 为 space_admin 权限，需妥善保管，避免提交至版本控制
2. 链接传播风险：临时直链虽有时效，但仍可能在有效期内被截获，敏感文件建议配合加密
3. 覆盖误操作：强制使用 overwrite 策略时不可逆，重要数据建议优先 rename 或手动确认