README

! Last Modified : 
 ! ---------------------------------------------------------- --


  


全平台通用换源工具与框架 chsrc，目标支持 Linux, Windows (native, MSYS2, Cygwin), macOS, BSD, Android 等尽可能多的操作系统环境，龙芯、飞腾、RISC-V 等尽可能多的 CPU。我们使用 C11 来完成上述目标，以保证最大的可用性。本软件为自由软件，SDPX 软件许可证为 GPL-3.0-or-later and MIT






  
  
    
  
  
    
  
  
    
  
  






 ❤️ 致所有的朋友们

2025年8月11日，我因通宵重构本项目代码而被送去抢救（252，突发！换源工具 chsrc 作者在重构过程中被送去 120 抢救）。大家给予的关心和帮助让我非常非常感动！在此，我衷心感谢每一位朋友！无论是开源还是闭源，无论是否为职业程序员，我们其实都是一群使用软件、热心互助、充满友爱的人，这是一个温暖的大家庭。

我为 chsrc 采用 GPL 协议，怀着殷切的期望：希望能够营造像 Richard Stallman 在创建 GNU 项目之前，在 MIT 那样的氛围——写自己用得上的软件，与大家一起开发、维护，简单纯粹，无关商业利益。就像小区、校园自发组建的足球篮球队，从一次偶然的加入，逐渐成长为互相支持的伙伴。

这次经历让我更加深刻地体会到：开源，是一种把大家联系在一起的方式，它让互助和协作成为可能。最后，希望大家能够时刻关注自己的身体，你可以随时 chsrc chown chgrp chmod 无限次，但是无法 chbody！





 🤝 协作与贡献

 [!TIP]
 chsrc 不仅是一个命令行工具，同时也是一个体现了 Ruby on Rails 思想的 MVC 换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法 (recipe)。 配合使用 [rawstr4c], 这将比写 shell 脚本更加轻松。 如何编写 recipe?

---

 [!NOTE]
 这也许是你可以参与的第一个现实世界中有用的C语言项目，用 VS Code 一分钟内上手编译、运行、测试 chsrc

 欢迎对 GitHub、Gitee 协作不熟悉的人以此为契机学习参与贡献, 欢迎任何编程初学者。从开发到提交PR，我们覆盖全流程文档
---

 [!IMPORTANT]
 chsrc 可换源 65+ 菜品。每个人仅仅贡献和维护自己熟悉的部分，回报是得到其他所有领域专家的帮助。 欢迎成为 recipe 维护者





 📌 示例

桌面端:


  




安卓:


  






 🚀 安装


  


 [!IMPORTANT]
 若通过下述手动方式安装，则会下载到当前目录，可直接通过 ./chsrc 运行


Windows

- 可通过 scoop 安装，感谢 [@rocascent] 与 [@niheaven]

bash
scoop install chsrc




- 可通过 WinGet 安装，感谢 [@YU-7] 与 [@Dragon1573]

bash
winget install RubyMetric.chsrc




- 可通过 PowerShell 脚本一键下载最新版二进制文件，感谢 [@wickdynex]

    若下方链接无法访问，可使用 https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.ps1 替代

PowerShell
 使用 -Version 指定版本 (不指定时默认为 pre)
   1. 安装 pre 版本; 这比从包管理器安装的总是更新一些
   2. 安装旧版本; 有时新版本可能引入某些 Bug，临时使用旧版本解决燃眉之急
"& { $(iwr -useb https://chsrc.run/windows) } -Version pre" | iex




- 或手动下载二进制文件，这是最新版，往往比 scoop 提供的更新，适用于修复 Bug、添加新功能后及时使用，以及未安装 scoop 时

bash
 x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windows.exe -o chsrc.exe

 x86
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x86-windows.exe -o chsrc.exe

 Arm64 (WoA, Windows on Arm)
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-arm64-windows.exe -o chsrc.exe







Linux

- 可通过 apt/dpkg 安装，感谢 [@sanchuanhehe]

bash
 x64
$ curl -LO https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc_latest-1_amd64.deb

 也可以使用 Wget
wget https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc_latest-1_amd64.deb

$ sudo apt install ./chsrc_latest-1_amd64.deb
 或
$ sudo sudo dpkg -i chsrc_latest-1_amd64.deb




- 支持 AUR，可通过 yay 安装，感谢 [@Jerry-Terrasse]

bash
 AUR
$ yay -S chsrc-bin  Binary from GitHub Release
$ yay -S chsrc-git  Build  from the latest main branch (stable)
$ yay -S chsrc      Build  from GitHub Release




- 可通过 shell 脚本一键安装最新版，感谢 [@Efterklang] 与 [@wickdynex]

    若下方链接无法访问，可使用 https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.sh 替代

bash
 非root用户默认安装至 ~/.local/bin
$ curl https://chsrc.run/posix | bash

 也可以使用 Wget
$ wget -O - https://