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,禁用浏览器默认手势,拖动逻辑独占触摸事件。

💡
Bug定位经验:触摸事件冲突是移动端常见坑。touch-action:none是声明"这个元素的手势我自己处理"的标准方式,比手动preventDefault更可靠。

三、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张额度):

  1. 申请两张证书:scs1792287189973(netlab) + scs1792288427786(www)
  2. 下载Nginx格式证书(server.crt + server.key)
  3. OBS自定义域名HTTPS配置上传证书
  4. 等待443端口开启(部署生效中)

免费证书3个月到期(2027-01-18),需重新申请并更新OBS配置,每年约4次续期。

⚠️
HTTPS配置注意:OBS静态托管的HTTPS需要单独配置自定义域名证书,不是桶级别SSL。证书格式选Nginx,server.crt以BEGIN CERTIFICATE开头,server.key以BEGIN RSA PRIVATE KEY开头。

六、总结

v1.0.4是一次"审核修复+Bug修复+基建完善"的综合版本。核心经验:

  • 审核反馈是优化契机:将审核要求转化为系统性改进,而非临时补丁
  • Bug定位重于修复:理解根因找到定位,修复往往只需一行代码
  • DNS配置要谨慎:子域名用CNAME,不要创建独立区域
  • OBS静态托管:HTTP开箱即用,HTTPS需额外配置证书
💡
下一步:等待v1.0.4 AGC正式审核结果(1-3个工作日),同时等待HTTPS证书部署生效。免费证书2027-01-18到期前需续期。