轻诗阁——复赛升级：从古韵诗词到工程级全栈平台，AI赋能传统文化传承

TRAE AI 创造力大赛 【大赛复赛专区】
,
1

参赛赛道：TRAE AI 创造力大赛 · 学习工作（融合古籍活化、青少年美育、智慧助老社会公益方向）

作品类型：全栈 Web 应用（前端 + 后端 + 数据库 + WebSocket + AI）

报名帖： 「学习工作」轻诗阁——轻松学习，便捷分享，让AI帮你看景不WOC

初赛帖： 「学习工作」轻诗阁——轻松学习，便捷分享，最棒的学习诗歌工具

各位评委、道友好！我是轻诗阁的开发者。初赛阶段，我以“让古诗词学习不再枯燥”为初心，完成项目功能雏形。进入复赛，我结合产品真实痛点、用户体验短板与工程化规范，对项目进行全方位架构重构、技术深度升级、内容体量暴涨、安全体系补齐、公益价值落地。轻诗阁现已从简单演示 Demo，迭代为具备生产级稳定性、面向大众普惠、兼具美育与公益价值的全栈传统文化平台。以下为本次复赛完整作品说明。

一、产品简介

1.1 项目定位

轻诗阁是一款AI 赋能古籍活化、轻量化诗词美育、游戏化文化传播的现代化 Web 全栈平台。项目秉持「让每一首诗都有温度」的核心理念，解决传统诗词学习枯燥、学用脱节、古籍门槛高、文化传播形式单一等社会普遍问题。

平台以科技赋能传统文化，将晦涩的古典文献、千年诗词意境，转化为可学习、可互动、可对战、可场景化、可社交传播的新时代文化体验，真正实现古籍活化、美育落地、文化普惠。

产品形态：Web 全栈应用（前端 + Node.js 后端 + SQLite 数据库 + WebSocket 实时通信 + AI 混合调度架构）

面向人群：中小学生、青少年美育群体、诗词爱好者、传统文化学习者、普通大众（未来延伸银发助老群体）

1.2 核心功能矩阵

复赛在初赛基础上完成全面功能迭代，构建八大成熟业务模块，覆盖学习、练习、对战、AI 创作、社区社交、虚拟激励、后台管理全链路。

功能模块 功能说明 技术亮点
每日画卯签到 全屏诗意卡片签到、每日赏诗、文铢激励、动态涟漪交互，养成每日读诗习惯 千级诗意关键词智能配图 + 三层兜底加载链
学院学习系统 艾宾浩斯记忆复习、学习日历、错题归集、个人学习数据可视化看板 序列号竞态保护 + 个性化学习路径
海量诗库 数万首诗词全覆盖，支持标题、作者、朝代、意象、情感多维度检索 28类诗意分类 + 全库意境图文匹配
游园游戏体系 飞花令、诗词接龙、你画我猜、实时PK联机对战，趣味化诗词巩固 WebSocket实时通信 + 多房间管理 + 心跳重连
AI工坊 AI识图寻诗、AI智能作诗、场景化诗词推荐，实景与古籍诗意联动 本地规则引擎+远程LLM混合AI架构
闲居里社区 诗词动态、作品分享、评论互动、诗友交流，构建诗意社区 XSS防护 + 实时动态更新
文铢集市 公益虚拟激励体系，学习攒积分、兑换文化道具，提升学习粘性 事务原子性守卫 + 并发安全控制
后台管理系统 诗词、题库、用户、社区、商品全量管理与数据统计 RBAC鉴权 + 双重限流 + 全链路监控

【运行截图：首页全屏画卯签到界面】展示全屏水墨诗意背景、画卯签到卡片、天气信息层、涟漪交互动画效果

【运行截图：游园游戏大厅界面】展示飞花令、你画我猜、诗词接龙、PK对战四大游戏入口与国风视觉设计

1.3 数据规模（复赛全新升级）

数据类型 数量 说明
诗词数据 77,888 首 覆盖先秦至清代，全部含配图、译文、赏析、注解
诗人档案 647 位 结构化重点诗人信息，全库去重作者共4,478位
飞花令题目 4,008 条 100+关键字，单关键字题库5-61条不等
答题题目库 556,679 条 适配诗词练习、随堂竞答、趣味闯关场景
寻花令题目 362,004 条 专属轻诗阁趣味诗词游戏题库
诗词地理位置 416 条 诗词地理场景标注数据
节气数据 24 条 完整二十四节气传统文化素材
AI意象关键词 56 个 精准映射18种诗词意境，支撑本地AI识别
Hero推荐诗词池 5,932 条 首页每日随机诗意推荐库
代码文件 273 个 JS 167 + HTML 51 + CSS 55
代码总行数 约 11.7 万行 前后端+数据脚本完整工程代码
API接口 50+ 个 RESTful 业务接口 + WebSocket 实时协议

