更新日志

2026-08-14

升级提示：服务端 SDK 的改动向后兼容（现有代码不改也照常工作）；客户端那条修复须升级客户端才生效。两者可分别升级、无成对约束。

换个地址保存：带路径前缀的部署下不再存错地方

• 🚨 修复「编辑中途换个地址保存」在带路径前缀的部署下存错地方：把编辑器挂在反向代理的子路径下（如 https://example.com/api/…），或多实例部署给每个节点带节点前缀时，编辑页调用「本次另存到某地址」（session.save({ savePath })）拼出的保存地址会丢掉那段前缀——保存请求于是打到前端网关、或落到任意一个节点上，表现为保存失败、报 404，或内容存进了本不该处理它的实例。现已修正为与「改默认保存地址」（session.setSavePath()）完全一致的拼法，两个入口给出同一个地址。不带路径前缀的常规单域名部署行为不变（此前也不受影响）。保存目标「必须落在你自己后端」这道限制不变、未放宽。

保存回写地址支持只填相对路径

• setSaveFilePage 除了完整 URL，现在也接受以 / 起始的相对路径（可带查询串），例如 setSaveFilePage("/atkonoffice/doc/save?docId=" + docId)。SDK 会用本次打开所用的后端地址把它补全，与该文档的下载地址保持同源——因此反向代理挂子路径、多实例带节点前缀这些形态下前缀不会丢，你也不必再自己拼域名、自己处理「取不到就回退配置」那一串分支（那正是最容易漏掉一格、本地全对上线才坏的地方）。写法见控件能力 · 保存与回写。
• 向后兼容：传完整 URL 时行为与此前逐字一致（原样使用，跨域保存能力保留），现有代码无需改动。
• 相对路径写错（不以 / 起始、协议相对地址、查询串里带未编码的 ://——要在查询串里放一个完整地址请百分号编码）会在页面渲染前就以明确报错拦下、不产出半成品页面；若既没配后端对外地址、也无从推导，则抛原有的带配置指引异常。

2026-08-13

本批次只改 Windows 客户端：服务端与浏览器侧 SDK 零改动，无对外契约变更，新旧客户端与现有 SDK 均可混跑。升级客户端即可。

远端部署下那个填不了的授权码框

• 🚨 修复反向代理 / HTTPS 部署下打开文档时弹出「填不了的授权码框」：客户端此前会在业务登录凭据尚未就位时就去取编辑页面，于是那次请求是不带你的登录凭据发出的——被网关挡下后，客户端把挡回来的内容当成编辑页面解析，判成「未授权」并弹出授权码激活框，而框里既没有机器码可填、输入授权码也会被同一道网关挡下。本地开发环境（前后端同机）因为时序恰好相反而一直看不到这个问题，远端部署上则是每次都会出现。现在客户端会等业务凭据就位后再取编辑页面（凭据始终不到则按原有上界照旧发出、不会卡住），凭据早到时行为与之前完全一致、不引入额外等待。由你的页面承载的文档比对同受此修复覆盖。
• 服务器返回的不是编辑页面时，不再误弹授权码框：常见于把鉴权失败包成 HTTP 200 统一响应体的网关、或代理吐回的登录页。这类情形现在显示的是可重试的「未能从服务器取到编辑界面」提示——凭据恢复后点「重试」即可继续；比对模式下则直接结束加载、不再空转等待。真正的未授权不受影响：服务器确实下发了授权信息而未激活 / 已过期时，照旧弹激活框并显示机器码。
• 同一情形下的响应内容（脱敏、截断后）会记入客户端日志：此前排查这类问题必须手工复现一次请求才能看到网关到底回了什么，现在从终端用户机器的客户端日志即可判断是凭据问题还是网关配置问题。
• 修复「由你的页面承载的文档比对」取不到比对界面时窗口一直转圈：比对界面请求失败（网络中断、网关 5xx、空响应）时，客户端此前只收起比对进度提示，窗口上那层加载遮罩仍留着、并被页面尺寸变化持续刷新——用户看到的「终态」是永远转圈、无从判断已经失败。现在这类失败会一并结束加载态。由客户端自己渲染比对界面的那种（不经你的页面）此前即已正常，不受影响。

