Proma Memory

Proma 的长期记忆与主动智能系统插件 — 帮助 Proma 更好地"看见"你，成为更懂你的 Agent 助手

这是什么

Proma Memory 是为 Proma 桌面 AI 助手提供的长期记忆与主动智能系统插件。它的核心理念是：更敏锐地看到用户，更主动地帮助用户。

AI 助手不该只是被动地等待指令。Memory 通过持续观察用户的日常对话，逐步理解用户是谁、在做什么、怎样工作；然后在合适的时机，主动提供更贴合的帮助。这些记忆不是冷冰冰的数据库条目，而是一套有温度的、持续演化的认知模型。

当前状态

🚧 原型阶段 — 该插件当前仅为 Demo 阶段，还有非常多的功能未做，也还没经过足够的测试，以帮助其效果迭代和演化；暂时的计划是在后续跟随 Proma 插件系统一起上线，当前仅能够通过独立的工作区 + Skill 运行体验。

接入方式

这个仓库支持作为外置插件接入其他用户的 Proma 环境，与 Proma 项目环境完全隔离，装载和卸载无任何影响。

步骤一：安装插件

在 Proma 任意 Agent 模式工作区新建会话，把以下 prompt 完整粘贴发送给 Agent：

任务：帮我接入 Proma Memory 插件。

步骤如下，请依次执行：

1. 先确定 clone 目标位置（即后续的 $PROJECT_DIR，表示绝对路径）：
   - 平台默认路径是：
     · macOS：~/Documents/GitHub/Proma_Proactive
     · Windows：%USERPROFILE%\Documents\GitHub\Proma_Proactive
     · Linux：~/Projects/Proma_Proactive
   - 可能我有其它想存储该插件项目的位置；
   - 向我询问，待我确认后再继续。

2. Clone 仓库：
   mkdir -p "$(dirname $PROJECT_DIR)" && git clone https://github.com/SheldonLiu0412/Proma_Proactive.git "$PROJECT_DIR"

3. 检查依赖（缺失时自动为我安装）：
   cd "$PROJECT_DIR" && node --version && (npx tsx --version || npm install)

4. 构建所有 skills ：
   cd "$PROJECT_DIR" && node build.mjs

5. 把 memory-setup skill 复制到当前工作区的 skills 目录（由你确认）：
   mkdir -p "$HOME/.proma/agent-workspaces/<当前工作区slug>（或者可以叫做工作区name，不是会话目录名）/skills/memory-setup" && cp "$PROJECT_DIR/skills/memory-setup/SKILL.md" "$HOME/.proma/agent-workspaces/<当前工作区slug>/skills/memory-setup/SKILL.md"

6. 完成后告诉我，询问是否开始 memory-setup 流程。

注意：
- 不要跳步或是提前询问
- 由于实际工作的目录位置在变化，始终使用上述过程中规定的绝对路径

Agent 会自动完成位置选择、clone、构建、复制，并在需要时询问你工作区名称。

步骤二：配置插件

上一步完成后，在同一个会话里发送：

memory-setup

Agent 会引导你创建 Memory 工作区，并自动同步所有 Memory 相关的 Skills 到该工作区，完成后会告知后续如何初始化和使用。

已实现功能

Memory Init（全量初始化）

首次引入 Memory 时，从用户全部历史会话中构建初始记忆：

• 批量收集历史会话，按时间顺序分批处理，支持全量重建
• 通过 SubAgent 协作完成大规模会话分析

Memory Init Review（初始化自审查）

Init 完成后自动触发，对生成的记忆文件进行质量审查与修正：

• 逐类检查画像、纠偏、SOP、日记、变更日志的格式与内容
• 发现问题直接修正，输出审查报告

Memory Daily（每日记忆整合）

每天运行一次，从当日对话中提取长期记忆：

产物	说明
profile.md	以 Proma 视角书写的用户画像，wiki 式分级结构
corrections/	从用户对 Agent 的纠正中提炼的可复用行为改进
sop-candidates/	从重复性工作中提炼的流程模板
memory_log/	结构化的每日记忆变更记录
diary/	Proma 第一人称视角的散文日记

