鸿蒙 App 要加 AI 助手，模型密钥还能放手机里吗？

短答案：不该。 模型密钥、平台应用密钥都不该进鸿蒙安装包，也不该长期留在手机本地。更稳妥的架构是：手机只做薄客户端——发送用户输入、显示事件流、执行你明确注册的本地工具；智能体循环、权限判断和上下文治理放在你们自己部署的会话服务上。

这条结论不是品牌口号，而是移动分发的常识：安装包可被解包，设备可丢失，进程可被调试；把上游模型密钥或平台 appkey 写进客户端，等于把账单和调用权公开给拿到包的人。

行业在发生什么

华为公开材料与开发者社区在 2026 年持续把 HarmonyOS 叙述为「Agent 亲和」：系统侧强调意图、Skill 与智能体协同，开发者页汇总 Harmony Intelligence 下的 Agent / Skill 能力入口。2026-10-04 前后社区对「Agent 亲和架构与应用智能化改造」的梳理，也把应用从「等人点开图标」推到「把边界清晰的能力交给系统或自有助手调度」。与此同时，QuestMobile 2026 年三季度报告显示办公类 Agent 在 PC 与 App 端都高速增长——跨端助手成为默认预期：同一套业务，手机、桌面、网页都要能聊、能查。

对企业移动产品负责人，这带来一个具体决策：自有鸿蒙 App 里的业务 AI 助手，运行位置放哪？密钥放哪？ 系统级入口（小艺等）解决的是系统分发与意图；你们 App 内助手仍要回答凭据、会话与工具边界。两者可以并存，不能混成「接了系统 AI 就不用管密钥」。

行业答案：薄客户端 + 自建会话服务

推荐分工如下：

• 放在哪里：手机（薄客户端）；放什么：你们自己的登录态、UI、显式注册的本地工具、权限/提问应答；不要放什么：平台 AppKey、上游模型密钥、服务端签名私钥
• 放在哪里：你们的会话服务；放什么：智能体循环、工具调度、权限引擎、上下文、与平台的令牌换发；不要放什么：把终端用户身份甩给「手机里写死的全局密钥」
• 放在哪里：平台应用配置；放什么：应用类型、能力位、模型目录等按应用下发的装配；不要放什么：假设「一个 appid 打尽桌面+手机」且不拆吊销面

移动端即便要联网搜索或抓网页，也应默认关、按应用打开，并在服务端执行，而不是让手机持搜索商密钥乱发请求。文件与命令类能力在移动拓扑下本来就不该作为「装进包就能用」的默认项。

安卓、iOS、鸿蒙若共用同一套会话服务与视图归约，三端可以共用后端；手机上仍然各自只持自己的登录态。

Tansr 在这条链路上的位置

Tansr 的鸿蒙入口是 @tansr/harmony：会话服务的原生 ArkTS 薄客户端（HAR）。资料站「鸿蒙 SDK 5 分钟跑通」写明：它负责发送输入、归约事件流、执行你显式注册的本地工具、应答权限与提问；智能体内核、权限引擎、上下文治理跑在你们部署的 @tansr/serve；手机上没有任何平台凭据。视图归约与 Android / iOS 共用同一份金样。HAR 不包含 ArkUI 页面——列表、录音、播放由宿主自己接。

兼容条件（以 2026-10-23 资料站为准）：

• 当前声明最低 HarmonyOS 6.0 / API 20（Stage 模型）；HarmonyOS 5.x 原生兼容未宣称可用。兼容 Android 的旧鸿蒙设备继续用 Android SDK。
• 当前交付是独立发布的版本化字节码 HAR 0.2.0（2026-10-10），随 harmony-sdk.zip 分发，尚未上架公共 OHPM（文档 2026-10-13 核对）。本文不把「公共仓库随时下载」或未核实渠道的 zip 获取写成已确认事实；接入前以官方当期分发说明为准，并核对包内摘要。
• 0.2.0 的请求只走 serve 0.13.0 起提供的统一调用面 /api；服务端请按 @tansr/serve 现行版本核对（公开页示例基线含 0.15.1）。

控制台创建应用时选 移动应用（含鸿蒙）。一应用一平台，多端多 appid。移动应用下文件/命令族固定关；公网工具（WebFetch / Http / WebSearch）缺省关，开启后在会话服务主机执行，鸿蒙端无需为「代发 HTTP」改客户端逻辑。

凭据路径：SDK 每次请求经 AuthProvider 取短期认证头（通常是你们登录体系的 Bearer）；服务端 authenticate 解出 endUserId。不要在客户端持有平台 AppKey、上游模型密钥或服务端签名私钥。SDK 不持久化这些头。

采用条件与边界

• 必须自建并运维 @tansr/serve（或等价会话服务部署）；薄客户端不是「模型完全跑在手机本地、无需服务」。
• 界面、录音、播放、业务存储仍由宿主完成。
• 每个终端用户缺省最多 8 个活跃会话；不用的会话应关闭，否则可能遇到容量类拒绝。
• 操作系统麦克风等权限与智能体工具许可是两层，不能互相替代。
• 本文是架构与选型说明，不是「5 分钟真机跑通」验收报告；标题若承诺跑通步骤，需要 DevEco 真机或模拟器证据——本批未做，故不承诺照做即通。

什么时候密钥「看起来」还能放客户端

只有在你接受「拿到安装包的人可以盗用额度、冒充调用」时，把模型密钥放进客户端才「技术上能跑」。对要上架、要对企业客户负责的鸿蒙 App，这通常不可接受。个人本机脚本、从不分发的调试包，另当别论——那也不该滑进正式 HAP。

说明见 鸿蒙 SDK 5 分钟跑通（见资料站同名页，不在文内外链）、平台装配与 bundle（见资料站同名页，不在文内外链）、账号、密钥、套餐与计费（见资料站同名页，不在文内外链）。本文对照 2026-10-23 资料站，未安装 HAR，未在 DevEco 复现。