sjzar
FAQ
ISSUE 里不少重复问题，这里专门开个 ISSUE 说明一下，非常感谢之前的热心网友们帮忙解答问题，给大家磕头了。
信息安全问题
首先得强调信息安全问题，制作这个工具的初衷是希望能够方便将自己的聊天记录接入大模型，但是这个行为本身是存在信息安全隐患的。
如果将聊天记录接入云端大模型进行总结分析，就意味着已经将聊天记录发给大模型了，对方是否留档甚至利用这些数据进行训练，我们是无法得知的。
日常生活中私聊发送的敏感信息（例如身份、支付等），如果发生泄露，后果还挺严重的，所以大家使用工具前，请充分了解信息安全风险。
无法获取密钥的问题
TLDR: "临时使用低版本获取密钥" => "继续使用新版本"
chatlog 获取密钥的原理，是读取微信程序的内存数据，匹配特征后尝试解密本地数据库文件。
在微信 Windows 4.0.3.36 & macOS 4.0.3.80 以上的版本中，密钥信息不再长时间保留在内存数据中，所以无法通过当前方案获取密钥。
密钥在相同大版本内是通用的，因为数据库文件使用密钥加密，更换密钥需要重新加密整个数据库，一般只在大版本更新时才会更换密钥和加密算法，例如从 3.x 升级到 4.0。
目前可获取密钥的最后版本存档： Windows 4.0.3.36
- https://github.com/iibob/WechatWindowsVersionHistory/releases/tag/v4.0.3.36
- https://github.com/cscnk52/wechat-windows-versions/releases/tag/v4.0.3.36
macOS 4.0.3.80
- https://github.com/zsbai/wechat-versions/releases/tag/v4.0.3.80
如果需要长期保持在低版本且不让微信自动更新的话，可以再微信设置中禁止自动更新，也可以尝试在 hosts 文件中添加:
127.0.0.1 dldir1.qq.com
127.0.0.1 dldir1v6.qq.com
还有一类情况是 macOS Apple Silicon 用户会遇到的，获取密钥时日志中提示 timeout，这多半是由于终端、微信、chatlog 其中之一运行在 Rosetta 模式下运行导致。
图片无法访问的问题
部分图片无法访问的问题，有几个方面。
AES 加密 & WXGF 格式
微信 4.0.3 正式版之后，图片采用了 AES 加密，并且每个用户的 AES 密钥都不同，需要额外获取图片 AES 密钥才能解密。
近期更新已经支持获取图片 AES 密钥了，并且支持 wxgf 格式的解析，大家可以重新获取密钥后尝试一下。
wxgf 是微信内部的图片格式，需要转码后才能正常显示，目前提供了两个解析方案，通过 FFmpeg 命令行工具转码（推荐）或是转封装为 MP4 查看。
如果本地没有安装 FFmpeg 的话，WXGF 文件会被转封装为 MP4 文件，这样做的目的是让浏览器可以直接解析。
更推荐的方案是安装 ffmpeg 命令行工具，这样能够正常将 WXGF 文件转码为 JPG 图片，多帧动画将被转码为 GIF 动画。
只需要 PATH 路径中有 ffmpeg 命令行工具，chatlog 就会自动检测并使用 ffmpeg。
Windows 用户可以直接在 ffmpeg 官网下载 BtbN / gyan.dev 提供的预编译版本，下载后需要将 ffmpeg.exe 路径加入系统 PATH 中，稍微搜索就能找到很多教程。
macOS 用户可以使用 brew install ffmpeg 命令进行安装，非常方便。
wxgf 格式的详细信息，可以参考这篇博客：https://sarv.blog/posts/wxam/
微信中未打开图片
如果图片没有在微信中打开过，就不会下载数据到本地，所以无法访问到原图，只有缩略图。
这块没啥好办法，通过 Hook 调用客户端的 CDN 下载能力，或是尝试通过 API 获取 CDN 链接都越界了，暂时不考虑支持。
其他问题
其他常见问题的历史讨论，参考 https://github.com/sjzar/chatlog/issues/131 和之前的 ISSUE
讨论组
之前 @hao-ji-xing 大佬帮忙组织了讨论组，但是看到链接都过期了，这里尝试开一个 discord 讨论组，欢迎大家交流。
https://discord.gg/Qe3KxxmyuK
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：https://github.com/sjzar/chatlog/issues/190
目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：#190
目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
是相同请求参数偶发失败吗？
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：#190 目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
是相同请求参数偶发失败吗？
嗯嗯，是的。相同参数有时候正常请求、有时候重复请求一直都报这个错误，目前还未发现错误触发的规则，重启微信或者chatlog-server，过一段时间好像就正常了。
示例如下： 请求url： http://127.0.0.1:5030/api/v1/chatlog?time=2025-08-21&talker=xxxx&format=json 返回： <Response [404]> "time range not found: 2025-08-21 00:00:00 +0800 CST - 2025-08-21 23:59:59.999999999 +0800 CST"
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：#190 目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
是相同请求参数偶发失败吗？
嗯嗯，是的。相同参数有时候正常请求、有时候重复请求一直都报这个错误，目前还未发现错误触发的规则，重启微信或者chatlog-server，过一段时间好像就正常了。
示例如下： 请求url： http://127.0.0.1:5030/api/v1/chatlog?time=2025-08-21&talker=xxxx&format=json 返回： <Response [404]> "time range not found: 2025-08-21 00:00:00 +0800 CST - 2025-08-21 23:59:59.999999999 +0800 CST"
@sjzar 大佬，请问下这个问题定位到了吗，最近还是有这个情况
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：#190 目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
是相同请求参数偶发失败吗？
嗯嗯，是的。相同参数有时候正常请求、有时候重复请求一直都报这个错误，目前还未发现错误触发的规则，重启微信或者chatlog-server，过一段时间好像就正常了。 示例如下： 请求url： http://127.0.0.1:5030/api/v1/chatlog?time=2025-08-21&talker=xxxx&format=json 返回： <Response [404]> "time range not found: 2025-08-21 00:00:00 +0800 CST - 2025-08-21 23:59:59.999999999 +0800 CST"
@sjzar 大佬，请问下这个问题定位到了吗，最近还是有这个情况
还没看，有开自动解密吗？
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
大佬，这个issue可以看看么：#190 目前请求 /api/v1/chatlog 偶发 “time range not found” 错误，其他接口没问题，这个比较影响使用，求看看
是相同请求参数偶发失败吗？
嗯嗯，是的。相同参数有时候正常请求、有时候重复请求一直都报这个错误，目前还未发现错误触发的规则，重启微信或者chatlog-server，过一段时间好像就正常了。 示例如下： 请求url： http://127.0.0.1:5030/api/v1/chatlog?time=2025-08-21&talker=xxxx&format=json 返回： <Response [404]> "time range not found: 2025-08-21 00:00:00 +0800 CST - 2025-08-21 23:59:59.999999999 +0800 CST"
@sjzar 大佬，请问下这个问题定位到了吗，最近还是有这个情况
还没看，有开自动解密吗？
开了的，但自动解密有时候也不work 目前看，完全退出pc微信重新登录（pid不同），再手动执行是可以正常获取记录的。 辛苦有空看看，感谢！
开了的，但自动解密有时候也不work 目前看，完全退出pc微信重新登录（pid不同），再手动执行是可以正常获取记录的。 辛苦有空看看，感谢！
猜测是和自动解密相关，在更新文件过程中重新加载数据库文件列表造成的问题，晚点看下
大佬 求给个自定义图片key的设置项 版本问题导致无法自动获取 但我已经拿到key了 无法设置
更新了，是 @Symb0x76 老哥帮忙做的支持，感谢老哥，相关 PR: https://github.com/sjzar/chatlog/pull/238
大佬 求给个自定义图片key的设置项 版本问题导致无法自动获取 但我已经拿到key了 无法设置
大佬，3.x 版本，接口能看到 thumbpath 缩略图输出路径，请教下这个缩略图是不是手动点击也可以访问？在获得了image key的情况下，要怎么访问呢？ 127.0.0.1:5030/image/8460701bde765561b70e7833f40d8d03_t.dat 这种方式直接访问会输出：failed to decode hex key: encoding/hex: invalid byte: U+005F '_'
4.0.3.80也不行啊. MacOS 26. chatlog key NF tui config: {"config_dir":"/Users/admin/.chatlog","last_account":"","history":null,"webhook":null} 2025-09-09T15:28:25+08:00 ERR Failed to read memory error="no memory regions found" 2025-09-09T15:28:25+08:00 ERR failed to get key error="no valid key found"
4.0.3.80也不行啊. MacOS 26. chatlog key NF tui config: {"config_dir":"/Users/admin/.chatlog","last_account":"","history":null,"webhook":null} 2025-09-09T15:28:25+08:00 ERR Failed to read memory error="no memory regions found" 2025-09-09T15:28:25+08:00 ERR failed to get key error="no valid key found"
+1 4.0.3.80也不行
用上了，好用，爱用，多用！ 我的配置：M4 Pro的MBP，系统是15.4.1，微信下载的上面发那个4.0.3的Github链接，客户端用的是Cherry Studio，智谱的免费模型。 就是不知道会不会被微信封号呀，毕竟张小龙很小气。
用上了，好用，爱用，多用！ 我的配置：M4 Pro的MBP，系统是15.4.1，微信下载的上面发那个4.0.3的Github链接，客户端用的是Cherry Studio，智谱的免费模型。 就是不知道会不会被微信封号呀，毕竟张小龙很小气。
你可以吗老哥 我无论是windows还是macos 按照上面的方法都不行
用上了，好用，爱用，多用！ 我的配置：M4 Pro的MBP，系统是15.4.1，微信下载的上面发那个4.0.3的Github链接，客户端用的是Cherry Studio，智谱的免费模型。 就是不知道会不会被微信封号呀，毕竟张小龙很小气。
你可以吗老哥 我无论是windows还是macos 按照上面的方法都不行
能啊，很好用。不知道为什么你们不行。
使用软件就一直在登录环境异常，这个怎么解决啊，windows11 微信4.0.3.36
你这个号是不是新号
放弃使用这个项目了，新号老号都使用过，都收到安全警告了
4.0.6还不行，大佬会更新解密么
短期内不会更新，临时使用低版本获取密钥后即可正常在 4.0.6 版本使用 chatlog
意思是用4.0.3.36的微信获取密钥后，微信就可以更新最新版来使用了吗
https://github.com/sjzar/chatlog/issues/197#issuecomment-3305913745
已经发现分享的微信版本 4.0.3 的已经不被支持登录微信了，可恶的张小龙， 小气的很！
