alloevil/weibo-chat-auto

• Tauri v2 原生窗口 + WKWebView
• 运行资源：Bun 编译查看器服务和归档/索引辅助程序，应用显式携带 viewer.html 及浏览器模块。下载版运行无需 Node 或 Bun，归档仍需安装 Chrome。
• 本地数据：macOS 安装包将配置、Cookie、归档和缓存放在 ~/Library/Application Support/com.alloevil.weibo-chat/，不写入 .app。源码网页版仍使用仓库内数据，本版不自动迁移这些数据。
• 登录：Rust 打开 WebView → 扫码 → cookies_for_url() 提取 HttpOnly Cookie → 自动保存
• IPC：WKWebView 不注入 Tauri IPC，改用 HTTP 信号中转
• 图片：微博 CDN 检查 Referer，本地 /api/sinaimg?url= 代理绕过

1️⃣ 安装依赖

npm install

2️⃣ 保存 Cookie

npm run save-cookies

会弹出一个独立浏览器窗口（与日常 Chrome 隔离），打开微博聊天页：用微博 App 扫码 → 手机确认 → 跳转到聊天列表后 Cookie 自动写入 cookies.json。

3️⃣ 配置群聊

复制模板并填入群名（须与微博中完全一致；也可以跳过此步，在查看器 ⚙️ 设置 → 归档群聊 里直接勾选）：

cp config.example.json config.json

{
    "chromePath": "",
    "groups": ["群名称A", "群名称B"]
}

chromePath 留空即自动探测系统中的 Chrome；仅在 Chrome 装在非默认位置时才需手动填写。

4️⃣ 运行 & 查看

npm run archive   # 首次拉取最近 7 天，之后增量更新
npm run view      # 启动查看器 → http://localhost:3456

3456 端口被占用？用 WEIBO_PORT=4000 npm run view 换一个。

• 🎯 上下文：打开消息的上下文入口，查看前后时间邻域；午夜附近按需补邻日，并显示实际日期和读取边界，不把时间相邻视作同一话题。
• 引用核对：原文默认完整显示，长引用可主动收起；点击“核对原文”查看可能来源，再明确选中要打开的记录。核对后用“返回原上下文”继续阅读。
• 搜索定位：普通搜索按完整片段匹配，组合检索支持成员、归档日期和正文多词。点击结果“回原文”后可返回已加载结果和位置，继续“加载更多”。
• 阅读进度：每群保存本浏览器的阅读位置；搜索/AI 的临时原文浏览不会覆盖进入前的阅读进度。新归档提示由你明确点击后才跳转。
• @我：导航栏 @我 只留提到你的消息。签到机器人会 @ 每个成员（实测占命中的 93%），已无条件排除
• 未读分隔线：再次打开时，「以下为新消息」标出上次离开后的增量

微博把 webim 登录态和 weibo.com 侧的 24 小时滚动会话绑在一起：光有 SUB（名义有效期一年）不够，滚动会话断供一天就会失效。归档器与查看器内置了自动保活：

因此：保持查看器（或桌面 App）常驻，登录态基本不会过期。彻底停用超过一天，或微博侧强制失效（换设备、改密码、风控）后，仍需重新扫码 —— 点 Sync 会自动弹出扫码窗口。

Cookie 失效时归档器会明确报错并以退出码 1 退出，提示去跑 npm run save-cookies；它不会假装成功。定时任务的日志在 logs/archive.log，出现 Cookie 已失效 即需扫码：

grep -c "Cookie 已失效" logs/archive.log   # 非 0 说明该重新扫码了

实时同步默认关闭，在“更多 → 设置与皮肤”中可开启。开启且有页面订阅时，服务端每 20 秒读取新消息，并入日文件后通过 SSE 通知页面；手动“同步归档”仍用于补全历史。消息区底部先展开“向群里发消息”，再输入内容（Enter 发送，Shift+Enter 换行）。

为什么默认关闭：轮询要调 query_messages 读群消息，而"读取是否会推进微博侧的已读游标"无法从外部证伪 —— 该接口的响应自带 last_read_mid，只能通过同一个接口观察它。若真会推进，原生微博客户端的未读提示就会被悄悄吃掉。证据倾向于不会（webim 客户端另有独立的 clear_unread.json，点开会话时才调用），但这个代价必须由你显式选择承担。

