@artale/pi-db
基于JSON的本地轻量数据库，支持类SQL查询
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@artale/pi-db。 它的用途是：基于JSON的本地轻量数据库，支持类SQL查询 详细介绍见：https://321skill.com/skills/artale-pi-db/ 请根据该页面的说明完成安装。
使用示例
'帮我用pi-db开发一个本地CLI待办管理工具，支持待办的增删改查、按状态筛选，数据自动持久化到本地JSON文件'，它会自动引入pi-db依赖，定义待办事项的表结构schema，生成包含类SQL查询逻辑的完整Node.js代码，无需启动独立数据库进程。
对AI说：'我要快速验证一个小型商品库存管理系统的产品原型，用pi-db存储商品和库存数据，支持按分类、库存阈值筛选查询'，它会生成基于pi-db的原型代码，快速实现结构化数据的增删改查能力，省去搭建MySQL、SQLite等数据库的繁琐步骤。
对AI说：'帮我写一个批量处理本地运维日志的脚本，解析后的日志数据用pi-db存储，支持按错误等级、时间范围筛选并导出JSON'，它会编写日志解析、数据清洗逻辑，对接pi-db完成数据持久化，实现类SQL的条件查询和一键导出功能。
介绍
日常开发轻量本地工具、编写数据处理脚本时，搭建MySQL、SQLite等数据库成本过高，直接读写JSON文件又缺少结构化校验、条件查询能力，手动实现相关逻辑繁琐易出错，pi-db正是为解决这类轻量本地存储需求而生。 安装后即可快速定义表结构schema，通过类SQL的where子句完成条件筛选查询，支持常规增删改查操作，所有数据自动持久化到本地JSON文件，无需启动独立数据库进程，还支持一键导出表数据。 它适合开发小型本地工具的Node.js开发者、需要处理本地结构化数据的运维与脚本编写人员，以及想要快速验证产品原型、不想耗费时间搭建数据库环境的产品与研发人员。 使用时建议提前规划并定义好表schema，避免写入格式不统一的脏数据；单表建议控制在万级数据量以内，避免数据量过大导致查询性能下降。
核心特点
区别于需要独立部署的重型数据库、无查询能力的纯JSON存储方案，它无需额外运行服务，原生支持类SQL条件查询、内置schema校验与数据导出能力，数据直接以JSON文件形式持久化。
注意事项
不适合需要高并发读写、复杂联表/聚合查询、超大规模数据存储的生产级核心业务场景。
常见问题
pi-db的数据会上传到云端吗？
不会，所有数据均存储在本地JSON文件中，无云端同步逻辑。
pi-db支持完整SQL语法吗？
目前仅支持类SQL的where条件查询，暂不支持联表、聚合等复杂SQL能力。