Memory

跨会话的长期记忆 — 搜索、读取、保存。Memory 技能为 CLI-JAW 提供持久化的回忆能力，包括用户偏好、项目决策以及跨越单次对话的持久知识。

快速参考

概述

memory 技能是 CLI-JAW 的持久化知识层。它使 AI 能够跨会话记住事实、偏好和决策，而不仅仅依赖对话上下文。每个会话都会自动注入 memory 技能 — 无需手动加载。

Memory 在两个作用域下运行：

规则

Memory 技能遵循七条严格规则，规范何时以及如何使用记忆：

命令

搜索

在记忆索引中搜索关键词。返回匹配的条目及其源文件路径。

# 基本关键词搜索
cli-jaw memory search "keyword"

# 搜索用户偏好
cli-jaw memory search "user preference"

# 搜索错误代码或技术术语
cli-jaw memory search "auth login 401"

# 搜索系统/服务相关术语
cli-jaw memory search "launchd plist service"

# 跨实例搜索（L2 仪表盘，只读）
cli-jaw dashboard memory search "cross-instance topic"

读取

读取特定记忆文件的完整内容，或其中的指定行范围。

# 读取用户档案
cli-jaw memory read structured/profile.md

# 读取语义知识文件
cli-jaw memory read structured/semantic/cli-jaw.md

# 读取情景记忆条目
cli-jaw memory read structured/episodes/live/2026-03-07.md

# 仅读取指定行（适用于大文件）
cli-jaw memory read structured/profile.md --lines 1-30

保存

将持久事实追加到记忆文件中。内容是追加写入，不会覆盖原有内容。

# 将用户偏好保存到档案
cli-jaw memory save structured/profile.md "- User prefers Korean UI and English code"

# 将技术事实保存到语义文件
cli-jaw memory save structured/semantic/cli-jaw.md "- Memory runtime uses task snapshots before response generation"

# 保存有时间标记的情景记忆
cli-jaw memory save structured/episodes/live/2026-03-07.md "## 16:30\n- Decided to remove query-provider setup from memory UX"

列表 & 初始化

用于检查和初始化记忆目录的实用命令。

# 列出所有记忆文件及其大小
cli-jaw memory list

# 初始化记忆目录结构（首次设置）
cli-jaw memory init

存储布局

记忆被组织为 ~/.cli-jaw/memory/ 下的结构化目录层级。每个子目录有不同的用途：

~/.cli-jaw/memory/
  structured/
    profile.md                          # 用户偏好和身份
    index.sqlite                        # 全文搜索索引
    episodes/
      live/
        2026-03-07.md                   # 每日情景条目
        2026-05-29.md
    semantic/
      cli-jaw.md                        # CLI-JAW 相关知识
      deployment.md                     # 部署流程
      project-architecture.md           # 架构决策
    procedures/
      release-checklist.md              # 可重用的工作流
      code-review-process.md
    sessions/
      session-2026-05-29-abc123.md      # 自动提取的会话笔记

工作流

Memory 技能定义了四种标准工作流，规范在对话中如何使用记忆。

新对话

当新会话开始时：

用户提到偏好

当用户表达偏好时（例如，"我喜欢用 Tab 而不是空格"）：

用户问"你记得...吗？"

当用户询问之前是否讨论过某事时：

重要会话结束时

当会话产生了重要的决策或结果时：

使用示例（~해줌）

以下是 CLI-JAW 能理解的、以自然韩语风格编写的实际使用模式。

应该保存 vs. 应该跳过

选择正确的目标路径

保存事实时，根据信息的性质选择目标路径：

搜索技巧

记忆搜索索引支持全文关键词匹配。为获得最佳结果：

• 使用两种语言 — 如果用户使用双语工作，请同时搜索"auth"和"인증"
• 包含错误代码 — 搜索"401 unauthorized"以查找与认证相关的记忆
• 尝试文件名 — 搜索"launchd"或"plist"以查找系统服务相关的记忆
• 先精确后宽泛 — 先搜索"Cloudflare D1 migration"，然后回退到"database migration"
• 搜索符号 — 错误代码如"ECONNREFUSED"或配置键如"JAW_HOME"均已被索引

注意事项

• 优先使用简洁、持久的条目，避免冗长的日志
• 按照惯例，记忆是仅追加的 — 保存命令追加内容，不会覆盖
• 搜索索引（index.sqlite）在文件保存时自动维护
• 跨实例（L2）记忆始终是只读的；你无法保存到其他实例
• 如果你的实例启用了嵌入搜索，它是关键词搜索的补充而非替代

相关内容

• 概念：记忆 — 记忆系统架构的高层概述
• CLI 命令 — 完整的 cli-jaw memory 命令参考
• 仪表盘指南 — L2 仪表盘记忆和跨实例联合查询
• 技能目录 — 浏览代表性技能目录
• 生产力技能 — 记忆及相关技能的分类页面