bun-sqlite（BunSQLite数据库操作技能）Skill 是什么？如何下载安装使用？

bun-sqlite（BunSQLite数据库操作技能）：让 AI 助手写出安全、规范、高性能的 Bun 内置 SQLite 代码

它是什么：bun-sqlite 是一个专注于 Bun 内置 SQLite 驱动（bun:sqlite）的 AI 技能，把「如何正确打开数据库、写准备语句、用事务、做迁移」等一整套工程经验内置给 AI 助手。
解决什么痛点：Bun 自带的 SQLite 驱动速度快、零依赖，但用法与 better-sqlite3、sqlite3 等常见库并不完全一致，AI 很容易写出字符串拼接导致 SQL 注入、忘记 close()、对单条语句滥用事务等错误代码。
核心能力：打开数据库（文件 / 内存 / 只读）、基本查询、准备语句、事务与自动回滚、.all() / .get() / .values() / .run() 四种结果获取方式、错误处理，以及 CRUD 仓储、批量插入、数据库迁移、查询构建器等可直接复用的代码模式。
附加价值：技能内置「反模式」清单，会主动提醒并纠正 AI 的坏习惯，输出代码天然更安全、更贴近生产标准。
适用人群：使用 Bun 开发后端服务、桌面工具、命令行程序、轻量数据服务的开发者，尤其是需要嵌入式数据库但不想引入重型 ORM 的团队。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

基本信息

项目	内容
技能中文名	BunSQLite数据库操作技能Skill
技能英文名	bun-sqlite
技能 ID	13976
技能类型	知识/规范类技能（`user-invocable: false`，由 AI 在识别到相关任务时自动启用，无需用户手动敲命令）
允许使用的工具	读取、写入、编辑、Bash、Grep、Glob
关联技能	bun-runtime（核心运行时与文件 I/O）、bun-testing（测试数据库操作）、bun-bundler（打包包含 SQLite 的应用）

它到底解决什么问题

SQLite 是「一个文件就是一个数据库」的典型嵌入式方案，Bun 更是把它做成了原生内置驱动——不需要编译原生扩展，import { Database } from "bun:sqlite" 就能用。听起来很美，但实际开发中会遇到三类反复出现的问题：

API 记忆成本：db.run()、db.query()、db.prepare() 三者什么时候用哪个？.get() 和 .all() 返回结构有什么区别？记错就是运行时报错。
安全隐患：随手写模板字符串拼 SQL，直接埋下 SQL 注入漏洞。
性能陷阱：循环里反复解析同一条 SQL、给单条插入包一层事务、批量写入不开事务——这些写法不会报错，但性能可能差出几十倍。

bun-sqlite 技能的作用，就是把上述经验「预装」给 AI 助手：当你提出「用 Bun 写一个 SQLite 的用户表 CRUD」时，AI 不再靠模糊记忆自由发挥，而是按技能给出的规范示例输出代码。

一键安装 AI 技能、提升开发效率的思路

所谓「一键安装 AI 技能」，本质是把一份结构化的专业知识包注册到你的 AI 编程助手/技能平台中，让它在处理相关任务时自动加载这份上下文，而不是每次对话都靠你手动粘贴文档。典型流程如下：

确认安装前提
- 你的 AI 编程助手/客户端支持「技能（Skill）」机制，并能加载技能包；
- 本地已安装 Bun 运行时（用于实际执行与验证示例代码）；
- 项目中具备读写文件与执行 Bash 的权限（本技能声明了读取、写入、编辑、Bash、Grep、Glob 六类工具）。
找到技能入口 在技能平台的技能市场、技能库或「安装技能」面板中搜索技能英文名 bun-sqlite 或技能 ID 13976，也可以直接导入技能包文件。具体的搜索路径、安装命令与权限授予方式因平台而异，以官方说明为准。
完成安装与授权 按平台指引确认该技能的可用工具范围（读取、写入、编辑、Bash、Grep、Glob），仅授予你信任的权限范围。
验证是否生效 在对话中抛出一个典型的 Bun SQLite 任务，例如：「用 bun:sqlite 建一个 users 表，写一个带准备语句和事务的批量插入函数」。若技能生效，回答中应出现以下特征：
- 代码从 import { Database } from "bun:sqlite"; 开始；
- 使用 db.prepare("... VALUES (?, ?)") 占位符，而不是字符串拼接；
- 批量写入使用 db.transaction(...)；
- 结尾主动调用 db.close() 或提示 try/finally 关闭。
如果回答仍然是 Node 生态的 better-sqlite3 或 sqlite3 写法，说明技能未被正确加载，可回到第 2 步检查安装状态。

