硬核学习搭子

{workspace}/{技能名称-时间戳}/{文件名}

{workspace}/sc-xxx-20260730-150700/report.md
{workspace}/sc-xxx-20260730-150700/output/data.csv
{workspace}/sc-xxx-20260730-150700/assets/cover.png

📅 间隔重复时间表（艾宾浩斯曲线）：
┌──────────┬───────────────┬──────────────┐
│ 复习轮次  │ 间隔时间       │ 记忆保持率    │
├──────────┼───────────────┼──────────────┤
│ 第1次    │ 学习后 20分钟  │ ~100%        │
│ 第2次    │ 1小时后       │ ~90%         │
│ 第3次    │ 1天后        │ ~80%         │
│ 第4次    │ 2天后        │ ~75%         │
│ 第5次    │ 4天后        │ ~70%         │
│ 第6次    │ 7天后        │ ~65%         │
│ 第7次    │ 15天后       │ ~60%         │
│ 第8次    │ 30天后       │ ~55%         │
└──────────┴───────────────┴──────────────┘

计算公式：
nextReview = lastReview × intervalMultiplier
intervalMultiplier = {1, 3, 7, 14, 30} (天)

难度调整：
- 简单(一遍过)：multiplier × 1.5
- 中等(需要想)：multiplier × 1.0
- 困难(记不住)：multiplier × 0.6

## 📇 知识卡片 #{编号}

**学科**：{学科名称}
**主题**：{知识点主题}
**难度**：🟢简单 / 🟡中等 / 🔴困难
**来源**：{教材/课程/论文 - 页码/章节}

### 📌 核心概念
{一句话定义/公式/定理}

### 🔍 详细解释
{2-3段详细说明}

### 💡 费曼简化版
{用大白话解释，像教10岁小孩一样}

### 🔗 关联知识
- 前置：{需要先掌握的知识点}
- 后续：{延伸的知识点}
- 对比：{容易混淆的知识点}

### ✅ 自测题
**Q**: {问题}
**A**: {答案} (点击/翻转查看)

### 📅 复习计划
| 轮次 | 日期 | 结果 |
|------|------|------|
| 1 | {学习日+1天} | ⏳ |
| 2 | {学习日+3天} | ⏳ |
| 3 | {学习日+7天} | ⏳ |

🔬 费曼学习法四步：

Step 1: 选择概念
→ 写下你要学习的概念：{概念名}

Step 2: 教给小白
→ 用最简单的语言解释，仿佛在教一个完全不懂的人
→ {你的解释}

Step 3: 找到差距
→ 回顾解释，标记出你卡壳、含糊或需要查资料的地方
→ {差距1}, {差距2}

Step 4: 简化再简化
→ 回到原始材料，补上差距，然后用更简单的语言重新解释
→ {简化后的解释}

✅ 检验标准：如果小学生都能听懂，你就真的理解了。

📊 学习进度复盘检查表

□ 本周学习目标完成率：___%
□ 知识卡片掌握率（简单/中等/困难）：
  - 🟢 简单：___/___ (≥90%达标)
  - 🟡 中等：___/___ (≥75%达标)
  - 🔴 困难：___/___ (≥60%达标)
□ 复习计划执行率：___%
□ 错题本新增：___题，已解决：___题
□ 费曼法检验：通过/未通过
□ 下周调整方向：{调整说明}

⚠️ 预警阈值：
- 目标完成率 < 50% → 需调整学习计划
- 困难卡片掌握率 < 40% → 需降低难度或增加前置学习
- 连续3天未复习 → 触发提醒

{
  "skills": {
    "entries": {
      "feishu-doc": { "enabled": true },
      "feishu-knowledge-manager": { "enabled": true },
      "tencent-docs": { "enabled": true },
      "ima": { "enabled": true }
    }
  }
}

# PowerShell
@('FEISHU_APP_ID', 'FEISHU_APP_SECRET', 'TENCENT_DOC_TOKEN', 'IMA_API_KEY') | ForEach-Object {
  $status = if (Test-Path "Env:$_") { 'SET' } else { 'NOT_SET' }
  "$_=$status"
}

# CMD
for %V in (FEISHU_APP_ID FEISHU_APP_SECRET TENCENT_DOC_TOKEN IMA_API_KEY) do @if defined %V (echo %V=SET) else (echo %V=NOT_SET)

# Linux/macOS
for name in FEISHU_APP_ID FEISHU_APP_SECRET TENCENT_DOC_TOKEN IMA_API_KEY; do
  if [ -n "${!name:-}" ]; then echo "$name=SET"; else echo "$name=NOT_SET"; fi
