CodeBox-码盒CodeBox

版本更新记录

记录每一次进步与改变

2026
v1.16.02026年4月17日

表单收集与统一看板上线

  • 🐛 修复修复动态二维码在 plugin、MCP、API Key 和克隆链路中错误按 3 积分扣费的问题，统一改为按 10 积分计费
  • ⚡ 优化免费版调整为每月 50 积分、50 个静态二维码、约 5 个动态码或 2 个 AI Standard，更贴近真实试用场景
  • ✨ 新功能新增表单收集 MVP：表单设计、公开提交、提交记录、Excel 导出、二维码绑定与企业场景模板
  • ✨ 新功能新增统一数据看板，支持扫码与表单两类数据分析，并可导出 PDF 报告
v1.15.62026年4月1日

回退 AI 可空唯一约束

  • 🐛 修复移除 AI 任务 requestKey、AI 二维码 sourceTaskId 与额度流水 operationKey 的可空唯一约束，避免 Mongo/Prisma 在空值场景下引入危险兼容性问题
  • ⚡ 优化模型层改为基于普通查询和应用层幂等判断维持 AI 任务、二维码落库与额度流水的重复保护，保持代码可运行
v1.15.52026年4月1日

为 AI 二维码链路增加 schema 级幂等键

  • ⚡ 优化为 AI 任务增加 requestKey、完成时间和失败原因字段，统一数据库层任务终态语义
  • ⚡ 优化为 AI 二维码增加 sourceTaskId 唯一来源键，为额度流水增加 operationKey 唯一操作键，防止重复建码和重复补偿
  • 🐛 修复AI 创建、查询和补偿链路切换到 schema 级幂等约束，重复提交、重复回调和重复退款会被数据库唯一键拦住
v1.15.42026年4月1日

对齐 AI 二维码前端轮询契约

  • 🐛 修复前端 AI 二维码轮询改为直接使用 /api/ai/task 返回的 waiting、processing、finish、failed 状态，不再额外依赖 verify-ai-task 完成校验
  • ⚡ 优化统一 AI 任务完成、失败与超时提示逻辑，减少状态语义不一致导致的重复等待
v1.15.32026年4月1日

收敛 AI 二维码后端任务闭环

  • 🐛 修复修复 AI 任务创建失败、查询失败和第三方失败状态下的额度补偿闭环，避免重复扣费或漏补偿
  • 🐛 修复统一 AI 任务状态收敛与用户归属校验，批量查询和单任务查询均按用户过滤，避免越权访问
  • ⚡ 优化为 AI 二维码结果落库增加 shortLink 级幂等保护，重复回调和重复轮询不会重复创建二维码记录
v1.15.22026年4月1日

修复 AI 二维码任务边界状态

  • 🐛 修复统一 AI 任务状态为 waiting、processing、finish、failed，消除前后端对失败态与完成态的歧义判断
  • 🐛 修复补齐 AI 二维码扣费后的失败补偿、重复回调幂等处理，以及 ShowAPI 手动查询补处理链路
  • 🐛 修复加强 AI 任务完成校验，finish 后仅在二维码记录已落库时才视为最终完成，避免任务完成但列表暂未刷出的竞态问题
  • ⚡ 优化同步更新开发规则与 API 文档，明确 /api/ai/create、/api/ai/task 和 /api/v1/qrcode/verify-ai-task 的职责边界
v1.15.12026年3月31日

优化数据分析页趋势图布局与统计卡片样式

  • 🐛 修复调整扫描趋势图卡片高度策略，消除左下角大面积空白区域
  • ⚡ 优化统一下方统计卡片为横向条形列表样式，设备、UTM 和地理来源展示颗粒度保持一致
  • ⚡ 优化重构高表现二维码列表卡片头部和行样式，与设备、地域、UTM 模块保持一致的圆角容器与排序信息
  • ⚡ 优化同步升级首页数据分析展示底部模块，采用与后台统计卡片一致的圆角容器、排序头部和条形列表布局
  • ⚡ 优化扩展首页分析展示容器宽度并补齐可切换图表指标交互，确保左侧导航完整可见且趋势区域更接近后台统计体验
  • ⚡ 优化微调首页分析展示左侧导航、排序标签和底部统计卡片边框层级，使其更贴近后台数据分析页的视觉结构
  • ⚡ 优化继续放宽首页分析展示整体宽度并扩大左侧固定导航栏，避免展示压缩导致侧栏显得过窄
v1.15.02026年3月25日

