Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007

Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码

2026-07-17 15:59:55 +08:00

8.6 KiB

Raw Blame History

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

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

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

开发者：DEV-005 小草莓

模块：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 服务器

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

需要把它上传到服务器，让全世界打开 guanghulab.com 就能看到。

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

📦 本次交付物

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

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

<!-- 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 显示 HoloLake 前端登录界面
2	三模块流程完整	登录 → 人格体选择 → 对话界面全流程可走通
3	响应式布局	手机访问 guanghulab.com 布局正常
4	后端API正常	/api/ 和 /webhook/ 路由继续工作
5	Nginx无报错	nginx -t → syntax is ok
6	PM2进程正常	pm2 status → hololake online

📋 SYSLOG 说明

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

🌊 **guanghulab.com 要被你点亮了！**

🔥 全世界都能看到 HoloLake 了！