把自制的本地工具打成 ZIP 时,顺手复制一个 SQLite 主文件,解压后可能能打开,示例却少了一条。买家第一次打开工具就要用到样例库的话,交付前可以在空目录里解压,核对界面里的记录数。
本文由高维实验室(8 码分享团队)编写,使用 AI 辅助整理,实验只用虚构数据。
先在样例库里复现一次
我用 SQLite 3.50.4 开启 WAL 模式,写入「演示订单 A」并执行检查点,把它写入主文件。随后写入并提交「演示订单 B」,保持连接打开,并确认数据仍有一部分留在 seed.sqlite-wal。用主文件和 SQLite 备份导出的文件分别做 ZIP,再各自解压到空目录读取。
| ZIP 的来源 | 解压后能读到的样例 | 完整性检查 |
|---|---|---|
| 只取正在使用的主文件 | 演示订单 A | ok |
| 由 SQLite 备份导出 | 演示订单 A、演示订单 B | ok |
两份 ZIP 都能正常解压,两份数据库的 PRAGMA integrity_check 也都返回 ok。验收时再查一遍应交付的记录数和具体样例。WAL 中可能存有已提交的记录,直接拿走主文件会遗漏这些记录。 SQLite 的 WAL 文件说明
在临时目录复现两份 ZIP 的差异
下面的 Python 脚本用标准库生成两条虚构订单。它把 A 写回主文件,然后提交 B,但保持写入连接打开,不再执行检查点。脚本从两个 ZIP 里各解出一份数据库,再分别查询。运行结束后临时目录会自动清理。
import sqlite3
from contextlib import closing
from pathlib import Path
from tempfile import TemporaryDirectory
from zipfile import ZipFile
with TemporaryDirectory() as directory:
root = Path(directory)
source = root / "seed.sqlite"
backup = root / "snapshot.sqlite"
with closing(sqlite3.connect(source)) as writer:
assert writer.execute("PRAGMA journal_mode=WAL").fetchone() == ("wal",)
writer.execute("PRAGMA wal_autocheckpoint=0")
writer.execute("CREATE TABLE samples(label TEXT)")
writer.execute("INSERT INTO samples VALUES (?)", ("演示订单 A",))
writer.commit()
assert writer.execute("PRAGMA wal_checkpoint(TRUNCATE)").fetchone() == (0, 0, 0)
writer.execute("INSERT INTO samples VALUES (?)", ("演示订单 B",))
writer.commit()
with closing(sqlite3.connect(backup)) as destination:
writer.backup(destination)
for label, database in [("主文件", source), ("备份", backup)]:
archive = root / f"{label}.zip"
with ZipFile(archive, "w") as bundle:
bundle.write(database, "sample.sqlite")
with ZipFile(archive) as bundle:
unpacked = Path(bundle.extract("sample.sqlite", root / label))
with closing(sqlite3.connect(unpacked)) as reader:
(status,) = reader.execute("PRAGMA integrity_check").fetchone()
records = [row[0] for row in reader.execute("SELECT label FROM samples ORDER BY rowid")]
print(label, status, records)
两行都会输出 ok。主文件只有「演示订单 A」,备份还有「演示订单 B」。
先在解压后的样例库里运行两条 SQL
用 SQLite 工具打开刚解压的数据库,执行下面两条。第二条里的表和字段换成自己的,再用查询结果对照使用说明中应当交付的记录。
PRAGMA integrity_check;
SELECT label FROM samples ORDER BY rowid;
在这个例子里,两份数据库的第一条查询都返回 ok。第二条查询在直接复制的版本只返回演示订单 A,在备份版本返回演示订单 A 和 B。交付前把应有的样例写进 README,核对具体内容。SQLite 完整性检查说明
导出样例副本,再把它放进交付包
- 单独建一份含虚构资料的样例库,确认没有真实订单、手机号、地址或付款记录。
- 导出到一个新文件。用 Python 时,可以用标准库
sqlite3的备份方法。下面的命令从样例库目录运行,release-sample.sqlite用一个尚未存在的文件名。 - 把导出的文件、工具和使用说明一起打包。用空目录解压,按说明启动工具,核对两条演示订单,并实际做一次最常用的查询或导出。
import sqlite3
from contextlib import closing
from pathlib import Path
output = Path("release-sample.sqlite")
if output.exists():
raise FileExistsError(output)
with closing(sqlite3.connect("file:seed.sqlite?mode=ro", uri=True)) as source:
with closing(sqlite3.connect(output)) as destination:
source.backup(destination)
assert destination.execute("PRAGMA integrity_check").fetchone() == ("ok",)
count = destination.execute("SELECT count(*) FROM samples").fetchone()[0]
assert count == 2, f"预期 2 条演示记录,实际 {count} 条"
samples 和记录数是这个案例的值,换成自己工具的表名与预期行数。 SQLite 在线备份文档
样例库放到只读目录时,按只读方式再验一遍
我用 Linux 上的 SQLite 3.50.4 从同一个样例库导出两份备份,确认两份备份的完整性检查都通过。每份 ZIP 都只装一个数据库文件。以普通用户把解压后的文件和目录设为不可写,然后用 mode=ro 查询。
| ZIP 里备份的日志模式 | 只读目录的查询结果 |
|---|---|
保留 WAL,目录没有 -wal 和 -shm |
SQLITE_READONLY_DIRECTORY |
| 在导出副本上改成 DELETE | 读到演示订单 A 和 B |
如果工具把样例库安装在只读目录,可在打包前仅对导出的副本执行 PRAGMA journal_mode=DELETE;,确认返回 delete。关掉连接,再把副本打包。用普通账号把 ZIP 解压到测试目录,按工具实际的只读打开方式再查一次。需要写入的工具应在可写目录创建工作库或复制样例之后再写。 SQLite 官方只读数据库说明
用个人微信或支付宝收款,确认付款后交付 ZIP
- 登录 8 码分享,在工作台打开「收款通道」。有经营收款需求时,优先用本人已开通、适合当前经营场景的个人经营收款码。
- 用微信收款时,从页面下载 Windows 微信收款助手。点「获取激活码」,上传本人微信收款码,按提示在助手里激活。用同一台电脑登录收款微信,保持微信和助手运行,刷新通道列表查看是否在线。
- 用支付宝收款时,点「新增通道」,用本人支付宝扫码。在「完成通道设置」上传收款码、填写名称并保存。通道提示需重新激活时,用原账号扫码处理。可以只开一种,也可以设置两种。
- 用通道里的「测试收款」检查页面,然后到「发布资源」选择文件,把验收过的 ZIP 放在交付内容里,填写支持的系统、启动方式、公开说明和售价,保存后复制购买链接。
- 用未登录的手机核对公开介绍和付款方式。买家按当前订单显示的金额付款,订单确认付款后,在页面自动领取 ZIP。待确认时留存订单号与付款记录,联系分享者核对。
个人收款采用预充值平台额度,订单服务费从额度扣除。新用户有 20 元免费体验额度,可以先试用,觉得合适再充值。 8 码分享收款与自动交付图文指引