crypto-learning

# Crypto Learning - 加密货币自学系统

## 目标

给 hmzo 提供“每天可直接学习”的加密货币课程推送：
- 解释清楚（小白能看懂）
- 内容完整（不是只有题目）
- 有最新资料整合（web_search 检索）
- 有可执行学习动作（自测/作业）

## 学习大纲位置

学习大纲在 `content.json`：
- 小白向（30天）
- 投资向（60天）
- 进阶投资（90天）

进度在 `progress.json`。

## 必须遵守的输出质量规则（硬约束）

每次输出学习报告都必须满足以下要求：

1. **禁止只输出题目或一句话摘要**。
2. **最少包含 6 个模块**（见下方固定模板）。
3. **正文长度不少于 450 字**（不含标题与分隔符）。
4. **术语必须解释**：首次出现术语（如 PoW、PoS、Gas、TVL）时，给一句“白话解释”。
5. **至少给 2 个生活类比或场景例子**，帮助理解抽象概念。
6. **至少给 3 条要点总结**（可背诵版本）。
7. **必须含 3 道自测题 + 标准答案**。
8. **最后给出次日预告**，并更新学习进度。

若 web_search 检索结果不足，仍要基于 `content.json` 产出完整报告，不得降级为短消息。

## 固定输出模板（每次都用）

按以下结构输出（允许微调措辞，但模块不可缺失）：

1. `📚 第 X 天学习内容`（阶段 / 主题 / 今日重点）
2. `📖 先讲人话版`（先用 3-6 句白话解释核心概念）
3. `🧱 系统化知识`（定义、原理、关键组成、常见误区）
4. `🌐 最新资料整合`（基于 web_search 的信息融合，不要贴生硬链接堆砌）
5. `🧠 例子与类比`（至少 2 个）
6. `✅ 今日小结`（至少 3 条可记忆要点）
7. `📝 3题自测（含答案）`
8. `🚀 明日预告 + 进度更新`

## 工作流程

### 1) 读取进度

读取 `progress.json`：
- `current_stage`
- `current_topic_index`
- `current_subtopic_index`
- `completed_subtopics`

### 2) 获取今日主题

根据进度从 `content.json` 取出：
- 阶段
- 主题
- 子主题
- 基础知识点

### 3) web_search 检索并整合

必须检索当日主题相关的最新内容，再进行融合输出。

检索建议：
- 中文关键词：`子主题 + 加密货币 + 入门/教程/原理`
- 英文关键词：`subtopic + crypto + beginner guide/explained`
- 优先权威来源：Binance Academy、CoinMarketCap Alexandria、Investopedia、Ethereum/Bitcoin 官方文档等

要求：
- 不照搬原文；用自己的结构重写
- 把多来源信息合并成统一叙事
- 说明“共识点”和“容易误解点”

### 4) 生成详细学习报告

严格使用...

# Crypto Learning Skill - 加密货币自学系统

## 功能说明

这个 skill 帮助你系统学习加密货币知识，每天早上 9 点自动推送学习内容。

## 学习大纲

### 阶段 1：小白向（30天）
- 什么是加密货币
- 区块链基础
- 钱包和密钥
- 交易所基础
- 安全第一

### 阶段 2：投资向（60天）
- 技术分析基础
- 基本面分析
- DeFi基础
- 风险管理
- 市场周期

### 阶段 3：进阶投资（90天）
- 期权与合约
- 链上数据分析
- 宏观经济影响
- 税务与合规
- 投资心理学

## 使用方法

### 自动学习（推荐）

每天早上 9 点会自动推送学习内容，无需手动操作。

### 手动命令

```bash
# 查看学习进度
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py progress

# 获取今日学习内容
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py today

# 跳过今天
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py skip

# 重置学习计划
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py reset

# 预览下一个主题
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py next
```

## 工作原理

1. **读取进度**：从 `progress.json` 读取当前学习进度
2. **获取内容**：从 `content.json` 获取对应的学习内容
3. **搜索最新资料**：使用 browser 搜索该知识点的最新详细内容
4. **整合呈现**：将基础内容和搜索结果整合后呈现
5. **更新进度**：自动更新学习进度到下一个主题

## 定时任务

已设置每天早上 9 点（新加坡时间）自动推送：
- Cron 表达式：`0 9 * * *`
- 时区：Asia/Singapore

## 文件结构

```
crypto-learning/
├── SKILL.md          # Skill 定义文件
├── README.md         # 本文件
├── content.json      # 学习大纲（所有知识点）
├── progress.json     # 学习进度跟踪
└── learn.py          # 学习脚本
```

## 注意事项

- 每次学习都会通过 browser 搜索最新内容，确保信息的时效性
- 学习进度会自动保存，即使重启也不会丢失
- 可以随时跳过某天的学习
- 可以随时重置学习计划重新开始

## 开始学习

系统已经配置好定时任务，明天早上 9 点会自动推送第一个学习内容！

如果想立即查看当前学习内容，运行：
```bash
python3 /home/hmzo/.openclaw/workspace/skills/crypto-learning/learn.py today
```