微信消息工作台 CH3SH-LC/dsh-better-wechat

dsh-better-wechat

把电脑上的微信聊天，变成你随时能问的私人消息工作台。
本地优先：采集、解密、索引、筛选都在你的电脑上完成；只有你这次分析真正用到的消息文本，才会交给你在 DSH 里选择的模型。

微信里其实躺着大量有价值的信息 —— 谁答应了什么、哪条通知有时限、上周讨论的结论是什么。但真要用的时候，你只能在几百个会话里往上翻。

dsh-better-wechat 是 DeepSeek Harness（DSH）的一个插件。它在你的电脑本地把微信聊天整理成一份可检索、可筛选、可追溯的私人档案，然后让 DSH 里的助手用自然语言帮你查、帮你总结、帮你把「要做的事」挑出来。

- 🗂️ 一句话找消息 —— 按人、按群、按时间、按关键词找，返回原文和上下文
- ✅ 自动整理待办 —— 从聊天里挑出与你有关的承诺和截止时间，每条都带原文出处
- 🔕 免打扰群一键忽略 —— 整理消息时跳过你早已静音的群，只看真正重要的会话
- 🔒 本地优先、按需外发 —— 数据库、索引和完整历史留在本机；只有本次分析用到的消息文本交给 DSH 里的模型，换成本地模型即可完全不外发

它把什么变简单了

| 你现在的麻烦 | 用它可以这样 |
| 重要信息淹没在几百个群聊里 | 直接问「昨天关于验收的消息」，拿到原文和上下文 |
| 每天翻聊天记录找「谁答应了什么」 | 让它按日期整理候选待办，逐条附上消息依据 |
| 几十个免打扰群刷屏，整理时全是噪声 | 说一句「忽略免打扰群」，整理范围立刻干净 |
| 想知道「这事上周谁提的」 | 按时间回看，结论可追溯到具体某条消息 |
| 不想把聊天记录交给云端工具 | 采集、索引、完整历史都在本机；只把你选中的文本交给模型分析，也可以改用本地模型完全不外发 |

核心功能

1. 用大白话检索聊天记录

不需要记命令，也不需要知道消息存在哪个数据库。直接描述你记得的线索：谁、哪个群、大概什么时候、聊了什么。

「上周三到周五，项目群里提到的截止时间」「查一下昨天跟王工讨论的接口问题，给我原文」

2. 把聊天里的「事」挑出来

它会通读你指定时间范围内的消息，整理成候选待办：任务、负责人、截止时间、状态，并且每条都标注来自哪条消息。

更重要的是它的分寸感：
- 草稿不等于完成 —— 它给你的都是需要你核对的草稿，不会替你确认「已完成」
- 别人的事不算你的事 —— 群里的任务不会硬算到你头上
- 证据可回溯 —— 消息更新后会标记「依据已变化」，可以按版本回查当时的原文

「整理本周与我有关的待办，明确任务和可能任务分开」

3. 免打扰群，一键忽略

这是最好用的一条「减负开关」。

你手机里静音的群，插件读的是微信自己的「消息免打扰」设置，所以和你在微信里看到的是一回事。整理消息时开启忽略，免打扰群的海量消息就不会占用你的整理时间和模型上下文。

- 只排除确定处于免打扰的会话；状态不明的会话会保留，不会被误伤
- 会明确告诉你索引里是否已有免打扰信息，缺数据时不会假装「已排除」

「整理今天的待办，忽略免打扰群」

4. 会话视角：先找准人，再查内容

同名群、同名联系人很容易搞混。插件会先列出匹配到的会话（真实显示名、类型、消息量、最近时间、是否免打扰），确认后再读取内容 —— 不会擅自替你选一个。

5. 长期不关注名单

有些群你永远不想在整理时看到。可以把它们加入「长期不关注」名单：之后所有检索、上下文和待办都会自动跳过，但它仍然保留在本地档案里，随时可以查看或移出。

6. 结论带证据，越权的事不做

每条结论都能落到具体某条消息。插件不会发消息、不会改微信、不会替你执行任务、不会创建提醒 —— 它只做「读懂 + 整理」。

三分钟上手

第 0 步 · 准备：DSH（支持 workspace bundle 的版本）、Python 3.10+。要让插件自动读取电脑微信，还需要 Windows 上的微信 4.x 并已登录。

第 1 步 · 安装插件 在 DSH 的插件页面安装本插件目录（或让 plugin_manager 用 install_bundle 安装）。
⚠️ 首次安装本地插件目录后，请完整退出并重新打开 DSH。仅刷新或禁用/启用不能替代重启 —— 插件代码必须由宿主重新加载，新的工具才会出现。

第 2 步 · 让它读一次微信 安装完成后，在 DSH 里说：

「初始化微信助手」

插件会接入你已登录的电脑微信，做一次完整读取、校验并建立本地索引（首次通常需要几分钟）。若提示缺少采集依赖，运行插件目录里的 安装采集依赖.cmd 后重试。

第 3 步 · 开始提问「看看今天有哪些需要我回的消息」

之后每天想更新时，说一句「刷新微信记录」即可，不需要重新选择来源。

没有 Windows 微信也没关系：可以导入已有的聊天导出（完整导出目录即可），macOS / Linux 同样支持。

可以这样问它

