Merge branch 'master' into copilot/fix-system-proxy-error-macos

Author: cute-omega

.github/workflows/build-and-release.yml

@@ -230,7 +230,6 @@ jobs:
           ren DevSidecar-${{ steps.package-info.outputs.version }}-x64.exe   DevSidecar-${{ steps.package-info.outputs.version }}-windows-x86_64.exe;
           ren DevSidecar-${{ steps.package-info.outputs.version }}-ia32.exe  DevSidecar-${{ steps.package-info.outputs.version }}-windows-ia32.exe;
           ren DevSidecar-${{ steps.package-info.outputs.version }}-arm64.exe DevSidecar-${{ steps.package-info.outputs.version }}-windows-arm64.exe;
-          ren DevSidecar-${{ steps.package-info.outputs.version }}.exe       DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe;
           dir;
       - name: "Rename artifacts - Linux"
         if: ${{ matrix.os == 'ubuntu' }}
@@ -292,13 +291,6 @@ jobs:
           path: packages/gui/dist_electron/DevSidecar-${{ steps.package-info.outputs.version }}-windows-arm64.exe
           name: "DevSidecar-${{ steps.package-info.outputs.version }}-windows-arm64.exe"
           if-no-files-found: error
-      - name: "Upload DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe"
-        uses: actions/upload-artifact@v4.4.0
-        if: ${{ matrix.os == 'windows' }}
-        with:
-          path: packages/gui/dist_electron/DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe
-          name: "DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe"
-          if-no-files-found: error
       # endregion Upload artifacts - Windows
 
       # region Upload artifacts - Linux
@@ -474,11 +466,6 @@ jobs:
         with:
           name: "DevSidecar-${{ steps.package-info.outputs.version }}-windows-arm64.exe"
           path: release
-      - name: "Download DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe"
-        uses: actions/download-artifact@v4.1.8
-        with:
-          name: "DevSidecar-${{ steps.package-info.outputs.version }}-windows-universal.exe"
-          path: release
       # -------------------------------------------------------------------------------------------------------------------------
       - name: "Download DevSidecar-${{ steps.package-info.outputs.version }}-linux-x86_64.deb"
         uses: actions/download-artifact@v4.1.8
@@ -575,4 +562,4 @@ jobs:
           GHR_PATH: release/
           GHR_TITLE: ${{ github.ref_name }}
           GHR_REPLACE: true
-          GHR_DRAFT: true
+          GHR_DRAFT: true

.github/workflows/npm-run-electron.yml

@@ -113,11 +113,9 @@ jobs:
           pnpm install;
 
       - name: "npm run electron"
+        working-directory: packages/gui
         run: |
           echo "======================================================================";
-          echo "cd packages/gui";
-          echo "--------------------";
-          cd packages/gui;
           dir || ls -lah;
 
           echo "======================================================================";

.github/workflows/test-and-upload.yml

@@ -258,7 +258,6 @@ jobs:
           ren DevSidecar-${{ env.BUILD_VERSION }}-x64.exe   DevSidecar-${{ env.BUILD_VERSION }}-windows-x86_64.exe;
           ren DevSidecar-${{ env.BUILD_VERSION }}-ia32.exe  DevSidecar-${{ env.BUILD_VERSION }}-windows-ia32.exe;
           ren DevSidecar-${{ env.BUILD_VERSION }}-arm64.exe DevSidecar-${{ env.BUILD_VERSION }}-windows-arm64.exe;
-          ren DevSidecar-${{ env.BUILD_VERSION }}.exe       DevSidecar-${{ env.BUILD_VERSION }}-windows-universal.exe;
           dir;
       - name: "Rename artifacts - Linux"
         if: ${{ matrix.os == 'ubuntu' }}
@@ -320,13 +319,6 @@ jobs:
           path: packages/gui/dist_electron/DevSidecar-${{ env.BUILD_VERSION }}-windows-arm64.exe
           name: "DevSidecar-${{ env.BUILD_VERSION }}-windows-arm64.exe"
           if-no-files-found: error