关闭时，实时轮询不再发起群消息请求：停止轮询定时器，旧轮次迟到响应不再续页、写盘或通知，发送后的额外轮询也跳过。已发出的网络请求无法撤回。独立的系统定时归档、手动同步、登录保活不由此开关停止；每日摘要通知启用时仍可能保留 SSE 连接。开关保存在服务端 live-config.json，使用同一服务的页面共享设置。

实时同步与发言都依赖群会话 id。在设置里从微博会话列表选群时，查看器会保存接口返回且经过 user.type === 2 校验的群 id；归档器之后也会用实际切群请求再次核对并刷新它。因此新选群不必先启动 Chrome 归档即可发言，实时同步仍保持默认关闭。

另外两个取舍：

• 没人看时不轮询：页面全部关闭后轮询立即停止，不在后台空打微博接口。
• 自己发的消息不做本地回显：发送成功后催一轮实时同步，自己的消息与别人的消息走完全相同的入库路径，避免两条来源的数据打架。
• 桌面通知：默认只在提到你时弹（点击跳到那条消息）。设置里可加关键词订阅，或打开"每轮新消息都汇总通知"（一轮最多弹 3 条）。规则在服务端判定（lib/notify-rules.js），噪声不通知 —— 否则 93% 的推送都是签到机器人。授权只在真开了某条规则时才请求。
• 表情与图片：输入框左侧可选表情（复用渲染用的 340 条官方清单，插入 [标签]），也能发图 —— 选择、粘贴均可，上限 20MB。

发图的上传端点（/webim/uploadx.json）是从 webim 前端 bundle 逆向出来的，尚未对真实接口验证过（真发一张就撤不回）。若发图失败，先看 logs/ 里 [send] 那行的返回。

⚠️ 发消息是写操作，而查看器的 API 无鉴权（只绑 127.0.0.1）—— 本机任何程序都能借它发言。不要把端口暴露到外网。

采用 Agentic Search 模式。工具循环由 @earendil-works/pi-agent-core 的 runAgentLoop 提供（工具分发 + 参数校验 + 重试 + 超时 + provider 适配），本仓只保留检索层、提示词与预算闸门（≤7 轮检索；预算耗尽且停在工具调用上时追加一次无工具收尾轮；LLM 精排单独封顶 4 次；整个请求 150 秒墙钟上限）。结构化状态累积参考 LedgerAgent 论文。

检索层：话题块切分（30 分钟断层）→ 原问题与已有关键词的最多 4 路 bigram BM25 → RRF 融合、重复候选限制与精确线索保护 → 仅明确近期问题启用时间权重 → 命中附近原文精排 → 块内多命中窗口。日期/人物过滤仍优先，精确线索保护不绕过精排剔除；不增加在线改写调用。噪音剔除、别名和相对日期解析保留，可选离线标注可补充摘要与同义改写。方法、固定合成对照与已知失败见 检索评测说明。

注意：AI 代理需支持 SSE 流式响应。

详见 docs/agent-qa.md

Benchmark (Agent vs Legacy) — 2026-07 在单个私有群（56 天历史、5 个问题）上实测：

⚠️ 这组数字已过期且不可复现。 它早于块级 BM25 检索重写与 pi-agent-core 迁移；原始脚本在 eval/（agent 工作目录，随 ee2a63d 一起 untrack 移除），且依赖私有归档数据。请把这张表当作「为什么 Agent 模式是默认」的方向性记录，而不是当前实测值。延迟一项现在应当更低：新循环不再付固定重试等待（实测两次 429 的自愈 3011ms → 1407ms，这是 SDK 默认退避对比旧版固定 1s+2s 的结果），所以偏保守而非偏乐观。

要拿当前数字，在自己的归档上跑 node scripts/benchmark-qa.js --group <群名>（详见 docs/agent-qa.md）。

以下为历史版本截图，保留作界面参考；不代表 v1.31.0 的精简导航或引用展示。

消息视图 — 时段热力图、引用气泡、@提及高亮、每条「🎯 上下文」入口

上下文聚焦 — 点 🎯 弹出右侧面板；当前版本支持跨日时间邻域及待核对的引用线索

统计面板 — 每日消息量、活跃用户排行

