by 运行时依赖
安装命令
点击复制技能文档
Deep Memory（深层记忆） 分层记忆体系的第二层，负责结构化的知识与技能沉淀。日常高频信息存在 memory/ 和 MEMORY.md，遇到需要长期记住的概念、用法、经验时使用本层。 记忆层次决策树 区分 memory_search 和 deep-memory： memory_search（系统内置工具）只搜索 MEMORY.md 和 memory/（日常记忆层）。 查询技术/工具类内容（如 "@xxx 怎么用"）→ 走下面的决策树，先查 deep-memory。 不要用 memory_search 替代 deep-memory 查询流程。 用户问："我的 xxx 怎么用" / "之前那个 xxx 是在哪个文件" │ ├─→ 检查 MEMORY.md / memory/（日常记忆） │ └─→ 有 → 返回，无 → 继续 │ ├─→ 检查 DEEP-MEMORY.md 索引（关键字匹配） │ └─→ 命中 → 读取对应 deep-memory/.md │ └─→ 互联网搜索 什么时候用 deep-memory： 用户明确提到某个库、框架、工具的名称 想把读过的文档、博客、论文精华存起来备用 教用户某个知识点后，希望自己也能记住 用户说"把这个存到深层记忆" 什么时候用 MEMORY/memory： 日常会话中的事实、决定、上下文 用户偏好、习惯、项目进展 工作进度、非结构化的临时笔记 常见错误 不要用 memory_search 查 deep-memory： memory_search 是系统工具，只搜 MEMORY.md 和 memory/，不搜 DEEP-MEMORY.md 索引。 即使搜索结果为空，也不代表 deep-memory 里没有对应内容。 正确做法：手动读取 DEEP-MEMORY.md（索引表），匹配 keywords，再读对应文件。 不要跳过索引表直接搜记忆文件： deep-memory/ 下的文件没有全文索引，必须通过 DEEP-MEMORY.md 索引表定位。 直接遍历文件是无效的。 安装与初始化 skill 安装后需要运行初始化脚本，才能在workspace创建 DEEP-MEMORY.md 和 deep-memory/ 目录： node skills/depth-memory/scripts/setup.mjs 初始化脚本会自动： 创建 deep-memory/ 目录 写入一条验收测试记录（用于验证系统是否正常） 创建 DEEP-MEMORY.md 索引（若不存在） 将测试记录写入索引 验证： 初始化完成后，搜索关键字 深层记忆系统验收测试 或 验收测试，应能命中测试记录。 目录结构 deep-memory/ ← 记忆文件目录（setup.mjs 创建） 2026-04-27 13_06_20.md ← 格式：YYYY-MM-DD HH_MM_SS.md 2026-04-27 16_10_30.md ... DEEP-MEMORY.md ← 索引文件（setup.mjs 创建） memory/ ← 日常记忆（第一层） YYYY-MM-DD.md ← 每日笔记 MEMORY.md ← 长期记忆索引（第一层） skills/depth-memory/ SKILL.md ← 本文件 scripts/ setup.mjs ← 安装后初始化脚本（首次安装必运行） query.mjs ← 关键字检索 add.mjs ← 新增记忆（交互式 / 命令行） 工作流 查询流程
- 读取 DEEP-MEMORY.md（索引表）
- 从用户输入中提取关键字（@库名、英文术语、中文关键词）
- 遍历索引表格，匹配 Keywords 列：
- 完全相等 → 优先
- 包含匹配 → 次之
- 反向包含（关键字 → 条目关键词）→ 兜底
- 命中 → 读取对应 deep-memory/YYYY-MM-DD HH_MM_SS.md
- 无命中 → 互联网搜索
- 确定主题和关键字
- 将完整内容写入 deep-memory/YYYY-MM-DD HH_MM_SS.md （文件名用当前时间，格式固定）
- 提取关键字更新 DEEP-MEMORY.md 索引表 （在表头分隔线后插入新行，保持按关键词字母序或时间倒序）
- 可选：同步更新 memory/YYYY-MM-DD.md 记录本次操作
deep-memory/2026-05-05 17_49_00.md |
关键词提取原则：
必须包含库的正式名称（如 @k3000/store）
必须包含中文核心描述（1-2个词）
包含常用别名或相关术语
包含核心 API 或特性名称（可选）
用逗号分隔，不超过 10 个关键词
好的关键词示例：
@k3000/store, 结构化存储, 本地数据库, 二进制存储, 版本化存储
不好的关键词示例：
@k3000/store（缺少中文描述）
这个库很好用可以存很多东西（太模糊，无法检索）
脚本用法
query.mjs — 关键字检索
node scripts/query.mjs <关键字>
返回 JSON：
命中：{ found: true, keyword: "...", results: [{ keyword, description, filePath }] }
无命中：{ found: false, keyword: "..." }
匹配逻辑：
关键字 → 索引 Keywords 列（大小写不敏感，包含即命中）
兜底：索引 Keywords → 关键字（反向包含）
# 示例
node scripts/query.mjs @k3000/store
node scripts/query.mjs 结构化存储
add.mjs — 新增记忆条目
支持两种模式：
交互模式（不带参数）：
node scripts/add.mjs
# 按提示输入：标题 → 关键字 → 描述 → 内容（Ctrl+D 结束）
命令行模式（推荐在 agent 内使用）：
node scripts/add.mjs <标题> <关键字1,关键字2> <描述> [正文内容...]
# 注意：正文内容为空格分隔，多行内容需用 stdin 或直接写文件
实际 agent 用法：
直接用 write 工具写文件 + 手动编辑 DEEP-MEMORY.md，比调用脚本更可控。
list-index.mjs
此脚本目前不存在。
如需列全部索引，直接读取 DEEP-MEMORY.md 即可。
记忆文件格式规范
每个 deep-memory/YYYY-MM-DD HH_MM_SS.md 文件应包含：
# <标题>
来源：
存入时间：