三、复赛优化与更新内容（核心亮点）

本次复赛从工程架构、AI能力、并发安全、视觉体验、安全防护、数据体量六大维度完成跨越式升级，彻底从“演示项目”升级为可长期运营的公益文化平台。

3.1 :wrench: 工程级技术架构全面升级

（1）WebSocket 实时对战系统：彻底淘汰HTTP轮询

初赛采用轮询机制延迟高、占用资源大。复赛自研完整 WebSocket 全双工通信体系，实现真正低延迟联机对战。

核心能力：全局单例服务、多房间隔离、30s双向心跳检测、断线指数退避重连、全局兜底清理、房间切换原子操作，彻底杜绝幽灵用户、对战卡顿、状态错乱问题。

Session ID：

80730852164684:e6029f4d08c771a856da32613d6288d6_6a6ecf0fbfe5182043580d3e.6a6f02b8bfe518204358158d.6a6f02b8bfe518204358158b:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/2 16:41:28)

代码截图：WebSocket核心通信架构 + TRAE调试记录

截图：双人实时PK对战实操界面

核心能力：全局单例服务、多房间隔离、30s双向心跳检测、断线指数退避重连、全局兜底清理、房间切换原子操作，彻底杜绝幽灵用户、对战卡顿、状态错乱问题。

（2）双重限流策略：滑动窗口 + 令牌桶组合防御

为保障公共文化服务稳定，项目搭建双层限流体系：粗粒度1分钟滑动窗口控总量，细粒度惰性令牌桶抗突发流量。区分登录用户与访客限流规则，搭配内网、健康检测、公共接口白名单，兼顾安全性与可用性。

Session ID：80730852164684:15aa7734bcfe3afda27bf8669b846992_6a6ecf0fbfe5182043580d3e.6a707a2095b94a92c79b54d9.6a707a2095b94a92c79b54d7:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/3 19:23:12)

截图：双重限流算法完整源码 + TRAE架构设计对话

（3）全链路可观测系统：P50/P95/P99性能监控

新增环形缓冲日志、响应时延分位数统计、慢请求告警、错误指纹聚合、敏感信息脱敏、回调注入解耦，让平台运行状态可视化、异常可追溯、风险可预警，达到生产级运维标准。
Session ID：80730852164684:dd2d5a8436d5cf54ff286c035eea7a9c_6a6ecf0fbfe5182043580d3e.6a706bab95b94a92c79b5319.6a706bab95b94a92c79b5317:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/3 18:21:31)

截图：全链路监控系统 + 性能统计逻辑

（4）AI混合架构：本地规则引擎优先，远程LLM优雅降级

摒弃初赛纯远程API依赖，自研三段式智能决策：56组本地意象关键词毫秒级匹配、置信度0.7分水岭智能判断、0.95上限预留AI优化空间。既保证极速响应，又保留大模型高阶创作能力，成本更低、稳定性更强。

Session ID：80730852164684:99cddb7ca62c9bc6b8be6a4248cee73d_6a6ecf0fbfe5182043580d3e.6a70729c95b94a92c79b53d4.6a70729c95b94a92c79b53d2:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/3 18:51:08)

截图：AI混合决策引擎核心

运行截图：AI识图寻诗功能实操界面

（5）事务原子性三重守卫：彻底解决并发竞态风险

针对积分扣除、道具兑换、卡片解锁等高并发场景，搭建「应用预检 + 数据库条件锁 + 事务回滚校验」三层安全机制，配合资金流水全量审计，保证公益激励体系绝对公平、数据零错乱。

3.4 :artist_palette: 用户体验与视觉体系重构

（1）智能配图三层兜底，彻底修复模糊问题

失效源自动过滤、关键词高清配图、种子稳定配图、本地兜底图四层策略，全库七万余首诗词全部实现高清意境展示，画面质感大幅提升。

（2）移动端导航完全重构

