# @dimension-studios/ttk-proxy 中文文档

规范地址：https://npmcn.com/package/%40dimension-studios/ttk-proxy/

版本：1\.223\.0
npm 元数据更新时间：2026-11-10T17:14:37.348Z
中文译文更新时间：2026-11-12T09:54:07.397Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dimension-studios/ttk-proxy
原文对照：https://npmcn.com/package/%40dimension-studios/ttk-proxy/?lang=original
项目主页：https://github.com/dimension-studios-inc/dimension#readme
源码仓库：https://github.com/dimension-studios-inc/dimension

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：12.9 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2025-12-01T11:23:02.700Z
- 最新版本发布：2026-11-10T17:14:37.040Z
- 近 30 天下载量：5852（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：699（近 12 个月 699 个）

## 中文简介

TikTok 代理 API 的 CLI 工具

## 安装

```sh
npm install @dimension-studios/ttk-proxy
```

也可以使用：`pnpm add @dimension-studios/ttk-proxy`、`yarn add @dimension-studios/ttk-proxy`、`bun add @dimension-studios/ttk-proxy`

## README

# @ dimension- studios/ttk- 代理服务器

TikTok 代理 API 的 CLI 工具 - 一个简单的命令行接口,可以与 TikTok 代理服务交互.

## 安装

```bash
npm install -g @dimension-studios/ttk-proxy
```

## 配置

使用CLI 软件 `conf` 存储您的 API 证书。 您可以以两种方式配置:

### 1\. 使用环境变量(建议)

设置以下环境变量:

```bash
export TTK_FETCH_API_URL="https://your-api-url.com"
export TTK_FETCH_API_KEY="your-api-key"
export TTK_FETCH_API_SECRET="your-api-secret"
```

然后运行配置命令以保存它们 :

```bash
ttk-proxy config
```

### 2\. 使用国家综合指数

```bash
ttk-proxy config:set apiUrl "https://your-api-url.com"
ttk-proxy config:set apiKey "your-api-key"
ttk-proxy config:set apiSecret "your-api-secret"
```

### 查看当前配置

```bash
ttk-proxy config --show
```

### 清除配置

```bash
ttk-proxy config --clear
```

## 使用量

### 列出 TikTok 代理托肯斯

列出所有可用的 TikTok 代理符 :

```bash
ttk-proxy list
```

### 搜索店(按名称或子弹)

搜索商店 您的 API 令牌可以访问( 需要) `GET /ttk-proxy/shops/search` 在节点API上:

```bash
ttk-proxy shops coffee
```

### 调用 TikTok 代理 API

给TikTok代理API打电话

```bash
ttk-proxy call '{"shopId":"your-shop-id","url":"https://api.tiktok.com/endpoint","method":"GET"}'
```

较复杂身体的例子 :

```bash
ttk-proxy call '{
  "shopId": "shop-123",
  "url": "https://api.tiktok.com/v1/shops/products",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json"
  },
  "unofficialApi": {
    "addCookieToHeaders": true,
    "signUrl": true
  }
}'
```

#### 基础64 支助

也可以通过JSON正体作为基础64-编码字符串. CLI会自动检测并解码:

```bash
# First encode your JSON to base64
echo -n '{"shopId":"shop-123","url":"https://api.tiktok.com/endpoint","method":"GET"}' | base64

# Then pass it directly to the CLI
ttk-proxy call "eyJzaG9wSWQiOiJzaG9wLTEyMyIsInVybCI6Imh0dHBzOi8vYXBpLnRpa3Rvay5jb20vZW5kcG9pbnQiLCJtZXRob2QiOiJHRVQifQ=="
```

这在从JSON已经基数64-编码的日志或其他来源复制请求体时有用.

## 产出

CLI 打印出要 stdout 的普通信件, 错误要 stderr .

示例输出 :

```
🚀 Calling TikTok Proxy API at https://your-api-url.com...
✅ Status: 200 OK

📦 Response:
{
  "code": 0,
  "data": {
    "products": [...]
  },
  "message": "success"
}
```

## API 参考

### 图标

#### `ttk-proxy call <body>`

给TikTok代理API打电话,并配有JSON尸体.

-   **参数 :**
    -   `body` (字符串):用于请求的字符串JSON正体(可以是生JSON或基数64-编码JSON)

#### `ttk-proxy list`

列出所有 TikTok 代理符 .

#### `ttk-proxy shops <query>`

为您的 API 令牌授权的搜索店( )`GET /ttk-proxy/shops/search` 在你的节点API。 在 `query`。 。 。 .

#### `ttk-proxy get-cookies <shopId>`

为给定的店名获取 cookie JSON( 呼叫) `POST /ttk-proxy/get-cookies`) (中文(简体) ).

-   **选项 :**
    -   `-i, --allow-invalid`: 返回存储的饼干, 即使没有标记槽有效

#### `ttk-proxy config`

管理配置.

-   **选项 :**
    -   `-s, --show`: 显示当前配置
    -   `-c, --clear`: 清除所有配置

#### `ttk-proxy config:set <key> <value>`

设定配置值 .

-   **参数 :**
    -   `key` (字符串):配置密钥(`apiUrl`, (中文(简体) ), `apiKey`,或 `apiSecret`(中文(简体) )
    -   `value` (字符串):配置值

## 发展

### 设置

```bash
# Install dependencies (repo root)
bun install

# Build the package
bun run --cwd tools/ttk-proxy build

# Run type checking
bun run --cwd tools/ttk-proxy type-check

# Development mode (watch)
bun run --cwd tools/ttk-proxy dev
```

### 本地测试

```bash
# After building, run the CLI from the repo root
node tools/ttk-proxy/bin/cli.js --help
```

## 许可证

公务员制度委员会

## 作者

尺寸工作室

## 支助

关于议题和问题,请在 GitHub 存储器上打开一个问题.

## 常见问题

### @dimension-studios/ttk-proxy 是什么？

TikTok 代理 API 的 CLI 工具

### 如何安装 @dimension-studios/ttk-proxy？

在项目目录运行 npm install @dimension-studios/ttk-proxy，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ttk-proxy，可以用 npx ttk-proxy 直接运行。

### @dimension-studios/ttk-proxy 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dimension-studios/ttk-proxy 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dimension-studios/ttk-proxy 可以商用吗？

@dimension-studios/ttk-proxy 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dimension-studios/ttk-proxy 的下载量有多少？

根据 npm 官方下载统计，@dimension-studios/ttk-proxy 在 2026/10/13 – 2026/11/11 这 30 天内被下载 5,852 次，日均约 195 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dimension-studios/ttk-proxy 还在维护吗？

最新版本 1\.223\.0 发布于 2026/11/11（1 天前）；至今共发布 699 个版本，其中过去 12 个月发布了 699 个；首次发布于 2025/12/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。