DSH-wechat-export · 微信聊天记录导出

一个 DeepSeek Harness 插件：在 左侧栏 加一个入口，把本机微信 4.x（Windows）的聊天记录解密导出为 网页时间线（HTML）、CSV 表格 与 纯文本（TXT）。同一套能力同时注册为 agent 工具 wechat_archive，可以直接让 agent 帮你列出、筛选、预览、导出。

所有处理都在本机完成：数据库解密、消息解析、文件写入都在 Harness 的 Host 进程里跑，没有任何网络上传。

功能

左侧栏入口 —— 与「插件」「消息」并列，点开即是完整导出面板，不占对话。
会话分类筛选 —— 群聊 / 私聊 / 公众号 / 订阅号 / 服务号 / 系统，六类一次勾选，判定依据全部来自库里证据。
三种格式同时产出 —— HTML（按天分组的左右气泡、可离线打开、支持深色）、CSV（Excel 直开）、TXT（便于 grep）。
不依赖 Python —— 纯 Node 实现 SQLCipher 解密（node:crypto + node:zlib + node:sqlite），零 npm 依赖。
导出目录可配置 —— 面板内直接改，或让 agent 用 set_out_dir 设一次长期生效。
agent 工具同源 —— 面板与工具调用同一套服务方法（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:\微信导出，也接受 ~/导出），回车或点「保存目录」即生效；
点「选择…」 调起系统的目录选择框（Host 不支持目录选择时按钮会给出提示，此时手输路径）；
清空后保存回到默认目录 %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 摘要里也有一行 汇总：<路径>。

交给 agent 用

工具 wechat_archive 的 action：status / list / export / preview / capture / set_out_dir / open_folder / forget。例如：

「看看本机微信有哪些群聊」→ action: "list", kinds: ["group"]
「把最近 7 天活跃的群导出成 CSV 给我」→ action: "export", kinds: ["group"], days: 7
「列出我关注的订阅号」→ action: "list", kinds: ["subscription"]
「先给我看看老王最近 30 条消息」→ action: "preview", wxid: "..."
「以后都导到 D:\微信备份」→ 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 精确匹配时剥离；
解密时每页的最后 80 字节（IV 16 + HMAC 64）不属于 SQLite 数据，补零后交给 node:sqlite；
setAutoPadding(false) 必须设置，否则 CBC 会吃掉尾部字节；
第 1 页的 HMAC 覆盖范围为 page1[16, 4032)，包含那段 IV。写成 [16, 4016)（把 IV 排除在外）会让正确密钥全部校验失败 —— 这是本项目踩过的最贵的坑，test/realdb.test.mjs 就是为了守住它；
视频消息的 length 是字节数、playlength 才是秒数，取错会显示成 [视频 56734 秒]；
卡片正文的 CDATA 段（<![CDATA[...]]>）不适合用模板字符串里的正则去抓，lib/wechat.js 里用字符串查找实现的 field() 更可靠。

隐私与合规