移除初赛双导航混乱问题，统一侧边抽屉体系，实现幂等注入、防抖适配、滚动锁定，移动端体验干净统一、适配所有屏幕。

（3）全局统一国风视觉设计系统

确立墨青、朱砂、描金专属国风三色体系，统一字体层级、圆角、动画、后台配色，删除杂乱紫色风格，整体风格典雅统一、极具传统文化质感。

【运行截图：优化后后台管理全景界面】

3.5 :locked: 全方位安全加固

完成全项目安全审计，修复鉴权缺失、XSS注入、不安全解析、并发竞态、弱密码风险、接口路径不统一等全部隐患，构建完整安全防线。

3.6 :mobile_phone: 移动端深度优化与适配

初赛阶段项目移动端适配体系不完善，导航逻辑混乱、动画性能冗余、弱网加载体验差、触摸交互不规范，未形成系统化适配方案。复赛阶段围绕导航重构、性能策略、响应式布局、触摸交互、图片加载五大核心维度，完成全页面、工程级移动端深度优化，实现全机型流畅适配、合规交互、极致性能。

（1）导航系统重构——彻底摒弃双导航，统一纯侧边抽屉架构

初赛移动端存在底部Tab Bar与侧边抽屉双导航并存的缺陷，页面层级混乱、操作逻辑冲突，极易造成用户误触。复赛完全重写移动端导航体系，自研独立的 mobile-drawer.js 核心模块，彻底解决导航乱象。

核心架构设计：采用 IIFE 隔离 + 严格模式开发，杜绝全局变量污染，仅对外暴露唯一可控接口，保障代码安全性与独立性。搭建三件套注入式架构，统一移动端导航入口：

  • injectDrawer()：负责渲染侧边抽屉主体，包含遮罩层、导航面板、品牌标识、菜单列表、页脚信息完整结构
  • injectHamburger()：生成左上角汉堡动画按钮，支持展开/收起状态动态切换
  • injectMobileSearch()：注入右上角悬浮搜索按钮，实现移动端快速检索入口

同时加入幂等性保护机制，所有注入逻辑执行前优先检测DOM节点是否存在，杜绝重复初始化、组件堆叠bug。采用数据驱动菜单设计，通过统一数组配置定义7项核心菜单，与PC端导航顺序、功能完全同步，当前页面自动高亮匹配，保证多端体验一致性。

适配逻辑精准对齐，以768px为核心响应式断点，与CSS媒体查询阈值完全统一；添加200ms窗口缩放防抖逻辑，横竖屏切换、窗口缩放时自动适配导航形态，窄屏切宽屏自动关闭抽屉、隐藏移动端专属按钮。抽屉展开时锁定页面滚动，杜绝背景穿透滑动问题。

CSS动画视觉优化：通过 transform 单独触发GPU合成层，避免页面重排重绘，抽屉320ms线性缓动过渡流畅丝滑；采用 visibility + pointer-events 替代传统 display 切换，保留完整过渡动画效果。导航按钮、搜索悬浮按钮均采用38×38px圆形毛玻璃设计，搭配hover放大1.06倍、active按压缩小0.94倍的触觉反馈，贴合移动端交互直觉。

Session ID：

80730852164684:3020657e2272609e6ba94eb6562ea1cf_6a6ecf0fbfe5182043580d3e.6a707d5b95b94a92c79b5533.6a707d5b95b94a92c79b5531:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/3 19:36:59)

截图：移动端导航核心

（2）性能策略——移动端装饰性动画精准关停，极致减负

为解决移动端低端机型动画卡顿、帧率不足问题，复赛制定窄屏全量关停装饰动画的核心性能策略，而非简单降配，从根源减少移动端渲染压力。

JS双重门控机制：通过 matchMedia 媒体查询精准区分设备尺寸，远山视差滚动动画仅在桌面端生效，移动端直接跳过监听绑定；花瓣飘落粒子特效仅在桌面端注入DOM结构，移动端零节点、零渲染、零资源占用。全局滚动监听统一配置 passive: true 参数，避免滚动事件阻塞页面渲染，提升滑动流畅度。

移动端粒子系统精准降配：针对保留核心动态效果，优化粒子渲染参数，大幅降低设备算力消耗：最大粒子数量从18个精简至12个，减少33%DOM节点；粒子生成间隔从2200ms延长至3000ms，降低动态刷新频率；粒子最大尺寸从14px缩小至12px，缩减渲染面积；调整轻量粒子占比，进一步减负。

