Wechatian 微信推送链路(2026-08-27 实测可复用)
1. 链路总览
WorkBuddy 定时任务 → 写 .md 到 outbox → Wechatian 插件(Obsidian,30 秒轮询)
→ 腾讯 iLink 网关(ClawBot) → 个人微信
2. 关键事实(实测)
- Obsidian 桌面版 ≥1.13.0(实测 1.13.6/1.13.7),仅桌面端,需常开
- Wechatian 插件 0.1.x(GitHub: laruence/wechatian,2026-08-24 发 0.1.5)
- iLink(智联)= 腾讯 2026 官方开放的个人微信 Bot 通道,域名 ilinkai.weixin.qq.com,合规低封号风险
- 绑定后微信联系人出现「微信 ClawBot」(可改名);绑定账号必须先给 bot 发一条消息才下发发送凭据
- 发送机制:向 outbox 写任意文件,.md 内容即文本消息,媒体 ≤100MB 附件;30 秒轮询,文件消失=已取走发送
- 接收机制:微信消息 → inbox 每日对话笔记;文章链接自动剪藏;媒体进 attachments/
- 插件自动维护 Agent.md(协议自描述,可指给任何 AI 看)
3. 搭建步骤
A. 安装 Obsidian(受限网络优先走微软商店)
"C:/Users/<user>/AppData/Local/Microsoft/WindowsApps/winget.exe" install --id XP8K51FR765RLD --source msstore --accept-package-agreements --accept-source-agreements
- 装后路径:
%LOCALAPPDATA%\Programs\Obsidian\Obsidian.exe - 版本可能略滞后(商店源给 1.13.6),不影响 ≥1.13.0 要求
B. 安装 Wechatian 插件(手动放置,绕开不可达的社区市场)
- 建
<vault>/.obsidian/plugins/wechatian/,放 main.js、manifest.json、styles.css、versions.json - 预启用:写
<vault>/.obsidian/community-plugins.json,内容["wechatian"] - 下载渠道见「4. 受限网络下载通道」
C. vault 位置注意(踩坑)
- Obsidian 启动打开
C:\Users\<user>\AppData\Roaming\obsidian\obsidian.json中"open": true的 vault;命令行传 vault 参数可能被忽略 - 实测实际 vault 是
C:\Users\zhuangxukai\Documents\Obsidian Vault(用户原 vault),不是计划新建的位置 - 排查"插件装了对但没生效"时,先读 obsidian.json 确认实际 vault,再检查该 vault 的 .obsidian/plugins/
D. 微信扫码绑定(需用户手动,约 2 分钟)
- Obsidian 设置 → 第三方插件 → 关闭受限模式 → 启用 Wechatian(或用 community-plugins.json 预启用,首次弹信任横幅点"信任并启用")
- Wechatian 设置页出二维码 → 手机微信扫码确认
- 微信给 ClawBot 发一条任意消息(解锁发送凭据,否则 Test Send 报"还没有发送凭据")
- 设置页点 Test Send,手机收到即双向打通
E. WorkBuddy 定时任务(automation_update)
- mode=create;scheduleType=recurring;rrule=
FREQ=DAILY;BYHOUR=8;BYMINUTE=30 - prompt 必须写清:数据源绝对路径、读取规则、输出格式、outbox 写入绝对路径、红线(基于事实/不臆测/涉密不发)
- cwds=数据源目录,outbox 所在 vault 目录(逗号分隔)
4. 受限网络下载通道(重要,2026-08-27 实测)
- github.com 主站常超时,但 api.github.com 可达
- release 资产经 API 302 下载:
curl -L -H "Accept: application/octet-stream" \
"https://api.github.com/repos/{owner}/{repo}/releases/assets/{asset_id}" -o 目标文件
- 国内镜像 ghfast.top / gh-proxy.com 可达但不加速(与直连同速 ~25-45KB/s,大文件不推荐)
- 快速通道优先级:winget msstore(微软 CDN,秒级)> api.github.com 小文件 > 镜像(仅冗余)> GitHub 直连(极慢)
- 查资产 ID:
curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest看 assets[].id
5. xlsx 免依赖解析(Python 标准库,无需 openpyxl)
- xlsx = zip;sheet 名在
xl/workbook.xml;数据在xl/worksheets/sheet1.xml - 字符串两种编码:sharedStrings.xml(t="s") 和 inline
<is><t>—— 必须都处理,否则中文变空(踩坑) - Excel 序列日期 =
datetime(1899,12,30) + timedelta(days=N) - 完整可跑脚本见
references/todo-broadcast.py
6. 每日待办播报(小铠定制规则)
- 数据源:
D:\WorkBuddy工作区\任务管理.xlsx,sheet「任务清单」 - 列:序号|任务标题|父任务序号|分类|截止日期|优先级|状态|创建日期|备注
- 四类分桶:逾期(<今天)、今日(=今天)、近3日(+1~+3)、本周(+4~本周日);排除状态"完成/已完成";空类隐藏
- 输出:首行
📅 YYYY-MM-DD 周X · 每日待办早报,下按类列表- 标题 (分类·优先级·状态);四类全空则"今日无待办,专注当下。" - 写入 outbox 文件名:
daily-todo-YYYYMMDD.md - 实测 outbox 路径:
C:\Users\zhuangxukai\Documents\Obsidian Vault\Wechatian\outbox\
7. 限制与风险(必读)
- iLink 发送凭据可能 24h 无交互过期(未见实测,需 3-5 天观察;保活=每天与 bot 互动一次)
- 主动发送有限流:适合通知/拍板,不适合高频
- Obsidian 需电脑开机常开;关机即停
- 同一微信账号建议单设备在线(多端轮询争抢消息)
- 插件很新(0.1.x),先小规模试跑再正式用
8. 排障清单
| 症状 | 排查 |
|---|---|
| outbox 文件写后不消失 | Obsidian 没开 / 插件未启用 / 凭据未解锁(先给 bot 发消息) |
| Test Send 报无凭据 | 绑定账号先给 bot 发一条消息 |
| 微信没收到 | ClawBot 对话框是否存在、是否同一微信号、是否长时间无交互 |
| 打开的是错误 vault | 读 obsidian.json 的 "open" 字段,改到正确 vault |
| 插件装了对但没生效 | 确认文件在实际被打开的 vault 的 .obsidian/plugins/wechatian/ 下 |
9. 红线(小铠协作规范,必须遵守)
- 成本数据、未确认数据严禁走微信通道
- 推送内容先经小铠确认再上线
- 定时任务上线前先手动测试;自动化跑 3-5 天观察凭据是否失效
