WeChat History Archive

by Bowen Zhang
5
4
3
2
1
Score: 50/100

Description

Obsidian plugin for archiving WeChat public-account articles as Markdown with local images on Windows and macOS.

Reviews

No reviews yet.

Stats

4
stars
102
downloads
0
forks
24
days
3
days
3
days
1
total PRs
0
open PRs
0
closed PRs
1
merged PRs
0
total issues
0
open issues
0
closed issues
16
commits

Latest Version

4 days ago

Changelog

实时选择目录 / Select articles as pages arrive

  • 公众号及合集目录逐页显示,拉取过程中即可搜索和勾选;后续分页保留勾选和列表位置,新文章默认不选中。
  • 点击停止或拉取中断后,已取得的目录仍可选择保存,并标明“部分目录”。每页目录和勾选都会写入本地记录,重启插件可恢复。
  • 拉取中可点击“停止拉取并保存所选”,当前请求结束后保存点击时选定的文章。再次停止可取消等待中的保存。
  • 保存正文不会把部分目录标为完整。刷新目录会从头重新拉取,不从旧分页位置续拉。
  • 获取历史目录先尝试已有微信连接,仅在未连接时显示操作提示和备用主页链接;10 分钟内返回 Obsidian 可自动重试一次,也可手动重试或取消。
  • 保留 Windows、macOS 单篇和合集保存;Mac 历史目录仍为实验功能。

81 项自动化检查通过,覆盖分页实时显示、勾选保留、停止及重启恢复、并发写入、仅保存指定文章、合集隔离和原有功能。已检查宽窄窗口的独立界面预览;真实微信及 Obsidian 内的本次交互仍待实际使用确认。

History and album catalogs now appear page by page, with filtering and selection available during fetching. Later pages keep earlier selections and leave new articles unchecked. Stopping or interruption retains a selectable partial catalog, including across plugin restarts.

The new stop-and-save action finishes the current request and saves exactly the IDs selected at the click. A second stop cancels the queued save. Saving bodies does not make an incomplete directory complete; refreshing starts a new enumeration.

History requests try existing WeChat context first and show homepage guidance only when needed. Returning to Obsidian can trigger one retry within 10 minutes; manual retry and cancellation remain available. Windows and macOS behavior is retained, with Mac history still experimental.

Validation: 81 automated tests passed and isolated wide/narrow previews were inspected. The updated interaction has not been verified against live WeChat inside Obsidian.

README file from

Github

微信公众号归档 · WeChat Official Account Archive

中文说明 · English · 社区插件页面 · 下载安装包

中文说明

把微信公众号文章保存到 Windows / macOS 桌面版 Obsidian:可以粘贴链接直接保存单篇,也可以在拉取公众号历史目录或合集目录时勾选,随时停止并保存所选。文章生成 Markdown 笔记,图片可下载到本地。

当前版本:0.5.2。插件独立运行,不需要 AI、wechatDownload、微信读书、MCP 服务,也不需要额外安装 Python、Node.js 或 Docker。

主要功能

  • 单篇直接保存:粘贴文章链接即可保存,无需先获取目录,不扫描本机微信缓存。
  • 公众号历史目录:从任意一篇文章识别公众号,先尝试已有微信连接,连接不可用时再引导打开主页,分页取得当前可访问的历史目录。
  • 单个合集目录:支持微信原生合集 / 专辑链接,保留合集顺序,并在接口提供总数时核对篇数。
  • 边拉取边选择:每页到达后立即显示,新文章默认不勾选;支持标题搜索、全选当前结果和勾选未保存文章。
  • 保留部分目录:停止或中断后仍可勾选和保存已取得的文章;重启插件可恢复部分目录及未完成的选择。
  • 正文与图片归档:保存图文、图片短文和音频帖的文字介绍;图片可下载到笔记库,保留次序、比例和显示宽度。
  • 保留已有笔记:同来源笔记不会被覆盖,保留使用者的修改;记录进度、不可访问文章和失败原因。
  • 本地阅读与索引:每篇笔记保留原文链接,提供归档索引;已保存的正文、本地图片和目录可离线阅读。

