@local/wechat-archive
将本机的微信聊天记录导出为 HTML、CSV 和 TXT。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:qiuleec/DSH-wechat-export#98a974c98af0a99a6bd0d16b6da29f9f05e737c0Wechat Archive 以 @local/wechat-archive 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 DeepSeek Harness 插件：在 左侧栏 加一个入口，把本机
微信 4.x（Windows）的聊天记录解密导出为 网页时间线（HTML）、CSV 表格 与 纯文本（TXT）。
同一套能力同时注册为 agent 工具 wechat_archive，可以直接让 agent 帮你列出、筛选、预览、导出。
所有处理都在本机完成：数据库解密、消息解析、文件写入都在 Harness 的 Host 进程里跑，没有任何网络上传。
node:crypto + node:zlib + node:sqlite），零 npm 依赖。set_out_dir 设一次长期生效。lib/service.js），两边结果永远一致。| 项 | 要求 |
|---|---|
| 系统 | Windows 10/11（x64） |
| 微信 | 微信 4.x 桌面版（已在 4.1.15.56 上验证；4.x 的库结构与 3.x 完全不同） |
| Harness | DeepSeek Harness 桌面版，profile 需具备 webServer 服务（默认具备） |
| Node | 随 Harness 内置（Node 22+，需要 node:sqlite 与 zstdDecompressSync） |
插件以 bundle 形式安装，由 Harness 的 plugin_manager 完成包安装与组合，不要手写 profile 的
package.json 或 cordis.patch.yml。
方式一：让 agent 装（推荐）
git clone https://github.com/qiuleec/DSH-wechat-export
然后把该目录的绝对路径交给 agent：
「用 plugin_manager 安装 <clone 下来的目录绝对路径> 这个插件包」
agent 会调用 plugin_manager 的 install_bundle，把该目录作为包源安装进当前 profile。
方式二：自己调工具（在 Harness 会话里）
plugin_manager action=install_bundle target=<该目录的绝对路径>
plugin_manager action=set_bundle target=@local/wechat-archive enabled=true
包名是
@local/wechat-archive（@local/是「本地目录安装」的约定前缀，不入 npm 仓库）； bundle 行 id 为wechat-archive，也就是左侧栏入口的 id。
安装完成后，左侧栏出现「微信聊天记录导出」图标；application 为 applied 才算真正装载成功
（本地目录安装是符号链接，之后改代码无需重装，但改 Host 代码要 set_bundle enabled=false 再
=true 才会加载新模块）。
bin/wx_key.dll是 Windows x64 原生组件。macOS / Linux 上插件仍可安装，但「捕获密钥」不可用。
微信 4.x 用 SQLCipher 4 加密本地数据库（每页 4096 字节、保留 80 字节、PBKDF2-HMAC-SHA512 迭代 256000 次）。没有当前账号的 32 字节数据库密钥，任何人都读不出内容，所以插件必须先拿到密钥。
微信只在登录的最初几秒把密钥交给自己的数据库层（SetDBKey）。因此捕获流程是：
插件的边界，请放心：
%USERPROFILE%\.dsh\wechat-chat-plugin\key.txt（权限 0600）；Weixin.dll 的进程挂载，跳过启动器进程（这是 4.x 上最常见的失败原因）。左侧栏点「微信聊天记录导出」图标，面板分三步：
| 步骤 | 做什么 |
|---|---|
| 1 · 取得密钥 | 确认环境（数据目录、账号、组件、微信是否在跑），然后捕获密钥 |
| 2 · 选择会话 | 按名称/wxid 搜索、按类型筛选（群聊 / 私聊 / 公众号 / 订阅号 / 服务号 / 系统）、全选/清空；双击行可预览最近 60 条 |
| 3 · 导出 | 先确认/修改导出目录，再导出选中会话或"导出全部会话"；结果里直接给文件路径与「打开导出目录」 |
面板第 3 步顶部有一个「导出目录」输入框，三种用法：
D:\微信导出，也接受 ~/导出），回车或点「保存目录」即生效；%USERPROFILE%\.dsh\wechat-chat-plugin\exports。保存时 Host 会先创建目录并检查可写，所以路径写错会立刻报错，而不是等一次完整导出跑到最后才失败。
目录只影响写入位置；显式传 outDir 的一次性导出不会改动这个保存值。
每个会话产出三个文件（另有一份 JSON 汇总）：
<名称>-微信聊天记录-<YYYY-MM-DD>.html 按天分组的左右气泡时间线，无脚本、可离线打开、支持深色
<名称>-微信聊天记录-<YYYY-MM-DD>.csv 时间,发送人,类型,内容（UTF-8 BOM，Excel 直开）
<名称>-微信聊天记录-<YYYY-MM-DD>.txt 制表符分隔，便于 grep / 喂给脚本
微信聊天记录-<YYYY-MM-DD>.json 所有已导出会话的汇总，便于交给 AI 分析
JSON 汇总不是每个会话一份，而是每次导出一个：当天第一次写 微信聊天记录-<日期>.json，之后同一天再导出会带时间后缀另存一份（例如 微信聊天记录-2026-11-04-173512.json），因此不会用一个单聊的汇总覆盖掉之前几十个会话的汇总。
面板的导出结果里会直接打印它的完整路径（标为「JSON 汇总」），agent 工具的 export 摘要里也有一行 汇总：<路径>。
工具 wechat_archive 的 action：status / list / export / preview / capture /
set_out_dir / open_folder / forget。例如：
action: "list", kinds: ["group"]action: "export", kinds: ["group"], days: 7action: "list", kinds: ["subscription"]action: "preview", wxid: "..."action: "set_out_dir", outDir: "D:\微信备份"（outDir: "" 恢复默认）kinds 可选 group（群聊）/ direct（私聊，含企业微信单聊）/ official（公众号，即订阅号
subscription（订阅号）/ service（服务号）/ system（微信自己的占位会话，
如服务通知）。不传即全部。groupsOnly 仍然可用，等价于 kinds: ["group"]。会话类型是怎么判定的（不靠猜测，全部来自库里的证据）：
| 类型 | 依据 |
|---|---|
| 群聊 | username 以 @chatroom 结尾 |
| 订阅号 | contact.db 的 biz_info.type = 0（与 external_info.ServiceType 一致） |
| 服务号 | biz_info.type = 1；不看 gh_ 前缀，因为服务号常用自定义 ID（如 mcdonalds888） |
| 公众号 | 有 biz_info 行但 type 为 2/3 的企业号/内部应用号（这些号一般没有会话） |
| 私聊 | 其余账号，包括 @openim 企业微信单聊 |
| 系统 | notifymessage、filehelper、brandsessionholder、@placeholder_foldgroup 等 |
面板与工具调用的是同一套服务方法（lib/service.js），所以两边结果永远一致。
媒体文件不会被复制出来（那样既慢又占空间），而是显示为占位符：
[图片]、[语音 4.2 秒]、[视频 346 秒]、[表情：微笑]、[转账] 收到转账288.00元、
[链接/卡片] 标题 - 摘要、[文件] 试卷.pdf、[聊天记录] 某某与某某的聊天记录、[位置] 潭柘寺、
[语音通话] 01:23、以及系统消息原文。
微信对一部分卡片类型只存一句「当前版本不支持展示该内容，请升级至最新版本。」，直接照抄会让整个会话
看起来全是这句。插件会绕过这句占位符去取卡片里真正的内容：视频号卡片还原成
[视频号] 作者 - 摘要，其余认不出内容的按类型标注（[小程序]、[音乐]、[文件] 等）。
本机数据库是权威来源：微信自己的会话摘要与会话时间戳来自同一个库，所以导出条数与微信里看到的一致。 聊天记录若已被你在微信里删除，导出也不会有。
local_type 的高位带压缩标记，判断类型必须先 & 0xffff；message_content 可能是 zstd 帧（魔数 28 b5 2f fd），要 zstdDecompressSync；real_sender_id 指向该数据库自己的 Name2Id 表，rowid 在不同 shard 之间会变，不能硬编码 1/2；发送者wxid:\n 前缀，只能在与该条消息自身 sender 精确匹配时剥离；node:sqlite；setAutoPadding(false) 必须设置，否则 CBC 会吃掉尾部字节；page1[16, 4032)，包含那段 IV。写成 [16, 4016)（把 IV 排除在外）
会让正确密钥全部校验失败 —— 这是本项目踩过的最贵的坑，test/realdb.test.mjs 就是为了守住它；length 是字节数、playlength 才是秒数，取错会显示成 [视频 56734 秒]；<![CDATA[...]]>）不适合用模板字符串里的正则去抓，lib/wechat.js
里用字符串查找实现的 field() 更可靠。/api/wechat-chat/* 路由。sec-fetch-site、异源 Origin 一律 403 ——
别的网页无法通过浏览器读到你的聊天记录。本插件参照 wechat-chat-export-general v1.2.1（作者 Lee，CC BY 4.0）的技术说明与流程重写，
导出流程与消息解析逻辑按其文档记录的行为实现。
密钥捕获组件 bin/wx_key.dll 来自开源项目
WXexport-tool v1.2.0（作者 Ray0612），
随本插件一同分发，按 CC BY 4.0 使用与再分发。
本仓库的插件源码以 MIT 许可发布，见 LICENSE。
bin/wx_key.dll 不在 MIT 覆盖范围内：它是上表所列的第三方作品，按 CC BY 4.0 分发。
整体再分发本仓库时请保留上面的署名与许可说明。
本项目仅用于导出你自己账号在本机的聊天记录。请遵守当地法律与他人隐私，不要用它处理你不拥有 的数据。数据库格式、加密参数与进程注入方式都依赖微信的具体版本，微信升级后可能失效——这属于预期 内的维护成本，不是缺陷。
index.js Host 半边：9 条 /api/wechat-chat/* 路由 + agent 工具 wechat_archive
client.js 客户端半边：左侧栏入口（sidebar.panellist）+ 主面板（main，keyed）
cordis.patch.yml bundle 组合：insert { id: wechat-archive }
lib/sqlcipher.js SQLCipher 4：KDF、page-1 HMAC、逐页 AES-256-CBC 解密到临时库
lib/wechat.js 账号发现、会话列举、类型判定、消息解码与占位符还原
lib/capture.js koffi + bin/wx_key.dll：只对已加载 Weixin.dll 的进程挂载、轮询密钥
lib/export.js HTML / CSV / TXT / JSON 汇总的写出
lib/service.js 面板与工具共用的服务方法（所有操作返回 {ok, error, code}）
locale/{zh,en}.json 插件名称与描述（Harness 的插件市场读取这里）
icon.svg 左侧栏与插件行的图标
bin/wx_key.dll 密钥捕获组件（第三方，CC BY 4.0，见文末署名）
test/ 9 个测试文件 + fixture.mjs，共 427 条断言，不依赖真实微信数据
面板一直说「还没有数据库密钥」
密钥只在登录瞬间可捕获。完全退出微信（含托盘与后台进程，tasklist 里不能有 Weixin.exe）后
再点捕获，按提示在手机上确认登录。
捕获时报「Hook 安装失败」
最常见的原因是注入了启动器进程。本插件只对已加载 Weixin.dll 的 PID 挂载并跳过启动器；
若仍失败，检查微信版本（4.x 内不同小版本行为有差异，4.1.15.56 已验证可用）。
导出成功但公众号是空的
公众号消息存在 biz_message_0.db，而不是 message_0.db。本插件两个文件都会读；若你的某个号
仍然空，多半是本地确实没有该号的聊天记录（公众号消息常被微信自己清理）。
改了 Host 代码但行为没变
运行中的 Host 仍持有旧模块。plugin_manager 执行 set_bundle enabled=false 再 enabled=true。
客户端代码（client.js）由 Harness 重新构建，无需手动处理。
node test/sqlcipher.test.mjs # 加密往返：KDF / page-1 MAC / 逐页解密 / 错误密钥
node test/messages.test.mjs # 消息类型解码、群前缀剥离、HTML/CSV/TXT 写出
node test/pipeline.test.mjs # 合成账号目录端到端（发现→解锁→列举→导出）
node test/service.test.mjs # 设置读写、筛选、预览、导出编排、目录守卫
node test/kinds.test.mjs # 会话类型判定：biz_info.type、@chatroom、@openim、公众号伞形筛选
node test/routes.test.mjs # 同源校验、方法/坏 JSON/超长 body
node test/tool.test.mjs # agent 工具的 8 个 action
node test/render.test.mjs # 客户端：slot 注册、图标、面板渲染、样式生效与清理
node test/realdb.test.mjs # 有真实密钥时校验真实库；没有则自动跳过
一次跑全部的 Bash 片段：
for f in test/*.test.mjs; do printf '%-28s ' "$f"; node "$f" >/dev/null 2>&1 && echo ok || echo FAIL; done
共 427 条断言。测试不依赖真实微信数据：test/fixture.mjs 会临时造一个 80 字节 reserve 的明文库，再按 SQLCipher 4
布局加密成账号目录，因此无需你的密钥也能验证全链路。
客户端那半没有可 import 的 React（运行时由模块表提供），test/render.test.mjs 因此用一个同等调用形状的
hook 替身把面板渲染一遍，用来抓语法检查抓不到的问题：条件式调用 hook、子节点 undefined、组件返回空、
内联样式写死颜色等。
改完 Host 代码后需要让事务重新加载（set_bundle enabled=false 再 =true），否则运行中的 host
仍持有旧模块。