工作流分阶段执行：收集（Gather）→ 分析（Analyze）→ 整合（Consolidate），通过 TypeScript 工具脚本 + Proma Agent Skill 协作完成。

Memory Search（记忆检索）

随时召回用户的长期记忆：

• 接收自然语言查询，LLM 自动分析检索意图和范围
• 精准读取相关记忆文件（profile、corrections、SOP、diary、memory_log），避免全量加载
• LLM 基于读取的上下文生成精准回答，纯文本输出

Memory Edit（记忆操作）

随时修改用户的长期记忆，有如下特性：

• 多操作批量映射：一个指令可触发多个操作（如"添加纠偏 A 并删除 SOP B"）
• 自行目标匹配：用自然语言描述即可定位目标（如"删除讲不要催复的那条 correction"）
• 列出完整记忆目录结构（--list）

操作类型	支持的动作	执行方式
Profile	编辑指导	脚本返回具体规范和建议，Agent 手动 Edit
Correction	add / edit / delete	脚本直接修改
SOP	delete（仅删除）	脚本直接删除

规划中的能力

模块	说明	状态
每日 Memory 汇报	向用户推送今日记忆变更摘要，支持确认/修正	📋 规划中
纠偏 → Skill 更新	corrections 中通过的条目自动触发 Skill 内容更新任务	📋 规划中
周回顾与校正	每周回顾记忆质量，清理过时条目，校正偏差	📋 规划中
SOP → Skill 自动转化	当 SOP 候选被多次验证后，自动生成可执行的 Skill	📋 规划中
主动记忆装载	在日常对话中智能装载相关记忆，让助手的回应自然地体现"认识你"	📋 规划中
可自定义的记忆维度	用户可选择哪些记忆维度参与当前对话	📋 规划中

项目结构

源码目录

components/              # 可复用 Skill 组件（markdown 片段）
├── head.md              # 通用头部
├── memory-search/       # 记忆检索 Skill 组件
│   ├── head.md
│   ├── instruction.md
│   └── complete.md
├── memory-edit/         # 记忆操作 Skill 组件
│   ├── head.md
│   ├── instruction.md
│   └── complete.md
├── setup-head.md            # memory-setup 开头
├── setup-instance.md        # memory-setup 实例安装指令
├── setup-complete.md        # memory-setup 结束标志
├── sessions-gather-today.md  # 收集今日会话
├── sessions-gather-all.md    # 收集全量历史会话
├── memory-load.md            # 加载当前记忆
├── sessions-analyze.md       # 分析会话
├── corrections-extract.md    # 提取行为纠偏
├── sop-update.md             # 更新 SOP 候选
├── memory-log-write.md       # 写入变更日志
├── diary-write.md            # 写入散文日记
├── memory-bootstrap.md       # 初始化/重建记忆目录
├── profile-update.md    # 增量更新画像
├── profile-rules.md     # 用户画像规范
├── dream.md             # 生成梦境（默认未启用，如需开启在 skill-configs/memory-daily.json 的 components 数组末尾加入 "dream" 即可）
├── init-batch-analysis.md    # 批量分析（init 用）
├── daily-batch-analysis.md   # 批量分析（daily 用，NeedsBatching 模式）
├── daily-complete.md         # Daily 结束标志
├── init-complete.md          # Init 结束标志
├── guide/               # 指南专用组件
│   ├── head.md
│   ├── principles.md
│   └── state-complete.md
└── review/              # Init Review 专用组件
    ├── head.md
    ├── profile.md
    ├── corrections.md
    ├── sop.md
    ├── diary.md
    ├── memory-log.md
    └── footer.md

skill-configs/           # Skill 组装配置（JSON）
├── memory-setup.json
├── memory-daily.json
├── memory-init.json
├── memory-init-review.json
├── memory-search.json   # 记忆检索 Skill 配置
├── memory-edit.json     # 记忆操作 Skill 配置
└── memory-agent-guide.json

config/
├── llm-config.json              # LLM API 配置（ Anthropic 兼容格式）
├── memory-instance.template.json  # 实例配置模板
└── memory-instance.local.json     # 本机实例配置（git ignore）

