WPS 鸿蒙二开：个人版轻量打开清单

面向大众办公、轻量协作接入 WPS Open SDK 鸿蒙版时，个人版（ToC）路径通常比专业版更短：申请个人版 HAR 与凭据后，注册成功即可打开文档，一般无需激活序列号。下文按清单整理，方便对照联调。细节以官方对接文档为准。

能力落在哪

用个人版 HAR。isPersonalSdk() 为 true 时，不要假设不落地、Token 逻辑生效。业务页不要复制两套打开函数，差异收在 prepare。联调先绿只读打开，再开编辑，最后才开回传。

关键：ToC 别用 ToB 用例验收

个人版设置 enableLocalization 不生效。需要合规不落地时，应走专业版 HAR/凭据。联调「不落地没反应」时，先看 isPersonalSdk()，再查字段。产品口头「要安全」时，先确认 flavor。

短示例与联调五步

await prepareLite(ctx, CRED); // register only
const req = new OpenFileRequest(ctx, sandboxPath);
req.enableEdit = true;
req.wpsTransferType = TransferType.URI;
const result = await WPSApi.sendRequest(req);
// 拷贝 result.data.fileUri 到本应用沙箱

1. 个人版 HAR + 注册

2. 沙箱只读打开

3. 可编辑打开

4. （可选）URI 回传拷贝

5. 正式包包名复测

每步只改一类行为。未注册就打开会进 catch。开了 URI 后 UI 提示用户关窗；外部文件先入 filesDir。

高频坑

换 HAR 后 clean。正式包复测。密钥勿进公开仓。反馈请带：flavor、是否个人版、code/msg。并发打开时拷贝目录隔离。开了回传时 UI 提示「请关闭文档」。

小结

ToC 场景 = 个人版凭据 + 注册即可打开 + 按需编辑 + 可选回传拷贝。欢迎补充真机轻量打开表现。

接入评审确认 HAR 版本与包名。把对照表贴进联调页。坚持清单验收，路径类问题更好归因。同一工程多渠道包时提前列全 Bundle 名。注释写清「个人版无需 Token」「不落地不生效」。周五正式包再验注册与可编辑打开。

联调原则仍是分层：先注册，再打开，最后回传。产品需求拆成只读/可编辑/回传三档验收。字段以官方对接文档为准。

同一仓库兼专业版路径时，用构建变体注入凭据；业务页只调 Facade。反馈请带 flavor 与 code/msg。开了 URI 后拷贝再清理临时文件。密钥勿进公开仓。坚持两周清单，轻量路径误报通常会下降。

客服工单把「打不开」「不能编辑」拆层。新人按注册 → 只读 → 可编辑 → 回传 Onboarding。路径先入沙箱，少踩笼统 ERROR。欢迎在帖下补充真机包名与 HAR 版本信息，方便对照。

更多参数见官方对接文档：https://365.kdocs.cn/l/clQl5cek2NoT

申请 SDK HAR 与凭据：m_open_sdk@wps.cn（注明包名与专业版/个人版需求）。

技术交流 QQ 群：628436767