前言¶
在 DSH 里做记忆类能力时，常见做法是让用户手动粘贴聊天记录，或依赖外部导出文件再上传。微信桌面端里往往躺着大量可追溯的信息——承诺、截止时间、群里的结论——但真要用时只能在几百个会话里往上翻，也很难按「谁、哪个群、哪段时间」稳定筛出原文。
下面介绍社区插件 dsh-better-wechat（维护者 CH3SH-LC）。它在本机完成采集、解密与索引，把电脑微信聊天整理成可检索、可筛选、可追溯的私人档案，再通过 DSH 里的模型用自然语言查询与整理；只有本次分析选中的消息文本会交给你在 DSH 中选择的模型。
这是什么¶
dsh-better-wechat 是 DeepSeek Harness（DSH）的插件，在 SkillHub 社区目录中归类为「记忆」。当前 package 版本为 0.6.0（以仓库 package.json 为准）。
定位可以概括为：本地优先的微信消息整理助手。数据库、索引与完整历史留在本机；插件不向微信发消息、不改微信设置、不替你执行任务。分析环节依赖 DSH 宿主里的模型——若使用云端模型，被选中的正文会随模型请求离开本机；若在 DSH 中改用本地模型，则分析也可完全不外发。
核心功能¶
自然语言检索¶
不需要记底层工具名或数据库路径。用口语描述线索（人、群、时间、关键词），例如「上周三到周五项目群里提到的截止时间」「查昨天跟王工讨论的接口问题，给我原文」。插件会返回原文和上下文。
候选待办整理¶
在指定时间范围内通读消息，整理任务、负责人、截止时间等草稿，每条标注来源消息。README 强调：草稿需人工核对，不会替你确认「已完成」；群里别人的任务不会硬算到你名下；消息更新后会标记「依据已变化」，可按版本回查。
免打扰群一键忽略¶
整理时读取微信自身的「消息免打扰」设置，与手机端一致。开启忽略后，免打扰群的大量消息不进入本次整理范围。状态不明的会话会保留，不会被误排除；若索引里缺少免打扰信息，会明确说明，不会假装已排除。
会话确认与长期不关注¶
同名群或联系人可能混淆。插件会先列出匹配会话（显示名、类型、消息量、最近时间、是否免打扰），确认后再读内容。可将指定会话加入「长期不关注」名单，后续检索、上下文与待办自动跳过，本地档案仍保留。
能力组件（排障参考）¶
插件按功能域拆成可独立启停的组件：core（配置与本地引擎）、stage-one（读取与刷新）、read（状态、检索、上下文等）、tasks（候选待办）、preferences（长期不关注名单）。常用范围参数包括 start_date / end_date、kinds（friend / group / official 等）、exclude_muted 等；README 说明筛选发生在第二步，第一步只接受空参数。
图片、语音、视频和文件只记录「有这样一条消息」，不读取正文内容。
安装与启用¶
环境准备（来自 README）：
- DSH：需支持 workspace bundle 的版本；README 写明已在 DSH
0.2.0-rc.2上验证插件加载与工具注册。 - Python 3.10+（自动读取本机微信时建议 64 位）。
- 自动读取电脑微信：Windows + 微信 4.x + 已登录。macOS / Linux 可导入已有聊天导出目录，不支持自动读取本机微信。
第 1 步 · 安装插件
在 DSH 的插件页面安装本插件目录，或由 plugin_manager 使用 install_bundle 安装。目录页：SkillHub · dsh-better-wechat。
首次安装本地插件目录后，请完整退出并重新打开 DSH。仅刷新页面或禁用/启用插件不能替代重启——宿主需重新加载插件代码，新工具才会出现。
第 2 步 · 初始化读取
在 DSH 对话中说：
初始化微信助手
插件会接入已登录的电脑微信，做完整读取、校验并建立本地索引（首次通常需数分钟）。若提示缺少采集依赖，在插件目录运行 安装采集依赖.cmd 后重试。该脚本会从公开源安装 Python 依赖（与聊天内容无关），是插件主动发起的唯一联网行为。
第 3 步 · 日常使用
例如：
看看今天有哪些需要我回的消息
需要更新本地快照时说「刷新微信记录」，无需重新选择来源。
典型用法¶
以下示例均来自项目 README，可直接在 DSH 中复现：
- 「昨天群聊里关于验收的消息，给我原文和上下文」
- 「总结今天和这位联系人的讨论，每条结论给出消息依据」
- 「整理本周与我有关的待办，明确任务和可能任务分开，不把别人要做的事算到我名下」
- 「只提取今天上午 9 点到 12 点，项目甲群和项目乙群的记录」
- 「整理今天的待办，忽略免打扰群」
- 「以后不关注这个闲聊群 —— 先把匹配到的会话列出来给我确认」
适用场景与注意¶
适合谁：需要在本机归档微信聊天、用自然语言检索与复盘、并从聊天中整理带出处的待办草稿的 DSH 用户；希望用免打扰与「长期不关注」降低噪声的人；在意数据留在本机、并愿意自行控制模型与发送范围的人。
数据边界（务必理解）：
| 留在本机 | 会交给 DSH 里的模型 |
|---|---|
| 微信数据库与解密副本、完整索引与历史 | 本次分析被选中的消息正文 |
| 账号映射、本地密钥、不关注名单、待办草稿 | 联系人/群显示名、时间、证据编号及提问中的范围 |
读的是本地快照，不是实时聊天；查不到某时段时，先「刷新微信记录」并查看状态中的覆盖范围。一个私有数据目录绑定一个微信账号；可用环境变量 DSH_WECHAT_STATE_DIR 指定目录。升级或插件改名后，已有索引可继续使用（私有数据目录与插件名解耦）。
安全与合规：插件以当前 DSH 进程权限运行。安装前请自行查看 GitHub 源码、PRIVACY.md 与许可证（原创部分 MIT，采集器改写部分 Apache-2.0）。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-better-wechat 把「翻几百个会话找一条结论」变成在本机可检索、可筛选的档案，并把模型调用限制在你选中的文本上；配合免打扰忽略与长期不关注，整理范围更可控。