AI 二维码双引擎升级

  • ✨ 新功能新增 Replicate illusion 模型（ControlNet + SD1.5），生成高质量 AI 艺术二维码
  • ✨ 新功能10 个全新预设风格：赛博都市、水墨山水、魔幻森林、海浪、樱花庭院等
  • ✨ 新功能双引擎并存，支持在「AI绘画」和「经典风格」之间切换
  • ⚡ 优化AI 二维码结果处理逻辑重构，统一图片下载、R2 上传和记录创建流程
v1.14.02026年3月24日

CodeBox CLI 工具发布

  • ✨ 新功能新增 @codebox.club/cli 命令行工具，支持终端管理二维码
  • ✨ 新功能支持 QR 码创建、列表、统计、更新、删除、克隆、批量生成
  • ✨ 新功能支持模板浏览和搜索，Webhook CRUD 管理
  • ✨ 新功能支持 --json 机器可读输出，适配 CI/CD 流水线
  • ✨ 新功能三级配置：命令行参数 > 环境变量 > ~/.codeboxrc 配置文件
v1.13.22026年3月24日

SEO 全面优化

  • 🐛 修复移除虚假 AggregateRating 和无效 SearchAction 结构化数据，消除 Google 处罚风险
  • 🐛 修复删除指向无关账号的 sameAs 社交链接，避免知识图谱信号混乱
  • ⚡ 优化Sitemap 行业覆盖从 6 个扩展至 31 个，动态读取 niches 配置
  • ⚡ 优化为 Solutions、Resources、Tools 等 8 类页面补全 canonical URL 和 Open Graph 标签
  • ✨ 新功能新增博客 RSS Feed（/blog/feed.xml），支持 RSS 阅读器订阅
  • ✨ 新功能新增动态 OG 图片生成，社交分享显示品牌预览图
  • ⚡ 优化添加 x-default hreflang 标签，完善国际化信号
  • 🐛 修复修复页脚版权年份为动态生成
v1.13.12026年3月23日

OpenClaw Skill 发布

  • ✨ 新功能新增 OpenClaw AI Agent Skill，支持通过 OpenClaw 平台调用二维码生成、管理、统计等全部 API
  • ✨ 新功能Skill 包含 9 个操作：生成、批量生成、列表、删除、克隆、更新、统计分析、扫描导出、模板浏览
  • ⚡ 优化提供完整的 API 参考文档和使用示例，支持自动模板匹配
v1.13.02026年3月20日

模板库页面全新改版

  • ✨ 新功能全新 Hero 区域，展示 255+ 模板总数、搜索栏和 7 个顶层分类标签
  • ✨ 新功能新增 6 个热门合集卡片轮播，快速切换节日、品牌、行业、艺术风格、场景、平台分组
  • ✨ 新功能新增左侧筛选栏，支持按颜色（8色）、风格（7类）、行业（10类）、场景（10类）多维度筛选，数据驱动精确匹配
  • ✨ 新功能筛选支持跨组 AND + 组内 OR 逻辑，实时显示各标签匹配数量，禁用无结果标签
  • ⚡ 优化统一卡片设计：正方形预览区 + 悬浮快速编辑/预览按钮 + 可扫描徽章 + 分类标签
  • ⚡ 优化255 个模板（节日/行业/场景/艺术/平台/品牌）合并为统一 4 列网格，支持混合浏览和搜索
  • ⚡ 优化移动端筛选以底部弹出面板呈现，优化小屏体验
v1.12.12026年3月14日

WiFi 二维码中转页上线

  • ✨ 新功能新增 WiFi 中转页（/wifi），扫码后展示 WiFi 名称、密码、安全类型等信息，支持一键复制密码
  • ✨ 新功能WiFi 二维码升级为动态码，支持扫码统计和后台管理，与手机二维码流程一致
  • ⚡ 优化WiFi 中转页包含连接步骤指引和安全提示，提升用户体验
  • 🐛 修复后端 API 增加保护：vCard 等特殊类型自动降级为静态码，避免短链重定向无法识别
v1.12.02026年3月12日

pSEO 全行业覆盖：31 个行业 279 个资源页面上线

  • ✨ 新功能新增 26 个行业 pSEO 数据（营销、房地产、制造业、物流、旅游、酒店、健身、美容美发、汽车、金融、政务、展会活动、婚庆、宗教、农业、文创、游戏、法律、保险、宠物、家装、母婴、社区物业、外贸、咨询培训、自媒体）
  • ✨ 新功能每个行业配套 6 个场景指南、24 项部署清单、50 个创意案例、动态码 vs 静态码对比
  • ✨ 新功能新增资源中心首页（/resources），聚合展示所有行业的清单、案例和对比资源
  • ⚡ 优化行业解决方案页面场景卡片支持点击跳转到详细指南页面
  • ⚡ 优化行业解决方案页面新增「相关资源」板块，快速导航到清单、案例和对比页
  • 🐛 修复修复带连字符行业 slug（如 cultural-creative）的 URL 解析问题
