docs: 修正服务器架构说明和连接方式

Author: zcj220

开发备忘录.md

@@ -7,75 +7,65 @@
 
 ## ✅ AI 全代理模式 + 版本自动检查（2026-04-01，v1.5.4）
 
-### 背景
+### 架构（已确认正确）
 
-引擎打包成 exe 后没有 `.env` 文件，`TP_AI_API_KEY` 未配置 → AI 诊断功能不可用。同时也需要一个机制让后端切换 AI 模型而不要求用户更新插件。
+**两台服务器，职责不同：**
 
-### 架构设计
+| 服务器 | IP | 域名 | 用途 |
+|--------|-----|------|------|
+| xinzaoai.com | 115.159.71.197 | xinzaoai.com | 官网 + 文件下载（engine.exe, vsix） |
+| TestPilot AI | 82.157.97.179 | testpilot.xinzaoai.com | Python FastAPI 引擎 + AI 代理 |
 
-```
-用户引擎（exe）
-  有 TP_AI_API_KEY → 直连豆包（开发模式，本地.env）
-  无 TP_AI_API_KEY → ProxyAIClient → xinzaoai.com/api/ai/proxy → 豆包
-         ↑ 后端改 TP_ARK_MODEL/TP_ARK_API_KEY 即可切换模型，无需用户更新
-```
+**SSH 连接方式：**
+```bash
+# TestPilot AI 服务器（主服务器）
+ssh -i "D:\Projects\TestPilotAI\key\TestPilotAi.pem" ubuntu@82.157.97.179
 
-### 修改文件
+# xinzaoai.com 官网服务器（仅用于上传下载文件）
+scp -i "D:\Projects\xinzao\key\xinzao_ai.pem" ... ubuntu@115.159.71.197:/var/www/xinzao/downloads/
+```
 
-**引擎端：**
-- `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`
+**服务器关键路径（82.157.97.179）：**
+- 应用目录：`/opt/testpilot/app/`
+- 环境变量：`/opt/testpilot/app/.env`
+- 日志：`/opt/testpilot/logs/`
+- systemd 服务名：`testpilot-api.service`
+- 重启命令：`sudo systemctl restart testpilot-api`
 
-**服务器端（`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` → 弱提示，用户可选择忽略
+```
+用户引擎（本地 exe）
+  有 TP_AI_API_KEY → 直连豆包（开发模式）
+  无 TP_AI_API_KEY → ProxyAIClient
+                       ↓
+              testpilot.xinzaoai.com/api/v1/ai/proxy
+                       ↓（服务器有 API Key）
+                      豆包 AI（方舟平台）
+```
 
-### 服务器部署待做
+**切换 AI 模型**：SSH 改 `/opt/testpilot/app/.env` 的 `TP_AI_MODEL`，重启服务，用户无感知。
 
-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/
-```
+- `src/api/routes.py`：新增 `GET /version/check` 和 `POST /ai/proxy` 路由
+- `src/core/ai_client.py`：新增 `ProxyAIClient`，代理地址 `testpilot.xinzaoai.com/api/v1/ai/proxy`
+- `src/app.py`：无 Key 时自动使用 `ProxyAIClient`
+- `extension/src/engineManager.ts`：启动时调版本检查，强制/弱提示更新
 
-### 版本管理说明
+### 线上端点（已验证 HTTP 200）
 
-服务器 `index.js` 里的两个常量控制版本策略：
-```javascript
-const TP_LATEST_VERSION  = '1.5.4';   // 弱提示更新
-const TP_MINIMUM_VERSION = '1.5.0';   // 低于此版本强制更新
-```
-**切换 AI 模型**：只需 SSH 改服务器 `.env` 的 `TP_ARK_MODEL`，重启服务，用户无感知。
+| 端点 | URL |
+|------|-----|
+| 版本检查 | `https://testpilot.xinzaoai.com/api/v1/version/check` |
+| AI 代理 | `https://testpilot.xinzaoai.com/api/v1/ai/proxy` |
+| 引擎下载（Windows） | `https://xinzaoai.com/downloads/testpilot-engine-windows.exe` |
+| 插件下载 | `https://xinzaoai.com/downloads/testpilot-ai-1.5.4.vsix` |
 
 ### Git 信息
 
-- Commit: `4b82bc6` — "feat: AI全代理模式 + 版本自动检查（v1.5.4）"
-- Tag: `v1.5.4`
+- v1.5.4 commit: `7b6dcaf`
+- Tag: `v1.5.4`（含版本检查 + AI 代理）
 
 ---