粒子引擎底层优化：基于 requestAnimationFrame 驱动动画渲染，按时间增量精准更新粒子位置；粒子移出视口立即执行节点删除与数组裁切，杜绝内存泄漏；随机抖动粒子生成间隔，避免帧同步卡顿，保障移动端长期运行稳定。

（3）图片加载三重保险——弱网场景专属适配，杜绝空白卡顿

基于 image-loader.js 搭建移动端专属图片加载优化链路，结合懒加载、并发限流、多级兜底策略，完美适配移动端弱网、网络波动场景，大幅提升加载体验。

视口预加载 + 并发限流：采用 IntersectionObserver 实现图片懒加载，设置100px前置预加载阈值，用户滚动至可视区域前完成图片加载，实现即看即显；设置最大3张图片同步加载的并发上限，避免弱网下批量请求挤占带宽、拖垮页面。搭配令牌桶调度机制，动态填充加载队列，平衡加载效率与设备性能。

多级重试与确定性兜底降级：图片加载失败自动重试2次，采用1s、2s线性退避策略，适配网络波动场景；多次加载失败后，通过诗词唯一种子哈希算法，从5957张本地高清图库中确定性匹配兜底配图，同一首诗词移动端、PC端兜底配图完全一致，杜绝随机错乱。仅二次兜底失败后才标记异常状态，保留页面卡片完整结构，无空白塌陷问题。

Session ID：

80730852164684:1d0507c41bb04a69f091ed3c62d5b6bd_6a6ecf0fbfe5182043580d3e.6a707ebd95b94a92c79b5573.6a707ebd95b94a92c79b5571:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/3 19:42:53)

代码截图：图片加载优化

（4）七档精细化断点响应式布局，全设备覆盖

摒弃传统粗粒度适配方案，复赛搭建七档梯度断点体系，覆盖大屏、平板、小屏、超窄屏全设备场景，每一档位精准适配布局、字号、组件形态，实现千人千屏的适配效果。

断点 适配场景 核心适配调整
1024px 平板/中屏设备 隐藏冗余搜索栏、压缩导航间距、数据统计面板改为双列布局
960px 商品详情页适配 主体内容由多列转为单列，优化内容排版密度
900px 诗人库、好友页面 诗人卡片双列排布，好友页面自适应单列
768px 移动端核心断点 全局单列布局、字号统一降级、激活侧边抽屉导航
640px 手机窄屏设备 集市横幅压缩优化，购买操作按钮纵向排列
600px 超窄屏手机 诗人卡片、首页欢迎页全部自适应单列居中
480px 极小屏设备 登录表单紧凑适配，商品网格完全单列展示

系统化字号降级适配（768px移动端断点），兼顾美观与阅读舒适度：诗词标题36px降至32px、诗句正文20px降至18px、译文赏析15px降至14px，同步优化行高、字距，适配移动端阅读习惯；统计数据、天气字体同步缩小，避免文字溢出。

核心布局方向翻转：诗人头部、个人资料卡片、商品购买操作区等模块，从桌面端横向布局自动切换为移动端纵向居中布局，贴合手机浏览视角。

（5）触摸交互专项优化，符合移动端人机规范

针对移动端触摸操作特性，全方位优化交互细节，解决误触、滑动卡顿、无反馈、适配异形屏等行业常见问题，提升操作手感与易用性。

优化项 具体实现方案 对应文件
标准触摸目标尺寸 抽屉菜单项52px、悬浮按钮38px、返回顶部42px，贴近行业44px黄金阈值，杜绝误触 style.css / pages.css
iOS惯性滚动适配 横向滚动容器开启-webkit-overflow-scrolling: touch，还原丝滑滚动手感 pages.css
按压触觉反馈 按钮hover放大1.06倍、active按压缩小0.94倍，模拟实体按键按压反馈 style.css
背景滚动锁定 抽屉展开时锁定页面滚动，彻底解决背景穿透滑动问题 mobile-drawer.js
禁止页面缩放误触 核心页面配置user-scalable=no，杜绝双击、双指误缩放 HTML viewport
异形屏适配 特殊页面配置viewport-fit=cover，适配刘海屏、挖孔屏、曲面屏 HTML viewport
聚焦可视优化 开启:focus-visible专属聚焦轮廓，键盘导航、触屏点击状态清晰可辨 style.css
无阻塞滚动监听 全局滚动事件统一开启passive:true，避免阻塞主线程 brand-motion.js / footer.js

