@cloudglab/yapi-cli 0.0.1 → 0.0.2

package/skills/yapi-cli/reference/auth.md

@@ -4,8 +4,8 @@
 
 在调用任何认证或用户管理命令前，先判断用户意图：
 
-1. **配置初始化** → 新用户首次使用，需要 `--server` + `--token`（或后面再 login）
-2. **登录** → 区分 token 登录 vs 密码登录（LDAP/本地账号均走密码登录）
+1. **配置初始化** → 新用户首次使用，需要 `--url` + `--username` + `--password`，可选 `--auth-mode`
+2. **登录** → 区分 token 登录 vs 密码登录（普通 native / LDAP）
 3. **查看当前用户** → `whoami`，不需要参数
 4. **用户管理** → 管理员操作，需要确认是否有权限
 
@@ -14,31 +14,36 @@
 ### 初始化配置
 
 ```bash
-yapi config-init --server https://yapi.example.com --token <token>
-yapi config-init --server https://yapi.example.com --email <email> --password <password>
+yapi config-init --url https://yapi.example.com --username user@example.com --password secret
+yapi config-init --url https://yapi.example.com --username user@example.com --password secret --auth-mode ldap
 ```
 
-- `--server`：YApi 服务地址（必填）
-- `--token`：API Token（认证用，二选一）
-- `--email` + `--password`：账号密码（认证用，二选一）
-- `--projectId`：默认项目 ID（可选）
+- `--url`：YApi 服务地址（必填）
+- `--username`：登录用户名（通常是邮箱）
+- `--password`：登录密码
+- `--auth-mode`：认证方式，支持 `native` / `ldap`
+
+如果不传 `--auth-mode`，`install` / `config-init` 会在交互终端里提示你选择：普通登录还是 LDAP 登录。
 
 ### Token 登录
 
 ```bash
 yapi login --token <token>
-yapi login-by-token --token <token> --uid <uid>
+yapi login-by-token --token <token>
 ```
 
-`login-by-token` 需要同时传 `--uid` 用于设置 `_yapi_uid` cookie。
+`login-by-token` 用于快速校验 token；`uid` 会从 JWT 中自动提取。
 
 ### 密码登录
 
 ```bash
+yapi login
+yapi login --username <username> --password <password>
 yapi login --email <email> --password <password>
+yapi login --username <username> --password <password> --ldap true
 ```
 
-支持 LDAP 和本地账号。YApi 服务端统一处理认证方式。
+不带参数时，默认读取 `~/.yapi/config.json` 里的 `username/password/authMode` 登录。
 
 ### 登出
 
@@ -97,10 +102,12 @@ yapi user-upload-avatar --uid <uid> --imagePath <path> --confirm true
 
 | 参数名 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
-| `server` | string | config-init | YApi 服务地址 |
+| `url` | string | config-init | YApi 服务地址 |
 | `token` | string | login 二选一 | API Token |
-| `email` | string | login 二选一 | 登录邮箱 |
-| `password` | string | login 二选一 | 登录密码 |
+| `username` | string | config-init/login | 登录用户名（通常是邮箱） |
+| `email` | string | login 兼容别名 | 登录邮箱 |
+| `password` | string | config-init/login | 登录密码 |
+| `authMode` | string | config-init | `native` / `ldap` |
 | `uid` | number | user-delete/avatar | 用户 ID |
 | `username` | string | user-register | 用户名 |
 | `confirm` | boolean | 写操作 | 确认执行 |

package/skills/yapi-cli/reference/commands.md

@@ -12,10 +12,10 @@
 
 | 场景 | 命令 | 用法 | 说明 |
 | --- | --- | --- | --- |
-| 初始化配置 | `config-init` | `yapi config-init --server <url> [--token <t>] [--projectId <id>]` | 首次使用必做 |
+| 初始化配置 | `config-init` | `yapi config-init --url <url> --username <u> --password <p> [--authMode native]` | 首次使用必做 |
 | Token 登录 | `login` | `yapi login --token <t>` | 用 token 认证 |
-| 密码登录 | `login` | `yapi login --email <e> --password <p>` | LDAP/本地账号均可 |
-| Token 快捷登录 | `login-by-token` | `yapi login-by-token --token <t> [--uid <uid>]` | 纯 token 登录 |
+| 密码登录 | `login` | `yapi login [--username <u>] [--email <e>] [--password <p>] [--ldap true]` | 不带参数时使用配置文件 |
+| Token 快捷登录 | `login-by-token` | `yapi login-by-token --token <t>` | 纯 token 登录 |
 | 登出 | `logout` | `yapi logout` | 清除本地认证缓存 + 服务端登出 |
 | 查看当前用户 | `whoami` | `yapi whoami` | 返回当前用户信息 |
 

package/skills/yapi-cli/reference/install.md

@@ -6,10 +6,13 @@
 
 ```bash
 yapi install
-yapi install --server https://yapi.example.com --token <token>
+yapi install --url https://yapi.example.com --username user@example.com --password secret
+yapi install --url https://yapi.example.com --username user@example.com --password secret --auth-mode ldap
 npx -y @cloudglab/yapi-cli@latest install
 ```
 
+如果不传 `--auth-mode`，`install` 会在交互终端里提示你选择：`native` 普通登录，或 `ldap` 登录。
+
 仅 skill：
 
 ```bash
@@ -19,7 +22,7 @@ yapi install --skill-only
 仅 CLI 配置：
 
 ```bash
-yapi install --cli-only --server https://yapi.example.com --token <token>
+yapi install --cli-only --url https://yapi.example.com --username user@example.com --password secret --auth-mode native
 ```
 
 从源码安装 skill：

package/skills/yapi-cli/reference/overview.md

@@ -41,9 +41,10 @@ src/
 
 ## 认证方式
 
-- **Token 认证**：通过 `login --token <t>` 或 `config-init --token <t>` 设置
-- **JWT Cookie 认证**：通过 `login --email <e> --password <p>` 密码登录（支持 LDAP/本地账号）
-- **LDAP 专用**：`login --email <e> --password <p>`，YApi 服务端自动识别 LDAP 并处理 PBKDF2 加密
+- **配置文件**：`~/.yapi/config.json` 只保留 `url`、`username`、`password`、`authMode`
+- **Token 认证**：通过 `login --token <t>` 临时写入认证缓存，不写入配置文件
+- **Native 账号登录**：通过 `login` 或 `login --username <u> --password <p>` 发起 `/api/user/login`
+- **LDAP 登录**：通过 `login --ldap true` 或配置 `authMode=ldap` 发起 `/api/user/login_by_ldap`
 
 ## 配置位置