跳到主要内容

WPS Office 软件连接

通过 Bridge，Quicker 可以调用 WPS Office 中的文档与选择、表格区域、文字替换、幻灯片、已有宏及 JavaScript等能力。完整安装过程见安装与管理，本页说明该软件的差异。

适用范围​

需支持 JSA；已有个人版 12.1.0.28505 加载与回连记录。现有验证针对 Windows 个人版，不代表所有 WPS 发行包均支持。

安装前准备与首次启用​

安装机制：官方网页统一管理文字、表格、演示三个加载项。

  1. 先启动一次 WPS，确保本地加载项服务运行。
  2. 在 Quicker 设置 → 连接 → 软件连接 选择 WPS Office，打开WPS 加载项管理页。
  3. 在管理页分别安装文字、表格和演示三个加载项；安装或更新后，完全退出并重新打开对应 WPS 应用。
  4. 分别打开文档、表格和演示文件，允许各组件的加载项启用提示。看到 Quicker 标签后，在 Quicker 的软件连接页检查在线实例。

三个组件需要分别安装和启用。若某个组件已安装却没有 Quicker 标签，在该组件的 工具 → WPS 加载项 中找到对应的 Quicker 加载项并启用。仅有加载项文件不代表运行中的 WPS 已加载它。

确认连接​

安装并启用后，打开 Quicker 设置 → 连接 → 软件连接 → WPS Office，确认出现在线实例。打开命令工具并选择实例，用空对象 {} 调用 bridge.ping。成功响应及 pong: true 表明本次会话可调用；版本与当前文档摘要以实际结果为准。

宿主没有打开文档时，部分业务命令可能不可用；先测试连接，再测试文档命令。详细步骤见连接状态与命令工具。

创建动作​

使用WPS Office控制，或在命令工具选择命令、填写参数后点击 生成动作，粘贴到 Quicker 面板。模块页提供只读的最小连接示例。

动作通常根据触发时的前台 WPS 窗口（HWND）和目标组件精确定位。相同窗口有多个组件时须明确选择文字、表格或演示；没有匹配会话时失败。2.2.15 起，若仅有一个匹配的在线连接，不再强制要求从目标 WPS 窗口触发；详见动作怎样选择目标。

动作不保存工具窗口选择的临时 session。请阅读立即调用与动作目标的区别，再配置快捷键、面板或轮盘触发。

限制与排障​

同一 WPS 窗口可能承载多个组件。通用命令如 bridge.ping 应明确选择文字/表格/演示，组件专用命令可自动判断；WPS 发行版缺少 JSA 时无法通过复制文件补齐。

命令全集来自当前实例的 command.list，本文不保证每个命令在所有宿主版本或文档状态下均可用。遇到问题先保存错误和版本信息，按通用排障定位安装、加载、连接或命令执行阶段。

相关页面​