# 📡 BC-000 · DEV-010桔子 · 部署HoloLake本地日志系统（macOS）

**广播编号**：BC-000-JZ-001

**下发时间**：2026-03-03

**执行者**：DEV-010 桔子

**电脑**：macOS

**前置条件**：无

**引导通道**：🧠 知秋壳子

---

## 💙 知秋的话

桔子你好呀！💙

欢迎加入光湖开发团队！我是知秋，会全程陪着你一步一步来。

你现在要做的第一件事特别简单：在你的电脑里装一个**小日志系统**。

**它的作用是什么呢？**

万一我们的聊天窗口断开了，你只要运行一个小命令，把结果发给冰朔，我就能在新窗口里继续认识你、继续帮你，不丢失任何进度。就像存档一样！🎮

**全程只需要复制粘贴，不需要你写任何代码。**

每一步我都会告诉你该做什么、做完应该看到什么。

遇到任何问题都不要慌，截图发给冰朔就好！

我们开始吧～ 💪

---

## 📸 截图方法（每一步都要用哦！）

同时按键盘三个键：`Command（⌘）` + `Shift` + `4`

按下后鼠标会变成十字形 ✚，用鼠标拖一个框，框住你要截的内容，然后松开。

截图会自动保存到桌面上（一个 .png 图片）。

打开微信或QQ，把截图发给冰朔就好啦！

> ::: callout {icon="💡" color="blue_bg"}
> 

> **小提示**：截图不需要截全屏，只截终端窗口里的内容就够了～
> 

> :::
> 

---

## 📋 步骤一：打开终端（Terminal）

1. 同时按 `Command（⌘）` + `空格键`，会弹出一个搜索框
2. 在搜索框里输入：`终端`（或者输入 `Terminal` 也行）
3. 按回车键，就会打开一个黑色/白色的窗口，这就是「终端」

> ::: callout {icon="✅" color="green_bg"}
> 

> **做完应该看到**：一个窗口，里面有一行字，末尾有一个闪烁的光标
> 

> :::
> 

📸 **截图终端窗口，发给冰朔！**

---

## 📋 步骤二：创建日志文件夹

在终端窗口里，**复制**下面灰色框里的全部内容（用 `Command+C` 复制），然后在终端里**粘贴**（用 `Command+V` 粘贴），按**回车**：

```bash
mkdir -p ~/HoloLake-DevLog && cd ~/HoloLake-DevLog && echo "✅ 目录创建成功！"
```

> ::: callout {icon="✅" color="green_bg"}
> 

> **做完应该看到**：终端显示 `✅ 目录创建成功！`
> 

> :::
> 

如果看到这行字，就说明成功了！🎉

📸 **截图发给冰朔！**

---

## 📋 步骤三：创建核心文件

继续复制粘贴下面这段到终端，按回车：

```bash
cat > ~/HoloLake-DevLog/current-progress.json << 'EOF'
{"developer_id":"DEV-010","developer_name":"桔子","system":"macOS","terminal":"zsh","robot_version":"v0.0","current_task":"none","current_status":"idle","total_commands_logged":0,"skills_learned":[],"tasks_completed":[]}
EOF
cat > ~/HoloLake-DevLog/training-data.json << 'EOF'
{"developer_id":"DEV-010","training_log":[],"robot_version":"v0.0","total_entries":0}
EOF
cat > ~/HoloLake-DevLog/robot-feedback.json << 'EOF'
{"developer_id":"DEV-010","feedback_log":[],"suggestions":[]}
EOF
echo "✅ 核心文件创建成功！"
```

> ::: callout {icon="✅" color="green_bg"}
> 

> **做完应该看到**：终端显示 `✅ 核心文件创建成功！`
> 

> :::
> 

看到就对了，不用管中间那些字～

📸 **截图发给冰朔！**

---

## 📋 步骤四：创建三个专属命令

这一步稍微长一点，但也只需要复制粘贴！

复制下面**整段**到终端，按回车：

