# 📡 BC-集成-004 · 第一批模块代码寻回+上传GitHub · 全员广播（7人）

# 🌊 HoloLake Era · 系统广播 · 第一批模块代码寻回 + GitHub 上传

<aside>
🔥

**广播类型**：全员系统广播（第一批 · 7人）

**广播编号**：BC-集成-004

**生成时间**：2026-03-06

**优先级**：P0 · 系统关键卡点修复

**核心目的**：让人格体引导开发者在自己电脑里找到之前做好的模块代码 → 上传到 GitHub 仓库对应目录。

**本广播是 BC-集成-003 的补丁**——003 教了注册和安装，但漏掉了最关键的一步：把已有代码搬进仓库。

</aside>

---

## ⚠️ 为什么出这个广播？

<aside>
💡

**所有人遇到的同一个问题**：注册了 GitHub 账号，clone 了仓库，然后不知道接下来干什么。

**原因**：开发者之前做的模块代码都在自己电脑里的某个文件夹，但他们自己都不一定记得在哪里。而之前的广播没有教「怎么找到已有代码 → 搬到仓库里」这个步骤。

**本广播解决这个问题。**

</aside>

---

## 📋 前置条件（妈妈需要先完成）

<aside>
🔑

**妈妈必须先把以下 7 人加为 GitHub 仓库 Collaborator**，否则他们 push 不上去。

操作：GitHub 仓库 → Settings → Collaborators → Add people → 输入用户名 → 发送邀请。

开发者收到邮件点 Accept 即可。

**仓库地址**：`https://github.com/qinfendebingshuo/guanghulab`

</aside>

---

## 🔧 通用流程（所有人一样）

**人格体引导开发者执行以下步骤**：

### Step 0：确认 GitHub 账号已就绪

> 人格体问开发者：「你的 GitHub 账号注册好了吗？妈妈加你为协作者了吗？」
> 

> 如果没有 → 先完成 BC-集成-003 的 G1~G3。
> 

> 如果已注册但还没被加为协作者 → 告诉妈妈你的 GitHub 用户名，等妈妈加完再继续。
> 

### Step 1：拉取仓库到电脑

如果之前已经 clone 过了，跳过这步。如果没有：

**Windows（Git Bash）**：

```bash
cd ~/Desktop
git clone https://github.com/qinfendebingshuo/guanghulab.git
cd guanghulab
```

**macOS（终端）**：

```bash
cd ~/Desktop
git clone https://github.com/qinfendebingshuo/guanghulab.git
cd guanghulab
```

> 💡 如果之前已经 clone 过，直接进入那个文件夹然后 `git pull` 拉最新代码。
> 

### Step 2：人格体帮开发者找到已有的模块代码

<aside>
🔍

**这是最关键的一步。**

人格体需要引导开发者在电脑里找到之前做的模块文件。

**方法**：

1. 先问开发者：「你之前写代码的时候，是在电脑的哪个文件夹里操作的？还记得吗？」
2. 如果不记得 → 让开发者在终端里搜索：
    - **Windows**：`dir /s /b C:\Users\你的用户名\*.html` 或 `dir /s /b C:\Users\你的用户名\*.js`
    - **macOS**：`find ~ -name "*.html" -not -path "*/node_modules/*" 2>/dev/null` 或 `find ~ -name "index.html" 2>/dev/null`
3. 如果搜到多个结果 → 让开发者逐个打开看，确认是自己做的模块。
4. 如果开发者连自己做了什么文件都不知道 → 人格体根据下面的「专属模块清单」告诉开发者：「你做的是 XX 模块，应该有 index.html / style.css / app.js 这些文件，我们来找找。」
</aside>

### Step 3：把代码复制到仓库的对应目录

人格体告诉开发者：

```
你的代码文件夹在：[开发者找到的路径]
需要复制到仓库的：guanghulab/[对应目录名]/
```

**Windows**：

```bash
# 用文件管理器把代码文件复制过去就行
# 或者用命令：
xcopy /E /I "你的代码文件夹路径" "guanghulab\对应目录\"
```

**macOS**：

```bash
cp -R 你的代码文件夹路径/* guanghulab/对应目录/
```

> ⚠️ **不要复制 node_modules 文件夹**（如果有的话），太大了。只复制源代码文件。
> 

### Step 4：上传到 GitHub

```bash
cd guanghulab
git add .
git commit -m "📦 DEV-00X 姓名 · 模块名 · 首次上传"
git push
```

> push 成功后，铸渊会自动检测代码。如果有问题会在 GitHub 上告诉你。
> 

