Penfield技能使用说明
彭菲尔德记忆
持续积累的记忆。您的智能体能够记住对话、学习偏好、关联想法,并在不同会话、日期和渠道间精准衔接,无缝延续。
工具
记忆
| 工具 | 用途 | 使用时机 |
|---|---|---|
penfield_store | 保存记忆 | 用户分享偏好、您有所发现、做出决策、或学到值得保留的内容时 |
penfield_recall | 混合搜索(BM25 + 向量 + 图谱) | 需获取上下文后再回应、恢复话题、查找先前决策时 |
penfield_search | 语义搜索(向量权重更高) | 无准确术语时进行模糊概念搜索 |
penfield_fetch | 通过ID获取记忆 | 根据召回结果跟进特定记忆时 |
penfield_update_memory | 编辑现有记忆 | 纠正、添加细节、更改重要性或标签 |
知识图谱
| 工具 | 目的 | 使用时机 |
|---|---|---|
penfield_connect | 连接两个记忆 | 新信息与现有知识相关,随着时间推移构建理解 |
penfield_disconnect | 移除记忆间的链接 | 关系创建错误或已失效 |
penfield_explore | 从某个记忆遍历图谱 | 理解想法如何关联,寻找相关上下文 |
上下文与分析
| 工具 | 目的 | 使用时机 |
|---|---|---|
penfield_save_context | 保存会话检查点 | 结束实质性工作,准备移交给其他代理 |
penfield_restore_context | 从检查点恢复 | 从您或其他智能体中断的地方继续 |
penfield_list_contexts | 列出已保存的检查点 | 查找可恢复的先前会话 |
penfield_reflect | 分析记忆模式 | 会话开始定位,发现主题,找出空白 |
工件
| 工具 | 用途 | 何时使用 |
|---|---|---|
penfield_save_artifact | 存储文件 | 保存图表、笔记、代码、参考文档 |
penfield_retrieve_artifact | 获取文件 | 加载先前保存的工作 |
penfield_list_artifacts | 列出存储的文件 | 浏览已保存的工件 |
penfield_delete_artifact | 删除一个文件 | 清理过时的工件 |
个性
| 工具 | 目的 | 何时使用 |
|---|---|---|
penfield_awaken | 加载个性配置 | 会话开始,身份刷新 |
编写真正有效的记忆
记忆内容的质量决定了Penfield是有用还是无用。区别在于具体性和上下文。