“历史目录已遍历”表示接口返回了明确的末页,不代表能够取得公众号曾经发布的所有文章。已删除、受限、付费或未列入目录的内容可能无法获取。

使用条件

项目 要求
系统 Windows 和 macOS 桌面版;不支持 Linux 和移动端。
Obsidian 1.8.0 及以上;尚未逐一验证所有版本。
微信历史目录 Windows 微信 4.1.6.14 已有实测;Mac 微信 4.x 缓存适配为实验功能,尚未完成真实历史目录验收。两者均需本人已登录的微信和可用网页缓存;连接不可用时再按提示打开主页。
网络 获取新目录、正文和图片需要联网。公开单篇及合集通常不需要登录微信或读取本机缓存。

Mac 安装与验证范围: 见 MACOS.md。单篇文章、图片和公开合集使用与 Windows 相同的保存流程;历史目录受 Mac 微信缓存权限与格式影响,不把“未连接”解释为“没有文章”。

安装

方式一:通过社区目录安装
  1. 打开 Obsidian 社区插件页面,点击 Add to Obsidian。
  2. 在 Obsidian 中允许使用社区插件,安装并启用 WeChat Official Account Archive。
  3. 点击左侧工具栏的绿色归档图标,打开“微信公众号归档”面板。

也可以在“设置 → 第三方插件”的社区目录中搜索插件英文名称。每个新版本需要单独完成社区检查,目录中的可安装版本可能晚于 GitHub。

方式二:手动安装或更新
  1. 在 GitHub Releases 下载 wechat-history-archive-版本号.zip。
  2. 解压,将其中的 wechat-history-archive 文件夹放到笔记库的 .obsidian/plugins/ 下。
  3. 确认该文件夹内直接包含 main.js、manifest.json 和 styles.css。
  4. 重新打开 Obsidian,在“设置 → 第三方插件”中启用 WeChat Official Account Archive。

也可从 Release 单独下载上述三个文件。若笔记库自定义了配置目录,请使用该目录下的 plugins 文件夹。GitHub 自动生成的 “Source code” 压缩包是开发源码,不能直接安装。

升级时保留 data.json、笔记和附件。 0.3.4 将公开名称从 WeChat History Archive 改为 WeChat Official Account Archive,插件 ID、保存目录和设置格式不变,不需要迁移已有归档。

使用

只保存一篇文章
  1. 打开“微信公众号归档”面板,粘贴这篇文章的链接。
  2. 点击 保存单篇文章,等待正文和图片保存。
  3. 点击 打开刚保存文章 查看笔记。

单篇保存不获取公众号或合集目录,也不扫描微信缓存。公开文章通常无需登录;遇到微信验证、作者限制或删除页面时会停止并提示。图片是否下载遵循插件的“下载图片”设置。

每个公众号的单篇记录保存在同一文件夹下的 单篇归档记录.json 和 单篇归档索引.md 中,与历史及合集索引独立。页面提供统一文章标识时,短链接与长链接会识别为同一篇;已有同来源笔记会保留,后续批量归档也会复用。

保存一个公众号的历史文章
  1. 登录电脑微信(Windows;Mac 微信 4.x 为实验支持)。
  2. 点击 Obsidian 左侧绿色归档图标,或右下角的 微信公众号归档 按钮。也可以在命令面板搜索插件英文名称。
  3. 粘贴目标公众号任意一篇文章的链接,例如 https://mp.weixin.qq.com/s/...。
  4. 直接点击 获取文章目录。插件先尝试已有微信连接;连接有效时直接读取目录,无需预先复制主页链接。
  5. 只有提示未连接时,才在电脑微信内找到该公众号并打开可向下翻动的历史文章页,也可尝试从文章顶部的公众号名称进入。向下翻动几屏后返回 Obsidian,插件会自动重试一次。
  6. 若仍未连接,点击 复制备用主页链接,把链接发到微信文件传输助手,在 电脑微信内部 打开,再点击 重新检测连接。
  7. 目录会逐页显示,拉取过程中即可搜索和勾选,无需等全部拉完。可以点击 停止拉取并保存所选,或等待拉取结束后点击 保存所选文章。目录获取本身不下载正文。

