腾讯智能体云盘

解决云端文件交付的断层

Agent 在本地生成文件后，常面临交付断层：终端用户无法直接访问执行环境，缺乏便捷的跨设备获取方式。Tencent Agent Storage 针对这一痛点，将本地文件同步至专属云空间，自动生成带签名的下载直链和图片预览，打通从生成到消费的最后一步。

核心能力与工作流

该技能基于 Node.js 脚本（scripts/agent-storage.js）与 smh-node-sdk 运行，核心命令覆盖上传、目录同步、检索及链接重置。

• 无感的冲突处理：默认采用 rename 策略。当云端存在同名文件时，自动追加后缀（如 file(1).pdf），确保流程不中断。仅在用户明确要求时切换至 overwrite 或 ask。
• 流式分块上传：取消了文件大小限制。小于 50MB 的文件直接上传；超过阈值的大文件则自动转为分块模式，按 5MB 粒度读取，避免内存溢出。
• 安全的凭证隔离：脚本从 ~/.tencentAgentStorage/.env 等配置文件加载凭证，严格限制在 smh_ 前缀范围内。返回给用户的链接必须是带 COS 签名的 downloadUrl，禁止使用含 Token 的中转地址。

适用边界与工程注意点

• 权限基线：凭证需具备 space_admin 级别权限，这是云端文件写入的最低门槛。
• 链接时效与安全：默认链接有效期为 2 小时，输出时必须完整展示原始字符串，严禁截断或省略签名参数。
• 检索范围：search 命令仅支持基于文件名的匹配，不涉及文件内容的全文检索。