微信知识库 - 使用说明

环境要求

软件	版本要求
Windows	10/11 64位
微信	v4（推荐 4.1.5.30）
Node.js	20+ LTS
Python	3.10+

---

一次性配置（首次使用）

第一步：安装 Node.js

前往 https://nodejs.org 下载 LTS 版本安装，安装时勾选 "Add to PATH"。

验证安装：

node -v

第二步：安装 Python

前往 https://www.python.org/downloads 下载 3.10 或更高版本。

安装时务必勾选 "Add Python to PATH"。

验证安装：

python --version

第三步：安装 Python 依赖

打开命令提示符（CMD），进入 chatlog_fastAPI 目录执行：

cd 解压路径\get_wechat_me\chatlog_fastAPI
python -m pip install -r requirements.txt

启动方式

配置完成后，每次使用只需：

双击 无痕启动控制台.vbs

控制台窗口打开后，依次点击启动三个服务：

1. chatlog（微信数据服务，端口 5030）
2. FastAPI（后端，端口 8000）
3. 前端（端口 5173）

三个服务全部启动后，点击"进入系统"即可使用。

---

注意事项

• 启动前请确保微信已登录
• 若 chatlog 服务启动失败，尝试以管理员身份运行 无痕启动控制台.vbs
• 微信版本过新或过旧可能导致密钥提取失败，推荐使用 4.1.5.30

---

桌面版构建与代码签名

桌面版构建入口：

powershell -ExecutionPolicy Bypass -File .\scripts\build-desktop.ps1

默认构建允许未签名安装包，适合本机测试。未签名包在客户电脑上可能触发 Windows SmartScreen 或杀毒软件提示，这是 Windows 对未知发布者程序的常见提示。

如已有 Windows 代码签名 PFX/P12 证书，可在构建时启用签名：

powershell -ExecutionPolicy Bypass -File .\scripts\build-desktop.ps1 `
  -Sign `
  -CertificateFile "D:\certs\ChatLab-CodeSigning.pfx" `
  -CertificatePassword "证书密码" `
  -PublisherName "证书中的发布者名称" `
  -ForceSign

也可以使用环境变量，避免把证书密码写进命令历史：

$env:CHATLAB_PFX_FILE = "D:\certs\ChatLab-CodeSigning.pfx"
$env:CHATLAB_PFX_PASSWORD = "证书密码"
$env:CHATLAB_CERT_PUBLISHER_NAME = "证书中的发布者名称"
$env:CHATLAB_FORCE_SIGN = "1"
powershell -ExecutionPolicy Bypass -File .\scripts\build-desktop.ps1

签名相关环境变量：

变量	说明
CHATLAB_PFX_FILE	PFX/P12 证书完整路径
CHATLAB_PFX_PASSWORD	证书密码
CHATLAB_CERT_PUBLISHER_NAME	可选，证书发布者名称
CHATLAB_TIMESTAMP_SERVER	可选，默认 http://timestamp.digicert.com
CHATLAB_FORCE_SIGN	设为 1 时签名失败会中断构建

安全要求：

• 不要把 .pfx、.p12、.pvk、.key、.cer、.crt 或 certs/ 放进项目或安装包资源目录。
• 构建脚本会阻止证书、私钥、.env、knowledge*.db、__pycache__ 进入发布资源。
• 证书只通过本机路径参与签名，不会复制到客户安装包。