hashSTACS-Global feishu-chat
模块兼容：所有脚本均提供
.js和.mjs两个版本。优先使用.js，若报require is not defined错误则改用同名.mjs文件。
直接用 exec 执行，不要检查文件或环境。
命令
搜索群组
node ./chat.js --open-id "SENDER_OPEN_ID" --action search --query "群名关键词"
可选：--page-size 20 --page-token "xxx" --user-id-type "open_id"
获取群详情
请求会携带 X-Chat-Custom-Header: enable_chat_list_security_check。
node ./chat.js --open-id "SENDER_OPEN_ID" --action get --chat-id "oc_xxx"
可选：--user-id-type "open_id"
列出群成员
同上安全请求头。返回列表会在脚本侧再次过滤机器人成员。
node ./chat.js --open-id "SENDER_OPEN_ID" --action list_members --chat-id "oc_xxx"
可选：--page-size 20 --page-token "xxx" --user-id-type "open_id"（对应接口的 member_id_type）
输出
脚本输出单行 JSON，将 reply 原样给用户；编排时使用 items / chat 等字段。
权限 scope
| action | scope |
|---|---|
search |
im:chat:readonly |
get |
im:chat:readonly |
list_members |
im:chat:readonly、im:chat.members:read |
与其他技能的编排
| 场景 | 建议流程 |
|---|---|
用户说「把消息发到 XX 群」但未给 chat_id |
feishu-chat search → 选定 chat_id → 使用发消息相关技能 |
| 用户说「看看 XX 群里有谁」 | search → list_members |
| 用户说「把文档发给群里的张三」 | list_members → 从结果中取张三的 open_id |
feishu-im-read 需要 chat_id |
search → get（可选）→ feishu-im-read |
授权
若返回 {"error":"auth_required"} 或 {"error":"permission_required"}（且不含 "auth_type":"tenant"），不要询问用户是否授权，直接立即执行：
- 若返回 JSON 中含
required_scopes，将其用空格拼接后传入--scope：
node ../feishu-auth/auth.js --auth-and-poll --open-id "SENDER_OPEN_ID" --chat-id "CHAT_ID" --timeout 60 --scope "<required_scopes 用空格拼接>"
- 若无
required_scopes，则不加--scope。 {"status":"authorized"}→ 重试原命令；{"status":"polling_timeout"}→ 立即重试同一 auth 命令。CHAT_ID不知道可省略。
权限不足时（应用级）
若返回中含 "auth_type":"tenant"，不要触发用户重新授权（重新授权无法解决应用级权限问题），将 reply 原样发给用户。