HarmonyOS, 端插件, InsightIntentEntry, 小艺开放平台, LLM, 踩坑, 设计取舍

本文总结了HarmonyOS端插件开发中的两个关键知识点：1) 小艺结果卡片绑定规则要求卡片参数必须为object类型且子项名与返回值字段完全匹配才能正确绑定；2) 端插件返回值由端侧代码决定，平台只配置输入参数。文章重点探讨了LLM跨上下文判断问题，提出通过搜索先行、upsert幂等操作和长期记忆辅助来解决新建/更新判断难题，其中结构化数据仍应存储在端插件本地，长期记忆仅作参考。这些实践对实现稳

【HarmonyOS端插件开发要点总结】 新旧API对比：推荐使用@InsightIntentEntry新装饰器，支持自动参数注入和独立意图文件管理，相比legacy方式更简洁高效。 执行模式选择：后台存储类操作应选background模式，避免误选UI模式导致调用失败。 参数定义三处一致性：平台参数配置（LLM可见）、装饰器parameters声明（框架校验）、执行器类属性（注入接收）必须保持同

本文记录了在DevEco Code中接入DeepSeek自定义模型时遇到的问题及解决方案。作者最初通过/connect命令配置API key失败，发现仅认证不足以注册模型。通过查阅文档，最终在deveco.jsonc中独立配置DeepSeek provider和模型定义，与内置模型隔离，实现双模型切换。核心结论：认证（auth.json）与模型定义（deveco.jsonc）分离，两者通过prov

本文为HarmonyOS小艺开放平台智能体接入的实战笔记，主要包含三部分内容： 架构理解：澄清了App与智能体的关系，指出智能体是本体（大脑）而App是外挂（手脚），App只能被动响应智能体调用而非主动控制。 FunctionComponent SDK详解：介绍了SDK的参数配置、控制器功能、错误码等，强调App只能定制按钮样式而无法控制对话窗口内容。 开发踩坑：包括ButtonType命名冲突解

摘要： 本文记录了HarmonyOS开发中遇到@Trace装饰器导致JSON序列化属性名被添加__ob_前缀的问题。消息持久化时因JSON.stringify()读取的是劫持后的内部键名，导致数据加载失败。解决方案包括：1)为@ObservedV2类添加toJSON()方法返回正确键名；2)加载时兼容__ob_前缀的旧数据；3)业务数据使用fileIo同步写入替代异步的preferences。核心

本文介绍了HarmonyOS NaturalLanguageKit中textProcessing.getEntity()接口的10种实体识别功能，包括时间、邮箱、快递单号等实体类型。文章提供了API概览、关键特性说明及每种实体的详细技术参数，包括输入示例和返回的JSON数据结构解析。特别指出该功能无需权限、支持中英文、不支持模拟器等注意事项，对开发者在HarmonyOS应用中实现文本实体识别具有实

文章摘要 本文记录了在HarmonyOS中使用speechRecognizer进行语音识别时遇到的8个典型问题及其解决方案。主要问题包括语音消息延迟/丢失、文本乱码拼接、消息分裂、引擎启动失败、指数爆炸式重启、录音中断等。通过改用long模式、正确处理onResult回调、优化发送时机、修复startListening参数、设置maxAudioDuration参数以及调整recognitionMo

文章摘要 本文记录了在HarmonyOS中使用speechRecognizer进行语音识别时遇到的8个典型问题及其解决方案。主要问题包括语音消息延迟/丢失、文本乱码拼接、消息分裂、引擎启动失败、指数爆炸式重启、录音中断等。通过改用long模式、正确处理onResult回调、优化发送时机、修复startListening参数、设置maxAudioDuration参数以及调整recognitionMo

本文记录了2026年7月19日HarmonyOS开发过程中遇到的五个典型问题及解决方案： 类实例创建方式对比：分析constructor与static of()工厂方法的内存差异，结论是两者内存占用几乎相同，但constructor性能略优。 Stack布局点击问题：发现侧边面板遮挡导致点击失效，推荐改用SideBarContainer或调整渲染顺序。 自定义悬浮面板实现：通过Stack+PanG