Skip to content

feat: 添加网络代理配置#73

Open
imsyy wants to merge 4 commits into
devfrom
feat/proxy
Open

feat: 添加网络代理配置#73
imsyy wants to merge 4 commits into
devfrom
feat/proxy

Conversation

@imsyy

@imsyy imsyy commented Jul 6, 2026

Copy link
Copy Markdown
Member

改动类型

  • 新功能(feat)
  • 缺陷修复(fix)
  • 重构 / 优化(不改变对外行为)
  • 文档(docs)
  • 其他(请在「改动说明」中注明)

是否包含破坏性变更

  • 是(请在「改动说明」中详细描述)

改动说明

添加网络代理配置功能,支持为应用所有网络请求设置代理:

  1. 支持三种代理模式:

    • 跟随系统(默认):使用操作系统代理设置,与添加功能前的行为一致
    • 关闭代理:直连,不走任何代理
    • 手动代理:支持 HTTP/HTTPS 协议,配置服务器地址和端口
  2. 主要变更:

    • 新增 electron/main/utils/proxy.ts:代理配置转换与应用逻辑
    • 修改 shared/types/settings.ts:添加 NetworkProxySettings 类型
    • 修改 shared/defaults/settings.ts:添加代理配置默认值
    • 修改 src/settings/categories/services.ts:添加代理设置项 UI
    • 修改 electron/main/apis/netease/:网易云 API 请求应用代理配置
    • 修改 electron/preload/:暴露代理测试 IPC
  3. 代理应用范围:

    • Electron 主会话(defaultSession
    • 自定义会话(persist:main
    • 网易云音乐 API 请求

关联 Issue

测试情况

手动测试:

  1. 切换不同代理模式,验证网络请求行为正确
  2. 设置手动代理后测试代理连接性
  3. 验证默认"跟随系统"模式与之前行为一致
  4. 验证设置界面条件显示(手动代理时才显示地址/端口输入框)

截图 / 录屏

无 UI 改动

自查清单

  • 本 PR 只包含一个主要功能 / 修复,没有夹带无关改动
  • 已在本地完整测试通过;AI 生成的代码同样自行测试并审阅过,未做未经验证的提交
  • 已运行 pnpm format,并确认 pnpm typecheckpnpm lint 通过
  • 改动涉及原生模块时已 pnpm build:native 验证;未手写 native/*/index.d.ts
  • 已向 dev 分支提交

Copilot AI review requested due to automatic review settings July 6, 2026 09:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

本 PR 为 SPlayer-Next 增加「网络代理配置」能力,把代理设置接入到主进程会话(defaultSession 与 persist:main)以及网易云 API 请求链路,并提供渲染端的代理连通性测试入口。

Changes:

  • 新增代理配置类型与默认值,并在“服务”设置页加入代理模式/地址/端口/测试按钮。
  • 主进程新增代理配置转换与应用逻辑,启动时与配置变更时应用到 Electron Session。
  • 网易云 API 请求从全局 fetch 切换为 electron.net.fetch 以跟随 Session 代理;新增 system:testNetworkProxy IPC 供 UI 调用。

Reviewed changes

Copilot reviewed 15 out of 16 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
src/types/settings-schema.ts 扩展设置控件类型,新增 text 以支持文本输入项。
src/settings/categories/services.ts 在服务设置中新增代理配置项与“测试代理”动作。
src/i18n/locales/zh-CN.json 增加代理相关中文文案(label/description/选项/测试结果)。
src/i18n/locales/en-US.json 增加代理相关英文文案(label/description/选项/测试结果)。
src/components/settings/SettingsItem.vue SettingsItem 渲染层新增 text 类型控件(SInput)。
shared/types/settings.ts 新增 NetworkProxySettings/NetworkProxyProtocol 并挂到 SystemConfig.system.networkProxy
shared/defaults/settings.ts 增加 networkProxy 默认值(system + host/port)。
electron/preload/index.ts 暴露 window.api.system.testNetworkProxy() 到渲染进程。
electron/preload/index.d.ts testNetworkProxy 补充类型声明。
electron/main/utils/proxy.ts 新增代理配置构建、应用到 Session、连通性测试实现。
electron/main/ipc/system.ts 注册 system:testNetworkProxy IPC handler。
electron/main/ipc/config.ts 配置变更副作用中新增代理配置变更触发应用逻辑。
electron/main/core/index.ts 应用启动流程中加载并应用持久化的代理配置。
electron/main/apis/netease/core/xeapi.ts 网易云 xeapi 公钥请求改用 net.fetch 以应用代理。
electron/main/apis/netease/core/request.ts 网易云核心请求改用 net.fetch 以应用代理。
electron/main/apis/netease/core/ncbl.ts 网易云打卡上传请求改用 net.fetch 以应用代理。

Comment thread src/settings/categories/services.ts Outdated
Comment on lines +9 to +14
const testNetworkProxy = async (): Promise<void> => {
const ok = await window.api.system.testNetworkProxy();
const { t } = i18n.global;
if (ok) toast.success(t("settings.networkProxyTest.success"));
else toast.error(t("settings.networkProxyTest.failed"));
};
Comment thread src/settings/categories/services.ts
Comment on lines +74 to +78
case "system.networkProxy.protocol":
case "system.networkProxy.host":
case "system.networkProxy.port":
void applyNetworkProxy();
break;
Comment thread electron/main/utils/proxy.ts
Copilot AI review requested due to automatic review settings July 6, 2026 09:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 15 out of 16 changed files in this pull request and generated 2 comments.

Comment on lines +135 to +144
<SInput
v-else-if="item.type === 'text'"
:model-value="model"
:placeholder="item.placeholderKey ? t(item.placeholderKey) : ''"
:disabled="isDisabled"
clearable
class="w-full"
@update:model-value="model = $event"
@blur="applyChange(model)"
/>
Comment on lines +40 to +52
export const testNetworkProxy = async (): Promise<boolean> => {
const proxyConfig = buildProxyConfig();
if (proxyConfig.mode === "system") return true;
if (proxyConfig.mode === "direct") return false;
try {
await applyNetworkProxy();
const res = await net.fetch(PROXY_TEST_URL, { signal: AbortSignal.timeout(8000) });
return res.ok;
} catch (err) {
systemLog.warn("[proxy] test failed", err);
return false;
}
};
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants