DWS 公共参考（dws-shared）

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。

每个 dingtalk-* 子 skill 都把本 skill 列为 PREREQUISITE：执行任何产品命令前先读这里的认证、全局参数、Schema 命令发现与多组织规则。dws 必须在 PATH 上。

认证

• dws auth login（新账号新增 profile，同一 corpId + userId 重登只刷新该账号）；--device 无头 / SSH 登录
• dws auth status [--profile <selector>] 查看组织当前账号或指定账号；会尝试刷新，失败时保留真实错误
• macOS 出现 ciphertext_key_mismatch 且普通终端仍可登录时：先运行 env -u DWS_DISABLE_KEYCHAIN dws auth migrate-keychain --to file-dek --dry-run --format json，通过后加 --yes 迁移；不要直接 auth reset

全局参数

• 所有命令加 --format json 取可解析输出
• 全局 --profile <selector>：支持 corpId:userId、corpId:userName、corpName:userId、corpName:userName，也兼容单独的 corpId、唯一 corpName 和本地 profile 名；均不改默认 profile
• 以 leaf Schema 的 confirmation 为准：user_required 才先确认并在同意后加 --yes；not_required 不得仅因 effect=write 自行升级确认要求

命令发现：Schema + --help

选择命令、读取参数映射/组合约束与安全语义时，优先渐进查询当前二进制内嵌的 leaf Schema；真正组装参数前，用 --help 确认 Cobra 当前接受的 flags：