📦 Secretary Memory — 秘书记忆

Secretary Memory - 秘书式记忆系统 v3.0 五大核心改进 改进 模块 触发时机

• 容量管理 capacity_管理器.py 每次 consolidation 时自动运行
• FTS5 + LLM 摘要 fts5_索引.py, 会话_搜索.py 搜索时或会话开始
• 跨会话召回 auto_loader.py OpenClaw 会话开始时
• 用户建模 user_模型.py 每次会话结束时增量
• 自动 技能 生成 技能-创建器/ 同一问题出现 ≥3 次

目录结构 memory/ # 根目录 ├── dAIly/ # 每日日志（7天内） ├── 归档/ # 归档（7天前） ├── agenda/ # 待办 ├── 性能分析/ # 用户偏好 ├── projects/ # 进行中项目 ├── knowledge/ # 知识沉淀 ├── scripts/ # 脚本目录 │ ├── 会话_summary.py # 会话摘要 │ ├── 上下文_loader.py # 上下文加载 │ ├── memory_搜索.py # 多分区搜索 │ ├── consolidate.py # 归档脚本 (集成容量管理) │ ├── capacity_管理器.py # [NEW] 容量管理 │ ├── fts5_索引.py # [NEW] FTS5 全文搜索 │ ├── 会话_搜索.py # [NEW] 统一搜索入口 │ ├── auto_loader.py # [NEW] 跨会话召回 │ ├── user_模型.py # [NEW] 用户关系图谱 │ ├── 性能分析_miner.py # 偏好提取 (集成用户图谱) │ ├── conflict_检测or.py # 冲突检测 │ ├── 恢复.py # 恢复/回溯 │ ├── 迁移.py # 迁移脚本 │ ├── realtime_监控.py # 实时监控 │ └── 技能-创建器/ # [NEW] 自动 技能 生成 │ ├── 技能.md │ └── auto_技能_生成器.py └── references/ └── SPEC.md

• 容量管理 (capacity_管理器.py)

自动检测 memory 目录容量，防止爆满。

# 检查容量（每次 consolidation 自动运行） python3 capacity_管理器.py --检查

# 详细输出 python3 capacity_管理器.py --verbose --warn

# 仅检查不执行 python3 consolidate.py --检查-capacity

# 自动归档触发检查 python3 capacity_管理器.py --auto

阈值配置：

指标 警告线 临界值 MEMORY.md 行数 80% (400行) 95% (475行) dAIly/ 文件数 80% (24个) 95% (28个) 归档/ 大小 80% (80MB) 95% (95MB)

• FTS5 + LLM 摘要 (fts5_索引.py, 会话_搜索.py)

基于 SQLite FTS5 的快速全文搜索，配合 LLM 总结结果。

# 构建 FTS5 索引（首次使用） python3 会话_搜索.py --build-索引

# FTS5 + LLM 摘要搜索 python3 会话_搜索.py "项目X 架构设计"

# 纯 FTS5（无 LLM） python3 会话_搜索.py "项目X" --no-llm

# 传统分区搜索 python3 会话_搜索.py "项目X" --classic

# 混合搜索（默认） python3 会话_搜索.py "项目X"

# 会话开始时召回 python3 会话_搜索.py "项目X" --上下文

# 查看索引统计 python3 会话_搜索.py --stats

# 优化数据库 python3 fts5_索引.py --vacuum

搜索策略：

fts5: 仅 FTS5 全文搜索（BM25 排序） classic: 传统分区搜索 hybrid: FTS5 + 经典搜索合并（默认）

• 跨会话召回 (auto_loader.py)

会话开始时自动加载相关记忆，按优先级排序。

# 命令行工具 用法 python3 auto_loader.py --topic "项目X 架构" python3 auto_loader.py --topic "项目X" --inject # 输出注入格式 python3 auto_loader.py --stats # 查看加载状态

# Hook 用法 python3 auto_loader.py --hook-启动 --会话-id {会话_id} --topic "项目X"

优先级算法：

综合得分 = 相关性 × 分区权重 × 时间加权

分区权重: agenda → 2.0 (最高) projects → 1.8 性能分析 → 1.5 knowledge → 1.2 dAIly → 1.0 归档 → 0.5 (最低)

时间加权: 7天内 → 1.5x 7天后 → 指数衰减，最少 0.3

• 用户建模 (user_模型.py)

从会话中提取实体和关系，构建用户知识图谱。

# 构建图谱 python3 user_模型.py --build

# 增量更新 python3 user_模型.py --更新

# 图谱统计 python3 user_模型.py --stats

# 按话题查询 python3 user_模型.py --查询 "项目X"

# 获取实体局部图谱 python3 user_模型.py --entity "Python" --depth 2

# 清理低频实体 python3 user_模型.py --vacuum

实体类型：

类型 权重 示例 user 2.0 用户、客户 project 1.8 项目、系统 techno记录y 1.5 Python、React person 1.3 开发者、工程师 preference 1.2 喜欢简洁回答 concept 1.0 架构、设计

关系类型： works_on, uses, manages, interested_in, collaborates_with

数据文件：

图谱：memory/.user_graph.json 统计：memory/.user_graph_stats.json

• 自动 技能 生成 (技能-创建器/)

检测复杂/重复任务，自动生成新 技能 封装解决方案。

# 检测复杂任务（扫描 dAIly/ 历史） python3 技能-创建器/auto_技能_生成器.py --检测

# 生成新 技能 python3 技能-创建器/auto_技能_生成器.py --生成 \ --name "task-追踪er" \ --pattern "task_追踪ing" \ --description "自动化任务追踪" \ --triggers "任务,todo,追踪" \ --steps "创建任务" "更新状态" "生成报告"

# 注册触发词 python3 技能-创建器/auto_技能_生成器.py --register \ --技能 "task-追踪er" --triggers "任务,todo"

# 查看统计 python3 技能-创建器/auto_技能_生成器.py --stats

# 列出已生成的 技能s python3 技能-创建器/auto_技能_生成器.py --列出

# 自我改进 python3 技能-创建器/auto_技能_生成器.py --improve

内置复杂模式识别：

模式 关键词 建议名称 task_追踪ing 任务、todo、追踪、待办 task-追踪er code_review 代码审查、review、PR code-review bug_triage bug、修复、问题 bug-triage meeting_notes 会议、meeting、纪要 meeting-notes data_analysis 分析、数据、报表 data-analysis doc_generation 文档、doc、生成 doc-生成器 test_generation 测试、test、用例 test-生成器 部署ment 部署、部署、发布 部署-辅助工具 API_de签名 API、接口、rest API-de签名er db_模式 数据库、模式、表结构 db-模式-管理器 原有脚本 会话摘要 会话_summary.py python3 会话_summary.py --会话 "今天讨论了..." --topics "项目X, 决策Y" python3 会话_summary.py --会话 "..." --dry-运行 # 预览 python3 会话_summary.py --watch # 实时监控追加

上下文加载 上下文_loader.py python3 上下文_loader.py "项目X 设计方案" python3 上下文_loader.py "项目X" --quiet python3 上下文_loader.py "项目X" --格式化 prompt

偏好提取 性能分析_miner.py python3 性能分析_miner.py --s