在 HarmonyOS 项目里接入时，真正卡住进度的往往不是「会不会写 OpenFileRequest」，而是接入准备阶段的一组高频疑问：凭据怎么和包名对应、换 HAR 后为何还报 1013、注册成功前能不能打开、激活序列号该写在哪、为什么打开后只能预览。本文按「申请 → 注册 → 打开」把这些问题收成可执行的排查顺序，字段语义以官方对接文档为准。

在 HarmonyOS 应用接入后，打开与编辑往往先跑通，下一步产品会要求「用户关文档后，把编辑结果拿回本应用」。对接文档把这类能力挂在与本文按调用链说明等待语义、结果字段、拷贝到本应用沙箱的写法与联调清单，细节以官方对接文档为准。

说明 HarmonyOS 工程用 WPS Open SDK 的 OpenFileExtraOptions：仅显式赋值生效、分享打印云文档等开关语义，以及预设策略与联调清单。

说明 HarmonyOS 工程用 WPS Open SDK 在打开文档时配置水印与修订：WaterMark、Revision 字段语义、与 enableEdit 的叠加顺序，以及可复用封装与联调清单。

说明 HarmonyOS 工程用 WPS Open SDK 控制文档只读与可编辑：enableEdit 语义、与 OpenFileRequest 其它字段的边界、预览/编辑双入口封装，以及联调时常见误判。

按调用链说明 HarmonyOS 工程用 WPS Open SDK 的 OpenFileRequest 打开本地文档：registerApp、沙箱路径、enableEdit 与 sendRequest 结果处理，并给出可复用封装与联调清单。

说明 HarmonyOS 工程接入 WPS Open SDK 时，不同 HAR/凭据形态下的注册分叉、激活序列号注入与字段生效差异，并给出可复用适配层封装与联调清单。

按最小可运行链路说明 HarmonyOS 工程接入 WPS Open SDK：HAR 依赖、registerApp、沙箱路径与 OpenFileRequest，并给出联调排错与封装建议。

从 HarmonyOS 工程视角概述 WPS Open SDK：HAR 集成、WPSApi 单例、registerApp 到 OpenFileRequest 的主链路，以及打开、策略与关窗回传如何落在同一参数模型。

回顾 HarmonyOS 工程接入 WPS Open SDK 的主调用链：registerApp、OpenFileRequest、策略字段与关闭回传，并给出可复用 Facade 与联调顺序，便于周复盘与新人上手。