核心内容摘要
漫画脸描述生成从零开始：学生党用笔记本GPU跑通Qwen3-32B全流程
Cursor-memory-cli 自动化记忆提取的完整实现一个用于安装和配置 Cursor Memory 系统的命令行工具。
Cursor Memory 是一个持续学习系统可以从 Cursor 会话中提取结构化记忆并将其编码为可查询的 JSON 记录供跨会话调用。
基于 Cursor Memory 实战如何终结 AI 助手的“金鱼记忆” 的理论方案完整落地自动化cursor-memory-cli工具。
仓库地址cursor-memory-cli目录概述安装快速开始安装组件说明
使用方法记忆类型存储结构配置说明
常见问题概述Cursor Memory 系统通过以下机制工作Hook 触发在每次提交 prompt 前自动触发记忆评估提醒Skill 自主执行cursor-memory skill 独立完成记忆分析、提取和存储结构化提取提取决策、洞察、模式、纠正等多种类型的记忆持久化存储将记忆保存为结构化 JSON 文件便于后续查询Skill 与 Command 的关系cursor-memory skill核心组件自主完成记忆的分析、提取和存储无需调用外部命令catch-memory command手动补充工具供用户在需要时显式触发记忆提取核心特性自动触发通过 Cursor hooks 机制自动触发记忆评估智能去重同一会话的多次提取会自动合并到同一文件质量过滤仅保留置信度 50 的高价值记忆结构化存储按日期组织的 JSON 文件便于检索安装前置要求Node.js 18Cursor Editor运行安装命令node~/.cursor/cli/cursor-memory-cli/index.mjs setup安装模式CLI 支持两种安装模式全局模式推荐适用于所有项目配置存储在~/.cursor/目录node~/.cursor/cli/cursor-memory-cli/index.mjs setup --global本地模式仅适用于当前项目配置存储在项目的.cursor/目录node~/.cursor/cli/cursor-memory-cli/index.mjs setup --local交互式选择如果不指定模式CLI 会提示你选择node~/.cursor/cli/cursor-memory-cli/index.mjs setup? Where would you like to install cursor-memory? ❯ Global (~/.cursor/) - applies to all projects Local (./.cursor/) - applies to current project only快速开始
安装 Cursor Memory# 全局安装推荐node~/.cursor/cli/cursor-memory-cli/index.mjs setup --global安装完成后会显示[ok] cursor-memory setup complete! Components installed: - hooks.json (merged) - hooks/cursor-memory-reminder.sh (executable) - skills/cursor-memory/ (SKILL.md, README.md) - commands/catch-memory.md
重启 Cursor安装完成后重启 Cursor 以加载新的 hooks 配置。
开始使用现在每次与 Cursor Agent 交互时系统会自动评估是否需要提取记忆。
cursor-memory skill 会自主完成记忆的分析、提取和存储。
如果需要手动触发记忆提取可以使用命令/catch-memory安装组件说明CLI 会安装以下组件
hooks.json配置 Cursor 在提交 prompt 前触发记忆提醒钩子。
{version:1,hooks:{beforeSubmitPrompt:[{command:~/.cursor/hooks/cursor-memory-reminder.sh}]}}注意如果已有hooks.jsonCLI 会智能合并配置不会覆盖现有的 hooks。
cursor-memory-reminder.sh位于hooks/目录的可执行脚本负责在每次交互前注入记忆评估提醒规则创建临时规则文件rules/cursor-memory-reminder.mdc提示 Agent 评估当前会话是否产生了值得保留的记忆
cursor-memory skill位于skills/cursor-memory/目录包含SKILL.md技能定义文件描述何时激活及工作流程references/TYPES.md10 种记忆类型和 12 种实体类型的定义references/STORAGE.md存储格式和去重逻辑说明
catch-memory 命令手动补充位于commands/catch-memory.md作为手动触发记忆提取的补充工具。
注意cursor-memory skill 已具备独立完成记忆提取的能力此命令主要用于用户需要显式控制时使用。
使用方法自动模式推荐安装完成后cursor-memory skill 会在以下情况自动评估并提取记忆解决了复杂的调试问题通过试错找到了可行的解决方案用户纠正了 Agent 的假设或方法做出了重要的架构或技术决策发现了跨会话相关的洞察Skill 会自主完成记忆的分析、提取和存储到./memories/目录无需用户干预。
手动触发补充方式当需要显式控制记忆提取时可以在 Cursor 中使用命令/catch-memory分析当前会话并提取记忆。
分析特定会话文件/catch-memory /path/to/session-file.json适用场景希望立即提取记忆而不等待自动评估需要分析历史会话文件调试记忆提取功能显式请求你也可以直接对 Agent 说“Save memories”保存记忆“Remember this”记住这个“What did we learn?”我们学到了什么记忆类型Cursor Memory 支持 10 种记忆类型类型说明示例decision在备选方案之间做出的选择及其推理选择 Vercel 而非 Netlify 部署因为 Next.js 集成更好insight跨会话相关的发现发现遗留认证服务需要特定的 header 格式confidence完整性或确定性评估高置信度认为数据库迁移是安全的pattern_seed可能演变为模式的早期观察用户经常要求在实现前先用 Jest 写测试commitment对未来工作的承诺或期望承诺在 API 变更后更新文档learning技术或系统学习发现 API 速率限制是 100 req/min而非 1000correction用户对 Agent 行为的纠正用户纠正了使用 Redux 的假设实际使用 Zustandcross_agent给其他 Agent 的信息给未来 Agent 的
注意事项运行集成测试前必须 seed 测试数据库workflow_note偏离默认工作流的情况及原因由于时间限制跳过了此热修复的单元测试gap发现的缺失信息或能力缺少 staging 环境的访问凭证置信度评分每条记忆必须包含置信度评分
记录中的明确陈述
从上下文强烈暗示
带有不确定性的合理推断 50不提取太不确定存储结构文件位置记忆存储在当前工作目录的./memories/目录下./memories/ ├──
/ │ ├──
-fix-auth-bug.json │ └──
-api-refactor.json ├──
/ │ └──
-database-migration.jsonJSON 结构{session_id:
-fix-auth-bug,timestamp:
T14:30:00Z,last_updated:
T15:45:00Z,extraction_count:2,memories:[{type:decision,category:technical,title:选择 JWT 而非 Session 进行认证,content:决定使用 JWT 进行 API 认证因为需要支持移动端和无状态的微服务架构,source_chunk:**User:** 我们应该用什么方式做认证\n**Assistant:** 考虑到需要支持移动端...,reasoning:JWT 更适合分布式系统和移动端场景,alternatives:[{option:Session,why_not:需要服务端状态不适合微服务}],selected_option:JWT,confidence_score:95,related_entities:[{type:project,raw:auth-service,slug:auth-service,resolved:true}],tools_mentioned:[],urls_mentioned:[],target_agents:[]}],suggestions:[]}单会话单文件机制同一会话的多次记忆提取会自动合并到同一个文件会话标识基于会话开始时间生成稳定的 session_id智能去重基于(type, title)和内容相似度去重版本选择保留置信度更高的版本元数据更新更新last_updated和extraction_count配置说明hooks.json 配置如果需要自定义 hooks 配置可以编辑hooks.json{version:1,hooks:{beforeSubmitPrompt:[{command:~/.cursor/hooks/cursor-memory-reminder.sh},{command:其他 hook 命令}]}}调整记忆提取行为编辑skills/cursor-memory/SKILL.md可以调整激活触发条件记忆质量标准提取数量限制
常见问题Q: 安装后 hook 没有触发A: 请确保重启了 Cursorhooks/cursor-memory-reminder.sh有执行权限chmod xhooks.json语法正确Q: 记忆文件存储在哪里A: 记忆存储在当前工作目录的./memories/目录下按日期组织。
Q: 如何查看提取的记忆A: 直接查看./memories/YYYY-MM-DD/目录下的 JSON 文件。
Q: 可以禁用自动记忆提取吗A: 可以删除或注释hooks.json中的cursor-memory-reminder.sh条目即可。
Q: 全局安装和本地安装有什么区别A:全局安装~/.cursor/对所有项目生效本地安装./.cursor/仅对当前项目生效优先级更高Q: 如何更新 cursor-memory-cliA: 重新运行安装命令即可CLI 会智能合并配置而不会丢失现有设置。
命令参考Usage: node cli/cursor-memory-cli/index.mjs setup [--global|--local] Commands: setup Install cursor-memory components Options: --global Install to ~/.cursor/ (user-level) --local Install to ./.cursor/ (project-level) --help Show help message技术架构cursor-memory-cli/ ├── index.mjs # CLI 入口 ├── lib/ │ ├── constants.mjs # 常量定义 │ ├── copy.mjs # 文件复制工具 │ ├── hooks.mjs # hooks.json 合并逻辑 │ ├── logger.mjs # 日志输出 │ ├── setup.mjs # 安装流程 │ └── ui.mjs # 交互式 UI └── templates/ ├── hooks.json # hooks 配置模板 ├── hooks/ │ └── cursor-memory-reminder.sh # hook 脚本 ├── skills/ │ └── cursor-memory/ # 技能定义 │ ├── SKILL.md │ └── references/ │ ├── TYPES.md │ └── STORAGE.md └── commands/ └── catch-memory.md # 命令定义LicenseMIT