那天晚上本来在改 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 查询链路。开发者测试的路径和用户实际走的路径，往往不是同一条。
为什么是「诗词一刻」？
- 轻量无负担：无需下载 App，微信搜一搜即用，用完即走
- 界面清雅：远山蓝配素纸白，现代设计融合东方气韵
- 数据丰富：覆盖先秦至清代，数万首诗词持续更新
- 完全免费：无广告，无付费墙，纯粹的诗意空间
- 开源驱动：数据源来自 chinese-poetry-api，开源生态让创造更简单
古人说，"腹有诗书气自华"。
在这个信息过载的时代，每天留一刻钟给诗词，不是怀旧，而是给自己留一片安静的天空。
微信搜索「诗词一刻」，打开就读，读完就走。
诗一直在那里，等你来。