⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Tigris 对象存储操作指南：上传、下载、删除、列表、预签名 URL 全解析

tigris-object-operations by tigrisdata/skills

44 周安装量

2 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/tigrisdata/skills --skill tigris-object-operations

Node.js 云服务文件管理

🇨🇳中文介绍

Tigris 对象操作

前提条件

在进行任何操作之前，如果尚未安装 Tigris CLI，请先安装：

tigris help || npm install -g @tigrisdata/cli

如果需要安装，请告知用户：“我正在安装 Tigris CLI (@tigrisdata/cli)，以便我们可以使用 Tigris 对象存储。”

概述

Tigris 存储提供对象操作：上传（put）、下载（get）、删除（remove）、列表（list）、元数据（head）和预签名 URL。

所有方法都返回 TigrisStorageResponse<T, E> - 请先检查 error 属性。

快速参考

操作	函数	关键参数
上传	`put(path, body, options)`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

162,100 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

161,200 周安装

Azure 配额管理指南：服务限制、容量验证与配额增加方法

138,600 周安装

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

127,000 周安装

import { put } from "@tigrisdata/storage";

// 简单上传
const result = await put("simple.txt", "Hello, World!");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Uploaded:", result.data?.url);
}

// 大文件上传，带进度
const result = await put("large.mp4", fileStream, {
  multipart: true,
  onUploadProgress: ({ loaded, total, percentage }) => {
    console.log(`${loaded}/${total} bytes (${percentage}%)`);
  },
});

// 防止覆盖
const result = await put("config.json", config, {
  allowOverwrite: false,
});

选项	值	默认值	用途
access	public/private	-	对象可见性
addRandomSuffix	boolean	false	避免命名冲突
allowOverwrite	boolean	true	允许替换现有对象
contentType	string	inferred	MIME 类型
contentDisposition	inline/attachment	inline	下载行为
multipart	boolean	false	为大文件启用
onUploadProgress	callback	-	跟踪上传进度

import { get } from "@tigrisdata/storage";

// 以字符串形式获取
const result = await get("object.txt", "string");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Content:", result.data);
}

// 以文件形式获取（在浏览器中触发下载）
const result = await get("object.pdf", "file", {
  contentDisposition: "attachment",
});

// 以流形式获取
const result = await get("video.mp4", "stream");
const reader = result.data?.getReader();
// 处理流...

选项	值	默认值	用途
contentDisposition	inline/attachment	inline	下载行为
contentType	string	from upload	MIME 类型
encoding	string	utf-8	文本编码
snapshotVersion	string	-	从快照读取

import { remove } from "@tigrisdata/storage";

const result = await remove("object.txt");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Deleted successfully");
}

import { list } from "@tigrisdata/storage";

// 列出所有对象
const result = await list();
console.log("Objects:", result.data?.items);

// 按前缀列出（文件夹）
const result = await list({ prefix: "images/" });

// 分页列出
const allFiles = [];
let currentPage = await list({ limit: 10 });
allFiles.push(...currentPage.data?.items);

while (currentPage.data?.hasMore) {
  currentPage = await list({
    limit: 10,
    paginationToken: currentPage.data?.paginationToken,
  });
  allFiles.push(...currentPage.data?.items);
}

选项	用途
prefix	过滤以指定前缀开头的键
delimiter	分组键（例如，'/' 用于文件夹）
limit	返回的最大对象数（默认值：100）
paginationToken	从上次列表继续
snapshotVersion	从快照列出

对象元数据 (head)

import { head } from "@tigrisdata/storage";

const result = await head("object.txt");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Metadata:", result.data);
  // { path, size, contentType, modified, url, contentDisposition }
}

import { getPresignedUrl } from "@tigrisdata/storage";

// 用于 GET 的预签名 URL（临时访问）
const result = await getPresignedUrl("object.txt", {
  operation: "get",
  expiresIn: 3600, // 1 小时
});
console.log("URL:", result.data?.url);

// 用于 PUT 的预签名 URL（允许客户端上传）
const result = await getPresignedUrl("upload.txt", {
  operation: "put",
  expiresIn: 600, // 10 分钟
});

预签名 URL 选项

选项	值	默认值	用途
operation	get/put	-	URL 用途
expiresIn	秒	3600	URL 过期时间
contentType	string	-	PUT 操作所需

错误	修复方法
未先检查 `error`	在使用 `result.data` 之前始终检查 `if (result.error)`
`get()` 中使用了错误的格式	使用 'string'、'file' 或 'stream'
忘记设置 `multipart: true`	对于大于 100MB 的文件启用
忽略分页	使用 `hasMore` 和 `paginationToken`

对于浏览器上传，请使用客户端包直接上传到 Tigris：

import { upload } from "@tigrisdata/storage/client";

const result = await upload(file.name, file, {
  url: "/api/upload", // 您的后端端点
  onUploadProgress: ({ percentage }) => {
    console.log(`${percentage}%`);
  },
});

有关初始设置，请参阅 file-storage。

2026 年 1 月 23 日

🇺🇸English

Tigris Object Operations

Prerequisites

Before doing anything else , install the Tigris CLI if it's not already available:

tigris help || npm install -g @tigrisdata/cli