done

# PowerShell - 检测workspace中的学习资料
$dir = "$env:USERPROFILE.qclawworkspace"
$studyFiles = @("学习计划.md", "知识卡片.csv", "疑点清单.md", "周复盘.md")
foreach ($f in $studyFiles) {
    $path = Join-Path $dir $f
    if (Test-Path $path) { Write-Host "✅ 已存在: $f" }
    else { Write-Host "⏳ 待创建: $f" }
}

# Linux/macOS
dir="$HOME/.qclaw/workspace"
for f in "学习计划.md" "知识卡片.csv" "疑点清单.md" "周复盘.md"; do
    [ -f "$dir/$f" ] && echo "✅ 已存在: $f" || echo "⏳ 待创建: $f"
done

# CMD
for %%f in ("学习计划.md" "知识卡片.csv" "疑点清单.md" "周复盘.md") do (
    if exist "%USERPROFILE%.qclawworkspace%%f" (echo ✅ 已存在: %%f) else (echo ⏳ 待创建: %%f)
)

可用服务（按优先级排序）：
✅ 飞书知识库 (FEISHU_APP_ID 已配置)
✅ 腾讯文档 (TENCENT_DOC_TOKEN 已配置)
✅ 文件系统 (workspace 可写入)
✅ IMA知识库 (IMA_API_KEY 已配置)
❌ Notion (禁用 - 境外服务)

📚 学习目标确认：
- 学习类型：[备考/技能提升/兴趣学习/项目驱动]
- 目标描述：[具体目标，如"通过CPA会计科目"]
- 截止日期：[YYYY-MM-DD，如有]
- 可用时间：[每天可用学习时间]
- 材料来源：[教材名/课程名/其他]
- 隐私设置：[标准/家长可见模式]

输入：目标、截止日、可用时间/天、知识点数量
输出：每日学习安排 + 复习时间表

算法：
1. 计算总可用学习天数 = 截止日 - 今天
2. 计算新学+复习时间比 = 7:3（标准模式）/ 5:5（冲刺模式）
3. 按难度分配学习时间：
   - 🟢简单：1倍时间
   - 🟡中等：2倍时间
   - 🔴困难：3倍时间
4. 插入间隔重复复习节点
5. 留出10%缓冲时间

# 📚 学习计划 — {目标名称}

**目标**：{学习目标}
**截止日期**：{YYYY-MM-DD}
**可用时间**：每天 {N} 小时
**模式**：{标准/冲刺}

## 📅 总体规划
- 总学习天数：{N}天
- 知识点总数：{N}个（🟢{n1} / 🟡{n2} / 🔴{n3}）
- 新学:复习时间比：{7:3 或 5:5}

## 📋 每日安排

### Day 1 — {日期}
| 时段 | 内容 | 类型 | 时长 |
|------|------|------|------|
| 新学 | {知识点1-3} | 🟡中等 | 60min |
| 复习 | {前置知识点} | 🟢简单 | 20min |
| 自测 | 卡片 #{1-5} | 混合 | 10min |

### Day 2 — {日期}
| 时段 | 内容 | 类型 | 时长 |
|------|------|------|------|
| 新学 | {知识点4-6} | 🔴困难 | 90min |
| 复习 | Day1全部 (间隔1天) | 混合 | 30min |
| 自测 | 卡片 #{1-8} | 混合 | 10min |

...（后续天数）

## 🔄 复习时间表
| 知识点 | 第1次复习 | 第2次 | 第3次 | 第4次 |
|--------|----------|-------|-------|-------|
| {知识点1} | +1天 | +3天 | +7天 | +14天 |

编号,学科,主题,难度,核心概念,费曼简化版,前置知识,复习日期1,复习日期2,复习日期3,状态
001,{学科},{主题},🟡,{一句话定义},{大白话解释},{前置知识点},{+1天},{+3天},{+7天},⏳

# ❓ 疑点清单 — {学科/主题}

## 🔴 高优先级（阻塞后续学习）
| # | 疑点 | 来源 | 关联知识 | 解决方案 | 状态 |
|---|------|------|---------|---------|------|
| 1 | {疑点描述} | {来源:页码} | {阻塞哪个知识点} | {方案} | ⏳ |

## 🟡 中优先级（影响理解深度）
| # | 疑点 | 来源 | 关联知识 | 解决方案 | 状态 |
|---|------|------|---------|---------|------|
| 1 | {疑点描述} | {来源:页码} | {影响哪个知识点} | {方案} | ⏳ |

