tapd-login

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TAPD 登录

TAPD Login

当用户需要为本地 TAPD CLI 配置或清理认证信息时使用此 skill。

This skill is used when users need to configure or clear authentication information for the local TAPD CLI.

使用场景

Usage Scenarios

首次配置 TAPD CLI
```
tapd
```
出现认证错误
用户要求登录、配置 token、绑定凭证或退出登录

First-time configuration of TAPD CLI
Authentication errors occur with
```
tapd
```
Users request to log in, configure tokens, bind credentials, or log out

Recommended Authentication Method

优先引导用户使用 TAPD 个人令牌，只有在用户明确需要开放应用接入时，再引导走应用凭证流程。

Prioritize guiding users to use TAPD Personal Token. Only guide users through the application credential process when they clearly need open application access.

个人令牌获取流程（推荐）

Personal Token Acquisition Process (Recommended)

当用户没有

TAPD_ACCESS_TOKEN

时，引导用户按下面步骤获取：

打开 TAPD 个人令牌页面：

text

https://www.tapd.cn/personal_settings/index?tab=personal_token

点击 “创建个人访问令牌”
按需要填写名称或用途说明
创建后复制令牌

重要提醒：

令牌通常只显示一次
必须让用户当场保存好
后续若丢失，只能重新创建

拿到令牌后，再继续执行登录命令。

When users do not have a

TAPD_ACCESS_TOKEN

, guide them to follow these steps to obtain it:

Open the TAPD Personal Token page:

text

https://www.tapd.cn/personal_settings/index?tab=personal_token

Click "Create Personal Access Token"
Fill in the name or usage description as needed
Copy the token after creation

Important Reminders:

Tokens are usually only displayed once
Users must save the token immediately
If lost later, a new token can only be created

After obtaining the token, proceed to execute the login command.

应用凭证获取流程（备选）

Application Credential Acquisition Process (Alternative)

如果用户明确要使用开放应用模式，引导用户：

在 TAPD 开放平台中创建一个应用
获取以下信息：
- ```
client_id
```
- ```
client_secret
```
- ```
company_id
```
确认这些值可用于 CLI 登录后，再继续执行登录命令

如果用户并不确定该选哪种方式，默认回到个人令牌方案，不要优先推荐应用凭证。

If users clearly want to use the open application mode, guide them to:

Create an application in the TAPD Open Platform
Obtain the following information:
- ```
client_id
```
- ```
client_secret
```
- ```
company_id
```
Confirm these values can be used for CLI login before proceeding to execute the login command

If users are unsure which method to choose, default back to the personal token scheme; do not prioritize recommending application credentials.

执行步骤

Execution Steps

先确认用户是否已经拿到凭证：
- 个人令牌模式：需要
```
TAPD_ACCESS_TOKEN
```
  和一个
```
workspace_id
```
- 应用凭证模式：需要
```
client_id
```
  、
```
client_secret
```
  、
```
company_id
```
如果用户还没有凭证，先引导其完成上面的获取流程，不要急着发起需求创建或同步。
如果用户需要登录，执行：

bash

tapd login

如果用户已经提供了参数，优先使用非交互方式：

bash

tapd login --mode personal --personal-token <token> --workspace-id <workspace-id>
tapd login --mode app --client-id <id> --client-secret <secret> --company-id <company-id>

如果用户要清理本地认证信息，执行：

bash

tapd logout

First confirm whether the user has obtained the credentials:
- Personal token mode: Requires
```
TAPD_ACCESS_TOKEN
```
  and a
```
workspace_id
```
- Application credential mode: Requires
```
client_id
```
  ,
```
client_secret
```
  ,
```
company_id
```
If the user does not have credentials yet, first guide them to complete the above acquisition process; do not rush to initiate requirement creation or synchronization.
If the user needs to log in, execute:

bash

tapd login

If the user has provided parameters, prioritize using non-interactive mode:

bash

tapd login --mode personal --personal-token <token> --workspace-id <workspace-id>
tapd login --mode app --client-id <id> --client-secret <secret> --company-id <company-id>

If the user wants to clear local authentication information, execute:

bash

tapd logout

注意事项

Notes

```
tapd login
```
会把凭证写入
```
.tapd/credentials.json
```
个人令牌模式会同时验证一个 workspace
```
tapd logout
```
会删除本地认证文件
用户没有凭证时，先引导获取凭证，再继续创建需求、同步需求或拉取需求

```
tapd login
```
writes credentials to
```
.tapd/credentials.json
```
The personal token mode verifies a workspace simultaneously
```
tapd logout
```
deletes the local authentication file
When users do not have credentials, guide them to obtain credentials first before proceeding to create, synchronize, or pull requirements

tapd-login

Original

Translation

TAPD 登录

TAPD Login

使用场景

Usage Scenarios

推荐认证方式

Recommended Authentication Method

个人令牌获取流程（推荐）

Personal Token Acquisition Process (Recommended)

应用凭证获取流程（备选）

Application Credential Acquisition Process (Alternative)

执行步骤

Execution Steps

注意事项

Notes