devops-platform-web/AGENTS.md

@RTK.md

DevOps 运维平台前端 Agent 入口

项目规则

• 使用当前 Vue 3 + Vite + TypeScript 结构，不引入无关框架。
• 页面内容、计划文档和交付说明优先使用中文。
• UI 风格保持安静、工具型、信息密度合理的运维后台，不做营销页。
• 只在 devops-platform-web/** 内修改前端文件，不修改 devops-platform-api/** 和 devops-platform-docs/**。
• 改动可运行入口、目录或重要文件时，同步更新 README.md。

技术约束

• UI 组件优先使用 Element Plus。
• 状态管理使用 Pinia。
• 路由使用 Vue Router。
• 请求封装使用 Axios，并集中在 src/services/**。
• 发布流程展示以后端 run.steps 为准，前端只展示步骤状态、节点详情和日志，不维护流程图 XML 渲染器。
• 不新增前端 mock 数据或接口失败降级；项目、发布、refs、流程和 Agent 调用统一走后端 API。

API 与安全边界

• 前端不得保存 Jenkins token、Gitea token、通知 webhook、LLM API key/baseURL/model。
• 前端不得直接调用 Jenkins、Gitea、企微、飞书或模型供应商；统一通过后端 API。
• API 契约以 /Users/mac033/Desktop/my-project/devops-platform-docs/devops-platform-implementation-tracker.md 和后端 OpenAPI 为准。

发布流程与 Agent 边界

• 发布步骤组件只展示后端步骤、节点状态和节点详情，不推进状态机。
• 后端返回的节点标识在前端统一映射为 step.nodeId，仅用于展示和定位步骤。
• Agent 只能作为全局右侧抽屉工具存在，不作为独立侧边栏路由；能力只允许 DevOps 场景：发布风险摘要、失败诊断、Runbook 问答、发布说明草稿和事故复盘草稿。
• 禁止在前端新增泛聊天入口。