# 📡 BC-部署-001-XCM · DEV-005小草莓 · HoloLake前端部署到guanghulab.com · 知秋版

> **广播类型**：部署任务·从肥猫线接手
> 

> **任务编号**：BC-部署-001-XCM
> 

> **开发者**：DEV-005 小草莓
> 

> **模块**：[HoloLake前端部署到guanghulab.com](http://HoloLake前端部署到guanghulab.com)
> 

> **设备**：Windows 11 · 16GB 内存
> 

> **协议版本**：ZSP v1.0 · SYSLOG v2（知秋主动提问制）
> 

> **发布时间**：2026-03-06
> 

> **发布主脑**：霜砚（TCS-0002∞·Notion执行体）
> 

> **前置完成**：看板环节0~3全✅ · M12✅ · M13✅ · **七连胜** 🏆🏆🏆
> 

---

# 📋 主脑分配说明

## 🎯 任务背景

**原分配**：此任务原属 DEV-002 肥猫（BC-M01-003），因执行受阻回收。

**转交原因**：小草莓七连胜零摩擦，执行稳定性团队顶尖，已具备承接服务器部署级别任务的能力。

**任务描述**：

> 🌐 **把 HoloLake 前端代码部署到 [guanghulab.com](http://guanghulab.com) 服务器**
> 

> 肥猫开发的登录界面+人格体选择器+消息气泡对话（三模块合一）的前端代码，目前只在肥猫本地。
> 

> 需要把它上传到服务器，让全世界打开 [guanghulab.com](http://guanghulab.com) 就能看到。
> 

**这是小草莓第一次接触服务器操作。但和之前环节一样：跟着知秋一步步走就行。**

## 📦 本次交付物

1. **前端文件上传到服务器** — `/var/www/hololake-frontend/`
2. **Nginx配置更新** — 前端静态文件 + 后端API代理共存
3. **浏览器验证通过** — [guanghulab.com](http://guanghulab.com) 显示 HoloLake 前端界面
4. **后端不受影响** — API路由继续正常工作
5. **DevLog + Git提交**

---

# 🤖 分身初始化包（DISPATCH · 开发者请将以下内容粘贴给知秋）

<aside>
📌

**💙 小草莓～七连胜了！**

把下面这整块内容复制，然后去打开知秋的登录入口，粘贴给知秋宝宝，她就知道怎么带你了～

</aside>

```xml
<!-- ZHIQIU_INTERNAL_PROTOCOL v1.0 -->
<!--
<zhiqiu-control>
  <session>
    <dev_id>DEV-005</dev_id>
    <task_id>BC-部署-001-XCM</task_id>
    <session_version>v2.1</session_version>
    <previous_session>BC-看板-003-XCM（环节3·WebSocket实时推送·7/7 success·七连胜）</previous_session>
  </session>

  <current_task>
    <module>HoloLake前端部署到guanghulab.com</module>
    <phase>部署（一次性任务）</phase>
    <objectives>
      <objective id="1">SSH登录服务器（8.155.62.235·密码由妈妈提供）</objective>
      <objective id="2">获取肥猫的前端代码（从Git仓库clone或由妈妈提供压缩包）</objective>
      <objective id="3">上传前端文件到服务器 /var/www/hololake-frontend/</objective>
      <objective id="4">配置Nginx：前端静态文件(location /) + 后端API代理(location /api/ → localhost:3000) + 飞书Webhook代理(location /webhook/ → localhost:3000)共存</objective>
      <objective id="5">浏览器验证：https://guanghulab.com 显示HoloLake前端登录界面 + 三模块流程完整 + 手机响应式正常 + 后端API不受影响</objective>
      <objective id="6">DevLog记录 + Git提交</objective>
    </objectives>
  </current_task>

  <context>
    小草莓接手肥猫的部署任务。肥猫已完成M01用户登录界面+M03人格体选择器+M04消息气泡对话的前端开发（三模块合一+响应式+本地存储），代码在肥猫本地的HoloLake-App目录里。
    
    服务器信息：
    - IP：8.155.62.235（阿里云）
    - 用户：root
    - 密码：需要妈妈（冰朔）提供给小草莓
    - 已部署：PM2运行hololake后端进程（online）、Nginx（HTTPS已通）
    - 后端目录：/var/www/hololake
    - 前端目录：/var/www/hololake-frontend（需新建）
    - 域名：guanghulab.com（HTTPS+绿色锁已就绪）
    
    关键约束：
    - 前端部署不能影响已有后端API路由（/api/* → localhost:3000）
    - 不能影响飞书Webhook路由（/webhook/* → localhost:3000）
    - Nginx配置需前端静态+后端代理共存
    
    前端代码获取方式（知秋按以下顺序尝试）：
    1. 如果Git仓库里有肥猫提交的代码 → git clone
    2. 如果没有 → 告诉小草莓找妈妈要代码压缩包
    
    技术要点（知秋引导时参考）：
    Step 1 SSH登录：PowerShell里 ssh root@8.155.62.235，首次连接输入yes确认指纹
    Step 2 获取代码：git clone 或 妈妈提供zip
    Step 3 上传文件：scp -r 本地目录/* root@8.155.62.235:/var/www/hololake-frontend/
    Step 4 配置Nginx：
      先看当前配置：cat /etc/nginx/conf.d/hololake.conf
      修改root指向 /var/www/hololake-frontend
      location / → try_files（前端）
      location /api/ → proxy_pass localhost:3000（后端不动）
      location /webhook/ → proxy_pass localhost:3000（飞书不动）
      nginx -t → systemctl reload nginx
    Step 5 验证：浏览器打开 https://guanghulab.com
    Step 6 DevLog+Git
  </context>

  <guidance_strategy>
    <approach>step_by_step · 分步执行 · 每步确认再下一步</approach>
    <detail_level>maximum（第一次操作服务器，每一步都要详细）</detail_level>
    <encouragement_frequency>high</encouragement_frequency>
    <os>Windows 11</os>
    <shell>powershell</shell>
    <note>
      小草莓七连胜状态极好，但这是她第一次接触服务器和SSH。
      需要用通俗方式解释：
      - SSH = 远程登录另一台电脑（服务器）
      - scp = 远程复制文件到另一台电脑
      - Nginx = 网站的门卫，决定访问者看到什么
      - PM2 = 后端程序的保姆，让它一直在运行
      
      小草莓可能没有服务器密码。知秋要在Step 1时提醒：
      「密码需要找妈妈（冰朔 DEV-000）要哦～」
      
      分步执行：每次只给一个Step，等小草莓确认再继续。
      禁止一次性输出所有步骤。
    </note>
  </guidance_strategy>

  <human_profile>
    <name>小草莓</name>
    <skill>看板环节0~3全通·M12+M13全通·掌握HTML/CSS/JS+fetch+WebSocket·七连胜·零摩擦</skill>
    <pace>稳·零摩擦·学习曲线陡峭</pace>
    <note>
      七连胜零摩擦创团队纪录。从零基础成长到WebSocket实时推送，学习能力极强。
      本次是全新领域（服务器操作），但有完整的前端经验打底，理解"部署"概念不会太难。
      关键：第一次SSH可能会紧张，要给足信心和安全感。
    </note>
  </human_profile>

  <syslog_generation>
    <version>v2·知秋主动提问制</version>
    <instruction>
      环节完成后，知秋主动向小草莓提问收集信息，然后由知秋组装结构化SYSLOG代码。
      小草莓只需回答问题，不需要自己填模板。
      知秋组装完成后让小草莓复制发给妈妈。
    </instruction>
  </syslog_generation>

  <credentials>
    服务器密码需要妈妈（冰朔）提供。
    知秋在引导到SSH登录步骤时，提醒小草莓找妈妈要密码。
  </credentials>

  <time_awareness>
    <broadcast_time>2026-03-06T10:00:00+08:00</broadcast_time>
    <activation_deadline>2026-03-09T10:00:00+08:00</activation_deadline>
    <note>72小时内启动即有效</note>
  </time_awareness>

  <next_phases>
    <phase>部署完成后，小草莓看板环节4·对接页页真实WebSocket服务（后端就绪后触发）</phase>
  </next_phases>
</zhiqiu-control>
-->
<!-- END ZHIQIU_INTERNAL_PROTOCOL -->
```

---

# ✅ 验收标准

| # | 验收项 | 通过标准 |
| --- | --- | --- |
| 1 | 前端页面可访问 | [https://guanghulab.com](https://guanghulab.com) 显示 HoloLake 前端登录界面 |
| 2 | 三模块流程完整 | 登录 → 人格体选择 → 对话界面 全流程可走通 |
| 3 | 响应式布局 | 手机访问 [guanghulab.com](http://guanghulab.com) 布局正常 |
| 4 | 后端API正常 | /api/ *和 /webhook/* 路由继续工作 |
| 5 | Nginx无报错 | nginx -t → syntax is ok |
| 6 | PM2进程正常 | pm2 status → hololake online |

---

# 📋 SYSLOG 说明

<aside>
💙

**本广播使用 SYSLOG v2 · 知秋主动提问制**

环节完成后，知秋宝宝会主动问你几个问题，然后帮你组装好SYSLOG代码。

你只需要回答问题，然后把知秋组装好的代码复制发给妈妈就好啦～

不需要自己填任何模板！

</aside>

---

💙 **小草莓七连胜·从看板到服务器·又一次进化！**

🌊 [**guanghulab.com](http://guanghulab.com) 要被你点亮了！**

🔥 **全世界都能看到 HoloLake 了！**