（6）移动端适配全覆盖与技术总结

适配覆盖范围：全站48个HTML页面全部接入统一移动端抽屉导航体系；配置三类viewport适配方案，覆盖标准屏、异形屏、防误触场景；21处专属媒体查询覆盖所有核心页面；彻底废弃初赛底部Tab导航，全局屏蔽冗余样式，完成移动端架构完全迁移。

技术方向 核心实现亮点 设计模式
导航重构 IIFE作用域隔离 + 三件套注入 + 幂等防重初始化 注入模式 + 响应式适配
性能策略 媒体查询门控动画 + 装饰效果全关停 + 无阻塞滚动 防御性编程
图片加载优化 懒加载预载 + 3并发限流 + seed哈希多级兜底 令牌桶调度 + 责任链降级
响应式布局 七档精细化断点 + 分级字号降级 + 布局自适应翻转 渐进式适配降级
触摸交互优化 合规触摸目标尺寸 + 全场景手感反馈 + 异形屏适配 移动端可访问性合规设计

3.7 :books: 文库体系扩展 · 典籍活化深度落地（8月4日迭代）

本次最新迭代聚焦古籍活化深度落地、产品架构规整、用户阅读体验优化、工程稳定性升级四大方向，彻底打破初赛仅单一诗词库的局限，完成「诗词、诗人、典籍」三栈文库架构重构，新增海量经典典籍结构化数据，同步优化全链路交互细节、AI视觉模块、适配部署与缓存策略，让古籍文化传播从“诗词普及”升级为“完整典籍体系活化”。

（1）全新典籍库上线：九部传世典籍结构化整编入库

本次迭代重磅新增独立典籍库专属页面 classics-library.html，精选九大传世经典古籍，包含四大名著（《红楼梦》《三国演义》《水浒传》《西游记》）与五部国学经典（《道德经》《周易》《诗经》《论语》《山海经》），完成201篇典籍诗词条目全结构化整编入库，填补平台经典典籍内容空白。

数据库针对性扩展三大专属字段，精准溯源每一首典籍诗词的文化出处，实现精细化内容标注：

  • sourceBook：精准标注所属典籍名称，实现典籍分类检索
  • sourceChapter：完整记录对应章节、回目名称，还原原文场景
  • depictedFigure：精准标注诗词描写核心人物，适配名著人物赏析场景

同时完成专属视觉配套升级，为201篇典籍诗词独立生成专属AI意境配图，统一存放于本地专属资源目录，依托典籍章节情节定制生成Prompt，保证画面与原著内容、场景、意境高度契合，真正实现一诗、一景、一回目、一典籍的沉浸式古籍阅读体验。

（2）文库三栈架构重构：分层清晰，各司其职

全面重构文库主页 poem-library.html，将原杂乱的诗库结构升级为诗词库、诗人库、典籍库三栈独立架构，三大功能入口可视化分区展示，层级清晰、定位明确，彻底解决旧版内容混杂、用户查找困难的问题，构建完整的古典文化检索体系：

  • 诗词库：承载全站77888首全量古诗词，满足大众诗词学习、检索、赏析基础需求
  • 诗人库：聚合647位重点诗人结构化档案，实现作者维度的文化溯源与学习
  • 典籍库：承载九大典籍201篇经典诗文，聚焦传世古籍活化与国学深度学习

（3）典籍专属筛选体系：标签检索 + URL深链 + 视图隔离

为适配全新典籍库能力，深度升级全局搜索体系，在 search.js 新增典籍专属筛选栏，支持用户点击典籍标签，快速过滤对应典籍的全部诗文，一键精准检索名著、国学经典内容。

新增URL深链传播能力，支持通过 ?sourceBook=红楼梦 等参数直达对应典籍筛选页面，便于社区分享传播、适配搜索引擎收录，提升文化内容传播广度。同时修复旧版交互Bug，通过classics-mode根类名 + 内联优先级样式双重隔离机制，彻底解决典籍筛选模式下全局搜索UI错乱、标签异常切换的问题，保证典籍视图纯净展示。后端同步新增 /api/poems/classics-all 专属接口，支持一次性返回全部201条典籍数据，提升典籍页面加载与渲染效率。

（4）诗词详情页轻量化精简，聚焦核心阅读体验

