ChargeDB 版本更新日志

v1.9.0 (2026-06-23) - 缓存策略与版本同步版本

🛠️ 缓存修复

• 占位图缓存修复 - 图片代理占位图响应改为 no-store，避免临时错误图或占位图被浏览器/CDN 缓存

• 页面缓存控制 - 为非 API 与非静态资源页面补充 no-store 响应头，降低页面状态过期导致的展示异常

📝 发布记录

• 补齐 v1.8.8 至 v1.8.12 的中间版本日志

• 同步 package.json 与 package-lock.json 当前版本到 1.9.0

---

v1.8.12 (2026-06-18) - Vercel 部署与 UI 交互修复版本

🚀 部署与生产环境

• Vercel 部署工作流 - 新增 preview 与 deploy 脚本，支持预览部署和生产部署

• 部署忽略配置 - 新增 .vercelignore，排除环境文件、构建产物、依赖缓存和测试缓存

• 图片代理生产环境优化 - 调整图片代理为 Vercel/CDN HTTP 缓存模式，并补充图片 URL 参数编解码工具

🛠️ UI 与交互修复

• UI 动画交互修复 - 调整卡片、筛选、详情预览和搜索工具栏的动画状态，降低布局抖动和误触

• 搜索建议定位修复 - 修正搜索建议浮层的位置计算，改善输入时的展示稳定性

🔧 运维接口改进

• 缓存状态接口说明修正 - 明确图片代理缓存由 CDN 响应头管理，避免误以为可通过本地内存缓存批量清理

• 图片预加载接口优化 - 配合新的图片代理缓存策略调整预加载流程

---

v1.8.11 (2026-05-27) - Notion 分页查询版本

🧩 数据同步

• 充电宝数据分页拉取 - Notion 充电宝查询增加 page_size 与 start_cursor 循环分页

• 完整数据集修复 - 避免 Notion 默认分页限制导致部分充电宝产品未被加载

---

v1.8.10 (2026-05-05) - 内存泄漏与依赖审计修复版本

🧹 内存与事件清理

• 反馈表单图片预览清理 - 删除图片、提交成功和组件卸载时统一释放 Object URL

• 筛选滑块事件清理 - 为拖拽监听增加统一 cleanup，避免鼠标/触控事件残留

• 文档目录事件绑定修复 - 防止目录重新生成时重复绑定点击监听

🔒 依赖与缓存维护

• 依赖审计修复 - 升级 Next.js 与 PostCSS，并通过 overrides 固定 PostCSS 解析版本

• 缓存清理机制优化 - 改进本地缓存统计与过期清理逻辑，降低长期运行时的内存压力

---

v1.8.9 (2026-05-03) - Hangla 产品 Feed 接入版本

✨ 新功能

• Hangla 产品 Feed - 新增 /.well-known/hangla-products.json 数据接口，输出充电宝、充电器和数据线的标准化产品数据

• 产品描述生成 - 为 feed 项目生成标题、图片、来源链接和产品描述，方便外部服务读取

🖼️ 图片与链接修复

• Feed 图片地址稳定化 - 使用稳定图片 ID 和代理地址生成 feed 图片，减少签名 URL 过期影响

• ChargeDB 图片代理保持 - 确保 Hangla feed 图片继续通过 ChargeDB 代理访问，避免外部直接依赖 Notion 图片链接

---

v1.8.8 (2026-03-05) - 数据线投稿表单微调版本

📝 表单文案与选项

• 接头外壳选项修正 - 移除不适用于接头外壳硬度字段的“没有附带不可拆卸的线缆”选项

• 线径字段说明优化 - 将“截面为正圆形时不填”的辅助说明从长标签调整为 Tooltip，减少表单拥挤

---

v1.8.7 (2026-03-05) - Tooltip 与移动端控件体验修复版本

🛠️ 交互与可用性修复

• 移动端复选框/单选框尺寸修复 - 取消被全局触控最小尺寸规则错误放大的问题，恢复表单控件为合理视觉尺寸

• Tooltip 移动端定位修复 - 改为通过 Portal 渲染到 document.body，点击后固定在屏幕底部弹出，不再出现在页面流底部

• Tooltip 桌面端定位优化 - 改为按鼠标锚点定位并随鼠标移动更新，展开位置贴近光标

v1.8.6 (2026-03-05) - 数据线投稿验证增强版本

✅ 投稿流程改进

