@agney/pi-honcho-memory
pi编码代理的持久记忆扩展
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@agney/pi-honcho-memory。 它的用途是:pi编码代理的持久记忆扩展 完整的 Skill 内容见:https://321skill.com/skills/agney-pi-honcho-memory/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我保存当前项目的编码进度,记住我们正在开发用户认证模块,使用JWT方案。' 它会自动将上下文注入到后续会话的系统提示中,并持续保存对话历史。下次打开pi时,无需重复说明,AI代理会自动加载之前的记忆。
介绍
这个Skill解决了pi编码代理在开发过程中缺乏长期记忆的问题。在实际开发中,AI代理每次对话都会丢失上下文,无法记住用户偏好、项目进展和关键决策,导致重复配置和效率低下。通过集成Honcho服务,它实现了用户画像和项目摘要的自动注入,让AI代理拥有“记忆”能力,避免重复说明。
使用方式很简单,你只需要安装后运行/honcho-setup交互式配置API密钥,或设置环境变量如HONCHO_API_KEY。之后pi会自动将缓存的用户信息和项目摘要注入到系统提示中,零网络延迟。每次对话结束后,用户/助手的消息会自动保存到Honcho。你还可以通过自然语言指令使用honcho_search、honcho_chat、honcho_remember等工具主动操作记忆,或通过/honcho-status查看状态。会话策略支持按仓库、Git分支或目录作用域,灵活控制记忆粒度。
它非常适合需要持续编码上下文支持的智能体开发者和全栈开发者。尤其是那些使用pi作为编码代理、希望保持项目对话连贯性的团队或个人。对于需要跨分支、跨工作目录共享记忆的场景(如大型仓库多分支开发),这个扩展能显著减少重复配置,提升开发效率。
建议在团队开发中统一使用相同的工作空间ID和会话策略,以确保记忆一致性。需要注意的是,它依赖Honcho服务,需要提前获取API密钥;若Honcho不可用,会优雅降级,pi正常工作但记忆功能失效。配置优先级上,环境变量高于配置文件,建议通过环境变量管理敏感信息。
常见问题
如何获取Honcho API密钥?
前往honcho.dev注册账号,在控制台创建API密钥,格式为hch-...。然后运行`/honcho-setup`或设置环境变量`HONCHO_API_KEY`。
支持哪些会话策略?
支持三种:repo(跨同一仓库的工作树共享记忆)、git-branch(按分支隔离)、directory(按工作目录隔离)。默认是repo。可通过环境变量`HONCHO_SESSION_STRATEGY`或配置文件设置。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/agney-pi-honcho-memory/raw/index.md 读取 @agney/pi-honcho-memory 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/agney-pi-honcho-memory/raw/index.md(查看排版版本)