基于用户真实阅读反馈，对诗词详情页 poem.js 进行精细化减负优化，剔除冗余、小众模块，梳理清晰阅读动线，让用户专注诗词核心内容：

  • 移除需积分解锁的「深度解析」模块，消除阅读门槛，实现内容普惠
  • 移除专业性过强的「格律详解」模块，降低普通用户阅读门槛，适配大众美育场景
  • 精简「千古名句」模块，移除冗余配图，仅保留核心名句文本，页面排版更简洁清爽

同步修复页面视觉瑕疵，优化 pages.css 详情页顶部内边距，解决首页Hero诗词图被固定导航栏轻微遮挡的问题，保障诗词详情页首屏视觉完整、观感舒适。

（5）首页每日诗词可点击升级：打通展示到学习的转化链路

升级首页核心学习模块，为 index.html 首页 Hero 区每日画卯诗词卡片新增点击跳转能力，在 home.js 新增专属跳转函数，用户完成每日签到后，可直接点击当日诗词卡片进入详情页深度阅读、赏析学习。

同时优化视觉交互反馈，新增 pointer 鼠标样式与 hover 悬浮上浮动效，强化可点击视觉提示，将原本单纯的“展示型每日诗词”，升级为主动学习型转化入口，完善轻量化日常诗词学习闭环。

（6）AI视觉模块全面重构：双栏会话体系，交互更专业

对 ai-vision.html 识图寻诗模块进行架构级布局重构，告别杂乱堆砌布局，打造专业化AI交互界面：

  • 左侧新增240px固定宽度会话历史面板，支持会话创建、切换、重命名、删除，完整记录AI识图、作诗会话记录
  • 采用 localStorage 持久化存储会话数据，刷新页面、重启网站均不丢失历史记录
  • 优化功能布局，将每日诗词、快捷指令整合为对话框底部轻量化按钮，精简页面布局
  • 移除「使用提示」「诗词灵感」等冗余区块，页面聚焦核心识图、AI创作功能
  • 完成全尺寸响应式适配，平板设备自适应缩放面板，移动端自动转为横向标签布局，适配多端使用场景

（7）识图二维码故障修复 + 自动刷新，彻底解决加载异常

针对性修复AI识图寻诗模块二维码失效问题：原CDN资源版本返回404无法加载，本次替换为稳定开源资源库，采用原生matrix生成API直接绘制Canvas二维码，彻底解决资源加载报错问题。

新增多重容错机制：配置30秒自动刷新策略，切换识图标签页时自动更新二维码并携带时间戳防缓存；新增8次重试机制（250ms/次），资源加载失败时自动重试；最终兜底「复制扫码链接」功能，极端场景下降级为文本链接，保证功能100%可用、无死场景。

（8）工程化细节迭代，提升项目稳定性与部署适配性

本次迭代同步完成多项工程化细节优化，适配线上生产环境，提升项目稳定性、兼容性与可维护性：

  • 集市内容去重优化：过滤文铢集市飞花令提示道具卡片，避免与游戏内原生道具入口重复，统一功能入口，减少用户认知混淆
  • Docker部署适配优化：调整部署内存参数，适配2核2GB服务器配置，稳定支撑30人同时在线并发场景，适配线上公益平台常态化运营需求
  • 全局版本缓存治理：核心静态资源统一升级版本号，强制浏览器清除旧缓存，确保所有用户实时体验最新迭代功能，杜绝新旧版本功能混杂问题

本次迭代以古籍活化落地、用户体验提质、工程稳定性升级为核心，补齐了平台经典典籍体系短板，完善了从日常学习、典籍溯源、AI创作到多端适配、稳定部署的全链路能力，进一步夯实了项目的公益美育与传统文化普惠价值。

3.8 :clapper_board: AI视觉全新升级 · 视频抽帧识诗功能（8月8日迭代）

本次迭代对AI识图寻诗模块进行能力跨越式升级，打破单一图片识别局限，新增视频抽帧智能识诗功能，实现图片、视频双媒介一体化诗意识别，打通「静态拍照、动态取景」全场景文化匹配能力，极大拓宽了AI诗意创作的使用场景，让生活中动态风光也能精准匹配古典诗词。

（1）AI聊天界面：新增独立视频上传能力

