# 团队、会话、通知与用量

> 使用 v42 team、invite、session、notify 和 usage 管理团队、成员与邀请、登录会话、Telegram 与电脑通知偏好、套餐用量及兑换码。

`team`、`invite`、`session`、`notify` 和 `usage` 五个命令组用于管理你的[团队](/docs/account/teams)、账号[登录会话](/docs/account/account-and-login)、[通知偏好](/docs/agents/notifications)以及[套餐用量](/docs/account/credits-and-usage)。

## 团队、成员与发出的邀请（`v42 team`）

```sh
v42 team list
v42 team use <team_id>
v42 team show
v42 team create <name>
v42 team rename <name>
v42 team leave --yes
```

- `team list`：列出当前账号所属的全部团队，并标出当前配置档案正在使用的团队。
- `team use <team_id>`：将 `<team_id>` 保存为当前配置档案的默认团队（若只想在单次命令中临时切换团队，可使用全局选项 `--team <uuid>` 或环境变量 `V42_TEAM`）。
- `team show`：查看当前团队的详情，包括你在其中的角色。
- `team create <name>`：创建一个由你拥有的新组织团队（名称 `1` 到 `100` 个字符）。当前生效的团队不会自动切换，如需切换请运行 `v42 team use <team-id>`。
- `team rename <name>`：重命名当前团队（`1` 到 `100` 个字符；仅限团队 Owner）。
- `team leave --yes`：退出当前团队（必须传 `--yes`；团队 Owner 不能退出自己的团队）。

### 团队成员管理（`v42 team members` / `v42 team member`）

```sh
v42 team members
v42 team member set <--role <admin|member> | --can-register <on|off>> <seat>
v42 team member remove <seat> --yes
```

- `team members`：列出当前团队的所有成员席位（seats）。
- `team member set <seat>`：修改某位成员的角色 `--role`（`admin` 或 `member`）或是否允许注册电脑 `--can-register`（`on` 或 `off`）。`<seat>` 可以是 `v42 team members` 中的席位 ID、用户 ID 或邮箱（仅限团队 Owner 或 Admin；不能修改 Owner 的席位）。
- `team member remove <seat> --yes`：将某位成员移出当前团队（仅限团队 Owner 或 Admin；不能移除 Owner；必须传 `--yes`）。

### 发送与管理团队邀请（`v42 team invite`）

```sh
v42 team invite create <email> [--role <admin|member>]
v42 team invite list
v42 team invite revoke <id>
```

- `team invite create <email>`：通过邮箱邀请某人加入当前团队，`--role` 指定加入后的角色（默认 `member`，可选 `admin`；仅限团队 Owner 或 Admin）。命令会输出仅显示一次的一次性邀请 token 和链接，同时向受邀人发送邮件。
- `team invite list`：列出当前团队尚未撤回的邀请。
- `team invite revoke <id>`：撤回尚未被接受的邀请（仅限团队 Owner 或 Admin）。

## 处理发给你的团队邀请（`v42 invite`）

```sh
v42 invite list
v42 invite show --token <token>
v42 invite accept [<id>] [--token <token>]
v42 invite decline <id>
```

- `invite list`：列出发送到你已验证邮箱的待处理团队邀请。
- `invite show --token <token>`：查看邀请链接 token 对应的邀请详情（可传 `#token=` 后面的部分或完整链接），不会直接接受邀请。
- `invite accept [<id>] [--token <token>]`：通过邀请 `<id>`（来自 `v42 invite list`）或 `--token <token>` 接受邀请并加入该团队。当前默认团队不会自动改变，可运行 `v42 team use <team-id>` 切换。
- `invite decline <id>`：拒绝指定的邀请。

## 登录会话管理（`v42 session`）

```sh
v42 session list
v42 session revoke <id> [--yes]
```

- `session list`：列出你账号在网页、桌面与手机 App 以及 CLI 上的所有登录会话；`current: true` 标记当前 CLI 配置档案正在使用的会话。
- `session revoke <id>`：退出某个登录会话，使用该会话的设备必须重新登录。如果撤销的是当前 CLI 配置档案自身正在使用的会话，必须传入 `--yes`（撤销后当前配置档案会退出登录；若本机装有已登录的 Vibe42 桌面 App，下次执行命令时会从桌面 App 重新获取登录状态）。

## 通知管理（`v42 notify`）

```sh
v42 notify status
v42 notify bind [--wait]
v42 notify unbind
v42 notify prefs <computer> [options]
v42 notify events [--limit <limit>]
```

- `notify status`：查看当前账号是否已绑定 Telegram 通知。
- `notify bind [--wait]`：生成一条在 Telegram 中打开的一次性绑定链接（有效期 10 分钟）。加上 `--wait` 会每 3 秒检查一次，直到在 Telegram 中完成绑定或链接过期。如果账号已绑定 Telegram，命令会以 `notify_already_bound` 失败，请先执行 `v42 notify unbind`。
- `notify unbind`：解除当前账号的 Telegram 通知绑定。
- `notify prefs <computer>`：不带选项时查看 `<computer>` 的通知偏好设置。团队 Owner、Admin 或该电脑的拥有者可通过以下选项修改设置：
  - `--enable <types>` / `--disable <types>`：要开启或关闭的事件类型（以逗号分隔，或传 `all`）。支持的事件类型：`terminal_bell`、`terminal_notification`、`agent_confirmation_pending`、`agent_turn_finished`、`agent_error`、`tmux_window_close`、`tmux_pane_close`、`device_tmux_missing`、`device_disconnect`、`session_created`、`session_closed`。
  - `--targets <channels>`：投递渠道（以逗号分隔：`apns`、`fcm`、`telegram`、`webapp`，或传 `all`）。
  - `--bell-throttle <seconds>`：同一终端两次响铃通知之间的最小间隔秒数。
  - `--notification-throttle <seconds>`：同一终端两次终端通知之间的最小间隔秒数。
- `notify events [--limit <limit>]`：按从新到旧的顺序列出最近已投递的通知记录（`1` 到 `100` 条）。

## 套餐用量与优惠兑换码（`v42 usage`）

```sh
v42 usage [--devices]
v42 usage redeem <code> [--preview]
```

- `usage`：查看当前团队在本计费周期内的套餐使用量（仅限团队 Owner 和 Admin）。加上 `--devices` 则改为按设备列出当前统计窗口内的流量和 Credits 消耗。
- `usage redeem <code> [--preview]`：为当前团队兑换优惠码（仅限团队 Owner）。加上 `--preview` 可仅预览该兑换码会赋予的权益而不实际兑换。折扣码（discount code）只能在 Console 购买套餐结账时使用，不能在此处兑换。
