忆时 - 记忆胶囊系统

> 模拟人类的记忆机制，让 AI 拥有会遗忘、会联想、会涌现、会封存的记忆系统。

> 详细流程参见 modules/ 目录。

触发条件

• 自动加载：每次对话自动激活，AI 主动联想和检索记忆
• 关键字：忆时、记忆检索、时间胶囊、记忆胶囊、回想、回忆、我说过、我记得
• 场景：用户询问过去的事情、要求回忆、需要上下文关联、触发闪回
• 主动：定时模式运行时主动扫描到期胶囊和记忆关联

核心概念

记忆类型

执行流程入口

1. 读取 modules/01-initialize.md - 初始化 Chroma
2. 读取 modules/02-passive-mode.md - 被动模式流程
3. 读取 modules/03-active-mode.md - 主动模式流程
4. 读取 modules/04-time-capsule.md - 时间胶囊操作
5. 读取 modules/05-retrieval.md - 类人检索策略
6. 读取 modules/06-import-export.md - 导入导出操作

核心命令

PY=/home/fslong/.config/opencode/skills/忆时/scripts/memory_core.py

初始化:    python3 $PY init
存储记忆:  python3 $PY store "内容" --type task --emotion high
检索记忆:  python3 $PY recall "查询" --limit 5 --expand
封胶囊:  python3 $PY capsule lock --unlock-at "2026-12-31"
查看胶囊:  python3 $PY capsule list
导入:      python3 $PY import-file file.md --format markdown
导出:      python3 $PY export --format timeline --output output.md
统计:      python3 $PY stats
遗忘:      python3 $PY forget --before "2025-01-01" --auto
恢复:      python3 $PY recover
查看备份:  cat memories_backup.jsonl | python3 -m json.tool --lines

项目结构

忆时/
├── SKILL.md                    # 技能定义 (入口)
├── yishi-instructions.md       # 外挂提示词 (必须配置到 opencode.json)
├── modules/                    # 详细流程模块
│   ├── 01-initialize.md        # Chroma 初始化
│   ├── 02-passive-mode.md      # 被动模式流程
│   ├── 03-active-mode.md       # 主动模式流程
│   ├── 04-time-capsule.md      # 时间胶囊操作
│   ├── 05-retrieval.md         # 类人检索策略
│   └── 06-import-export.md     # 导入导出操作
├── models/                     # embedding 模型
│   └── onnx.tar.gz             # 离线安装包 (80MB, 首次使用自动解压)
├── scripts/
│   └── memory_core.py          # 核心引擎 CLI
└── references/
    └── chroma-api.md           # ChromaDB API 参考

模型安装

本技能使用 all-MiniLM-L6-v2 embedding 模型。安装方式：

1. 有离线包 (models/onnx.tar.gz) → 首次调用时自动解压到 models/all-MiniLM-L6-v2/onnx/
2. 无离线包 → 自动从 Chroma S3 下载到 models/all-MiniLM-L6-v2/onnx/
3. 也可手动下载并解压至 models/all-MiniLM-L6-v2/onnx/

> ⚠️ 注意：模型文件永远存放在本技能目录下的 models/ 中，不会写入 ~/.cache/chroma/。即使执行 rm -rf ~/.cache/chroma 也不会影响已安装的模型。

使用说明

必须配置外挂提示词

本技能依赖 OpenCode 的 instructions 配置才能完整生效。

未配置时，AI 不会自动检索记忆或存储记忆。

配置步骤：

1. 编辑全局配置文件 ~/.config/opencode/opencode.json
2. 添加 instructions 字段，指向技能目录下的提示词文件：

{
  "instructions": [
    "~/.config/opencode/skills/忆时/yishi-instructions.md"
  ]
}

1. 重启 OpenCode 使配置生效

配置后 AI 将自动：

• 每次对话前检索记忆系统
• 用户说"记住"时自动存储记忆
• 话题关联时主动涌现历史记忆
• 对话结束时自动归档重点

未配置则：

• 技能仍可手动调用命令
• 但不会自动检索/存储记忆
• 不会主动联想和闪回

运行环境

• Python: 3.13+
• 依赖: chromadb 1.5.4
• 脚本: scripts/memory_core.py
• 数据: data/ (ChromaDB PersistentClient 自动创建)