截图中的用户名、群名与头像均为脱敏示例。

Windows 推荐使用 WSL。原生 Windows 可在 Git Bash 中运行网页版安装流程；自动定时归档暂不配置，请使用 Windows 任务计划程序运行 npm run archive。桌面应用目前仅在 macOS 验证。

若 Windows 的 Chrome 不在自动探测位置，请在 config.json 使用 C:/.../chrome.exe 形式，或在 JSON 中把反斜杠写成双反斜杠；修改后重新运行 npm run setup，安装器会读取该配置。

macOS / Linux / WSL — npm run setup 安装时会询问是否启用，也可随时用一条命令管理（macOS 用 launchd，Linux 用 systemd user timer，无 systemd 的环境 —— 如部分 WSL 发行版 —— 回退写 crontab 条目）。Windows 原生请使用任务计划程序：

./scripts/schedule.sh install     # 安装（每小时归档一次）
./scripts/schedule.sh status      # 查看状态
./scripts/schedule.sh uninstall   # 干净卸载

systemd Linux 上可用 systemctl --user list-timers weibo-archive.timer 看到定时器。若自动安装失败，也可手动配置 cron（crontab -e），每小时归档一次：

0 * * * * cd /path/to/weibo-chat-auto && node scripts/auto-archive-simple.js >> logs/archive.log 2>&1

启用后定时归档会顺带刷新 Cookie，基本不会过期。

weibo-chat-auto/
├── scripts/
│   ├── setup.sh                 # 网页版一键安装脚本
│   ├── run-desktop.sh           # 桌面应用一键启动（装依赖→编译→运行）
│   ├── auto-archive-simple.js   # 主归档脚本
│   ├── save-cookies.js          # Cookie 保存工具
│   ├── viewer-server.js         # 本地查看器服务器
│   ├── qa-agent.mjs             # Agentic Q&A 模块
│   └── …                        # 其他辅助脚本（QA 索引构建、渲染冒烟、截图）
├── config.example.json          # 群聊配置模板
├── config.json                  # 实际配置（不提交）
├── viewer.html                  # 群聊档案馆（单页应用，多主题）
├── src-tauri/                   # Tauri v2 桌面应用（Rust）
│   ├── src/lib.rs               # 窗口、sidecar 拉起、应用内登录
│   └── tauri.conf.json
├── sidecar/build.mjs            # 用 Bun 把 viewer-server 编译为独立二进制
├── cookies.json                 # 登录凭据（不提交）
├── ai-config.json               # AI 配置（不提交）
├── state/                       # 归档状态（不提交）
├── output/                      # 归档数据（不提交）
│   └── <storage-key>/           # 新群为可读前缀 + hash；.group-meta.json 保存原始群名
│       └── weibo_chat_2026-05-01.json
├── cache/images/                # 图片缓存（不提交）
├── docs/                        # 文档和截图
│   └── agent-qa.md              # Agent Q&A 技术方案
└── package.json

每条消息：

{
    "id": 123456789,
    "from_uid": 12345,
    "user": "用户名",
    "avatar": "https://...",
    "timestamp": 1778000000000,
    "time": "2026/05/11 12:00:00",
    "date": "2026-05-11",
    "content": "消息内容",
    "type": 321,
    "pics": ["https://upload.api.weibo.com/2/mss/msget?source=...&fid=..."],
    "share": {
        "url": "http://weibo.com/...",
        "title": "...",
        "author": "...",
        "pics": ["https://wx1.sinaimg.cn/large/..."],
        "reposts": 100,
        "comments": 50,
        "likes": 200
    }
}

npm run save-cookies

扫码登录后 Cookie 自动保存。

为什么过期？ 独立浏览器不共享日常登录态，微博的滚动会话断供约一天即失效。保持查看器常驻（内置 30 分钟保活）或定时任务运行可自动续期。

检查 config.json 中的 chromePath 是否正确，并确认已安装 Google Chrome。

查看器会输出一行提示并退出（最常见原因是桌面应用已在运行 —— 服务是同一个，直接打开 http://localhost:3456 即可）。想换端口运行：

WEIBO_PORT=4000 npm run view

图片经本地服务器代理加载（依赖有效 Cookie），Cookie 过期后无法显示。重新 npm run save-cookies 即可。