README file from
Github微信随手记 (WeChat Diary)
对着微信说话, 内容自动落进你自己电脑的 Obsidian 库。
微信是中文用户一天里打开最频繁的输入框。这个插件把它变成一条零摩擦的采集管道: 扫码绑定一次微信 bot, 之后随时在手机上发文字、语音、图片给它——只要电脑上的 Obsidian 开着, 每条消息都会追加到库里的 日记/YYYY/YYYY-MM-DD.md。纯 Markdown, 全部在你自己的机器上。
日记、备忘录、灵感、给爸妈记的病历——发出去, 就记下了。
功能
- 发什么记什么, 不用任何开场白: 不需要说「开始记日记」, 发出去就记下了。「撤回」删掉最后一条, 「结束」是可选的收尾仪式(不发也没关系, 跨天自动收尾), 「帮助」看全部用法。
- 「在吗」会得到状态回复: 打招呼、探活这类消息不会被记进笔记, bot 会告诉你它在、今天已记几段。
- 熬夜不怕跨天: 凌晨 4 点前记的都算前一天, 睡前的话属于"今晚"。
- 语音友好: 语音消息由微信自动转写成文字, 带 🎤 标记入库。
- 图片: 发图自动存进
日记/attachments/YYYY/并嵌入当天笔记;「撤回」同样撤得掉(只删笔记里的引用, 图片文件保留)。 - 纯机械记录, 不经过任何 AI: 原文直存, 一个字不改, 行为完全可预测。(设置里的 AI 配置暂未启用, 为将来的可选功能保留。)
- 数据只在你机器上: 笔记是库里的纯 Markdown; 无作者服务器、无账号体系、无遥测。
- 只追加, 格式公开: 历史段落永不被改写, 写入格式是一份公开契约(docs/data-contract.md), 任何工具和 AI 都能读。
安装与绑定
- 在 Obsidian 第三方插件里安装并启用(仅桌面端)。
- 打开插件设置 → 扫码绑定 → 用手机微信扫码并确认。
- 选好日记文件夹(默认
日记), 完事——给 bot 发条消息试试。
诚实的限制
- 仅桌面端, 且管道只在 Obsidian 开着时运行。 电脑关机/睡眠期间发的消息不会丢: 下次打开 Obsidian 会按服务端游标自动补记, 24 小时内实测可补收, 更长时间未测。
- 语音转写依赖微信自身; 转写失败时 bot 会请你重说一遍。
- Python 版的定时提醒功能本版尚未包含。
网络访问说明
本插件只与两类远程服务通信:
- 腾讯 iLink bot 接口(
ilinkai.weixin.qq.com及登录后服务端指派的地址; 二维码页面由腾讯域名提供)。这是微信官方的 bot 通道——插件扫码登录、长轮询拉取你发给 bot 的消息、回发回执。你的消息本来就经过微信/腾讯的基础设施, 与任何微信消息相同。对该接口的连接为直连(绕过系统代理), 因为该端点实际上拒绝代理 TLS。 - 你自己配置的 OpenAI 兼容接口——当前版本未启用: 即使配置了也不会发出任何 LLM 请求。设置项为将来的可选功能保留。
除此之外没有任何网络请求。无遥测、无统计、无作者运营的服务器。使用本插件需要一个微信账号(这正是插件的意义所在)。bot 绑定凭据与 AI Key 存放在 Obsidian 的密钥存储中——在库文件夹之外, 同步工具不会带走它们; 同步进度等非敏感状态存于插件的 data.json。
数据格式
日记/
├── 2026/
│ └── 2026-08-12.md
└── attachments/
└── 2026/
└── 2026-08-12-2305-a3f1.jpg
---
date: 2026-08-12
weekday: 周三
source: wechat-diary
---
# 2026-08-12
**23:05**
今天试了新的手冲豆子, 花香很明显。
![[日记/attachments/2026/2026-08-12-2305-a3f1.jpg]]
完整规则见 docs/data-contract.md: 只追加、北京时间(时区可配)、一次发送 = 一个 \n\n 分隔块 = 一条消息、「结束」写封存注脚。自契约 v1.2 起, 一天的边界是凌晨 4 点——4 点前的记录落在前一天的文件里。
前身 Python 常驻版 wechat-diary 已归档(2026-08), 它写出的库遵循同一契约, 本插件可直接接着写。