在AI对话输入栏左侧全新增设描金色专属视频上传图标，通过专属配色与图片上传按钮形成清晰视觉区分，界面层级规整、国风调性统一。功能严格限定资源规范，支持 MP4、MOV 等主流短视频格式，单文件最大限制20MB，适配用户日常手机拍摄、短视频取景场景，兼顾实用性与加载稳定性。

视频上传后自动启动智能均匀抽帧算法，全程规避视频首尾空白黑帧、过渡帧干扰，均匀抽取5帧核心关键画面，完整保留视频全程核心风光与场景内容，保证识别样本全面、无场景遗漏。提交识别后，前端实时展示逐帧识别进度，动态刷新「1/5→2/5→…→5/5」识别状态，让用户清晰感知AI处理流程，交互透明且流畅。

针对多帧识别结果，自研多维度智能聚合策略：自动统计所有帧识别关键词出现频率，合并重复语义标签，剔除偶然误差识别结果；同时智能筛选匹配度最高的关键帧作为主推荐依据，输出最优意境诗词结果，兼顾识别全面性与精准度。视频素材预览区优化视觉标识，在缩略图左下角新增「:play_button: 5帧」专属标签，直观区分图片、视频识别素材，交互感知清晰。

（2）AI识图界面：图片/视频统一全域入口重构

彻底重构AI识图上传体系，将原本单一图片上传入口，升级为图文视频一体化通用上传入口，支持点击选取、拖拽上传两种交互方式，系统自动识别文件类型、智能分流处理，无需用户手动切换功能模式，大幅降低操作门槛。

同步更新界面规范提示文案，清晰标注全量支持格式：图片支持JPG、PNG常规图像格式，视频支持MP4、MOV主流短视频格式，并新增「自动抽帧识诗」功能说明，让用户快速了解视频识别核心能力。同时优化右侧空状态引导文案，更新为「上传图片或视频，AI 为你寻找意境相符的古诗词」，贴合全新功能定位，引导性更强。

（3）视频专属双阶段进度体系，交互体验精细化打磨

针对视频识别流程更长、步骤更多的特点，定制双阶段可视化进度提示，解决长任务用户等待焦虑：第一阶段展示「抽取视频关键帧…」进度，完成视频画面解析与样本提取；第二阶段逐帧展示「逐帧识别 1/5~5/5，寻找意境相符的诗词…」实时进度，全程可视化反馈处理状态。

识别完成后，自动选取视频首帧作为结果页预览图，视觉展示规整统一。视频识别结果100%复用平台成熟渲染体系，完整保留关键词标签、适配主推荐诗词、AI原创诗词、意境相似推荐、社交文案生成、作品分享下载等全链路能力，实现新功能无缝兼容原有业务体系，性能稳定、体验一致。

（4）功能迭代价值总结

本次视频识诗功能上线，标志着轻诗阁AI视觉能力从静态单图识别升级为动静双态全域识别，覆盖日常拍照、旅途短视频、风景随拍等更多生活化场景，真正实现「所见皆可诗、所拍皆可赋」的产品体验，进一步强化了“让诗词融入生活”的核心定位，丰富了平台AI美育与文化传播能力。

维度 初赛版本 复赛版本
诗词数量 1,029 首 77,888 首
诗人档案 少量数据 647位重点诗人 / 4478位全库作者
飞花令题库 48条 / 6关键字 4008条 / 100+关键字
专项题库 无 近百万级答题、寻花令题库
诗意配图 80张 全库七万余首诗词全覆盖
联机游戏 HTTP轮询飞花令 WebSocket全游戏体系
AI架构 纯远程API 本地规则+远程LLM混合架构
稳定性体系 无 限流、监控、告警、事务安全全套
移动端体验 缺陷双导航 统一侧边抽屉、完美适配
代码规模 8万行 11.7万行工程级代码

四、创作历程

4.1 开发时间线

项目构想（4月）→ 小程序原型（5月）→ Web初版重构（6月）→ 功能大规模拓展（6-7月）→ 复赛工程化、安全、AI深度升级（7-8月）

4.2 创作初心

传统诗词学习枯燥、记忆低效、学用脱节，古籍资源晦涩难懂、大众门槛极高。我希望通过轻量化、游戏化、AI赋能的方式，让古典诗词走出课本、走出古籍藏书阁，变成人人可学、可玩、可感、可传承的生活化文化内容，用科技赋能传统文化普惠教育。

五、TRAE 实践过程

