灏天文库更新日志

更新日志

本项目的所有重要更改均记录在此文件中。

[2026-08] — 2026-08-03

升级

• App Vue2 → Vue3：工程 RuoYi-App-master - Vue3 原地升级（vueVersion=3、根 index.html、createSSRApp、Vuex 4、globalProperties、Promise 兼容拦截器、config ESM 与语法扫尾）。详情与真机回归清单见该目录 README.md。

[2026-07] — 2026-07-31

新增

• 灏天文库 App：上线手机端下载门户页，支持扫码与 Android 下载；平板双列布局与横屏阅读；启动检查更新、多应用商店跳转、账号注销与备案号展示。
• APP 扫码登录 Web：电脑登录页新增「APP 扫码」Tab，手机扫一扫确认后电脑自动登录，免输密码。
• 付费文集只卖整本 + 试读：付费文集统一购买整本；未购可见试读篇，目录区分试读/已解锁/付费；支付弹窗展示试读摘要与永久解锁说明。
• 个人中心申请晋升精品：个人花园文集卡片可一键申请晋升精品，与 Skill/OpenClaw 共用每日限额。
• 首页文集语义化排序：精品文集支持「默认推荐 / 最新上架 / 文档最多 / 最近更新」四种排序。
• 独立服务条款页：新增 /home/agreement，与隐私政策一并供商店与注册页引用。
• GEO / SEO 增强：品牌数字统一、llms.txt 主题文集、文集 FAQ 模块、作者公开简介与结构化数据（面包屑等）。
• AIGC 显式标识：RAG / 知识生成界面与下载文档标注「本内容由人工智能生成」；Web 端恢复 RAG 对话入口。
• 灏天文库剪藏助手浏览器扩展：发布 Chrome 扩展（Manifest V3），一键收藏网页正文到个人花园文集；支持右键/Alt+S、弹窗编辑、Token 认证与智能正文提取（MIT 开源）。
• App 知识路径浏览：「我的 → 知识路径」支持官方/我的路径列表与详情，点关联文集进入已有文集详情；创建/编辑/聚合阅读仍引导 Web。
• App 精品文集筛选对齐 Web：首页新增「类型」（免费/付费/会员）与「排序」（默认推荐 / 最新上架 / 文档最多 / 最近更新）。
• 会员服务协议合规：Web/App 开通或续费会员前须勾选《会员服务协议》；新增独立协议页 /home/member-agreement，关于页可再次查阅。
• Web 记住我默认勾选：密码登录页默认勾选「记住我」，关浏览器再开仍保持登录（约 30 天）。
• 多端会话按设备隔离：同账号手机端与电脑端各自最多 2 个会话，互不影响；仅同端超限时踢掉较早会话。
• App 版本 1.1：检查更新、下载页与后台发版参数同步升级。

修复

• 搜索页一直转圈：修复搜索结果返回后仍显示「正在加载数据流」的问题。
• App 文档正文空白：修复部分机型进入文档内容 Tab 后正文不显示。
• App 扫一扫黑屏：修复扫码页无相机预览、卡在「处理中」等问题，并优化进页速度。
• 会员开通被拦截：修复个人中心开通/续费会员时跳转支付宝被浏览器安全策略拦住。
• 登录锁定提示异常：密码错误锁定提示中的次数占位符现已正确显示。
• App 付费与权限：修复付费角标误显示「免费」、打开付费/会员文档被误登出、会员续费参数错误等问题。
• 个人主页与知识路径：修复公开主页文集接口 404、提示文字看不清、知识路径首屏封面不显示等问题。
• 顶栏格言撑高页头：修复窄屏下格言竖排导致页头过高的问题。
• 扫码登录稳定性：延长二维码有效期，修复 App 确认后电脑端未自动登录、提示文字被截断等问题。
• App 隐私政策 SDK 公示：按应用商店要求修正 SDK 名称、开发者与隐私链接，补全一键认证、OAID、联通认证等条目。
• App 登录/注册协议无法点开：勾选区与协议链接拆分，点击协议名可正常进入协议页。

优化

• 支付与导购体验：支付弹框视觉更简洁；作者查看自己的付费/会员文集时显示「无需购买，可直接阅读」。
• 阅读进度布局：个人中心阅读进度改为固定网格，卡片更整齐。
• RSS / 知识路径：保存路径改为站内弹窗；切回「自定义选文集」可清空列表；知识路径官方推荐继续扩充。
• 等级规则页：同步个人花园经验、知识路径头衔与 FAQ 说明。
• 隐私与合规：完善隐私政策与服务条款、精简 App 敏感权限、登录默认不勾选协议、协议链接可点开阅读。
• Skill / OpenClaw 指南：用户侧说明去掉接口与实现细节，只保留安装、Token 与能力说明。
• 知识路径性能：列表/详情接口 Redis 缓存覆盖会员请求；封面 SQL 轻量化，降低数据库压力。
• GEO / SEO 再增强：Organization JSON-LD 增加 sameAs；首页文集卡改为 article/h3 语义标签；robots.txt 澄清 knowledge-path 与 knowledge 路径。
• App 文集详情缓存：目录大纲与最新文档页面内短缓存延长至 10 分钟；扫码登录默认写入 RememberMe（约 30 天）。
• Web 会员开通合规：未勾选协议时开通/续费按钮禁用，支付逻辑二次校验。

[2026-06] — 2026-06-30

新增

• 知识路径系统：支持官方推荐路径和会员自定义路径（每人最多10条），在RSS阅读器中可按路径聚合阅读文集，自动追踪进度，读完路径解锁成就头衔。
• 用户公开个人主页：每个用户拥有公开主页 /home/user/{userId}，未登录也可访问，展示头像、昵称、统计数据（公开文集/文档/成就）、文集与成就Tab。
• 首页知识路径入口：首页新增「知识路径」Tab，展示官方推荐路径列表，支持搜索，点击可跳转RSS阅读。
• 内容更新提示：RSS阅读器检测到文档内容更新时，显示「内容已更新，建议重读」提示和徽标。
• 路径阅读进度：知识仪表展示路径总进度和各文集进度，支持继续阅读深链。
• ht-skills 更新：个人花园晋升系统，支持根据用户等级与活跃度提升花园额度与权限；新增花园文集推荐、成长徽章等功能，完善个人知识花园生态。
• 个人中心「个人花园」Tab：新增个人花园入口，展示额度概览与花园文集列表，支持搜索与分页。

优化

• 知识路径列表和详情接口增加缓存（非会员请求），大幅降低数据库压力。
• 个人主页和知识路径详情页支持服务端渲染，利于搜索引擎收录。
• 个人花园相关接口性能提升，文集列表加载更快。
• 文集详情信息更丰富：文集详情卡片新增「文集类别」「文集来源」「访问类型」三行展示。

[2026-05] — 2026-05-27

新增

• About Us 品牌页面：深色渐变 + 玻璃拟态布局，包含品牌介绍、关键指标与里程碑。
• 资源中心服务端渲染：列表与详情页由服务端渲染首屏内容，加载更快、对搜索更友好。
• 阅读进度类型筛选：支持按「付费/免费/会员」筛选阅读记录。
• 成就达成通知：解锁成就头衔时自动发送站内消息。
• 文档页评论区升级：展示用户等级与头衔胶囊，支持回复提示与点赞防连点。
• 个人中心头衔展示：新增「等级与头衔」页签，展示进度条与已解锁头衔。

修复

• 阅读进度翻页失效：筛选后翻页无效的问题已修复。
• 排行榜加载慢：优化统计方式，加载速度大幅提升。
• 新建文档进不去：修复浏览器缓存导致的页面加载问题。
• HTTP→HTTPS 跳转：修正为 301 永久跳转。
• 过期会话报错：浏览器带旧登录状态访问时不再报 500 错误。
• 登录后跳转异常：修复记住我登录后跳转到错误页面的问题。
• 登录回跳被粘住：修复登录后反复跳转到旧页面的 bug。
• 文集页初始化失败：修复偶尔出现的「页面初始化失败」提示。
• 文集目录消失：修复文集详情页目录被意外隐藏的问题。
• 个人中心页面异常：修复打包后部分功能失效的问题。
• 评论登录态异常：修复已登录却显示游客评论的问题。
• 推广码显示异常：修复推广码说明文字间距过大。
• 新建文档跳首页：未登录时访问文档直接跳登录页而非首页。
• 会员价格不一致：统一前后台会员套餐价格。
• 长文档发布截断：修复上传超过 2MB 的长文档内容被截断的问题。

