@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 问答、发布说明草稿和事故复盘草稿。
- 禁止在前端新增泛聊天入口。