231 lines
8.6 KiB
Markdown
231 lines
8.6 KiB
Markdown
|
# 📡 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 了！**
|