顾承煜-优快云博客

原创 HarmonyOS Node.js fs + path：三方HAR软链接越界与缺失依赖拦截【鸿蒙心迹】

同一个HarmonyOS工程，在开发者电脑上能找到本地HAR包，换一台构建机器却报找不到文件。问题有时不是ohpm网络仓库，也不是版本号写错，而是仓库里的某个.har路径实际指向了仓库之外。Linux和macOS环境允许创建软链接，CI拉取源码时未必保留链接目标；开发电脑恰好有那个目标，就会掩盖交付缺口。的里声明的本地file:*.har。演示项目LinkFence / HAR-2808要做的是构建前预检，不是替代ohpm安装器或修改任何锁文件。

2026-10-22 10:23:14 158

原创 HarmonyOS ArkUI ContainerReader：折叠屏浮窗中的盘点卡片容器断点【鸿蒙心迹】

货架盘点这类页面，通常同时承载数量、物料信息和下一步操作。手机竖屏里排得整齐，并不意味着在展开折叠屏上也整齐：当应用以浮窗运行，屏幕看起来很宽，真正留给卡片的内容区域却可能只有四百多 vp。若仍以设备宽度或窗口宽度决定展示两列，按钮和数量栏就会互相挤压。我把演示项目称为 StockScope；示例数据固定为任务INV-2048、物品“机械键盘”、货架A-01-03、已核对7/12。这是一组用于讲解结构的模拟数据，不是设备实测结果。

2026-10-21 14:39:52 100

原创 HarmonyOS ArkUI LazyForEach × IDataSource：文搜图候选分页去重与稳定键【鸿蒙心迹】

配图和 HiLog 均为教学示意，未声称在 DevEco Studio 或真机实际运行。本文从可复现的本地模拟结果讨论列表层的正确性，真实文搜图模型、检索 SDK、设备耗时不在演示覆盖范围内。

2026-10-20 16:02:26 185

原创 HarmonyOS AppGallery Connect × Node.js：上架截图比例与尺寸门禁【鸿蒙心迹】

不代表在平台上架审核已通过。

2026-10-20 15:57:36 157

原创 PhotoViewPicker+ArkTS：超分队列重选图后旧输入隔离【鸿蒙心迹】

本文通过PixelQueue演示图库选择与超分任务的时序错位问题，提出以activeUri、selectionVersion、activeRun三者分离管理输入归属，确保任务结果仅在版本匹配时更新界面。通过版本号校验与disposed守卫，防止旧处理结果覆盖新输入，实现任务隔离与过期回调拦截。演示中READY状态仅表示流程接受当前输入，非真实画质提升，强调业务逻辑与实际算法结果的边界。

2026-10-18 18:32:55 183

原创 Node.js+JSON5：权限声明与功能说明差异清单【鸿蒙心迹】

# 六、工具停在何处才算合理一个小型 Node.js 脚本确实可以把两份配置之间的文字差异拦在上架之前，但它的价值是帮助工程团队发现需要确认的问题，而不是替代平台政策判断。配置引用的字符串资源可能只是给系统弹窗展示的简短原因，而团队的功能说明需要覆盖用户能在产品中看到的入口和使用目的。输入读取失败、JSON5 语法错误和字段形状不对时，应当让工具以错误退出，并向开发人员报告路径和解析原因，而不是生成一份“没有权限、全部通过”的空报告。工具输出的是“需要人工核查的差异”，不是“平台审核拒绝原因”。

2026-10-18 18:29:06 204

原创 ArkUI MediaQuery 折叠屏编辑器草稿状态隔离【鸿蒙心迹】

保障的是组件存活时的响应式数据流，不等同于“持久草稿”功能。后续接入持久层时，应该在点击保存的瞬间生成快照，回调仅确认那份快照，必要时用修订序列排除过期确认。折叠屏上的编辑器有一种很容易被低估的问题：屏幕展开以后，编辑区变宽、预览区出现，看着只是布局从单栏换成双栏；这里的 600vp 是本项目选定的界面断点，不是系统认定折叠屏的硬件阈值。，标题是“发布评审纪要”，编辑框中的文本是“待确认：发布节奏与回滚预案。## 四、保存按钮只提交一次明确的状态变化编辑框的输入与保存，是最容易被布局逻辑误伤的两处交互。

2026-10-16 09:26:46 184

原创 AppGallery Connect×Node.js：JSON5版本号与权限声明提交前闸门【鸿蒙心迹】

本文设计并实现名为ReleaseGate的本地检查工具，用于在HarmonyOS应用提交前自动校验版本号、权限声明等关键配置。通过读取app.json5、module.json5等JSON5格式文件，识别版本码递增、新增权限等异常，提供可复现的检查报告。工具不依赖平台接口，仅做静态分析，强调“人工确认”而非自动阻断，避免误判。结合命令行脚本与ArkUI界面展示，提升团队协作效率，降低上线风险。

