免费开源的WPS AI插件 察元AI助手:installGlobalErrorLogger:启动写盘与 Vue 错误钩子

摘要

全局错误日志在 install 时尝试创建日志目录并写入 logger_boot 行,再把 Vue 的 errorHandler 接到统一 logError。排查「仅有控制台无文件」时,应检查 getApplication().FileSystem 与数据目录权限。

关键词

日志;errorHandler;Vue

扩展阅读与维护提示

本篇围绕「installGlobalErrorLogger:启动写盘与 Vue 错误钩子」组织材料。仓库内与主题最直接相关的检索词包括:日志、errorHandler、Vue。建议在阅读正文所列片段后,用 IDE 全局搜索这些符号,沿 import 与调用栈向上追问「谁在什么时机调用」,而不是只记住单文件路径。

摘要所概括的要点为:全局错误日志在 install 时尝试创建日志目录并写入 logger_boot 行,再把 Vue 的 errorHandler 接到统一 logError。排查「仅有控制台无文件」时,应检查 getApplication().FileSystem 与数据目录权限。落地到排障时,可把现象粗分为三类交叉验证:配置是否按预期写入持久化介质;WPS COM 上下文是否可用(例如是否缺少 ActiveDocument);以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类,需要与相邻篇目拼成完整拼图。

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

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

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

正文

1. 安装流程

prepareLogDirectoriesOnInstall 与 writeLogLine(logger_boot)。

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

复制代码
// src/utils/globalErrorLogger.js 第544-570行
export function installGlobalErrorLogger(app) {
  if (!app) return

  try {
    prepareLogDirectoriesOnInstall()
    const fs = getApplication()?.FileSystem
    const dir = getLogsDir()
    if (fs && dir) {
      const abs = tryEnsureLogDir(fs, dir)
      maybeCleanupOldLogs(fs, abs)
    }
  } catch (e) {
    void e
  }

  try {
    writeLogLine(
      safeStringify({
        ts: new Date().toISOString(),
        type: 'logger_boot',
        logsDir: getLogsDir(),
        ua: typeof navigator !== 'undefined' ? navigator.userAgent : ''
      })
    )
  } catch (e) {
    void e
  }

2. Vue 错误处理

app.config.errorHandler 包装 logError,携带组件名等上下文;注释说明不在此处弹层以避免渲染期递归。

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

复制代码
// src/utils/globalErrorLogger.js 第572-580行
  app.config.errorHandler = (err, instance, info) => {
    logError('vue_error', {
      info: String(info || ''),
      error: normalizeValue(err),
      component: instance?.$options?.name || instance?.type?.name || ''
    })
    console.error('[Vue Error]', info, err)
    // 不在此处弹层:避免渲染期错误 → 弹窗 → 再次触发 Vue 更新形成递归。
  }
相关推荐
玩美数据5 分钟前
海外市场数据分析驱动下的产业趋势演变与竞争格局深度解读
大数据·人工智能
oil欧哟11 分钟前
Oil Studio 的产品思路与日常使用方式:在 Mac 上录口播演示,并接入 AI Agent 精剪与自动录屏
人工智能·macos
可夫小子30 分钟前
OpenAI 用 Codex 修 ChatGPT 性能,1700 次调查只直接合入 15 个 PR
openai·ai编程
意念回复43 分钟前
从 RNN 到 GQA:自注意力与多头注意力机制全解析
人工智能·rnn·深度学习
Flynn Liang1 小时前
AI Agent 分层记忆体系实战:用 Redis 五类结构构建可淘汰、可追溯的长短期记忆
数据库·人工智能·redis
CyrusYiVPP1 小时前
新用户第二周还剩几个?pandas做留存率cohort分析,数据分析实战第6期
人工智能·python
谙弆悕博士1 小时前
多智能体架构详解:网状去中心化架构(Mesh对等P2P)
人工智能·架构·去中心化·p2p·多智能体·智能体·langgraph
吴佳浩8 小时前
我把 HAMi 摆回一台双卡机器上跑了一遍:GPU 编排的性能账,到底记在谁头上
人工智能·gpu
ndz10 小时前
PixVerse 768 个官方特效模板:Playground 预览,再用 API 批量出视频
ai编程
forest_0912 小时前
《AI 编程 Harness 实战手册》04|审批这道门:点了一百次“允许”,还剩多少作用?
人工智能·算法·prompt·agi