自动重试仅属于你刚刚发起的目录请求,有效期为 10 分钟,不轮询缓存。可点击 取消等待;更换链接、保存文件夹或发起单篇保存也会取消等待。验证、频率限制、系统权限错误及已开始分页后的错误不会自动重试。等待连接不会覆盖已有目录或索引。

本次优化不等于自动打开微信内置浏览器。首次使用或连接过期时,仍可能需要在微信内打开主页;普通公众号入口是否产生兼容缓存取决于微信版本,备用主页链接仍保留。

目录支持标题搜索、全选当前结果、勾选当前未保存 和 清空全部勾选。搜索和后续分页不会取消之前的勾选;新到达的文章不会自动选中,保存按钮显示全部勾选数量。

点击 停止拉取并保存所选 后,会在当前请求结束、保留已取得目录后开始保存;仅处理点击时选定的文章,不继续翻页。再次点击 停止 可取消这次等待中的保存。遇到验证、频率限制或其他拉取错误时,也会取消等待中的保存并提示原因。

只保存某个合集的文章

在同一输入框粘贴微信原生合集链接(路径为 /mp/appmsgalbum,包含 __biz 和 album_id),点击 获取文章目录,即可边拉取边勾选;停止后同样保留已取得的部分合集目录。

公开合集通常无需先打开微信主页或扫描本机缓存。插件会自动翻页;中途失败、重复页或篇数不符不会被标记为完整目录。微信要求验证或拒绝访问时,插件会提示并停止。

每个合集有独立的索引和进度文件,不覆盖公众号历史索引;相同文章共用笔记和附件。当前不自动解析公众号自定义菜单、第三方专题页或后台分组。

中断、继续与刷新
  • 拉取目录时点击 停止,会在当前请求结束后保留已取得的目录和勾选,可直接保存所选文章;目录及索引会标注“部分目录”,不会被误认为已经拉完。保存正文不会补全目录。
  • 保存文章时点击 停止,保留已保存的笔记,未完成的勾选可以继续保存。
  • 每页目录和勾选都会写入本地记录。重新打开面板或重启插件,可恢复上次取得的目录(包括部分目录)和未完成的选择,无需联网。
  • 点击 刷新文章目录 从头重新获取当前目录、检查新文章;目前不从上次停止的分页位置续拉。刷新尚未取得新页面就失败或停止时,保留旧目录。更换来源链接或保存文件夹后,需要重新获取目录。
  • 已有同来源笔记及使用者修改会保留;未勾选文章不会被下载或删除。

文件保存在哪里

默认保存到当前笔记库的 公众号归档 文件夹,可在插件设置中修改,也可关闭图片下载。

公众号归档/
└─ 公众号名称/
   ├─ 公众号归档索引.md
   ├─ 归档记录.json
   ├─ 日期 文章标题 [文章标识].md
   └─ 附件/

合集的索引和进度也保存在对应公众号的文件夹内。已下载的图片支持离线阅读;下载失败而保留的远程图片仍需要网络。

常见问题与限制