If you need to install it, tell the user: "I'm installing the Tigris CLI (@tigrisdata/cli) so we can work with Tigris object storage."

Overview

Tigris Storage provides object operations: upload (put), download (get), delete (remove), list, metadata (head), and presigned URLs.

All methods return TigrisStorageResponse<T, E> - check error property first.

Quick Reference

Operation	Function	Key Parameters
Upload	`put(path, body, options)`	path, body, access, contentType
Download	`get(path, format, options)`	path, format (string/file/stream)
Delete	`remove(path, options)`	path
List	`list(options)`	prefix, limit, paginationToken
Metadata	`head(path, options)`	path
Presigned URL	`getPresignedUrl(path, options)`	path, operation (get/put)

Upload (put)

import { put } from "@tigrisdata/storage";

// Simple upload
const result = await put("simple.txt", "Hello, World!");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Uploaded:", result.data?.url);
}

// Large file with progress
const result = await put("large.mp4", fileStream, {
  multipart: true,
  onUploadProgress: ({ loaded, total, percentage }) => {
    console.log(`${loaded}/${total} bytes (${percentage}%)`);
  },
});

// Prevent overwrite
const result = await put("config.json", config, {
  allowOverwrite: false,
});

Put Options

Option	Values	Default	Purpose
access	public/private	-	Object visibility
addRandomSuffix	boolean	false	Avoid naming collisions
allowOverwrite	boolean	true	Allow replacing existing
contentType	string	inferred	MIME type
contentDisposition	inline/attachment	inline	Download behavior
multipart	boolean	false	Enable for large files
onUploadProgress	callback	-	Track upload progress

Download (get)

import { get } from "@tigrisdata/storage";

// Get as string
const result = await get("object.txt", "string");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Content:", result.data);
}

// Get as file (triggers download in browser)
const result = await get("object.pdf", "file", {
  contentDisposition: "attachment",
});

// Get as stream
const result = await get("video.mp4", "stream");
const reader = result.data?.getReader();
// Process stream...

Get Options

Option	Values	Default	Purpose
contentDisposition	inline/attachment	inline	Download behavior
contentType	string	from upload	MIME type
encoding	string	utf-8	Text encoding
snapshotVersion	string	-	Read from snapshot

Delete (remove)

import { remove } from "@tigrisdata/storage";

const result = await remove("object.txt");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Deleted successfully");
}

List Objects

import { list } from "@tigrisdata/storage";

// List all objects
const result = await list();
console.log("Objects:", result.data?.items);

// List with prefix (folders)
const result = await list({ prefix: "images/" });

// List with pagination
const allFiles = [];
let currentPage = await list({ limit: 10 });
allFiles.push(...currentPage.data?.items);

while (currentPage.data?.hasMore) {
  currentPage = await list({
    limit: 10,
    paginationToken: currentPage.data?.paginationToken,
  });
  allFiles.push(...currentPage.data?.items);
}

List Options

Option	Purpose
prefix	Filter keys starting with prefix
delimiter	Group keys (e.g., '/' for folders)
limit	Max objects to return (default: 100)
paginationToken	Continue from previous list
snapshotVersion	List from snapshot

Object Metadata (head)

import { head } from "@tigrisdata/storage";

const result = await head("object.txt");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Metadata:", result.data);
  // { path, size, contentType, modified, url, contentDisposition }
}

Presigned URLs

import { getPresignedUrl } from "@tigrisdata/storage";

// Presigned URL for GET (temporary access)
const result = await getPresignedUrl("object.txt", {
  operation: "get",
  expiresIn: 3600, // 1 hour
});
console.log("URL:", result.data?.url);

// Presigned URL for PUT (allow client upload)
const result = await getPresignedUrl("upload.txt", {
  operation: "put",
  expiresIn: 600, // 10 minutes
});

Presigned URL Options

Option	Values	Default	Purpose
operation	get/put	-	URL purpose
expiresIn	seconds	3600	URL expiration
contentType	string	-	Require for PUT

Common Mistakes

Mistake	Fix
Not checking `error` first	Always check `if (result.error)` before `result.data`
Wrong format in `get()`	Use 'string', 'file', or 'stream'
Forgetting `multipart: true`	Enable for files >100MB
Ignoring pagination	Use `hasMore` and `paginationToken`

Client-Side Uploads

For browser uploads, use the client package to upload directly to Tigris:

import { upload } from "@tigrisdata/storage/client";

const result = await upload(file.name, file, {
  url: "/api/upload", // Your backend endpoint
  onUploadProgress: ({ percentage }) => {
    console.log(`${percentage}%`);
  },
});

For initial setup, see file-storage.

Weekly Installs

Repository

tigrisdata/skills

GitHub Stars

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex42

opencode42

gemini-cli41

claude-code40

github-copilot39

cursor38

Supabase Postgres 最佳实践指南 - 8大类别性能优化规则与SQL示例

89,100 周安装

Tigris 对象存储操作指南：上传、下载、删除、列表、预签名 URL 全解析

🇨🇳中文介绍

Tigris 对象操作

前提条件

概述

快速参考

相关 Skills

上传 (put)

Put 选项

下载 (get)

Get 选项

删除 (remove)

列出对象

List 选项