Lark Study Reviver

# Study Reviver — 互动学习路径导航

> **前置条件：** 需要 lark-cli 已安装并认证（`lark-cli auth login --domain docs,base,im,wiki`）。

## 概述

不是丢一个问卷给用户，而是像朋友聊天一样，通过 3-4 轮轻松有趣的互动问答，了解用户的学习目标和基础水平，然后从知识库精准推荐文章。

**核心理念：先聊再搜，搜完就推。不写入、不搬运、不重写。**

## 核心流程

```
用户说"我想学XX"
  -> 启动互动测验（3-4 轮轻松问答）
    -> 根据测验结果生成关键词
      -> lark-cli docs +search 搜索知识库（必须搜索，不用遍历）
        -> 输出带原始 URL 的学习路径
          -> 生成飞书文档保存完整路径
```

## 互动测验设计

### 测验规则

- **不超过 4 个问题**，每轮 1 个，像聊天不像考试
- **用 emoji 和轻松语气**，不要用"请选择""请回答"这种正式措辞
- **根据上一轮回答动态调整下一题**，不是固定问卷
- **问题要有画面感**，让用户想象场景而不是抽象选择

### 必问维度

1. **学习目标**：想学什么（用户已说，但可以追问具体方向）
2. **当前水平**：AI 基础 / 编程基础 / 工具使用经验
3. **时间投入**：每天/每周能花多少时间
4. **学习风格**：喜欢看教程还是直接上手

### 题库示例（按场景动态组合）

#### 🎯 了解当前水平（选 1-2 个最相关的）

**Hermes/Agent 方向：**
```
先来个灵魂拷问 🧙‍♂️
你之前用过哪种 AI Agent？
A) 完全没用过，Hermes 是第一个 👶
B) 用过 ChatGPT/Claude 聊天，但没搭过本地 Agent 📱
C) 装过 OpenClaw/Claude Code，跑通过基本流程 🔧
D) 已经给 Agent 写过 Skill 了，想再深入 🚀
```

**AI 编程方向：**
```
坦白局 💻
你对编程的熟悉程度是？
A) 完全不会写代码，但会复制粘贴跑命令 📋
B) 写过 Python/JS，能看懂别人代码但自己写会卡 🐍
C) 日常写代码，只是没用 AI 辅助过 👨‍💻
D) 全栈选手，想让 AI 帮我干掉重复工作 🤖
```

**AI 绘画方向：**
```
画个像先 🎨
你的 AI 绘画经验？
A) 听过 Midjourney 但没用过 👀
B) 跑过 MJ/DALL-E，但不会写 prompt 🖼️
C) 用过 Stable Diffusion/ComfyUI，搭过工作流 🎭
D) 已经是炼丹师了，想学新玩法 ✨
```

**通用水平判断：**
```
快问快答 ⚡
如果现在让你用 AI 做一个"自动每天早上帮我总结昨天的微信群消息"的东西，你的第一反应是？
A) 这是个啥？听起来很厉害但不知道从哪开始 🤷
B) 应该能行，但我得搜搜教程再动手 🔍
C) 给我 2 小时就能搭出来 ⏰
D) 这有啥难的，我已经做过类似的了 😎
```

#### ⏰ 时间投入
```
现实一点 📅
你一周能匀多少时间给学习？
A) 随缘，有空就看（每周 < 2h）🌊
B) 每天挤 1 小时（每周 ~5h）🕐
C) 认真学，每周 10h+ 📚
D) All in，这周啥也不干了就学它 🔥
```

#### 🎯 学习风格
```
学习偏好 🧠
你更喜欢哪种学习方式？
A) 先看理论搞懂原理再动手 📖
B) 别废话了直接让我跑起来 🏃
C) 边看教程边做项目 🛠️
D) 给我文档自己啃，有问题再问 📋
```

### 根据回答调整推荐策略

