3.6 KiB
多组织 / 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 名只退出一个账号。执行前必须确认目标范围。