hashSTACS-Global feishu-im-message
直接用 exec 执行，不要检查文件或环境。
重要：此 skill 以用户身份发送消息，对方看到的发送者是用户本人。调用前必须确认发送对象和消息内容。
发送消息
# 发本地图片（自动上传后发送）
node ./message.js --open-id "ou_xxx" --action send \
--receive-id-type open_id --receive-id "ou_yyy" \
--image-path "/path/to/image.png"
# 发私信给某人（open_id）
node ./message.js --open-id "ou_xxx" --action send \
--receive-id-type open_id --receive-id "ou_yyy" \
--msg-type text --content '{"text":"你好"}'
# 发消息到群聊（chat_id）
node ./message.js --open-id "ou_xxx" --action send \
--receive-id-type chat_id --receive-id "oc_xxx" \
--msg-type text --content '{"text":"大家好"}'
# 发富文本（post）
node ./message.js --open-id "ou_xxx" --action send \
--receive-id-type open_id --receive-id "ou_yyy" \
--msg-type post --content '{"zh_cn":{"title":"标题","content":[[{"tag":"text","text":"正文内容"}]]}}'
返回字段：message_id、chat_id、create_time。
回复消息
# 回复消息
node ./message.js --open-id "ou_xxx" --action reply \
--message-id "om_xxx" --msg-type text --content '{"text":"收到"}'
# 以话题形式回复
node ./message.js --open-id "ou_xxx" --action reply \
--message-id "om_xxx" --msg-type text --content '{"text":"回复"}' \
--reply-in-thread true
返回字段：message_id、chat_id、create_time。
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--open-id |
是 | 当前用户 open_id |
--action |
是 | send / reply |
| send 参数 | ||
--receive-id-type |
send 必填 | open_id（私聊）/ chat_id（群聊） |
--receive-id |
send 必填 | 接收者 ID，与 receive-id-type 对应 |
--msg-type |
是 | text / post / image / file / interactive 等 |
--content |
是 | 消息内容（JSON 字符串） |
--uuid |
可选 | 幂等 ID，1 小时内相同 uuid 只发一条 |
--image-path |
可选 | 本地图片路径，自动上传后以 image 类型发送（不需同时传 --msg-type 和 --content）。路径必须在允许目录内，见下方说明 |
| reply 参数 | ||
--message-id |
reply 必填 | 被回复消息 ID（om_xxx） |
--reply-in-thread |
可选 | true=话题回复，默认 false |
content 格式示例
| msg_type | content |
|---|---|
text |
{"text":"消息内容"} |
post |
{"zh_cn":{"title":"标题","content":[[{"tag":"text","text":"正文"}]]}} |
image |
{"image_key":"img_xxx"} |
file |
{"file_key":"file_xxx"} |
图片路径限制
--image-path 只允许读取以下目录内的文件：
/tmp/~/.enclaws/media~/.enclaws/tenants/（含所有租户的 workspace，如~/.enclaws/tenants/{tenant_id}/users/{user_id}/workspace/）
其他路径会返回 path_not_allowed 错误。
典型场景
- 用户要求以自己身份发消息给某人 →
send --receive-id-type open_id - 用户要求以自己身份发消息到群 →
send --receive-id-type chat_id（先用 feishu-chat 搜索群组获取 chat_id） - 用户要求回复某条消息 →
reply --message-id
授权
若返回 {"error":"auth_required"} 或 {"error":"permission_required"}，不要询问用户是否授权，直接立即执行以下命令发送授权链接：
- 若返回 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 字段内容原样发送给用户。