Initial upload for secondary development

README.md

@@ -0,0 +1,114 @@
+# 微信知识库 - 使用说明
+
+## 环境要求
+
+| 软件 | 版本要求 |
+|---|---|
+| 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__` 进入发布资源。
+- 证书只通过本机路径参与签名，不会复制到客户安装包。