WORKFLOW ORCHESTRATION
今天，准备把消息送到哪里？
连接执行终端、编排群组和内容，让每一次投递都有迹可循。
执行终端
-
已配置群
-
启用中计划
-
待处理任务
-
今日发送
总发送群-
成功-(-)
失败-(-)
本周发送
总发送群-
成功-(-)
失败-(-)
本月发送
总发送群-
成功-(-)
失败-(-)
执行中任务
待发送任务
运行状态
添加执行终端
每台 Windows 执行机使用独立编号和密钥
执行终端列表
| 编号/名称 | 企微群数量 | 客户端版本 | 执行终端密钥 | 状态/最后在线 | 操作 |
|---|
群聊列表
群名必须与企微聊天窗口顶部显示完全一致
已选 0 个
| ID | 群名称 | 添加时间 | 最后修改时间 | 归属执行终端 | 状态 | 操作 |
|---|
单个加群
请输入企微会话顶部显示的完整群名
批量加群
每行一个群名，统一设置归属执行终端
发布计划
管理立即、定时和循环发布计划
发布账号：
| 任务名称 | 所属企微 | 内容 | 是否循环 | 成功数 | 失败数 | 群数量 | 预计执行时间 | 状态 | 操作 |
|---|
历史图片素材
置顶素材会优先显示；删除仅从素材库移除，不影响已有计划和待发送任务
| 预览 | 素材备注 | 图片地址 | 添加时间 | 最后使用时间 | 状态 | 操作 |
|---|
创建发布
可选择立即发送、精确到分钟的定时发送，或按 cron 循环发送
任务日志
按照发布计划汇总显示，点击查看进入各群发送明细
发送账号：
| 名称 | 发送账号 | 最近计划时间 | 任务数/成功/失败 | 总耗时 | 状态 | 操作 |
|---|
投递明细
| 任务 ID | 群 | 计划时间 | 开始时间 | 完成时间/耗时 | 状态 | 执行终端 | 重试 | 错误信息 |
|---|
策略中心
全局发送安全策略和飞书监控通知
审计动态
记录所有后台变更；鼠标放到“操作对象”可查看脱敏后的请求参数和处理结果
| 操作时间 | 操作账号 | 操作 | 操作对象 | 结果 | 来源 IP |
|---|
开通客户空间
创建后把“客户标识/管理员账号”和密码交给客户，其余配置由客户自行完成
客户空间
每个客户使用独立数据表、独立调度器与独立成员体系
| 客户 | 登录账号 | 终端/群组 | 成员 | 额度 | 有效期/状态 | 操作 |
|---|
添加工作成员
账号权限会在服务端接口层强制校验
成员列表
| 账号/名称 | 权限 | 状态 | 最后登录 | 操作 |
|---|
推送小助手运行逻辑
从后台创建发布计划，到客户端执行、结果回传及异常告警的完整链路
重要说明：本工具通过前台 UI 模拟操作企业微信，并非官方 API。运行期间电脑不能锁屏，企业微信窗口必须可见；客户端升级可能导致自动化失效，并存在账号风控风险。
一、系统协作关系
管理后台人员操作入口
- 管理账号、执行终端和群归属
- 编辑文字及多张图片
- 立即、定时或循环发布
→
服务端任务中心MySQL + APScheduler
- 生成计划、批次和逐群任务
- 任务租约、权限和超时控制
- 统计、审计动态及飞书告警
→
Windows 客户端单实例 + 心跳 + SQLite
- 领取本客户端名下任务
- 逐群打开和关闭企微窗口
- 异常重启后补报执行结果
→
企业微信 PC必须保持前台可见
- Ctrl+F 搜索目标群
- 核对标题后粘贴内容
- 发送完成并关闭主窗口
二、单个群任务执行主链路
1
任务到期立即或北京时间调度触发2
客户端领取校验密钥、归属、状态和租约3
打开企微恢复窗口并确认前台进程4
搜索并核名Ctrl+F 搜索，复制会话标题5
粘贴并发送文字、多图；非测试才发送6
结果闭环关闭窗口、回传并处理下一群三、发送前安全闸门
前台进程校验当前窗口必须属于企业微信进程
→
群标题精确核对单击或双击复制，必须完全一致
→
最终发送开关核对通过且 dry_run=false 才发送
✓ 核对通过发送消息，记录成功并回传服务端。
↷ 未复制到群名或出现弹窗按配置间隔执行两次 Esc，跳过本群。
× 群名不一致或前台错误立即停止，避免误发或误操作其他窗口。
四、异常恢复与监控
断点恢复已完成但未回传的结果保存在本地 SQLite，重启后继续回传。
任务超时超过计划时间 2 小时仍未发送，标记失败并禁止再次执行。
进度告警发送中计划 5 分钟没有发布进度，通过飞书通知管理员。
结果查看后台汇总总数、成功和失败，并可查看每个群的详细日志。