diff --git a/HANDFOFF.md b/HANDFOFF.md index 88e8b46..00b10be 100644 --- a/HANDFOFF.md +++ b/HANDFOFF.md @@ -2,6 +2,48 @@ > 创建时间: 2026-06-12 04:00 > 源会话: hermes session (ses_1d95d15c4ffehQaZ6hrbIbak5k) +## 🔴 关键操作手册(必读) + +### 如何发送消息到 coregroup(核心群聊) + +> **任何时候要向 coregroup 发消息,不要从 246 操作。用本地 HTTP bridge。** + +```powershell +# ✅ 正确方式(UTF-8 编码,中文不会乱码) +$json = '{"message":"你好大家,开发完成,请 git pull 测试"}' +$bytes = [System.Text.Encoding]::UTF8.GetBytes($json) +Invoke-WebRequest -Uri "http://127.0.0.1:5802/send" -Method POST -Body $bytes -ContentType "application/json; charset=utf-8" -UseBasicParsing + +# ❌ 错误 — Invoke-WebRequest -Body "字符串" 会走系统 GBK 编码,中文变问号 +# ❌ 错误 — 不要从 246 发 +# ❌ 错误 — 不要用 send_xmpp_groupmsg.py(没有 join MUC 被丢弃) +``` + +**原理:** +- 我的 XMPP bot JID: `xxm@yoin.fun`(运行在这个 Windows 机器上) +- bot 启动时已自动 join MUC rooms(含 `coregroup@conference.yoin.fun`) +- HTTP bridge(`xmpp_bot.py` 内置)绑定 `127.0.0.1:5802` +- 只有这个方式发的消息会出现在 coregroup 里 + +### 如何查看是否有新消息 + +```powershell +# 查看 mohe 发给我的消息 +curl "http://127.0.0.1:5802/messages?from=mohe" + +# 查看全部消息 +curl "http://127.0.0.1:5802/messages" +``` + +### 状态检查 + +```powershell +# 检查 bot 是否在运行 +Get-Process -Name python* | Where-Object { $_.CommandLine -match "xmpp_bot" } + +# 检查 HTTP bridge 是否在监听 +netstat -ano | findstr :5802 + ## 已完成 ### 系统修复