文章

围绕跨端渲染、原生工具链、端侧推理与实际问题排查整理的正式文章。

  1. WebGL2 / ANGLE 着色器编译卡死与长帧阻塞排查

    定位 Windows Chrome（WebGL2 → ANGLE → D3D11 fxc）下两类着色器编译退化：循环内动态索引常量数组导致的 144 秒无响应，以及动态光源循环内隐式偏导采样导致的 3 秒链接阻塞。

    三维与渲染

  2. 博客迁移与新站搭建思路

    记录从 Jekyll 模板迁移到 Jaspr 与 flutter_scene 的选型缘由、内容与三维书房设想，以及 Cloudflare 部署考量。

    开发随笔

  3. Flutter Scene 室内三维场景性能优化记录：静态合批、离线贴图与双态替身

    记录三维书房在 Web 端从启动期像素回读、细碎节点提交与动态纹理泄漏，收敛到离线烘焙、时间片合批、静动态双态替身与阴影掩码隔离的过程。

    三维与渲染

  4. Debug 正常、Release 失败：Gson 与 R8 泛型响应解析排查

    接口返回 200 但开启 R8 的 Release 包进入失败态，记录如何通过字节码 Signature 检查定位泛型擦除与 LinkedTreeMap 类型转换异常。

    客户端开发

  5. 三维可动圆背精装书的实现：装订几何、纸芯防穿模与页面纹理复用

    记录三维圆背精装书的紧背与空背形变建模、左右纸叠厚度不对称时的纸根细分防穿模，以及 TextPainter 动态分页与 6 槽页面纹理原地覆写。

    三维与渲染

  6. 在三维场景里接入中文输入法：老式打字机的 RenderEditable 对齐与非阻塞动画

    记录三维打字机放弃自建字符网格后，以 TextEditingController 为单一状态源，读取真实 RenderEditable 光标几何驱动字车与露纸滚动，并解耦中文输入法组合态与机械击键动画的过程。

    客户端开发

  7. 缓存 Tab 的状态同步：如何避免旧请求覆盖新操作

    结合多 Tab 页面保活与列表刷新场景，分析双向通知遗漏、异步回调修改旧对象与慢查询回退新状态的成因及协调方法。

    客户端开发

  8. TextPainter 测量够宽，Text 为什么仍然被裁切？

    定位自定义 Tab 单行标题在真机被截断的原因：TextPainter 不会自动继承组件树的 DefaultTextStyle 与字体缩放，测量与绘制必须共用最终样式。

    客户端开发

  9. flutter_scene 运行时状态边界修复：动态网格缩容、异步模板计数与物理快照同步

    记录向 flutter_scene 提交的三处运行时状态一致性修复：可更新网格缩容时的环形缓冲脏区间夹紧、异步场景加载失败后的模板持有计数释放，以及 Rapier 原生快照恢复后的刚体注册表对齐。

    三维与渲染

  10. 同一个 Native 动态库，为什么 Linux 能加载、Android 却失败？

    通过最小 C 动态库复现与 readelf / ldd 产物检查，解释 Linux 宿主全局符号范围如何掩盖缺失的 DT_NEEDED 依赖，以及 Android 命名空间隔离为何直接报错。

    客户端开发

  11. Flutter GPU / Impeller：用颜色化 LOD Probe 排查手工 Mip 链采样

    在 Android Vulkan 下遇到手工上传的完整 mip chain 不随 roughness 或 textureLod 变化时，如何通过纯色 LOD 探针、2D 图集控制路径与同版本本地引擎对照定位采样器限制。

    三维与渲染

  12. ADB 能看到设备，Flutter 为什么找不到？flutter_tools 设备解析修复与多 SDK 排查

    记录无线 ADB 设备在 adb devices -l 中可见却被 Flutter 丢弃的原因，从 AOSP 列宽格式定位到提交上游 PR

    客户端开发

  13. Flutter 视频页生命周期：路由覆盖、Tab 切换与后台播放的统一处理

    Flutter 中被新路由覆盖或切走的页面不会触发 dispose；记录如何用有效可见性统一管理实时视频流、双向对讲、录像与横屏锁定。

    客户端开发

  14. Flutter AndroidView 视频渲染：一次 Surface 生命周期问题的排查与改造

    排查 AndroidView + SurfaceView 在横竖屏切换与路由进出时触发的引擎层 getWidth 空指针崩溃，记录向 TextureView 双分支桥接改造的判断过程与边界。

    客户端开发

  15. Flutter / Compose / MAUI 开发体验：基于实际项目的取舍

    结合 Flutter 跨版本项目、Android Studio 下的 Jetpack Compose 界面开发与 .NET MAUI 尝试，围绕 UI 编写、IDE 预览、热重载与插件维护记录实际体验。

    开发随笔

  16. 小米真机屏幕镜像点击断连：从错误日志到系统设置的排查记录

    Android Studio 开启小米设备屏幕镜像后点击画面即断连（ScreenSharingAgent exit code 134），记录在多台机型及 HyperOS 3/4 上通用的省电策略解决方法。

    客户端开发

  17. 使用 ESRGAN-TF2 与 TFLite 在 Flutter 中实现任意尺寸图像超分

    Kaggle 上的 ESRGAN-TF2 TFLite 模型输入固定为 50×50，记录张量读写、边缘补齐、分块推理与重叠裁剪去接缝的实现过程。

    AI 与模型