数据只在本机流转；插件不含任何网络请求代码，只有本机回环的 /api/wechat-chat/* 路由。
面板路由做了同源校验：非回环对端、非回环 Host、跨站 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 使用与再分发。

WXexport-tool — https://github.com/Ray0612/WeChat-Export-Tool — 作者 Ray0612 — CC BY 4.0
wechat-chat-export-general — 作者 Lee — 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 仍持有旧模块。

DSH-wechat-export · 微信聊天记录导出

所有处理都在本机完成：数据库解密、消息解析、文件写入都在 Harness 的 Host 进程里跑，没有任何网络上传。

功能

左侧栏入口 —— 与「插件」「消息」并列，点开即是完整导出面板，不占对话。
会话分类筛选 —— 群聊 / 私聊 / 公众号 / 订阅号 / 服务号 / 系统，六类一次勾选，判定依据全部来自库里证据。
三种格式同时产出 —— HTML（按天分组的左右气泡、可离线打开、支持深色）、CSV（Excel 直开）、TXT（便于 grep）。
不依赖 Python —— 纯 Node 实现 SQLCipher 解密（node:crypto + node:zlib + node:sqlite），零 npm 依赖。
导出目录可配置 —— 面板内直接改，或让 agent 用 set_out_dir 设一次长期生效。
agent 工具同源 —— 面板与工具调用同一套服务方法（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。

bin/wx_key.dll 是 Windows x64 原生组件。macOS / Linux 上插件仍可安装，但「捕获密钥」不可用。

为什么需要"捕获密钥"这一步

微信只在登录的最初几秒把密钥交给自己的数据库层（SetDBKey）。因此捕获流程是：

你手动完全退出微信（托盘图标、后台进程都要退）；
点面板上的「现在捕获密钥」；
插件拉起微信并挂载捕获组件，然后等你在手机上确认登录；
密钥一出现就写入本机文件，之后可长期复用（换账号才需要重新捕获）。

插件的边界，请放心：

绝不替你结束微信进程 —— 微信在跑时它会直接拒绝，并告诉你先手动退出；
绝不上传密钥，只写到 %USERPROFILE%\.dsh\wechat-chat-plugin\key.txt（权限 0600）；
只对已经加载 Weixin.dll 的进程挂载，跳过启动器进程（这是 4.x 上最常见的失败原因）。

使用

左侧栏点「微信聊天记录导出」图标，面板分三步：

步骤	做什么
1 · 取得密钥	确认环境（数据目录、账号、组件、微信是否在跑），然后捕获密钥
2 · 选择会话	按名称/wxid 搜索、按类型筛选（群聊 / 私聊 / 公众号 / 订阅号 / 服务号 / 系统）、全选/清空；双击行可预览最近 60 条
3 · 导出	先确认/修改导出目录，再导出选中会话或"导出全部会话"；结果里直接给文件路径与「打开导出目录」

导出目录

面板第 3 步顶部有一个「导出目录」输入框，三种用法：

直接输入绝对路径（D:\微信导出，也接受 ~/导出），回车或点「保存目录」即生效；
点「选择…」 调起系统的目录选择框（Host 不支持目录选择时按钮会给出提示，此时手输路径）；
清空后保存回到默认目录 %USERPROFILE%\.dsh\wechat-chat-plugin\exports。

每个会话产出三个文件（另有一份 JSON 汇总）：

<名称>-微信聊天记录-<YYYY-MM-DD>.html   按天分组的左右气泡时间线，无脚本、可离线打开、支持深色
<名称>-微信聊天记录-<YYYY-MM-DD>.csv    时间,发送人,类型,内容（UTF-8 BOM，Excel 直开）
<名称>-微信聊天记录-<YYYY-MM-DD>.txt    制表符分隔，便于 grep / 喂给脚本
微信聊天记录-<YYYY-MM-DD>.json          所有已导出会话的汇总，便于交给 AI 分析

交给 agent 用

工具 wechat_archive 的 action：status / list / export / preview / capture / set_out_dir / open_folder / forget。例如：

「看看本机微信有哪些群聊」→ action: "list", kinds: ["group"]
「把最近 7 天活跃的群导出成 CSV 给我」→ action: "export", kinds: ["group"], days: 7
「列出我关注的订阅号」→ action: "list", kinds: ["subscription"]
「先给我看看老王最近 30 条消息」→ action: "preview", wxid: "..."
「以后都导到 D:\微信备份」→ 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），所以两边结果永远一致。

会看到什么内容

已修复的实现要点（给以后维护的人）

local_type 的高位带压缩标记，判断类型必须先 & 0xffff；
message_content 可能是 zstd 帧（魔数 28 b5 2f fd），要 zstdDecompressSync；
real_sender_id 指向该数据库自己的 Name2Id 表，rowid 在不同 shard 之间会变，不能硬编码 1/2；
群消息正文常带 发送者wxid:\n 前缀，只能在与该条消息自身 sender 精确匹配时剥离；
解密时每页的最后 80 字节（IV 16 + HMAC 64）不属于 SQLite 数据，补零后交给 node:sqlite；
setAutoPadding(false) 必须设置，否则 CBC 会吃掉尾部字节；
第 1 页的 HMAC 覆盖范围为 page1[16, 4032)，包含那段 IV。写成 [16, 4016)（把 IV 排除在外）会让正确密钥全部校验失败 —— 这是本项目踩过的最贵的坑，test/realdb.test.mjs 就是为了守住它；
视频消息的 length 是字节数、playlength 才是秒数，取错会显示成 [视频 56734 秒]；
卡片正文的 CDATA 段（<![CDATA[...]]>）不适合用模板字符串里的正则去抓，lib/wechat.js 里用字符串查找实现的 field() 更可靠。

隐私与合规

数据只在本机流转；插件不含任何网络请求代码，只有本机回环的 /api/wechat-chat/* 路由。
面板路由做了同源校验：非回环对端、非回环 Host、跨站 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 使用与再分发。

WXexport-tool — https://github.com/Ray0612/WeChat-Export-Tool — 作者 Ray0612 — CC BY 4.0
wechat-chat-export-general — 作者 Lee — 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 条断言，不依赖真实微信数据

常见问题

开发

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

改完 Host 代码后需要让事务重新加载（set_bundle enabled=false 再 =true），否则运行中的 host 仍持有旧模块。

qiuleec/DSH-wechat-export

DSH-wechat-export · 微信聊天记录导出

功能

环境要求

安装

为什么需要"捕获密钥"这一步

使用

导出目录

交给 agent 用

会看到什么内容

已修复的实现要点（给以后维护的人）

隐私与合规

第三方组件与署名

许可

免责声明

项目结构

常见问题

开发

Community comments

qiuleec/DSH-wechat-export

DSH-wechat-export · 微信聊天记录导出

功能

环境要求

安装

为什么需要"捕获密钥"这一步

使用

导出目录

交给 agent 用

会看到什么内容

已修复的实现要点（给以后维护的人）

隐私与合规

第三方组件与署名

许可

免责声明

项目结构

常见问题

开发

Community comments