v1.11.02026年3月12日

pSEO 2.0：5 大行业场景指南与资源中心上线

  • ✨ 新功能新增 pSEO 渲染引擎：场景指南、部署清单、创意案例、类型对比四大内容类型
  • ✨ 新功能餐饮行业：6 个场景指南（扫码点餐、外卖跳转、会员注册、排队取号、优惠活动、顾客评价）
  • ✨ 新功能零售行业：6 个场景指南（商品溯源、会员管理、促销活动、库存查询、门店导航、防伪验证）
  • ✨ 新功能教育行业：6 个场景指南（课堂签到、资料分发、招生推广、家校沟通、校园导航、考试报名）
  • ✨ 新功能电商行业：6 个场景指南（包裹营销、私域引流、防伪溯源、售后服务、直播带货、跨境电商）
  • ✨ 新功能医疗行业：6 个场景指南（预约挂号、患者信息采集、药品溯源、随访管理、健康宣教、电子处方）
  • ✨ 新功能每个行业配套 24 项部署清单、50 个创意案例、动态码 vs 静态码对比
  • ✨ 新功能新增 /resources 资源中心路由（清单、案例、对比）
  • ✨ 新功能新增医疗行业解决方案页面（/solutions/healthcare）
  • ⚡ 优化JSON Schema 驱动的内容生成与校验体系，支持批量扩展到 30 个行业
v1.10.12026年3月11日

修复动态二维码中转页跳转 404 问题

  • 🐛 修复修复目标 URL 缺少协议前缀时被当作相对路径导致跳转 404 的问题
  • 🐛 修复在短链创建、服务端渲染和客户端跳转三层增加协议前缀自动补全
v1.10.02026年3月11日

TypeScript SDK 发布：@codebox.club/sdk

  • ✨ 新功能发布 @codebox.club/sdk npm 包（v0.1.0），零运行时依赖，支持 ESM + CJS
  • ✨ 新功能SDK 提供 13 个方法：二维码 CRUD、统计分析、模板目录、Webhook 管理
  • ✨ 新功能类型化错误处理：AuthenticationError（401）、RateLimitError（429）、CodeBoxError（通用）
v1.9.12026年3月11日

GEO 优化：提升 AI 搜索引擎可见性

  • ✨ 新功能增强 llms.txt：完整覆盖 API 文档、MCP Server、SDK、Webhook、博客和工具页链接，帮助 AI 系统理解网站结构
  • ✨ 新功能robots.txt 新增 10 个 AI 爬虫显式 Allow 规则（GPTBot、ClaudeBot、PerplexityBot、Google-Extended 等）
  • ✨ 新功能5 篇教程文章新增 HowTo Schema 结构化数据，支持 Google Rich Results 展示
  • ⚡ 优化博客文章 BlogPosting Schema 补充 image 和 inLanguage 属性
  • ⚡ 优化新增安全响应头：HSTS（含 preload）、X-Content-Type-Options、X-Frame-Options、Referrer-Policy
  • ⚡ 优化博客文章 OpenGraph 元数据补充封面图
v1.9.02026年3月10日

按量计费：免费额度 + 额度包充值

  • ✨ 新功能全新额度计费体系：每月自动发放免费额度（普通二维码 5 次、AI 二维码 5 次），充值额度永不过期
  • ✨ 新功能新增额度包购买功能，支持微信扫码支付，即时到账
  • ✨ 新功能所有功能对全部用户开放（高级样式、批量创建、API、数据导出等），无 Feature 门槛
  • ✨ 新功能新增额度管理页面，查看余额明细和消费流水
  • ⚡ 优化原 Pro 订阅用户自动迁移，按剩余天数折算等值额度
  • ⚡ 优化额度消耗仅在创建二维码时扣减，查看、编辑、统计、导出等操作不消耗额度
v1.8.02026年3月9日

