小紫 SQLite 查询插件

简介

小紫 SQLite 查询插件 v1.0，AI 直接分析本地 .db 文件：

• query 执行 SELECT 查询，返回 JSON 行数据
• tables 列出所有表/视图及行数
• schema 查看表列结构、索引
• export 查询结果导出 CSV 或 JSON
• 无需 pip，Python 标准库 sqlite3
• Win / macOS / Linux 通用

重要：v1.0 仅支持 SELECT 只读查询，不允许 INSERT/UPDATE/DELETE/DROP 等，避免 AI 误改数据库。

典型流程：tables 看有哪些表 → schema 看结构 → query 查数据 → export 导出

操作说明

参数要点：

• dbpath 必填，SQLite 文件路径如 D:\data\app.db
• sql SELECT 语句，如 SELECT * FROM users WHERE id=1
• table schema/export 用表名
• limit 最多返回行数，默认 100，最大 10000
• output export 必填
• format export 格式 csv（默认）或 json

安装

1. 解压到 D:\xiaozi-plugins\数据处理\SQLite查询插件\
2. 复制 python/ 到本目录
3. 测试：run.bat --action tables --dbpath D:\data\app.db

无需 pip，标准库即可。

命令行

run.bat --action tables --dbpath D:\data\app.db
run.bat --action schema --dbpath D:\data\app.db --table users
run.bat --action query --dbpath D:\data\app.db --sql "SELECT * FROM users LIMIT 10"
run.bat --action export --dbpath D:\data\app.db --table users --output D:\data\users.csv
run.bat --action export --dbpath D:\data\app.db --sql "SELECT * FROM logs" --output D:\data\logs.json --format json

注册技能 sqlite_tool

名称： sqlite_tool

描述： SQLite查询 v1.0。query/tables/schema/export本地db只读查询、看表结构、导出CSV/JSON。用户查SQLite、分析.db、导出表数据时使用。需dbpath；query需sql SELECT；schema需table。仅SELECT只读。

脚本： D:\xiaozi-plugins\数据处理\SQLite查询插件\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["query", "tables", "schema", "export"], "description": "操作类型"},
    "dbpath": {"type": "string", "description": "SQLite .db 路径"},
    "sql": {"type": "string", "description": "SELECT语句"},
    "table": {"type": "string", "description": "表名"},
    "limit": {"type": "string", "description": "最多行数默认100"},
    "output": {"type": "string", "description": "export输出路径"},
    "format": {"type": "string", "description": "csv/json"}
  },
  "required": ["action", "dbpath"]
}

对话示例

常见错误

能力边界

与其他插件配合

• csv_tool：导出 CSV 后继续筛选统计
• json_tool：导出 JSON 后格式化分析
• data_clean：清洗导出数据

详见包内 SQLite查询插件.md。