2026-08-12

🚨 本批次必须成对升级：客户端与服务端 SDK 须同版一起升（客户端 1.8.0 ↔ 服务端 SDK 1.8.0），新旧不混跑。下面两组都改了双方共用的对外契约，其中实时通道的地址还参与连接校验，一端改另一端不改会直接连不上。本批次不提供新旧兼容开关。

端点收进统一前缀 /atkonoffice，反向代理从三条规则简化为一条

• SDK 自动挂载的端点现已全部在 /atkonoffice/ 一个前缀下：拉起 / 会话 / 票据续订 / 文件取用由 /atkonoffice-rpc/* 移到 /atkonoffice/rpc/*，实时通道由 /atkonoffice-ws 移到 /atkonoffice/ws。文档取用 / 新建空白 / 授权三组端点本来就在该前缀下，位置不变。对部署是净简化：此前反代需要三条转发规则（两个游离前缀 + /atkonoffice），现在一条 /atkonoffice/ 即可（实时通道因须放行升级头仍单列一条）。可直接抄的完整 nginx 形状见开始 · 反向代理转发。
• ⚠️ 自建反向代理 / 网关的转发规则须同步改（含同域名 + 路径前缀形态）：把两条旧规则合并到 /atkonoffice/ 一条上，实时通道那条的路径也随之改为 /atkonoffice/ws。不改的症状是点「编辑」后编辑器窗口起不来、或业务页收不到任何事件回推。
• ⚠️ 显式配置过 atkonoffice.control-plane.ws-url 的须同步改值（路径段 /atkonoffice-ws → /atkonoffice/ws）：旧值指向的路径已不再有端点，实时通道会直接连不上。未显式配置（由后端地址自动推导）的无需改动。
• ⚠️ 在浏览器侧显式传过端点路径的须同步改值：launchPath 默认值改为 /atkonoffice/rpc/launch、wsTicketPath 默认值改为 /atkonoffice/rpc/ws-ticket，见类型 · atkonoffice.config。用默认值的无需改动。

撤除启动响应里的「保存地址」字段与对应配置项

• 🚨 启动响应与拉起串里不再带保存地址字段，请不要再从启动响应读取它。文档的真实保存目标一直只有一个来源：你自己在宿主页路由里设定的那个地址（setSaveFilePage）。启动时点那个字段的值虽然正确，却决定不了只读、新建等场景下的真实保存语义——它被误读为「保存的权威目标」已经实际造成过一轮排查成本，故直接撤除而非补文档说明。文档标识（docId）仍随拉起参数下达、位置不变，事件回推里的文档标识也一字未变。
• 🚨 配置项 atkonoffice.launch.save-path 撤除：保存端点的路径本来就归你自己（SDK 不注册保存端点、也不该替你决定它的路径）——上一条撤掉那个字段后，该配置项在 SDK 侧再无任何效果，留着只会是又一处会被误读的地方。⚠️ application.yml 里配过它的，请一并删掉这一行。若你此前读它来拼自己的保存地址，改为在自己代码里持一份路径常量即可，写法见开始 · 挂一个 save 路由。

2026-08-11

支持多实例部署（负载分担 / 横向扩容）

• 服务端 SDK 现支持多实例负载分担 / 横向扩容：每个实例配置一个指向自己的对外地址、负载均衡按路径前缀精确转发，一条编辑会话全程由受理它的那个实例服务，不依赖负载均衡的会话保持。部署做法（每实例地址、两类转发规则、易错点）见部署要求 · 多实例部署。
• 两条边界如实说明：节点重启 / 摘除 / 滚动更新会中断该节点上正在编辑的会话（终端用户关窗重开即可继续），请安排在维护窗口内；加 / 减节点是配置事件（改该节点配置 + 负载均衡规则），不是加副本自动生效。
• 浏览器端 SDK 新增错误码 ws_ticket_node_mismatch（config 类）：多实例的按实例路由没配对时，它是唯一的可观测信号，见错误码词表。

2026-08-09

实时通道的连接凭据改为一次性

• 编辑器与业务页接入实时通道的连接凭据改为一次性：一条已经成功使用过的凭据不能再用第二次。集成方无需改任何配置或代码，客户端也无需升级。
• 两条如实说明：① 它只覆盖「已经成功接入过」的凭据，部署要求里的两条安全前置（WS 端点日志不记查询串、生产必须 wss）仍然承重，不被本次改进替代；② 新增一格很窄的代价——「成功连上后不到一秒即断线」的重连、或终端机器系统时钟被回拨后的重连，会被判为凭据重复使用，此时编辑器会停止重连并提示关闭窗口后重新打开（重开即恢复）。

2026-08-08

保存失败一定有人看见，慢后端不再被误报失败

• 保存失败的提示改为一张常驻的可操作卡片：一行标题、一句说明、一行错误码（截图或口述给管理员时双方信息量一致）、一颗「重新保存」按钮；不再自动消失，用户处置后才收起。此前它是 8 秒自动消失的一行文字——用户没看清就没了，当场以为保存成功。「重新保存」重发失败的那一次保存、不会重新加载文档，未保存的编辑不丢失。
• 自建编辑页里保存失败时，编辑器窗口也会给出同一档提示：此前只有内置编辑页会在窗口内提示，自建编辑页只把失败回传业务页——而保存那一刻用户眼睛在编辑器窗口上、浏览器页在它后面。保存成功照旧零打扰。若你的前端也对保存失败做了提示，同一次失败会有两处提示（两处同时只看得到一个，属有意设计）。
• 后端处理较慢时，一次其实已经存好的保存不再被误报成「保存失败」：save 端点收完内容后还要做同步杀毒 / 推对象存储 / 合规扫描等耗时处理时，此前超过约半分钟未应答即被判为失败，用户按提示重试会造成重复保存；现在保存方向的判定窗口单独放宽到约 3 分钟。⚠️ 后端保存处理超过约 3 分钟时同样的误报仍会发生——正解是让 save 端点先快速应答、把耗时处理转到后台。
• ⚠️ 一条随之变得典型的边界如实说明：保存上传进行中关闭编辑器窗口，若后端应答很慢，本次保存可能既不回报成功也不回报失败（窗口照常关闭、业务页只看到编辑器关闭）——请勿以关窗作为「已保存」的依据。
• 长时间编辑的会话重新打开文档页 / 进入比对页不再那么容易失败（未显式配置后端对外地址的部署）：页面刷新过、掉线重连过的会话会自动顺延服务端记录的地址，不再固定一小时后失效。显式配置了 backend-origin 的部署不走此机制、行为不变。

打开与保存的传输中断有了明确结论（网页端错误码同步扩充）

• 网页端 SDK 新增两条稳定错误码：open() 在「请求根本没发出去」（后端没起 / 断网 / 跨域被拦）与「后端答复的不是 JSON」（网关 / 反代返了 HTML 错误页）时，分别以 launch_request_failed / launch_response_not_json 拒绝——这两条恰是接入联调期最常撞的失败，此前抛出的是不带错误码的浏览器原生错误。词表见错误码参考。⚠️ 行为变更：若页面写过「捕获到原生 TypeError 就提示检查后端」这类分支，从此不再被触发，请改按错误码分流（词表开放，保留 default 兜底）。
• 服务器半途不再接收内容时，保存不再无限转圈：有限时间内判定为保存失败并给出可重试提示；「上传中途被中止」也不再被当成保存成功——保存是否成功同时看传输结果与服务器答复。正常的慢速上传不受影响（判定依据是「对方是否还在接收」，不是快慢）。
• 四个页面方法（发送文件到地址 / 下载文件到本地 / 插入图片 / 从地址插入文档）不再可能把编辑器冻死：服务器半途停止收发时，在有限时间内中止并抛出页内异常。⚠️ 行为变更：这些方法此前会一直挂着或静默返回成功，现在会抛异常 / 判失败；「答复成功但零字节内容」也一律判失败——「下载文件到本地」不再可能把页面指定的目标文件清空还报成功。页面脚本若依赖「调用返回即成功」，需补上错误处理。
• ⚠️ 新增一条无差别的总时长上限：页面方法发起的单次下载总耗时超过约半小时会被中止——此前不设时限、原本能成功的超长下载现在会失败。有超大内容下载需求时请评估链路带宽或改为分片。

2026-08-06

取文档失败不再被误报成「文件损坏」

• 服务器半途不再传输文档内容时，客户端不再无限转圈：有限时间内判定为取文档失败，给出「无法获取文档」提示卡 + 错误码 + 重试按钮；此前这期间被静默忽略的保存与页面脚本也随之恢复响应。判定依据是「对方是否还在传输」而不是快慢——慢网络、大文档照常完成。
• 半途中断的下载不再变成一份「损坏的文档」：此前会把已收到的部分内容当作完整文档交给编辑器，编辑器随即报「文件损坏」，用户被指去排查文档本身。现在传输结果与服务器应答都正常才算成功，判定失败时不落盘、不交给编辑器。
• 服务器答复成功但内容为零字节时（存储组件读到空、下载地址指到空对象、中间反代吞掉内容），同样在取内容那一步判为失败，不再报成「文件损坏」——日志里也能直接分辨「答复成功但没有内容」与「对方拒绝」「传输中断」。
• 三个页面方法（下载文件到本地 / 插入图片 / 从地址插入文档）写不进本机文件时不再假装成功：磁盘满、目录不可写时抛出页内异常，不再把空 / 半截文件当成功交付。⚠️ 行为变更：此前静默返回成功，页面脚本若依赖「调用返回即成功」需补上错误处理。

2026-08-05

等待可信：加载指示统一为循环转圈，取文档不再卡住窗口

• 打开、保存、文档比对三处的加载指示统一为循环转圈 + 一句进展文案（「正在获取文档…」「正在装载文档…」这类），不再出现分段百分比进度条与「停在某个百分比像卡死」的观感；失败提示卡上那条停在满格的红色进度条一并移除。
• 取文档期间编辑器窗口不再无响应：从服务器取文档字节这一步改到后台执行——转圈持续转动、窗口可拖动、点关闭正常走关闭流程。这是慢网络下最长的一段，也是「看起来像卡死」的主要来源。
• 文档还没装载完就点保存，不再收到一次假的「保存失败」：过早的保存请求被直接忽略，装载完成后再点即正常保存。
• 文档比对的两份文档改为按序装载（左边完成后再装右边），修复偶发「右边出图、左边空白」；打开前预填的数据区域改为文档装载完成后执行，慢网络下不再偶发静默落空。
• 本机磁盘写不进时有了自己的提示卡「无法写入本机磁盘」：正文说明文档内容其实已取到、问题在本机，下一步是清理磁盘空间或确认临时目录可写；附专用错误码与「复制诊断信息」按钮，不给「重试」按钮（腾出空间前重试必然同一结果）。此前磁盘满 / 目录只读会被谎报成「文档损坏」，排查方向完全错位。
• 🚨 升级须知：本批次客户端与服务端 SDK 的配套是双向的，须同批升级——只升客户端会出现比对偶发一边空白、预填偶发落空；只升服务端 SDK 会出现比对一直停在加载。最低配套版本：客户端 1.7.0 需配服务端 SDK 1.7.0 及以上，反之亦然（自本批次起客户端与服务端 SDK 版本号统一）。

2026-08-04

编辑器异常消失会通知网页；时间偏差容忍放宽到 15 分钟

• 编辑器窗口异常消失（进程崩溃 / 被强杀）后，业务页不再永远停在「编辑中」：服务端在一段宽限期后通知网页「编辑器已不在」，通知说明是正常关闭还是异常消失（shellClosed 事件的 reason 字段，见类型 · 事件负载）；既有监听「编辑器关闭」的集成方无需改代码。⚠️ 如实说明：这条通知有延迟（默认量级两分钟，随服务端配置），宽限期届满前刷新页面会丢掉它；终端用户整机断电 / 断网 / 休眠属连接状态事件的辖区，不走这条通知。
• 业务页新增一对连接状态事件 channelLost / channelRestored：网页可以在「连接断了、正在后台自动恢复」时给出准确提示、恢复后自动撤掉；断开通知会说明这次能不能自行恢复。与既有错误通知分层并存，两层挑一层处理即可（一条例外见类型 · 事件负载）。
• 终端机器与服务器时间只差几分钟不再完全无法编辑：可容忍的时间偏差从 1 分钟放宽到 15 分钟（配置项 max-drift-sec 默认值随之改变，显式配过的部署不受影响），覆盖未配 NTP 的自然时钟漂移、虚拟机挂起迁移等情形；小时级以上的偏差（日期 / 时区设错）仍会报错——那属于配置错误，报出来才对。⚠️ 两条部署安全前置（WS 端点日志不记查询串、生产必须 wss）随本次放宽成为承重条件；服务端与客户端须同批升级，只升一侧会得到「连接建得起来但通知全部丢失」的半通状态。
• 后端不可达超过约 3.5 分钟后，业务页不再永久放弃：转入低频后台重试，后端恢复后无需用户操作自动接上，保存通知继续送达（后端重部署、临时断网、笔记本休眠唤醒都属这一格）；编辑器窗口那一侧同样改为低频长驻重试，不再整晚高频敲后端（代价是长中断恢复后重新接上最多晚约 5 分钟）。
• 「时间不一致」的失败提示现在写出实测差了多少（如「时间相差约 20 分钟」）——这是管理员唯一能直接动手核对的信息。个别环节拿不到实测值时，提示与此前相同。

2026-08-03

连接断了会说话：编辑窗口的连接提示与重连收敛

• 编辑窗口在与页面的实时连接中断时给出角落提示（不遮挡文档、不影响继续编辑与保存），按情形给出该做什么：已停止重试的提示关窗重开、服务器时间需校正的提示联系管理员（校正后自动恢复、无需关窗）、正在自动重试的只告知无需操作。提示持续显示到连接恢复为止；几秒内自愈的瞬时抖动不打扰用户。
• 重连无济于事的情形（会话已失效、凭据配置有误）不再无效重连：编辑窗口停止重试并给出提示（此前每秒多次、可能拖慢同一出口下其他用户的访问）；业务页侧同样改为立即给出终态提示，不再先空转约 3.5 分钟。
• 网络中断超过一分钟后恢复，不再误报「本机与服务器时间不一致」：每次重连都重新生成凭据，网络恢复即刻连上（此前会拿中断前的过期凭据去连、被误判成时间偏差，还要白等约 5 分钟才自行恢复）。
• 某些网络环境下业务页永远收不到保存通知的问题已修复：网络设备不转发连接保活信号时，此前网页会把服务器的判死断开当成「本次编辑已正常结束」而不再重连（文档保存成功、网页却一直显示不出来）；现在照常重连并在恢复后继续收到保存通知。
• 打开失败提示上的「重试」按钮此前点了会永久停在「正在加载文档」：已修复，重试会真的重新打开文档（沿用原有登录状态、不会因此掉登录）。

2026-08-02

失败提示能报给管理员：错误码上卡，重试按钮按能否自愈显示

• 文档窗口打开失败时，提示卡片显示稳定错误码：用户截图或口述给管理员时，双方拿到的信息不再一样多。（此前版本的说明曾写「错误提示不再出现内部术语与错误码」——自本版本起口径调整：提示文案依旧面向用户、不含内部术语，另附一行可报给管理员的错误码。）
• 对重试无济于事的失败（时间不同步、未授权、编辑组件未安装、打开参数有误），提示卡原「重试」位置改为「复制诊断信息」按钮：一键复制错误码、时间与客户端版本号，可直接发给管理员。网络抖动、编辑器忙、装完 WPS 再试等可自愈的失败仍给「重试」。
• 时间不一致的提示改为双向中性、并写出实测差值：原提示单方面写「设备时间不正确，请校准后重试」，而时间差是相对的——照此去改本机时间可能把本来准确的电脑调错。新提示为「本机与服务器的时间不一致（时间相差约 X）」，并把「先联系管理员校准服务器时间」放在「再确认本机时间」之前。
• 打开失败按原因分别措辞：「取不到文档内容」「取不到编辑界面」「打开参数有误」各自给出可区分的说明与下一步，不再罗列「可能是网络异常、登录态过期或无访问权限」这类并列猜测；能确定的直接指明，确定不了的如实说明。
• 浏览器端 SDK 的错误对象新增稳定 code / category 字段：业务页可按错误码编程分流（区分「接入配置有误」「拉起未完成」「事件通道抖动」），不必再匹配英文提示文案；随包类型声明同步更新。词表见错误码参考。
• 修复后端重启或长时间编辑后，业务页重新订阅文档事件失败、收不到保存回推的问题；页面并发发起的重复订阅已收敛为一条。

2026-07-31

打开失败当场给出可读原因

• 打开文档失败（服务未启动 / 未登录 / 无访问权限 / 断网）时，编辑器窗口不再转圈约 45 秒后给一句与真实原因无关的「无法获取文档」，而是窗口出现后立即给出指向网络、登录状态或访问权限的可读提示，且不再被后续提示覆盖。
• 保存或打开文档后立即关闭编辑器窗口，不再偶发进程残留（此前可能导致下次点「编辑」提示「编辑器正忙」）；连续多次保存或下载不再持续占用后台资源。

2026-07-30

生产环境打开提速与保存体验

• 生产 HTTPS 环境下从业务页点「编辑」到编辑器显示出文档，由此前的 10~20 秒（且时快时慢）稳定到 2~3 秒。
• 接口较慢时，点「编辑」后编辑器窗口立即出现并显示加载进度，不再长时间「点了没反应」；等待建立会话期间给出「正在建立安全会话…」的明确提示。
• 保存大文档或慢网络上传时，编辑器窗口不再卡顿、不再被 Windows 判为「未响应」；保存上传进行中关闭窗口会先等本次上传安全完成，不中断在途上传。

2026-07-25

Word 数据区域锁定：关键字段防误改、可由代码即时更新

• Word 文档里的数据区域（模板填充位、以及经代码在文档中创建的区域）现在是锁定的：终端用户在编辑器里无法手动改动这些区域的内容、也无法删除它们；文档的其余部分照常正常编辑。适合合同金额、公文文号等「希望预填、且不希望被手误改动」的关键字段。
• 业务页现在可以在编辑过程中经代码即时更新锁定区域的内容（浏览器侧新增 atkonoffice.session.word.fillDataRegion(name, value)）：例如在编辑器里点一个业务按钮，把某个锁定区域的值刷成最新数据；终端用户手动改动该区域仍然被拦。
• 集成写法见Word · 数据区域。

2026-07-22

同一时间只保留一个编辑窗口

• 现在同一台电脑上同一时间只保留一个文档编辑窗口。已有编辑窗口在使用时，从网页再次点击打开文档不会再弹出新窗口，而是切换到已打开的那个窗口并给出提示（说明已有窗口正在使用，如需打开其它文档请先关闭当前窗口）。
• 文档正在打开的过程中重复点击会给出「正在打开，请稍候」提示，避免冷启动期间连点开出多个窗口。
• 修复了在网页里快速重复点击「编辑」时，浏览器标签页 / 窗口的标题偶尔残留一串内部标记文字、且此后无法自行恢复成原标题的问题；现在无论如何重复触发打开，打开流程结束后页面标题都会正确复原。

2026-07-21

编辑器内可弹提示框，保存 / 加载提示更轻盈

• 编辑页新增弹出提示 / 确认框能力（atkonoffice.session.showMessageBox）：可在编辑器里弹出一个提示框，显示在正在编辑的文档之上、不被文档遮挡，支持信息 / 确认 / 警告 / 错误四种样式与「确定」「确定 / 取消」「是 / 否」「是 / 否 / 取消」等按钮组合，用户点了哪个按钮会回传给页面——可用于「保存前先确认」等场景。集成写法见通用控制 · 弹出提示与确认框。
• 在编辑器里保存文档时，「正在保存文件」的提示不再铺满、盖住正在编辑的文档，而是改为悬浮在文档上方的一张小提示卡，保存过程中文档四周始终可见；卡内新增一条真实推进的进度条（随导出 → 上传各阶段平滑向前、只增不退），快速保存时提示卡也会短暂停留、不再一闪而过，让保存进度可感知；「原格式 + PDF」等多产物保存会按产物逐档推进。
• 打开文档时的加载 / 失败提示同样改为悬浮在编辑区之上的一张小卡片，加载过程中编辑区周围始终可见，加载指示、失败提示与重试都呈现在这张卡上，与保存提示风格统一。
• 编辑窗口标题统一为「ATKONOFFICE」，并在标题栏 / 任务栏 / Alt-Tab 显示产品品牌图标；保存 / 加载提示卡的观感一并打磨为更干净的圆角悬浮卡。
• 修复保存进行中重复点击保存会触发多次保存的问题：保存进行期间再次点击保存会被忽略，本次保存完成后即可正常再次保存。

2026-07-16

客户端打开更稳、失败提示更清晰

• 在网页里点「在客户端打开」后，若在弹出编辑窗口之前就失败（如无法连接到服务器、本产品未授权、设备时间不正确等），客户端现在会弹出一条面向用户、可操作的提示，引导下一步怎么做，而不再是「点了没反应、只能查日志」。
• 对「未授权」「无法连接到服务器」这类常见打开失败，客户端会直接打开一个与正常编辑窗口体验一致的窗口，在其中清晰展示失败原因与下一步指引；同一次失败只提示一次，不重复弹窗。
• 业务网页可感知「编辑器窗口已关闭」：终端用户关闭客户端里的编辑器窗口后，网页会收到通知，可据此自动复位页面状态（例如把「编辑中」按钮恢复为可再次打开），无需手动刷新。
• 修复本机已打开 WPS（如另一个 WPS 表格或文档）时，在客户端打开 Office / WPS 文档偶发「窗口已弹出、文档却嵌不进去」的问题（尤以表格多见）：遇到「WPS 正忙」会自动短暂重试，多数瞬时占用可自动恢复；若确因本机 WPS 被占用（如停在某个对话框上）始终无法嵌入，会给出可操作提示，引导先关闭本机其它 WPS 窗口再点「重试」，而不再只显示笼统的「嵌入失败」。
• 改善「设备时间与服务器有偏差」时打开文档的体验：小幅偏差客户端自动校正并照常打开、用户无感；偏差过大时给出「设备时间不正确，请校准后重试」的明确提示，而不再是打开无反应。（该提示的措辞已由后续版本修正为双向中性并显示实测差值——时间差是相对的，单方面指认设备可能把本来正确的机器调错，见 2026-08-02 条目。）

后端对外地址免配置

• 常见部署下业务后端不再需要单独配置对外地址：浏览器端 SDK 已配置的后端基址（atkonoffice.config({ backendBase })）会随打开请求上送，服务端据此生成客户端拉起链接、文档下载 / 保存地址与实时通道地址，端到端「开-编-存」全链路在后端零地址配置下即可跑通。
• 若部署中「浏览器可达地址」与「客户端可达地址」不一致（如经 Web VPN / 代理），仍可在后端显式配置该地址来覆盖，显式配置优先级最高。
• 配置说明见配置项 · atkonoffice.launch.*。

2026-07-13

Windows 客户端安装体验升级

• 安装全程为标准简体中文安装向导：欢迎页、安装目录选择（支持自定义安装位置，重装时默认回显上次位置）、安装进度、完成页；卸载前先出确认页再执行。
• 安装包与卸载程序带产品图标和版本信息；系统「设置 → 应用」中的客户端条目补齐图标、版本号、发布者与占用空间。
• 安装完成页新增「立即启动」选项（默认勾选）：勾选则装完即可用；取消勾选则首次在网页中发起编辑时自动就绪。
• 自定义目录安装后，网页一键拉起客户端照常可用。
• 企业批量部署的静默安装（安装包命令行加 /S）行为不变：除系统提权提示外无任何界面，装完即刻可用。

2026-07-12

保存反馈更可信、异常提示更友好

• 在编辑窗口内保存失败时，窗口内会出现即时提示（不打断编辑、不遮挡文档），按失败原因给出友好说明，可就地继续编辑或再次保存重试；此前保存失败时窗口内无任何反馈。
• 保存完成通知如实反映本次是否真正保存成功、实际产出了哪些格式，修正了个别情形下「实际未保存却提示成功」的问题。
• 编辑窗口与业务页之间的状态同步通道异常、以及编辑组件未正确安装时，均给出可读的中文提示与恢复指引，取代此前的无响应或英文系统消息。

2026-07-11

一次保存产出多份产物

• 保存时可声明把当前文档同时产出为一组产物（如原格式 + PDF），一次动作全部产出并一并送达业务后端：要么都成、要么都不落，不会出现半份结果；不声明时与普通保存完全一致。
• 保存完成通知升级为产物清单，业务页可据此得知本次实际产出了哪些格式。
• 修复使用内置本地盘存储时，文档标识含中文、空格等特殊字符的文档无法打开的问题。
• 集成写法见通用控制 · 多产物保存。

编辑加载失败可就地重试

• 「未检测到 WPS」「无法获取文档」「编辑器加载失败」等失败提示上新增**「重试」按钮**：处理好环境（如装完 WPS）后点重试即可继续，无需返回网页重新发起。（「重试」按钮的适用范围已由后续版本按失败能否自行恢复细分，且失败提示本身已按原因拆分措辞，见 2026-08-02 与 2026-08-05 条目。）
• 失败提示收归编辑窗口统一呈现，不再在网页里额外弹重复提示框；业务自行订阅的失败回调不受影响。
• 修复个别打开失败场景界面无任何反馈（「点了没反应」）的问题；消除文档会话结束后的无谓后台重连与错误提示噪声。

授权校验与激活引导

• 未持有效授权的部署在打开文档时不再进入编辑器，改为弹出激活引导；持有效授权的部署使用体验完全不变。
• 授权码激活失败时按具体情形（授权码无效 / 已过期 / 未绑定本机 / 服务暂时不可用等）给出针对性说明与下一步指引。
• 客户端错误提示整体更友好，不再出现内部术语与错误码。授权说明见产品授权。（其中「不再出现错误码」的口径已由后续版本调整：失败提示会另附一行可报给管理员的稳定错误码，提示文案本身依旧不含内部术语，见 2026-08-02 条目。）

2026-07-10

打开接口参数模型统一（接入面变更）

• open() 支持携带自定义业务参数：params 中的自定义键（如 bizType）随打开透传到后端路由，后端据此按业务场景分流，无需为每种场景单开接口，见业务参数透传与分流。
• 字段更名：业务页地址 page → pageUrl、后端路由 hostPagePath → pageApi、Word 比对目标由顶层 compareWith 移入 params.compareDocId。
• 移除四个从不生效的入参（openType / compareMode / compareHost / create），直接删除即可、功能零损失。
• 本文档全部示例已按新命名更新；早前对接的集成请对照通用控制更新调用。

2026-07-09

服务端 SDK 同时支持两代 Spring Boot 技术栈

• 同一服务端 SDK 现发布两套制品：Spring Boot 3.x / JDK 17 用无尾缀正式版，Spring Boot 2.7 / JDK 8 用 -javax 兼容版；API 完全一致，按后端大版本二选一。
• 安装坐标见开始 · 安装。