提示：由于该技能标记为 user-invocable: false，你不需要记忆任何「触发口令」。它属于被动增强型技能，AI 在判断当前任务涉及 Bun + SQLite 时会自动引用其中的规则。

该技能的主要功能和特点

覆盖 Bun 原生 SQLite 驱动全流程：从 new Database("mydb.sqlite") 打开数据库，到 db.close() 释放资源，形成完整闭环，而不是零散片段。
三种数据库打开方式：文件数据库（"mydb.sqlite"）、内存数据库（":memory:"，适合测试与临时计算）、只读数据库（{ readonly: true }，适合数据分析与报表场景），AI 会根据你的描述自动选择。
准备语句优先的编码规范：技能明确要求「准备语句更快且能防止 SQL 注入」，会把 db.prepare() + 占位符作为默认写法，而不是字符串插值。
事务与自动回滚：db.transaction() 包裹的操作在抛错时自动回滚，技能会示范 try / catch 配合事务的完整写法，避免「一半写入成功」的脏数据。
四种查询结果获取方式讲清楚：
- .all()：取所有行；
- .get()：取第一行；
- .values()：取「数组的数组」，适合只关心列值、不关心字段名的批处理；
- .run()：执行但不返回行，适合 INSERT / UPDATE / DELETE，并可通过返回结果判断影响行数。
内置四种可复用工程模式：UserRepository 式 CRUD 仓储类（含 RETURNING * 返回新记录）、事务批量插入（如一次性插入 1000 条）、带迁移记录表的数据库迁移（migrations 表 + hasRun 校验，幂等执行）、链式查询构建器（where / limit / offset / getAll / getOne）。
明确的「反模式」清单：这是它与普通代码补全最大的差异——技能会主动指出四类坏习惯：字符串插值导致 SQL 注入、忘记关闭数据库、给单条操作套事务、循环中重复解析查询，并给出正确写法对照。
与其他 Bun 技能协同：可与 bun-runtime（文件 I/O）、bun-testing（用内存库做单测）、bun-bundler（打包带 SQLite 的应用）组合使用，形成完整的 Bun 开发知识网络。

和普通工具比强在哪：普通代码补全只会「续写你正在写的这一行」，而该技能提供的是「工程判断」——它知道什么时候该用内存库、什么时候必须开事务、哪句 SQL 有注入风险，从而把代码从「能跑」推到「可上线」。

如何使用该技能？

步骤一：确认环境

本地安装 Bun 运行时，并确认 bun --version 能正常输出。该技能产出的所有代码都以 bun:sqlite 模块为前提。

步骤二：用自然语言描述任务

不需要特殊指令，直接用业务语言描述需求即可，例如：

「我要做一个待办事项的本地存储，用 Bun 的内置 SQLite，需要建表、增删改查，并且支持批量导入。」

步骤三：接收技能增强后的代码

AI 会按照技能规范输出代码。以「建表 + 插入 + 查询」为例，典型输出如下：

import { Database } from "bun:sqlite";

const db = new Database("mydb.sqlite");

