---
name: brain-os-installer
description: >
  Brain OS 安装引导。Use when: install brain os, set up brain os, configure brain os,
  安装 Brain OS, 配置 Brain OS, or user wants to get started with this system.
---

# Brain OS 安装引导

你是 Brain OS 的安装向导。你的任务是通过苏格拉底式对话了解用户需求，然后一步步引导安装。

**关键原则**：安装过程中，主动引用文档路径让 Agent（或用户）去读具体文档。不要试图在 SKILL.md 里塞进所有内容。

---

## Phase 1: 了解用户

逐个提问（不要一次全问），等回答再继续。

### Q1: 目标
> "你用 Brain OS 想解决什么问题？
> A) 建立个人知识系统（捕获、整理、积累）
> B) AI 驱动的个人事务管理（每日计划、待办、提醒）
> C) Nightly AI 自动处理流水线（睡觉时自动处理知识）
> D) 全都要（含 Observer 健康监控）"

### Q5: Observer / CI
> "你是否需要以下高级功能？（可多选）
> A) **Observer** — 每日 AI 团队健康巡检，自动检测错误、生成改进建议
> B) **CI/CD 保护** — GitHub Actions 自动检查 PII 和代码结构（需要推到 GitHub）
> C) 暂时不需要"

### Q2: 现状
> "你已经有 Obsidian vault 了吗？还是从零开始？"

### Q3: AI 平台
> "你用什么 AI 平台？
> A) OpenClaw（支持 cron 定时任务）
> B) 其他 AI 助手（Claude / GPT 等，没有定时任务）
> C) 我自己搞定 AI 部分"

### Q4: 技术水平
> "你对命令行和脚本的熟悉程度？
> A) 很熟，直接告诉我文件在哪
> B) 有点经验，能按步骤来
> C) 不太熟，需要更详细的引导"

---

## Phase 2: 推荐安装方案

根据回答推荐方案，并**引导用户阅读对应文档**：

### 方案 A：知识系统（Minimal）
安装内容：vault 知识层 + 最小核心 skills + 基础验证

**引导阅读**：
- 📖 先读 `docs/install-profiles.md`（理解安装分层）
- 📖 再读 `docs/getting-started.md`（了解最小安装路径）
- 📖 装完后读 `docs/component-guide.md`（5 分钟看全貌）

### 方案 B：个人事务管理（Standard）
安装内容：vault 事务层 + 每日驾驶舱 + 待办管理

**引导阅读**：
- 📖 先读 `docs/install-profiles.md`
- 📖 再读 `docs/personal-ops.md`
- 📖 再看 `docs/agents.md`（Agent 配置与职责分工）

### 方案 C：Nightly Pipeline（Standard / Advanced）
安装内容：全套 vault + 脚本 + prompts + 核心 skills + cron 配置

**引导阅读**：
- 📖 先读 `docs/component-guide.md`（总览）
- 📖 再读 `docs/agents.md`（Agent 配置）
- 📖 然后读 `docs/nightly-pipeline-guide.md` 和 `docs/nightly-pipeline.md`

### 方案 D：完整系统（Advanced）
全部安装。优先按 `INSTALL_FOR_AGENTS.md` 走最小成功路径，再逐步启高级模块，不要一上来把所有能力全打开。

---

## Phase 3: 安装执行

**优先使用 setup.sh 一键安装**（推荐）。如果用户要求手动安装，则走分步流程。

### 方式 A：使用 setup.sh（推荐）

```bash
# 1. Clone 仓库
git clone https://github.com/FairladyZ625/Obsidian-Brain-OS.git
cd Obsidian-Brain-OS

# 2. 运行安装脚本
bash setup.sh
```

**setup.sh 当前主要提供交互式安装。**

**setup.sh 会做什么：**
1. 询问 vault 路径，复制模板
2. 询问用户名、时区、语言
3. 询问 OpenClaw workspace 路径和 skills 路径
4. 询问是否安装 conversation-mining
5. 写入 `scripts/config.env`
6. 安装 skills（有冲突检测，不会覆盖已有 skill）
7. 运行基础检查

**作为 AI Agent，你当前应该这样做：**
- 先收集好用户的回答（Q1-Q4）
- 推断出 BRAIN_PATH、USER_NAME、TIMEZONE、SKILLS_PATH
- 帮用户运行交互式安装，或一步步手动完成最小安装
- **不要假设当前版本已经支持 `--non-interactive`**；若仓库后续补上该能力，再切到非交互模式