提示或现象 说明或处理方式
未连接到可用的微信页面 在电脑微信内重新打开目标公众号主页,翻动几屏后再获取目录。
没有找到支持的网页缓存 确认使用 Windows 微信或 Mac 微信 4.x;微信版本变化可能导致缓存布局不兼容。
微信要求验证或访问频率受限 在微信中完成验证,或暂停一段时间再试;已保存的文章会保留。
作者隐私设置限制、文章删除或其他访问限制 记录不可访问状态,不把空白页面保存为成功笔记。插件不绕过这些限制。
图片下载失败 保留允许的远程图片链接,并在记录中写明原因;远程图片不能离线显示。
排版与原网页不同 Markdown 以阅读为主,改善空白、强调、表格及图片布局,但不完全复刻微信模板的背景、字体和定位效果。
音频或视频没有下载 保留原文入口和可提取的文字介绍,不下载音视频本体,也不生成转写。

已验证实际目录及正文下载、图片引用、部分排版样例和模拟 Obsidian API 加载。尚未完成真实 Obsidian 界面的全面自动化验收,也未覆盖所有公众号样式。微信网页接口及缓存格式可能变化。

隐私、账号与网络

账号与费用。 获取整个公众号的历史目录需要本人已登录的电脑微信;公开单篇及合集通常不需要。插件不要求单独注册账号、API 密钥、订阅或付费服务。

网络请求。 只在使用者主动识别公众号、获取目录或保存文章时联网,使用 HTTPS:

  • mp.weixin.qq.com:文章、账号信息、公众号历史目录及合集目录。
  • qpic.cn、qlogo.cn、res.wx.qq.com 及其子域名:文章图片。

微信页面会话参数只发送至 mp.weixin.qq.com,重定向地址会经过校验。

笔记库外文件。 公众号历史目录功能会只读检查以下位置的微信网页缓存,匹配使用者已经打开的目标公众号页面。单篇文章和公开合集不扫描这些缓存。

%APPDATA%\Tencent\xwechat\radium\web
%APPDATA%\Tencent\xwechat\radium\cache
%APPDATA%\Tencent\WeChat\XPlugin\Plugins\Radium
%APPDATA%\Tencent\WeChat\XPlugin\Plugins\XWeb
%APPDATA%\Tencent\WeChat\Cache

Mac 微信 4.x 的实验适配仅检查:

~/Library/Containers/com.tencent.xinWeChat/Data/Documents/app_data/radium/web
~/Library/Containers/com.tencent.xinWeChat/Data/Documents/app_data/radium/cache

Mac 读取 Chromium Simple Cache v5 的 URL key,不扫描响应正文;不兼容的格式和权限不足会提示并停止。

插件不会修改上述目录;跳过聊天数据库、登录数据库、独立 Cookie 数据库和聊天附件目录。会话参数只在内存中使用,不写入设置、笔记或进度文件。粘贴链接在保存设置前会去除会话及追踪参数,旧配置在启动时也会清理。

本地保存与同步。 文章、图片、公共来源链接、索引和进度通过 Obsidian 接口写入所选的笔记库文件夹,插件设置通过 Obsidian 配置接口保存。若笔记库启用了同步,这些文件也会按原有设置同步。

连接重试。 使用者主动获取历史目录但未连接时,返回 Obsidian 可触发一次缓存检查和目录重试;等待超过 10 分钟、取消或更换来源后不再自动重试。连接提示只保存在内存中,不自动打开微信、发送消息或操作鼠标键盘。

剪贴板与其他服务。 只有点击复制按钮时,插件才把生成的公开链接写入剪贴板,不读取剪贴板。没有广告、遥测、分析服务、AI 调用、第三方上传或后台下载,也不会自行更新依赖库。

本项目独立开发,不是微信或 Obsidian 官方产品。仓库和发布包不包含使用者的微信缓存、会话参数、归档文章或笔记库配置。

开发与许可证

仅开发者需要 Node.js 22 或以上版本:

npm ci
npm run check

构建产物位于 dist/wechat-history-archive/;运行所需第三方库已打包到 main.js,最终用户不需要开发环境。测试使用虚构会话和本地样例,不连接实际微信账号。构建会将 CSS 解析依赖中的动态错误类型查找替换为静态映射,保留依赖许可,并在上游代码变化时停止构建。