skills/                  # 组装输出目录（构建产物，不提交 git，clone 后运行 node build.mjs 生成）
├── memory-setup/
│   └── SKILL.md
├── memory-daily/
│   └── SKILL.md
├── memory-init/
│   └── SKILL.md
├── memory-init-review/
│   └── SKILL.md
├── memory-search/       # 记忆检索 Skill（构建产物）
│   └── SKILL.md
└── memory-edit/         # 记忆操作 Skill（构建产物）
    └── SKILL.md

docs/
└── memory-agent-guide.md   # SubAgent 完整工作规范

src/
├── scripts/
│   ├── gather-sessions.ts        # 收集今日活跃会话（支持 --with-digests 自动提取摘要、--plan-batches 自动分批）
│   ├── gather-all-sessions.ts    # 收集全量历史会话（初始化用）
│   ├── extract-session-digest.ts # 提取会话摘要
│   ├── plan-batches.ts           # 计算 init 分批方案
│   ├── list-skills.ts            # 列出当前全部 Skill
│   ├── memory-bootstrap.ts       # 初始化/重建记忆目录
│   ├── memory-ops.ts             # 记忆存储 CRUD 操作
│   ├── memory-search.ts          # 记忆检索脚本（LLM 分析范围 → 精准读取 → LLM 生成答案）
│   ├── memory-edit.ts            # 记忆操作脚本（多操作映射、模糊匹配、操作层重试）
│   └── install-memory-instance.ts # 安装/配置实例
├── utils/
│   ├── llm-client.ts             # Anthropic 兼容 LLM 客户端（支持调用层指数退避重试）
│   ├── paths.mjs                 # 路径常量（带 JSDoc 类型）
│   ├── sessions.ts               # 会话读取/解析的共享工具
│   ├── instance-config.mjs       # 实例配置读取工具
│   └── time.ts                   # 时间工具
└── memory-runner.mjs             # 启动脚本（实验性）

build.mjs                # Skill 组装脚本

运行时数据目录（.memory/，git ignored）

./.memory/
├── profile.md                  # 用户画像
├── README.md                   # Memory 文件夹索引说明
├── corrections/
│   ├── active.json             # 待处理的行为纠偏建议
│   └── archive.jsonl           # 已处理的历史记录
├── sop-candidates/
│   ├── index.json              # SOP 索引
│   └── *.md                    # 各 SOP 详情
├── memory_log/
│   └── YYYY-MM-DD.md           # 每日变更日志
├── diary/
│   └── YYYY-MM-DD.md           # 每日散文日记
├── dreams/
│   ├── residues.json           # 滚动累积的潜意识残留池
│   └── YYYY-MM-DD.md           # 每日梦境（含分镜）
└── state.json                  # 运行状态与增量检测

LLM 配置

config/llm-config.json 存储 LLM API 配置，支持 Anthropic 兼容格式（如 MiniMax）：

{
  "provider": "anthropic-compatible",
  "baseUrl": "https://api.minimaxi.com/anthropic",
  "apiKey": "your-api-key",
  "model": "MiniMax-M2.7-highspeed",
  "temperature": 0.3,
  "maxTokens": 4096,
  "thinking": false
}

直接修改 config/llm-config.json 即可切换配置。

组件化构建

Skills 通过 build.mjs 从组件文件组装生成：

node build.mjs              # 构建所有 Skill
node build.mjs memory-daily # 只构建指定配置

每个 JSON 配置声明组件列表，build.mjs 按顺序拼接 markdown 文件并自动编号阶段（numbered: true 时）。

⚠️ 构建产物 skills/*/SKILL.md 内嵌了本机绝对路径（PROJECT_ROOT / MEMORY_ROOT），已在 .gitignore 中排除。切勿直接分发构建产物；他人接入时应 clone 源码后重新运行 node build.mjs，或通过 memory-setup 流程自动完成。

技术依赖

依赖	说明
Proma	运行环境（Electron 桌面应用）
@anthropic-ai/claude-agent-sdk	Agent 引擎
npx tsx	TypeScript 脚本直接运行
Anthropic 兼容 API	LLM 后端（如 MiniMax）
Proma 会话存储	数据源（agent-sessions.json / conversations.json + JSONL 日志）

许可

MIT