# 构建设置 BuildOver 使用反向代理 + AI 聊天小部件包装您现有的开发服务器。您访问 `localhost:` 而不是原始端口，浮动面板可让您要求 Claude 使用 HMR 实时编辑源文件。 **软件包**（全部由 `buildover` CLI 拉入）： * `buildover` — CLI (`buildover dev`) * `buildover-server` — 自动安装的依赖项 * `buildover-widget` — 自动安装的依赖项 ## 工作流程 ### 1\.检查现有安装构建--版本 2>/dev/null || npx 构建 --版本 2>/dev/null ### 2\.安装构建版本 **全球（推荐）：** npm install -g 构建 **本地开发依赖：** npm install --save-dev 构建 # pnpm add -D 构建/yarn add -D 构建 ### 3\.检测目标端口读取 `package.json` 来查找开发端口：猫包.json | grep -E '“开发”|“开始”' 如果未指定，则常见默认值： * `3000` — React CRA、Next.js * `5173` — 维特 * `4200` — 角度 * `8080` / `8000` — 通用 / Django / Flask 不清楚的请用户确认。 ### 4\.配置API密钥 grep "ANTHROPIC_API_KEY" .env 2>/dev/null ||回显“未设置” 如果缺少，请添加到 `.env` （如果需要则创建）： ANTHROPIC_API_KEY=sk-ant-... 在获取密钥。 > 代理和小部件无需密钥即可工作 - 只有人工智能聊天需要它。 ### 5\.开始构建 # 全局安装： buildover dev --target <目标端口> --port # 本地安装： npx buildover dev --target <目标端口> --port <构建端口> 默认的“--port”是“4100”。使用“10001”以避免常见冲突。 **示例**（Next.js 在 3000 上，BuildOver 在 10001 上）：构建开发--目标3000--端口10001 # → 打开 http://localhost:10001 ### 6\. （可选）用于远程访问的 Cloudflare 隧道如果用户想要公共 HTTPS URL： # 安装 (macOS) 酿造安装cloudflared # 验证并创建隧道 cloudflared 隧道登录 cloudflared 隧道创建 <隧道名称> 创建 `~/.cloudflared/config.yml`：隧道：<隧道 ID> 凭证文件：/Users/<用户名>/.cloudflared/<隧道 ID>.json 入口： - 主机名：your-subdomain.yourdomain.com 服务：http://localhost: - 服务：http_status：404 cloudflared 隧道运行 <隧道名称> ## 验证清单 * 启动时没有“⚠ 未配置身份验证” → 已加载 API 密钥 ✓ * 横幅显示正确的目标和 BuildOver URL ✓ * 打开 `http://localhost:` 显示原始站点 + 浮动聊天按钮 ✓ * 发送聊天消息会触发服务器输出中的“[Agent]”日志 ✓ ## 常见问题问题 |修复 ---|--- BuildOver 端口上的“EADDRINUSE” | `lsof -i :` → 终止进程 `⚠ 未配置身份验证` |将“ANTHROPIC_API_KEY”添加到“.env”并重新启动服务器聊天已发送但代码未更改 |检查服务器日志中是否有“[Agent] Error”——通常是身份验证失败小部件不可见 |硬刷新；检查 `/buildover/widget.js` 返回 200 HMR 不工作 |在 BuildOver 之前启动原始开发服务器

构建设置

包含技能