差——模糊,无上下文,后期无法找到:
"User likes Python"
好——具体,有上下文,可找到:
"[Preferences] User prefers Python over JavaScript for backend work.
Reason: frustrated by JS callback patterns and lack of type safety.
Values type hints and explicit error handling. Uses FastAPI for APIs."
使记忆可被找到的关键:
- 上下文前缀在括号内:
[偏好],[项目:API 重新设计],[调查:支付错误],[决定] - "是什么"背后的"为什么"—— 理由比事实本身更重要
- 具体细节—— 名称、数字、日期、版本,而非模糊的概括
- 关联记忆的引用—— "这基于[先前关于X的发现]" 或 "与先前假设Y相矛盾"
记忆类型
使用正确的类型。系统会据此进行筛选和分析。
| 类型 | 用途 | 示例 |
|---|---|---|
事实 | 经核实的、持久的信息 | "用户公司在AWS EKS上运行Kubernetes" |
洞察 | 模式或领悟 | "部署失败与周五发布相关" |
修正 | 修正先前的理解 | "修正:超时并非Redis问题——而是一个硬编码的批处理限制" |
对话 | 会话摘要,重要交流 | "讨论了迁移策略。用户倾向于采用渐进式方法" |
参考 | 源材料,引用 | "RFC 8628 为输入受限设备上的 OAuth 定义了设备代码流程" |
任务 | 工作项,行动项 | "待办:索引重建后测量召回延迟" |
策略 | 方法,方案,计划 | "针对用户的代码库:始终先检查 types.ts 文件,它是事实来源" |
检查点 | 里程碑状态 | "项目进度 80% — 认证部分完成,用户界面待完成" |
核心身份 | 不可变的身份事实 | 通过个性配置设置,很少手动存储 |
个性特质 | 行为模式 | 通过个性配置设置,很少手动存储 |
关系 | 实体关联 | "用户与查德·舒尔茨合作开展网络安全内容工作" |
重要性评分
请使用完整的评分范围。并非所有内容都是0.5分。
| 评分 | 含义 | 示例 |
|---|---|---|
| 0.9–1.0 | 关键信息——永不遗忘 | 架构决策、来之不易的修正、核心偏好 |
| 0.7–0.8 | 重要信息——经常查阅 | 项目背景、用户工作的关键信息 |
| 0.5–0.6 | 普通信息——有用背景 | 一般偏好、会话摘要 |
| 0.3–0.4 | 次要信息——背景细节 | 边缘信息、无关紧要的观察 |
| 0.1–0.2 | 琐碎信息——可能无需存储 | 若在犹豫是否存储,则不必存储 |
连接记忆
连接是Penfield强大的核心。孤立的记忆只是一条笔记。连接起来的记忆才是理解。
存储一条记忆后,总要问:这与什么相关?然后将其连接起来。
关系类型 (24种)
知识演进: 取代·更新·演进自当理解发生变化时使用。"我们曾以为X,现在我们知道Y。"
证据: 支持·反驳·质疑当新信息证实或挑战现有观点时使用。
层级: 父级·子级·兄弟姐妹关系·由...组成·属于...的一部分用于结构关系。包含子主题的主题,包含组件的系统。
因果关系: 导致·受...影响·是...的前提条件用于因果链和依赖关系。
实施关系: 实现·记录·测试·...的示例当某物展示、描述或验证另一事物时使用。
对话关系: 回应·参考资料·灵感来源用于归属和对话线索。
序列: 紧随其后·位于之前用于流程或时间线中的有序步骤。
依赖关系: 依赖于用于表示一事物需要另一事物。
检索策略
好的查询能找到内容。差的查询返回噪声。
根据您的查询类型调整搜索权重:
| 查询类型 | bm25权重 | 向量权重 | 图权重 |
|---|---|---|---|
| 精确术语查找("Twilio身份验证令牌") | 0.6 | 0.3 | 0.1 |
| 概念搜索("我们如何处理错误") | 0.2 | 0.6 | 0.2 |
| 关联知识(“关于支付的一切”) | 0.2 | 0.3 | 0.5 |
| 默认(平衡) | 0.4 | 0.4 | 0.2 |
积极过滤:
记忆类型:["修正", "洞见"]以发现修正和洞见重要性阈值:0.7以跳过噪音启用图扩展:true以追踪关联(默认开启,通常保持开启)
工作流程
用户分享偏好
penfield_store({
content: "[Preferences] User wants responses under 3 paragraphs unless complexity demands more. Dislikes bullet points in casual conversation.",
memory_type: "fact",
importance: 0.8,
tags: ["preferences", "communication"]
})
调查追踪
// Start
penfield_store({
content: "[Investigation: Deployment Failures] Reports of 500 errors after every Friday deploy. Checking release pipeline, config drift, and traffic patterns.",
memory_type: "task",
importance: 0.7,
tags: ["investigation", "deployment"]
})
// Discovery — connect to the investigation
discovery = penfield_store({
content: "[Investigation: Deployment Failures] INSIGHT: Friday deploys coincide with weekly batch job at 17:00 UTC. Both compete for DB connection pool. Not a deploy issue — it's resource contention.",
memory_type: "insight",
importance: 0.9,
tags: ["investigation", "deployment", "root-cause"]
})
penfield_connect({
from_memory_id: discovery.id,
to_memory_id: initial_report.id,
relationship_type: "responds_to"
})
// Correction — supersede wrong assumption
correction = penfield_store({
content: "[Investigation: Deployment Failures] CORRECTION: Not a CI/CD problem. Friday batch job + deploy = connection pool exhaustion. Fix: stagger batch job to 03:00 UTC.",
memory_type: "correction",
importance: 0.9,
tags: ["investigation", "deployment", "correction"]
})
penfield_connect({
from_memory_id: correction.id,
to_memory_id: initial_report.id,
relationship_type: "supersedes"
})
会话交接
penfield_save_context({
name: "deployment-investigation-2026-02",
description: "Investigated deployment timeout issues. memory_id: " + discovery.id,
memory_ids: [discovery.id, correction.id, initial_report.id]
})
下一会话或不同代理:
penfield_restore_context({
name: "deployment-investigation-2026-02"
})
不存储的内容
- 逐字对话记录(过于冗长,信息价值低)
- 易于搜索的事实(请使用网络搜索)
- 临时任务状态(请使用工作记忆)
- 用户未同意存储的任何个人信息
- 所有琐碎交流(要有选择性——质量重于数量)
标签
保持简短、一致、小写。每条记忆2-5个标签。
良好示例:偏好设置,架构,调查,修正,项目名称不良示例:2026-02-02,关于部署的重要记忆,用户沟通风格偏好
同样可在OpenClaw之外使用
原生OpenClaw插件是最快捷的途径,但Penfield可与任何AI工具在任何地方协同工作:
Claude连接器
Name: Penfield
Remote MCP server URL: https://mcp.penfield.app
Claude代码
Claude mcp add --transport http --scope user penfield https://mcp.penfield.app
MCP服务器— 适用于Gemini CLI、Cursor、Windsurf、Intent、Perplexity Desktop或任何MCP兼容工具:
{
"mcpServers": {
"penfield": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.penfield.app/"
]
}
}
}
API— 可通过api.penfield.app直接进行HTTP访问,实现自定义集成。
相同的记忆存储、相同的知识图谱、相同的账户。插件速度提升4-5倍(无需MCP代理层),但无论您如何连接,所有内容都将保持同步。


微信扫一扫,打赏作者吧~