691b8cdd0c
- 核心配置: IDENTITY, USER, SOUL, AGENTS, TOOLS, HEARTBEAT, MEMORY - memory/: 每日总结和临时记录 - skills/: 所有已安装技能 - notes/: 语音配置笔记
6.6 KiB
6.6 KiB
腾讯云 COS 操作参考
本文档记录三种操作方式的详细参数定义，供执行操作时查阅。
环境设置：首次使用请运行 scripts/setup.sh，详见 SKILL.md 首次使用章节。
官方文档链接：
- cos-mcp GitHub: https://github.com/Tencent/cos-mcp
- COS Node.js SDK: https://www.tencentcloud.com/zh/document/product/436/8629
- COSCMD 工具: https://www.tencentcloud.com/zh/document/product/436/10976
方式一：cos-mcp MCP 工具参数参考
存储操作工具
getCosConfig
获取当前 COS 配置信息。
- 参数：无
putObject
上传本地文件到存储桶。
filePath(string, 必需): 本地文件路径（包含文件名）fileName(string, 可选): 存储桶中的文件名targetDir(string, 可选): 存储桶中的目标目录
putString
上传字符串内容到存储桶。
content(string, 必需): 要上传的字符串内容fileName(string, 必需): 存储桶中的文件名targetDir(string, 可选): 目标目录contentType(string, 可选): MIME 类型，默认text/plain
putBase64
上传 base64 编码内容到存储桶。
base64Content(string, 必需): base64 编码的内容fileName(string, 必需): 存储桶中的文件名targetDir(string, 可选): 目标目录contentType(string, 可选): MIME 类型，如image/png、application/pdf
putBuffer
上传 buffer 内容到存储桶。
content(string, 必需): buffer 内容字符串fileName(string, 必需): 存储桶中的文件名targetDir(string, 可选): 目标目录contentType(string, 可选): MIME 类型，默认application/octet-streamencoding(string, 可选): 编码格式，枚举值:hex|base64|utf8|ascii|binary，默认utf8
putObjectSourceUrl
通过 URL 下载文件并上传到存储桶。
sourceUrl(string, 必需): 可下载的文件 URLfileName(string, 可选): 存储桶中的文件名targetDir(string, 可选): 目标目录
getObject
下载存储桶内的文件。
objectKey(string, 必需): 文件在存储桶中的路径
getBucket
查询存储桶内的文件列表。
Prefix(string, 可选): 路径前缀过滤，默认根路径
getObjectUrl
获取文件的带签名下载链接。
objectKey(string, 必需): 文件在存储桶中的路径
图片处理工具
imageInfo
获取图片元数据信息。
objectKey(string, 必需): 图片在存储桶中的路径
assessQuality
评估图片质量分数。
objectKey(string, 必需): 图片在存储桶中的路径
aiSuperResolution
AI 超分辨率，提升图片分辨率。
objectKey(string, 必需): 图片在存储桶中的路径
aiPicMatting
AI 智能抠图，去除图片背景。
objectKey(string, 必需): 图片在存储桶中的路径width(string, 可选): 输出宽度height(string, 可选): 输出高度
aiQrcode
识别存储桶内图片中的二维码内容。
objectKey(string, 必需): COS 对象键完整路径，如images/qrcode.jpg
waterMarkFont
生成带文字水印的图片。
objectKey(string, 必需): COS 对象键完整路径，如images/photo.jpgtext(string, 可选): 水印文字内容（支持中文），默认test
智能搜索工具
imageSearchPic
以图搜图，从数据集中检索相似图片。
uri(string, 必需): 图片地址
imageSearchText
文本搜图，根据文字描述检索匹配图片。
text(string, 必需): 检索文本
文档与媒体处理工具
createDocToPdfJob
创建文档转 PDF 处理任务。
objectKey(string, 必需): 文档在存储桶中的路径
describeDocProcessJob
查询文档转码任务结果。
jobId(string, 必需): 任务 ID（通过提交文档任务的响应获取）
createMediaSmartCoverJob
创建视频智能封面任务。
objectKey(string, 必需): 视频在存储桶中的路径
describeMediaJob
查询智能封面任务结果。
jobId(string, 必需): 任务 ID（通过提交智能封面任务的响应获取）
方式二：scripts/cos_node.mjs 命令参考
脚本位于 scripts/cos_node.mjs，依赖 cos-nodejs-sdk-v5（npm install cos-nodejs-sdk-v5）。
所有凭证通过环境变量读取。输出 JSON 格式。
可用操作
| 操作 | 命令 | 说明 |
|---|---|---|
| upload | node scripts/cos_node.mjs upload --file <path> --key <key> |
上传本地文件 |
| put-string | node scripts/cos_node.mjs put-string --content <text> --key <key> [--content-type <mime>] |
上传字符串内容 |
| download | node scripts/cos_node.mjs download --key <key> --output <path> |
下载文件到本地 |
| list | node scripts/cos_node.mjs list [--prefix <prefix>] [--max-keys <n>] |
列出文件 |
| sign-url | node scripts/cos_node.mjs sign-url --key <key> [--expires <seconds>] |
获取签名下载链接 |
| delete | node scripts/cos_node.mjs delete --key <key> |
删除文件 |
| head | node scripts/cos_node.mjs head --key <key> |
查看文件元信息 |
返回格式
成功时 success: true，退出码 0；失败时 success: false，退出码 1。
方式三：COSCMD 命令参考
依赖 Python，通过 pip install coscmd 安装。首次使用需配置（写入 ~/.cos.conf，后续无需重复）：
coscmd config -a $TENCENT_COS_SECRET_ID -s $TENCENT_COS_SECRET_KEY -b $TENCENT_COS_BUCKET -r $TENCENT_COS_REGION
常用命令
| 操作 | 命令 | 说明 |
|---|---|---|
| 上传文件 | coscmd upload <localpath> <cospath> |
上传单个文件 |
| 递归上传目录 | coscmd upload -r <localdir> <cosdir> |
上传整个目录 |
| 下载文件 | coscmd download <cospath> <localpath> |
下载单个文件 |
| 递归下载目录 | coscmd download -r <cosdir> <localdir> |
下载整个目录 |
| 列出文件 | coscmd list [cospath] |
列出文件，加 -r 递归 |
| 删除文件 | coscmd delete <cospath> |
删除单个文件 |
| 递归删除 | coscmd delete -r <cosdir> -f |
强制递归删除 |
| 签名 URL | coscmd signurl <cospath> [-t <seconds>] |
获取带签名的下载链接 |
| 文件信息 | coscmd info <cospath> |
查看文件元信息 |
| 复制 | coscmd copy <source> <dest> |
桶内/跨桶复制 |
| 移动 | coscmd move <source> <dest> |
移动文件（复制+删除源） |
全局参数
-c <CONFIG_PATH>：指定配置文件路径（默认~/.cos.conf）-b <BucketName-APPID>：指定存储桶（覆盖配置文件）-r <Region>：指定区域-d：调试模式，输出详细日志