【摘要】

此版本为大版本更新，为 框架升级 和 提升各OS兼容性 的重要版本。 主要升级了 NodeJS 到 22.x 版本、包管理工具由 lerna 变更为 pnpm、升级了大量依赖、支持arm系统、处理了部分环境运行异常的问题，提升了各操作系统及各种环境的兼容性、优化了异常处理及日志记录机制。

【框架升级】

• nodejs：升级到 22.x 版本 #395

• 包管理工具：由 lerna 变更为 pnpm #395

• 清理和升级依赖 #396

  点击查看依赖升级详情

  • electron: 17.4.11 -> 19.1.9 (33.x 打的包太大，且升级没有太大意义，暂时不升级)
  • electron-builder: 23.0.3 -> 25.1.8
  • electron-updater: 4.3.5 -> 6.3.9
  • vue: 2.6.11 -> 2.7.16
  • vue-router: 3.4.8 -> 3.6.5
  • vue-cli-plugin-electron-builder: 2.1.1 -> 3.0.0-alpha.4
  • @vue/cli-plugin-babel: 4.5.0 -> 5.0.8
  • @vue/cli-service: 4.5.0 -> 5.0.8
  • agentkeepalive: 2.1.1 -> 4.5.0
  • ant-design-vue: 1.6.5 -> 1.7.8
  • axios: 0.21.1 -> 1.7.8
  • crypto-js: 4.0.0 -> 4.2.0
  • iconv-lite: 0.4.13 -> 0.6.3
  • log4js: 6.3.0 -> 6.9.1
  • lru-cache: 6.0.0 -> 7.15.0
  • node-forge: 0.8.2 -> 1.3.1
  • sass: 1.27.1 -> 1.81.0
  • sass-loader: 10.0.4 -> 16.0.3
  • through2: 2.0.1 -> 4.0.2
  • tunnel-agent: 0.4.3 -> 0.6.0

【新特性】

• 支持 arm 系统：包括 windows-arm64、linux-arm64、linux-armv7l、macos-arm64 #401 https://github.com/docmirror/dev-sidecar/commit/adab43b8e41e899f83e23d21a4fbdc19e5e73272
• 提供更多环境的包：macOS-x64、macOS-arm64、linux的 tar.gz 包
• 新增可配置化的 帮助中心 页面，并在该页提供 反馈问题 按钮 #408 https://github.com/docmirror/dev-sidecar/commit/b905d50c39aef47bed241799e933f4241e7bcc9e
• 主题设置：新增 跟随系统 主题 #403
• 日志保存路径、最大日志文件大小、历史日志文件保留数量，可配置化 #432 #445
• 系统代理自定义排除域名，可配置为不排除，用于忽略国内域名白名单中的域名 https://github.com/docmirror/dev-sidecar/commit/74d78207bf4eeaa64f7486725f5d7a6777ecf823
• success 和 abort 拦截器：支持自定义响应内容和响应头 https://github.com/docmirror/dev-sidecar/commit/df3b93d223f70c0bf43889a4ac00ae06a040259d https://github.com/docmirror/dev-sidecar/commit/09523c58cedf751ba3af47c3a962332aac6d1260
• 各配置中，域名匹配串支持格式如 .xxx.com 的配置，效果同 *.xxx.com https://github.com/docmirror/dev-sidecar/commit/3a0fda64838f9e81baecfe6f3b9e1e409ea05f38

  注：之前配置成 .xxx.com 是匹配不到任何域名的，也匹配不到 xxx.com

• linux系统：允许隐藏窗口了，前提是先设置好快捷键 #448

  考虑到大部分linux系统没有系统托盘，所以要求先设置好快捷键，否则无法呼出窗口。默认快捷键：Alt + S

• 新增内容搜索功能 https://github.com/docmirror/dev-sidecar/commit/67c7e39000a2a5c726f698dbe3fc7d59807fdd28

  快捷键：Ctrl + F（显示/隐藏搜索框）、ESC（隐藏搜索框）、F3 或 回车（下一项）、Shift + F3（上一项）

• 新增自定义组件：MockInput（模拟输入框），目的是为了 内容搜索功能 能够搜索到输入框中的内容 https://github.com/docmirror/dev-sidecar/commit/7519956b28cf130b96101e924bc56a871908a537
• DNS功能调整：1）新增 UDP 和 TCP 类型的DNS服务；2）修复 TLS 类型的DNS服务地址配置不生效的问题；3）删除 ipaddress 类型的DNS；4）修复DNS配置中的 cacheSize 不生效的问题（注：未生效时，默认值为：1024） https://github.com/docmirror/dev-sidecar/commit/7282098ec016c8a50361880ee568ac9dbc94fc98
• 域名白名单，支持配置为 代理，用于大范围设置 不代理，个别域名设置为 代理，起到排除作用 https://github.com/docmirror/dev-sidecar/commit/a6d2685e38a1da34fac503539941c2402588c6cb

  例子：*.xxx.com 配置为不代理，aaa.xxx.com 配置为 代理

