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

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

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

说到使用者痛点。市面上的诗词 App 让人抓狂

应用商店里的诗词 App 我也用过开屏广告、会员弹窗、花里胡哨的界面诗词内容被挤在 banner 和弹窗之间，像菜行业市场里摆摊卖字画。使用者真正想要的是纯粹的文字，而不是被各种营销噪音打断。

从 API 到小程序：把痛点转化为机会

有了 chinese-poetry-api 的数据与接口。我决定建立一个「诗词一刻」——在通勤路上只需十五分钟，就能读完一首好诗。

干净，是第一原则

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

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

说到配色，远山蓝。让阅读更舒适

第一版用了水墨风——深色渐变、金色点缀、印章装饰。朋友们反馈这方面，“有点暗，不太想长时间看。”于是全部推翻，将主色换成 远山蓝 #5B7F95——雨后远山氤氲的颜色，清透但不冷淡；背景换成干净的浅灰白，

新配色发布后有朋友说：“这个蓝色看着舒服，像下雨天靠在窗边读书。说起来，”这正是我们想要的阅读氛围。

再看详情页。让诗本身成为最好的装饰

诗句居中，大字号，宽行距，白底卡片。去掉笺纸边线、水墨晕染等多余装饰，让文字自己说话。怎么说呢，

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

每天一首，与古人对话

首页即为今日推荐。每天只请求一次接口并缓存至本地存储，打开秒出内容，无需等待 loading。怎么说呢，

阅读完毕后点击“换一首”。随机推荐机制保证每次打开都有新鲜感，让使用者永远不知道下一首会遇见谁。

快速搜索这方面，半句也能定位

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

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

穿越朝代·纵览千年

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

• 唐朝：万首唐诗扑面而来；
• 词苑千花等你采撷；

上拉加载更多，每一次滑动都是一次时空旅行。

从拼音注音来看，读诗无障碍

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

收藏与历史的观点是，你的私人诗库

喜欢的诗可以收藏；浏览过的自动记录，收藏夹和历史记录随时翻阅，你的阅读轨迹就是个人专属的编年史。

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

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

从分享功能来看，让诗意流动

好诗想分享？一键转发，对方打开即可直接阅读。分享链接通过搜索接口加载，不依赖 ID 查询。以避免因缓存导致的转圈问题。不过，

为什么选择「诗词一刻`」？

• 轻量无负担：无需下载 App。微信搜一下即用，用完即走；
• 界面清雅：#5B7F95 远山蓝配素纸白，现代设计融合东方气韵；
• 数据丰富：
• 完全免费：
• a chinese-poetry-api,开源环境让创造更简单。按理说，

"腹有诗书气自华"