pi-threads
基于ripgrep的Pi对话历史搜索工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-threads。 它的用途是：基于ripgrep的Pi对话历史搜索工具 完整的 Skill 内容见：https://321skill.com/skills/pi-threads/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我找出我们去年讨论过关于‘用户认证方案’的所有对话。” 它会调用pi-threads，在您的本地对话历史文件中，使用ripgrep快速搜索关键词“用户认证”，并将包含相关讨论的对话线程整理后呈现给您，方便您回顾当时的决策细节和代码建议。
介绍
Pi-threads 是一款专为 Pi AI 设计的扩展工具，它解决了用户在长期使用中难以回溯和查找过往对话历史的问题。当用户需要引用数月前讨论过的代码片段、项目想法或重要决策时，手动翻阅聊天记录效率极低，而本工具通过强大的搜索能力，让历史信息触手可及。
使用方式非常便捷，用户只需在Pi的对话环境中安装并启用此扩展，便可通过自然语言或关键词指令，快速搜索所有保存的对话线程。其核心是利用ripgrep这一高效的命令行搜索工具作为后端，对本地存储的对话日志文件进行全文检索，支持正则表达式等高级搜索模式，从而精准定位到包含目标内容的对话。
该工具非常适合与Pi进行深度、长期协作的用户，例如软件开发者、研究人员、写作者以及项目管理者。他们经常需要与AI反复探讨复杂问题，并在不同阶段的对话中积累了大量有价值的信息，pi-threads能帮助他们高效地复用这些知识资产。
在使用时，建议用户确保对话历史已妥善保存在本地可访问的路径中。由于搜索基于本地文件，其效果取决于历史记录的完整性和文件格式的兼容性。定期整理和备份对话日志文件，能获得更佳的搜索体验。
核心特点
其核心区别在于后端集成了ripgrep这一业界公认的高性能搜索工具，相比简单的文本匹配或内置搜索，它在处理海量、结构复杂的对话日志文件时，搜索速度和准确性（尤其是支持正则表达式）有显著优势。
注意事项
不适合需要实时同步或搜索云端对话历史的场景，其功能完全依赖于本地存储的对话日志文件。
常见问题
如何安装pi-threads？
通过npm安装，具体命令见下方安装部分。
它能搜索多久以前的对话？
取决于Pi客户端本地保存的对话历史文件的时长和范围。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-threads/raw/index.md 读取 pi-threads 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-threads/raw/index.md（查看排版版本）