42 lines
3.6 KiB
Markdown
42 lines
3.6 KiB
Markdown
# 多组织 / profile
|
||
|
||
> 本文件为 `dingtalk-misc` 内多组织 / profile 产品入口。命令前缀：`dws profile` / `dws auth` / 全局 `--profile`。
|
||
|
||
dws 可同时登录多个钉钉账号，同一组织也可保留多个账号。一个 profile = 一个 `corpId + userId` 身份；当前 profile 决定本次命令注入哪个身份。
|
||
|
||
## 触发条件（命中任一即用本入口）
|
||
|
||
- 显式：用户提到 切换 / 换 / 跨组织、另一个钉钉、别的公司、看登录了哪些组织、当前是哪个组织、某人 / 某群 / 某数据在别的组织
|
||
- 隐式（最常见、易漏）：在当前组织读 / 搜没找到目标（群 / 人 / 数据），且 `dws profile list` 去重后显示已登录 ≥2 个组织 —— 别急着判「不存在」，按下方跨组织铁律去其他组织找
|
||
- 需要跨多个组织汇总 / 对比数据
|
||
- 用户问认证状态 / 登录了哪些组织或账号 / 当前账号是哪个
|
||
|
||
**不触发**：只登录 1 个组织时，按当前组织正常处理，不带 `--profile`。
|
||
|
||
## 命令
|
||
|
||
- `dws profile list --format json` — 默认列出全部账号；`profile` 是稳定选择器 `corpId:userId`，Token 状态现场读取且不刷新
|
||
- `dws profile switch <selector|->` — 持久切换账号；`-` 切回上一个
|
||
- 全局 `--profile <selector>` — 单次指定身份，不改当前 profile
|
||
- `dws auth login` — 新账号新增 profile；同一 `corpId + userId` 重登只刷新该账号
|
||
- `dws auth status [--profile <selector>]` — 查看并按需刷新指定身份；刷新失败返回未认证和真实原因
|
||
|
||
`selector` 支持 `corpId:userId`、`corpId:userName`、`corpName:userId`、`corpName:userName`，也兼容单独的 corpId、唯一 corpName 和本地 profile 名。名称只用于输入；重名时必须按报错候选改用 `profile list` 返回的稳定 `corpId:userId`。
|
||
|
||
只传组织时必须存在唯一 `isOrgCurrent=true` 账号。多账号组织没有默认账号时先让用户指定账号；禁止选择第一项、最近登录或最近使用账号。`primaryProfile/isPrimary` 仅兼容输出，不参与选择。
|
||
|
||
## 跨组织铁律（必须执行，不得跳过）
|
||
|
||
「找群 / 找人 / 找数据」（chat search、aisearch / contact、doc / wiki 搜索等读 / 搜场景）在当前组织没命中、且 `dws profile list` 按 `corpId` 去重后显示 ≥2 个组织时，每个组织使用唯一 `isOrgCurrent=true` 项的 `profile` 各搜一遍；命中即用，全部组织都没有才追问用户。多账号组织没有默认账号时先询问用户。禁止把同一组织的多个账号重复当成多个组织。
|
||
|
||
## 跨组织聚合（agent 编排，无内置 --all-orgs）
|
||
|
||
① `dws profile list --format json` 按 `corpId` 分组 → ② 每组取唯一 `isOrgCurrent=true` 的稳定 `profile`；没有则询问用户 → ③ 对每个稳定 `profile` 各取一次数 → ④ 合并并标注来源组织和账号。
|
||
|
||
## 安全护栏（务必遵守）
|
||
|
||
- 只有 `dws profile list` 按 `corpId` 去重后显示 ≥2 个组织才启用跨组织逻辑；同组织多账号不算多组织。
|
||
- 自动跨组织只对「读 / 搜」。写 / 发 / 删 / 撤回等操作默认只在当前组织做；确需带 `--profile` 跨组织写时，必须先与用户确认目标组织。
|
||
- 持久切换 `dws profile switch`（改默认组织）按写操作对待：未经用户明确要求不得执行。跨组织找数一律用一次性 `--profile`，不改当前组织。
|
||
- `dws auth logout` 默认退出全部账号；组织选择器退出该组织全部账号；精确选择器或本地 profile 名只退出一个账号。执行前必须确认目标范围。
|