WPS 鸿蒙二开：ToB 不落地与水印清单

政企办公接入 WPS Open SDK 鸿蒙版时，常见要求不只是能打开文档，还包括：专业版客户端与激活序列号、文档默认不落地、打开页水印、分享打印可控，以及关窗回传。下文按清单整理，方便对照联调。细节以官方对接文档为准。

能力落在哪

用专业版 HAR。isPersonalSdk() 为 true 时不要假设不落地生效。业务页不要复制两套打开函数，差异收在 prepare。联调先绿可编辑打开，再叠不落地与水印，最后才开回传，失败时更好归因。

关键：不落地优先于 extraOptions

不落地时分享/打印/另存为等会被强制关闭，extraOptions 无法打开它们。要细控菜单须先 enableLocalization = true。联调「关了分享却还能点」时，先看是否可落地、字段是否写入同一次请求。产品口头「要安全」时，拆成不落地、水印、菜单、回传四档验收，避免混测。

短示例与联调五步

await preparePro(ctx, CRED); // register + setWpsFileToken
const req = new OpenFileRequest(ctx, sandboxPath);
req.enableEdit = true;
req.wpsWaterMarkParams = { Enable: true, WaterMaskText: '内部', Angle: -30 };
req.wpsTransferType = TransferType.URI;
const result = await WPSApi.sendRequest(req);
// 拷贝 result.data.fileUri 到本应用沙箱

1. 专业版 HAR + 注册 + Token

2. 可编辑打开（无策略）

3. 确认默认不落地

4. 加水印；（可选）可落地 + extraOptions

5. URI 回传拷贝

每步只改一类行为。未注册就打开会进 catch。开了 URI 后 UI 提示用户关窗；fileUri 在 WPS 沙箱，必须先拷贝到本应用目录再上传。外部文件先入 filesDir，少踩笼统 ERROR。

高频坑

换 HAR 后 clean。正式包复测。密钥勿进公开仓。开了回传时 UI 提示「请关闭文档」。路径先入沙箱。反馈请带：是否不落地、是否已 Token、code/msg。并发打开时拷贝目录隔离。清理临时文件失败不必当成打开失败。

小结

ToB 场景 = Token + 不落地默认 + 水印/菜单 + 回传拷贝。欢迎补充真机不落地与菜单表现。

接入评审确认 HAR 版本与包名。把对照表贴进联调页。不落地 + URI 时拷贝后再清理临时文件。坚持清单验收，策略类问题更好归因。同一工程多渠道包时提前列全 Bundle 名。注释写清强制关闭规则，减少误报。周五正式包再验注册与不落地可编辑打开。

联调原则仍是分层：先可编辑打开，再叠策略，最后回传。产品「要安全」拆成四档验收，比一张大用例清晰。字段以官方对接文档为准。