发布标签必须与 manifest.json 的版本完全一致,例如 0.5.2,不加 v 前缀。社区安装要求 Release 单独附上 main.js、manifest.json 和 styles.css。

采用 MIT 许可证。项目及第三方许可全文包含在 main.js 的注释中;手动安装包还附带 LICENSE 和 THIRD-PARTY-NOTICES.txt。更新记录见 CHANGELOG.md。

问题反馈请使用 GitHub Issues。请勿在公开反馈中附上会话参数、原始缓存、私人文章内容或笔记库配置。


English

Save individual or selected WeChat Official Account (微信公众号) articles as Markdown notes with local images in Obsidian on Windows or macOS. Save one article directly, or fetch an account's currently accessible history or a native WeChat album and choose which articles to save.

Version: 0.5.2. The plugin runs inside Obsidian. End users do not need Python, Node.js, Docker, AI, an MCP server, wechatDownload, or WeChat Read.

Features

  • Save one article directly without fetching a directory or scanning WeChat caches.
  • Fetch available account history or one native album, with pagination and completeness checks.
  • Choose articles while pages arrive. New entries remain unchecked and earlier selections are retained.
  • Keep partial catalogs and unfinished selections after stopping, errors, or restarting the plugin.
  • Search by title, select visible results, or select unsaved articles.
  • Save text and local images, preserving image order, proportions, and display widths.
  • Improve Markdown spacing, emphasis, tables, and decorative image sizing.
  • Preserve existing notes and user edits, record unavailable articles, and resume unfinished selections.
  • Keep local indexes and original public URLs. Albums have separate indexes and share notes for the same article.

Requirements

  • Windows or macOS desktop Obsidian. The manifest specifies version 1.8.0 or later; not every version has been tested. Mobile and Linux are not supported.
  • A logged-in desktop WeChat client for full-account history. Windows WeChat 4.1.6.14 has prior validation. Mac WeChat 4.x history is experimental; live history enumeration is not yet verified.
  • Internet access for new directories, articles, and images. Saved notes, local images, and local directories can be read offline.

Installation

Community directory

Open the community plugin page, click Add to Obsidian, then install and enable WeChat Official Account Archive. You can also search for that name under Settings → Community plugins. Each release is checked separately; the installable directory version may lag behind GitHub.

Manual installation or upgrade
  1. Download the installation ZIP from GitHub Releases.
  2. Extract it and copy the wechat-history-archive folder into your vault's plugin directory. The default location is .obsidian/plugins/.
  3. Confirm that the folder directly contains main.js, manifest.json, and styles.css.
  4. Restart Obsidian, open Settings → Community plugins, and enable WeChat Official Account Archive.

You can also download those three files separately from the release. GitHub's source-code archives need to be built before installation. Preserve data.json, notes, and attachments when upgrading. If your vault uses a custom configuration directory, use its plugins subdirectory.

Version 0.3.4 updates the display name from WeChat History Archive; the plugin ID, settings format, and storage paths remain unchanged.

Usage

The plugin interface is currently in Chinese. The steps below identify each button.

Save one article

Paste the article URL and click 保存单篇文章 (save this article). After saving, click 打开刚保存文章 (open saved article). The image-download setting also applies to single articles.

This path does not enumerate history or scan WeChat caches. Public articles usually need no login. Verification, deleted pages, and author restrictions are reported without bypassing access controls.

Single saves have their own 单篇归档记录.json and 单篇归档索引.md inside the account folder; they do not replace history or album indexes. When the page exposes a stable article ID, short and long links reuse the same note, including during later batch saves. Existing notes and user edits are preserved.

