send-to-me

企业微信消息发送工具。当需要发送消息、报告、通知或告警时使用，支持指定消息来源（sender）和接收人（touser）。

Security Scan

The skill's code and instructions implement a straightforward WeCom (企业微信) message sender and align with its description, but the package metadata omitted declaring the required environment variables (secrets) — so verify configs before use.

Purpose & Capability

The name/description (WeCom message sender) matches the included Python code: it formats messages and calls the official qyapi.weixin.qq.com endpoints to get an access token and send messages. There are no unrelated service integrations or unexplained capabilities in the code.

Instruction Scope

SKILL.md and the code limit actions to reading configuration (env/.env/CLI), formatting messages, and making HTTPS requests to the WeCom API. The instructions do not ask the agent to read unrelated system files or send data to unexpected endpoints.

Install Mechanism

No install spec is provided (instruction-only). The documentation requests installing only python-dotenv via pip, which is proportionate for .env support. No downloads from arbitrary URLs or archive extraction are present.

Credentials

The runtime legitimately requires sensitive values (WECOM_CORP_ID, WECOM_CORP_SECRET, WECOM_AGENT_ID) to call the WeCom API; those are present in env_example.txt and referenced in SKILL.md and code. However, the registry metadata lists no required env vars — an inconsistency that could mislead users about the need to supply secrets. Treat the corp secret like any credential: only provide it to code you trust.

Persistence & Privilege

The skill does not request permanent/always-on presence, does not modify other skills or system-wide settings, and has no code that persists credentials beyond normal .env usage. Autonomous invocation defaults are not abused here.

Assessment

This package appears to do only what it says: format messages and call the official WeCom API. Before installing or using it: (1) review the included scripts yourself (they are plain Python and readable); (2) do not paste your WECOM_CORP_SECRET or other credentials into public places — store them in a local .env or environment variables; (3) note the registry metadata did not declare required env vars, so be sure to supply WECOM_CORP_ID, WECOM_CORP_SECRET, and WECOM_AGENT_ID when running; (4) verify you trust the source/blog link if you plan to run this in production or supply sensitive credentials; and (5) consider testing in an isolated environment or using an account with limited privileges when first evaluating.

概述

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

作者微信公众号：XiaoqiangClub <br/> 配置教程：https://xiaoqiangclub.blog.csdn.net/article/details/144614019

特点

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

快速开始

1. 安装依赖

pip install python-dotenv

2. 配置企业微信

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

# 复制配置文件
cp env_example.txt .env

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

3. 发送消息

# 发送简单消息
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/send_message.py "$(python -c 'from scripts.message_formatter import MessageFormatter; print(MessageFormatter.task_report("数据备份", "success", "备份完成", "文件大小: 1.2GB"))')"

配置

配置文件（推荐）

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

WECOM_CORP_ID=your_corp_id
WECOM_CORP_SECRET=your_corp_secret
WECOM_AGENT_ID=your_agent_id
WECOM_TOUSER=@all
WECOM_SENDER=🎸 XiaoqiangClub

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

环境变量

# Windows
set WECOM_CORP_ID=your_corp_id
set WECOM_CORP_SECRET=your_corp_secret
set WECOM_AGENT_ID=your_agent_id

# Linux/Mac
export WECOM_CORP_ID=your_corp_id
export WECOM_CORP_SECRET=your_corp_secret
export WECOM_AGENT_ID=your_agent_id

命令行参数

python scripts/send_message.py "消息内容" -c corp_id -k corp_secret -a agent_id

配置优先级

命令行参数 > 环境变量 > .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	通用自动发送的消息

使用示例

from scripts.send_message import send_wechat_message

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

消息格式模板

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

1. 任务报告 (task_report)

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

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)

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

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

输出效果：

🚀 任务通知

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

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

3. 系统告警 (system_alert)

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

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

输出效果：

🚨 系统告警

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

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

📌 处理建议:
1. 检查数据库服务器状态
2. 检查防火墙规则
3. 查看数据库日志

4. 每日汇总 (daily_summary)

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

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%
- 修复了定时任务的时区问题

5. 自定义消息 (custom)

适用于灵活的自定义消息格式。

message = MessageFormatter.custom(
    title="项目更新",
    content="项目开发进度报告",
    fields={
        "当前阶段": "开发中",
        "完成度": "65%",
        "预计完成": "2024-12-01"
    }
)

输出效果：

📌 项目更新

━━━━━━━━━━

项目开发进度报告

  • 当前阶段: 开发中
  • 完成度: 65%
  • 预计完成: 2024-12-01

命令行参数

参数	简写	说明	默认值
message	-	消息内容（必填）	-
--sender	-s	消息发送来源	.env 配置
--corp-id	-c	企业微信 CorpID	.env 配置
--corp-secret	-k	企业微信密钥	.env 配置
--agent-id	-a	企业微信应用 AgentID	.env 配置
--touser	-t	接收用户	@all 或 .env 配置
--toparty	-p	接收部门	空
--totag	-g	接收标签	空

代码调用

from scripts.send_message import send_wechat_message

success = send_wechat_message(
    message="任务执行完成",
    sender="📦 数据备份服务",
    touser="@all",
    toparty="",
    totag=""
)

if success:
    print("消息发送成功")
else:
    print("消息发送失败")

返回值

• 发送成功: True
• 发送失败: False

注意事项

1. 企业微信 API 有调用频率限制，请合理使用
2. touser、toparty、totag 至少要有一个非空，否则消息无法送达
3. 请妥善保管 CorpID 和 CorpSecret，不要泄露到代码仓库
4. 建议使用 MessageFormatter 格式化消息，可读性更好

---

作者微信公众号：XiaoqiangClub <br/> 配置教程：https://xiaoqiangclub.blog.csdn.net/article/details/144614019