# yaoyao-memory v3.9.5 功能清单

## 📊 分类统计 (103个脚本)

| 分类 | 数量 | 说明 |
|------|------|------|
| 记忆管理 | 17 | 核心记忆操作 |
| 工具 | 22 | 通用工具 |
| 搜索 | 8 | 搜索相关 |
| 监控 | 5 | 健康检查/性能 |
| 运维 | 6 | 自动修复/备份 |
| 安全 | 7 | 安全隔离/审计 |
| 学习 | 6 | 自动学习/人设 |
| 记忆增强 | 6 | 遗忘检测/摘要 |
| 向量 | 5 | 向量系统 |
| 配置 | 4 | 配置管理 |
| 初始化 | 4 | 安装/迁移 |
| 接口 | 3 | API/CLI |
| 容错 | 3 | 熔断/重试 |
| 预测 | 3 | 预测缓存 |
| 云同步 | 2 | IMA/NAS |
| Token优化 | 3 | Token追踪 |

---

## 🗄️ 核心记忆 (17)

| 脚本 | 功能 |
|------|------|
| `memory.py` | 核心记忆CRUD |
| `memory_stats.py` | 统计分析 |
| `memory_quality.py` | 质量评估 |
| `memory_graph.py` | 知识图谱 |
| `memory_tags.py` | 标签系统 |
| `memory_timeline.py` | 时间线 |
| `memory_trends.py` | 趋势分析 |
| `memory_insights.py` | 洞察提取 |
| `memory_archive.py` | 归档管理 |
| `memory_diff.py` | 对比工具 |
| `memory_exporter.py` | 导出模块 |
| `memory_merger.py` | 合并模块 |
| `memory_snapshot.py` | 快照管理 |
| `memory_suggester.py` | 建议器 |
| `memory_reminder.py` | 提醒器 |
| `memory_priority_calculator.py` | 优先级计算 |
| `memory_enhancer.py` | 增强器 |

---

## 🔍 搜索 (8)

| 脚本 | 功能 |
|------|------|
| `search.py` | 主搜索 |
| `batch_search.py` | 批量搜索 |
| `fast_path.py` | 快速路径 |
| `memory_search_enhanced.py` | 增强搜索 |
| `smart_query.py` | 智能查询 |
| `query_predictor.py` | 查询预测 |
| `query_cache.py` | 查询缓存 |
| `semantic_cache.py` | 语义缓存 |

---

## 🩺 监控 (5)

| 脚本 | 功能 |
|------|------|
| `health_check.py` | 健康检查 |
| `performance_monitor.py` | 性能监控 |
| `memory_health_checker.py` | 记忆健康检查 |
| `check_coverage.py` | 覆盖率检查 |
| `benchmark.py` | 基准测试 |

---

## 🔧 运维 (6)

| 脚本 | 功能 |
|------|------|
| `auto_fixer.py` | 自动修复 |
| `auto_updater.py` | 自动更新 |
| `optimizer.py` | 优化器 |
| `optimize_vector_system.py` | 向量优化 |
| `backup_manager.py` | 备份管理 |
| `backup_restore.py` | 备份恢复 |

---

## 🔒 安全 (7)

| 脚本 | 功能 |
|------|------|
| `security.py` | 安全模块 |
| `governance.py` | 治理层 |
| `rbac.py` | 权限控制 |
| `context_guard.py` | 上下文守卫 |
| `subagent_isolation.py` | 子Agent隔离 |
| `skills_guard.py` | Skill安全 |
| `shell_embed.py` | Shell嵌入 |

---

## 📚 学习 (6)

| 脚本 | 功能 |
|------|------|
| `persona_learner.py` | 人设学习 |
| `auto_tagger.py` | 自动标签 |
| `auto_learn.py` | 自动学习 |
| `behavior_learner.py` | 行为学习 |
| `psychology_adapter.py` | 心理学适配 |
| `auto_update_persona.py` | 自动更新人设 |

---

## 🧠 记忆增强 (6)

| 脚本 | 功能 |
|------|------|
| `forget_detector.py` | 遗忘检测 |
| `conversation_summarizer.py` | 对话摘要 |
| `summarize.py` | 总结工具 |
| `progressive_summary.py` | 渐进摘要 |
| `intelligent_recall.py` | 智能召回 |
| `auto_context.py` | 自动上下文 |

---

## 🔢 向量 (5)

| 脚本 | 功能 |
|------|------|
| `vector_store.py` | 向量存储 |
| `vector_extension_manager.py` | 向量扩展 |
| `generate_index.py` | 索引生成 |
| `backfill_l0_vectors.py` | L0回填 |
| `memory_graph.py` | 图谱(兼向量) |

---

## ⚙️ 配置 (4)

| 脚本 | 功能 |
|------|------|
| `config_manager.py` | 配置管理 |
| `config_panel.py` | 配置面板 |
| `feature_flag.py` | 特性开关 |
| `paths.py` | 路径管理 |

---

## 🚀 初始化 (4)