MCP Server 与 OpenClaw Skill：AI Agent 集成

  • ✨ 新功能新增 MCP Server（/api/mcp），支持 Claude Desktop、Cursor 等 AI Agent 通过 MCP 协议直接调用二维码能力
  • ✨ 新功能MCP 提供 4 个 Tool：generate（生成追踪二维码）、get_stats（扫码统计）、update_link（更新动态链接）、list_templates（浏览模板）
  • ✨ 新功能发布 OpenClaw Skill（codebox-qrcode）到 ClawHub，支持免费生成二维码图片（无需 API Key）
  • ✨ 新功能新增 MCP Server 开发文档页（/docs/mcp），包含接入配置、工具说明和测试示例
  • ✨ 新功能新增博客：《让AI Agent帮你生成二维码：CodeBox MCP Server接入指南》
  • ⚡ 优化MCP 鉴权复用现有 API Key 体系，无需额外配置
  • ⚡ 优化采用 Streamable HTTP 无状态模式，与 Next.js App Router 原生兼容
v1.7.12026年3月9日

设计体系优化与交互体验提升

  • ✨ 新功能提取 SectionHero、CTASection、FAQSection 共享组件，统一全站页面结构
  • ✨ 新功能新增 ScrollReveal 滚动入场动画组件，工具页与解决方案页卡片交错入场
  • ✨ 新功能免费工具编辑器新增表单验证与错误状态提示
  • ⚡ 优化统一卡片阴影层级体系（静态 shadow-sm、交互 shadow-md、悬停 shadow-xl）
  • ⚡ 优化修复低对比度文字，全站辅助文字提升至 WCAG AA 标准
  • ⚡ 优化动画支持 prefers-reduced-motion，尊重用户无障碍偏好
v1.7.02026年3月6日

营销增长：水印优化、免费工具页、行业解决方案

  • ✨ 新功能新增免费二维码工具页（/tools），支持WiFi、微信、文本、网址、名片5种类型在线生成
  • ✨ 新功能新增行业解决方案页（/solutions），覆盖餐饮、零售、教育、营销、电商5大行业
  • ✨ 新功能支持去除二维码水印下载
  • ⚡ 优化水印文字升级为 codebox.club，增强品牌域名曝光
  • ⚡ 优化工具页与解决方案页均配置SEO元数据与JSON-LD结构化数据，提升搜索引擎收录
  • ⚡ 优化顶部导航栏新增「工具」和「解决方案」入口
v1.6.02026年3月6日

更新日志页面与模板体验优化

  • ✨ 新功能新增版本更新日志（Changelog）时间线页面
  • ✨ 新功能模板库迁移为独立路由，支持平滑导航
  • ✨ 新功能新增模板详情页与分类页独立路由
  • ⚡ 优化优化模板页面筛选栏吸附效果，与Header无缝衔接
  • ⚡ 优化优化模板页面快速滚动性能，移除卡片级backdrop-blur与冗余动画
  • ⚡ 优化统一Header高度为64px，修复各页面布局高度不一致问题
  • 🐛 修复修复模板详情页面包屑导航链接错误
  • 🐛 修复修复模板分类页local参数残留导致的404问题
v1.5.02026年3月5日

博客系统与SEO优化

  • ✨ 新功能新增博客系统，支持MDX内容管理
  • ⚡ 优化优化SEO元数据与结构化数据
  • ⚡ 优化优化模板页面样式与交互体验
  • 🐛 修复修复部分页面样式兼容性问题
v1.4.02026年2月15日

模板系统与API增强

  • ✨ 新功能新增二维码模板接口，支持模板管理
  • ✨ 新功能新增API文档页面
  • ⚡ 优化优化API接口响应速度与稳定性
  • ⚡ 优化优化二维码生成样式配置
  • 🐛 修复修复API接口类型定义问题
v1.3.02026年1月20日

登录优化与品牌升级

  • ⚡ 优化优化登录流程与用户体验
  • ⚡ 优化升级品牌Logo与视觉设计
  • ⚡ 优化优化Dashboard页面样式
  • 🐛 修复修复主题切换在部分页面不生效的问题
2025
v1.2.02025年12月10日

数据分析与追踪增强

  • ✨ 新功能新增UTM参数追踪功能
  • ✨ 新功能新增扫码数据可视化图表
  • ⚡ 优化优化短链接跳转速度
  • 🐛 修复修复部分设备扫码统计不准确的问题
v1.1.02025年11月1日

二维码样式定制

  • ✨ 新功能新增渐变色二维码支持
  • ✨ 新功能新增Logo嵌入二维码功能
  • ✨ 新功能新增WiFi二维码与文本二维码类型
  • ⚡ 优化优化二维码下载清晰度
v1.0.02025年9月15日

CodeBox 正式发布

  • ✨ 新功能支持URL动态二维码生成
  • ✨ 新功能支持二维码样式自定义（颜色、形状）
  • ✨ 新功能提供扫码数据统计与分析
  • ✨ 新功能集成Next-auth用户认证系统
  • ✨ 新功能提供API接口与APIKEY管理