优化

• 文档页加载更快：服务端已有内容时，前端不再重复请求。
• Mermaid 图表兼容：修复 Mermaid 图表在某些情况下渲染失败的问题。
• 代码高亮增强：补齐 Markdown 代码块的语法高亮。
• 阅读进度查询更快：新增后端缓存，减少重复查询。
• 登录防重复提交：登录按钮增加加载状态，防止重复点击。
• 文档摘要优化：修复摘要与正文内容重复的问题。
• 全站域名统一：统一为 aiknowledge.cn。
• 图片搜索引擎优化：全站图片补全描述信息。
• 阅读进度统计更准确：重写统计逻辑，修正数据偏差。
• 文集封面比例统一：全站文集卡片封面比例一致。
• 文集页结构优化：默认展示「文集信息」而非简介。
• 目录阅读状态：左侧目录展示未读/阅读中/已读标记。
• 文集卡片阅读进度：首页文集卡片展示阅读进度条。
• 支付安全性提升：增加金额校验与并发安全控制。

[2026-04] — 2026-04-28

新增

• 阅读状态系统：文集列表展示已读篇数与进度条，目录展示阅读状态标记，支持筛选和排序。
• 收藏分类：收藏列表按「个人花园 / 精品文集 / 文档」分类展示，支持筛选。
• 后台文集搜索增强：文集列表支持按类型联动筛选。

修复

• 推广码说明：注册页与个人中心增加推广码说明提示。
• 个人中心页面异常：修复打包后部分功能失效的问题。

优化

• 阅读进度查询更快：重写统计逻辑，保存改为更高效的方式。
• 阅读进度批量查询：一次请求获取多个文集进度，减少加载时间。
• 文集封面比例统一：全站文集卡片封面比例一致。
• 文集页结构优化：默认展示「文集信息」而非简介。

[2026-03] — 2026-03-26

新增

• 个人花园：用户可创建个人文集空间，基于等级与会员状态有不同数量限制；支持字典配置化管理。
• 封面自动生成：无封面文集自动加入队列，AI 定时生成封面图。
• 阅读进度展示创建者：阅读记录新增创建者信息。
• 首页阅读进度：文集卡片展示阅读状态与百分比。
• 评论区升级：展示用户等级与头衔，支持回复提示与点赞防连点。
• 个人中心头衔展示：新增「等级与头衔」页签。
• 后台用户头衔展示：用户详情页增加「成就头衔」区块。
• 后台文集搜索增强：文集列表支持按类型联动筛选。

优化

• 目录阅读状态：文集目录展示未读/阅读中/已读标记。
• 文集详情渲染：修复 Markdown 渲染异常，清除 HTML 残留。
• 目录交互优化：点击展开区域折叠目录，点击标题进入文档。

[2026-01 ~ 2026-02]

新增

• 文集购买功能：支持直接购买付费文集。
• RAG 智能问答：支持流式输出、对话管理，文档变更自动同步知识库索引。
• AI 文集封面：支持 AI 自动生成文集封面图。
• 活动系统：支持创建活动与参与记录管理。
• 个人中心增强：新增「我的评论」和「订单记录」标签页。
• 文集上传审核：用户可提交 Markdown 文件申请创建文集，支持拖拽排序与层级关系，管理员审核通过后自动创建。
• 搜索功能增强：支持文档内容搜索，新增搜索缓存，分页体验优化。
• 通知系统增强：注册、推广、审核、评论等事件自动通知，支持分页与展开查看。

修复

• 评论未登录报错：未登录用户可正常查看评论。
• 文集购买失败：修复订单字段长度不足导致的问题。
• 图片转换报错：转换失败时自动降级保存。
• 文集审核报错：修复多处编译错误与类型不匹配。
• Emoji 存储失败：数据库字符集升级，支持 Emoji 存储。
• 文集路径错误：修复目录路径双斜杠问题。
• 应用启动失败：修复安全组件导致的启动错误。
• 编译错误：修复多处语法与类型错误。

