Tencent Agent Storage

The Problem It Solves

In many automated or cross-device workflows, a common pain point is securely delivering files generated by an Agent—such as reports, charts, or processed images—to a user on their phone, tablet, or another computer. Sharing file paths is ineffective in cloud environments, while manual transfers break the flow. This skill is designed to solve the problem of secure file delivery and cross-device access.

How It Works: Core Capabilities & Key Steps

This skill takes local files or folders as input, interacts with Tencent Cloud Object Storage via a script to perform the upload, and always returns a time-limited, signed download direct link.

Core capabilities include:
- File Upload: Supports uploading single files (upload) or entire folders recursively (uploadDir), preserving the original directory structure.
- File Management: Provides commands for listing (list), searching (search), creating directories (mkdir), and renaming/moving (rename) to manage files in the cloud.
- Secure Link Generation: The info command regenerates access links for existing files. All download links are temporary COS-signed direct links with a default validity of 2 hours, requiring no extra permission configuration.

A critical part of the workflow is handling upload conflicts. The default strategy is rename (automatically renaming files, e.g., file(1).pdf) to guarantee successful uploads. The overwrite strategy is used only when the user explicitly requests it (e.g., saying "overwrite"). The ask strategy is used only when the user asks for confirmation first.

Constraints & Important Notes

When using this skill, be aware of the following technical constraints and best practices:
- Credentials & Permissions: Execution requires a configured space_admin level access token. The script reads it from smh_-prefixed environment variables in specific paths (e.g., ~/.tencentAgentStorage/.env). Never hardcode or expose credentials.
- Link Specification: Links shown to users must be the complete downloadUrl returned by the script. These are signed URLs with domain *.tencentsmhuc.cn and signature parameters. Never use intermediate links containing access_token, and never truncate link content.
- File Size & Upload: There is no file size limit. Files over 50MB use multipart chunked upload to avoid memory issues, but the upload process is sequential.
- Search Capabilities: File search (search) only matches by filename, not by file content.
- Error Handling: All commands return JSON. When an upload fails, the Agent must clearly inform the user of the error and offer a retry option. Never provide a download link upon failure.