轻量SQLite管理工具（免费版）

本工具为AI Agent、独立开发者与小型团队提供轻量级本地SQLite数据库管理能力。免费版聚焦核心场景：建表、增删改查、索引、备份、查询优化，足以覆盖绝大多数本地数据存储需求。

概述

SQLite是一种嵌入式关系型数据库，数据存储于单一文件中，无需启动服务进程即可使用。相比 PostgreSQL、MySQL等需要独立服务端的传统数据库，SQLite在部署成本、跨平台移植、内存占用方面具有天然优势，尤其适合集成在AI Agent、CLI工具、桌面应用中。

本工具基于Python标准库sqlite3模块封装，提供更友好的面向对象API，并预置WAL并发模式、连接池、自动备份、Schema迁移等常用能力。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Agent、的轻量级本地、SQLite、数据库管理工具、免部署、低内存、覆盖建表、备份等核心场景、场景重新设计的轻、本地数据库管理工、通过单一文件、零运维的方式提供、结构化数据存储能、Python、API、性能调优参数与常、Schema、可快速接入会话记、缓存层、日志归档等典型工、Use、when、需要数据库操作、SQL、数据存储管理时使、不适用于数据库架、构设计决策等。

使用场景

场景一：AI Agent会话记忆

将每次对话的关键信息持久化到本地数据库，避免重复向LLM请求相同上下文，降低Token消耗。

场景二：本地缓存层

对昂贵的外部API调用结果进行TTL缓存，命中即返回，未命中再发起真实请求。

场景三：日志归档与分析

将应用运行日志结构化写入SQLite，配合索引实现快速检索与统计聚合，无需部署独立日志系统。

场景四：配置与元数据管理

替代JSON/YAML配置文件，获得事务一致性、索引查询、外键约束等数据库级能力。

快速开始

第一步：建立数据库连接

from sqlite_connector import SQLiteDB
# ...
# 磁盘持久化模式（推荐生产使用）
db = SQLiteDB("agent_data.db")
# ...
# 内存模式（适合临时数据，进程结束即销毁）
mem_db = SQLiteDB(":memory:")

第二步：创建表与索引

db.create_table("memos", {
    "id": "INTEGER PRIMARY KEY AUTOINCREMENT",
    "title": "TEXT NOT NULL",
    "content": "TEXT",
    "tags": "TEXT",
    "created_at": "TEXT DEFAULT CURRENT_TIMESTAMP"
})
# ...
db.create_index("memos", "tags")
db.create_index("memos", "created_at")

第三步：增删改查

# 写入
db.insert("memos", {"title": "第一条备忘", "content": "测试内容", "tags": "demo"})
# ...
# 查询
rows = db.query("SELECT * FROM memos WHERE tags = ?", ("demo",))
# ...
# 更新
db.update("memos", "id = ?", {"content": "更新后的内容"}, (1,))
# ...
# 删除
db.delete("memos", "id = ?", (1,))

完整上手时间约60秒，无需任何额外配置。

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

示例

性能优化参数

import sqlite3
# ...
conn = sqlite3.connect("agent_data.db")
conn.execute("PRAGMA journal_mode=WAL")        # 启用WAL并发模式
conn.execute("PRAGMA synchronous=NORMAL")     # 平衡安全与性能
conn.execute("PRAGMA cache_size=-64000")      # 64MB缓存
conn.execute("PRAGMA temp_store=MEMORY")      # 临时表存内存
conn.execute("PRAGMA page_size=4096")         # 页大小优化

预置Schema模板：会话日志表

db.create_table("session_logs", {
    "id": "INTEGER PRIMARY KEY AUTOINCREMENT",
    "session_id": "TEXT NOT NULL",
    "agent": "TEXT NOT NULL",
    "message": "TEXT",
    "metadata": "TEXT",                          # JSON序列化存储
    "created_at": "TEXT DEFAULT CURRENT_TIMESTAMP"
})
db.create_index("session_logs", "session_id")
db.create_index("session_logs", "created_at")

预置Schema模板：TTL缓存表

db.create_table("cache", {
    "id": "INTEGER PRIMARY KEY AUTOINCREMENT",
    "key": "TEXT UNIQUE NOT NULL",
    "value": "BLOB",
    "created_at": "TEXT DEFAULT CURRENT_TIMESTAMP",
    "expires_at": "TEXT NOT NULL"
})
db.create_index("cache", "key")
db.create_index("cache", "expires_at")

最佳实践

1. 批量写入替代循环写入

# 慢：循环单条插入
for row in rows:
    db.insert("table", row)
# ...
# 快：一次性批量插入，性能提升10倍以上
db.batch_insert("table", rows)

2. 为高频查询字段建立索引

# 查询条件中的字段必须建索引
db.create_index("table", "column_name")
# 多列联合索引
db.create_index("table", "col1, col2")

3. 定期清理过期数据

db.cleanup_expired("cache", "expires_at")
db.cleanup_old("logs", "created_at", days=7)

4. 定期VACUUM压缩空间

db.vacuum()  # 在业务低峰期执行

5. 使用事务包裹批量操作

db.transaction(() => {
    db.insert("orders", order)
    db.update("stock", {"qty": qty - 1}, "id = ?", pid)
})

常见问题

Q1：出现"database is locked"错误如何处理？

A：默认journal模式并发能力弱，建议启用WAL模式（PRAGMA journal_mode=WAL），同时为连接池设置合理的timeout参数（如5秒），让等待中的写操作自动重试。

Q2：数据库文件越来越大怎么办？

A：(1) 定期执行db.vacuum()回收空间；(2) 为日志类表设置TTL自动清理；(3) 大文件考虑使用PRAGMA auto_vacuum=INCREMENTAL。

Q3：查询很慢如何排查？

A：使用EXPLAIN QUERY PLAN查看执行计划，若出现COLLSCAN表示全表扫描，需要为查询字段建立索引；若totalDocsExamined/nReturned比值远大于1，说明索引选择性差。

Q4：SQLite能支持多少并发？

A：WAL模式下支持任意数量读并发，但同一时刻只能有一个写操作。若写并发是瓶颈，建议改用 PostgreSQL 等客户端-服务端架构数据库。

Q5：内存模式数据会丢失吗？

A：会。:memory:模式数据完全驻留内存，进程退出即丢失，仅适合临时数据、单元测试或中间计算结果。

已知限制

本免费体验版限制以下高级功能：

• 批量写入条数上限为1000条/次
• 不支持自动定时备份（仅支持手动备份）
• 不支持Schema自动迁移工具
• 不支持连接池监控指标

解锁全部功能请使用专业版：sqlite-lite-manager-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python: 3.8+（用于数据库管理脚本）

依赖详情

API Key 配置

• 本免费版基于本地SQLite，无需任何API Key
• 不涉及云端服务调用，数据完全保留在本地

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "轻量SQLite管理免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "sqlite lite manager"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}