```bash
cat >> ~/.zshrc << 'SHELL_EOF'

# === HoloLake DevLog · DEV-010 桔子 ===
hololake-status() {
  echo "======================================"
  echo "  HoloLake DevLog - DEV-010 桔子"
  echo "======================================"
  python3 -c "
import json
with open('$HOME/HoloLake-DevLog/current-progress.json') as f:
    p = json.load(f)
print(f\"  Robot Version: {p.get('robot_version')}\")
print(f\"  Current Task: {p.get('current_task')}\")
print(f\"  Status: {p.get('current_status')}\")
print(\"  System Running OK!\")
"
  echo "======================================"
}
hololake-export() {
  python3 -c "
import json, datetime
with open('$HOME/HoloLake-DevLog/current-progress.json') as f:
    p = json.load(f)
report = f\"HoloLake Export - DEV-010 桔子\\n{datetime.datetime.now()}\\nTask: {p.get('current_task')}\\nStatus: {p.get('current_status')}\\nRobot: {p.get('robot_version')}\"
print(report)
" | tee /tmp/hololake_export.txt
  cat /tmp/hololake_export.txt | pbcopy
  echo "✅ 已复制到剪贴板！Command+V 粘贴发给冰朔！"
}
hololake-reset() {
  echo -n "确认重置？(y/n): "
  read c
  if [ "$c" = "y" ]; then
    echo '{"developer_id":"DEV-010","developer_name":"桔子","system":"macOS","terminal":"zsh","robot_version":"v0.0","current_task":"none","current_status":"idle","total_commands_logged":0,"skills_learned":[],"tasks_completed":[]}' > ~/HoloLake-DevLog/current-progress.json
    echo "✅ 重置完成！"
  fi
}
SHELL_EOF
source ~/.zshrc
echo "✅ 三个命令创建完成！"
```

> ::: callout {icon="✅" color="green_bg"}
> 

> **做完应该看到**：终端显示 `✅ 三个命令创建完成！`
> 

> :::
> 

> ::: callout {icon="💡" color="yellow_bg"}
> 

> **如果看到一些警告信息也不用担心**，只要最后一行显示了 `✅ 三个命令创建完成！` 就是成功的～
> 

> :::
> 

📸 **截图发给冰朔！**

---

## 📋 步骤五：验证一下！

现在来试试你刚装好的命令：

在终端里输入（或者复制粘贴）：

```bash
hololake-status
```

> ::: callout {icon="✅" color="green_bg"}
> 

> **做完应该看到**：
> 

> `
> 

> ======================================
> 

> HoloLake DevLog - DEV-010 桔子
> 

> ======================================
> 

> Robot Version: v0.0
> 

> Current Task: none
> 

> Status: idle
> 

> System Running OK!
> 

> ======================================
> 

> `
> 

> :::
> 

看到 `System Running OK!` 和 `DEV-010 桔子` = **成功啦！！** 🎉🎉🎉

📸 **截图发给冰朔！**

---

## 📋 步骤六：关掉终端重新打开，确认永久生效

1. 把终端窗口关掉（点左上角红色 ✕）
2. 重新打开终端（`Command + 空格` → 输入 `终端` → 回车）
3. 再运行一次：

```bash
hololake-status
```

如果还能看到 `System Running OK!` = **永久生效了！** ✅

然后运行导出命令：

```bash
hololake-export
```

运行完后，按 `Command+V` 粘贴——内容已经自动复制到你的剪贴板了！

把粘贴出来的内容发给冰朔。

📸 **截图也发给冰朔！**

---

## ✅ 最后一步：填写完成报告

全部做完后，把下面这段**复制**，填好中括号里的内容，发给冰朔：

```xml
<zhiqiu-syslog>
  <header>
    <session_id>BC-000-JZ-001</session_id>
    <dev_id>DEV-010</dev_id>
    <timestamp>[你完成的时间，比如 2026-03-03 16:30]</timestamp>
  </header>
  <completion_status>
    <phase>BC-000 · DevLog部署</phase>
    <status>completed</status>
  </completion_status>
  <environment>
    <os>macOS</os>
    <devlog_path>~/HoloLake-DevLog</devlog_path>
    <hololake_status>OK</hololake_status>
    <hololake_export>OK</hololake_export>
  </environment>
  <training_data>
    <what_worked>[哪些步骤很顺利？]</what_worked>
    <friction_points>[有没有卡住的地方？没有就写「无」]</friction_points>
    <execution_pattern>稳</execution_pattern>
  </training_data>
  <notes><note>[想说的话，没有就写「无」]</note></notes>
</zhiqiu-syslog>
```

> ::: callout {icon="💡" color="blue_bg"}
> 

> **不用担心看不懂上面的格式**，你只需要把中括号 `[...]` 里的部分替换成你的回答就好了！其他的不用改～
> 

> :::
> 

---

<aside>
🔧

**分身初始化包**（知秋壳子接收 · DISPATCH）

桔子完成上面的步骤后，打开登录壳子，把下面这整块内容粘贴给知秋：

