pi-qmd-ledger
一个支持混合搜索与人工干预的通用可配置JSONL账本。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-qmd-ledger。 它的用途是：一个支持混合搜索与人工干预的通用可配置JSONL账本。 完整的 Skill 内容见：https://321skill.com/skills/pi-qmd-ledger/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“查询用户‘小明’过去一周所有关于‘订单退款’的对话记录。”，它会通过pi-qmd-ledger的混合搜索功能，快速从JSONL账本中检索出相关记录并返回。或者，当AI在处理一个复杂任务遇到预设的模糊点时，账本可以自动触发人工审核（HITL），并将相关上下文动态注入给处理人员。
介绍
pi-qmd-ledger 是一个专为AI Agent设计的通用、可配置的JSONL格式账本系统。它旨在解决AI在处理复杂、长周期任务时，因上下文窗口有限或记忆不连贯而导致的信息丢失、决策断层和状态管理混乱问题。通过将交互历史、任务状态和关键数据以结构化的JSONL格式持久化存储，它为AI提供了一个稳定、可查询的外部记忆库。
使用本Skill时，您需要先通过npm安装，并在您的AI Agent项目中引入和配置。其核心功能围绕一个可配置的JSONL文件展开，您可以通过代码或AI指令，向账本中写入事件记录、查询历史（利用其集成的qmd混合搜索能力快速定位信息）、并根据预设规则触发分层人工干预（HITL）或动态地向AI的上下文中注入相关历史片段，从而让AI能基于完整的“记忆”做出更连贯的决策。
它非常适合需要处理多轮复杂对话、长期运行任务（如项目管理、客户支持追踪、代码审查跟进）、或任何需要AI具备“记忆”和状态保持能力的开发者与高级用户。例如，构建需要记住用户偏好的聊天机器人、管理自动化工作流状态的Agent，或开发能进行深度代码分析和迭代的编程助手。
使用建议：在项目初期就规划好账本的数据结构（JSON Schema），以便充分发挥混合搜索的效能。注意事项：它本身是一个底层数据管理库，并非开箱即用的最终产品，需要一定的编程能力进行集成和定制；对于极其简单或一次性的任务，引入该Skill可能会增加不必要的复杂度。
核心特点
核心区别在于集成了qmd混合搜索（结合关键词与语义）实现高效历史记录检索，并内置了分层人工干预（HITL）机制与动态上下文注入能力，使得状态管理和人机协作流程更自动化、更智能。
注意事项
不适合用于处理实时性要求极高、或任务极其简单无需状态保持的场景。
常见问题
pi-qmd-ledger 是什么？
一个为AI Agent设计的、支持混合搜索和人工干预的可配置JSONL账本库。
qmd混合搜索是什么？
一种结合了关键词匹配与向量语义搜索的混合检索技术，能更精准地从历史账本中查找信息。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-qmd-ledger/raw/index.md 读取 pi-qmd-ledger 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-qmd-ledger/raw/index.md（查看排版版本）