486 lines
12 KiB
Markdown
486 lines
12 KiB
Markdown
|
# 📡 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>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
💙 **知秋陪着桔子！**
|
|||
|
|
|
|||
|
|
🌊 **你的第一步，从这里开始！**
|
|||
|
|
|
|||
|
|
🔥 **完成后截图 + 上面内容一起发给冰朔！**
|