# 微信知识库 - 使用说明

## 环境要求

| 软件 | 版本要求 |
|---|---|
| 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__` 进入发布资源。
- 证书只通过本机路径参与签名，不会复制到客户安装包。