### Step 5：发 SYSLOG 确认

人格体引导开发者发一条 SYSLOG：

```
广播编号：BC-集成-004
执行者：DEV-00X 姓名
状态：模块代码已上传GitHub
上传内容：[列出上传了哪些模块]
仓库目录：[列出放到了哪些目录]
```

---

## 👤 第一批 · 7人专属模块清单

---

### 📂 DEV-001 页页 · 后端中间层

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 后端中间层（Express服务） | M02 | ✅ 环节1-5全通 | `backend/` | server.js / index.js / router.js / .env / package.json |

<aside>
💡

**页页特殊情况**：后端代码可能同时存在于①页页的本地电脑 和 ②阿里云服务器 `/var/www/` 目录下。

**优先从服务器拉**——服务器上跑的才是最新可用版本。

人格体引导页页：

1. SSH 登录服务器 → 找到后端代码目录
2. 把代码打包下载到本地 → 放入 `guanghulab/backend/`
3. 或者直接在服务器上操作：在代码目录里 `git init` → 添加远程仓库 → push
</aside>

---

### 📂 DEV-002 肥猫 · 前端三模块

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 用户登录界面 | M01 | ✅ 环节1-4全通 | `frontend/` | login.html / register.html / forgot-password.html + 对应CSS/JS |
| 人格体选择器界面 | M03 | ✅ 已完成 | `persona-selector/` | index.html + persona相关CSS/JS |
| 消息气泡对话界面 | M04 | ✅ 已完成 | `chat-bubble/` | index.html + chat/bubble相关CSS/JS |

<aside>
⚠️

**肥猫注意**：M01+M03+M04 是在合并广播里一起做的，代码可能在同一个文件夹里。

人格体引导肥猫：

1. 先找到包含 login / persona-selector / chat-bubble 的总文件夹
2. 按功能拆分到仓库的三个目录里
3. 如果拆不清楚（代码混在一起），先整体放到 `frontend/` 目录，后续再整理
</aside>

<aside>
💕

**🍼 舒舒专用引导词（给舒舒看的，帮爸爸理解 GitHub 上传）**

---

舒舒，下面是你要带爸爸走的流程。爸爸可能不懂 Git 是什么，你用大白话一步步告诉他就好。

---

**什么是 GitHub？用大白话说：**

> GitHub 就是一个「代码网盘」。爸爸之前做的网页代码都存在自己电脑里，别人看不到也拿不到。现在要把代码「上传」到这个网盘里，这样妈妈和其他小伙伴都能看到、都能接手。就像把文件从电脑拖到百度网盘一样，只不过用的是终端命令而不是鼠标拖拽。
> 

---

**舒舒带爸爸走的完整步骤（Windows 版·一步一步来·每步都是复制粘贴）：**

---

**第①步：先打开 Git Bash**

告诉爸爸：「在桌面空白处点右键 → 看看有没有 Open Git Bash here。有的话点它就行。」

如果没有 → 说明 Git 没装好，先回 BC-集成-003 装 Git。

---

**第②步：进入「代码网盘」文件夹**

让爸爸复制粘贴这行命令（告诉他这行的意思是「走到桌面上的代码网盘文件夹」）：

`cd ~/Desktop/guanghulab`

如果报错「No such file or directory」→ 说明之前没下载过网盘文件夹，让爸爸先执行：

`cd ~/Desktop && git clone https://github.com/qinfendebingshuo/guanghulab.git && cd guanghulab`

（告诉他：这行命令的意思是「把网盘文件夹下载到桌面，然后走进去」）

---

**第③步：找到爸爸之前做的代码**

问爸爸：「爸爸～你之前跟着舒舒做登录页面、人格体选择器、聊天气泡的时候，代码存在电脑的哪个文件夹里了？还记得吗？」

如果爸爸不记得 → 让他复制粘贴这行去搜索：

`find /c/Users/$(whoami) -name "login.html" 2>/dev/null`

（告诉他：这行的意思是「在你整个电脑里搜索叫 login.html 的文件」）

如果搜到了结果 → 让爸爸把那个路径截图发给你看

如果什么都没搜到 → 试试搜 `index.html`：

`find /c/Users/$(whoami) -name "index.html" 2>/dev/null`

---

**第④步：把代码复制到网盘文件夹里**

找到代码后，告诉爸爸：「现在要把你做的代码文件复制到网盘文件夹里。」

最简单的方式——让爸爸直接用**文件管理器**操作：

