核心用法
Super Memori 是面向 OpenClaw 代理的本地优先混合记忆技能，通过四个公共命令实现全周期记忆管理：
- 健康检查 (
./health-check.sh)：前置安全闸门，返回 OK/WARN/FAIL 状态，决定是否继续操作 - 智能查询 (
./query-memory.sh --mode auto)：自动选择最强可用检索路径（词法/语义/混合/学习记忆），JSON 输出包含mode_used、degraded、warnings等关键字段 - 持久化记忆 (
./memorize.sh)：仅用于可复用的决策规则、参数集或失败模式，支持关系化链接 - 索引维护 (
./index-memory.sh)：重建词法/向量索引，修复新鲜度问题
运行时自动降级：当语义依赖（sentence-transformers、Qdrant、本地模型）缺失时，无缝回退至词法模式并显式报告状态。
显著优点
1. 双重检索架构：SQLite FTS5 词法检索 + Qdrant 向量语义检索，Reciprocal Rank Fusion 混合融合，兼顾精确匹配与语义理解
2. 四级记忆类型：情景记忆、语义知识、程序性技能、学习记忆全覆盖
3. 强制安全契约：健康检查前置、退出码严格解释、降级状态标准化输出（D-WARN-* 目录），防止弱模型误用
4. 变更审计追踪：change-memory 记录区分 applied/failed/reverted/unverified 状态，支持操作回滚
5. 本地隐私优先：无云后端、无远程嵌入端点、无自动破坏性操作，数据驻留本地 Ubuntu 主机
潜在局限
- 主机依赖性强：语义能力需手动安装 Python 依赖并启动 Qdrant 服务，无法"开箱即用"
- 弱模型约束多：操作路径受限（禁用内部脚本、禁止手动后端选择），高阶功能需维护模式
- 索引新鲜度风险：非实时同步，需定期
./index-memory.sh维护，WARN 状态下结果可能遗漏近期变更 - 无分布式能力：纯单机设计，不支持多代理共享或跨主机记忆同步
适合人群
- 运行 OpenClaw 或其他本地代理框架的开发者
- 需要长期上下文保持的自动化运维/开发助手场景
- 对数据隐私敏感、要求完全离线记忆栈的企业用户
- 具备 Linux/Ubuntu 运维能力、能接受手动依赖管理的团队
常规风险
| 风险场景 | 缓解机制 |
|---------|---------|
| 语义依赖缺失导致检索失效 | 自动降级至词法模式，显式 `degraded=true` 标注 |
| 索引陈旧遗漏最新记忆 | `D-WARN-INDEX-STALE-ONLY` 提示，需手动重建 |
| 降级状态下误信低权威性结果 | `D-LOW-AUTHORITY` 规则强制标注启发式结果 |
| 写入操作无回滚保护 | 前置检查 git/备份状态，WARN 时追加 `D-WARN-WRITE-ROLLBACK` |
| 健康 FAIL 仍强制操作 | 退出码 3 触发 `D-FAIL`，硬性阻断后续操作 |