a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
496 lines
17 KiB
Markdown
496 lines
17 KiB
Markdown
# 📡 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> |