Archive account history
  1. Sign in to your own desktop WeChat account (Mac WeChat 4.x history is experimental).
  2. Click the green archive icon in Obsidian's left ribbon or the 微信公众号归档 status-bar button. You can also search for WeChat Official Account Archive in the command palette.
  3. Paste a public article URL from the target account, such as an https://mp.weixin.qq.com/s/... URL.
  4. Click 获取文章目录 (fetch directory) directly. The plugin first tries existing WeChat context; a working session needs no preliminary homepage copy.
  5. Only if connection guidance appears, open that account's scrollable history page inside desktop WeChat. The account name at the top of an article is another possible entry point. Scroll down, then return to Obsidian for one automatic retry.
  6. If it still cannot connect, click 复制备用主页链接 (copy backup homepage), send it to WeChat's File Transfer Assistant, open it inside desktop WeChat, then click 重新检测连接 (retry connection).
  7. Pages appear as they arrive, and you can search and select immediately. Click 停止拉取并保存所选 (stop fetching and save selected), or wait for the directory to finish and click 保存所选文章 (save selected). Fetching the directory does not save article bodies.

The automatic retry expires after 10 minutes and never polls caches. 取消等待 (cancel waiting), changing the source or output folder, or starting a single save cancels the pending retry. Verification, rate limits, system permission errors, and failures after pagination begins are not retried automatically. Waiting for context preserves the existing directory and index.

This does not automatically open WeChat's internal browser. A first visit or expired context may still require opening the homepage in WeChat. Whether normal account navigation produces compatible cache data depends on the WeChat version; the backup link remains available.

Use title search, 全选当前结果 (select visible results), 勾选当前未保存 (select visible unsaved articles), or 清空全部勾选 (clear selections). Filtering and later pages do not clear earlier selections; new entries are not selected automatically. Existing notes from the same source are preserved.

停止拉取并保存所选 stops pagination after the current request, retains its entries, then saves only the articles selected at the click. Pressing 停止 again cancels the queued save. Verification, rate limits, or other fetch errors also cancel it and report the problem.

Click 停止 (stop) to stop after the current request and retain fetched entries, selections, and saved notes. Partial catalogs remain selectable and are explicitly labeled incomplete in the panel and index, even after selected article bodies are saved. Each page and selection change is recorded locally; reopening the panel or restarting the plugin restores the latest catalog and unfinished selections without a network request. 刷新文章目录 (refresh directory) starts a fresh enumeration; it does not resume the old page cursor. If a refresh stops or fails before receiving a new page, the previous catalog is preserved.

Archive one album

Paste a native WeChat album URL containing /mp/appmsgalbum, __biz, and album_id, fetch its directory, and select articles while pages arrive. Stopping retains a selectable partial album catalog. Public albums normally work without a WeChat login or cache scan. If WeChat requests verification or denies access, the plugin stops and reports the condition.

Pagination preserves album order and checks the reported count when available. Incomplete, repeated, or inconsistent pages are not marked complete. Each album has its own index and progress record. Custom menus, third-party topic pages, and unpublished backend groups are not supported.

Storage and settings

The default vault-relative folder is 公众号归档. Each account has a subfolder containing its index, progress JSON, notes, and an 附件 image folder. Settings let you change the output folder or disable image downloads. Changing the source or folder requires fetching a new directory.

Privacy, network, and filesystem disclosures

Accounts and payments

Full-account history requires the user's own logged-in desktop WeChat client. Public individual articles and albums usually do not. There is no separate plugin account, API key, subscription, or payment. Verification requested by WeChat must be completed in WeChat.

Network requests

Requests occur only after the user asks to identify an account, fetch a directory, or save individual or selected articles. The plugin uses HTTPS to contact:

  • mp.weixin.qq.com for article pages, account information, history, and album directories.
  • qpic.cn, qlogo.cn, res.wx.qq.com, and their subdomains for article images.

WeChat session parameters are sent only to mp.weixin.qq.com. Redirect destinations are validated. Node HTTPS is used on desktop to enforce redirect boundaries, timeouts, and response-size limits without weakening TLS.

