SuperAPI AI 工具集

blink-database

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:blink-database 用于在 Blink 项目中操作数据库,覆盖建表、查询、增删改等日常数据需求,并提供 MCP 工具与 SDK 两种使用途径。

主要能力:MCP 提供 blink_db_query(执行任意 SQL,如 SELECT、INSERT、UPDATE、DELETE、CREATE TABLE)和 blink_db_schema(查看所有表及列名、类型、可空性、默认值、主键)。SDK 提供 create、get、list、update、delete、upsert、count、exists,以及 createMany、updateMany、deleteMany 等批量操作。list 支持 where(含 AND/OR 嵌套)、orderBy、limit、offset、select。

使用方式:SDK 中统一使用 camelCase 字段名,系统会自动与数据库的 snake_case 互转;ID 自动生成为字符串。查询示例:await blink.db.todos.list({ where: { AND: [{ userId: user.id }, { OR: [{ status: 'open' }, { priority: 'high' }] }] }, orderBy: { createdAt: 'desc' }, limit: 20, offset: 0 })。CLI 原始 SQL:blink db query "SELECT * FROM todos LIMIT 10"。

限制与注意:SQLite 返回的布尔值为 "0"/"1" 字符串而非 true/false,过滤时用 { isCompleted: "1" },判断时用 Number(todo.isCompleted) > 0。TypeScript 中 id 必须为 string,不能是 number。不要使用 snake_case 调用 SDK。REST CRUD 默认受 JWT 保护,需用 createClient 初始化 auth(如 mode: 'managed'),RLS 在服务端按用户限制访问。不要在异步操作(AI、上传)完成前创建数据库记录,否则可空字段或缺失数据会触发 NOT NULL 约束失败,应在数据齐全后再创建。

适用场景:需要在 Blink 应用中快速实现数据表的增删改查、批量写入、条件过滤查询与结构检查的开发场景。收费、价格、平台与效果等资料暂未提供。