# MultiRegistrySwitcher

**Repository Path**: WD_MoonMoonBird/multi-registry-switcher

## Basic Information

- **Project Name**: MultiRegistrySwitcher
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="./logo.png" width="128" alt="Multi Registry Switcher Logo" />
</p>

<h1 align="center">Multi Registry Switcher</h1>
<h3 align="center">多注册源切换工具 · 一键管理 npm / yarn / pnpm / Homebrew / Maven 的源</h3>

<p align="center">
  <a href="https://gitee.com/WD_MoonMoonBird/multi-registry-switcher"><img src="https://img.shields.io/badge/Gitee-多注册源切换工具-c71d23?logo=gitee" alt="Gitee" /></a>
  <img src="https://img.shields.io/badge/Tauri-2.x-FFC131?logo=tauri&logoColor=white" alt="Tauri 2" />
  <img src="https://img.shields.io/badge/React-19-149ECA?logo=react" alt="React 19" />
  <img src="https://img.shields.io/badge/Rust-2021-DEA584?logo=rust&logoColor=black" alt="Rust" />
  <img src="https://img.shields.io/badge/license-MIT-green" alt="License" />
</p>

---

## 项目简介

**Multi Registry Switcher** 是一个跨平台桌面应用，帮助你在不同项目之间快速切换多种包管理器与开发工具的注册源（registry / mirror）。所有切换都是**当前用户级**生效（非全局、不污染系统），切换过程可一键回滚。

适合在国内网络环境开发、又经常需要回到官方源调试的开发者。

## 核心特性

- 🪟 **一键切换**：从内置列表选源，一键写入对应配置文件并立即生效。
- ↩️ **一键回滚**：所有切换会备份原配置，切错随时还原。
- ⚡ **测速**：内置 TCP 测速，自动推荐当前最快的源。
- 🧩 **自定义源**：任意添加 / 编辑 / 删除自定义镜像地址。
- 🌗 **主题与多语言**：内置中英文 + 浅色 / 深色 / 跟随系统。
- 💻 **跨平台**：macOS（arm64）+ Windows（x64）原生应用，基于 Tauri 2 + React 19。

## 支持的注册源

| 包管理器 | 检测方式 | 配置文件 |
|----------|----------|----------|
| npm | `~/.npmrc` | registry |
| yarn (v1) | `~/.yarnrc` | registry |
| pnpm | `~/.pnpmrc` | registry |
| Homebrew | Homebrew 环境变量 | api.brew.sh mirror |
| Maven | `~/.m2/settings.xml` | mirror |

## 安装

> 最新版本：**v0.1.0**

<table>
<tr>
<th>平台</th>
<th>下载</th>
<th>架构</th>
</tr>
<tr>
<td>🍎 macOS</td>
<td><a href="https://deadpan.asia/mrs/downloads/mrs-0.1.0-mac-arm64.dmg">mrs-0.1.0-mac-arm64.dmg</a></td>
<td>Apple Silicon (arm64)</td>
</tr>
<tr>
<td>🪟 Windows</td>
<td><a href="https://deadpan.asia/mrs/downloads/mrs-0.1.0-win-x64-setup.exe">mrs-0.1.0-win-x64-setup.exe</a></td>
<td>x64 (NSIS 安装器)</td>
</tr>
</table>

官方站点：[https://deadpan.asia/mrs/](https://deadpan.asia/mrs/)

> ⚠️ 安装包目前为 **ad-hoc 签名**，首次打开会有系统拦截：
> - **macOS**：右键「打开」或 `xattr -dr com.apple.quarantine "/Applications/Multi Registry Switcher.app"`
> - **Windows**：SmartScreen 提示「更多信息」→「仍要运行」

## 截图

> 截图待补：Dashboard / Manager / SpeedTest / Profile / Settings

<details>
<summary>📸 查看 UI 设计</summary>

可参考官方站点交互演示：[https://deadpan.asia/mrs/](https://deadpan.asia/mrs/) 的右侧实时预览。

</details>

## 技术栈

- **桌面框架**：[Tauri 2](https://tauri.app/) —— Rust 后端 + Web 前端，单二进制小体积
- **前端**：React 19 + TypeScript + Vite + Tailwind CSS + Zustand + Framer Motion
- **后端**：Rust 2021 edition，命令执行走 `tokio::process`（macOS GUI 启动时自动扩展 PATH）
- **国际化**：内置中英双语切换

## 开发

### 环境要求

- Node.js ≥ 22
- pnpm ≥ 9
- Rust ≥ 1.77（含 `cargo-tauri` CLI：`cargo install tauri-cli --version "^2.0"`）
- macOS：Xcode Command Line Tools
- Windows：WebView2 Runtime + MSVC Build Tools

### 拉取与运行

```bash
git clone https://gitee.com/WD_MoonMoonBird/multi-registry-switcher.git
cd multi-registry-switcher
pnpm install
pnpm tauri dev          # 启动开发模式（热更新）
```

### 构建发布版

```bash
# macOS（产出 .app，需手动 hdiutil 打 DMG，见 docs）
pnpm tauri build

# Windows（在 macOS 上交叉编译，需无空格 CARGO_TARGET_DIR）
CARGO_TARGET_DIR=/path/no-spaces/mrs-target \
  pnpm tauri build --target x86_64-pc-windows-gnu --bundles nsis
```

## 路线图

- [ ] Intel macOS 安装包
- [ ] 开发者证书签名（消除 Gatekeeper / SmartScreen 警告）
- [ ] Linux 支持
- [ ] 更多包管理器（pip / cargo / gem）

## 贡献

欢迎 Issue 和 PR！开发约定见源码内各模块注释（`crate::utils`、`src/website/*` 等）。

## 许可证

[MIT](./LICENSE)

## 相关链接

- 🌐 官方网站：[https://deadpan.asia/mrs/](https://deadpan.asia/mrs/)
- 📦 Gitee 仓库：https://gitee.com/WD_MoonMoonBird/multi-registry-switcher