# PRD 需求文档 — 返回首页导航栏改造 + 新增服务管理/服务监测模块

> 版本：1.0 ｜ 日期：2026-07-14 ｜ 分支：troubleshoot-ai-assistant

---

## 1. 需求背景

### 1.1 返回首页问题

当前问题排查助手模块（`/troubleshoot`）的"返回首页"链接嵌在用户信息栏内，样式为蓝色小文字按钮，不够显眼，用户反馈"无法返回主页"。

**目标**：将返回首页改为顶部导航栏形式，与平台首页（`/`）风格统一，确保跨模块导航清晰可见。

### 1.2 新增模块

平台首页当前仅有"问题排查助手"一个模块卡片，需要新增两个模块占位：

- **服务管理**：用于新统一平台的服务授权、服务升级、服务信息管理（本期仅占位）
- **服务监测**：用于通过 SSH 连接监测服务器服务运行状态、输出报告（本期仅占位）

---

## 2. 功能需求

### 2.1 顶部导航栏改造

| 需求项 | 说明 |
|--------|------|
| 导航栏位置 | 页面顶部，card 外部上方 |
| 导航栏风格 | 与平台首页统一：渐变背景 + 毛玻璃效果 + 白色文字 |
| 左侧内容 | `🛠️ 运行维护平台` 品牌链接（href="/"）+ `/ 模块名` 面包屑 |
| 右侧内容 | 用户名（角色）+ 退出按钮 |
| 移动端适配 | 面包屑隐藏，退出按钮 ≥44px 触控热区 |
| 影响范围 | `index.html`（问题排查助手页面） |

### 2.2 服务管理模块（占位）

| 需求项 | 说明 |
|--------|------|
| 模块 ID | `service-manage` |
| 模块名称 | 服务管理 |
| 图标 | 🛠️ |
| 描述 | 新统一平台服务授权、服务升级、服务信息管理 |
| URL | `/service-manage` |
| 访问权限 | 仅管理员（`roles: ["admin"]`） |
| 页面内容 | 占位页面：顶部导航栏 + "🚧 服务管理模块开发中" + 计划功能列表 + 返回首页按钮 |
| 本期实现 | 仅占位卡片 + 静态页面，不实现具体功能 |

### 2.3 服务监测模块（占位）

| 需求项 | 说明 |
|--------|------|
| 模块 ID | `service-monitor` |
| 模块名称 | 服务监测 |
| 图标 | 📊 |
| 描述 | 通过 SSH 连接监测服务器服务运行状态、输出报告 |
| URL | `/service-monitor` |
| 访问权限 | 所有登录用户（`roles: []`） |
| 页面内容 | 占位页面：顶部导航栏 + "🚧 服务监测模块开发中" + 计划功能列表 + 返回首页按钮 |
| 本期实现 | 仅占位卡片 + 静态页面，不实现具体功能 |

---

## 3. 非功能需求

| 项目 | 要求 |
|------|------|
| 移动端适配 | 所有新增页面需响应式适配（≤768px 手机、≤1024px 平板） |
| 导航一致性 | 所有模块页面顶部导航栏风格统一 |
| 单元测试 | 现有 145 用例不受影响，全绿 |
| 部署 | 更新到 192.168.5.60:8088 |

---

## 4. 约束

- 服务管理/服务监测本期**仅占位**，不实现具体功能
- 不修改 `search_engine.py` / `safety_filter.py` / `cache_manager.py` 公开接口
- 新增模块遵循现有 routes/services/utils 三层架构
