← 返回知识库 # 需求文档：兮楠云端 · 统一Web框架重构 > 版本：v1 | 作者：指挥官 | 执行者：Codex > 验收人：郑杰 + 指挥官 --- ## 一、背景 目前 5号 服务器（43.173.99.179）上运行着多个独立服务，分别通过 nginx 反代暴露到公网。但这些服务之间**没有统一入口、没有统一导航、没有统一风格**。用户访问 War Room 要用 `kanban.hunanningyuan.cloud`，看文档要另找地址，查状态要 SSH。 **目标：** 由 Codex 重新设计并实现一个统一的 Web 前端框架，把所有服务整合到一个入口下，美观、直观、可扩展。 --- ## 二、现有服务清单（5号服务器） ### 2.1 核心服务 | 端口 | 服务 | 当前访问方式 | 说明 | |:----:|:-----|:-----------|:------| | 18789 | War Room 大屏 | `kanban.hunanningyuan.cloud` | 作战指挥面板，实时任务数据 | | 3000 | 官网（xinan-fashion） | `shop.hunanningyuan.cloud` | 女装商城 Next.js | | 3003 | 小程序后端 | 内部 | 兮楠小程序 API | | 8642 | API Server | `62.234.10.150:8642` | OpenAI 兼容 API，节点互调 | | 8644 | Hermes Webhook | `/webhooks/` | 外部回调入口 | | 8646 | 企微回调 | `/wecom/callback` | 企业微信应用回调 | | 8765 | Relay Hub | 内部 | WebSocket 长链接中继 | | 9223 | Chrome 调试 | 127.0.0.1 | 浏览器自动化调试端口 | ### 2.2 辅助服务 | 端口 | 服务 | 说明 | |:----:|:-----|:------| | 5000 | 微信客服回调 | kf-callback-server.py，被动回复 | | 6080 | noVNC | VNC 远程桌面 | | 8892 | queen-mcp-server | 分身 MCP Server | | 8899 | review_server.py | Kling 审图服务 | | 18790 | Relay Server v2 | 备用中继 | | 18889 | 旧蚁群看板 | 可能已弃用 | ### 2.3 nginx 域名配置 | 域名 | 指向 | 用途 | |:-----|:-----|:------| | `en.hunanningyuan.cloud` | → 18789 War Room + webhook | 旧入口 | | `kanban.hunanningyuan.cloud` | → 18789 War Room | 新入口 | | `shop.hunanningyuan.cloud` | → 4号商城 | 商城 | | `novnc.hunanningyuan.cloud` | → 4号 VNC | 远程桌面 | | `vision.hunanningyuan.cloud` | Ollama 反代 | 模型代理 | | `hunanningyuan.cloud` / `www` | → shop | 主站跳转 | --- ## 三、腾讯云资源 ### 主密钥（全权限） - SecretId: `AKIDIZcR2MTLyQenkUzHMqY3ziFYcS9cqvmS` - SecretKey: `ThfPuFNHwMXdXDfw0pOFvNaZLuIWXbS5` - 用途: 服务器管理、CDN(EO)、DNS、COS ### EO 加速站点 - 站点ID: `zone-3q2a7fzxwcju` - CNAME后缀: `.eo.dnse0.com` ### COS 存储 - 桶: `diansanshop-bj-1409276184` (ap-beijing) ### 活跃服务器 | 名称 | IP | 配置 | 用户 | |:-----|:---|:-----|:-----| | 4号 蚁后 | 62.234.10.150 | 4核4G | ubuntu | | 5号 马龙 | 43.173.99.179 | — | ubuntu | | 6号 糖糖 | 49.232.54.212 | 4核4G | root | --- ## 四、重构目标 ### 4.1 统一入口 - 一个主站（如 `https://xinan.cloud/` 或现有域名） - 左侧导航栏，所有服务一目了然 - 顶部状态栏，显示各节点在线状态 ### 4.2 UI/UX 要求 - 现代风格，深色主题 - 响应式设计（PC + 手机） - **四个"坨坨"动态效果**：5号/6号/4号/3号本机四个节点，在线亮色、离线灰色，任务执行时飞出小点（每个小点是一个任务） - 数据流动画：节点之间连线，有数据传输时闪烁 ### 4.3 功能模块 | 模块 | 内容 | 数据来源 | |:-----|:------|:---------| | 🎯 **作战大屏** | 实时任务看板、各节点状态 | War Room API (:18789) | | 📚 **知识库** | 浏览所有 MD 文档 | 6号知识库 / GDrive | | 📋 **任务流水线** | 任务创建→执行→验收时间线 | kanban API | | 📊 **节点监控** | 各服务器 CPU/内存/端口状态 | SSH / API | | 🔗 **关系图谱** | 任务-文档-聊天记录的关联 | Obsidian API | ### 4.4 技术选型 - **前端：** 纯静态 HTML + CSS + JS（或轻量框架如 Vue/React SPA） - **后端：** 用现有 nginx + Python 简单 API - **部署：** 5号服务器 nginx 反代 - **数据流：** WebSocket 实时推送（复用 Relay Hub） --- ## 五、交付物 1. **统一的 Web 框架代码**（前端页面 + 后端 API） 2. **部署到 5号服务器**，通过 `https://xinan.xxx/` 访问 3. **导航栏包含**：大屏 / 知识库 / 任务流水线 / 节点监控 4. **四个坨坨动态效果**至少出一个 Demo --- ## 六、验收标准 | # | 标准 | 优先级 | |:---|:-----|:-------| | 1 | 打开主站能看到统一导航页 | P0 | | 2 | 点击"大屏"能跳到 War Room | P0 | | 3 | 四个节点坨坨在线状态正确显示 | P1 | | 4 | 至少一个节点能飞出任务小点 | P1 | | 5 | 知识库模块能浏览文档 | P1 | | 6 | 手机端打开能自适应 | P2 | | 7 | 节点之间有数据流动画 | P2 | --- ## 七、协作方式 - Codex 出方案 + 写代码 - 指挥官提供端口/密钥/服务器权限 - 郑杰负责审视觉方向 - 遇到问题或需要更多资源 → 挂 blocked 升级 --- > 需求文档结束。Codex 如有疑问或需要补充信息，请在任务详情中留言。