mysql-free
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/letmetry--mysql-free.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @letmetry/mysql-free。为 skill 提供零配置、一次调用即可用的 MySQL 关系型存储(免费档:每月 1 万 token / 100MB / 7 天存续)。无需自建数据库、无需注册账号——装好即用,适合 SkillHub 开发者快速给自己的 skill 加关系型数据能力。
阅读全文 (展开查看完整说明)
概述
让任何 skill 都能拥有真正的关系型存储(建表、增删改查、事务),无需自建 MySQL、无需注册云账号。底层复用已上线的 LWS MySQL,通过自助式 UUID 鉴权 + 按调用方独立 schema 隔离,装好即用。
何时使用
- skill 需要结构化、可关联的数据(用户档案、会话历史、配置、榜单、订单等),KV 不够用。
- 想用真正的关系型能力(JOIN、索引、事务),但不想自己搭库、配 auth。
- 做原型 / 验证想法:免费档直接上,起量再升付费档。
鉴权模型(和 kvstore 一样自助)
每个调用方自己生成 UUID 当 API Key(和 kvstore 完全独立,互不干扰):
scripts/mysql.js uuid生成一个 UUID。- 设为环境变量
MYSQL_API_KEY。 - 首次调用时,服务端自动为该 UUID 建一个独立 schema(库),之后所有 SQL 都跑在你的 schema 里,和其他调用方完全隔离。
用法
HTTP API(所有请求带头 X-API-Key: <uuid>):
| 方法 | 路径 | Body | 说明 |
|---|---|---|---|
| POST | /api/mysql/query | { "sql": "CREATE TABLE ..." } | 在你的 schema 里执行任意 SQL(SELECT/INSERT/UPDATE/DELETE/DDL 均可);返回结果行或 affectedRows |
| GET | /api/mysql/info | — | 返回你的连接信息(host/port/schema/user),可用任意 MySQL 客户端直连 |
| GET | /api/mysql/usage | — | 本调用方用量(token 已用/上限、存储、存续) |
CLI(scripts/mysql.js):
scripts/mysql.js uuid
scripts/mysql.js query "CREATE TABLE users(id INT PRIMARY KEY, name VARCHAR(50))"
scripts/mysql.js query "INSERT INTO users VALUES (1,'alice')"
scripts/mysql.js query "SELECT * FROM users"
scripts/mysql.js usage免费档限额(当前唯一档位,付费档后续上线)
| 项 | 免费档 |
|---|---|
| token/月 | 1 万(token ≈ 读写触及的行数,每条 SQL 至少计 1) |
| 存储 | 100MB |
| 存续 | 7 天(连续 7 天无活动,schema 自动回收;常活跃则保留) |
| 价格 | ¥0,免卡 |
- 超限(token 或存储)写入会被拒绝;读永远免费。
- 每个调用方数据隔离在自己的 schema,互不可见。
- 底层 LWS MySQL 与线上业务共用一台机器,但每个调用方有专属的 MySQL 账号,且仅被授权访问自己的
ms_*schema——既碰不到 museumcheck / letmetryai 等生产库,也看不到任何其他调用方的数据(跨租户隔离)。
示例(在另一个 skill 的 SKILL.md 引用)
需要关系型存储时,调用 mysql-free skill(先
scripts/mysql.js uuid取 key 设为 MYSQL_API_KEY):
scripts/mysql.js query "CREATE TABLE IF NOT EXISTS orders(id INT AUTO_INCREMENT PRIMARY KEY, item VARCHAR(100), created_at DATETIME DEFAULT CURRENT_TIMESTAMP)"
scripts/mysql.js query "INSERT INTO orders(item) VALUES ('coffee')"
scripts/mysql.js query "SELECT * FROM orders ORDER BY id DESC LIMIT 10"
注意:免费档适合验证想法与原型;需要更大存储 / 更长存续 / 更高并发,等付费档上线。