Saltar al contenido
Marketplace

wecomcli-contact

de wecomteam

使用 wecom-cli 按姓名、拼音、英文名或别名搜索企业微信通讯录中的人员，并查询匹配人员的 userid、部门和职务。适用于查找联系人、区分同名人员、获取用户 userid，以及列出全部同名人员。

Resumen

SKILL.mdLeída en c4b9b66

企业微信联系人搜索

执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。

使用 wecom-cli 按关键词搜索企业微信通讯录中的人员。

接口

按关键词批量模糊搜索人员，一次最多 10 个关键词，返回命中 users 数组（姓名 / 英文名 / 职务 / 部门）。关键词可匹配的字段包括：姓名（用户名）、姓名拼音、英文名、别名，而不仅限于中文名和别名。

命令
wecom-cli contact users search --json '<JSON 参数>'
参数
字段类型必填默认值语义
keywordsstring[]是—搜索关键词列表，可按姓名（用户名）/ 拼音 / 英文名 / 别名匹配，最多 10 个；多个关键词之间是 OR 关系
search_modestring否—搜索模式，默认不传该参数；仅当需要拿到完整人员名单时，才显式传 "list"
  • 默认（不传 search_mode）：返回最相关的候选结果，用于常规按名 / 拼音等查单个人的场景，绝大多数场景走此分支。
  • 传 search_mode = "list"：返回全量命中列表。仅当用户明确要"完整名单"时才传，典型话术如"一共有几个张三 / 所有叫李四的人 / 列出全部同名 / 全部同名人员"等清点、穷举意图；此时不受"前 5 位"展示上限约束。
返回
字段类型说明
usersarray命中的用户列表
users[].useridstring用户唯一标识
users[].namestring中文姓名
users[].aliasstring英文名 / 别名（可能为空）
users[].emailstring邮箱（可能为空）
users[].positionstring管理职务（如"负责人"），不是"职位"（可能为空）
users[].matched_keywordsstring[]本条 user 命中的请求关键词
users[].departmentsstring[]所在部门路径列表（从大到小），主部门靠前
hintstring结果限制提示（可能为空）：当某个关键词的命中结果因限制未完整返回时，接口会在此字段给出说明
users_countintegerusers 数组元素数量
使用规则
  • 歧义展示上限：同一关键词下候选超过 5 位时，只展示前 5 位（附姓名 / 英文名 / 职务等区分信息），告知用户"若目标不在其中可要求『查看更多』"，仅在用户明确要求时再展开下一批；
  • 展示顺序：必须严格按照接口返回 users 数组的原始顺序展示，不得自行随机排序、重排或打乱次序。
  • 结果限制提示：当返回中 hint 字段非空时，必须在回复中告知用户"当前返回内容有限，仅返回了部分结果"，并可结合 hint 内容说明受限原因。

缺少参数

必填参数缺失（未提供搜索关键词）且上下文无法推断时，用简洁自然语言向用户追问缺失信息，不得猜测默认值。

Archivos 1 archivo

Instálala a mano

Deska ejecuta esto por ti, para cada agente que elijas. Para ejecutarlo tú en una terminal:

npx skills add wecomteam/wecom-cli --skill wecomcli-contact

Más de wecomteam

  • wecomcli-docwecomteam企业微信在线 doc 文档技能。能够新建 doc、导入本地 .doc/.docx/.txt 为 doc、读取 doc 内容、向 doc 追加或覆盖写入。仅当用户明确出现「doc」「docx」「word」「在线文档」「office 文档」等强类型词，或提供 https://doc.weixin.qq.com/doc/xxx 链接时才使用本技能。用户说"文档""新建文档""写文档""整理成文档""输出到文档"等未指定类型的泛化表达，一律使用 wecomcli-smartpage。22.3 k instalaciones en skills.sh0
  • wecomcli-todowecomteam管理企业微信待办，支持创建、删除或退出、完成、查询和筛选，以及修改标题、描述、参与人名单和截止时间。22.1 k instalaciones en skills.sh0
  • wecomcli-meetingwecomteam企业微信会议管理。本技能负责『在线会议』——即含在线会议链接（含会议号/入会链接、可远程或视频参会）的会议的创建、查询、搜索、获取详情（含会议信息、纪要、待办）、查询会议转写原文（逐字发言记录）、更新、取消等全部操作；若用户要的是不含在线会议链接的『日程』（也涵盖纯线下面对面碰头），改用 wecomcli-calendar 技能。用户仅说'开会/约个会/某会/某会议'等、未明确要创建的是日程还是在线会议时，必须先读取本技能并按其中的消歧流程向用户追问确认后再处理，不可臆断直接创建。22 k instalaciones en skills.sh0
  • wecomcli-smartsheetwecomteam企业微信智能表格内容操作技能——专注于智能表格（smartsheet）的数据、结构与样式管理：读取表结构与记录、管理子表/字段/记录/视图/图表，以及修改行列样式（填色/高亮）；记录新增或更新遇到 851003 / no authority 时通过 Webhook 兜底写入。触发条件：用户提到智能表格、企微表格、smartsheet 的内容操作或样式修改，或链接形如 https://doc.weixin.qq.com/smartsheet/s3_xxx。企业微信表格分为「智能表格」和「在线表格」两种类型，本文档介绍的是智能表格的相关技能。智能表格包含子表（sheet）、视图（view）、字段/列（field），每条记录（record）以 `record_id` 作为主键，结构类似关系型数据库。当用户未明确说明使用「在线表格」时，一律默认使用功能更强大的智能表格（本技能）。17.5 k instalaciones en skills.sh0
  • wecom-unifiedwecomteam企业微信全能套件，覆盖通讯录、文档、在线表格、智能表格、智能文档、日程、会议、待办、微盘、邮件、消息、媒体文件等业务域。链接包含 doc.weixin.qq.com 或 page.weixin.qq.com 必触发。提及企业微信或命中以下功能必触发：查找联系人信息。搜索、重命名和授权文档，新建与读写 doc 在线文档，创建与修改在线表格，创建/导入并读写智能表格的子表/字段/记录/视图/图表及填色、高亮等样式，创建与编辑智能文档（含表单和数据看板），创建/查询/修改/取消日程并查询闲忙、办公楼和会议室，预约与管理在线会议（含纪要、待办与转写原文），创建/查询/修改/完成/删除或退出待办，搜索和上传微盘文件、下载离线文件、重命名支持的文件及新建文件夹，发送/回复/转发与搜索阅读邮件，向当前授权人或最近活跃会话发送文本/Markdown/图片/文件/语音/视频消息，以及上传下载媒体文件。即使未明确提到「企业微信」，只要涉及找人/文档/表格/日程/会议/待办/微盘/邮件/发消息等办公场景，也应触发本技能。未指定类型的「文档」默认使用智能文档；未明确「在线表格」的「表格」默认使用智能表格。链接包含 drive.weixin.qq.com 必触发12.5 k instalaciones en skills.sh0
Todas las skills de wecomteam