• 数据线投稿协议验证增强 - 在同意《ChargeDB 数据收集与使用授权协议（简版）》后必须先完成人机验证

  • 协议页完成验证后才允许进入后续填写步骤

  • 提交接口新增 CAP token 校验，防止绕过前端直接提交

📝 内容更新

• 更新版本日志并同步版本记录

---

v1.8.5 (2026-02-15) - 安全与稳定性修复版本

🔒 安全加固

• Image Proxy SSRF 防护升级 - 增加严格的 Notion 图片 URL 校验

  • 仅允许受控 Notion 图片域名与 https 协议

  • 增加 DNS 解析后的私网地址拦截（IPv4/IPv6）

• 清理调试接口 - 删除 /api/test-image，避免外部探测与误用风险

🛠️ 稳定性修复

• Notion 请求重试修复 - 在三套数据源中改为“每次重试独立 AbortController”

  • 修复超时后复用 signal 导致后续重试立即失败的问题

  • 涉及 notion.ts、charger.ts、cable.ts

🚀 性能优化

• 文档页数据获取去重 - 新增 getDocPageData 聚合接口

  • 文档页由多次 getDocs() 调用改为单次拉取后派生 doc/breadcrumb/adjacent

  • 减少重复树遍历与不必要请求

🖼️ 图片兼容性改进

• 过期签名 URL 兜底 - 对部分 Notion S3 过期签名链接增加 fallback 拉取策略，提升图片可恢复性

---

v1.8.4 (2026-01-26) - Web 界面无障碍性优化版本

♿ 无障碍性改进

• 表单字段优化 - 为所有表单输入添加 name 和 autocomplete 属性，提升表单填写体验

• ARIA 标签补充 - 为所有图标按钮添加 aria-label 属性，改善屏幕阅读器支持

• 无障碍反馈 - 将 alert() 调用替换为 aria-live 区域，提供非阻塞式反馈

• 语义化改进 - 为装饰性图标添加 aria-hidden="true"，为交互式按钮添加 aria-expanded 状态

• 排版规范 - 使用标准省略号字符（…）替代三个句点（...）

🐛 问题修复

• ESLint 警告 - 修复 lucide-react Image 图标与图片元素的命名冲突

---

v1.8.3 (2026-01-26) - 文档渲染修复版本

🐛 Bug修复

• 行内代码块解析修复 - 修复 Notion 行内 <code> 标记被错误渲染为独立代码块并产生额外换行的问题

---

v1.8.2 (2026-01-26) - 性能与稳定性优化版本

🚀 性能优化

• 组件库导入优化 - 启用 optimizePackageImports，减少 lucide-react 的打包体积

• Notion 数据去重 - 使用 React.cache() 避免详情页与元数据重复请求

• Notion 子块并行拉取 - 递归获取子块时并行化请求，降低瀑布延迟

🧹 代码改进

• 滚动监听清理与被动监听 - 返回顶部按钮监听改为 useEffect 并添加 passive 与清理逻辑

• Notion 块类型标注 - 补充块类型定义，修复隐式 any 报错

---

v1.8.1 (2026-01-06) - UI优化与代码清理版本

🎨 UI与视觉优化

• 产品卡片翻转效果 - 新增 FlippableProductCard 组件

  • 鼠标悬停时平滑翻转，背面展示详细参数（容量、功率、重量、评分等）

  • 增强交互趣味性和信息展示效率

• 底部导航栏视觉升级 - 添加渐变模糊遮罩

  • 优化底部工具栏的背景处理，增加视觉层次感

🔧 技术改进

• 设备检测逻辑优化 - 精确识别低性能设备

  • 移除对 Chrome 浏览器的宽泛限制

  • 仅针对 Android 设备及特定低内存设备进行性能降级

• 代码库清理 - 移除不再使用的 TitleCarousel 组件

• 组件重构 - 优化 SearchableProductsGrid 布局

---

v1.8.0 (2025-12-30) - 最近点击记录版本

✨ 新功能

• 添加最近点击记录功能 - 记忆用户最近查看的产品

  • 自动保存用户点击过的产品记录

  • 方便用户快速回顾之前查看的产品

  • 移除滚动位置存储，简化状态管理

---

v1.7.0 (2025-12-24) - UI修复与无障碍优化版本

🎨 UI修复

• 修复切换按钮与标题的遮挡关系问题 - 优化层级关系

• 修复右上角标签遮挡关系问题 - 改善视觉层次