Files outside the vault

Full-account discovery uses Node filesystem APIs to read existing WeChat web caches outside the vault. Supported cache directories are under:

%APPDATA%\Tencent\xwechat\radium\web
%APPDATA%\Tencent\xwechat\radium\cache
%APPDATA%\Tencent\WeChat\XPlugin\Plugins\Radium
%APPDATA%\Tencent\WeChat\XPlugin\Plugins\XWeb
%APPDATA%\Tencent\WeChat\Cache

Experimental Mac WeChat 4.x discovery only checks:

~/Library/Containers/com.tencent.xinWeChat/Data/Documents/app_data/radium/web
~/Library/Containers/com.tencent.xinWeChat/Data/Documents/app_data/radium/cache

On Mac, only Chromium Simple Cache v5 URL keys are read, not response bodies. Unsupported formats and permission failures stop history discovery with an explanation. See MACOS.md for validation limits.

This reuses the session of an account page the user has already opened. The plugin does not modify these directories. It skips chat databases, login databases, standalone cookie databases, and chat attachment folders. Single-article saving and public-album discovery do not scan these caches.

Session values remain in memory and are not written to settings, notes, or progress records. Pasted URLs are stripped of session and tracking parameters before saving; old settings are cleaned on load. Articles, images, public links, and progress are written inside the selected vault folder through Obsidian APIs. Vault sync services synchronize those files according to the user's existing configuration.

Connection retry

After a user-requested directory fetch cannot connect, returning to Obsidian can trigger one cache check and catalog retry within 10 minutes. Cancellation or changed inputs invalidate the pending retry. This state is kept in memory only. The plugin does not automatically open WeChat, send messages, or control the mouse or keyboard.

Clipboard and other services

The backup-homepage button writes the generated public URL to the clipboard only when clicked. The plugin does not read the clipboard. There are no ads, analytics, telemetry, AI calls, third-party uploads, background downloads, or self-updating dependencies.

The bundled CSS parser resolves error constructors through a static lookup. The build replaces its upstream dynamic-evaluation fallback and fails if that dependency code changes unexpectedly. Dependency copyright and license notices remain included.

Limitations and troubleshooting

  • “Directory exhausted” means an explicit final page was returned, not that every article ever published is available. Deleted, restricted, paid, or unlisted content may be unavailable.
  • If no usable session is found, reopen the account homepage inside desktop WeChat and try again. Cache layouts and endpoints may change.
  • If WeChat requests verification or limits frequency, the plugin stops. Verify in WeChat or wait before retrying.
  • Author-restricted articles are recorded as unavailable, not saved as empty successful notes.
  • Failed image downloads retain an allowed remote image link and record the problem. Those remote images require internet access.
  • Audio, video, and embedded media retain an original-page link; media downloads and transcription are not supported.
  • Markdown focuses on readability and does not reproduce every WeChat background, font, or layout.

Validation includes actual directory and article downloads, image-reference checks, formatting comparisons, and automated tests with a simulated Obsidian API. Full automation against the real Obsidian interface and all account styles has not been completed. This is an independent project, not an official WeChat or Obsidian product.

Development

Use Node.js 22 or later:

npm ci
npm run check

Build output: dist/wechat-history-archive/. Runtime libraries are bundled into main.js; users need no development runtime. Tests use synthetic sessions and local fixtures, not real WeChat accounts.

Release tags must exactly match manifest.json, such as 0.5.2, without a v prefix. Attach main.js, manifest.json, and styles.css individually for community installation. The ZIP is also supplied for manual installation.

License and support

This project uses the MIT License. Project and third-party licenses are included as comments in main.js; manual packages also contain LICENSE and THIRD-PARTY-NOTICES.txt. See the changelog.

Report problems through GitHub Issues. Do not include session values, raw caches, private article content, or vault configuration in public reports.