钉钉通讯录与联系人查询。当用户提到"钉钉通讯录"、"查找员工"、"搜索用户"、"查用户信息"、"获取用户详情"、"用户手机号"、"员工姓名"、"员工工号"、"查部门"、"搜索部门"、"部门成员"、"部门列表"、"部门详情"、"子部门"、"父部门"、"部门路径"、"员工总数"、"通讯录搜索"、"userId 转 unionId"、"unionId 转 userId"、"dingtalk contact"、"dingtalk directory"、"find user"、"get user info"、"department members"时使用此技能。支持：按关键词搜索用户/部门、获取用户完整信息（姓名/手机/工号/部门/职位/unionId）、获取部门成员列表、获取部门树结构、查询用户所在部门路径、员工总人数统计等全部通讯录操作。
凭证禁止在输出中完整打印，确认时仅显示前 4 位 +
| 配置键 | 必填 | 说明 | 如何获取 |
|---|---|---|---|
| DINGTALKAPPKEY | ✅ | 应用 AppKey | 钉钉开放平台 → 应用管理 → 凭证信息 |
| DINGTALKAPPSECRET |
| 标识 | 说明 |
|---|---|
| userId（= staffId） | 企业内部员工 ID，可通过通过管理后台 -> 通讯录 -> 成员管理 -> 点击姓名查看 |
| unionId |
TARGET_UID=$(echo $SEARCH | grep -o list:\[[^] | grep -o [^]$ | tr -d )
DETAIL=$(curl -s -X POST https://oapi.dingtalk.com/topapi/v2/user/get?accesstoken=${OLDTOKEN} \
-H Content-Type: application/json \
-d {\userid\:\$TARGETUID\,\language\:\zhCN\})
echo 用户详情: $DETAIL
确定好要做什么之后，用以下命令从 references/api.md 中提取对应章节的完整 API 细节（请求格式、参数说明、返回值示例）： bash grep -A 30 ^## 1. 按关键词搜索用户 references/api.md grep -A 50 ^## 2. 获取用户完整详情 references/api.md grep -A 20 ^## 3. unionId → userId 转换 references/api.md grep -A 18 ^## 4. 企业员工总人数 references/api.md grep -A 25 ^## 5. 按关键词搜索部门 references/api.md grep -A 25 ^## 6. 获取子部门列表 references/api.md grep -A 20 ^## 7. 获取子部门 ID 列表 references/api.md grep -A 25 ^## 8. 获取部门详情 references/api.md grep -A 40 ^## 9. 获取部门成员完整列表 references/api.md grep -A 18 ^## 10. 获取部门成员 userId 列表 references/api.md grep -A 20 ^## 11. 获取用户所在部门路径 references/api.md grep -A 12 ^## 错误码 references/api.md grep -A 6 ^## 所需应用权限 references/api.mdToken 失效处理：dt_helper 仅按时间缓存，无法感知 token 被提前吊销。若 API 返回 errcode 40001/40014（token 无效/过期），用 --nocache 跳过缓存强制重新获取：
bash
OLD_TOKEN=$(bash $HELPER --old-token --nocache) # 强制重新获取旧版 token
NEW_TOKEN=$(bash $HELPER --token --nocache) # 强制重新获取新版 tokenreferences/api.md 查阅索引
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 dingtalk-contact-1776110949 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 dingtalk-contact-1776110949 技能
skillhub install dingtalk-contact-1776110949
文件大小: 9.44 KB | 发布时间: 2026-4-15 12:29