2026-10-16 09:22:30 143

原创 Network Kit HTTP：图像超分回源429限速账本与重试时钟【鸿蒙心迹】

本文聚焦图像超分页面中HTTP回源的429限流处理问题，提出将429视为调度信号而非普通错误，通过状态机管理请求生命周期，实现“一轮一建、一轮一销”的请求对象控制。结合Retry-After的可信解析与时间上限约束，引入世代编号与计时器绑定机制，防止旧回包覆盖新内容，避免无效重试加剧服务压力。强调界面应保留低清预览并展示可控倒计时，拒绝无边界自动重试，确保用户体验与系统稳定性的平衡。

2026-10-14 14:35:28 204

原创 ArkUI ListItem：平行视界工单延迟删除撤销窗口与跨栏恢复【鸿蒙心迹】

本文通过UndoDesk演示在双栏工单页中实现安全删除与撤销的完整方案。核心在于：不将“划出”等同于“删除”，引入本地待删除队列，以稳定ID管理状态（ACTIVE/PENDING_DELETE/DELETED），结合令牌机制与定时器竞争检查，确保撤销可恢复、提交可校验。右栏仅依赖selectedId，避免引用失效；左栏通过ForEach键值绑定，支持排序与刷新下的状态一致性。5秒撤销期由业务层控制，非动画依赖，且支持后台恢复判断。最终实现界面与数据解耦、状态可审计、跨设备形态兼容的可靠撤销能力。

2026-10-14 14:31:53 23

原创 HarmonyOS 7 WebSocket：闪控窗行情流序列缺口与快照补洞

QuoteGapLab 通过状态机机制解决行情数据乱序问题：客户端基于序列号校验，发现缺口后缓存新帧、拉取快照并按序回放，确保“截至某帧”的快照与回放一致。结合 protobuf 解码校验、有界缓冲与唯一监听绑定，实现网络异常下的精准恢复。

2026-10-05 23:23:46 212

原创 HarmonyOS 7 RDB+TaskPool：文搜图向量索引INT8量化与Top-K召回

VectorPocketLab 优化大规模图像语义搜索：通过为每张图独立量化至INT8，减少存储与内存占用；分块处理任务提升可中断性与进度反馈；粗召回（Top-40）结合高精度重排（Top-10），兼顾效率与准确率。关键设计包括动态缩放、代次隔离、游标及时释放与查询失效机制，实现从“慢启动”到“快响应”的转变。

2026-10-05 23:20:48 155

原创 HarmonyOS 7 + Spatial Recon Kit-C++：3DGS 输入帧时间戳倒退的单调门禁与批次隔离【鸿蒙心迹】

本文通过演示工程 ChronoRecon 阐明空间重建中时间关系的敏感性：即使数据格式合法，时间戳倒退、重复或跨批次迟到仍会导致重建失败。提出基于 generation 与单调性检查的门禁机制，确保帧序正确；强调拒绝后应冻结批次、销毁旧会话并重建新会话，避免隐式拼接时间线。代码实现原子化校验与缓冲所有权管理，日志详尽记录拒绝原因，提升故障可追溯性。

2026-10-03 12:48:51 199

原创 HarmonyOS 7 + ArkWeb onControllerAttached：折叠布局重建中的控制器租约与迟到脚本拒绝【鸿蒙心迹】

折叠屏切换导致ArkWeb组件重建，旧控制器虽存在但已失效。本文通过FoldWebLease演示工程揭示：仅依赖控制器对象不可靠，需以webEpoch追踪页面加载代次。命令携带epoch与commandId进入队列，仅当当前租约有效且PAGE_READY时才执行。onControllerAttached与onPageEnd分层推进状态，revoke()清除旧队列，回调中校验epoch防止迟到结果污染新页面。核心是“控制器存在≠可控制”，状态机与代次判断保障异步操作的正确归属。

2026-10-03 12:45:22 220

原创 HarmonyOS 7 + Network Kit + ArkUI：提审测试账号与关键服务的可用性探针【鸿蒙心迹】

本文介绍工具ReviewProbe，用于在应用提审前自动化验证测试账号的可用性。它通过固定白名单配置、临时凭据输入与内存令牌管理，模拟最小业务链路：认证健康、登录、资料读取、内容获取。演示显示4个探针中3个通过、1个因503被阻断，结果不记录敏感信息，仅输出状态码、耗时与归一化原因。强调“账号存在”不等于“业务可用”，需分层判断失败类型（网络/权限/服务），避免误判。代码严格控制请求生命周期，使用Network Kit并及时销毁资源，确保安全与可复现性。最终报告聚焦是否阻断发布，而非复制原始响应。

2026-10-02 13:22:25 201

Bing_kinger的博客