钉钉消息样式 Skill

提升钉钉消息的视觉效果和交互体验，支持智能格式选择、模板库、@提醒。

官方文档: https://open.dingtalk.com/document/development/robot-message-type

支持的消息类型

类型	图片	按钮	@提醒	最佳场景
text	❌	❌	✅	简单通知
markdown	❌	❌	✅	报告、表格、列表
link	✅	❌	❌	商品推荐、文章分享
actionCard	✅	✅	❌	操作确认、选择菜单
feedCard	✅	❌	❌	多图文列表

⚠️ 注意: Webhook 方式不支持纯图片(image)类型，需要图片请使用 Link 或 FeedCard

快速开始

1. 基础发送

# 文本消息
python3 ~/.copaw/skills/dingtalk-message-style/scripts/send_dingtalk.py text "内容"

# Markdown（支持表格）
python3 .../send_dingtalk.py markdown "标题" "### 内容\n| 列1 | 列2 |\n|-----|-----|\n| A | B |"

# Link 卡片（带图片）
python3 .../send_dingtalk.py link "标题" "描述" "图片URL" "跳转URL"

# 单按钮 ActionCard
python3 .../send_dingtalk.py action "标题" "描述" "按钮标题" "按钮URL"

# 多按钮 ActionCard（横向排列）
python3 .../send_dingtalk.py action_multi "标题" "描述" '[{"title":"按钮1","actionURL":"url1"},{"title":"按钮2","actionURL":"url2"}]' --btn-orientation 1

# 多图文 FeedCard
python3 .../send_dingtalk.py feed '[{"title":"标题1","picURL":"图片1","messageURL":"链接1"}]'

2. @提醒功能

# @所有人
python3 .../send_dingtalk.py markdown "标题" "内容 @所有人" --at-all

# @指定手机号
python3 .../send_dingtalk.py markdown "标题" "内容 @138xxxx" --at-mobiles "138xxxx,139xxxx"

# @指定用户ID
python3 .../send_dingtalk.py text "内容" --at-user-ids "user1,user2"

3. 使用模板

# 查看模板列表
python3 ~/.copaw/skills/dingtalk-message-style/scripts/smart_send.py --list

# 商品推荐
python3 .../smart_send.py --template goods_recommend --vars '{"商品名":"iPhone","价格":"5999","亮点":"最新款","描述":"性能强劲","图片URL":"...","商品链接":"..."}'

# 任务报告
python3 .../smart_send.py --template task_report --vars '{"时间":"2026-03-18","任务表格":"|任务|状态|\\n|A|✅|","完成数":"1","总数":"1","总结":"完成"}'

# 降价提醒
python3 .../smart_send.py --template price_alert --vars '{"商品名":"iPhone","原价":"6999","现价":"5999","降幅":"1000","图片URL":"...","商品链接":"..."}'

模板库

模板	类型	说明
`goods_recommend`	Link	单商品推荐
`goods_list`	FeedCard	多商品列表
`price_alert`	Link	降价提醒
`task_report`	Markdown	任务报告
`order_status`	Markdown	订单状态
`daily_summary`	Markdown	每日总结
`meeting_notice`	ActionCard	会议通知
`confirm_action`	ActionCard	操作确认
`alert_notify`	Markdown	告警通知
`shopping_cart`	Markdown	购物车提醒

智能格式选择

自动根据内容选择最佳格式：

from smart_send import SmartSender

# 多商品 → FeedCard
sender = SmartSender()
sender.add_product("商品1", "图片1", "链接1", "¥99")
sender.add_product("商品2", "图片2", "链接2", "¥199")
sender.analyze_and_send()  # 自动选 FeedCard

# 单商品+图片+链接 → Link
sender = SmartSender()
sender.add_product("商品", "图片", "链接", "¥99", "描述")
sender.analyze_and_send()  # 自动选 Link

# 内容+@提醒 → Markdown
sender = SmartSender()
sender.set_title("告警")
sender.set_content("CPU超过90%")
sender.at(mobiles=["138xxxx"], at_all=False)
sender.analyze_and_send()  # 自动选 Markdown

按钮排列方向

ActionCard 多按钮支持两种排列：

# 竖直排列（默认）
--btn-orientation 0

# 横向排列
--btn-orientation 1

图片链接处理

淘宝图片 URL 需去掉 _.webp 后缀：

# 自动处理
fix_taobao_image_url(url)  # xxx.jpg_.webp → xxx.jpg

Markdown 支持的语法

语法	支持	说明
标题 `#`	✅	支持 h1-h6
粗体 `**`	✅
引用 `>`	✅
链接 `[]()`	✅
代码 `	✅
列表 `-`	✅
图片 `![]()`	❌	请用 Link/FeedCard

文件结构

~/.copaw/skills/dingtalk-message-style/
├── SKILL.md
├── _meta.json
├── scripts/
│   ├── send_dingtalk.py    # 基础发送
│   └── smart_send.py       # 智能发送+模板
└── templates/
    └── templates.json      # 模板定义

常见问题

Q: 为什么图片不显示？

Markdown 不支持图片，请用 Link 或 FeedCard
淘宝图片需去掉 _.webp 后缀

Q: 如何@所有人？

A: 使用 --at-all 参数

Q: 如何让按钮横向排列？

A: 使用 --btn-orientation 1

版本: 1.1.0 | 更新: 2026-03-18

钉钉消息样式

安装技能