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

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

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

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

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

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

干净，是第一原则

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

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

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

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

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

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

这就对了。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

古人说，"腹有诗书气自华"。

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

微信搜索「一念清词」，打开就读，读完就走。

诗一直在那里，等你来。