## 🟢 低优先级（边缘知识）
| # | 疑点 | 备注 | 状态 |
|---|------|------|------|
| 1 | {疑点描述} | 可后续补充 | ⏳ |

# 📊 周复盘 — Week {N}（{日期范围}）

## 进度概览
| 指标 | 目标 | 实际 | 达成率 |
|------|------|------|--------|
| 新学知识点 | {N} | {n} | {pct}% |
| 复习完成率 | 100% | {pct}% | {pct}% |
| 卡片掌握率 | 80% | {pct}% | {pct}% |

## ✅ 本周成果
1. {成果1}
2. {成果2}

## ⚠️ 问题与调整
- {问题} → {调整方案}

## 📅 下周重点
1. {重点1} (难度: 🔴)
2. {重点2} (难度: 🟡)

## 进度复盘检查表
- [ ] 目标完成率 ≥ 70%
- [ ] 🟢简单卡片掌握率 ≥ 90%
- [ ] 🟡中等卡片掌握率 ≥ 75%
- [ ] 📅 复习计划执行率 ≥ 80%
- [ ] ❌ 错题解决率 ≥ 50%

# PowerShell
$dir = "$env:USERPROFILE.qclawworkspace"
$content | Out-File -FilePath (Join-Path $dir "学习计划.md") -Encoding UTF8

# CMD
cd %USERPROFILE%.qclawworkspace
echo %content% > "学习计划.md"

# Linux/macOS
echo "$content" > "$HOME/.qclaw/workspace/学习计划.md"

# PowerShell
[System.Environment]::SetEnvironmentVariable("FEISHU_APP_ID", "your-id", [System.EnvironmentVariableTarget]::User)

# Linux/macOS
echo 'export FEISHU_APP_ID="your-id"' >> ~/.bashrc && source ~/.bashrc

# CMD
setx FEISHU_APP_ID "your-id"

# PowerShell
$dir = "$env:USERPROFILE.qclawworkspace"
Get-ChildItem $dir -Filter "学习*" | Select-Object Name, LastWriteTime

# CMD
dir "%USERPROFILE%.qclawworkspace学习*"

# Linux/macOS
ls -la "$HOME/.qclaw/workspace/"学习* 2>/dev/null

✅ 超时时间：60秒（文档服务调用）
✅ 最大重试：2次
✅ 重试间隔：3秒
✅ 降级策略：文档服务 → 本地文件 → 对话窗口输出

首选输出通道失败
  ↓
1. 飞书知识库写入失败 → 降级到腾讯文档
2. 腾讯文档写入失败 → 降级到本地文件
3. 本地文件写入失败 → 直接输出到对话窗口
4. 所有通道失败 → 提供复制粘贴模板

# PowerShell
$timeoutSec = 60
$maxRetries = 2
$retryDelaySec = 3
$retryCount = 0
$success = $false

while ($retryCount -le $maxRetries -and -not $success) {
    try {
        # 执行文档服务操作
        $success = $true
        break
    }
    catch [System.Net.WebException] {
        if ($_.Exception.Status -eq "Timeout") {
            Write-Host "⏱️ 超时（${timeoutSec}秒）"
            $retryCount++
            if ($retryCount -le $maxRetries) {
                Write-Host "🔄 重试 ($retryCount/$maxRetries)..."
                Start-Sleep -Seconds $retryDelaySec
            }
        }
        elseif ($_.Exception.Response -and $_.Exception.Response.StatusCode -eq 401) {
            Write-Host "❌ 认证失败 (401) - 不重试"
            break
        }
        else {
            $retryCount++
            if ($retryCount -le $maxRetries) { Start-Sleep -Seconds $retryDelaySec }
        }
    }
    catch {
        Write-Host "❌ 错误: $($_.Exception.Message)"
        $retryCount++
        if ($retryCount -le $maxRetries) { Start-Sleep -Seconds $retryDelaySec }
    }
}

if (-not $success) {
    Write-Host "😥 文档服务失败，降级到本地文件输出"
}

# Bash
max_retries=2
retry_delay=3
retry_count=0
success=false

while [ $retry_count -le $max_retries ] && [ "$success" = "false" ]; do
    if 执行操作 2>/dev/null; then
        success=true
    else
        retry_count=$((retry_count + 1))
        [ $retry_count -le $max_retries ] && sleep $retry_delay
    fi
done

[ "$success" = "false" ] && echo "😥 降级到本地文件"

⚠️ 检测到未成年人相关学习资料

自动启用：
1. 家长可见摘要模式
2. 隐私保护提醒
3. 学习时长限制建议
4. 内容安全过滤