docs: 更新备忘录 - AI全代理模式 + 版本检查 + 服务器部署说明

Author: zcj220

开发备忘录.md

@@ -1,10 +1,84 @@
 # TestPilot AI 开发备忘录
 
-> 最后更新：2026-03-31（✅ 引擎下载 404 修复 + VSIX/引擎自托管）
+> 最后更新：2026-04-01（✅ AI 全代理模式 + 版本自动检查）
 > 项目结构详见 README.md，此处不重复。
 
 ---
 
+## ✅ AI 全代理模式 + 版本自动检查（2026-04-01，v1.5.4）
+
+### 背景
+
+引擎打包成 exe 后没有 `.env` 文件，`TP_AI_API_KEY` 未配置 → AI 诊断功能不可用。同时也需要一个机制让后端切换 AI 模型而不要求用户更新插件。
+
+### 架构设计
+
+```
+用户引擎（exe）
+  有 TP_AI_API_KEY → 直连豆包（开发模式，本地.env）
+  无 TP_AI_API_KEY → ProxyAIClient → xinzaoai.com/api/ai/proxy → 豆包
+         ↑ 后端改 TP_ARK_MODEL/TP_ARK_API_KEY 即可切换模型，无需用户更新
+```
+
+### 修改文件
+
+**引擎端：**
+- `src/core/ai_client.py`：末尾新增 `ProxyAIClient` 类，接口与 `AIClient` 完全相同
+  - 代理地址：`https://xinzaoai.com/api/ai/proxy`
+  - 鉴权：`X-Engine-Secret: testpilot-engine-secret-2026`
+- `src/app.py`：无 `TP_AI_API_KEY` 时自动使用 `ProxyAIClient`
+
+**服务器端（`xinzao/server/index.js`）：**
+- `bodyParser.json({ limit: '10mb' })`：支持截图 base64 大请求体
+- `GET /api/version/check`：返回 `{ latest, minimum, model, changelog }`
+- `POST /api/ai/proxy`：验证 `X-Engine-Secret` → 转发到豆包 → 返回 OpenAI 格式响应
+- 环境变量：`TP_ARK_API_KEY`、`TP_ARK_BASE_URL`、`TP_ARK_MODEL`、`TP_ENGINE_SECRET`
+
+**插件端（`extension/src/engineManager.ts`）：**
+- `_checkVersion()` 方法：启动时异步调 `/api/version/check`
+  - 低于 `minimum` → 弹出模态强制更新提示
+  - 低于 `latest` → 弱提示，用户可选择忽略
+
+### 服务器部署待做
+
+SSH 被 fail2ban 临时封锁，手动解封后执行：
+
+```bash
+# 1. 上传 server/index.js
+scp -i "D:\Projects\xinzao\key\xinzao_ai.pem" D:\Projects\xinzao\server\index.js ubuntu@115.159.71.197:/home/ubuntu/xinzao/server/
+
+# 2. 设置服务器环境变量
+ssh ubuntu@115.159.71.197
+cat >> /home/ubuntu/xinzao/server/.env << 'EOF'
+TP_ARK_API_KEY=98c755a5-2ae7-47b1-8904-a990482cfab2
+TP_ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
+TP_ARK_MODEL=doubao-seed-1-8-251228
+TP_ENGINE_SECRET=testpilot-engine-secret-2026
+EOF
+
+# 3. 重启服务
+pm2 restart xinzao-server  # 或 node index.js
+
+# 4. 上传新 VSIX
+scp testpilot-ai-1.5.4.vsix ubuntu@115.159.71.197:/var/www/xinzao/downloads/
+```
+
+### 版本管理说明
+
+服务器 `index.js` 里的两个常量控制版本策略：
+```javascript
+const TP_LATEST_VERSION  = '1.5.4';   // 弱提示更新
+const TP_MINIMUM_VERSION = '1.5.0';   // 低于此版本强制更新
+```
+**切换 AI 模型**：只需 SSH 改服务器 `.env` 的 `TP_ARK_MODEL`，重启服务，用户无感知。
+
+### Git 信息
+
+- Commit: `4b82bc6` — "feat: AI全代理模式 + 版本自动检查（v1.5.4）"
+- Tag: `v1.5.4`
+
+---
+
 ## ✅ 引擎下载 404 修复 + 插件自托管发布（2026-03-31）
 
 ### 问题背景