NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #562 by repository stars
Latest stable
v0.8.0
Last release 19 days ago
03 Nov 2026
Ships on a steady schedule
a new release about every 2 months
Most releases are documented
notes for 22 of 25 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
27 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
search: 关键词搜索支持按朝代筛选,REST 用 dynasty 或 dynasty_id,GraphQL 用 dynastyId,MCP 用 dynasty
dynasty 或 dynasty_id,GraphQL 用 dynastyId,MCP 用 dynasty (bcc55d7)Poem.id 字段与 poem(id:) 查询:诗词 ID 每次数据发布都可能变化 (17c2714)type=唐诗 不再查不到诗词 (8ecab9a)statistics 按 lang 参数返回对应简繁写法的朝代名 (36a7617)| 项目 | 数量 |
|---|---|
| 诗词总数 | 343333 |
| 作者数量 | 13646 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.zst |
统一数据库(包含简体和繁体表),zstd 压缩,解压:zstd -d --long=27 poetry.db.zst |
poetry.db.gz |
同一数据库的 gzip 压缩版,内容相同、体积更大 |
poetry-vectors.db.zst |
语义检索用的向量文件(可选),须与同一版本的数据库一起使用,解压:zstd -d --long=27 poetry-vectors.db.zst |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
Your coding agent can read these notes before it upgrades. Set up the MCP server →
vectors: 新增向量文件格式及数据处理的 embed 命令
semanticSearchPoems 查询,触发限流时耐心等待重试 (4d7cb58)Author.poems 跟随外层查询的 lang 参数 (44a2969)database.path 及 DB_PATH 环境变量 (476edf5)EMBEDDING_API_URL 后不再丢失向量文件的默认路径,Docker 中能正常开启语义检索 (1655471)runEmbed 以满足 gocyclo 圈复杂度检查 (19b473d)/poems 支持更多筛选条件 (e045d6e)lang 参数未正确切换简繁体数据的问题 (0a360f0)| 项目 | 数量 |
|---|---|
| 诗词总数 | 343333 |
| 作者数量 | 13646 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.zst |
统一数据库(包含简体和繁体表),zstd 压缩,解压:zstd -d --long=27 poetry.db.zst |
poetry.db.gz |
同一数据库的 gzip 压缩版,内容相同、体积更大 |
poetry-vectors.db.zst |
语义检索用的向量文件(可选),须与同一版本的数据库一起使用,解压:zstd -d --long=27 poetry-vectors.db.zst |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
database: REST 与 GraphQL 的诗词列表统一按 ID 升序排列
/poems 支持更多筛选条件 (e045d6e)lang 参数未正确切换简繁体数据的问题 (0a360f0)| poetry.db.gz | 统一数据库(包含简体和繁体表) |
| 项目 | 数量 |
|---|---|
| 诗词总数 | 371313 |
| 作者数量 | 13577 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.gz |
统一数据库(包含简体和繁体表) |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
| poetry.db.gz | 统一数据库(包含简体和繁体表) |
| 项目 | 数量 |
|---|---|
| 诗词总数 | 371313 |
| 作者数量 | 13577 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.gz |
统一数据库(包含简体和繁体表) |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
deps: 启用 Dependabot 自动更新 Go 模块与 GitHub Actions
新增 (type_id, id) 索引,随机诗词改为按 ID 选取,不再使用 OFFSET
(type_id, id) 索引,随机诗词改为按 ID 选取,不再使用 OFFSET (3dd51c8)### ✨ 新功能 - 诗词类型 ID 支持批量查询与缓存
| poetry.db.gz | 统一数据库(包含简体和繁体表) |
| 项目 | 数量 |
|---|---|
| 诗词总数 | 383123 |
| 作者数量 | 13577 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.gz |
统一数据库(包含简体和繁体表) |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
### ✨ 新功能 - k6 峰值压测目标从 1000 提高到 3000 并发用户 (c81fe1d) - 随机诗词改用密码学安全的随机数,并按 offset 选取 (1a572b5) - 随机诗词支持同时按多个诗词类型筛选
### ✨ 新功能 - 数据处理前预热朝代与作者缓存,避免 SQLite 锁竞争 (239533f) ### ♻️ 重构 - Dockerfile 移除非 root 用户及显式属主设置
Nothing published for this version
| poetry.db.gz | 统一数据库(包含简体和繁体表) |
| 项目 | 数量 |
|---|---|
| 诗词总数 | 383123 |
| 作者数量 | 13577 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.gz |
统一数据库(包含简体和繁体表) |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
### ♻️ 重构 - 精简 GitHub 工作流命名 (b5d55da) - 改进 Dockerfile 中应用目录的属主设置
优化 Dockerfile:提前 USER 指令,使用 COPY --chmod 设置权限
USER 指令,使用 COPY --chmod 设置权限 (f4f1cb9)### ✨ 新功能 - 数据库下载增加校验和验证,改进更新检查 (6f1a539) ### 🔒 安全 - 容器改为以非 root 用户运行 (0339a8d) ### 📝 文档 - 更新 README
### ♻️ 重构 - 移除独立的 search 包,抽取公共方法并补充集成测试
### ✨ 新功能 - 随机诗词改用 ORDER BY RANDOM() 实现 (2260476) - 数据库仓储层按统计、写入、查询拆分模块 (becbdf8) ### ⚡ 性能优化 - 调整 k6 压测的请求耗时阈值
### ✨ 新功能 - 新增常规负载压测,调整 k6 峰值与压力测试配置 (30580ba) - 诗词搜索支持指定搜索类型和分页 (2e27e1c) ### ♻️ 重构
### ✨ 新功能 - 随机诗词支持按作者、类型、朝代筛选 (c87a554) - 随机诗词的筛选条件不存在时返回 404 (b59d53e) - 数据库连接池大小根据 CPU 核数自适应 (2b13c84) - 新增多场景的 k6 压测脚本及说明文档 (7b2371a) ### 📝 文档 - 补充
| poetry.db.gz | 统一数据库(包含简体和繁体表) |
| 项目 | 数量 |
|---|---|
| 诗词总数 | 383123 |
| 作者数量 | 13577 |
| 朝代数量 | 11 |
| 文件 | 说明 |
|---|---|
poetry.db.gz |
统一数据库(包含简体和繁体表) |
checksums.txt |
SHA256 校验和 |
API 通过 ?lang= 参数切换:
zh-Hans - 简体中文(默认)zh-Hant - 繁体中文容器启动时会自动下载数据库,无需手动下载。
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest
详细使用说明请参考 README
data/ 目录 (f6df414)created_at (d30f93a)lang 参数切换简繁体 (f535360)data/ 目录 (ab99d38)rhythmic 字段,词牌名并入标题 (8092be2)Poem.paragraphs 更名为 content,移除 Poem.createdAt 与 Author.description (3f0eece)Nothing published for this version
Nothing published for this version
Docker 构建加入 Go 编译缓存,CI 按需选择构建平台
Nothing published for this version
### ✨ 新功能 - 以子模块方式引入 chinese-poetry 数据集 (ccf79f2) - 实现诗词数据处理 (ac982e4) - 实现 API 服务 (d890a3d) - 实现 GraphQL API (85a8ab2) - 支持 Docker 部署 (f4b2abe) - 新增
DATABASE_MODE 改用数值配置 (14c7d01)One column per month.