♿ 无障碍优化

• 提升网站可访问性

• 优化键盘导航支持

🚀 性能优化

• 图片缓存优化 - 提升图片加载性能

• 缓存控制增强 - 优化资源缓存策略

🐛 Bug修复

• 修复多个功能性Bug

• 通用问题修复

---

v1.6.0 (2025-12-22) - 新年投票版本

✨ 新功能

• 新年投票功能 - 2025 ChargeDB 年度充电大赏

  • 支持用户为喜爱的产品投票

  • 新年主题UI设计

  • 投票结果统计展示

🎨 UI优化

• 新年主题视觉更新

• 优化投票界面交互体验

---

v1.5.0 (2025-12-20) - 筛选功能增强版本

✨ 新功能

• 动态计算功率和价格范围 - 智能筛选体验优化

  • 根据当前产品数据自动计算筛选范围

  • 功率和价格滑块范围动态调整

  • 提升筛选的精准度和用户体验

---

v1.4.0 (2025-12-06) - 安全与维护版本

🔒 安全修复

• 修复安全漏洞问题

🔧 技术改进

• 更新依赖项版本

• 版本号统一维护

• 代码质量提升

---

v1.3.3 (2025-10-27) - 微信多图片与充电器优化版本

✨ 新功能

• 微信页面支持多图片展示 - 增强微信群组页面功能

  • 支持多张图片轮播展示

  • 优化图片处理逻辑

🔧 技术改进

• 优化充电器数据库页面UI与功能 - 提升充电器展示体验

• 移除图片组件的 enableZoom 属性，简化组件结构

• 优化 multi-image-gallery 组件

---

v1.3.2 (2025-10-20) - 移动端详情页滚动修复版本

🐛 重要修复

• 修复移动端详情页滚动位置问题 - 彻底解决从主页点击进入详情页自动定位到底部的问题

  • 问题根源：客户端路由时浏览器保留滚动位置，详情页继承了主页的滚动位置

  • 解决方案：使用 CSS 禁用详情页的 scroll-behavior: smooth + JavaScript 立即重置滚动位置

  • 通过 data-detail-page 属性和 :has() 选择器精准控制

  • 确保从主页点击时主页位置不变，只有详情页重置到顶部

🔧 技术改进

• 新增 detail-page-scroll-reset.tsx 组件用于详情页滚动重置

• 在 globals.css 中添加针对详情页的 scroll-behavior 覆盖规则

• 使用 useEffect 在详情页挂载时立即重置滚动位置

• 采用 CSS + JavaScript 双重保险机制，确保无滚动动画

📝 代码改进

• 简化卡片导航逻辑，移除不必要的滚动操作

• 优化详情页和详细数据页的滚动行为

• 改进用户体验，消除页面切换时的滚动闪烁

---

v1.3 (2025-10-16) - 对比页面搜索重构版本

🎨 UI/UX 改进

• 对比页面搜索重构 - 全新的产品选择体验

  • 桌面端：从右侧优雅弹出的全屏搜索窗口

  • 移动端：从底部向上滑出的搜索面板

  • 搜索窗口布局类似首页，卡片式展示更直观

  • 桌面端 3 列网格布局，移动端 2 列布局

  • 支持空格分词的智能搜索

  • 实时搜索结果统计

🔧 技术改进

• 新增 product-search-modal.tsx 弹窗组件

• 优化对比页面的产品选择交互流程

• 改进动画效果，提升用户体验

• 支持 ESC 键关闭弹窗，背景点击关闭

---

v1.2 (2025-10-16) - 搜索功能增强版本

🔍 搜索功能改进

• 自动分词检索 - 支持空格分隔的多关键词搜索

  • 例如输入”小米 67”可以搜索到”小米 自带线充电宝 20000 67W”

  • 所有关键词采用 AND 逻辑，必须全部匹配

  • 搜索范围包括标题、品牌、型号、副标题和标签

• 搜索状态记忆 - 用户体验优化

  • 从搜索/筛选状态点击进入详情页面后，返回时自动恢复搜索状态

  • 搜索状态持久化存储在 localStorage，有效期30分钟

  • 支持滚动位置、视图模式和搜索查询的完整恢复

🔧 技术改进

• 新增 search-state-storage.ts 工具模块，统一管理搜索状态持久化

• 优化搜索算法，提升多关键词匹配的准确性和性能

