{"skill":{"slug":"subagent-distiller","displayName":"Subagent Distiller","summary":"自动增量提取对话中的结构化知识，智能过滤无用信息，动态聚类主题，支持状态追踪和长期价值沉淀。","description":"# Subagent Distiller v3.0 - 生产级记忆蒸馏系统\n\n**一句话介绍**：自动增量提取对话中的结构化知识，过滤垃圾，动态聚类，专注长期价值。\n\n---\n\n## 核心特性\n\n| 特性 | 说明 |\n|------|------|\n| **增量扫描** | Cursor 机制，只处理新增对话，99% 节省 |\n| **实时结构化** | 边提取边整理，直接输出精炼格式 |\n| **智能过滤** | 体育分析、市场预测、临时新闻 → 直接丢弃 |\n| **动态聚类** | 自动发现域（Polymarket/OpenClaw/...），非固定分类 |\n| **状态追踪** | RESOLVED/PENDING/ABANDONED，待办自动提醒 |\n\n---\n\n## 安装\n\n```bash\n# 通过 ClawHub 安装\nclawhub install subagent-distiller\n\n# 或手动安装\ngit clone https://github.com/yourname/subagent-distiller.git ~/.openclaw/workspace/skills/subagent-distiller\n```\n\n---\n\n## 快速开始\n\n### 1. 初始化（首次运行）\n```bash\ncd ~/.openclaw/workspace/skills/subagent-distiller\npython3 incremental_slice.py    # 扫描历史对话\npython3 realtime_distill.py     # 提取结构化知识\n```\n\n### 2. 每日自动运行（推荐）\n```bash\n# 添加到 crontab\ncrontab -e\n\n# 凌晨 3:00 增量提取\n0 3 * * * cd ~/.openclaw/workspace/skills/subagent-distiller && python3 incremental_slice.py && python3 realtime_distill.py\n\n# 早上 9:00 待办提醒\n0 9 * * * cd ~/.openclaw/workspace/skills/subagent-distiller && python3 lifecycle_manager.py\n```\n\n### 3. 每周域聚合（手动）\n```bash\npython3 domain_consolidate.py   # 自动发现域，生成专书\n```\n\n---\n\n## 文件结构\n\n```\nsubagent-distiller/\n├── SKILL.md                          # 本文档\n├── incremental_slice.py              # 增量扫描器（cursor 机制）\n├── realtime_distill.py               # 实时结构化提取\n├── domain_consolidate.py             # 动态域聚合\n├── lifecycle_manager.py              # 生命周期管理（待办提醒）\n├── bulk_cleanup.py                   # 批量清理工具\n├── chunks/                           # 切片缓存（自动生成）\n├── cursors/                          # 游标记录（自动生成）\n└── state.json                        # 处理状态（自动生成）\n```\n\n---\n\n## 配置\n\n### 过滤规则（可自定义）\n\n编辑 `realtime_distill.py` 中的 `get_prompt()` 函数：\n\n```python\n# 默认丢弃：\n- 体育比赛分析（球队胜率、比分预测）\n- 具体市场预测（\"X市场胜率62%\"、当日赔率）\n- 临时新闻解读（时效性<7天）\n- 无结论探索（只有\"试试\"没有结果）\n- 寒暄废话（\"在吗\"、\"测试\"）\n- 内容污染（\"我看到...\"等内部思考）\n\n# 默认保留：\n- 架构设计、系统方案\n- 避坑指南、故障解决\n- 配置沉淀、环境搭建\n- 原则/铁律、SOP流程\n```\n\n### 域聚类规则（自动）\n\n```python\n# 自动从卡片名提取前缀作为域\npolymarket_trading_logic.md → Polymarket/\nopenclaw_config_setup.md    → Openclaw/\nbitcoin_wallet_security.md  → Bitcoin/  # 自动创建新域\n```\n\n---\n\n## 输出格式\n\n### 知识卡片（自动生成的 .md 文件）\n\n```markdown\n---\ntopic: \"主题名称\"\nstatus: RESOLVED | PENDING | ABANDONED\ncreated: 2026-03-05\nupdated: 2026-03-06\nsource: session_id.jsonl Line 100-200\n---\n\n# 🏷️ 主题：xxx\n\n## 核心摘要\n一句话总结\n\n## 最新结论 / 成功方案\n- 最终方案\n- 关键决策\n\n## 避坑指南\n- ❌ 废弃尝试及原因\n- ⚠️ 关键陷阱\n\n## 待办事项（仅 PENDING）\n- [ ] 待验证...\n- [ ] 待决策...\n\n## 历史溯源\n- session_id.jsonl Line 100-200\n```\n\n### 域专书（每周聚合生成）\n\n```\nmemory/domains/\n├── Polymarket.md      # 交易代码、架构设计\n├── Openclaw.md        # 配置、子代理模式\n├── Research.md        # 科研相关\n└── System.md          # 通用知识\n```\n\n---\n\n## 工作原理\n\n```\n对话会话 (.jsonl)\n    │\n    ▼\nincremental_slice.py    ← 只读新增行（cursor 记录位置）\n    │\n    ▼\nrealtime_distill.py     ← 子代理提取，垃圾直接丢弃\n    │                        ├── 状态标记\n    │                        └── 精炼格式输出\n    │\n    ▼\nlifecycle_manager.py    ← 每日检查 PENDING 超时\n    │\n    ▼\ndomain_consolidate.py   ← 每周聚合，动态发现域\n```\n\n---\n\n## 命令参考\n\n| 命令 | 说明 |\n|------|------|\n| `python3 incremental_slice.py` | 增量扫描，生成切片 |\n| `python3 realtime_distill.py` | 生成提取任务清单 |\n| `python3 lifecycle_manager.py` | 检查待办，生成提醒报告 |\n| `python3 domain_consolidate.py` | 域聚合，生成专书 |\n| `python3 bulk_cleanup.py` | 批量清理现有卡片 |\n| `python3 lifecycle_manager.py --list-pending` | 列出所有待办 |\n\n---\n\n## 故障排查\n\n### Q: 切片为空？\n```bash\n# 检查 cursor 文件\nls cursors/\n# 删除后重新扫描\nrm cursors/*.cursor && python3 incremental_slice.py\n```\n\n### Q: 提取结果不理想？\n```bash\n# 调整提示词\nvim realtime_distill.py  # 修改 get_prompt() 函数\n```\n\n### Q: 如何彻底重置？\n```bash\n# 清空所有状态\nrm -rf chunks/* cursors/* state.json slice_summary.json\npython3 incremental_slice.py\n```\n\n---\n\n## 版本历史\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| v3.0 | 2026-03-06 | 增量扫描、实时结构化、动态域、智能过滤 |\n| v2.0 | 2026-03-05 | 夜间自动蒸馏、hook 拦截器 |\n| v1.0 | 2026-03-04 | 基础切片提取 |\n\n---\n\n## 作者\n\n- **作者**: OpenClaw Community\n- **许可证**: MIT\n- **仓库**: https://github.com/openclaw/subagent-distiller\n\n---\n\n**一句话**: 让 AI 助手拥有真正的长期记忆，只记住有价值的东西。","topics":["Subagent","知识","记忆"],"tags":{"latest":"3.0.1"},"stats":{"comments":0,"downloads":757,"installsAllTime":28,"installsCurrent":2,"stars":0,"versions":2},"createdAt":1772799097509,"updatedAt":1779077750624},"latestVersion":{"version":"3.0.1","createdAt":1772799682089,"changelog":"- Update version to 3.0.1\n- Documentation cleanup in SKILL.md; no user-facing feature changes\n- No change in core functions or configuration","license":null},"metadata":null,"owner":{"handle":"mashirops","userId":"s17famez147nv7685638s9rqah884cxy","displayName":"Peng Shu","image":"https://avatars.githubusercontent.com/u/58142289?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089782860}}