dws钉钉通讯录查询经验

# dws钉钉通讯录查询经验

## 背景

知识库整理业务系统负责人、研发负责人、运维负责人时，需要从钉钉通讯录核对人员身份，避免同名人员写错。

## 前置检查

```shell
dws auth status --format json
dws profile list --format json
```

判断标准：

- `authenticated=true` 表示当前 `dws` 已登录。
- 当前账号应是知识库所属组织下的账号。
- 查询、读取类操作必须加 `--format json`，便于结构化提取字段。

## 查询流程

### 1. 按姓名搜索

```shell
dws contact user search --query "姓名" --format json
```

关注字段：

| 字段 | 用途 |
| --- | --- |
| `name` | 姓名 |
| `nick` | 昵称 / 组织内展示名 |
| `title` | 岗位 |
| `userId` | 钉钉用户 ID，后续详情查询使用 |
| `openDingTalkId` | 钉钉开放 ID |

### 2. 按 userId 查详情

```shell
dws contact user get --user-id "userId" --format json
```

关注字段：

| 字段 | 用途 |
| --- | --- |
| `orgEmployeeModel.orgUserName` | 组织内姓名 |
| `orgEmployeeModel.orgUserId` | 组织内 userId |
| `orgEmployeeModel.jobNumber` | 工号 |
| `orgEmployeeModel.orgName` | 组织 |
| `orgEmployeeModel.depts[].deptName` | 部门 |
| `orgEmployeeModel.orgTitle` | 岗位 |
| `orgEmployeeModel.orgMasterDisplayName` | 上级 |
| `orgEmployeeModel.orgMasterUserId` | 上级 userId |
| `labels[].name` | 权限标签 |
| `isAdmin` | 是否管理员 |

## 本次实践

| 姓名 | 选用 userId | 部门 | 岗位 | 说明 |
| --- | --- | --- | --- | --- |
| 杨超 | `80921` | IT技术组 | 服务器运维工程师 | 知识库所有者 / 主人 / 运维负责人 |
| 曾雪 | `1642262121855980` | IT业务组 | 资金产品经理 | GTMS 业务负责人 |
| 李光鑫 | `47766` | IT技术组 | Java工程师 | GTMS 研发负责人 |
| 张静 | `45270` | IT业务组 | 供应链系统经理 | SRM 业务负责人 |
| 唐海军 | `45271` | IT技术组 | Java工程师 | SRM 研发负责人 |
| 罗衡 | `59539` | IT技术组 | 服务器运维工程师 | 运维工程师 / 堡垒机相关沟通 |

## 重名处理

- 搜索结果有多个人时，不要直接取第一条。
- 结合业务系统上下文、岗位、昵称、部门确认目标人。
- 在人员页记录“重名处理”说明，后续复查时能知道为什么选这个 userId。

示例：

- `杨超` 搜索到多位同名人员，知识库主人选用 `userId=80921`、昵称 `杨超(基础架构)`、岗位 `服务器运维工程师`。
- `张静` 搜索到多位同名人员，SRM 业务负责人选用 `userId=45270`、昵称 `张静(数字化中心)`、岗位 `供应链系统经理`。

## 知识库落档方式

人员信息统一写入 `09-人员信息`：

```text
09-人员信息/
├── 人员信息总览.md
├── 杨超.md
├── 曾雪.md
├── 李光鑫.md
├── 张静.md
├── 唐海军.md
└── 罗衡.md
```

人员页建议字段：

```markdown
## 基本信息

| 项目 | 内容 |
| --- | --- |
| 姓名 |  |
| 钉钉 userId | `` |
| 钉钉 openDingTalkId | `` |
| 工号 | `` |
| 组织 |  |
| 部门 |  |
| 岗位 |  |
| 上级 |  |
| 上级 userId | `` |
| 权限标签 |  |
| 是否管理员 |  |
| 钉钉查询时间 |  |
```

## 双链规则

- 业务系统负责人字段使用人员链接，例如 `[[09-人员信息/曾雪]]`。
- 人员页反向记录关联系统和角色。
- 人员总览汇总部门、岗位、userId、关联系统。

## 注意事项

- 查询输出可能包含多个组织或多个同名人员，要先确认业务语境。
- 知识库可以记录账号和内部资料，但消息中的临时 token、cookie 不建议原文展开，除非明确需要。
- 所有查询命令统一带 `--format json`。

## 适用位置

- [[09-人员信息/人员信息总览]]
- [[09-人员信息/杨超]]
- [[09-人员信息/罗衡]]