[2025-10 ~ 2025-12]

新增

• 接口缓存系统：高频接口统一缓存管理，页面响应更快。
• 评论加载更快：评论树结构由后端构建，减少前端计算。
• RAG 系统管理：新增对话数据统计与用户活跃度分析。

修复

• 会员奖励天数不累加：连续获得多次奖励时天数正确累加。
• 编辑器页面报错：修复文档编辑页 JavaScript 错误与图表加载 404。
• 知识生成订单异常：修复商品名称为空与支付空指针问题。
• 多处类型转换错误：经过多轮迭代修复。

优化

• 评论查询更快：减少不必要查询，提升响应速度。
• 数据安全加固：个人中心强制使用当前登录用户，防止越权查看。
• 图表渲染优化：统一 Mermaid 渲染配置。

[2025-03 ~ 2025-09]

新增

• 创作者申请：用户可在个人中心申请成为创作者，管理员审核，支持批量操作。
• 创作者中心：创作者专属管理面板，支持文集管理与批量导入。
• 文集晋升：个人花园文集可申请晋升为精品文集。
• 文集收费设置：支持配置文集为付费或免费。

修复

• 文档查询报错：无效查询不再报错。
• 批量导入搜索：文集选择支持搜索查找。
• 批量导入格式限制：仅允许 Markdown 等文档格式，限制文件大小。

优化

• 搜索栏样式统一：首页各板块搜索栏风格一致。
• 文档层级关系：简化父子关系逻辑。
• 审核流程优化：审核按钮根据状态控制，防止重复审核。
• 图片处理优化：区分 GIF 与其他格式，转换失败自动降级。

[2025-01 ~ 2025-02]

新增

• 支付系统完善：支付宝同步通知、支付安全加固。
• RAG 智能问答：流式输出、对话管理，文档变更自动同步索引。
• AI 大模型集成：支持知识宇宙功能与 AI 模型管理。
• 活动系统：活动创建、展示与参与记录。
• 个人中心增强：新增「我的评论」和「订单记录」。
• 文集上传审核：支持 Markdown 文件提交、拖拽排序、层级关系，管理员审核后自动创建文集。
• 搜索增强：支持文档内容搜索，新增缓存机制。
• 通知系统：注册/推广/审核/评论等事件自动通知。
• 权限控制系统：购买后自动校验权限。
• 反馈系统：开放用户反馈入口。

修复

• 评论未登录报错：未登录可正常查看评论。
• 文集购买失败：修复字段长度问题。
• 图片转换报错：失败自动降级保存。
• 文集审核报错：修复编译错误。
• Emoji 存储失败：数据库升级支持 Emoji。
• HTTPS 混合内容：修复安全页中不安全资源加载。
• 后台越权访问：修复访问控制漏洞。
• 登录/注册流程：修复弹框异常、角色显示、忘记密码等问题。
• 个人中心异常：修复订单显示与权限校验问题。
• RAG 认证失败：修复流式输出时的认证问题。

优化

• 搜索缓存：减少重复请求，提升搜索速度。
• 通知性能：改为点击触发，减少后台请求。
• 文档接口：减少不必要查询，提升响应速度。

[2024-10 ~ 2024-12]

新增

• 平台核心功能：搭建完成文集管理、文档管理、用户管理、权限控制等核心系统。
• 前台页面：首页、文集详情、文档详情、资源中心、评论系统。
• 支付系统：支付宝与微信支付集成。
• 用户等级系统：经验值、等级区间、成就头衔解锁。
• 文集分类体系：付费/会员/免费三种访问类型。

[2024-06 ~ 2024-09]

新增

• 项目启动：确定技术选型与产品方向。
• 需求设计：知识库平台功能规划与技术方案。
• 环境搭建：服务器部署与开发工具链配置。
• 技术验证：框架评估、Markdown 渲染、缓存策略验证。

灏天文库 · 专业技术知识库平台