• 改进状态管理逻辑，确保搜索状态在页面导航间正确传递

---

v1.1 (2025-10-15) - 充电器功能与移动端优化版本

🚀 主要功能

• 新增充电器页面 - 完整的充电器数据库展示和对比系统

• 添加充电器详情页面，包含详细的规格参数展示

• 实现充电器数据的搜索和筛选功能

• 新增站点切换组件，支持充电宝和充电器页面之间的无缝切换

🎨 UI优化

• 优化移动端公告标题显示 - 实现响应式宽度设计和文本自动截断功能

• 改进公告轮播组件的响应式布局，支持不同屏幕尺寸

• 调整公告标题最大宽度设置，在移动端显示更多内容

• 新增充电器卡片和列表卡片组件，提供丰富的产品信息展示

📱 移动端改进

• 修复移动端公告标题过长导致的溢出问题

• 实现灵活的flex布局，确保公告元素正确排列

• 优化文本截断逻辑，保持标题可读性

🔧 技术改进

• 更新缓存逻辑以支持充电器数据的获取和存储

• 扩展数据类型定义，增加充电器相关的类型支持

• 增强组件复用性，优化代码结构

---

v1.0.1 (2025-10-13) - 文档解析修复版本

🐛 重要修复

• 修复Notion文档解析截断问题 - 添加分页支持，确保长文档完整显示

• 重构getPageBlocks函数，支持获取所有页面块而不仅是第一页

• 修复fetchDocsFromNotion函数的数据库查询分页问题

• 增加详细日志输出便于调试文档解析问题

🚀 技术改进

• 优化Notion API调用效率，增加页面大小到100

• 添加文档块获取数量统计

• 改进错误处理和重试机制

---

v1.0.0 (2025-10-09) - 最新稳定版

🚀 主要功能

• 完整的充电宝产品对比系统

• 移动端响应式设计

• 详细的规格参数展示

• 用户评测提交系统

• 搜索和筛选功能

• 图片缓存优化

🐛 最近修复

• 修复页面文本选择和复制功能

• 重构主题系统，明确主题解析类型定义

• 引入主题守卫组件并优化主题切换逻辑

• 调整文档目录样式以改善滚动体验

• 通用Bug修复

• 新增公告功能

v0.9.0 (2025-10-03) - 移动端优化版本

✨ 新功能

• 增强对比界面的移动端响应性，改善布局一致性

• 为对比界面增加新的数据卡片和产品规格详细描述

• 为对比页面增加搜索功能

🎨 UI优化

• 重构 ItemBar 和 ItemBarInline 组件，改善布局和视觉一致性

• 重构评分组件，支持处理超出最大限制的数值

• UI界面增强

• 移动端布局修复

🐛 Bug修复

• 通用Bug修复

• 修复多个功能Bug

• 线缆Beta功能Bug修复

v0.8.0 (2025-09-28) - 功能增强版本

✨ 新功能

• 添加京东数据源支持

• 新增列表视图，UI优化

• 修复 parseDetailData 函数中的 energy20min 属性解析

🎨 UI优化

• UI界面增强

• UI优化

• UI修复

🐛 Bug修复

• 完善数据处理

• 屏蔽重复标签

• 京东数据调整

• 修复多个功能Bug

v0.7.0 (2025-09-20) - CDN优化版本

🚀 性能优化

• 使用 Cloudflare Turnstile 替换 CAP 服务

• 优化CDN缓存

• 修复图片缓存CDN优化 - 紧急修复所有图片显示相同的bug

• 添加图片缓存优化测试脚本，增强图片代理API缓存一致性

✨ 新功能

• 添加充电宝文档功能

• 重构 ChargeBabyDetailPage 并添加 DetailDataPreviewCard 组件

• 为 ChargeBabyDetailPage 添加 generateMetadata 函数，实现动态SEO元数据生成

• 添加分享按钮和购买链接组件

🐛 Bug修复

• 修复样式问题

• 更新 DetailDataPreviewCard 组件样式和文本清晰度

• 增强 SubmitPage 和 TurnstileWidget 组件的客户端渲染

• 修复多个功能Bug

v0.6.0 (2025-09-15) - 评测系统版本

✨ 新功能

• 添加反馈功能

• 为 SubmitPage 添加用户问题报告的反馈选项

• 实现评测提交功能，包含新的API端点和管理模态框

• 添加图片上传功能和 Notion 集成

