如何使用

装好后你无需手敲命令。插件会给 Agent 注入一段「记忆纪律」系统提示,让它在会话里自主判断该记什么、该查什么,并调用下面的工具完成。你也可以随时显式地说「记住XX」或「查一下记忆里关于XX的」来主动触发。

5 个工具一览

工具	作用	什么时候用
`okf_remember`	写入一条记忆(自动去重、校验、落盘)	有值得沉淀的新知识时
`okf_search`	按关键词召回,按权重/近因排序	开场预取、回答前找相关记忆
`okf_read`	精读某条全量(含交叉链接),并记录一次使用反馈	需要完整细节时
`okf_forget`	撤回一条记忆	记错 / 不需要时
`okf_graph`	导出记忆图谱 JSON(nodes/edges/timeline)	可视化 / 传递图谱数据

让它记住(写入)

自动(推荐):你在对话里披露新事实、拍板决策、纠正 Agent、提到技术选型时,Agent 会自己判断是否值得记,不用你开口。
手动:直接说「记住…」即可触发,例如 记住,我的三家门店是韶山/湘乡/塘厦,共用局域网共享文件夹。

什么才算「值得记」:新背景事实/偏好、决策及理由、可复用方法论/流程/经验教训、用户纠正、被确认的反直觉结论、技术选型。不记:寒暄、单轮临时任务、已有记忆的重复内容、未验证的猜测(猜测归入 Idea,等成熟再沉淀)。

让它回忆(召回)

你问相关问题时,Agent 会先 okf_search 召回再作答。
也可显式说「查一下记忆里关于XX的」。
检索不到会明确告诉你「记忆库没有」,不会编造。

技术选型怎么用(TechChoice)

针对前端/后端/语言/方案/配置这类选型,插件按「三档规则」处理(细节见下文「技术选型三档规则」专节):命中 2+ 候选 → 全部展示给你选;命中 1 个 → 直接用;你未指定技术但命中维度关键词(如「前端」)→ 按该维度记忆处理;你提出新方案/切换/配置 → 追加式更新,不覆盖旧候选。

示例:怎么记、怎么查

// ① 记一条门店事实(Fact)
用户: 记住,我的三家门店是韶山/湘乡/塘厦,共用局域网共享文件夹
Agent: okf_remember(title="门店布局", type="Fact",
        content="# 核心\n\n三家门店共用局域网共享文件夹…", tags=["门店"])
       → 已沉淀记忆 fact/门店布局

// ② 记住前端方案(TechChoice)
用户: 前端就用 React 18 + Vite 吧
Agent: okf_remember(type="TechChoice", title="前端方案",
        content="## Options\n\n| 候选 | 状态 |\n|---|---|\n| React 18 + Vite | active |",
        tags=["前端","技术选型"])

// ③ 问数据库时先召回(而不是去翻本地文件)
用户: 帮我查询数据库
Agent: okf_search(query="查询数据库")
       → 命中「鼎赞数据统一用 mcp-dezensaas-mysql」
       → 按该记忆走 mcp-dezensaas-mysql 服务

配置

项	方式	默认
记忆库根目录	环境变量 `OKF_MEMORY_ROOT` 或 settings `okfMemory.root`	`~/.dsh/memory/`
学习参数	`lib/learning.js` 中 `PARAMS`(衰减天数/归档阈值等)	见文件

dsh-okf-memory

安装

说明文档