企业官网建设流程全解析

摘要

错误详情通过 DOM overlay 展示，避免 window.open。默认 merge 为 true 时在短窗口内合并多条 pendingLines，降低连续弹窗压力；失败时退回 alert 截断。

关键词

overlay;CEF;错误

扩展阅读与维护提示

本篇围绕「showSafeErrorDetail：合并刷新与兜底 alert」组织材料。仓库内与主题最直接相关的检索词包括：overlay、CEF、错误。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。

摘要所概括的要点为：错误详情通过 DOM overlay 展示，避免 window.open。默认 merge 为 true 时在短窗口内合并多条 pendingLines，降低连续弹窗压力；失败时退回 alert 截断。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。

教程文件名「33-cuowu-duihuakuang-yu-xiangqing.md」仅用于导航与排序，不等价于源码模块名。若正文中的行号与本地分支不一致，多半因合并导致行偏移，此时应以函数名、导出名为锚重新检索；团队若维护了生成脚本，可在变更大段源码后重新运行以保持摘录大致对齐。

本文刻意避免对产品能力做营销式承诺：所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型，应在网关、证书与代理层收口，而不是假设加载项能绕过浏览器安全模型。

若你同时阅读 docs/chayuan-llm-chain-series，可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序，再回到本教程看数据结构、默认值与修改风险面；两者互补，不重复堆砌功能列表。

正文

1. 模块级约束

文件头注释说明设计动机与 WPS CEF 注意点。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/safeErrorDialog.js 第1-9行 /** * 在 WPS CEF 内展示错误详情：仅用当前文档内的 DOM，不使用 window.open / document.write， * 降低触发 CrBrowserMain 宿主崩溃的概率。 * * 与官方「加载项网页调试」一致：异常处理遵循标准 Web API（见 MDN：error / unhandledrejection）。 * WPS 文档中 InvokeAsHttp 等接口需在回调里判断 res.status；此处为页面内 JS 全局兜底。 * * 说明：若宿主 native 层已 abort()，JS 无法拦截，只能通过避免危险调用与缩小同步负载来降低概率。 */

2. 异步合并入口

setTimeout(flushPending, FLUSH_MS) 合并 burst 错误。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/safeErrorDialog.js 第172-185行 export function showSafeErrorDetail(opts = {}) { try { const title = String(opts.title || '错误').trim() || '错误' const detail = truncateDetail(opts.detail != null ? String(opts.detail) : '') const merge = opts.merge !== false if (merge) { pendingLines.push(`【${title}】\n${detail}`) clearTimeout(flushTimer) flushTimer = setTimeout(flushPending, FLUSH_MS) return } showSafeErrorDetailSync({ title, detail }) } catch (e) {