README.md

智能DevOps平台

本仓库主要包含以下内容：

• 一个 Trae 技能：用于执行 Git 推送并触发 Jenkins 代码扫描
• 一个本地仪表盘：包含总览、项目列表、项目详情、配置管理四个页面，支持多项目管理与联调
• 一套本地模拟服务：模拟 Git、Jenkins、Sonar、Nexus、GitLab 等接口，便于前后端联调
• 一套本地基础设施：通过 docker compose 一键启动 GitLab、SonarQube、Nexus（可选）

技能

• 工程内可维护版本：
  • skills/devops-push-scan/SKILL.md
  • skills/devops-push-scan/config.yaml
  • skills/devops-push-scan/prompts/
• Trae 入口（用于识别与调用）：
  • .trae/skills/devops-push-scan/SKILL.md

仪表盘

仪表盘通过后端 /api/* 获取数据，配置与项目数据统一存放在 work/：

• work/config.yaml：AI 模型配置
• work/projects.json：项目列表，包含 id、name、repo_path
• work/projects/<id>/api/*.json：每个项目的系统配置，如 git、jenkins、sonar、nexus
• work/projects/<id>/api/gitlab.json：GitLab 配置（可选）

模拟服务

• 启动端口：http://localhost:8788
• Git 模拟接口：/git/repo/<repo>/...
• Jenkins 模拟接口：/jenkins/...
• Sonar 模拟接口：/sonar/...
• Nexus 模拟接口：/nexus/...
• GitLab 模拟接口：/gitlab/...

AI（可选）

• 在配置页面维护 work/config.yaml（兼容 OpenAI 风格参数：api_base、model、api_key_env）
• 设置环境变量：export OPENAI_API_KEY="***"（或使用你在 api_key_env 里指定的变量名）
• 仪表盘中的 AI 解读内容会以 Markdown 形式展示分析结果

目录说明

• skills/：技能源码与提示词模板
• .trae/skills/：Trae 识别技能时使用的入口文件
• dashboard/：前端仪表盘工程
• backend/：后端接口与聚合逻辑
• mock_services/：本地模拟服务
• work/：运行时配置、项目数据与历史记录
• infra/：可选的本地基础设施编排文件

基础设施（可选）

cd infra
docker compose up -d

快速上手

bash scripts/start-all.sh

启动完成后访问：http://localhost:5174

Windows 环境可执行：

scripts\start-all.bat

启动完成后访问：http://localhost:5174

更多文档：

• docs/getting-started.md
• docs/installation.md
• docs/commands.md