拼写检查服务:Application 回退与停止请求
摘要
在 ShowDialog 内可能缺少 Application,getApplication 从 opener/parent 回溯。停止标志通过 localStorage 键前缀写入,并结合 storage 事件取消 in-flight 批次。
关键词
spellCheck;storage;取消
扩展阅读与维护提示
本篇围绕「拼写检查服务:Application 回退与停止请求」组织材料。仓库内与主题最直接相关的检索词包括:spellCheck、storage、取消。建议在阅读正文所列片段后,用 IDE 全局搜索这些符号,沿 import 与调用栈向上追问「谁在什么时机调用」,而不是只记住单文件路径。
摘要所概括的要点为:在 ShowDialog 内可能缺少 Application,getApplication 从 opener/parent 回溯。停止标志通过 localStorage 键前缀写入,并结合 storage 事件取消 in-flight 批次。落地到排障时,可把现象粗分为三类交叉验证:配置是否按预期写入持久化介质;WPS COM 上下文是否可用(例如是否缺少 ActiveDocument);以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类,需要与相邻篇目拼成完整拼图。
教程文件名「15-pinxie-jiancha-fuwu-yu-duochuang-kongzhi.md」仅用于导航与排序,不等价于源码模块名。若正文中的行号与本地分支不一致,多半因合并导致行偏移,此时应以函数名、导出名为锚重新检索;团队若维护了生成脚本,可在变更大段源码后重新运行以保持摘录大致对齐。
本文刻意避免对产品能力做营销式承诺:所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型,应在网关、证书与代理层收口,而不是假设加载项能绕过浏览器安全模型。
若你同时阅读 docs/chayuan-llm-chain-series,可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序,再回到本教程看数据结构、默认值与修改风险面;两者互补,不重复堆砌功能列表。
正文
1. Application 获取
避免对 window.Application 赋值引发只读错误,只做读取链式回退。
阅读源码摘录时,请把它当作「定位入口」而非完整实现:同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前,建议用最小文档手工走一遍相关助手或对话框,并观察任务清单与日志中的字段是否与预期一致,再决定是否做数据迁移或配置重置。
// src/utils/spellCheckService.js 第20-23行
/** WPS ShowDialog 内可能无 Application,从 opener/parent 获取(不赋值 window.Application,避免只读属性报错) */
function getApplication() {
return window.Application || window.opener?.Application || window.parent?.Application
}
2. 停止键与 storage 监听
NdSpellCheckStop 前缀键与事件监听将取消信号广播到所有相关窗口。
阅读源码摘录时,请把它当作「定位入口」而非完整实现:同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前,建议用最小文档手工走一遍相关助手或对话框,并观察任务清单与日志中的字段是否与预期一致,再决定是否做数据迁移或配置重置。
// src/utils/spellCheckService.js 第27-59行
const activeSpellCheckRuns = new Map()
const STOP_REQUEST_KEY_PREFIX = 'NdSpellCheckStop:'
function getStopRequestKey(taskId) {
return `${STOP_REQUEST_KEY_PREFIX}${taskId}`
}
function setStopRequested(taskId, value) {
try {
if (value) {
localStorage?.setItem(getStopRequestKey(taskId), '1')
} else {
localStorage?.removeItem(getStopRequestKey(taskId))
}
} catch (_) {
// Ignore storage write failures and keep in-memory stop handling available.
}
}
function isStopRequested(taskId) {
try {
return localStorage?.getItem(getStopRequestKey(taskId)) === '1'
} catch (_) {
return false
}
}
if (typeof window !== 'undefined' && !window.__ndSpellCheckStopListenerBound) {
window.addEventListener('storage', (event) => {
if (!event?.key || !event.key.startsWith(STOP_REQUEST_KEY_PREFIX) || event.newValue !== '1') return
const taskId = event.key.slice(STOP_REQUEST_KEY_PREFIX.length)
const runState = activeSpellCheckRuns.get(taskId)
if (!runState) return