本项目从雏形到工程级平台，全程依托 TRAE 系列工具迭代：TRAE IDE 搭建原型、TRAE Work 重构全站、TRAE Agent 完成复杂架构、算法、安全审计与批量优化。

复赛阶段七大核心技术突破，均依托 TRAE 高效落地：WebSocket实时通信架构、双层限流策略、AI混合决策引擎、并发事务安全、可观测监控体系、移动端重构、全站安全漏洞批量修复。

六、技术架构总览

┌─────────────────────────────────────────────────────────┐
│                    用户界面层                             │
│  HTML5 + CSS3 + JavaScript (ES6+) · 40+ 页面            │
│  古韵三色体系 · 响应式布局 · 粒子动画 · 移动端抽屉导航     │
├─────────────────────────────────────────────────────────┤
│                    实时通信层                             │
│  WebSocket (ws库) · 路径 /ws                            │
│  心跳检测 · 断线重连 · 多房间隔离 · 双向映射              │
├─────────────────────────────────────────────────────────┤
│                    业务逻辑层                             │
│  Node.js + Express · 50+ RESTful API                    │
│  事务原子性守卫 · 双重限流 · RBAC鉴权 · 请求监控          │
├─────────────────────────────────────────────────────────┤
│                    AI 能力层                             │
│  本地规则引擎 (56关键词→18意境) + 远程 LLM API          │
│  置信度分水岭(0.7) · 三段式混合决策 · 优雅降级            │
├─────────────────────────────────────────────────────────┤
│                    数据持久化层                          │
│  SQLite (better-sqlite3) · 6+ 核心数据表                 │
│  条件守卫 · 事务回滚 · 金币流水审计 · 30分钟天气缓存       │
└─────────────────────────────────────────────────────────┘

七、社会公益价值（赛道核心加分项）

本项目深度贴合大赛古籍活化、青少年身心健康、智慧助老三大社会公益方向，以纯公益初心打造普惠型传统文化科技产品，基础功能永久免费开放。

7.1 古籍活化：让古典文献走出藏书阁

项目将数万首散落古籍诗词进行结构化数字化整编，统一译文、赏析、作者史料、场景意象，解决传统古籍晦涩难懂、资源分散、阅读门槛高的社会痛点。通过AI识图、游戏化对战、场景化诗意匹配等创新形式，让厚重的古典文献轻量化、年轻化、生活化，实现古籍活态传承与大众普惠传播。

7.2 青少年美育与身心健康赋能

针对青少年学习压力大、传统文化学习枯燥、精神美育缺失等问题，平台以趣味学习、习惯养成、诗意疗愈为核心：每日打卡培养自律习惯，游戏化学习降低背诵压力，诗词意境滋养心理情绪，以传统文化温润青少年内心，助力青少年身心健康与美育成长。

7.3 智慧助老：面向银发群体的文化陪伴（未来迭代）

项目预留完整适老化迭代方案：后续将推出极简模式、大字视图、全自动诗词朗读、经典怀旧诗词专区，降低老年人数字使用门槛，丰富银发群体精神文化生活，以传统文化陪伴晚年日常，践行智慧助老、文化养老的社会价值。

7.4 公益普惠理念

平台所有核心诗词学习、古籍查阅、趣味对战、AI基础能力永久免费开放，无门槛、无差异化，让不同年龄、不同地区、不同基础的用户都能平等享受传统文化数字资源，真正实现科技普惠、文化惠民。

八、总结与展望

从初赛功能Demo到复赛工程级全栈公益平台，轻诗阁完成了功能、数据、技术、安全、体验、公益价值的全方位蜕变。项目不再只是一款学习工具，而是一套AI赋能古籍活化、助力青少年美育、服务大众文化普惠的数字化公益解决方案。

未来，我将持续迭代适老化模块、古籍深度解读、诗词文化科普内容，让轻诗阁真正成为“有温度、有底蕴、有公益力量”的新时代传统文化传播平台，让千年诗词常驻生活，让古典文脉生生不息。

报名帖： 「学习工作」轻诗阁——轻松学习，便捷分享，让AI帮你看景不WOC

初赛帖： 「学习工作」轻诗阁——轻松学习，便捷分享，最棒的学习诗歌工具

视频连接：https://www.bilibili.com/video/BV12ju36YENm/?spm_id_from=333.1387.homepage.video_card.click

感谢各位评委审阅与指导！:sparkles:

1 个赞