catalog/repos/adaptyteam--adapty-cli.md

127 lines
3.3 KiB
Markdown
Raw Normal View History

2026-04-07 11:44:56 +08:00
# 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