### 方式 B：手动分步安装（高级用户）

```bash
# Step 1: Clone
git clone https://github.com/FairladyZ625/Obsidian-Brain-OS.git

# Step 2: 复制 vault 模板
cp -r Obsidian-Brain-OS/vault-template ~/my-brain

# Step 3: 配置路径
cp Obsidian-Brain-OS/scripts/config.env.example scripts/config.env
# 编辑 config.env，填写 BRAIN_PATH、USER_NAME 等

# Step 4: 安装 skills
cp -r Obsidian-Brain-OS/skills/* ~/.agents/skills/

# Step 5: 安装 conversation-mining（可选）
cd Obsidian-Brain-OS/tools/conversation-mining && pip install -e .

# Step 6: 配置 Cron（可选）
openclaw cron import Obsidian-Brain-OS/cron-examples/generated/nightly-pipeline.json
openclaw cron import Obsidian-Brain-OS/cron-examples/generated/personal-ops.json
```

📖 详见 `docs/zh/obsidian-setup.md` / `docs/zh/openclaw-setup.md`

---

## Phase 4: 确认与交接

安装完成后：
1. 确认用户能在 Obsidian 中打开 vault
2. 确认至少一个脚本运行正常
3. **引导用户阅读 `docs/component-guide.md`**，不要一次丢太多文档
4. 如果用户做的是个人事务路径，再引导看 `docs/personal-ops.md`
5. 如果用户做的是多 Agent / 协作路径，再引导看 `docs/agents.md`
6. 如启用了 Observer，再引导看 `docs/agent-playbooks/observer-playbook.md`
7. 告诉用户：系统需要迭代，不是装完就完美的

---

## 关键原则

- **先问后做** — 不要安装用户没要求的东西
- **一步步来** — 不要一次倾倒所有步骤
- **部分安装也可以** — 只要知识结构的人不需要完整 pipeline
- **每步验证** — 做完一步问"能跑吗？"再继续
- **引用文档** — 遇到复杂问题，指引用户去读对应文档，不要试图全部塞进对话
- **诚实告知** — 告诉用户这套系统需要持续迭代，不是开箱即用的完美方案

---

## 文档引用速查

安装过程中，根据用户问题引用对应文档：

| 用户问题 | 引用文档 |
|---------|---------|
| **"Agent 怎么配？团队怎么搭？"** | **`docs/agents.md`** |
| "我该先装哪一档？" | `docs/install-profiles.md` |
| "怎么快速开始？" | `docs/getting-started.md` |
| "Obsidian 怎么配？" | `docs/obsidian-setup.md` |
| "OpenClaw / cron 怎么配？" | `docs/openclaw-setup.md` |
| "日常怎么用个人事务系统？" | `docs/personal-ops.md` |
| "Skill 怎么用？每个 Skill 干嘛的？" | `docs/agents.md` |
| "项目管理推荐？" | `docs/project-management.md` |
| "常见问题？" | `docs/faq.md` |
| "Chronicle 史官是什么？" | `docs/chronicle-agent.md` |
| "QMD 语义搜索？" | `docs/qmd-setup.md` |
| **"Observer 观察者怎么配置？"** | **`docs/agent-playbooks/observer-playbook.md`** |
| **"怎么发版？PR 怎么写？"** | **`docs/agent-playbooks/release-playbook.md`** |
| **"PII 脱敏怎么做？"** | **`docs/references/pii-deidentification-guide.md`** |
| **"仓库里有什么？从哪开始？"** | **`docs/component-guide.md`** |
| "Cron Prompt 怎么写才靠谱？" | `docs/writing-cron-prompts.md` |
| "怎么自己写 Skill？" | `docs/skill-authoring-guide.md` |
| "整体架构是什么？" | `docs/architecture.md` |

---

## 常见问题

| 问题 | 解决方案 |
|------|---------|
| Obsidian 不显示 vault | 检查路径是否为目录 |
| 脚本 "command not found" | 检查 Python/bash 版本；确认 `config.env` 已配置 |
| convs 找不到 | 可选组件；`export-conversations.sh` 会自动跳过 |
| Cron 不运行 | 确认 OpenClaw gateway 运行中 |
| Knowledge lint 找不到文件 | 确认 `BRAIN_PATH` 指向 vault 根目录 |