发送给我

概述

本技能用于向企业微信发送文本消息。当需要发送消息、报告、通知、告警等任何需要向我发送消息的场景时，都可以使用此技能。

作者微信公众号：XiaoqiangClub

配置教程：https://xiaoqiangclub.blog.csdn.net/article/details/144614019

特点

• - 使用广泛验证的 python-dotenv 库: 稳定可靠的 .env 配置解析
• CLI 支持: 提供命令行工具，可直接终端调用
• 灵活配置: 支持命令行参数、环境变量、.env 文件配置
• 美化格式: 内置多种消息格式模板，支持 emoji 和结构化内容
• 指定接收人: 支持通过参数或配置文件指定消息接收人

快速开始

1. 安装依赖

bash
pip install python-dotenv

2. 配置企业微信

首次使用需要配置企业微信参数，详见：配置教程

bash

复制配置文件

cp env_example.txt .env

编辑 .env 文件，填入你的企业微信配置

3. 发送消息

bash

发送简单消息

python scripts/send_message.py 你好，这是一条测试消息

指定消息来源

python scripts/send_message.py 备份任务已完成 -s 📦 数据备份服务

指定接收人（发送给指定用户，多个用 | 分隔）

python scripts/send_message.py 重要通知 -t zhangsan|lisi

发送给部门

python scripts/send_message.py 部门通知 -p 2

使用格式化模板

python scripts/sendmessage.py $(python -c from scripts.messageformatter import MessageFormatter; print(MessageFormatter.task_report(数据备份, success, 备份完成, 文件大小: 1.2GB)))

配置

配置文件（推荐）

在 skill 目录下创建 .env 文件：

bash
WECOMCORPID=yourcorpid
WECOMCORPSECRET=yourcorpsecret
WECOMAGENTID=youragentid
WECOM_TOUSER=@all
WECOM_SENDER=🎸 XiaoqiangClub

如何获取配置信息？请阅读：
https://xiaoqiangclub.blog.csdn.net/article/details/144614019

环境变量

bash

Windows

set WECOMCORPID=yourcorpid
set WECOMCORPSECRET=yourcorpsecret
set WECOMAGENTID=youragentid

Linux/Mac

export WECOMCORPID=yourcorpid export WECOMCORPSECRET=yourcorpsecret export WECOMAGENTID=youragentid

命令行参数

bash
python scripts/sendmessage.py 消息内容 -c corpid -k corpsecret -a agentid

配置优先级

命令行参数 > 环境变量 > .env 文件

接收人配置 (touser / toparty / totag)

企业微信支持三种接收方式，可以组合使用：

参数	说明	示例
touser	指定用户账号	zhangsan 或 zhangsan\	lisi\	wangwu
toparty

指定部门 ID | 2 或 2\|3\|4 |
| totag | 指定标签 ID | 1 或 1\|2\|3 |
| @all | 发送给所有人 | touser=@all |

注意：touser、toparty、totag 至少要有一个非空，否则消息无法送达

如何获取用户账号？

企业微信管理后台 → 通讯录 → 查看用户的 账号 字段

消息来源 (sender)

sender 参数用于标识消息的发送来源，让接收者知道这条消息是从哪个服务/系统/应用发出的。

sender 命名建议

场景	sender 示例	说明
定时任务	📦 数据备份服务	标识备份任务发送的消息
监控系统

🚨 系统监控中心 | 标识监控告警消息 | | CI/CD | 🔄 CI/CD 流水线 | 标识构建/部署消息 | | 数据分析 | 📊 数据分析平台 | 标识报表消息 | | 定时脚本 | ⏰ 定时清理任务 | 标识定时任务消息 | | 通用机器人 | 🎸 XiaoqiangClub | 通用自动发送的消息 |

使用示例

python
from scripts.sendmessage import sendwechat_message

sendwechatmessage(
message=备份任务已完成,
sender=📦 数据备份服务
)

消息格式模板

本 skill 内置了 MessageFormatter 类，提供多种预设的消息格式：

1. 任务报告 (task_report)

适用于定期任务执行结果的汇报。

python
from scripts.message_formatter import MessageFormatter

message = MessageFormatter.task_report(
task_name=数据备份,
status=success,
message=数据库备份任务已成功完成,
details=备份文件: backup_2024.db\n备份大小: 1.2GB\n耗时: 5分30秒
)

输出效果：

📋 任务报告

━━━━━━━━━━
🏷️ 任务名称: 数据备份
📊 执行状态: ✅ SUCCESS
⏰ 执行时间: 2024-11-04 18:30:00
━━━━━━━━━━

📝 简要说明: 数据库备份任务已成功完成

📌 详细信息:
备份文件: backup_2024.db
备份大小: 1.2GB
耗时: 5分30秒

2. 任务通知 (job_notification)

适用于实时任务状态变更通知。

python
message = MessageFormatter.job_notification(
job_name=每日报表生成,
event=completed,
message=已生成今日报表，请查收附件。
)

输出效果：

🚀 任务通知

━━━━━━━━━━
📦 任务名称: 每日报表生成
📌 事件类型: 🏁 COMPLETED
⏰ 通知时间: 2024-11-04 18:30:00
━━━━━━━━━━

已生成今日报表，请查收附件。

3. 系统告警 (system_alert)

适用于系统异常或告警信息的推送。

python
message = MessageFormatter.system_alert(
level=error,
title=数据库连接失败,
message=主数据库连接超时，请检查网络和数据库状态。,
details=1. 检查数据库服务器状态\n2. 检查防火墙规则\n3. 查看数据库日志
)

输出效果：

🚨 系统告警

━━━━━━━━━━
⚠️ 告警级别: 🟠 错误 ❌
📌 告警标题: 数据库连接失败
⏰ 发生时间: 2024-11-04 18:30:00
━━━━━━━━━━

📝 告警内容:
主数据库连接超时，请检查网络和数据库状态。

📌 处理建议:

1. 1. 检查数据库服务器状态
2. 检查防火墙规则
3. 查看数据库日志

4. 每日汇总 (daily_summary)

适用于日报、周报等汇总信息。

python
message = MessageFormatter.daily_summary(
date=2024-11-04,
stats={
处理任务: 128 个,
成功: 125 个,
失败: 3 个,
总耗时: 2小时30分
},
highlights=- 优化了数据处理流程，处理速度提升20%\n- 修复了定时任务的时区问题
)

输出效果：

📊 每日汇总

━━━━━━━━━━
📅 汇总日期: 2024-11-04
⏰ 生成时间: 2024-11-04 18:30:00
━━━━━━━━━━

📈 统计数据:
• 处理任务: 128 个
• 成功: 125 个
• 失败: 3 个
• 总耗时: 2小时30分

✨ 今日要点:

• - 优化了数据处理流程，处理速度提升20%
• 修复了定时任务的时区问题