-      - name: "Upload DevSidecar-${{ env.BUILD_VERSION }}-windows-universal.exe"
-        uses: actions/upload-artifact@v4.4.0
-        if: ${{ matrix.os == 'windows' }}
-        with:
-          path: packages/gui/dist_electron/DevSidecar-${{ env.BUILD_VERSION }}-windows-universal.exe
-          name: "DevSidecar-${{ env.BUILD_VERSION }}-windows-universal.exe"
-          if-no-files-found: error
       # endregion Upload artifacts - Windows
 
       # region Upload artifacts - Linux
@@ -465,4 +457,4 @@ jobs:
           path: packages/gui/dist_electron/DevSidecar-${{ env.BUILD_VERSION }}-macos-universal.dmg
           name: "DevSidecar-${{ env.BUILD_VERSION }}-macos-universal.dmg"
           if-no-files-found: error
-      # endregion Upload artifacts - macOS
+      # endregion Upload artifacts - macOS

.npmrc

@@ -1,4 +1,5 @@
 shamefully-hoist=true
+phantomjs_cdnurl=https://npmmirror.com/mirrors/phantomjs
 # Native modules (e.g. @parcel/watcher) require C++17.
 # In CI, CXXFLAGS=-std=c++17 (Linux/macOS) and CL=/std:c++17 (Windows) are
 # set before `pnpm install` so node-gyp compiles with the correct standard.

README.md