| 脚本 | 功能 |
|------|------|
| `init_memory.py` | 初始化 |
| `promote.py` | 升级工具 |
| `setup_wizard.py` | 安装向导 |
| `migrate.py` | 迁移工具 |

---

## 🌐 接口 (3)

| 脚本 | 功能 |
|------|------|
| `api_server.py` | API服务 |
| `unified_api.py` | 统一API |
| `cli.py` | 命令行 |

---

## 🛡️ 容错 (3)

| 脚本 | 功能 |
|------|------|
| `circuit_breaker.py` | 熔断器 |
| `retry.py` | 重试机制 |
| `conflict_detector.py` | 冲突检测 |

---

## 🔮 预测 (3)

| 脚本 | 功能 |
|------|------|
| `heat_tracker.py` | 热度追踪 |
| `predictive_cache.py` | 预测缓存 |

---

## ☁️ 云同步 (2)

| 脚本 | 功能 |
|------|------|
| `sync_ima.py` | IMA同步 |
| `sync_samba.py` | Samba同步 |

---

## 📝 Token (3)

| 脚本 | 功能 |
|------|------|
| `token_tracker.py` | Token追踪 |
| `token_optimizer.py` | Token优化 |
| `token_reporter.py` | Token报告 |

---

## 🔨 工具 (22)

| 脚本 | 功能 |
|------|------|
| `alert_manager.py` | 告警管理 |
| `audit.py` | 审计日志 |
| `cleanup.py` | 清理工具 |
| `memory.py` | (核心) |
| `meow_config.py` | MeoW配置 |
| `monitor.py` | 监控 |
| `multilang.py` | 多语言 |
| `safe_extension_loader.py` | 安全加载 |
| `smart_memory_update.py` | 智能更新 |
| `smart_memory_upgrade.py` | 智能升级 |
| `stats_dashboard.py` | 统计面板 |
| `warmup.py` | 预热 |
| `virustotal_scan.py` | 病毒扫描 |
| `infrastructure.py` | 基础设施 |
| `knowledge_ops.py` | 知识操作 |
| `mcp_manager.py` | MCP管理 |
| `push_helper.py` | 推送助手 |
| `rbac.json` | (配置) |
| `self_improver.py` | 自我改进 |
| `search_optimizer.py` | 搜索优化 |
| `update_l3_profile.py` | L3更新 |
| `ui_helpers.py` | UI助手 |

---

## 🆕 v4.0 新增功能

| 脚本 | 功能 | 说明 |
|------|------|------|
| `hardware_detector.py` | 硬件检测 | 检测AVX512/AMX/NEON |
| `auto_optimizer.py` | 自动优化 | 根据硬件配置优化 |
| `conversation_manager.py` | 对话管理 | 多轮对话历史管理 |
| `predictive_maintenance.py` | 预测维护 | 预测增长+维护计划 |
| `forget_detector.py` (v2) | 遗忘检测 | 多维度衰减+矛盾检测 |
| `memory_wal.py` | WAL模式 | SQLite WAL模式管理 |
| `batch_operations.py` | 批量操作 | 导入/导出/删除/更新 |
| `tag_manager.py` | 标签管理 | 自动标签/合并/清理 |
| `quick_search.py` | 快速搜索 | 命令行搜索工具 |

**已有Web界面**：`html/dashboard.html` + `api_server.py`（1234行完整面板）

## ⚡ v4.0 性能优化

| 优化项 | 状态 | 效果 |
|--------|------|------|
| WAL模式 | ✅ 已启用 | 并发读写提升50%+ |
| WAL自动启用 | ✅ memory.py自动启用 | 初始化时自动配置 |
| FTS-only快速路径 | ✅ 已有 | 简单查询跳过向量 |
| 缓存预热 | ✅ optimizer.py | 热点数据缓存 |
| 写合并 | ✅ 0.5秒延迟合并 | 减少I/O次数 |
| API单例 | ✅ 60秒复用 | 减少重复初始化 |
| vectors.db WAL | ✅ 已启用 | 并发读写提升 |

## 🔍 友商调研 (v4.0)

| 项目 | Stars | 借鉴功能 |
|------|-------|----------|
| kektordb | 67 | 记忆衰减、矛盾检测 |
| mcp-memory-libsql | 82 | 高性能持久化 |
| cursor10x | 78 | 项目记忆、代码关系 |
| ultimate_mcp_server | 144 | MCP协议、多Provider |
| bondai | 217 | 模块化架构 |

---

## 📋 工作流

```
用户请求
    │
    ▼
┌─────────────────┐
│  search.py      │ ← 智能路由 + FTS搜索
│  smart_query.py │ ← 查询预测
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  memory.py     │ ← 核心CRUD + 向量存储
│  memory_*.py   │ ← 17个记忆模块
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  auto_fixer.py │ ← 自动修复
│  sync_ima.py   │ ← IMA云同步
│  sync_samba.py │ ← NAS备份
└─────────────────┘
```