- 「昨天群聊里关于验收的消息，给我原文和上下文」
- 「总结今天和这位联系人的讨论，每条结论给出消息依据」
- 「整理本周与我有关的待办，明确任务和可能任务分开，不把别人要做的事算到我名下」
- 「只提取今天上午 9 点到 12 点，项目甲群和项目乙群的记录」
- 「总结昨天的消息，排除闲聊群，不读公众号」
- 「以后不关注这个闲聊群 —— 先把匹配到的会话列出来给我确认」
- 「整理今天的待办，忽略免打扰群」

隐私：本地优先，但要看你把模型放在哪

先把话说清楚：采集、解密、校验、索引、筛选、会话查找全部在你的电脑上完成，微信数据库、解密副本和完整索引不会上传到任何地方。但插件不是“本地总结器”——分析必须由 DSH 里的模型来做，所以你要知道哪些内容会随模型请求离开本机。

| 留在本机 | 会交给 DSH 里的模型 |
| 微信数据库与其解密副本 | 本次分析被选中的消息正文 |
| 完整聊天历史与全文索引 | 联系人 / 群显示名、时间、证据编号 |
| 账号映射、本地随机密钥 | 你提问里的时间 / 会话 / 类型范围 |
| 长期不关注名单、候选待办草稿 | — |

- 这不是“完全离线总结”。 如果 DSH 用的是云端模型（例如 DeepSeek API），上表右列的内容会随模型请求发送给对应服务商。这不是插件在“上传”，而是“让模型帮你分析”本身的含义。
- 想让内容完全不外发：在 DSH 里改用本地模型，那就真的不出本机。
- 你能控制发多少：范围与条数由你决定——按日期、按会话、按类型筛选，用「忽略免打扰群」跳过高噪声会话，一次只读你真正要用的那几条。图片、语音、视频和文件正文不会被读取，未读取的内容会明确标注。
- 插件自己不碰微信：不向微信写入数据、不注入进程、不保存数据库密钥、不发送消息、不执行任务、不创建提醒。

插件主动发起的联网行为只有一个：运行 安装采集依赖.cmd 时从公开源安装 Python 依赖包（与聊天内容无关）。其余网络流量来自 DSH 与它所选择的模型，遵循 DSH 自身的配置与权限。

完整的数据边界见 PRIVACY.md，安全反馈见 SECURITY.md。

适用环境与边界（如实说明）

| 项目 | 情况 |
| DSH 宿主 | 已在 DSH 0.2.0-rc.2 真实运行时验证插件加载、工具注册、返回格式与审批 |
| 自动读取电脑微信 | 需要 Windows + 微信 4.x + Python 3.10+（64 位） |
| macOS / Linux | 支持导入已有聊天导出；不支持自动读取本机微信 |
| 图片 / 语音 / 视频 / 文件 | 只记录「有一条这样的消息」，不读取正文 |
| 实时性 | 读的是本地快照，不是实时聊天；空结果不等于「没有消息」，需要时先刷新 |
| 待办准确性 | 结论是需要人工核对的草稿；请以原文为准 |

常见问题

会把我的聊天记录上传吗？ 分两层看。微信数据库、解密副本、完整索引和历史都只在本机，插件不会上传它们；但被选中用于分析的那段文本会交给 DSH 里的模型——如果那是云端模型，文本就会随模型请求发送给该服务商。想让内容完全不出本机，请把 DSH 换成本地模型。

免打扰状态是怎么判断的？ 读的是微信自己的「消息免打扰」设置。状态不明的会话不会被当成「没开免打扰」，也不会被误排除。

升级或改名后我的索引会丢吗？ 不会。私有数据目录与插件名字解耦：如果本机已有旧目录里的索引，改名后会继续使用它，不需要重新采集（也可以用环境变量 DSH_WECHAT_STATE_DIR 指定目录）。

为什么重启 DSH 之后工具还是没出现？ 说明宿主没有重新加载插件。请在任务结束后正常重启 DSH；仅刷新页面或禁用/启用插件可能清不掉旧模块缓存。

为什么有的时候查不到消息？ 常见原因是本地快照还没覆盖到那个时间段。状态信息会告诉你是否需要刷新，以及当前覆盖范围 —— 空结果不等于当天没有消息。

支持多个微信账号吗？ 一个私有数据目录绑定一个账号。切换账号请使用另一个数据目录，避免混在一起。

深入一点

- 架构与数据边界：docs/ARCHITECTURE.md
- 安装升级与排障：docs/TROUBLESHOOTING.md
- 发布流程：docs/RELEASING.md
- 隐私说明：PRIVACY.md ｜ 安全反馈：SECURITY.md ｜ 参与贡献：CONTRIBUTING.md ｜ 更新记录：CHANGELOG.md

本项目原创部分采用 MIT，采集器上游改写部分采用 Apache-2.0，见 第三方归属。

附录 · 插件由哪些能力组成（排障与进阶使用）

插件按功能域拆成 5 个可独立启停的组件，每个组件只提供自己那组能力：

| 组件 | 能力 |
| core | 配置、本地引擎与审批状态（不直接提供工具） |
| stage-one | 读取与刷新本机聊天（wechat_prepare、wechat_refresh） |
| read | 状态、检索、上下文、按范围复核、会话查找（wechat_status、wechat_search、wechat_context、wechat_review、wechat_conversations） |
| tasks | 候选待办的保存与读取（wechat_save_tasks、wechat_list_tasks） |
| preferences | 长期不关注名单的查看与修改（wechat_get_preferences、wechat_set_preferences） |

常用范围参数：start_date / end_date、start_time / end_time、kinds（friend / group / official / private / system）、conversation_ids、exclude_conversation_ids、exclude_muted。
第一步只接受空参数；筛选与忽略全部发生在第二步。