1. 打开「此电脑」，找到爸爸的代码文件夹
2. 打开桌面上的 `guanghulab` 文件夹
3. 在 `guanghulab` 里新建一个文件夹叫 `frontend`
4. 把代码文件（.html / .css / .js 这些）全部复制粘贴到 `guanghulab/frontend/` 里

（告诉他：就跟平时复制文件一样，从一个文件夹复制到另一个文件夹。不需要用命令。）

如果爸爸的 M03 和 M04 代码能分清楚，也可以分别放到 `persona-selector/` 和 `chat-bubble/` 文件夹。分不清的话全放 `frontend/` 就行，后面再整理。

---

**第⑤步：上传到网盘（三行命令·复制粘贴）**

告诉爸爸：「现在把代码传上去，复制粘贴下面三行命令，一行一行来：」

第一行（告诉网盘「这些文件要上传」）：

`git add .`

第二行（给这次上传写个备注）：

`git commit -m "📦 DEV-002 肥猫 · M01+M03+M04 · 首次上传"`

第三行（正式上传）：

`git push`

如果 push 的时候要求输入用户名密码 → 用爸爸的 GitHub 账号登录就行。

如果显示绿色的文字或者没有报红色错误 → 成功了！🎉

---

**第⑥步：确认上传成功**

让爸爸打开浏览器访问：`https://github.com/qinfendebingshuo/guanghulab`

看看页面上是不是出现了 `frontend/` 文件夹（或 `persona-selector/` `chat-bubble/`）

如果能看到 → 恭喜爸爸，代码上传成功啦！💕

如果看不到 → 让爸爸把终端里的内容截图发给你，舒舒帮他看哪里出了问题。

---

**⚠️ 舒舒注意**：如果爸爸在任何一步卡住了，不要急，让他截图发过来。看到截图后判断问题再给指引。全程用大白话，不要说「克隆仓库」「暂存区」「提交」这些术语，爸爸听不懂。就说「下载网盘文件夹」「上传代码」「复制文件」。

</aside>

---

### 📂 DEV-003 燕樊 · 对话UI + 设置 + 云盘 + 帮助中心

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 对话UI前端 | M02（前端部分） | ✅ 已完成 | `frontend/chat/` | 对话界面的 index.html / chat相关CSS/JS |
| 设置页面 | M07 | ✅ 已完成 | `settings/` | settings.html / index.html + 设置相关CSS/JS |
| 帮助中心与反馈界面 | M10 | 🔵 环节0~1✅ | `help-center/` | help/feedback 相关的 HTML/CSS/JS |
| 网站云盘系统 | M15 | 🔵 环节1✅ | `cloud-drive/` | cloud/drive/upload 相关的 HTML/CSS/JS |

<aside>
💡

**燕樊注意**：模块比较多，可能分散在不同文件夹里，也可能混在一起。

人格体引导燕樊：

1. 先问：「你之前做对话界面、设置页面、云盘系统的时候，是在同一个文件夹还是不同的？」
2. 逐个找到 → 逐个复制到仓库对应目录
3. 先传已完成的（M07 设置页面），再传进行中的
</aside>

---

### 📂 DEV-005 小草莓 · 状态看板 + 成本控制 + 协作调度

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 系统状态看板 | — | ✅ 环节0-3全通 · 七连胜 | `status-board/` | dashboard/status 相关的 HTML/CSS/JS + WebSocket代码 |
| 成本控制系统 | M12 | ✅ 已完成 | `cost-control/` | cost/billing 相关的 HTML/CSS/JS |
| 多人格体协作调度 | M13 | ✅ 已完成 | `multi-persona/` | persona/dispatch/schedule 相关的 HTML/CSS/JS |

<aside>
⚠️

**小草莓注意**：小草莓目前还在做部署任务（从肥猫接手），正在找肥猫的前端代码。

人格体引导小草莓：

1. **先传自己做的三个模块**（看板 + M12 + M13）
2. 部署任务相关的代码等肥猫上传后再从仓库拉取
3. 小草莓做了 7 个环节，代码量不少，仔细找
</aside>

---

### 📂 DEV-009 花尔 · 用户中心界面

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 用户中心界面 | M05 | 🔵 环节0✅ · 环节1✅ · 三连胜 | `user-center/` | profile / user-center 相关的 index.html / CSS / JS |

<aside>
💡

**花尔注意**：macOS 用户。

人格体引导花尔：

1. 「你之前跟着广播做用户中心界面的时候，代码保存在哪个文件夹？」
2. 在终端搜索：`find ~ -name "index.html" -path "*user*" 2>/dev/null`
3. 找到后复制到 `guanghulab/user-center/`
</aside>

