WorkBuddy 智能学习系统 (Smart Learning System)

概述

WorkBuddy 的自我进化引擎，基于「感知-学习-行动」SEA 循环实现持续优化。整合六大模块，形成完整的反馈闭环。

---

系统架构

反馈收集 ←→ 隐式信号 ←→ 任务画像
     ↓              ↓           ↓
  知识蒸馏 ←→ 自适应阈值 ←→ 模式识别
                  ↓
            实时警报（触发→固化）
                  ↓
            模板执行（命中→执行→对比）

模块说明

模块	文件	核心功能
反馈收集	feedback.py	显式反馈（👍/👎/✏️）+ 自动归类
隐式信号	signal_collector.py	5类行为信号无感采集
任务画像	task_profiler.py	执行轨迹追踪 + 复杂度分析
模式识别	pattern_recognizer.py	高频模式扫描 + 自适应警报
知识蒸馏	knowledge_distiller.py	自适应阈值 + 模板匹配 + 避坑规则
主入口	learn.py	整合六大模块，CLI 命令行

数据存储

.workbuddy/memory/
├── feedback/           # 反馈记录 (JSON)
├── signals/           # 隐式信号数据 (JSON)
├── task_profiles/     # 任务执行轨迹 (JSON)
├── patterns/          # 模式识别结果 + 阈值状态
│   └── threshold_state.json  # 自适应阈值状态
└── templates/         # 蒸馏模板 + 避坑规则
    └── failed_patterns/avoid_*.yaml

---

核心模块详解

1. 反馈收集 (feedback.py)

FeedbackCollector：

• record_feedback(task_id, rating, tags, note) - 记录单条反馈
• get_recent_feedback(days) - 获取近期反馈
• generate_feedback_prompt() - 生成反馈询问文本

反馈类型：good / bad / neutral 标签：用户自定义，如 文件整理、数据分析、报告生成

2. 隐式信号采集 (signal_collector.py)

SignalCollector - 5类信号无感采集：

信号	计算方式	学习意义
反馈填写率	有反馈任务/总任务	参与度代理
任务取消率	主动中断/总任务	方案不适配
平均任务时长	所有任务耗时均值	执行效率
工具成功率	成功调用/总调用	工具质量
重复修正率	重复执行/总任务	模式固化价值

健康评分（0-100）：基于5类信号综合计算

3. 任务画像 (task_profiler.py)

TaskProfile - 单任务轨迹：

• start_task(task_id, summary) - 开始
• use_template(template_id, name) - 标记使用模板
• record_tool_call(tool, success, duration) - 记录工具调用
• end_task(outcome, success) - 结束

TaskProfilerAnalyzer - 分析器：

• get_complexity_distribution(days) - 简单/中等/复杂 分布
• compare_template_vs_free(days) - 有模板 vs 自由执行 对比
• get_tool_usage_stats(days) - Top10 高频工具

4. 模式识别 + 警报 (pattern_recognizer.py)

评分公式：

score = (freq/max_freq) * 50 + (recency/max_recency) * 20 + stability * 30

≥60分 = 高价值模式，建议沉淀

自适应阈值引擎 (AdaptiveThresholds)：

• 基于历史警报准确率自动调节阈值
• 准确率 > 70% → 敏感模式（降阈值 15%）
• 准确率 < 40% → 保守模式（升阈值 30%）
• 状态持久化：threshold_state.json

三级警报：

等级	类型	条件	响应
URGENT	突发	≥ urgent阈值（默认75）	立即通知
TREND	趋势	环比增长 > 150% 且 ≥ trend阈值	本周关注
STABLE	稳定	长期高频且 ≥ high阈值	建议模板化

5. 知识蒸馏 (knowledge_distiller.py)

自适应蒸馏阈值：

effective_threshold = base / feedback_rate

填写率高 → 低阈值（频繁蒸馏）；填写率低 → 高阈值（避免误触发）

模板匹配：

• match_template(user_request) - Jaccard 相似度关键词匹配
• generate_match_suggestion(user_request) - 生成推荐文本
• 置信度 ≥ 50% → 直接推荐；≥ 20% → 参考提示

避坑规则：

• 负面反馈 → avoid_*.yaml 避坑规则
• 自动推断应避免的操作 + 修复建议

---

命令行使用

cd .workbuddy/skills/workbuddy-smart-learning

python learn.py full        # 完整学习周期（6阶段综合报告）
python learn.py patterns     # 模式识别
python learn.py feedback    # 记录反馈
python learn.py distill     # 知识蒸馏
python learn.py signals     # 隐式信号报告
python learn.py alerts      # 实时警报检查
python learn.py profiler    # 任务画像分析
python learn.py match "关键词"  # 模板关键词匹配

full 命令输出结构

## 1. 反馈摘要     - 近7天反馈数、填写率
## 2. 模式识别     - 近30天高价值模式、Top3高频任务
## 3. 实时警报     - URGENT/TREND/STABLE 三级警报
## 4. 知识蒸馏     - 自适应阈值状态、自动蒸馏触发结果
## 5. 模板对比     - 有模板 vs 自由执行 成功率/耗时对比

---

与主对话流程集成

任务完成后 → 反馈询问

反馈：[👍/👎/✏️]
标签：任务类型（可选）
备注：改进建议（可选）

调用 python learn.py feedback 记录

新会话启动时 → 模式检查

检测到涉及历史上下文时：

1. 读取 MEMORY.md + 近期每日记忆
2. 检查 ≥60分的高频模式
3. 主动提示用户是否需要优化

警报处理 → 阈值学习

• 用户确认警报有效 → record_alert_confirmed(task)
• 用户判定为误报 → record_alert_rejected(task)

---

阈值配置

参数	默认值	说明
模式评分阈值	60	≥60分触发沉淀建议
蒸馏基础阈值	5	正面反馈达到此数触发蒸馏
警报-突发	75	立即通知
警报-关注	70	本周关注
警报-趋势	60	周报标记
趋势增幅	150%	环比超过此值触发趋势警报

---

版本历史

• 2026-04-14：基础版 - 反馈收集 + 模式识别 + 知识蒸馏
• 2026-04-17 v1：第一轮 - 隐式信号 + 自动蒸馏触发 + 实时警报
• 2026-04-17 v2：第二轮 - 任务画像 + 模板匹配 + 自适应阈值引擎