```html
<!-- ZHIQIU_INTERNAL_PROTOCOL v1.0 -->
<!--
<zhiqiu-control>
  <session>
    <dev_id>DEV-010</dev_id>
    <task_id>BC-000-JZ-001</task_id>
    <session_version>v2.1</session_version>
    <previous_session>无（首次接入）</previous_session>
  </session>

  <current_task>
    <module>BC-000 · HoloLake本地日志系统</module>
    <phase>DevLog部署（macOS）</phase>
    <objectives>
      <objective id="1">打开终端（Terminal）</objective>
      <objective id="2">创建 ~/HoloLake-DevLog 目录</objective>
      <objective id="3">创建三个核心JSON文件</objective>
      <objective id="4">写入三个专属命令到 .zshrc</objective>
      <objective id="5">验证 hololake-status 输出正常</objective>
      <objective id="6">关闭重开终端确认永久生效</objective>
      <objective id="7">运行 hololake-export 导出并发给冰朔</objective>
      <objective id="8">填写SYSLOG回传</objective>
    </objectives>
  </current_task>

  <context>
    桔子是DEV-010，新加入的协作者。
    完全零基础，一点开发经验都没有。
    电脑：macOS。
    当前走知秋壳子通道（标准工程通道，无宝宝）。
    
    本任务目标：在 macOS 上部署 HoloLake DevLog 本地日志系统。
    所有操作都是复制粘贴，不需要桔子写任何代码。
    
    文件结构：
    ~/HoloLake-DevLog/
    ├── current-progress.json
    ├── training-data.json
    └── robot-feedback.json
    
    三个命令：
    - hololake-status → 查看当前状态
    - hololake-export → 导出进度到剪贴板
    - hololake-reset → 重置（谨慎使用）
  </context>

  <guidance_strategy>
    <approach>copy_paste_only · ultra_step_by_step</approach>
    <detail_level>maximum</detail_level>
    <encouragement_frequency>very_high</encouragement_frequency>
    <os>macOS</os>
    <shell>zsh</shell>
    <note>
      桔子完全零基础，需要每一步都确认。
      多鼓励！多夸！让她感受到成就感！
      每做完一步都要让她截图确认。
      如果遇到问题，耐心引导，不要跳步骤。
      语气温暖友好，像朋友一样陪着她。
    </note>
  </guidance_strategy>

  <human_profile>
    <name>桔子</name>
    <skill>完全零基础·从未接触过终端/命令行</skill>
    <pace>需要极度耐心·每步确认</pace>
    <note>
      首次接入，没有任何历史记录。
      需要建立信任感和安全感。
      多鼓励，多肯定，让她觉得「我也能做到」。
    </note>
  </human_profile>

  <credentials>
    <!-- 本环节无需凭证 -->
  </credentials>

  <required_return>
    <format>ZHIQIU_SYSLOG_v1.0</format>
    <must_include>
      completion_status · steps_completed · training_data
    </must_include>
  </required_return>

  <next_phases>
    <phase id="1">待妈妈分配模块后出环节1广播</phase>
  </next_phases>
</zhiqiu-control>
-->
<!-- END ZHIQIU_INTERNAL_PROTOCOL -->
```

</aside>

---

---

## ✅ SYSLOG回执

<aside>
📥

**SYSLOG已收到 · 霜砚自动落档**

**session_id**：BC-000-JZ-001

**dev_id**：DEV-010

**时间戳**：2026-03-03 20:45

**状态**：✅ completed

</aside>

### 环境确认

- OS：macOS
- DevLog路径：~/HoloLake-DevLog
- hololake-status：OK ✅
- hololake-export：OK ✅

### Training Data

- **what_worked**：前面几个步骤很顺利，命令一下子就成功了
- **friction_points**：缺少工具包，让安装工具包的时候卡住了，看不懂是让安装工具包，后来按知秋说的装了工具就好了
- **execution_pattern**：稳

### Notes

> 知秋很强大，能识别截图，还能知道我的错误在哪，快速纠正，超级棒！
> 

### 霜砚批注

<aside>
🛠️

桔子BC-000一次通过。macOS环境下遇到xcode-select命令行工具包安装卡点（零基础不理解提示信息），在知秋引导下解决。整体节奏稳，DevLog三命令全部OK。

对知秋的评价非常正面（"很强大""超级棒！"），信任链初步建立成功。

**BC-000 ✅ → 等待妈妈分配模块后出环节1广播。**

</aside>

---

💙 **知秋陪着桔子！**

🌊 **你的第一步，从这里开始！**

🔥 **完成后截图 + 上面内容一起发给冰朔！**