From 9bd3e6c4a407215da6cbdc9c56a4682a31bdede7 Mon Sep 17 00:00:00 2001
From: KQL <apple@appledeMac-Pro.local>
Date: Sun, 24 Aug 2025 14:10:34 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=AF=A6=E7=BB=86=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=8C=87=E5=8D=97=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 包含快速部署和手动部署步骤
- 支持多种部署方式
- 添加故障排除指南
- 包含生产环境部署建议
---
 DEPLOYMENT.md | 288 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 288 insertions(+)
 create mode 100644 DEPLOYMENT.md

diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md
new file mode 100644
index 0000000..5672962
--- /dev/null
+++ b/DEPLOYMENT.md
@@ -0,0 +1,288 @@
+# 部署指南 - AI Agent 设计工作流
+
+## 快速部署（推荐）
+
+### 一键启动
+
+#### Mac/Linux 用户
+```bash
+# 克隆项目
+git clone http://123.60.55.248:3000/Duguay/agent.git
+cd agent
+
+# 运行快速启动脚本
+./quick-start.sh
+```
+
+#### Windows 用户
+```bash
+# 克隆项目
+git clone http://123.60.55.248:3000/Duguay/agent.git
+cd agent
+
+# 运行快速启动脚本
+quick-start.bat
+```
+
+项目将自动在 `http://127.0.0.1:5175` 启动
+
+---
+
+## 手动部署步骤
+
+### 1. 环境准备
+
+#### 必需环境
+- Node.js >= 14.0.0
+- npm >= 6.0.0
+- Git
+
+#### 检查环境
+```bash
+node --version  # 应显示 v14.0.0 或更高
+npm --version   # 应显示 6.0.0 或更高
+git --version   # 确保 Git 已安装
+```
+
+### 2. 获取代码
+
+```bash
+# 使用 Git 克隆
+git clone http://123.60.55.248:3000/Duguay/agent.git
+
+# 进入项目目录
+cd agent
+```
+
+### 3. 安装依赖
+
+```bash
+# 安装项目依赖
+npm install
+```
+
+### 4. 启动项目
+
+```bash
+# 启动开发服务器（自动打开浏览器）
+npm run dev
+
+# 或者只启动服务器（不自动打开）
+npm run serve
+```
+
+### 5. 访问应用
+
+在浏览器中访问：`http://127.0.0.1:5175`
+
+---
+
+## 其他部署方式
+
+### 使用 Python HTTP Server
+
+#### Python 3
+```bash
+cd agent
+python3 -m http.server 5175 --bind 127.0.0.1
+```
+
+#### Python 2
+```bash
+cd agent
+python -m SimpleHTTPServer 5175
+```
+
+访问：`http://127.0.0.1:5175/linear-workflow.html`
+
+### 使用 Live Server (VS Code)
+
+1. 在 VS Code 中安装 Live Server 扩展
+2. 右键点击 `linear-workflow.html`
+3. 选择 "Open with Live Server"
+4. 修改端口为 5175（可选）
+
+### 使用 Docker（高级）
+
+创建 `Dockerfile`：
+```dockerfile
+FROM node:14-alpine
+WORKDIR /app
+COPY . .
+RUN npm install
+EXPOSE 5175
+CMD ["npm", "run", "serve"]
+```
+
+构建并运行：
+```bash
+docker build -t ai-agent-workflow .
+docker run -p 5175:5175 ai-agent-workflow
+```
+
+---
+
+## 配置说明
+
+### 修改端口
+
+编辑 `package.json`：
+```json
+{
+  "scripts": {
+    "dev": "npx http-server -p 你的端口 -a 127.0.0.1 -o /linear-workflow.html",
+    "serve": "npx http-server -p 你的端口 -a 127.0.0.1"
+  }
+}
+```
+
+### 修改绑定地址
+
+如需允许外部访问，修改 `package.json`：
+```json
+{
+  "scripts": {
+    "dev": "npx http-server -p 5175 -a 0.0.0.0 -o /linear-workflow.html",
+    "serve": "npx http-server -p 5175 -a 0.0.0.0"
+  }
+}
+```
+
+⚠️ **安全提示**：绑定到 0.0.0.0 会允许外部访问，请确保在受信任的网络环境中使用。
+
+---
+
+## 故障排除
+
+### 问题1：npm install 失败
+
+**解决方案**：
+```bash
+# 清理缓存
+npm cache clean --force
+
+# 删除 node_modules 和 package-lock.json
+rm -rf node_modules package-lock.json
+
+# 重新安装
+npm install
+```
+
+### 问题2：端口被占用
+
+**错误信息**：
+```
+Error: listen EADDRINUSE: address already in use 127.0.0.1:5175
+```
+
+**解决方案**：
+
+查找占用端口的进程：
+```bash
+# Mac/Linux
+lsof -i :5175
+
+# Windows
+netstat -ano | findstr :5175
+```
+
+终止进程或更换端口。
+
+### 问题3：图片无法加载
+
+**原因**：直接打开 HTML 文件而非使用服务器
+
+**解决方案**：确保使用 HTTP 服务器运行项目
+
+### 问题4：页面显示异常
+
+**检查步骤**：
+1. 确认浏览器版本（推荐 Chrome 90+）
+2. 检查控制台错误信息（F12）
+3. 清除浏览器缓存（Ctrl+Shift+Delete）
+
+---
+
+## 生产环境部署
+
+### 使用 Nginx
+
+1. 安装 Nginx
+2. 配置 nginx.conf：
+
+```nginx
+server {
+    listen 5175;
+    server_name 127.0.0.1;
+    
+    root /path/to/agent;
+    index linear-workflow.html;
+    
+    location / {
+        try_files $uri $uri/ =404;
+    }
+    
+    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}
+```
+
+3. 重启 Nginx：
+```bash
+nginx -s reload
+```
+
+### 使用 PM2（持久化运行）
+
+1. 安装 PM2：
+```bash
+npm install -g pm2
+```
+
+2. 创建 `ecosystem.config.js`：
+```javascript
+module.exports = {
+  apps: [{
+    name: 'ai-agent-workflow',
+    script: 'npx',
+    args: 'http-server -p 5175 -a 127.0.0.1',
+    cwd: '/path/to/agent'
+  }]
+}
+```
+
+3. 启动应用：
+```bash
+pm2 start ecosystem.config.js
+pm2 save
+pm2 startup
+```
+
+---
+
+## 更新项目
+
+```bash
+# 拉取最新代码
+git pull origin master
+
+# 更新依赖
+npm install
+
+# 重启服务
+npm run dev
+```
+
+---
+
+## 联系支持
+
+遇到问题？请访问：
+- 项目仓库：http://123.60.55.248:3000/Duguay/agent
+- 提交 Issue：http://123.60.55.248:3000/Duguay/agent/issues
+
+---
+
+最后更新：2024-08-24
\ No newline at end of file