Tencent Agent Storage (云文件上传备份工具)

Tencent Agent Storage (云文件上传备份工具) 是什么

管理用户专属云盘空间，把本地成果上传、列举、搜索、下载、预览、移动和生成限时分享链接。

适用场景

适合跨设备交付报告、备份项目输出、上传文件夹、搜索历史文件和分享给同事。

核心能力与工作机制

清单提供 upload/uploadDir、info、list、search、mkdir、rename，默认同名自动改名，显式覆盖才用 overwrite，并规范签名链接输出。

执行流程

安装 Node 与 smh-node-sdk，配置 space_admin Token；确认本地路径后上传，读取 JSON 获取 downloadUrl，再查询云端信息并向用户交付有效期说明。

输入与输出

需要本地文件或目录、云端目标路径、冲突策略和访问 Token。输出 JSON、云端文件记录、完整签名下载链接和图片预览。

依赖、账号与权限

依赖 Node.js、smh-node-sdk ^1.0.9、网络和 Tencent Agent Storage 的 space_admin accessToken。

副作用、限制与风险

Token 权限较高，签名链接会授予临时访问；上传可能涉及隐私、版权和大文件流量。会在云端创建目录、上传、重命名、移动或显式覆盖文件；默认 rename 避免覆盖。

不适用边界

禁止输出含 accessToken 的中转链接，未明确要求时不得覆盖同名文件，也不承诺永久链接。

失败处理与验收

网络错误最多按清单策略有限重试，仍失败则说明原因；部分目录上传要报告 failCount 和失败项。通过 info/list 核对路径、大小和文件名，实际打开签名 URL，并确认链接未截断且不含 Token。

适合谁使用

适合需要跨端接收 Agent 产物和云端备份的腾讯生态用户。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.11 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 声明许可证为 MIT。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Tencent Agent Storage (云文件上传备份工具) 主要解决什么问题？

管理用户专属云盘空间，把本地成果上传、列举、搜索、下载、预览、移动和生成限时分享链接。适合跨设备交付报告、备份项目输出、上传文件夹、搜索历史文件和分享给同事。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要本地文件或目录、云端目标路径、冲突策略和访问 Token。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

安装 Node 与 smh-node-sdk，配置 space_admin Token；确认本地路径后上传，读取 JSON 获取 downloadUrl，再查询云端信息并向用户交付有效期说明。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖 Node.js、smh-node-sdk ^1.0.9、网络和 Tencent Agent Storage 的 space_admin accessToken。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会在云端创建目录、上传、重命名、移动或显式覆盖文件；默认 rename 避免覆盖。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

禁止输出含 accessToken 的中转链接，未明确要求时不得覆盖同名文件，也不承诺永久链接。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

网络错误最多按清单策略有限重试，仍失败则说明原因；部分目录上传要报告 failCount 和失败项。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

通过 info/list 核对路径、大小和文件名，实际打开签名 URL，并确认链接未截断且不含 Token。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。