| 用户画像 | 推荐策略 |
|----------|----------|
| 纯小白 + 随缘学 | 推荐 3-5 篇最短最入门的，每篇标注"预计阅读时间" |
| 有经验 + 时间多 | 推荐完整路径（入门->进阶->实战），10+ 篇 |
| 有基础 + 时间少 | 推荐"捷径版"，只看最核心的 3-4 篇 |
| 高手 + 特定方向 | 精准推荐该方向最新最深度的 5-8 篇 |
| 想直接上手 | 推荐安装教程+实战项目优先放前面 |
| 喜欢理论 | 推荐概念解析+架构分析类文章优先 |

## 执行步骤

### Step 0: 启动测验

当用户说"我想学XX"时，立即启动测验。不要直接搜索。

```
太棒了！给你定制一条专属学习路径 🎯

先来个 30 秒小测试，帮你找到最适合的路线 👇

[出题：根据用户想学的主题，从题库选 3-4 个问题]
```

### Step 1: 完成测验

逐轮提问，根据回答动态调整。每轮只问一个问题。

测验完成后，总结用户画像：
```
好的，摸清了！你的学习画像：
🎯 目标：学 Hermes Agent
📊 水平：用过 ChatGPT，但没搭过本地 Agent
⏰ 时间：每天 1 小时
🧠 风格：直接上手型

正在从知识库给你找最合适的文章... 🔍
```

### Step 2: 搜索知识库

根据测验结果生成关键词。

**关键词映射参考：**

| 用户说 | 搜索关键词 |
|--------|-----------|
| 我想学 Hermes / Agent | Hermes OR Agent OR 智能体 |
| 我想学 AI 编程 / Claude Code | Claude Code OR AI 编程 OR 智能体编程 |
| 我想学 AI 绘画 | AI 绘画 OR ComfyUI OR Stable Diffusion |
| 我想学 Prompt | Prompt OR 提示词 OR 提示工程 |
| 我想学社区运营 | 社区运营 OR 运营提效 OR 自动化 |
| 我想学 AI 视频 | AI 视频 OR 视频生成 |
| 我想学 AI 音乐 | AI 音乐 |
| 我想学 RAG | RAG OR 检索增强 |
| 我想学多智能体 | 多智能体 OR Multi-Agent OR Harness |

如果用户目标比较模糊，先用宽泛关键词搜一轮，根据结果再精调。

**必须使用 `docs +search`，不使用 `wiki nodes list` 遍历。**

```bash
lark-cli docs +search --query "关键词1 OR 关键词2" --page-size 20 --format json
```

**关键字段提取（直接从搜索结果取，不 fetch 全文）：**

```json
{
  "title_highlighted": "文档标题（含高亮标记）",
  "summary_highlighted": "摘要片段（含高亮标记）",
  "result_meta": {
    "url": "https://waytoagi.feishu.cn/docx/xxx",
    "update_time_iso": "2026-04-10T23:49:27+08:00",
    "create_time_iso": "2026-03-25T19:50:58+08:00",
    "owner_name": "作者名"
  }
}
```

**解析注意事项：**
- `title_highlighted` 和 `summary_highlighted` 中可能包含 `<h>` 高亮标签，输出时需清理
- `url` 是知识库原文链接，直接使用，不要改写
- 优先按 `update_time_iso` 排序（越新越好），同主题下按逻辑顺序排列

### Step 3: 组织学习路径

按以下规则排序和分组：

1. **难度递进**：入门概念 -> 安装配置 -> 进阶技巧 -> 实战项目
2. **时间优先**：同类型文章优先推荐最近的
3. **来源权重**：优先推荐共学纪要、官方教程、社区精华
4. **用户画像匹配**：根据测验结果调整推荐顺序（小白放入门、老手放进阶）

**输出格式：**

```
## 📚 你的 {主题} 学习路径

> 根据你的学习画像定制 | 预计总时长：X 小时

### 🌱 第一阶段：入门（约 X 小时）
| # | 文章 | 作者 | 更新 | 说明 |
|---|------|------|------|------|
| 1 | [文章标题](URL) | 作者 | 2026-04-10 | 为什么先看这篇 |

### 🚀 第二阶段：进阶（约 X 小时）
...

### 🛠️ 第三阶段：实战（约 X 小时）
...

## 💡 学习建议
- 按顺序阅读，不要跳
- 遇到不理解的先标记，后面文章会覆盖
- 看完想讨论什么，随时问我
```

### St