v1.0.4版本的核心目标是修复v1.0.3审核反馈问题、解决两个关键Bug,并完成产品官网与个人门户双站上线。本文记录AGC审核修复、Bug定位排坑、ICP备案、OBS静态托管和HTTPS证书配置的完整实战过程。
一、AGC审核三项问题修复
v1.0.3提交AGC后收到三项审核反馈,v1.0.4逐一修复:
- 图标与名称一致性:应用图标、名称在各配置文件中保持完全一致,通过全量检查module.json5和app.json5确保统一
- 深色模式画布背景色:画布背景在深色模式下调整为#3a3a3a,与系统深色主题协调,避免突兀的亮色背景
- 退出三重保障+接口配置统一:退出机制采用terminateSelf()+process.exit(0)双保险,接口配置统一使用click事件,移除touchend等重复触发
二、两个关键Bug修复
v1.0.4修复了两个影响用户体验的关键Bug,定位过程值得记录:
Bug 1:IP串台问题
现象:切换设备时,新设备的属性面板会短暂显示上一个设备的IP配置。
定位:propertyPanel.ts中同时绑定了change事件和click事件,设备切换时change事件触发延迟,导致旧值残留。
修复:移除propertyPanel.ts中的change事件处理器,统一只用click事件。一行代码删除,问题彻底解决。
Bug 2:设备拖动误滑动
现象:移动端拖动设备时,页面会跟着滑动,设备难以精准放置。
定位:SVG画布和设备节点未设置touch-action,浏览器默认手势处理与拖动逻辑冲突。
修复:canvas.ts中SVG元素和设备节点统一设置touch-action:none,禁用浏览器默认手势,拖动逻辑独占触摸事件。
三、ICP备案与合规
应用上架和网站上线都需要ICP备案。2026-10-16备案通过,粤ICP备2026120308号。备案号标注在三个位置:
- 帮助弹窗底部(应用内)
- 侧边栏底部(应用内)
- 两站页脚(网站)
四、OBS静态托管双站上线
两个网站部署到华为云OBS静态托管,全程踩坑不少:
4.1 桶配置
- netlab-website桶:产品官网 netlab.guidl.top
- guidl-personal桶:个人门户 www.guidl.top
- 桶ACL+对象ACL均设为public-read,obsutil sync带-acl=public-read参数
4.2 DNS配置踩坑
最大坑:www.guidl.top曾被误添加为独立DNS区域(只有NS/SOA记录),遮蔽了guidl.top区域下的同名CNAME记录。权威DNS优先匹配更具体的独立区域,导致NXDOMAIN。
解决:删除www.guidl.top独立区域,原CNAME记录立即生效。DNS区域遮蔽问题排查耗时最长,教训是:子域名不要创建独立DNS区域,用CNAME记录即可。
4.3 HTTPS链接批量修复
OBS静态托管默认只支持HTTP,HTTPS需额外配置证书。两站51个HTML文件中所有 https://(netlab|www).guidl.top 链接需批量替换为 http://,否则链接失效。obsutil sync增量同步到两个OBS桶。
五、HTTPS证书配置
华为云CCM免费测试证书(DigiCert DV Basic,3个月有效期,每账号20张额度):
- 申请两张证书:scs1792287189973(netlab) + scs1792288427786(www)
- 下载Nginx格式证书(server.crt + server.key)
- OBS自定义域名HTTPS配置上传证书
- 等待443端口开启(部署生效中)
免费证书3个月到期(2027-01-18),需重新申请并更新OBS配置,每年约4次续期。
六、总结
v1.0.4是一次"审核修复+Bug修复+基建完善"的综合版本。核心经验:
- 审核反馈是优化契机:将审核要求转化为系统性改进,而非临时补丁
- Bug定位重于修复:理解根因找到定位,修复往往只需一行代码
- DNS配置要谨慎:子域名用CNAME,不要创建独立区域
- OBS静态托管:HTTP开箱即用,HTTPS需额外配置证书