Feishu User

飞书用户与身份查询

Standalone Wrapper

• 共享环境变量：FEISHU_APP_ID、FEISHU_APP_SECRET，可选 FEISHU_BASE_URL、FEISHU_OAUTH_STORE_DIR
• 用户授权会持久化到共享 token store；同一 FEISHU_APP_ID 下其他已安装 skill 会复用，不需要重复授权
• feishu_get_user -> node scripts/user.js get-user '<json>'
• feishu_search_user -> node scripts/user.js search-user '<json>'

执行前必读

• 本 skill 只做“用户身份信息查询”，不读聊天记录，也不发消息
• feishu_get_user 不传 user_id 时获取“当前登录用户”；传了 user_id 时获取“指定用户”
• user_id_type 默认 open_id；除非你明确拿到的是 union_id 或 user_id，否则不要改
• 所有结果都受当前用户的组织架构可见范围影响；看不到的人，工具也查不到

快速索引：意图 → 工具 → 必填参数

核心约束（Schema 未透露的知识）

1. “当前用户” 和 “指定用户” 走的是两套接口

• 不传 user_id 时，底层走的是“获取登录用户信息”接口，适合确认当前 OAuth 身份
• 传 user_id 时，底层走的是通讯录用户查询接口，适合查同事资料
• 这两种返回结构相近，但语义不同；不要把“当前用户查询”误当成“任意用户查询”

2. user_id_type 只有在你真的知道 ID 类型时才改

传错 user_id_type 常见表现是“查不到人”或返回权限错误。

3. 搜人不是精确过滤，而是关键词搜索

• feishu_search_user 适合姓名、手机号、邮箱的模糊检索
• 结果按搜索相关性返回，不保证是你心里那个人排第一
• 搜索结果多时要检查 has_more 和 page_token

4. 41050 不是 token 坏了，而是组织架构不可见

如果当前用户看不到某个同事的组织架构，按指定用户查询时会直接失败。这个限制来自“当前用户可见范围”，不是应用的全局通讯录权限。

使用场景示例

场景 1：确认当前登录用户

{}

场景 2：按 open_id 查询指定同事

{
  "user_id": "ou_xxx",
  "user_id_type": "open_id"
}

场景 3：按关键词搜索用户并翻页

首次请求：

{
  "query": "张三",
  "page_size": 20
}

继续翻页：

{
  "query": "张三",
  "page_size": 20,
  "page_token": "xxx"
}

常见错误与排查

官方文档参考

• 通讯录 API 总览: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3
• 获取登录用户信息: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/authen-v1/user_info/get
• 获取单个用户信息: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get
• 搜索用户: https://open.feishu.cn/document/ukTMukTMukTM/uMTM4UjLzEDO14yMxgTN