• 增强提交数据处理，添加多选支持和改进数据提取逻辑

🎨 UI优化

• 重构ICP备案信息处理，引入 ICPBeian 组件

• 使用 ConditionalFooter 替换 Footer，根据页面类型管理页脚可见性

• 更新页脚样式，改善视觉一致性

• 重构ESLint配置，增强评测提交数据结构

🐛 Bug修复

• 增强评测提交流程，改进Turnstile验证和图片上传处理

• 重构 Turnstile 验证组件在 SubmissionTab 中的位置

• 实现设备特定性能优化，引入 DeviceOptimizedContainer 组件

• 增强Chrome和Android设备的性能优化

v0.5.0 (2025-09-10) - 微信功能版本

✨ 新功能

• 添加 WeChatPage 组件并更新 ChargeBabyCard 的微信群组导航

• 重构 getChargeBabies 函数，优先显示微信组件

🎨 UI优化

• 增强 FilterComponent，引入容量和功率预设及滑块功能

• 为 ChargeBabyCard 和 FilterComponent 添加重量和价格排序选项

• 为 FilterComponent 和 SearchCompareToolbar 添加价格过滤功能

• 增强移动端触摸交互，改进按钮样式和触摸目标大小

🐛 Bug修复

• 从 CompareInterface 的可用产品中过滤掉’WeChat’型号

• 重构 ChargeBabyCard 和 FilterComponent，改善数据处理

• 增强 SubmissionTab 组件，更新表单输入样式

• 在 SearchCompareToolbar 中实现搜索建议功能

• 增强 FilterComponent 和 SearchCompareToolbar，添加内联过滤选项

v0.4.0 (2025-09-05) - 基础功能版本

✨ 新功能

• 添加联系管理员弹窗功能，更新评测标题和说明

• 添加相关评测功能

• 添加Notion数据获取脚本和子项目评测卡片组件

• 线缆长度支持多项输入

• 添加示例图片

• 增加表单功能

🎨 UI优化

• UI优化

• 优化UI和数据库结构

• 优化提交流程

• 优化表单UI样式

• 重构提交页面和工具栏，改善用户体验

🐛 Bug修复

• 修复数据库结构问题

• 添加ICP页脚

• 适配Turnstile验证

• 适配移动端

• 修复多个功能Bug

v0.3.0 (2025-08-28) - 图片功能版本

✨ 新功能

• 添加图片缩放功能，增强组件中的图片处理

• 增强图片缩放功能，支持动态缩放和触摸支持

• 添加图片下载功能

🎨 UI优化

• 更新 layout.tsx 中的字体配置，包含显示和预加载选项

• 优化移动端交互体验

• 优化UI布局

🐛 Bug修复

• 重构 ImageZoom 和 NotionImage 组件中的图片处理

• 修复放大逻辑

• 重构 ChargeBabyCard 和 ComparisonTable 组件中的评分检查

• 更新 DetailDataPage 和数据描述中的术语

• 修复能量体积比解析

• 重构 DetailDataPage 和 ComparisonTable 组件中的能量重量比显示

• 为 ComparisonTable 组件添加数据源信息

• 重构各组件中的数字格式化以保持一致性

v0.2.0 (2025-08-20) - 搜索筛选版本

✨ 新功能

• 添加产品对比功能

• 添加详细数据页面功能

• 添加排序功能，更新筛选组件，优化产品展示逻辑

• 添加筛选功能

• 支持自定义图文内容

🎨 UI优化

• 优化排行榜组件和搜索工具栏，增加移动端适配

• 更新配置文件，添加排行榜按钮，优化搜索工具栏和比较界面

• UI优化

• 优化UI设计

• 适配移动端

🐛 Bug修复

• 实现产品详情和404页面，增强排行榜和产品网格的错误处理

• 重构 ProductsGrid 中的错误处理，使用 Next.js Link 组件导航

• 更新 package.json 并重构 filter-component 和 notion 库

• 修复移动端UI问题

• 添加数据来源

• 修复多个功能Bug

v0.1.0 (2025-08-15) - 项目初始版本

✨ 初始功能

• 项目初始化

• 更新 package.json

• 移动端适配

• 添加显示名称功能

🎨 基础UI

• 基础产品展示页面

• 简单的产品列表

• 基础样式框架

🐛 初始修复

• 修复初始Bug

• 修复移动端UI问题

---

最后更新: 2026-06-23当前版本: 1.9.0