piia-engram
本地优先、用户自主的AI工作身份层,跨工具共享你的偏好与上下文
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:piia-engram。 它的用途是:本地优先、用户自主的AI工作身份层,跨工具共享你的偏好与上下文 完整的 Skill 内容见:https://321skill.com/skills/piia-engram/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“记住,我在这个React项目里喜欢用TypeScript,并且组件都要写成函数式组件。” 它会将这条偏好记录到你的本地Engram身份层中。之后,当你在另一个支持MCP的工具(如Cursor)中开始新功能时,AI助手会读取这条记录并建议:“根据你的编码习惯,这里是否也使用TypeScript和函数组件?”。
介绍
在AI编码助手日益普及的今天,每个工具(如Claude Code、Cursor)都在构建自己的“记忆”或规则集,但这些信息往往被锁定在单一工具或工作区内。piia-engram 旨在解决这一碎片化问题,它提供了一个位于所有工具之上的、统一的个人AI身份层。它让你只需定义一次你的工作习惯、质量标准和项目背景,即可在所有兼容MCP协议的编码工具中共享。
使用方式非常简单。通过pip安装后,piia-engram会在你的本地目录(~/.engram/)下创建存储文件。当你使用支持MCP的工具时,AI助手可以读取和写入这个本地知识库,记录你的决策、偏好和项目上下文。你可以随时查看、编辑或覆盖这些内容,完全掌握控制权。
它非常适合那些频繁在不同AI编码工具(如Claude Code、Cursor、Windsurf)间切换,并希望保持工作上下文连续性的开发者、技术负责人或全栈工程师。对于需要将个人或团队的最佳实践、代码规范沉淀下来,并在多个项目中复用的场景,它也极具价值。
使用建议:初次使用时,建议花些时间通过对话让AI助手帮你初始化身份层,例如定义你的代码风格、常用工具链和项目架构偏好。对于涉及敏感信息(如密钥、命令)的写入,系统默认会等待你的审核,但你可以通过设置环境变量 ENGRAM_APPROVAL=strict 来要求审核所有写入操作,以获得最高级别的控制。
核心特点
与各工具内置的、封闭的“记忆”功能不同,piia-engram的核心区别在于其“本地优先”和“用户所有”的设计哲学。它不依赖任何云账户,所有数据以可读的JSON/Markdown格式存储在你的电脑上,实现了真正的数据可移植性和完全的可审计性。
注意事项
不适合仅使用单一、不支持MCP协议的AI编码工具,且对跨工具上下文共享无需求的用户。
常见问题
piia-engram会泄露我的隐私数据吗?
不会。所有数据默认存储在本地 ~/.engram/ 目录下,无需连接云端服务器。涉及高风险信息的写入(如命令、配置)默认需要用户批准,且所有写入操作都可被审计和撤销。
如何让我的AI助手(如Claude Desktop)使用它?
需要在AI助手的MCP配置文件中添加piia-engram服务器。具体步骤请参考项目README中的安装和配置指南,通常只需几行配置即可完成。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/piia-engram/raw/index.md 读取 piia-engram 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/piia-engram/raw/index.md(查看排版版本)