【鸿蒙二开】WPS 文档跳读与提问清单

鸿蒙工程接 WPS Open SDK 时，Demo 能打开文档之后，排障效率取决于两件事：会不会按症状跳读对接文档，以及提问时能不能带齐可核对材料。这篇按社区交流帖写法，压缩成「文档地图、自查代码、渠道分工、提问模板」，方便直接对照。

文档地图

官方文档：https://365.kdocs.cn/l/clQl5cek2NoT

自查最小代码

WPSApi.registerApp(APP_KEY, APP_SECRET, {
  onCallback: (r) => {
    if (r.code !== ResultCode.OK) {
      console.error(r.code, r.msg);
      return;
    }
    if (!SdkConstants.isPersonalSdk()) {
      WPSApi.setWpsFileToken(PRO_SN);
    }
    // ready 后再 sendRequest
  },
});

未注册成功就打开，Promise 会抛异常——和「打开返回非 OK」不是一类问题。编辑验收记得 enableEdit = true。回传要把 fileUri 拷到本应用沙箱。

渠道分工

提问请带这些

1. Bundle（运行时打印值）

2. HAR 交付日 / 专业版或个人版

3. registerApp 的 code / msg

4. sendRequest 结果或异常栈

5. WPS 客户端版本

6. 已读文档哪一节、仍无法解释的现象

7. 复现：冷启动 → 注册 → 打开样例

建议把就绪态做成全局标志，打开按钮绑定该标志；失败时把 code / msg 打到可复制日志。样例文档先入沙箱再给 OpenFileRequest。注册模块不要夹带水印、回传等高级配置，先保证 ResultCode.OK，再逐项叠加。调试包与正式包包名不同时，邮件里务必写清，否则最容易出现偶发 1013。依赖侧把交付 HAR 放进 libs/，oh-package.json5 写本地 file 依赖后再 ohpm install。现场可一键导出 Bundle、HAR、注册结果、最近打开 code、客户端版本，方便远程协助对照文档章节。

小结

鸿蒙 WPS 二开的支持闭环是：文档定位 → 本地自查 → 材料齐全再进交流渠道或邮件。把提问清单贴进评审，比发版后反复追日志便宜得多。真机先确认客户端能独立打开同类文档，再看 SDK 注册日志，排障会快很多。后续编辑、水印、关窗回传都可以按专题继续聊，但都应建立在注册成功与文档跳读习惯之上；发版前再核对一次 HAR 与 Bundle，能少很多现网噪音。社区里遇到 1013 时，把 Bundle、HAR 批次、邮件申请版本三样对齐，大多能一次定位。把文档跳读表收藏到浏览器，比每次重新翻目录更快；联调记录固定六项也能让下一位同事直接接上。