# Adapty 命令行管理工具

`CLI` `订阅管理` `应用内购买` `Node.js` `开发工具`

<a href="https://adapty.io/?utm_source=github&utm_medium=referral&utm_campaign=adapty-cli">
    <img src="https://adapty-portal-media-production.s3.amazonaws.com/github/logo-adapty-new.svg">
</a>

# Adapty CLI

[Adapty 开发者命令行工具](https://adapty.io/docs/developer-cli)。在终端中管理应用、产品、付费墙、投放位置和访问级别。

## 安装

```sh
npm install -g adapty
```

需要 Node.js >= 18。

## 认证

```sh
adapty auth login
```

打开浏览器进行 OAuth 设备流认证。Token 存储于 `~/.config/adapty/config.json`。

可通过 `ADAPTY_TOKEN` 环境变量覆盖：

```sh
ADAPTY_TOKEN=your-token adapty apps list
```

其他认证命令：

```sh
adapty auth whoami     # 验证 token，显示用户信息
adapty auth status     # 显示本地认证状态
adapty auth logout     # 清除本地存储的 token
adapty auth revoke     # 在服务端撤销 token 并清除本地记录
```

## 命令

所有资源命令都需要 `--app APP_ID`（UUID）。使用 `adapty apps list` 查找应用 ID。

### 应用

```sh
adapty apps list [--page N] [--page-size N]
adapty apps get APP_ID
adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app
adapty apps update APP_ID [flags]
```

### 产品

```sh
adapty products list --app UUID [--page N] [--page-size N]
adapty products get --app UUID PRODUCT_ID
adapty products create --app UUID [flags]
adapty products update --app UUID PRODUCT_ID [flags]
```

### 付费墙

```sh
adapty paywalls list --app UUID [--page N] [--page-size N]
adapty paywalls get --app UUID PAYWALL_ID
adapty paywalls create --app UUID --title "Name" --product-id UUID1 [--product-id UUID2]
adapty paywalls update --app UUID PAYWALL_ID [flags]
```

### 投放位置

```sh
adapty placements list --app UUID [--page N] [--page-size N]
adapty placements get --app UUID PLACEMENT_ID
adapty placements create --app UUID [flags]
adapty placements update --app UUID PLACEMENT_ID [flags]
```

### 访问级别

```sh
adapty access-levels list --app UUID [--page N] [--page-size N]
adapty access-levels get --app UUID ACCESS_LEVEL_ID
adapty access-levels create --app UUID [flags]
adapty access-levels update --app UUID ACCESS_LEVEL_ID [flags]
```

### 全局参数

| 参数          | 说明                              |
| ------------- | --------------------------------- |
| `--json`      | 以 JSON 格式输出                  |
| `--help`      | 显示帮助                          |
| `--page`      | 页码（默认：1）                   |
| `--page-size` | 每页条数（默认：20，最大：100）   |

## 环境变量

| 变量             | 说明                                                                              |
| ---------------- | --------------------------------------------------------------------------------- |
| `ADAPTY_TOKEN`   | 覆盖存储的认证 token                                                              |
| `ADAPTY_API_URL` | 覆盖 API 基础地址（默认：`https://api-admin.adapty.io/api/v1/developer`）        |

## Claude Code 技能

为 Claude Code 安装 Adapty CLI 技能：

```sh
npx skills add adaptyteam/adapty-cli --skill adapty-cli
```

## 开发

```sh
pnpm install
pnpm build
./bin/run.js apps list
```

## 许可证

MIT