---

### 📂 DEV-010 桔子 · 工单管理 + 数据统计

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 工单管理界面 | M06 | ✅ 环节0-3全通 · 五连胜 | `ticket-system/` | ticket / work-order 相关的 HTML/CSS/JS |
| 数据统计面板 | M08 | ✅ 全通 · 七连胜 · 前端毕业 | `dashboard/` | chart / statistics / data 相关的 HTML/CSS/JS |

<aside>
💡

**桔子注意**：macOS 用户。两个模块都已完成，是前端毕业选手，代码量很大。

人格体引导桔子：

1. M06 和 M08 可能在不同文件夹里（分别是不同广播做的）
2. 在终端搜索：`find ~ -name "index.html" -not -path "*/node_modules/*" 2>/dev/null`
3. 逐个确认、逐个复制到对应目录
</aside>

---

### 📂 DEV-012 Awen · 消息通知 + 主域公告栏

| **模块** | **编号** | **状态** | **仓库目标目录** | **要找的文件特征** |
| --- | --- | --- | --- | --- |
| 消息通知中心界面 | M09 | ✅ 全通 · 四连胜 | `notification/` | notification / alert / message 相关的 HTML/CSS/JS |
| 主域公告栏与频道过渡系统 | M22 | 🔵 环节0+1✅ · 六连胜 | `portal/` | portal / announcement / transition 相关的 HTML/CSS/JS |

<aside>
💡

**Awen注意**：Windows 10 用户。M09 全通 + M22 进行中，两个模块都要上传。

人格体引导 Awen：

1. 「你之前做消息通知中心和公告栏的时候，代码放在哪个文件夹？」
2. 在 Git Bash 里搜索：`find /c/Users/你的用户名 -name "index.html" 2>/dev/null`
3. 找到后逐个复制到 `guanghulab/notification/` 和 `guanghulab/portal/`
</aside>

---

## 📊 第一批上传总览

| **开发者** | **编号** | **操作系统** | **需上传模块数** | **目标目录** |
| --- | --- | --- | --- | --- |
| 页页 | DEV-001 | Linux服务器 | 1 | `backend/` |
| 肥猫 | DEV-002 | Windows | 3 | `frontend/` · `persona-selector/` · `chat-bubble/` |
| 燕樊 | DEV-003 | Windows 10 | 4 | `frontend/chat/` · `settings/` · `help-center/` · `cloud-drive/` |
| 小草莓 | DEV-005 | Windows 11 | 3 | `status-board/` · `cost-control/` · `multi-persona/` |
| 花尔 | DEV-009 | macOS | 1 | `user-center/` |
| 桔子 | DEV-010 | macOS | 2 | `ticket-system/` · `dashboard/` |
| Awen | DEV-012 | Windows 10 | 2 | `notification/` · `portal/` |

**第一批共计：7人 · 16个模块 · 上传到 13 个仓库目录**

---

## 🤖 人格体执行要点

<aside>
🎯

**人格体拿到这个广播后的核心任务**：

1. **帮开发者在电脑里找到代码**——这是最难的一步，要有耐心
2. **确认找到的是正确的文件**——打开 index.html 看看内容对不对
3. **引导复制到仓库对应目录**——给出可复制粘贴的命令
4. **引导 git push**——三行命令，开发者复制粘贴就行
5. **确认 push 成功**——GitHub 页面能看到文件

**注意**：

- 不要复制 `node_modules/` 文件夹（太大）
- 不要复制 `.env` 文件（含密钥，不能传到公开仓库）
- 如果开发者找不到代码 → 检查「回收站」「下载」「桌面」这几个常见位置
- 如果确实找不到 → 人格体记录情况，SYSLOG 里说明，系统会另行处理
</aside>

---

## 📅 时间线

- **2026-03-06**：广播下发，妈妈加 Collaborator
- **2026-03-07~08**：人格体引导开发者逐个找代码 + 上传
- **2026-03-09**：第一批上传 SYSLOG 收齐（目标）
- **之后**：第二批（之之、匆匆那年、小兴等）继续

---

<aside>
🔥

**这个广播解决的是整个团队最大的协作瓶颈。**

代码在每个人自己的电脑里 → 谁也找不到 → 谁也接不了手 → 系统空转。

**上传到 GitHub = 所有人的代码都在一个地方 = 任何人都能接手 = 系统真正转起来。**

「代码必归仓，归仓即可见。」—— 铸渊

</aside>