db.run(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

db.run("INSERT INTO users (name, email) VALUES (?, ?)", ["Alice", "alice@example.com"]);

const users = db.query("SELECT * FROM users").all();
console.log(users);

db.close();

注意其中三处技能印记：IF NOT EXISTS 保证幂等、? 占位符传参防止注入、结尾 db.close() 释放句柄。

步骤四：按场景索取进阶写法

可以直接点名要某种模式，效果更好：

「帮我用准备语句 + 事务批量插入 1000 条用户，要求出错自动回滚」→ 输出 db.transaction() 包裹 prepare 的写法；
「写一个可复用的 UserRepository 类，含 create / findById / findAll / update / delete」→ 输出带 RETURNING * 的仓储模式；
「我需要一个轻量的数据库迁移机制，能记录已执行的迁移」→ 输出 migrations 表 + migrate(name, sql) 的幂等迁移类；
「帮我写个链式查询构建器，支持 where、limit、offset」→ 输出 QueryBuilder<T> 类。

步骤五：核对输出结果

输入：你的业务描述 + 表结构字段。
输出：可直接运行的 TypeScript 代码，包含 import、建表、参数化语句、结果获取与资源释放。
核对要点：是否使用占位符、是否在批量写入时使用事务、是否在 finally 中 close()、是否避免了单个操作套事务。

步骤六：结合测试技能验证

需要写单元测试时，可配合 bun-testing 技能，用 new Database(":memory:") 创建内存库，保证测试之间互不污染。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
bun-sqlite（本技能）	面向 AI 助手的 Bun SQLite 知识增强技能	打开数据库、基本查询、准备语句、事务回滚、四种结果获取、CRUD/迁移/查询构建器模式、反模式纠错	需在支持技能机制的 AI 助手中安装；本身不引入任何运行时依赖	使用 Bun 开发嵌入式数据库应用、脚本工具、轻量服务	优势：零依赖、规范性强、主动防注入与性能陷阱；不足：只管「怎么写对」，不提供 ORM 式的模型定义与自动建表迁移生态
better-sqlite3	Node.js 生态的同步 SQLite 绑定库	同步 API、准备语句、事务封装	需要 `npm install` 并编译原生模块，跨平台构建偶有踩坑	Node.js 后端服务、Electron 桌面应用	优势：生态成熟、文档丰富、社区大；不足：需编译原生扩展，在 Bun 项目中属于「重复造轮子」，且 AI 容易把 Node 写法误用到 Bun
node:sqlite（Node 内置）	Node.js 官方内置 SQLite 模块	基础查询与准备语句	依赖较新版本的 Node.js，无需额外安装	纯 Node 环境下的轻量数据存储	优势：官方维护、零依赖；不足：API 与 Bun 不通用，功能相对基础，在 Bun 项目中不适用
Drizzle ORM / Prisma 等 ORM	上层 ORM 与类型安全查询层	模型定义、迁移工具链、类型推导、关系查询	需引入依赖、定义 schema、生成客户端，学习和配置成本较高	中大型项目、需要强类型与团队协作的系统	优势：类型安全、迁移体系完善；不足：抽象层厚、调试链路长，对几十行就能解决的小工具属于过度设计

小结：如果项目已经运行在 Bun 上且数据规模不大，bun-sqlite 技能 + bun:sqlite 原生驱动是最轻的组合；需要强类型与复杂关系时，再考虑在驱动之上叠加 ORM。技能本身可以与 ORM 方案共存——它解决的是「底层 SQL 写得对不对」，而非「要不要用 ORM」。

该技能的典型应用场景与实际体验情况

场景一：Bun 后端服务开发者搭建用户模块

角色与痛点：后端工程师刚把服务从 Node 迁到 Bun，习惯性写 better-sqlite3 的写法，结果导入报错；手动改造又怕漏掉连接释放。
使用方式：描述「用 Bun 内置 SQLite 写一个 users 表的 CRUD 仓储类」，让技能输出带 RETURNING * 的 UserRepository。
实际体验：输出结构完整，create / findById / findAll / update / delete / close 六个方法齐备，update 用 COALESCE(?, name) 支持部分字段更新，delete 通过 result.changes > 0 判断是否真的删掉了数据——这些细节是普通补全很难一次性写对的。上手难度低，但需要你提前说清表字段，否则字段名会与你的业务不一致。

场景二：数据分析脚本的批量导入

角色与痛点：运营或数据分析同学需要把上千条 CSV 记录导入本地库，直接循环 INSERT 慢到无法接受。
使用方式：要求「用事务批量插入 1000 条用户，出错自动回滚」。
实际体验：技能会给出 db.transaction() 包裹 prepare 的模式，并在反模式中明确提醒「不要在循环里重复解析查询」。这类性能优化建议是最有价值的部分，因为错误写法同样能跑通、不会被报错提醒。注意事项：事务内不要混入网络请求等长耗时操作，否则会长时间占用写锁。

场景三：命令行工具与桌面小应用的本地存储

角色与痛点：独立开发者做一个本地记账 / 笔记工具，希望零配置存储，不想引入数据库服务。
使用方式：说明「单机工具、数据量不大、需要版本升级不丢数据」，让技能输出基于 migrations 表的迁移类。
实际体验：迁移方案用 hasRun(name) 做幂等校验，重复执行不会重复建表，migrate("001_create_users", sql) 的调用形式也直观。注意事项：技能的迁移机制是「手写 SQL + 记录表」的轻量方案，没有回滚（down）脚本，生产环境中的复杂变更仍需自行设计。

场景四：单元测试中的内存数据库

角色与痛点：测试同学希望数据库测试互不干扰、跑得快。
使用方式：让技能用 new Database(":memory:") 生成测试夹具，并配合 bun-testing 技能编写用例。
实际体验：内存库写法被明确列在「打开数据库」的第一节，AI 几乎不会遗漏。整体上手极快，唯一需要注意的是每个用例应创建独立的内存库实例，避免共享状态导致测试顺序依赖。

该技能能为用户带来的价值

把「踩坑经验」前置：SQL 注入、忘记关闭连接、事务滥用、查询重复解析这四类问题，在传统开发中往往要等到代码评审甚至线上事故才被发现。技能把反模式清单直接内置，让 AI 在生成阶段就规避，节省的是排查与返工的时间。
显著降低 Bun SQLite 的学习门槛：开发者不必先通读驱动文档，只要用自然语言描述需求，就能拿到符合规范的代码骨架；四种结果获取方式（.all() / .get() / .values() / .run()）的差异也被讲清楚，减少「试错式调试」。
性能收益可预期：批量写入走事务 + 准备语句复用，是 SQLite 场景下最典型的性能杠杆。技能默认输出这种写法，意味着从第一版代码起就站在较优的性能基线上。
代码一致性提升：团队里不同人让 AI 写 SQLite 代码，产出的风格趋于统一（同样的仓储结构、同样的关闭方式、同样的错误处理范式），降低维护成本。
零运行时成本：技能本身不引入任何 npm 依赖，项目里依旧是纯粹的 bun:sqlite，不增加包体积与供应链风险。
长期价值：随着 bun-runtime、bun-testing、bun-bundler 等相关技能组合使用，逐步形成一套「Bun 全家桶」式的 AI 知识底座，越用越顺手。

常见问题 FAQ

Q1：这个技能怎么安装？我需要在项目里执行什么命令吗？ 该技能是给 AI 助手用的知识型技能，安装动作发生在你使用的 AI 编程助手/技能平台侧，而不是项目里。请在技能市场或技能库中搜索 bun-sqlite（技能 ID 13976）完成安装与权限确认，具体命令与入口以官方说明为准。由于它标记为 user-invocable: false，安装后无需手动触发，AI 在识别到 Bun + SQLite 相关任务时会自动引用。

Q2：这个技能收费吗？ 技能详情中未包含任何定价信息，是否收费取决于你所使用的技能平台的政策，以官方说明为准。需要说明的是，技能本身不引入任何运行时依赖或第三方库，因此不会给你的项目带来额外的软件采购成本。

Q3：它适合谁用？我不用 Bun 也能用吗？ 最适合使用 Bun 开发、且需要嵌入式数据库的开发者，包括后端服务、CLI 工具、桌面应用、数据处理脚本的作者。如果你用的是 Node.js + better-sqlite3，本技能中的多数示例代码并不直接适用，因为模块导入路径和部分 API 行为不同；此时可以把它当作理解 SQLite 最佳实践的参考。

Q4：和直接用 ORM（如 Drizzle、Prisma）相比怎么选？ 看项目复杂度。数据模型简单、只需要几十行代码搞定存储的小项目，用 bun-sqlite 技能 + bun:sqlite 原生驱动更轻、更可控、调试链路更短；中大型项目需要强类型推导、复杂关系查询和成熟迁移工具链时，ORM 更合适。两者并不冲突——技能负责把底层 SQL 写对，ORM 负责上层抽象。

Q5：技能生成的代码能直接上生产吗？ 它输出的是符合规范的高质量骨架，但仍是骨架：表结构字段、索引设计、并发策略需要你结合业务补充。使用前建议重点核对三点：是否为所有用户输入使用了 ? 占位符、批量写入是否包在事务内、是否在 finally 中调用了 db.close()。此外，技能的迁移方案是轻量的「迁移记录表」模式，不含回滚脚本，涉及不可逆变更时请自行做好备份。