【兼容性处理】

• 修复部分环境下，安装成功但启动报错 Error: Cannot found module '@natmri/platform-napi-darwin-x64' 的问题 https://github.com/docmirror/dev-sidecar/commit/2710f200d6bd9dbb7a79c1a9cad9acd29d920f6c
• 修复部分环境下，开发模式启动项目会缺失依赖的错误：Module not found: Error: Can't resolve 'spawn-sync' ... #376
• 修复原生模块加载失败的问题 #406 #415
• 当 @starknt/shutdown-handler-napi 和 @starknt/sysproxy 出现异常时，将异常捕获掉并尝试使用替代方案执行，尽可能的避免DS运行异常 #407

【BUG修复】

• 修复 Git.exe代理 和 npm代理 功能的http代理地址端口号不正确的问题 https://github.com/docmirror/dev-sidecar/commit/5e4e8b83858eb42bde2fc505f9fc920a1b5fc9b0 https://github.com/docmirror/dev-sidecar/commit/ff311a854b321509536fcb94d039a7e3bc278995

  原因： 1.8.7 版本为了提升协议兼容性，将 http 和 https 两个端口拆分开来了，但遗漏了这两个功能的 http代理端口号的调整

• 修复 OPTIONS 拦截器在正式请求中缺少响应头 Access-Control-Allow-Credentials 和 Cross-Origin-Resource-Policy 导致浏览器拒绝接收该跨域请求的响应的问题 https://github.com/docmirror/dev-sidecar/commit/51366cf2c8c8bd2b3e8f51b9cbd11bc77517f577 https://github.com/docmirror/dev-sidecar/commit/6a20f0da75dae168d290445f5198292e6ec0e2d7
• 预设IP设置为map而非list时，IP取值有误的问题修复 https://github.com/docmirror/dev-sidecar/commit/9d9a0ff8b82e12bee43009ced737ae5f50ae7c0c
• 所有JSON解析失败时异常捕获及处理，避免DS启动失败 https://github.com/docmirror/dev-sidecar/commit/2a7550368b36150b7c7eedf66bc3cb07168a1ae8
• 当代理服务启动，系统代理关闭时，加速服务页面显示 当前未启动 的问题修复 https://github.com/docmirror/dev-sidecar/commit/f575e6bda97abba2048b9fe34be160470a77edaa

【优化】

• 优化 设置Loopback -> 打开EnableLoopback 功能，不再需要 DevSidecar以管理员身份启动 #401-files#diff-3239150
• IP测速页面：域名太长显示不全时，鼠标移到右侧小图标，可看到完整域名 https://github.com/docmirror/dev-sidecar/commit/de70b083dd7aa2ceaa2bda779c8064aba18d643b
• 查看日志 按钮，只在 设置 和 帮助中心 页面的右上角显示 https://github.com/docmirror/dev-sidecar/commit/b6538f4fea2727c02832d26413e1124beb1db4f5
• 伪服务和伪证书作用域扩大到泛域名，而非单个域名，提升性能 #430
• 历史日志压缩保存，压缩率高达 90% ~ 95% #432
• 共享配置文件与1.x版本的分离开来 https://github.com/docmirror/dev-sidecar/commit/705dbcd80a1b07afade082092a94fc30ca87db9b
• 捕获所有文件保存失败的异常，并记录日志 https://github.com/docmirror/dev-sidecar/commit/f44dc790c7c036fb7aaa7bf4b0aa5e89e3e3e2df
• 捕获DS的各种未知异常，并将异常信息记录到日志文件中（包括UI的脚本异常） https://github.com/docmirror/dev-sidecar/commit/fe060ebfa7fc7c6ae591b119b76803ec645b1c99
• 关闭所有输入框的 拼写检查 功能，避免页面配置添加过多导致输入内容时卡顿 https://github.com/docmirror/dev-sidecar/commit/632b75f842b1388109e9e0bd197d2914387ca40d

【内置文件更新】

• pac.txt（GFW列表）: 2024/10/07 版本 -> 2025/01/12
• domestic-domain-allowlist.txt（国内域名白名单）: 2024/11/07 版本 -> 2024/12/01 版本

【文档】

• Wiki页面 开始缓慢建设中。