[{"_1":2,"_169":-5,"_170":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_147":148},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_135":-5,"_136":11,"_137":22,"_138":11,"_139":11,"_140":-5,"_141":11,"_142":-5,"_143":144,"_145":91,"_146":-7},"canonicalUrl","https://hub.docker.com/r/liukunup/ai-software-engineer/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","liukunup","reponame","ai-software-engineer","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2025-11-07T08:59:42.209367Z","description","","is_private","last_updated","2025-11-19T17:50:21.010774Z","last_modified","2025-11-19T17:50:21.931295Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",386,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# AI Software Engineer\n\n

\n\n[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker&logoColor=white)](https://www.docker.com/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.110+-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)\n[![Python](https://img.shields.io/badge/Python-3.12+-3776AB?logo=python&logoColor=white)](https://www.python.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-22.x-339933?logo=node.js&logoColor=white)](https://nodejs.org/)\n[![Kubernetes](https://img.shields.io/badge/Kubernetes-Ready-326CE5?logo=kubernetes&logoColor=white)](https://kubernetes.io/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n**集成多种 AI 编程助手的智能工作节点**\n\n支持独立运行和集群部署 | 安全的命令执行 | 完整的 API 服务\n\n[快速开始](#-快速开始) • [功能特性](#-功能特性) • [部署指南](#-部署方式) • [API 文档](#-api-文档) • [配置说明](#-配置)\n\n

\n\n---\n\n## 📖 简介\n\nAI Software Engineer 是一个基于 Docker 的智能工作节点，集成了多种主流 AI 编程助手 CLI 工具，并提供 FastAPI 后端服务用于安全地执行白名单命令。\n\n### 核心特性\n\n- 🎯 **双模式运行**: Standalone（独立）和 Worker（集群）两种模式\n- 🔒 **安全执行**: 基于白名单的命令执行机制\n- 🚀 **开箱即用**: 一键启动脚本，快速部署\n- 📊 **完整监控**: 健康检查、心跳上报、状态追踪\n- ☸️ **云原生**: 支持 Docker、Docker Compose、Kubernetes\n- 🤖 **AI 集成**: GitHub Copilot、OpenAI Codex、Cursor、Alibaba Qoder、Tencent Codebuddy 等工具\n- 🔧 **灵活配置**: 支持按需安装 AI 工具，减少镜像体积\n\n---\n\n## 🎯 快速开始\n\n### 前置要求\n\n- Docker 20.10+\n- (可选) Docker Compose 2.0+\n- (可选) Kubernetes 1.20+\n- (可选) Python 3.12+ (本地开发)\n\n### 1️⃣ 本地开发模式\n\n使用 Python 虚拟环境运行：\n\n```bash\n# 克隆仓库\ngit clone https://github.com/liukunup-ai/ai-software-engineer.git\ncd ai-software-engineer\n\n# 创建虚拟环境并安装依赖\npython -m venv .venv\nsource .venv/bin/activate # Windows: .venv\\Scripts\\activate\npip install -r requirements.txt\n\n# 启动服务（使用启动脚本）\n./start.sh\n\n# 或直接使用 uvicorn\ncd app\nuvicorn main:app --host 0.0.0.0 --port 8007 --reload\n```\n\n访问服务：\n- API 文档: http://localhost:8007/docs\n- 健康检查: http://localhost:8007/healthz\n\n### 2️⃣ Docker 容器模式\n\n#### Standalone 模式（独立容器）\n\n```bash\n# 使用 Makefile 构建并运行\nmake build\nmake run\n\n# 或使用 Docker 命令\ndocker build -f docker/Dockerfile -t ai-software-engineer:latest .\ndocker run -d \\\n --name ai-worker \\\n -e NODE_MODE=standalone \\\n -p 8007:8007 \\\n ai-software-engineer:latest\n```\n\n#### Worker 模式（集群节点）\n\n```bash\n# 配置环境变量\nexport REGISTER_URL=http://master-node:8000\nexport REGISTER_KEY=your-secret-key\nexport NODE_NAME=worker-01\n\n# 使用启动脚本\n./start.sh --register http://master-node:8000 --key your-secret-key\n\n# 或使用 Docker Compose\ndocker-compose up -d\n```\n\n---\n\n## 🚀 功能特性\n\n### 运行模式\n\n| 模式 | 用途 | 特点 | 适用场景 |\n|------|------|------|----------|\n| **Standalone** | 独立容器 | 无需后端，快速启动 | 开发、测试、单机部署 |\n| **Worker** | 集群节点 | 自动注册，心跳上报 | 生产环境、分布式部署 |\n\n### 集成的 AI 工具\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n

GitHub Copilot 官方 AI 编程助手	OpenAI Codex OpenAI 代码模型	Claude Code Anthropic Claude 助手
Cursor AI 代码编辑器	Alibaba Qoder 阿里云代码助手	Tencent Codebuddy 腾讯代码助手
OpenCode 开源代码生成工具

\n\n### 技术栈\n\n- **基础镜像**: Ubuntu 24.04 LTS\n- **运行时**: Python 3.12 + Node.js 22.x\n- **框架**: FastAPI 0.110+ + Uvicorn\n- **HTTP 客户端**: httpx 0.27+\n- **容器化**: Docker + Docker Compose + Docker CLI\n- **编排**: Kubernetes (可选)\n\n---\n\n## 📦 包含的工具\n\n### 系统工具\n```bash\n├── Ubuntu 24.04 LTS\n├── Python 3.12\n├── Node.js 22.x\n├── Docker CLI\n├── Git\n├── curl, wget\n├── vim, tree\n└── 其他常用 CLI 工具\n```\n\n### AI 编程助手\n```bash\n# GitHub Copilot (可选安装)\ngh copilot suggest \"your task\"\ngh copilot explain \"complex command\"\n\n# OpenAI Codex (可选安装)\ncodex help\n\n# Claude Code (可选安装)\nclaude-code help\n\n# Cursor (可选安装)\ncursor help\n\n# Alibaba Qoder (可选安装)\nqoder help\n\n# Tencent Codebuddy (可选安装)\ntencent-codebuddy help\n\n# OpenCode (可选安装)\nopencode help\n```\n\n> **注意**: AI 工具默认全部安装。可通过构建参数控制按需安装，减少镜像体积。\n\n---\n\n## 🛠 部署方式\n\n### 方式 1: 快速启动脚本\n\n```bash\n# 本地开发（不使用 Docker）\n./start.sh\n\n# 使用 Makefile（Docker）\nmake build\nmake run\n\n# 自定义参数\n./start.sh --port 8080 --register http://master:8000 --key secret\n```\n\n### 方式 2: Docker 命令\n\n```bash\n# Standalone\ndocker run -d \\\n --name ai-standalone \\\n -e NODE_MODE=standalone \\\n -e ALLOWED_COMMANDS=echo,date,ls,python3,node \\\n -p 8007:8007 \\\n ai-software-engineer:latest\n\n# Worker\ndocker run -d \\\n --name ai-worker \\\n -e NODE_MODE=worker \\\n -e REGISTER_URL=http://master:8000 \\\n -e REGISTER_KEY=your-key \\\n -e NODE_NAME=worker-1 \\\n -e NODE_HOST=192.168.1.100 \\\n -e NODE_PORT=8007 \\\n -p 8007:8007 \\\n ai-software-engineer:latest\n```\n\n### 方式 3: Docker Compose\n\n```yaml\nversion: '3.8'\n\nservices:\n ai-software-engineer:\n image: ai-software-engineer:latest\n container_name: ai-software-engineer\n restart: unless-stopped\n ports:\n - \"8007:8007\"\n environment:\n NODE_MODE: worker # 或 standalone\n REGISTER_URL: http://localhost:8000\n REGISTER_KEY: key\n NODE_NAME: ai-software-engineer\n NODE_HOST: 127.0.0.1\n NODE_PORT: 8007\n HEARTBEAT_INTERVAL: 30\n ALLOWED_COMMANDS: echo,date,ls\n COMMAND_TIMEOUT: 15\n```\n\n```bash\ndocker-compose -f docker/docker-compose.yml up -d\n```\n\n### 方式 4: Kubernetes\n\n```bash\n# 部署\nkubectl apply -f docker/k8s-deployment.yaml\n\n# 扩容\nkubectl scale deployment ai-worker --replicas=10\n\n# 查看状态\nkubectl get pods -l app=ai-worker\n```\n\n详细配置参见 [k8s-deployment.yaml](./docker/k8s-deployment.yaml)\n\n---\n\n## 🔨 构建镜像\n\n### 使用 Makefile（推荐）\n\n```bash\n# 查看所有可用命令\nmake help\n\n# 构建完整镜像（包含所有 AI 工具）\nmake build\n\n# 强制重新构建（不使用缓存）\nmake build-no-cache\n\n# 构建最小化镜像（仅必要工具）\nmake build-minimal\n```\n\n### 自定义构建\n\n```bash\n# 指定镜像名称和标签\nmake build IMAGE_NAME=myorg/ai-worker IMAGE_TAG=v1.0\n\n# 选择性安装 AI 工具\ndocker build \\\n --build-arg INSTALL_GITHUB_COPILOT=true \\\n --build-arg INSTALL_OPENAI_CODEX=false \\\n --build-arg INSTALL_CURSOR=false \\\n --build-arg INSTALL_ALIBABA_QODER=true \\\n -f docker/Dockerfile \\\n -t ai-software-engineer:custom .\n\n# 指定 Python 和 Node.js 版本\ndocker build \\\n --build-arg PYTHON_VERSION=3.12 \\\n --build-arg NODE_VERSION=22.x \\\n -f docker/Dockerfile \\\n -t ai-software-engineer:latest .\n```\n\n---\n\n## 📡 API 文档\n\n### 端点列表\n\n| 方法 | 路径 | 描述 | 认证 |\n|------|------|------|------|\n| `GET` | `/healthz` | 健康检查，返回节点状态 | 否 |\n| `POST` | `/execute` | 执行白名单命令 | 否 |\n| `POST` | `/config/commands` | 更新命令白名单（运行时） | 否 |\n| `POST` | `/config/timeout` | 更新命令超时（运行时） | 否 |\n| `GET` | `/docs` | Swagger API 文档 | 否 |\n| `GET` | `/redoc` | ReDoc API 文档 | 否 |\n\n### 健康检查\n\n```bash\ncurl http://localhost:8007/healthz\n```\n\n响应示例（Standalone 模式）：\n```json\n{\n \"status\": \"healthy\",\n \"mode\": \"standalone\",\n \"node_name\": \"dev-node\",\n \"allowed_commands\": [\"echo\", \"date\", \"ls\", \"python3\"],\n \"command_timeout\": 15.0\n}\n```\n\n响应示例（Worker 模式）：\n```json\n{\n \"status\": \"healthy\",\n \"mode\": \"worker\",\n \"node_name\": \"worker-01\",\n \"node_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"register_url\": \"http://master:8000\",\n \"allowed_commands\": [\"echo\", \"date\", \"ls\", \"python3\"],\n \"command_timeout\": 15.0\n}\n```\n\n### 执行命令\n\n```bash\n# 执行 echo 命令\ncurl -X POST http://localhost:8007/execute \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"command\": \"echo\",\n \"args\": [\"Hello\", \"World\"]\n }'\n```\n\n响应示例：\n```json\n{\n \"command\": \"echo\",\n \"args\": [\"Hello\", \"World\"],\n \"exit_code\": 0,\n \"stdout\": \"Hello World\\n\",\n \"stderr\": \"\",\n \"duration_ms\": 12.5\n}\n```\n\n### 运行时配置更新\n\n```bash\n# 更新命令白名单\ncurl -X POST http://localhost:8007/config/commands \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"commands\": [\"echo\", \"date\", \"ls\", \"pwd\", \"python3\", \"node\"]\n }'\n\n# 更新命令超时\ncurl -X POST http://localhost:8007/config/timeout \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"timeout\": 30.0\n }'\n```\n\n### 错误处理\n\n```json\n// 命令不在白名单\n{\n \"detail\": \"Command 'rm' is not allowed\"\n}\n\n// 命令执行失败\n{\n \"detail\": \"Command 'invalid_cmd' not found\"\n}\n{\n \"detail\": \"命令执行超时\"\n}\n\n// 命令未找到\n{\n \"detail\": \"命令未找到，请检查容器或系统中是否已安装\"\n```\n\n### Swagger 文档\n\n访问 http://localhost:8007/docs 查看完整的交互式 API 文档。\n\n---\n\n## ⚙️ 配置\n\n### 环境变量\n\n#### 通用配置\n\n| 变量 | 说明 | 默认值 | 必需 |\n|------|------|--------|------|\n| `NODE_MODE` | 运行模式 (`standalone`/`worker`) | `worker` | 否 |\n| `NODE_NAME` | 节点名称 | 主机名 | 否 |\n| `ALLOWED_COMMANDS` | 允许的命令白名单（逗号分隔） | `echo,date,ls` | 否 |\n| `COMMAND_TIMEOUT` | 命令执行超时（秒） | `15` | 否 |\n| `HOST` | 监听地址 | `0.0.0.0` | 否 |\n| `PORT` | 监听端口 | `8007` | 否 |\n| `LOG_LEVEL` | 日志级别 | `info` | 否 |\n| `RELOAD` | 热重载（开发模式） | `false` | 否 |\n| `AISE_ENV` | 环境标识 | `dev` | 否 |\n\n#### Worker 模式专用\n\n| 变量 | 说明 | 默认值 | 必需 |\n|------|------|--------|------|\n| `REGISTER_URL` | 主节点地址 | `http://localhost:8000` | 是 |\n| `REGISTER_KEY` | 注册密钥 | `key` | 是 |\n| `NODE_HOST` | 节点主机地址 | 自动检测 | 否 |\n| `NODE_PORT` | 节点端口 | `8007` | 否 |\n| `NODE_DESC` | 节点描述 | `AI-Software-Engineer` | 否 |\n| `NODE_TAGS` | 节点标签（逗号分隔） | `worker,ai` | 否 |\n| `HEARTBEAT_INTERVAL` | 心跳间隔（秒） | `30` | 否 |\n\n### 配置示例\n\n```bash\n# .env 文件（Worker 模式）\nNODE_MODE=worker\nREGISTER_URL=http://192.168.1.100:8000\nREGISTER_KEY=my-secret-key-2024\nNODE_NAME=worker-prod-01\nNODE_HOST=192.168.1.101\nNODE_PORT=8007\nNODE_DESC=Production Worker Node\nNODE_TAGS=production,gpu,high-memory\nHEARTBEAT_INTERVAL=30\nALLOWED_COMMANDS=echo,date,ls,pwd,cat,python3,node,npm,git\nCOMMAND_TIMEOUT=30\nLOG_LEVEL=info\nAISE_ENV=production\n\n# .env 文件（Standalone 模式）\nNODE_MODE=standalone\nNODE_NAME=dev-node\nALLOWED_COMMANDS=echo,date,ls,pwd,python3,node\nCOMMAND_TIMEOUT=15\nPORT=8007\nLOG_LEVEL=debug\nRELOAD=true\nAISE_ENV=dev\n```\n\n---\n\n## 📂 项目结构\n\n```\nai-software-engineer/\n├── 📄 README.md # 项目文档（本文件）\n├── 📄 GETTING_STARTED.zh-CN.md # 快速开始指南\n├── 📄 LICENSE # 开源许可证\n├── 📄 Makefile # 构建自动化\n├── 📄 requirements.txt # Python 依赖\n├── 🚀 start.sh # 启动脚本\n├── 🚀 start.ps1 # PowerShell 启动脚本\n│\n├── 📁 app/ # FastAPI 应用\n│ ├── __init__.py\n│ └── main.py # 主程序入口\n│\n├── 📁 docker/ # Docker 相关文件\n│ ├── Dockerfile # Docker 镜像定义\n│ ├── docker-compose.yml # Docker Compose 配置\n│ ├── entrypoint.sh # 容器入口脚本\n│ ├── k8s-deployment.yaml # Kubernetes 部署配置\n│ ├── .env.example # 环境变量示例\n│ └── 📁 scripts/ # AI 工具安装脚本\n│ ├── install-github-copilot.sh\n│ ├── install-openai-codex.sh\n│ ├── install-claude-code.sh\n│ ├── install-cursor.sh\n│ ├── install-opencode.sh\n│ ├── install-alibaba-qoder.sh\n│ └── install-tencent-codebuddy.sh\n│\n└── 📁 docs/ # 文档目录（预留）\n```\n\n## 🎓 使用教程\n\n### AI 工具配置\n\n#### GitHub Copilot\n\n```bash\n# 进入容器\ndocker exec -it ai-worker bash\n\n# 认证 GitHub\ngh auth login\n\n# 使用 Copilot\ngh copilot suggest \"create a REST API with Python FastAPI\"\ngh copilot explain \"docker run -it --rm -v \\$(pwd):/app ubuntu bash\"\n---\n\n## 🎓 使用教程\n\n### AI 工具配置\n\n#### GitHub Copilot\n\n```bash\n# 进入容器\ndocker exec -it ai-worker bash\n\n# 认证 GitHub\ngh auth login\n\n# 使用 Copilot\ngh copilot suggest \"create a REST API with Python FastAPI\"\ngh copilot explain \"docker run -it --rm -v \\$(pwd):/app ubuntu bash\"\n```\n\n#### 其他工具\n\n- **OpenAI Codex**: 参考 [OpenAI 文档](https://platform.openai.com/docs/)\n- **Claude Code**: 访问 [Anthropic 官网](https://www.anthropic.com/)\n- **Cursor**: 访问 [Cursor 官网](https://cursor.sh/)\n- **Alibaba Qoder**: 访问 [阿里云 Qoder](https://www.alibabacloud.com/product/qoder)\n- **Tencent Codebuddy**: 参考腾讯云官方文档\n- **OpenCode**: 参考项目 GitHub 仓库\n\n### 开发模式\n\n```bash\n# 本地开发（热重载）\n./start.sh --no-reload=false\n\n# 或使用 Docker（代码热加载）\ndocker run -it --rm \\\n -e NODE_MODE=standalone \\\n -e RELOAD=true \\\n -v $(pwd)/app:/app \\\n -p 8007:8007 \\\n ai-software-engineer:latest\n\n# 查看日志\ndocker logs -f ai-worker\ntail -f ai-software-engineer.log\n```\n\n### 生产部署\n\n```bash\n# 使用 Kubernetes\nkubectl apply -f docker/k8s-deployment.yaml\nkubectl get pods -w\n\n# 扩容到 10 个副本\nkubectl scale deployment ai-worker --replicas=10\n\n# 滚动更新\nkubectl set image deployment/ai-worker \\\n worker=ai-software-engineer:v2.0\n\n# 查看状态\nkubectl rollout status deployment/ai-worker\n```\n\n---\n\n## 🔒 安全建议\n\n### 命令白名单\n\n⚠️ **重要**: 严格控制 `ALLOWED_COMMANDS`，仅包含安全命令\n\n✅ **推荐的命令**:\n```bash\necho, date, ls, pwd, cat, python3, node, npm, git status, docker ps\n```\n\n❌ **禁止的命令**:\n```bash\nrm, shutdown, reboot, dd, mkfs, fdisk\n```\n\n⚠️ **谨慎使用**:\n```bash\ncurl, wget, apt, yum # 仅在必要时添加\n```\n\n### 最佳实践\n\n1. **最小权限**: 使用非 root 用户运行容器\n2. **网络隔离**: 使用 Docker 网络隔离\n3. **资源限制**: 设置 CPU 和内存限制\n4. **密钥管理**: 使用环境变量或 Kubernetes Secrets\n5. **日志审计**: 启用命令执行日志记录\n6. **定期更新**: 及时更新基础镜像和依赖\n\n### Docker 安全选项\n\n```bash\ndocker run -d \\\n --name ai-worker \\\n --user 1000:1000 \\\n --read-only \\\n --security-opt=no-new-privileges \\\n --cpus=2 \\\n --memory=4g \\\n -e NODE_MODE=standalone \\\n -p 8007:8007 \\\n ai-software-engineer:latest\n```\n\n---\n\n## 🧪 测试\n\n### 手动测试\n\n```bash\n# 测试 Standalone 模式\n./start.sh --test-mode\n\n# 测试健康检查\ncurl http://localhost:8007/healthz\n\n# 测试命令执行\ncurl -X POST http://localhost:8007/execute \\\n -H \"Content-Type: application/json\" \\\n -d '{\"command\": \"echo\", \"args\": [\"test\"]}'\n\n# 测试配置更新\ncurl -X POST http://localhost:8007/config/commands \\\n -H \"Content-Type: application/json\" \\\n -d '{\"commands\": [\"echo\", \"date\", \"ls\", \"pwd\"]}'\n```\n\n### 容器测试\n\n```bash\n# 构建并测试\nmake build\nmake run\nmake health-check\n\n# 查看容器状态\ndocker ps --filter \"name=ai-worker\"\n```\n\n---\n\n## 📊 监控和日志\n\n### 查看日志\n\n```bash\n# 本地开发日志\ntail -f ai-software-engineer.log\n\n# Docker 容器日志\ndocker logs -f ai-worker\ndocker logs --tail 100 ai-worker\n\n# Kubernetes 日志\nkubectl logs -f deployment/ai-worker\nkubectl logs -l app=ai-worker --tail=100\n```\n\n### 监控指标\n\n```bash\n# 容器资源使用\ndocker stats ai-worker\n\n# Kubernetes 资源使用\nkubectl top pods -l app=ai-worker\n```\n\n---\n\n## 🔧 故障排除\n\n### 常见问题\n\n#### 1. Worker 模式无法注册\n\n**症状**: 日志显示 `❌ 注册失败`\n\n**解决方案**:\n```bash\n# 检查后端连接\ncurl $REGISTER_URL/healthz\n\n# 验证配置\ndocker logs ai-worker | grep \"后端地址\"\n\n# 检查网络连接\ndocker exec ai-worker curl -v $REGISTER_URL/healthz\n```\n\n#### 2. 命令执行被拒绝\n\n**症状**: API 返回 `Command 'xxx' is not allowed`\n\n**解决方案**:\n```bash\n# 方法1: 重启时添加命令到白名单\ndocker run -d \\\n -e ALLOWED_COMMANDS=echo,date,ls,your-command \\\n ...\n\n# 方法2: 运行时更新白名单\ncurl -X POST http://localhost:8007/config/commands \\\n -H \"Content-Type: application/json\" \\\n -d '{\"commands\": [\"echo\", \"date\", \"ls\", \"your-command\"]}'\n -d '{\"commands\": [\"echo\", \"date\", \"ls\", \"your-command\"]}'\n```\n\n#### 3. 容器启动失败\n\n**症状**: 容器不断重启\n\n**解决方案**:\n```bash\n# 查看详细日志\ndocker logs ai-worker\n\n# 检查端口占用\nlsof -i :8007\n\n# 使用不同端口\ndocker run -d -p 8008:8007 ...\n```\n\n#### 4. 端口冲突\n\n**症状**: `Error: address already in use`\n\n**解决方案**:\n```bash\n# 查找占用端口的进程\nlsof -i :8007\nnetstat -anp | grep 8007\n\n# 修改启动端口\n./start.sh --port 8008\n```\n\n---\n\n## 📚 文档资源\n\n- 📖 [快速开始指南](./GETTING_STARTED.zh-CN.md) - 入门教程\n- 📖 [Makefile 命令](./Makefile) - 构建和部署命令\n- 📖 [API 文档](http://localhost:8007/docs) - Swagger 交互式文档\n- 📖 [ReDoc 文档](http://localhost:8007/redoc) - 美化的 API 文档\n\n---\n\n## 🤝 贡献指南\n\n欢迎贡献代码、报告问题或提出改进建议！\n\n### 开发流程\n\n```bash\n# 1. Fork 项目\n# 2. 克隆仓库\ngit clone https://github.com/your-username/ai-software-engineer.git\n\n# 3. 创建特性分支\ngit checkout -b feature/amazing-feature\n\n# 4. 提交更改\ngit commit -m \"feat: Add amazing feature\"\n\n# 5. 推送到分支\ngit push origin feature/amazing-feature\n\n# 6. 创建 Pull Request\n```\n\n### 代码规范\n\n- **Python**: 遵循 PEP 8 规范\n- **Shell**: 使用 ShellCheck 检查\n- **Docker**: 遵循 Docker 最佳实践\n- **提交信息**: 使用语义化提交 (feat/fix/docs/style/refactor/test/chore)\n\n### 提交类型\n\n- `feat`: 新功能\n- `fix`: 修复 Bug\n- `docs`: 文档更新\n- `style`: 代码格式调整\n- `refactor`: 代码重构\n- `test`: 测试相关\n- `chore`: 构建/工具链相关\n\n---\n\n## ⚠️ 注意事项\n\n1. **AI 工具授权**: GitHub Copilot、OpenAI Codex 等工具需要有效订阅\n2. **网络要求**: 部分工具需要互联网连接才能使用\n3. **存储空间**: 完整镜像约 2-3 GB，最小化镜像约 1 GB\n4. **定期更新**: 建议定期重新构建镜像以获取最新工具版本\n5. **安全风险**: 严格控制命令白名单，避免执行危险命令\n6. **日志管理**: 生产环境建议使用日志收集系统\n7. **资源限制**: 生产环境建议设置容器资源限制\n\n---\n\n## 📄 许可证\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n---\n\n## 🔗 相关链接\n\n### 官方网站\n- [GitHub Copilot](https://github.com/features/copilot)\n- [OpenAI Platform](https://platform.openai.com/)\n- [Anthropic Claude](https://www.anthropic.com/)\n- [Cursor](https://cursor.sh/)\n- [Alibaba Qoder](https://www.alibabacloud.com/product/qoder)\n- [FastAPI](https://fastapi.tiangolo.com/)\n\n### 技术文档\n- [Docker 文档](https://docs.docker.com/)\n- [Kubernetes 文档](https://kubernetes.io/docs/)\n- [Python 文档](https://docs.python.org/3/)\n- [Node.js 文档](https://nodejs.org/docs/)\n\n### 项目相关\n- [GitHub 仓库](https://github.com/liukunup-ai/ai-software-engineer)\n- [问题反馈](https://github.com/liukunup-ai/ai-software-engineer/issues)\n- [更新日志](https://github.com/liukunup-ai/ai-software-engineer/releases)\n\n---\n\n

\n\n**如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！**\n\nMade with ❤️ by [liukunup](https://github.com/liukunup-ai)\n\n

","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":22,"_83":11,"_84":11},"read","write","admin","user","storage_size",1294668004,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":124,"_125":94,"_126":33,"_127":56,"_57":128,"_129":130,"_131":121,"_132":124,"_133":66,"_134":22},"content_type","creator",6686419,"digest","sha256:dd3cf90983a99fd3bd91ffab66d788102c6e2fe759c69cc30578b364575f92dd","full_size",1294622670,"id",1014563584,"images",[103,118],{"_104":105,"_95":106,"_107":48,"_108":109,"_110":111,"_112":113,"_114":48,"_115":-5,"_116":98,"_63":66,"_117":-5},"architecture","amd64","sha256:1021a858359e4a7b2e289620d81c1ed5af97adea2772b40bb6cf5ee1080e4856","features","last_pulled","2026-11-01T07:10:36.606717279Z","last_pushed","2025-11-19T17:50:18.596179057Z","os","linux","os_features","os_version","size","variant",{"_104":119,"_95":120,"_107":48,"_108":121,"_110":122,"_112":119,"_114":48,"_115":-5,"_116":123,"_63":66,"_117":-5},"unknown","sha256:cf8ceeece14f670da7998516d724b7fca248a4888011efbd8a9d0f2b3842fb5d","2026-11-01T07:10:36.63544846Z","2025-11-19T17:50:19.308508227Z",31508,"2025-11-19T17:50:19.836888Z","last_updater","last_updater_username","media_type","latest","repository",29083674,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":149,"_156":157,"_143":167,"_168":11},{"_40":150,"_42":151,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":152,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":153,"_79":11,"_80":155,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":154},[78],{"_82":22,"_83":11,"_84":11},"tags",{"_158":64,"_159":-5,"_160":-5,"_161":162},"count","next","previous","results",[163],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":164,"_50":124,"_125":94,"_126":33,"_127":56,"_57":128,"_129":130,"_131":121,"_132":124,"_133":66,"_134":22},[165,166],{"_104":105,"_95":106,"_107":48,"_108":109,"_110":111,"_112":113,"_114":48,"_115":-5,"_116":98,"_63":66,"_117":-5},{"_104":119,"_95":120,"_107":48,"_108":121,"_110":122,"_112":119,"_114":48,"_115":-5,"_116":123,"_63":66,"_117":-5},[],"canDeleteTags","actionData","errors"]

liukunup/ai-software-engineer

Tags for liukunup/ai-software-engineer