文章总结： 本文分享了基于GitHub开源chinese-poetry-api开发微信小程序诗词一刻的实战经验。产品以无广告界面和远山蓝配色打造沉浸阅读，集成每日推荐、多维搜索、朝代分类及拼音注音等功能，并剖析了用搜索接口替代ID传参解决分享异常的踩坑细节，展现了开源数据驱动轻量应用落地的过程。 综合评分： 62 文章分类： 产品介绍,软文广告

我在GitHub刷到一个诗词API，顺手写了款小程序

原创

didiplus didiplus

攻城狮成长日记

2026年7月14日 07:00 广东

在小说阅读器读本章

去阅读

PROJECT预计阅读 9 分钟 · 共 3259 字

诗词一刻：为千年的诗句，做一个干净的前端

一个前端工程师与诗词的邂逅

改 bug 改到心烦的夜晚，习惯性打开 GitHub 刷 timeline。一个仓库的名字跳进眼里——chinese-poetry-api。先秦到清代的诗词数据，RESTful 接口，一行命令就能跑起来。于是「诗词一刻」就这么诞生了。

CHAPTER 01

01偶然的灵感

那天晚上本来在改bug，改到心烦，习惯性打开GitHub刷timeline降降火。划了几屏，一个仓库的名字跳进眼里——chinese-poetry-api[1]

点进去一看，先秦到清代的诗词数据，RESTful 接口，搜索、分类、随机获取，一应俱全。README 写得干净利落，docker compose up 一行命令就能跑起来。

我盯着屏幕愣了几秒——这么好的数据源，不接个前端太可惜了。就像你在路边看到上好的木料，手痒，想刨两下。

应用商店里的诗词 App 我也用过，开屏广告、会员弹窗、花里胡哨的界面，诗词内容挤在 banner 和弹窗之间，像菜市场里摆摊卖字画。而眼前这个仓库，数据有了，接口有了，就差一个体面的前端。

于是「诗词一刻」就这么诞生了。一刻，十五分钟，通勤路上刚好够读一首诗。

CHAPTER 02

02干净，是第一原则

打开「诗词一刻」，没有开屏广告，没有弹窗，没有底部banner。首页只有三样东西：今日推荐、快捷入口、随机一首。

这不是偷懒，是刻意为之。读诗需要心境，而心境最怕打断。每一次多余的视觉噪音，都在把用户推离诗词本身。

01

配色：远山蓝

第一版用了水墨风——深色渐变、金色点缀、印章装饰。自己觉得有文化感，发给朋友试用，反馈一致：”有点暗，不太想长时间看。”

诗词本身就有距离感，界面不该再加重这种距离。

于是全部推翻。主色换成了远山蓝 #5B7F95 ——雨后远山氤氲的颜色，清透但不冷淡。背景换成干净的浅灰白。装饰精简到最克制的程度。

改完后再发给同一批人，有个朋友说：”这个蓝色看着舒服，像下雨天靠在窗边读书。” 这就对了。

02

详情页：诗本身就是最好的装饰

诗句居中，大字号，宽行距，白底卡片。没有笺纸边线，没有水墨晕染，没有多余装饰。

试过加装饰，但窄屏上边线压缩内容区域，长句被迫换行，排版零碎。最终选择了最朴素的方式——让文字自己说话。

Hero 区域用渐变背景 + 大圆角底部，内容卡片通过负 margin 上浮叠在 Hero 上，形成自然的层次感。底部操作栏用毛玻璃效果固定在底部，不遮挡内容但始终可达。

CHAPTER 03

03每天一首，与古人对话

打开小程序，首页便是今日推荐。每天一首，不贪多，不催促，就像一位老朋友每天给你递来一封千年前的信笺。

缓存策略保证了体验——每天只请求一次接口，之后从本地存储读取。第二次打开时秒出内容，不用盯着 loading 发呆。

读完了？点一下”换一首”，随机推荐机制让每次打开都有新鲜感，你永远不知道下一首会遇见谁。

CHAPTER 04

04想找哪首？一搜便知

记得半句诗，却想不起全篇？搜索功能支持四种维度——按标题、按内容、按作者、按全部，输入任意关键词即可精准定位。

热门搜索预置了”静夜思””将进酒””水调歌头”等经典篇目，一键直达。搜索历史自动保存，下次轻点即搜。

CHAPTER 05

05穿越朝代，纵览千年

从先秦诸子到清代词章，11 个朝代的诗词尽收眼底。每个朝代都有专属卡片，一眼看清诗词数量、代表作者和年代跨度。

点进唐朝，万首唐诗扑面而来；走进宋朝，词苑千花等你采撷。上拉加载更多，每一次滑动都是一次时空旅行。

CHAPTER 06

06拼音注音，读诗无障碍

“茕茕孑立””沆瀣一气”……遇到生僻字不敢读？详情页一键开启拼音注音模式，每个字头顶都标注了清晰拼音，从此朗读古诗文再无障碍。

这个功能差点被砍掉——中文注音的多音字、轻声、变调处理起来全是坑，准确率大概 90%。直到我妈试用时看到”茕茕孑立”，问我怎么读。我给她开了拼音模式，她一个字一个字地点着看，看了很久。

📝 功能存在的意义

一个功能如果能让哪怕一小部分人从”不敢读”变成”读得懂”，它就有存在的意义。

CHAPTER 07

07收藏与历史，你的私人诗库

读到心动的诗，点个收藏；浏览过的诗词，自动记录。收藏夹和历史记录随时翻阅，你的阅读轨迹就是一部个人诗词编年史。

01

学习热力图，让坚持看得见

个人中心的签到热力图，灵感来自 GitHub 贡献图。每天读诗自动打卡，色块深浅代表阅读频次。连续打卡天数一目了然，让”每天读一首诗”不再是空话。

CHAPTER 08

08分享，让诗意流动

读到一首好诗，想分享给朋友？一键转发，对方点开就能直接阅读。分享链接通过搜索接口加载，不依赖 ID 查询，确保每次打开都稳定可靠。

这个细节是踩过坑才想明白的——最初用 ID 传参，分享出去的链接别人打开一直转圈。因为本地调试时数据是缓存传入的，根本没走过 ID 查询链路。开发者测试的路径和用户实际走的路径，往往不是同一条。

CHAPTER 09

09为什么是「诗词一刻」？

轻量无负担界面清雅数据丰富完全免费开源驱动

轻量无负担：无需下载 App，微信搜一搜即用，用完即走

界面清雅：远山蓝配素纸白，现代设计融合东方气韵

数据丰富：覆盖先秦至清代，数万首诗词持续更新

完全免费：无广告，无付费墙，纯粹的诗意空间

开源驱动：数据源来自 chinese-poetry-api，开源生态让创造更简单

腹有诗书气自华

在这个信息过载的时代，每天留一刻钟给诗词，不是怀旧，而是给自己留一片安静的天空。

即刻体验

微信搜索「一念清词」

打开就读，读完就走

诗一直在那里，等你来。

参考资料

[1]chinese-poetry-api：https://github.com/palemoky/chinese-poetry-api

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：攻城狮成长日记 didiplus didiplus《我在GitHub刷到一个诗词API，顺手写了款小程序》