115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# 微信知识库 - 使用说明
|
||
|
||
## 环境要求
|
||
|
||
| 软件 | 版本要求 |
|
||
|---|---|
|
||
| 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
|
||
powershell -ExecutionPolicy Bypass -File .\scripts\build-desktop.ps1
|
||
```
|
||
|
||
默认构建允许未签名安装包，适合本机测试。未签名包在客户电脑上可能触发 Windows SmartScreen 或杀毒软件提示，这是 Windows 对未知发布者程序的常见提示。
|
||
|
||
如已有 Windows 代码签名 PFX/P12 证书，可在构建时启用签名：
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File .\scripts\build-desktop.ps1 `
|
||
-Sign `
|
||
-CertificateFile "D:\certs\ChatLab-CodeSigning.pfx" `
|
||
-CertificatePassword "证书密码" `
|
||
-PublisherName "证书中的发布者名称" `
|
||
-ForceSign
|
||
```
|
||
|
||
也可以使用环境变量，避免把证书密码写进命令历史：
|
||
|
||
```powershell
|
||
$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__` 进入发布资源。
|
||
- 证书只通过本机路径参与签名，不会复制到客户安装包。
|