返回更新记录
v1.0.0

SQLite 零配置单机模式(首次对外发布) (v1.0.0)

单二进制 + 单 .db 文件即可运行,无需 PostgreSQL 与 Redis;与生产 PG 路径并存,检索能力完整,PG 路径零回归。

SQLite单机模式首次发布

v1.0.0 是琅嬛的首次对外发布。这个版本最重要的变化不是加了多少功能,而是补上了一条完全不同的部署路径:SQLite 零配置单机模式,让「一个二进制 + 一个 .db 文件」就能跑起来,不再强制要求 PostgreSQL 和 Redis。

现在可以直接从下载页获取 macOS(Apple Silicon / Intel)、Linux、Windows 的预编译二进制,解压即用。

单机模式:一条命令起步

以前琅嬛的最低依赖是 PostgreSQL + pgvector + zhparser + Redis,首次体验要先拉起整套 docker compose。v1.0.0 起,直接运行二进制即可:

make standalone   # 或 go run ./cmd/langhuan,或直接 ./langhuan

首次启动会自动在 ~/.langhuan-data/ 生成 SQLite 数据库、加密密钥与配置文件,打开 http://127.0.0.1:8080 注册管理员即可开始导入文档与检索。

两条技术栈并存

单机模式没有简单地把 PostgreSQL 换成 SQLite 完事,而是为检索能力做了方言级适配:

  • 向量检索:生产走 pgvector(halfvec + HNSW);单机走 sqlite-vec 暴力扫描——召回率是精确解的 100%,代价是没有 ANN 加速,适合数万条 embedding 以内的规模。
  • 中文全文检索:生产走 PostgreSQL FTS + zhparser;单机走 FTS5 + gse(纯 Go 中文分词,词典内嵌进二进制)。
  • 队列 / 限流 / OIDC state:单机模式全部本地化——内存队列、内存限流器、内存 state store,Redis 可整体禁用。

检索能力本身保持完整:向量 + 中文全文 + RRF 融合 + rerank,一条不少。

能力边界,如实说明

单机模式定位是开发、演示与小团队试用,有几条边界值得知道:

  • 建议数据量 < 数万条 embedding(向量为暴力扫描)。
  • 写并发串行(SQLite 单写锁)。
  • 内存队列在进程退出时会丢失未完成任务,由 source cleanup 与用户重试补偿。

生产高并发、大数据量场景仍走 PostgreSQL + Redis 部署。

首次对外发布

v1.0.0 冻结了 REST、MCP、认证与错误码的兼容基线,作为对外承诺的接口边界。整个 SQLite 改造全程以「PG 路径零回归」为硬约束,经过两轮代码评审,现有 PostgreSQL 测试套件全部通过。

实现细节见 SQLite 支持设计规格 与 架构文档。