Sqlite Lite Manager Free

SKILL.md

---
slug: sqlite-lite-manager-free
name: sqlite-lite-manager-free
version: 1.0.0
displayName: 轻量SQLite管理免费版
summary: 面向AI Agent的轻量级本地SQLite数据库管理工具，免部署、低内存，覆盖建表、查询、索引、备份等核心场景。
license: Proprietary
edition: free
description: 面向AI Agent场景重新设计的轻量级SQLite本地数据库管理工具。通过单一文件、零运维的方式提供结构化数据存储能力，配套Python封装API、性能调优参数与常用Schema模板，可快速接入会话记忆、缓存层、日志归档等典型工作流。Use
  when 需要数据库操作、SQL查询、数据存储管理时使用。不适用于数据库架构设计决策。
tags:
- 集成工具
- 本地存储
- 数据库
- 轻量级
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: "L2-标准级"
pricing_model: per_use
suggested_price: "19.9 CNY/per_use"
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 轻量SQLite管理工具（免费版）

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

## 概述

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

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

## 核心能力

| 能力分类 | 说明 |
|----|---|
| 数据存储 | 支持磁盘持久化与内存模式两种运行形态 |
| 并发访问 | 默认启用WAL模式，支持多读单写并发 |
| 性能优化 | 内置索引管理、批量写入、查询计划分析 |
| 数据安全 | 提供全量备份、自动定时备份、ACID事务保障 |
| Schema管理 | 支持字段新增、列重命名、版本迁移 |
| 跨平台 | Windows/macOS/Linux全平台兼容，单文件可移植 |
**技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

### 核心功能执行
用`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配置文件，获得事务一致性、索引查询、外键约束等数据库级能力。

## 快速开始

### 第一步：建立数据库连接

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

### 第二步：创建表与索引

```python
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")
```

### 第三步：增删改查

```python
# 写入
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秒，无需任何额外配置。

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

## 示例

### 性能优化参数

```python
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模板：会话日志表

```python
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缓存表

```python
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. 批量写入替代循环写入

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

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

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

### 3. 定期清理过期数据

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

### 4. 定期VACUUM压缩空间

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

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

```python
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+（用于数据库管理脚本）

### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-----|:-----|:-----|:-----|
| Python | 运行时 | 必需 | python.org 官方下载 |
| sqlite3 | Python模块 | 必需 | Python标准库自带 |
| sqlite_connector | 封装模块 | 必需 | 随本Skill分发 |

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

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

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---:|---:|---:|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

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