@@ -182,6 +182,7 @@
 > 1. ~~[hub.fastgit.org](https://hub.fastgit.org/) （2024/11/18：这个好像失效了？）~~
 > 2. ~~[github.com.cnpmjs.org](https://github.com.cnpmjs.org/) 这个很容易超限（2024/11/18：这个好像失效了？）~~
 > 3. [bgithub.xyz](https://bgithub.xyz/)（edge浏览器可能报毒）
+> 4. [kkgithub.com](https://kkgithub.com/)（目前正在维护中）
 
 ## 五、api
 
@@ -375,10 +376,24 @@ npm config delete https-proxy
 
 ### 8.1、准备环境
 
-#### 1）安装 `nodejs`
+#### 1）安装 `nodejs` 及其他环境
 
 推荐安装 nodejs `22.x.x` 的版本，其他版本未做测试
 
+Windows上需要msvc，推荐使用VS 2022（node-gyp对VS 2026支持可能存在问题），安装时选择C++桌面开发工作负载即可。
+
+另外还需要带distutils的python，推荐安装自带setuptools的python 3.11版本。如果本地有uv，则可以简单的运行以下命令
+
+```shell
+uv init .
+uv sync
+.venv/Scripts/activate.ps1 # for windows pwsh
+.venv/Scripts/activate.bat # for windows cmd
+source .venv/bin/activate # for linux/mac
+```
+
+这会根据.python-version文件自动安装python 3.11版本。如不想使用python 3.11，也可删除.python-version文件，pyproject.toml已经指定了所需依赖。
+
 #### 2）安装 `pnpm`
 
 运行如下命令即可安装所需依赖：

package.json

@@ -11,7 +11,7 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^3.16.0",
-    "eslint": "^9.39.4",
+    "eslint": "^10.2.1",
     "eslint-plugin-format": "^0.1.3"
   },
   "pnpm": {

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docmirror/dev-sidecar-cli",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "private": false,
   "description": "给开发者的加速代理工具",
   "author": "docmirror.cn",

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docmirror/dev-sidecar",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "private": false,
   "description": "给开发者的加速代理工具",
   "author": "docmirror.cn",

packages/core/src/config/index.js

@@ -228,7 +228,15 @@ const defaultConfig = {
       },
       'fonts.googleapis.com': {
         '.*': {
-          proxy: 'fonts.loli.net',
+          proxy: 'fonts.googleapis.cn',
+          backup: ['fonts.loli.net'],
+          test: 'https://fonts.googleapis.com/css?family=Oswald',
+        },
+      },
+      'fonts.gstatic.com': {
+        '.*': {
+          proxy: 'fonts-gstatic.proxy.ustclug.org',
+          backup: ['gstatic.loli.net'],
           test: 'https://fonts.googleapis.com/css?family=Oswald',
         },
       },
@@ -241,12 +249,6 @@ const defaultConfig = {
       'themes.googleusercontent.com': {
         '.*': { proxy: 'google-themes.proxy.ustclug.org' },
       },
-      // 'fonts.gstatic.com': {
-      //   '.*': {
-      //     proxy: 'gstatic.loli.net',
-      //     backup: ['fonts-gstatic.proxy.ustclug.org']
-      //   }
-      // },
       'clients*.google.com': { '.*': { abort: false, desc: '设置abort：true可以快速失败，节省时间' } },
       'www.googleapis.com': { '.*': { abort: false, desc: '设置abort：true可以快速失败，节省时间' } },
       'lh*.googleusercontent.com': { '.*': { abort: false, desc: '设置abort：true可以快速失败，节省时间' } },

packages/core/src/modules/plugin/free-eye/README.md

@@ -0,0 +1,74 @@
+# 网络审查检测器
+
+FreeEye 是一个用 JavaScript 编写的网络审查检测器，自动化检测网络环境并推荐可能的规避方法。
+
+为中国大陆用户设计，但也可用于其他地区。
+
+希望使得用户能够使用本工具回答以下问题：
+
+1. 我的网络是被审查了，还是只是出现了异常故障？
+2. 使用了哪些审查手段？
+3. 有哪些规避方法可以绕过这些审查？
+
+## 使用方法
+
+前提条件是你需要在设备上安装 `node.js`。
+
+启动向导的方法：
+
+```bash
+git clone https://github.com/cute-omega/free-eye.git
+cd free-eye
+npm install
+npm start
+```
+
+（如果你不准备进行开发，可以跳过 `npm install`并直接运行 `npm start`；中国大陆用户可能需要设置npm镜像）
+
+不同测试的代码位于 `checkpoints/` 目录中。每个测试都有唯一的 `tag` 标识。单个测试的参数在 `config.json` 文件中设置，使用测试的 tag 作为键：
+
+```json
+{
+  "tag": {
+    // 测试特定的参数
+  }
+  // ...
+}
+```
+
+## 测试
+
+### Route（路由）
+
+通过尝试创建一个套接字并连接到一个非本地地址，检测设备是否具有互联网连通性。
+
+### DNS
+
+使用系统的 DNS 解析器尝试解析允许和被封锁的主机名。测试被封锁主机名是否存在 DNS 缓存投毒。
+
+### TCP
+
+尝试与已知允许和已知被封锁的 IP 地址建立 TCP 连接。
+
+### TLS
+
+尝试与已知允许但可能遭受审查的 IP 地址（例如对中国用户来说的“干净”的外国 IP）完成 TLS 握手。测试内容包括：
+
+- 不带任何 SNI 的握手
+- 带已知允许的 SNI 的握手
+- 带已知被封锁的 SNI 的握手
+
+还测试将 TLS 记录分片作为一种规避方法，通过尝试对被封锁的 SNI 进行握手但分片 ClientHello 来实现。
+
+## 编写你自己的测试
+
+如果你想编写自定义测试，只需实现 `template.js` 中描述的接口，将测试模块保存到 `checkpoints/` 目录，并在 `config.json` 中添加该测试的参数。
+
+## 相关项目
+
+本项目受到来自 [wallpunch/wizard](https://github.com/wallpunch/wizard) 的启发；
+用作 [docmirror/dev-sidecar](https://github.com/docmirror/dev-sidecar) 中的网络检测插件。
+
+---
+
+不论在哪里，人们的目光都应该是自由的。