CI deprecated `macos-13`

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 6 to 7.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

.editorconfig

@@ -1,4 +1,17 @@
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# Config Type   : EditorConfig
+# Config Authors: 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nil Null <nil@null.org>
+# Created On    : <2023-09-06>
+# Last Modified : <2025-08-27>
+#
+# 请参考 ./doc/03-为什么拒绝使用代码格式化工具.md
+#
 # http://editorconfig.org
+# --------------------------------------------------------------
+
 root = true
 
 [*]
@@ -6,14 +19,34 @@ indent_style = space
 indent_size = 2
 charset = utf-8
 trim_trailing_whitespace = true
-insert_final_newline = false
+
+# VS Code 对该配置(为 false)的实现有问题，这是确定的，
+# 然而 CLion 似乎对该配置(为 false)的实现是正确的，这导致不同贡献者反而产生了冲突
+# 所以我们现在改成 true
+insert_final_newline = true
 
 [*.{c,C,cpp,cxx,cc,h,hpp}]
 indent_style = space
 indent_size = 2
 
+[*.pl]
+indent_size = 4
+
+[*.{raku,rakumod,rakutest}]
+indent_size = 2
+
+[*.ps1]
+indent_size = 4
+
+[*.{sh,bash}]
+indent_size = 2
+
 [Makefile,makefile,*.{mk,make,makefile}]
 indent_style = tab
 
-[*.md]
-trim_trailing_whitespace = true
+# 使用 VS Code 生成文件的默认格式
+[*.json]
+indent_size = 4
+
+[*.{yaml,yml}]
+indent_size = 2

.github/FUNDING.yml

@@ -1 +1,4 @@
-custom: ['https://github.com/ccmywish/support-my-oss-work']
+custom: [
+  'https://afdian.com/a/ccmywish',
+  'https://github.com/ccmywish/support-my-oss-work'
+]

.github/ISSUE_TEMPLATE/01-Report_Bug.yml

@@ -1,13 +1,17 @@
-name: 🐞Bug 报告
+name: 🐞 Bug 报告
 description: 有 Bug 了吗?
-title: "[Bug] "
-labels: []
+title: "详细报告BUG是chsrc用户的一大美德"
+# labels: [ ]
+type: Bug
 body:
-
   - type: markdown
     attributes:
       value: |
-        感谢您花时间填写此 Bug 报告!
+        感谢花时间填写此 Bug 报告!
+
+        1. 你可能是通过包管理器安装的 `chsrc`，其版本往往稍旧，你可先尝试使用REAME中提供的安装命令来获取最新版本
+
+        2. 有时 Bug 是在最新版本中引入的，此时你可在安装命令时指定 `-v` 参数临时使用旧版本解决燃眉之急，详情查看README
 
   - type: textarea
     id: what-did-you-do
@@ -41,7 +45,7 @@ body:
     attributes:
       label: chsrc 版本
       # description: 你正在使用 chsrc 哪个版本？
-      placeholder: 请使用 chsrc -h 查看第一行*带有日期*的精确版本
+      placeholder: 请使用 chsrc -h 或 chsrc -v 查看，并*复制发布日期*
     validations:
       required: true
 
@@ -81,7 +85,7 @@ body:
     id: terms
     attributes:
       label: 防止重复问题
-      description: 您确认在打开这个新的 issue 之前已经搜索过类似的issue。您可以评论或订阅已经存在的相关 issue
+      description: 请确认在打开这个新的 issue 之前已经搜索过类似的issue。你可以评论或订阅已经存在的相关 issue
       options:
-        - label: 我已在项目的 GitHub 和 Gitee 两个仓库分别搜索过类似的 issue
+        - label: 我已在项目中搜索过类似的 issue
           required: true

.github/ISSUE_TEMPLATE/02-Request_Recipe.yml

@@ -1,7 +1,8 @@
-name: 🫸我想要对 target 换源!
+name: 🫡 我想要对 target 换源!
 description: 想要对尚未支持的 target 进行换源？
-title: "[New Target] "
-labels: []
+title: "提前找好方案怎么换源是chsrc用户的一大美德"
+# labels: [ ]
+type: Request
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/03-Share.yml

@@ -1,7 +1,8 @@
-name: 🎉隔壁新开了个镜像站！
-description: 告诉我们哪里开了个新镜像站！
-title: "[New Mirror] "
-labels: ['镜像站']
+name: 🎉 我找到了新的镜像站或源！
+description: 为大家分享新的镜像站或可用源！
+title: "分享是chsrc用户的一大美德"
+# labels: [ ]
+type: Contribute
 body:
   - type: markdown
     attributes:
@@ -11,7 +12,7 @@ body:
   - type: textarea
     id: description
     attributes:
-      label: 描述新的镜像站
+      label: 描述该镜像站或该源
       description: |
         1. 请告诉我们该镜像站的主体URL
         2. 你是否已经测试过该镜像站的可用性？

.github/ISSUE_TEMPLATE/03-Source_Share.yml

@@ -1,19 +0,0 @@
-name: 😋我找到了新的可用源！
-description: 为大家分享新的可用源！
-title: "[New Source] "
-labels: ['源']
-body:
-  - type: markdown
-    attributes:
-      value: |
-        感谢你的分享！这将使你与更广大的用户得到更多可选的服务！
-
-  - type: textarea
-    id: description
-    attributes:
-      label: 描述该源
-      description: |
-        1. 请告诉我们提供该源的镜像站的主体URL
-        2. 你是否已经测试过该源的可用性？
-    validations:
-      required: true

.github/ISSUE_TEMPLATE/04-Deprecate.yml

@@ -0,0 +1,20 @@
+name: ⛓️‍💥 镜像源已失效
+description: 该镜像站已关停/该源已不再被支持
+title: "报告镜像源情况是chsrc用户的一大美德"
+# labels: [ ]
+type: Deprecate
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢你的一手消息！让用户不再疑惑是哪里出了错！
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 什么被弃用了？
+      description: |
+        1. 请告诉我们是镜像站还是某个源失效
+        2. 如果可能，你可以开启该issue后参与维护！在代码中删除掉该源并不复杂！
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,6 @@
 blank_issues_enabled: true
 contact_links:
-  - name: ❤️ 感谢 chsrc
-    url: https://github.com/RubyMetric/chsrc/discussions/categories/%E6%84%9F%E8%B0%A2-chsrc
-    about: chsrc 是否帮助到了你？
-  - name: 🚀 赞赏支持 chsrc
-    url: https://github.com/ccmywish/support-my-oss-work
-    about: 通过经济支持帮助作者更好的开发和维护 chsrc
+  - name: ❤️ 赞赏支持 chsrc
+    url: https://afdian.com/a/ccmywish
+    # about 不支持 Markdown 语法
+    about: 你是否因为 chsrc 而受到启发、节省了时间精力 or whatever?

.github/PULL_REQUEST_TEMPLATE/Add_Feature.md

@@ -0,0 +1,15 @@
+## 新功能描述
+
+请描述该新功能，为什么要增加这个功能，以及具体的用例
+
+---
+
+## 方案
+
+请介绍你新增加该功能的方案
+
+---
+
+## 实现
+
+请介绍你的实现（若实现相当直接则不需要描述）

.github/PULL_REQUEST_TEMPLATE/Clean.md

@@ -0,0 +1,17 @@
+## 描述
+
+注意: 小改动请使用该PR模板。而中等、大型规模的变化，或者引起巨大联动变化的改动，需要使用 `Refactor` PR模板。
+
+请介绍你进行了什么清理，如某部分代码，如某部分文档
+
+---
+
+## 方案
+
+请介绍你进行清理的方案（如果你认为有必要的话）
+
+---
+
+## 实现
+
+请介绍你的实现（若实现相当直接则不需要描述）

.github/PULL_REQUEST_TEMPLATE/Enhance.md

@@ -0,0 +1,15 @@
+## 改进描述
+
+请描述要改进的具体内容，为什么要增强/改善它，以及具体的用例
+
+---
+
+## 方案
+
+请介绍你的改进方案
+
+---
+
+## 实现
+
+请介绍你的实现（若实现相当直接则不需要描述）

.github/PULL_REQUEST_TEMPLATE/Fix_Bug.md

@@ -0,0 +1,21 @@
+## Bug 背景
+
+请介绍 Bug 的背景以及相关 issue
+
+---
+
+## Bug 原因
+
+请描述导致 Bug 的具体原因
+
+---
+
+## 方案
+
+请介绍你的修复方案
+
+---
+
+## 实现
+
+请介绍你的实现（若实现相当直接则不需要描述）

.github/PULL_REQUEST_TEMPLATE/Implement.md

@@ -0,0 +1,48 @@
+## 问题描述
+
+(此内容必填)
+
+1. 简要说明此 PR 修复的具体问题或改进的功能背景
+2. 列出与此 PR 相关的 issue 或任务，若没有填 `N/A`
+
+<br>
+
+
+
+## 方案
+
+(此内容必填)
+
+详细描述针对该问题或功能改进的解决方案
+
+<br>
+
+
+
+## 实现
+
+(此内容可选填)
+
+在按照上述方案实现时，若遇到需记录和提醒他人的细节时，务必在此描述
+
+<br>
+
+
+
+## 测试
+
+(此内容可选填)
+
+描述如何验证本 PR，列出具体的测试步骤
+
+<br>
+
+
+
+## 备注
+
+(此内容可选填)
+
+列出需要特别注意或额外注意的事项
+
+<br>

.github/PULL_REQUEST_TEMPLATE/Refactor.md

@@ -0,0 +1,17 @@
+## 背景
+
+注意: 中等、大型规模的变化，或者引起巨大联动变化的改动，才需要使用该模板。中小改动请使用 `Clean` PR模板。
+
+请介绍该重构的背景，可以带来哪些优势？
+
+---
+
+## 方案
+
+请介绍你进行重构的方案
+
+---
+
+## 实现
+
+请介绍你的实现（若实现相当直接则不需要描述）

.github/PULL_REQUEST_TEMPLATE/Relate_Mirror_Source.md

@@ -0,0 +1,7 @@
+## 可用性确认
+
+1. 请你本人确认这些源真的可用或已经失效，不要等待其它用户帮你测试
+
+2. 请确保修改后代码依然可以编译及运行
+
+3. 请在你修改的各个文件的标头部分增加你自己的贡献信息，名字栏需要为中文拼音、或者英文名、或者账号名

.github/READIT.md

@@ -0,0 +1,15 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : (Overview .github) READIT.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2025-06-20>
+ ! Last Modified : <2025-06-20>
+ !
+ ! 此文件不能叫做 README.md，否则 GitHub 主页会显示此文件
+ ! ---------------------------------------------------------- -->
+
+[`pull_request_template.md`](./pull_request_template.md) 是 [`PULL_REQUEST_TEMPLATE/Implement.md`](./PULL_REQUEST_TEMPLATE/Implement.md) 的最简化版

.github/copilot-instructions.md

@@ -0,0 +1,32 @@
+# chsrc Project Rules for AI Assistants
+
+## 项目概述
+
+这是 chsrc 项目，一个用 C 语言编写的跨平台命令行换源工具，帮助用户在不同的镜像之间切换，适用于编程语言、操作系统、其他软件。它的最强大之处在于它是一个框架，能够帮助用户轻松地为不同的目标换源。
+
+
+## 架构
+
+- **Framework**: 在目录 `src/framework/` 中，包含了核心实现，支持 recipe
+
+  - `struct.h` 里定义了各种数据结构和宏，这是整个 chsrc 的核心，也是 chef DSL 的核心
+  - `chef.c` 里实现了 chef DSL，你可以使用它来确定正确的使用方法
+
+- **Recipes**: 在目录 `src/recipe/` 中，包含了针对不同目标的具体实现
+
+  - `lang/` - 编程语言 (Ruby, JavaScript 等等)
+  - `os/`   - 操作系统 (Ubuntu, Arch Linux 等等)
+  - `ware/` - 软件工具和应用 (Docker, Homebrew 等等)
+
+
+## Coding Guidelines
+
+### C Coding Style:
+
+请阅读 `doc/03-为什么拒绝使用代码格式化工具.md`
+
+### Important Project Concepts:
+
+请阅读 `doc/10-如何编写recipe.md`
+
+## Important: 一定要保持注释，因为它记录了重要的维护信息

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

.github/pull_request_template.md

@@ -0,0 +1,14 @@
+## 问题描述
+
+1. 简要说明此 PR 修复的具体问题或改进的功能背景
+2. 列出与此 PR 相关的 issue 或任务，若没有填 `N/A`
+
+<br>
+
+
+
+## 方案与实现
+
+详细描述针对该问题或功能改进的解决方案
+
+<br>

.github/workflows/PR-notify.yml

@@ -0,0 +1,62 @@
+# ---------------------------------------------------------------
+# Workflow File : PR-notify.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2025-06-19>
+# Last Modified : <2025-08-07>
+#
+# Notify PR
+# ---------------------------------------------------------------
+
+name: 告知PR者
+
+on:
+  pull_request_target:
+    types: [opened,
+            ready_for_review, # draft PR 转为正式 PR
+            review_requested,
+            reopened]
+
+jobs:
+  enforce-dev-branch:
+    name: 强制使用dev分支
+    runs-on: ubuntu-latest
+    # github.event.pull_request_target 内容为空，转而用 pull_request
+    if: github.event.pull_request.base.ref != 'dev'
+    steps:
+      - name: 评论
+        uses: thollander/actions-comment-pull-request@v3
+        with:
+          message: |
+            Hi @${{github.event.pull_request.user.login}},
+
+            ❤️ 感谢你的贡献！你的 PR 当前基于 `${{github.base_ref}}` 分支，请修改使用 `dev` 分支
+          comment-tag: "❤️ 感谢你的贡献！"
+      - run: |
+          echo "::error::❌ PR 必须以 dev 分支为目标！当前是 ${GITHUB_BASE_REF}"
+          exit 1
+
+  welcome:
+    name: 欢迎PR者
+    runs-on: ubuntu-latest
+    # 仅在 opened 时欢迎，其他情况都不再重复欢迎了
+    if: github.event.pull_request.base.ref == 'dev' && github.event.action == 'opened'
+    steps:
+      - name: 查看 GitHub Actions 环境
+        run: |
+          echo "Event 类型: ${{ github.event.action }}"
+          echo "Event 名: ${{ github.event_name }}"
+
+      # 2025-10-06 移除点赞的步骤
+      # 因原 peter-evans/create-or-update-comment@v5 已不再支持空body，而如果使用 Github Token 之类又过于大材小用因此移除
+
+      - name: 添加评论欢迎 PRer
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          body: |
+            Hi @${{github.event.pull_request.user.login}}
+
+            ❤️ 感谢你的贡献！我们将在最少半小时，最多5天内阅读此 PR 并回复你
+          edit-mode: replace

.github/workflows/PR-test.yml

@@ -0,0 +1,72 @@
+# ---------------------------------------------------------------
+# Workflow File : PR-test.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Mikachu2333 <mikachu2333@zohomail.com>
+#               |
+# Created On    : <2025-06-19>
+# Last Modified : <2025-08-17>
+#
+# Test PR
+# ---------------------------------------------------------------
+
+name: 测试PR
+
+on:
+  pull_request:
+    # 仅在开 pr、草稿转正式、手动要求 review、reopen的时候运行测试
+    types: [
+        opened,
+        # 因 synchronize 将导致 pr 的构建过于频繁而禁用
+        # synchronize, # 在 pr 者 push commit 时每次构建
+        ready_for_review, # draft PR 转为正式 PR
+        review_requested,
+        reopened,
+      ]
+    paths:
+      - "src/**"
+      - "lib/**"
+
+jobs:
+  test-on-ubuntu:
+    name: 在Ubuntu上测试
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.base.ref == 'dev'
+
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v6
+
+      - name: 测试构建情况
+        run: |
+          make
+
+      - name: 测试test情况
+        run: |
+          make test
+
+  test-on-windows:
+    name: 在Windows上测试
+    runs-on: windows-latest
+    if: github.event.pull_request.base.ref == 'dev'
+
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v6
+
+      - name: 创建测试文件
+        shell: powershell
+        run: |
+          New-Item -Path "$env:USERPROFILE\Documents\Powershell\Microsoft.PowerShell_profile.ps1" -ItemType File -Force
+          New-Item -Path "$env:USERPROFILE\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1" -ItemType File -Force
+
+      - name: 安装依赖
+        run: |
+          choco install just
+
+      - name: 测试构建情况
+        run: |
+          just
+
+      - name: 测试test情况
+        run: |
+          just test

.github/workflows/build-on-Linux-AArch64.yml

@@ -0,0 +1,47 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-Linux-AArch64.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-14>
+# Last Modified : <2025-09-12>
+#
+# Build chsrc on Linux (AArch64) and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 Linux AArch64
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 构建
+        uses: uraimo/run-on-arch-action@v3
+        with:
+          arch: aarch64
+          distro: ubuntu_latest
+
+          dockerRunArgs: |
+            --volume "${PWD}/artifacts:/artifacts"
+          run: |
+            apt-get update -qq
+            apt-get install build-essential -y -q
+            apt-get install git -y -q
+            pwd ; ls -al
+            git clone https://github.com/RubyMetric/chsrc -b gh-build -q
+            cd chsrc
+
+            make build-in-ci-release-mode
+            mv chsrc-ci-release chsrc-aarch64-linux
+
+            cp ./chsrc-aarch64-linux /artifacts
+
+      - name: 上传至 'pre' release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: pre
+          files: |
+            ./artifacts/chsrc-aarch64-linux

.github/workflows/build-on-Linux-ARMv7.yml

@@ -0,0 +1,47 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-Linux-ARMv7.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-14>
+# Last Modified : <2025-09-12>
+#
+# Build chsrc on Linux (ARMv7) and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 Linux ARMv7
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 构建
+        uses: uraimo/run-on-arch-action@v3
+        with:
+          arch: armv7
+          distro: ubuntu_latest
+
+          dockerRunArgs: |
+            --volume "${PWD}/artifacts:/artifacts"
+          run: |
+            apt-get update -qq
+            apt-get install build-essential -y -q
+            apt-get install git -y -q
+            pwd ; ls -al
+            git clone https://github.com/RubyMetric/chsrc -b gh-build -q
+            cd chsrc
+
+            make build-in-ci-release-mode
+            mv chsrc-ci-release chsrc-armv7-linux
+
+            cp ./chsrc-armv7-linux /artifacts
+
+      - name: 上传至 'pre' release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: pre
+          files: |
+            ./artifacts/chsrc-armv7-linux

.github/workflows/build-on-Linux-riscv64.yml

@@ -0,0 +1,47 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-Linux-riscv64.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-14>
+# Last Modified : <2025-09-12>
+#
+# Build chsrc on Linux (riscv64) and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 Linux riscv64
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 构建
+        uses: uraimo/run-on-arch-action@v3
+        with:
+          arch: riscv64
+          distro: ubuntu_latest
+
+          dockerRunArgs: |
+            --volume "${PWD}/artifacts:/artifacts"
+          run: |
+            apt-get update -qq
+            apt-get install build-essential -y -q
+            apt-get install git -y -q
+            pwd ; ls -al
+            git clone https://github.com/RubyMetric/chsrc -b gh-build -q
+            cd chsrc
+
+            make build-in-ci-release-mode
+            mv chsrc-ci-release chsrc-riscv64-linux
+
+            cp ./chsrc-riscv64-linux /artifacts
+
+      - name: 上传至 'pre' release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: pre
+          files: |
+            ./artifacts/chsrc-riscv64-linux

.github/workflows/build-on-Linux-x64.yml

@@ -0,0 +1,39 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-Linux-x64.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-14>
+# Last Modified : <2025-09-12>
+#
+# Build chsrc on Linux (x64) and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 Linux x64
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v6
+
+    - name: 构建
+      run: |
+        make build-in-ci-release-mode
+        mv chsrc-ci-release chsrc-x64-linux
+
+    - name: List files
+      run: ls *-linux
+
+    - name: 上传至 'pre' release
+      uses: softprops/action-gh-release@v2
+      # if: startsWith(github.ref, 'refs/tags/')
+      with:
+        tag_name: pre
+        files: |
+          chsrc-x64-linux

.github/workflows/build-on-Windows.yml

@@ -0,0 +1,80 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-Windows.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-14>
+# Last Modified : <2025-09-12>
+#
+# Build chsrc on Windows and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 Windows
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  build-and-upload:
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: msys2 {0}
+
+    steps:
+
+    - name: 检出代码
+      uses: actions/checkout@v6
+
+    - name: 安装 GCC
+      uses: msys2/setup-msys2@v2
+      with:
+        msystem: UCRT64
+        update: true
+        install: |
+          mingw-w64-ucrt-x86_64-gcc
+          mingw-w64-ucrt-x86_64-make
+          mingw-w64-i686-gcc
+          mingw-w64-i686-make
+
+    - name: 为 x64 构建
+      run: |
+        mingw32-make.exe build-in-ci-release-mode
+        mv chsrc-ci-release.exe chsrc-x64-windows.exe
+
+    - name: 为 x32 构建
+      env:
+        MSYSTEM: MINGW32
+      run: |
+        mingw32-make.exe build-in-ci-release-mode
+        mv chsrc-ci-release.exe chsrc-x86-windows.exe
+
+    - name: 为 Android 构建
+      run: |
+        compiler=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/windows-x86_64/bin/aarch64-linux-android21-clang
+
+        # 检查编译器版本
+        $compiler --version
+        echo
+
+        mingw32-make.exe build-in-ci-release-mode CC=$compiler CROSS_BUILD_WINDOWS_FOR_ANDROID=1
+        echo
+
+        # 让我们看看里面有啥
+        ls
+        echo
+
+        mv chsrc-ci-release chsrc-arm64-android
+
+    - name: List files
+      run: ls *.exe
+
+    - name: 上传至 'pre' release
+      uses: softprops/action-gh-release@v2
+      # if: startsWith(github.ref, 'refs/tags/')
+      with:
+        tag_name: pre
+        files: |
+          chsrc-x64-windows.exe
+          chsrc-x86-windows.exe
+          chsrc-arm64-android

.github/workflows/build-on-macOS.yml

@@ -0,0 +1,81 @@
+# ---------------------------------------------------------------
+# Workflow File : build-on-macOS.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2023-09-15>
+# Last Modified : <2025-12-18>
+#
+# Build chsrc on macOS and upload it to GitHub: the 'pre' release
+# ---------------------------------------------------------------
+
+name: 构建于 macOS
+on:
+  push:
+    branches: [ "gh-build" ]
+
+jobs:
+  on-arm64:
+    runs-on: macos-latest
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v6
+
+    - name: 检查编译器版本
+      run: |
+        clang --version
+        echo
+        gcc --version
+        echo
+        gcc-14 --version
+
+    - name: 为 arm64 (AArch64) 构建
+      run: |
+        make build-in-ci-release-mode
+        mv chsrc-ci-release chsrc-aarch64-macos
+
+    - name: List files
+      run: ls *-macos
+
+    - name: 上传至 'pre' release
+      uses: softprops/action-gh-release@v2
+      # if: startsWith(github.ref, 'refs/tags/')
+      with:
+        tag_name: pre
+        files: |
+          chsrc-aarch64-macos
+
+
+  on-x64:
+    # macos-13 是 x64，macos-14 是 AArch64(ARMv8-A)
+    # 但是 macos-13 已经于 2025-12-04 下线
+    runs-on: macos-15-intel
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v6
+
+    - name: 检查编译器版本
+      run: |
+        clang --version
+        echo
+        gcc --version
+        echo
+        gcc-14 --version
+
+    - name: 为 x64 构建
+      run: |
+        make build-in-ci-release-mode
+        mv chsrc-ci-release chsrc-x64-macos
+
+    - name: List files
+      run: ls *-macos
+
+    - name: 上传至 'pre' release
+      uses: softprops/action-gh-release@v2
+      # if: startsWith(github.ref, 'refs/tags/')
+      with:
+        tag_name: pre
+        files: |
+          chsrc-x64-macos

.github/workflows/linux-aarch64.yml

@@ -1,36 +0,0 @@
-name: Linux AArch64 Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  aarch64-linux-build-and-upload:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Build aarch64
-        uses: uraimo/run-on-arch-action@v2
-        with:
-          arch: aarch64
-          distro: ubuntu_latest
-
-          dockerRunArgs: |
-            --volume "${PWD}/artifacts:/artifacts"
-          run: |
-            apt-get update -qq
-            apt-get install build-essential -y -q
-            apt-get install git -y -q
-            pwd ; ls -al
-            git clone https://github.com/RubyMetric/chsrc -b gh-pipeline -q
-            cd chsrc
-            make CI CI_Build_Name=chsrc-aarch64-linux
-            cp ./chsrc-aarch64-linux /artifacts
-
-      - name: Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: pre
-          files: |
-            ./artifacts/chsrc-aarch64-linux
-          token: ${{ secrets.CHSRC_UPLOAD }}

.github/workflows/linux-armv7.yml

@@ -1,37 +0,0 @@
-name: Linux ARMv7 Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  armv7-linu-build-and-upload:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Build ARMv7
-        uses: uraimo/run-on-arch-action@v2
-        with:
-          arch: armv7
-          distro: ubuntu_latest
-
-          dockerRunArgs: |
-            --volume "${PWD}/artifacts:/artifacts"
-          run: |
-            apt-get update -qq
-            apt-get install build-essential -y -q
-            apt-get install git -y -q
-            pwd ; ls -al
-            git clone https://github.com/RubyMetric/chsrc -b gh-pipeline -q
-            cd chsrc
-            make CI CI_Build_Name=chsrc-armv7-linux
-            cp ./chsrc-armv7-linux /artifacts
-
-      - name: Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: pre
-          files: |
-            ./artifacts/chsrc-armv7-linux
-          token: ${{ secrets.CHSRC_UPLOAD }}
-

.github/workflows/linux-riscv64.yml

@@ -1,36 +0,0 @@
-name: Linux riscv64 Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  riscv64-linux-build-and-upload:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Build riscv64
-        uses: uraimo/run-on-arch-action@v2
-        with:
-          arch: riscv64
-          distro: ubuntu_latest
-
-          dockerRunArgs: |
-            --volume "${PWD}/artifacts:/artifacts"
-          run: |
-            apt-get update -qq
-            apt-get install build-essential -y -q
-            apt-get install git -y -q
-            pwd ; ls -al
-            git clone https://github.com/RubyMetric/chsrc -b gh-pipeline -q
-            cd chsrc
-            make CI CI_Build_Name=chsrc-riscv64-linux
-            cp ./chsrc-riscv64-linux /artifacts
-
-      - name: Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: pre
-          files: |
-            ./artifacts/chsrc-riscv64-linux
-          token: ${{ secrets.CHSRC_UPLOAD }}

.github/workflows/linux-x64.yml

@@ -1,30 +0,0 @@
-name: Linux x64 Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  x64-linux-build-and-upload:
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repo
-      uses: actions/checkout@v3
-
-    - name: Compile chsrc x64
-      run: |
-        make CI CI_Build_Name=chsrc-x64-linux
-
-    - name: List files
-      run: ls *-linux
-
-    - name: Release
-      uses: softprops/action-gh-release@v1
-      # if: startsWith(github.ref, 'refs/tags/')
-      with:
-        tag_name: pre
-        files: |
-          chsrc-x64-linux
-        token: ${{ secrets.CHSRC_UPLOAD }}

.github/workflows/macos.yml

@@ -1,54 +0,0 @@
-name: macOS Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  build-and-upload-on-M1:
-    runs-on: macos-latest
-
-    steps:
-    - name: Checkout repo
-      uses: actions/checkout@v3
-
-    - name: Compile chsrc for AArch64
-      run: |
-        make CI CI_Build_Name=chsrc-aarch64-macos
-
-    - name: List files
-      run: ls *-macos
-
-    - name: Release
-      uses: softprops/action-gh-release@v1
-      # if: startsWith(github.ref, 'refs/tags/')
-      with:
-        tag_name: pre
-        files: |
-          chsrc-aarch64-macos
-        token: ${{ secrets.CHSRC_UPLOAD }}
-
-
-  build-and-upload-on-x64:
-    runs-on: macos-13 # macos-14 is AArch64(ARMv8-A)
-
-    steps:
-    - name: Checkout repo
-      uses: actions/checkout@v3
-
-    - name: Compile chsrc for x64
-      run: |
-        make CI CI_Build_Name=chsrc-x64-macos
-
-    - name: List files
-      run: ls *-macos
-
-    - name: Release
-      uses: softprops/action-gh-release@v1
-      # if: startsWith(github.ref, 'refs/tags/')
-      with:
-        tag_name: pre
-        files: |
-          chsrc-x64-macos
-        token: ${{ secrets.CHSRC_UPLOAD }}

.github/workflows/pkg-deb.yml

@@ -0,0 +1,179 @@
+# ---------------------------------------------------------------
+# Workflow File : pkg-deb.yml
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+# Contributors  : 曾奥然 <ccmywish@qq.com>
+#               |
+# Created On    : <2025-06-10>
+# Last Modified : <2025-10-29>
+#
+# Build and publish deb packages
+# ---------------------------------------------------------------
+
+name: 构建发布deb包
+
+on:
+  release:
+    types: [ released ]
+  push:
+    branches: [ "gh-build" ]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to build'
+        required: true
+        default: '0.3.0'  # 短暂时间内不可达到的最新版本号
+
+jobs:
+  Build-deb:
+    name: 构建deb包
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v6
+      with:
+        ref: gh-build
+
+    - name: 获取版本号
+      id: get_version
+      run: |
+        if [ "${{ github.event_name }}" = "release" ]; then
+          version="${{ github.event.release.tag_name }}"
+          # 删除前缀 'v' if present
+          version=${version#v}
+
+        elif [ "${{ github.event_name }}" = "push" ];then
+          # 从源代码中提取版本号
+          version=$(sed -E -n 's/^#define Chsrc_Version +"([0-9]+\.[0-9]+\.[0-9]+).*"/\1/p' ./src/framework/version.h)
+
+        else
+          version="${{ github.event.inputs.version }}"
+        fi
+
+        echo "version=$version" >> $GITHUB_OUTPUT
+        echo "Version: $version"
+
+    - name: 验证版本号
+      run: |
+        version="${{ steps.get_version.outputs.version }}"
+
+        if [[ ! $version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+          echo "Invalid version format: $version"
+          exit 1
+        fi
+
+    - name: 更新 debian/changelog
+      run: |
+        version="${{ steps.get_version.outputs.version }}"
+
+        cd ./pkg/deb
+
+        (cat << EOF; cat ./debian/changelog) > new_changelog
+        chsrc ($version-1) unstable; urgency=medium
+
+          * Release version $version
+
+         -- 曾奥然 <ccmywish@qq.com>  $(date -R)
+
+        EOF
+
+        mv -f new_changelog ./debian/changelog
+
+    - name: 安装构建依赖
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y debhelper devscripts build-essential fakeroot
+
+    - name: 构建
+      run: |
+        make build-deb
+
+    - name: 移动构建产物到./dist和./dist-for-pre
+      run: |
+        version="${{ steps.get_version.outputs.version }}"
+
+        # 创建两个目录来存放构建产物（产物内容一样，只是文件名不一样）
+        mkdir dist dist-for-pre
+        find ./pkg -name "chsrc_${version}*.deb" -exec mv {} dist/ \;
+        cp -r dist/* dist-for-pre/
+
+        # 上传至 'pre' release 的文件名需要设置为 'latest', 从而稳定下载URL
+        cd ./dist-for-pre
+        for old_name in ./chsrc_${version}*.deb; do
+          new_name="${old_name/${version}-1/latest-1}"
+          mv "$old_name" "$new_name"
+        done
+
+    - name: 验证生成的deb包
+      run: |
+        version="${{ steps.get_version.outputs.version }}"
+        ls -la dist/
+        dpkg-deb --info dist/chsrc_${version}-1_amd64.deb
+        dpkg-deb --contents dist/chsrc_${version}-1_amd64.deb
+
+    - name: 测试deb包能否正常安装
+      run: |
+        version="${{ steps.get_version.outputs.version }}"
+
+        sudo dpkg -i dist/chsrc_${version}-1_amd64.deb || true
+        sudo apt-get install -f -y || true
+
+        bash pkg/deb/deb-installation-test.sh
+
+    - name: 上传deb包到artifacts
+      uses: actions/upload-artifact@v6
+      with:
+        name: chsrc-deb-files
+        path: dist/chsrc_*.deb
+        retention-days: 30
+
+    - name: 上传附件到GitHub Releases(the newly created release)
+      if: github.event_name == 'release'
+      uses: softprops/action-gh-release@v2
+      with:
+        # 用 * 省略版本号，以及指代各种架构
+        files: dist/chsrc_*.deb
+
+    - name: 上传附件到GitHub Releases(the 'pre' release)
+      if: github.event_name == 'push'
+      uses: softprops/action-gh-release@v2
+      with:
+        tag_name: pre
+        # 用 * 指代各种架构
+        files: dist-for-pre/chsrc_latest-1_*.deb
+
+
+
+
+
+  Create-APT-repository:
+    name: 创建APT仓库
+    needs: Build-deb
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+
+    steps:
+    - name: Download all artifacts
+      uses: actions/download-artifact@v7
+      with:
+        pattern: chsrc-deb-files
+        merge-multiple: true
+        path: ./debs
+
+    - name: Install repository tools
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y dpkg-dev
+
+    - name: Create Packages file
+      run: |
+        cd debs
+        dpkg-scanpackages . /dev/null | gzip -9c > Packages.gz
+        dpkg-scanpackages . /dev/null > Packages
+
+    - name: Upload repository metadata
+      uses: actions/upload-artifact@v6
+      with:
+        name: debian-repository-metadata
+        path: debs/Packages*
+        retention-days: 30

.github/workflows/pub-AUR-chsrc-and-chsrc-bin.yml

@@ -1,7 +1,19 @@
-# This workflow will publish the `chsrc` and the `chsrc-bin` packages to the AUR
-#   when there is a new `released` event.
-# Note: only normal version tags like `v1.2.3` will be published.
-name: Publish AUR Package (chsrc, chsrc-bin)
+# ---------------------------------------------------------------
+# Workflow File : pub-AUR-chsrc-and-chsrc-bin.yml
+# File Authors  : Terrasse <terrasse@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2024-08-29>
+# Last Modified : <2025-03-18>
+#
+# Publish the 2 packages to AUR when a new release is created:
+#   1. chsrc
+#   2. chsrc-bin
+#
+# Note: only normal version tags like 'v1.2.3' will be published
+# ---------------------------------------------------------------
+
+name: Publish 'chsrc' and 'chsrc-bin' to AUR
 on:
   release:
     types: [ released ]
@@ -33,7 +45,7 @@ jobs:
         sed -i "s/pkgver=.*/pkgver=$version/" PKGBUILD_bin
     - name: Publish chsrc-bin to AUR
       if: env.valid == '1'
-      uses: KSXGitHub/github-actions-deploy-aur@v3.0.1
+      uses: KSXGitHub/github-actions-deploy-aur@v4.1.1
       with:
         pkgname: chsrc-bin
         pkgbuild: ./PKGBUILD_bin
@@ -51,7 +63,7 @@ jobs:
         sed -i "s/pkgver=.*/pkgver=$version/" PKGBUILD
     - name: Publish chsrc to AUR
       if: env.valid == '1'
-      uses: KSXGitHub/github-actions-deploy-aur@v3.0.1
+      uses: KSXGitHub/github-actions-deploy-aur@v4.1.1
       with:
         pkgname: chsrc
         pkgbuild: ./PKGBUILD
@@ -60,4 +72,4 @@ jobs:
         commit_username: ${{ secrets.AUR_USERNAME }}
         commit_email: ${{ secrets.AUR_EMAIL }}
         ssh_private_key: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
-        commit_message: "github-action-auto-publish v${{ env.version }}"
+        commit_message: "github-action-auto-publish v${{ env.version }}"

.github/workflows/pub-AUR-chsrc-git.yml

@@ -1,10 +1,22 @@
-# This workflow will publish the `chsrc-git` package to the AUR
-#   when the main branch is updated.
-name: Publish AUR Package (chsrc-git)
+# ---------------------------------------------------------------
+# Workflow File : pub-AUR-chsrc-git.yml
+# File Authors  : Terrasse <terrasse@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2024-08-29>
+# Last Modified : <2025-06-19>
+#
+# Publish package 'chsrc-git' to AUR when branch 'main' is updated.
+# ---------------------------------------------------------------
+
+name: Publish 'chsrc-git' to AUR
 on:
   workflow_dispatch:
   push:
     branches: [ "main" ] # chsrc-git syncs with main
+    paths:
+      - "src/**"
+      - "lib/**"
 
 jobs:
   publish:
@@ -15,7 +27,7 @@ jobs:
       run: |
         wget https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD\?h\=chsrc-git -O ./PKGBUILD
     - name: Publish to AUR
-      uses: KSXGitHub/github-actions-deploy-aur@v3.0.1
+      uses: KSXGitHub/github-actions-deploy-aur@v4.1.1
       with:
         pkgname: chsrc-git
         pkgbuild: ./PKGBUILD

.github/workflows/pub-WinGet.yml

@@ -0,0 +1,24 @@
+# ---------------------------------------------------------------
+# Workflow File : pub-WinGet.yml
+# File Authors  :   YU-7   <2747046473@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2024-12-25>
+# Last Modified : <2024-12-25>
+#
+# This workflow publish to winget
+# ---------------------------------------------------------------
+
+name: Publish to WinGet
+on:
+  release:
+    types: [released]
+jobs:
+  publish:
+    runs-on: windows-latest
+    steps:
+      - uses: vedantmgoyal9/winget-releaser@main
+        with:
+          identifier:  RubyMetric.chsrc
+          installers-regex: '\.exe$' # Only .exe files
+          token: ${{ secrets.WINGET_TOKEN }}

.github/workflows/windows.yml

@@ -1,53 +0,0 @@
-name: Windows Build
-on:
-  push:
-    branches: [ "gh-pipeline" ]
-  pull_request:
-    branches: [ "gh-pipeline" ]
-
-jobs:
-  build-and-upload:
-
-    runs-on: windows-latest
-    defaults:
-      run:
-        shell: msys2 {0}
-
-    steps:
-
-    - name: Checkout repo
-      uses: actions/checkout@v3
-
-    - name: Install x64 gcc
-      uses: msys2/setup-msys2@v2
-      with:
-        msystem: UCRT64
-        update: true
-        install: |
-          mingw-w64-ucrt-x86_64-gcc
-          mingw-w64-ucrt-x86_64-make
-          mingw-w64-i686-gcc
-          mingw-w64-i686-make
-
-    - name: Compile chsrc x64
-      run: |
-        mingw32-make.exe CI CI_Build_Name=chsrc-x64-windows
-
-    - name: Compile chsrc x86
-      env:
-        MSYSTEM: MINGW32
-      run: |
-        mingw32-make.exe CI CI_Build_Name=chsrc-x86-windows
-
-    - name: List files
-      run: ls *.exe
-
-    - name: Release
-      uses: softprops/action-gh-release@v1
-      # if: startsWith(github.ref, 'refs/tags/')
-      with:
-        tag_name: pre
-        files: |
-          chsrc-x64-windows.exe
-          chsrc-x86-windows.exe
-        token: ${{ secrets.CHSRC_UPLOAD }}

.gitignore

@@ -1,23 +1,87 @@
-.vscode
+##############################
+#          VS Code
+##############################
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+!.vscode/c_cpp_properties.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/README.md
 
-*.exe
-*.out
+
+
+##############################
+#         Binaries
+##############################
 *.o
 *.obj
+*.a
+*.lib
+*.so
+*.dll
+*.out
+*.exe
+*.res
 
-# target exe name
+
+##############################
+#      Built executables
+##############################
 chsrc
+chsrc-debug
+chsrc-release
+chsrc-ci-release
+
+
+
+##############################
+#        Test files
+##############################
 xy
+fw
+README.md.bak*
+*.tmp
+chsrc_tmp_test.txt
+chsrc_tmp_test.txt.bak
+
+# Generated when testing (when there's a bug)
+nul
 
 # 'chsrc set -local' generated
 .bundle
+.npmrc
 
-# Generated when testing
-nul
 
-# Texinfo
+
+##############################
+#          Texinfo
+##############################
 chsrc.aux
 chsrc.log
 chsrc.toc
 *.info
 *.pdf
+
+
+
+##############################
+#         deb package
+##############################
+# deb package 未归档的目录
+pkg/deb/debian/chsrc/
+
+# 下面这个目录包含创建出 $HOME 的虚拟环境
+pkg/deb/debian/.debhelper/
+
+pkg/deb/debian/debhelper-build-stamp
+pkg/deb/debian/files
+pkg/deb/debian/chsrc.debhelper.log
+pkg/deb/debian/chsrc.substvars
+
+# 以下为 deb package 构建的直接产物
+chsrc_*.deb
+chsrc-dbgsym_*.ddeb
+chsrc_*.build
+chsrc_*.buildinfo
+chsrc_*.changes

.vscode/README.md

@@ -0,0 +1,18 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : (for VS Code users) README.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2025-06-18>
+ ! Last Modified : <2025-06-20>
+ ! ---------------------------------------------------------- -->
+
+# Dev in VS Code
+
+首先需要安装好 [just](https://github.com/casey/just)，而不再硬性需要 `make`
+
+1. `Ctrl-Shift-B` 直接构建
+2. `F5` 直接开始 Debug

.vscode/c_cpp_properties.json

@@ -0,0 +1,28 @@
+{
+    "configurations": [
+        {
+            "name": "Win32",
+            "includePath": [
+                "${workspaceFolder}/**"
+            ],
+            "cStandard": "c17",
+            "intelliSenseMode": "windows-gcc-x64"
+        },
+        {
+            "name": "Linux",
+            "includePath": [
+                "${workspaceFolder}/**"
+            ],
+            "cStandard": "c17"
+        },
+        {
+            "name": "Mac",
+            "includePath": [
+                "${workspaceFolder}/**"
+            ],
+            "cStandard": "c17"
+        }
+    ],
+    "enableConfigurationSquiggles": true,
+    "version": 4
+}

.vscode/extensions.json

@@ -0,0 +1,12 @@
+{
+    "recommendations": [
+        "ms-vscode.cpptools",
+        "ms-vscode.cpptools-extension-pack",
+        "editorconfig.editorconfig",
+        "redhat.vscode-yaml",
+        "nefrob.vscode-just-syntax"
+    ],
+    "unwantedRecommendations": [
+        "esbenp.prettier-vscode"
+    ]
+}

.vscode/launch.json

@@ -0,0 +1,64 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug chsrc",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/chsrc-debug",
+            "args": [
+                "get",
+                "nodejs"
+            ],
+            "preLaunchTask": "构建 debug 版 chsrc",
+            "stopAtEntry": true,
+            "cwd": "${workspaceFolder}",
+            "environment": [],
+            // 如果你认为使用弹出窗口难以调试，可尝试设置为false
+            "externalConsole": true,
+            // lldb 等请自行设置，不作额外说明
+            "MIMode": "gdb",
+            // "miDebuggerPath": "/path/to/gdb",
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                },
+                {
+                    "description": "Set Disassembly Flavor to Intel",
+                    "text": "-gdb-set disassembly-flavor intel",
+                    "ignoreFailures": true
+                }
+            ],
+            "postDebugTask": "停止 debug 程序"
+        },
+
+        {
+            "name": "Debug framework",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/fw",
+            "args": [],
+            "preLaunchTask": "测试 framework",
+            "stopAtEntry": true,
+            "cwd": "${workspaceFolder}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "gdb",
+            // "miDebuggerPath": "/path/to/gdb",
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                },
+                {
+                    "description": "Set Disassembly Flavor to Intel",
+                    "text": "-gdb-set disassembly-flavor intel",
+                    "ignoreFailures": true
+                }
+            ]
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,27 @@
+{
+    "editor.fontLigatures": false,
+
+    "C_Cpp.autoAddFileAssociations": false,
+    "C_Cpp.intelliSenseEngine": "Tag Parser",
+    "C_Cpp.default.browse.limitSymbolsToIncludedHeaders": false,
+
+    "editor.formatOnSave": false,
+
+    "C_Cpp.clang_format_fallbackStyle": "GNU",
+    "C_Cpp.formatting": "disabled",
+
+    "[c]": {
+        "editor.defaultFormatter": null,
+    },
+    "[h]": {
+        "editor.defaultFormatter": null
+    },
+    "[jsonc]": {
+        "editor.defaultFormatter": "vscode.json-language-features"
+    },
+    "[yaml]": {
+        "editor.defaultFormatter": "redhat.vscode-yaml"
+    },
+
+    "vscode-just.formatOnSave": false,
+}

.vscode/tasks.json

@@ -0,0 +1,172 @@
+{
+    "tasks": [
+        {
+            "type": "shell",
+            "label": "构建 chsrc",
+            "command": "just",
+            "args": [
+                "build"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "dependsOn": "停止程序",
+            "detail": "先停止原有程序，然后使用 just build 编译"
+        },
+        {
+            "type": "shell",
+            "label": "构建 debug 版 chsrc",
+            "command": "just",
+            "args": [
+                "build-in-debug-mode"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": false
+            },
+        },
+        {
+            "type": "shell",
+            "label": "测试 chsrc",
+            "command": "just",
+            "args": [
+                "test"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "group": {
+                "kind": "test",
+                "isDefault": true
+            },
+            "detail": "使用 just test 测试"
+        },
+        {
+            "type": "shell",
+            "label": "测试 framework",
+            "command": "just",
+            "args": [
+                "test-fw"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "group": {
+                "kind": "test",
+                "isDefault": false
+            },
+            "detail": "使用 just test-fw 测试 framework"
+        },
+        {
+            "type": "shell",
+            "label": "测试 xy.h",
+            "command": "just",
+            "args": [
+                "test-xy"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "group": {
+                "kind": "test",
+                "isDefault": false
+            },
+            "detail": "使用 just test-xy 测试 xy.h"
+        },
+        {
+            "type": "shell",
+            "label": "停止 debug 程序",
+            "windows": {
+                "command": "powershell",
+                "args": [
+                    "-c",
+                    "Get-Process -Name \"chsrc-debug\" -ErrorAction SilentlyContinue | Stop-Process -Force;",
+                    "Get-Process -Name \"gdb\" -ErrorAction SilentlyContinue | Stop-Process -Force;",
+                    "Get-Process -Name \"WindowsDebugLauncher\" -ErrorAction SilentlyContinue | Stop-Process -Force;"
+                ]
+            },
+            "linux": {
+                "command": "bash",
+                "args": [
+                    "-c",
+                    "if pgrep -f chsrc-debug > /dev/null; then pkill -f chsrc-debug; fi"
+                ]
+            },
+            "osx": {
+                "command": "bash",
+                "args": [
+                    "-c",
+                    "if pgrep -f chsrc-debug > /dev/null; then pkill -f chsrc-debug; fi"
+                ]
+            },
+            "group": "build",
+            "presentation": {
+                "echo": true,
+                "reveal": "silent",
+                "focus": false,
+                "panel": "shared",
+                "showReuseMessage": true,
+                "clear": false
+            },
+            "detail": "停止 debug 版本的 chsrc"
+        },
+        {
+            "type": "shell",
+            "label": "停止程序",
+            "windows": {
+                "command": "powershell",
+                "args": [
+                    "-c",
+                    "Get-Process -Name \"chsrc\" -ErrorAction SilentlyContinue | Stop-Process -Force;"
+                ]
+            },
+            "linux": {
+                "command": "bash",
+                "args": [
+                    "-c",
+                    "if pgrep -f chsrc > /dev/null; then pkill -f chsrc; fi"
+                ]
+            },
+            "osx": {
+                "command": "bash",
+                "args": [
+                    "-c",
+                    "if pgrep -f chsrc > /dev/null; then pkill -f chsrc; fi"
+                ]
+            },
+            "group": "build",
+            "presentation": {
+                "echo": true,
+                "reveal": "always",
+                "focus": false,
+                "panel": "shared",
+                "showReuseMessage": true,
+                "clear": false
+            },
+            "detail": "跨平台停止 chsrc"
+        }
+    ],
+    "version": "2.0.0"
+}

LICENSE-MIT.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 曾奥然 (Aoran Zeng), 郭恒 (Heng Guo)
+Copyright (c) 2023-2025 曾奥然 (Aoran Zeng), 郭恒 (Heng Guo)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

Makefile

@@ -1,48 +1,231 @@
-# ------------------------------------------------------------
+#!/usr/bin/make -f
+# --------------------------------------------------------------
 # SPDX-License-Identifier: GPL-3.0-or-later
-# -------------------------------------------------------------
+# --------------------------------------------------------------
 # Build File    : Makefile
-# File Authors  : Aoran Zeng <ccmywish@qq.com>
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Yangmoooo <yangmoooo@outlook.com>
+#								| sanchuanhehe <wyihe5520@gmail.com>
+#								|
 # Created On    : <2023-08-28>
-# Last Modified : <2024-09-10>
-# ---------------------------------------------------------------
+# Last Modified : <2025-10-15>
+#
+# 请阅读 ./doc/01-开发与构建.md 来使用
+# --------------------------------------------------------------
 
-CFLAGS = -Iinclude # -Wall
+#=========== OS Check ================
+On-Linux = 0
+On-Windows = 0
+On-macOS = 0
 
-# 只有Windows会定义该变量
-ifeq ($(OS), Windows_NT)
-	CLANG_FLAGS = -Target x86_64-pc-windows-gnu
+ifeq ($(shell uname), Linux)
+	On-Linux = 1
 endif
+
+ifeq ($(shell uname), Darwin)
+	On-macOS = 1
+endif
+
+# 只有 MSYS2 会定义 $(OS) 变量
+ifeq ($(OS), Windows_NT)
+	On-Windows = 1
+endif
+# 注意, 原生 Windows 会定义 $(ComSpec) 变量，且区分大小写
+# 但是 MSYS2 并不会定义
+#=====================================
+
+
+
+#======== Default Tooling ============
+ifeq ($(On-Windows), 1)
+  # MSYS2 环境
+	CC = cc
+else ifeq ($(On-macOS), 1)
+	CC = clang
+else
+	CC = cc
+endif
+
+ifeq ($(On-macOS), 1)
+	DEBUGGER = lldb
+else
+	DEBUGGER = gdb
+endif
+#=====================================
+
+
+
+#======== Compilation Config ==========
+CFLAGS += -Iinclude -Ilib
+
+ifeq ($(On-Windows), 1)
+	CLANG_FLAGS = -target x86_64-pc-windows-gnu
+endif
+
 ifeq ($(CC), clang)
 	CFLAGS += $(CLANG_FLAGS)
 endif
-ifeq ($(shell uname), Linux)
-	CFLAGS += -static
+
+override WARN += -Wall -Wextra -Wno-unused-variable -Wno-unused-function -Wno-missing-braces -Wno-misleading-indentation \
+	-Wno-missing-field-initializers -Wno-unused-parameter -Wno-sign-compare
+_C_Warning_Flags := $(WARN)
+
+DevMode-Target-Name = chsrc
+DebugMode-Target-Name = chsrc-debug
+ReleaseMode-Target-Name = chsrc-release
+CIReleaseMode-Target-Name = chsrc-ci-release
+
+CFLAGS_debug  = -g -DXY_DEBUG
+CFLAGS_static = -static
+CFLAGS_optimization = -O2
+
+ifdef DEBUG
+	CFLAGS += $(CFLAGS_debug)
 endif
 
-Target = chsrc
+STATIC = 0
 
-CI_Build_Name = chsrc
-#=======================
+ifeq ($(STATIC), 1)
+	CFLAGS += $(CFLAGS_static)
+endif
+#=====================================
 
-all:
-	@$(CC) src/chsrc-main.c $(CFLAGS) -o $(Target)
-	@echo; echo Compile done using \'$(CC)\' $(CFLAGS)
 
-CI: all
-	@mv $(Target) $(CI_Build_Name)
 
-test: $(Target)
-	@perl ./test/cli.pl
+#====== CI release mode 的配置 =======
+ifeq ($(MAKECMDGOALS), build-in-ci-release-mode)
 
-fastcheck: $(Target)
-	@perl ./test/cli.pl fastcheck
+	CFLAGS += $(CFLAGS_optimization)
 
+  # 仅在 Linux 上使用静态链接
+	ifeq ($(On-Linux), 1)
+		CFLAGS += $(CFLAGS_static)
+	endif
+
+  # GitHub Actions 上的 macOS 中的 LLVM 太老了
+  # 而且 gcc 被重命名为了 clang
+  # 需要直接指定版本
+  ifeq ($(On-macOS), 1)
+    CC = gcc-14
+  endif
+
+endif
+#=====================================
+
+
+
+#============ Aliases ================
+all: build
+
+b: build-in-dev-mode
+build: build-in-dev-mode
+bd: build-in-debug-mode
+br: build-in-release-mode
+bcir: build-in-ci-release-mode
+d: debug
+t: test
+check: test
+c: clean
+#=====================================
+
+
+
+build-in-dev-mode:
+	@echo Starting: Build in DEV mode: \'$(CC)\' $(CFLAGS) -o $(DevMode-Target-Name)
+	@$(CC) src/chsrc-main.c $(CFLAGS) $(_C_Warning_Flags) -o $(DevMode-Target-Name)
+	@echo Finished: Build in DEV mode
+
+build-in-debug-mode: CFLAGS += $(CFLAGS_debug)
+build-in-debug-mode:
+	@echo Starting: Build in DEBUG mode: \'$(CC)\' $(CFLAGS) -o $(DebugMode-Target-Name)
+	@$(CC) src/chsrc-main.c $(CFLAGS) $(_C_Warning_Flags) -o $(DebugMode-Target-Name)
+	@echo Finished: Build in DEBUG mode
+
+build-in-release-mode: CFLAGS += $(CFLAGS_optimization)
+build-in-release-mode:
+	@echo Starting: Build in RELEASE mode: \'$(CC)\' $(CFLAGS) -o $(ReleaseMode-Target-Name)
+	@$(CC) src/chsrc-main.c $(CFLAGS) $(_C_Warning_Flags) -o $(ReleaseMode-Target-Name)
+	@echo Finished: Build in RELEASE mode
+
+# CI release mode 的配置在该文件上方
+build-in-ci-release-mode:
+	@echo Starting: Build in CI-RELEASE mode: \'$(CC)\' $(CFLAGS) -o $(CIReleaseMode-Target-Name)
+	@$(CC) src/chsrc-main.c $(CFLAGS) $(_C_Warning_Flags) -o $(CIReleaseMode-Target-Name)
+	@echo Finished: Build in CI-RELEASE mode
+
+# 永远重新编译
+debug: build-in-debug-mode
+	@$(DEBUGGER) $(DebugMode-Target-Name)
+
+test: test-make-env test-xy test-fw
+
+test-make-env:
+	@echo "On-Linux: $(On-Linux)"
+	@echo "On-Windows: $(On-Windows)"
+	@echo "On-macOS: $(On-macOS)"
+	@echo "CC: $(CC)"
+	@echo "CFLAGS: $(CFLAGS)"
+	@echo "USER: $$(whoami)"
+	@echo "PWD: $(shell pwd)"
+	@echo "UID: $$(id -u)"
+	@echo "GID: $$(id -g)"
+# 检查HOME环境变量
+	@if [ -z "$(HOME)" ]; then \
+	 echo "HOME environment variable is not set!"; \
+	else \
+	 echo "HOME: $(HOME)"; \
+	fi
+
+# 这两个测试文件都用 DEBUG mode
+test-xy: CFLAGS += $(CFLAGS_debug)
 test-xy:
 	@$(CC) test/xy.c $(CFLAGS) -o xy
 	@./xy
 
+test-fw: CFLAGS += $(CFLAGS_debug)
+test-fw:
+	@$(CC) test/fw.c $(CFLAGS) -o fw
+	@./fw
+
+check: test
+
+# AUR package 安装时将执行此 target
+fastcheck: $(DevMode-Target-Name)
+	@perl ./test/cli.pl fastcheck
+
+test-cli: $(DevMode-Target-Name)
+	@perl ./test/cli.pl
+
 clean:
 	-@rm *.exe  2>/dev/null
+	-@rm *.res  2>/dev/null
 	-@rm xy     2>/dev/null
-	-@rm chsrc  2>/dev/null
+	-@rm fw     2>/dev/null
+	-@rm README.md.bak*    2>/dev/null
+
+	-@rm chsrc  					 2>/dev/null
+	-@rm chsrc-debug       2>/dev/null
+	-@rm chsrc-release  	 2>/dev/null
+	-@rm chsrc-ci-release  2>/dev/null
+
+# -include pkg/deb/Makefile # 不这么做，因为 pkg/deb/Makefile 需要在 pkg/deb 目录下执行
+# 保持动词在前的任务名风格
+build-deb:
+	@$(MAKE) -C pkg/deb deb-build
+
+clean-deb:
+	@$(MAKE) -C pkg/deb deb-clean
+
+install: $(ReleaseMode-Target-Name)
+	install -D -m 755 $(ReleaseMode-Target-Name) $(DESTDIR)/usr/bin/chsrc
+	install -D -m 644 doc/chsrc.1 $(DESTDIR)/usr/share/man/man1/chsrc.1
+
+# 这样还是太麻烦，不用，我们还是靠 just 来调用吧
+#
+# 通过 make rawstr4c ARGS="[--debug] Markdown.md" 来调用
+#rawstr4c:
+#	@bash ./tool/rawstr4c/run/run.sh $(ARGS)
+
+.PHONY: all b build bd br bcir d t check c \
+	build-in-dev-mode build-in-debug-mode build-in-release-mode build-in-ci-release-mode \
+	debug test test-make-env test-xy test-fw fastcheck test-cli clean install build-deb clean-deb rawstr4c

README.md

@@ -1,61 +1,149 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : README.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Mikachu2333 <mikachu.23333@zohomail.com>
+ !               | BingChunMoLi <bingchunmoli@bingchunmoli.com>
+ !               |
+ ! Created On    : <2023-12-28>
+ ! Last Modified : <2025-08-22>
+ ! ---------------------------------------------------------- -->
+
 <div align="center">
-  <img alt="chsrc logo" src="image/chsrc.png"/>
+  <img alt="chsrc logo" src="doc/image/chsrc.png"/>
 </div>
 
-全平台命令行换源工具，**目标支持 Linux, Windows (MSYS2, Cygwin), macOS, BSD 等尽可能多的操作系统环境，龙芯、飞腾、RISC-V 等尽可能多的 CPU**。
+全平台通用换源工具与框架 `chsrc`，**目标支持 Linux, Windows (native, MSYS2, Cygwin), macOS, BSD, Android 等尽可能多的操作系统环境，龙芯、飞腾、RISC-V 等尽可能多的 CPU**。
 
-我们使用 **C99** 来完成上述目标。我们并不使用 Python 或 JS 等解释语言，因为一个简单的换源工具，不应该强行塞给用户一个庞大的解释器和数十、数百 MB 其他文件。
+我们使用 **C11** 来完成上述目标。我们并不使用 Python 或 JavaScript 等解释语言，因为一个简单的换源工具，不应该强行塞给用户一个庞大的解释器和数十、数百 MB 其他文件。
 
 本软件为**自由软件**，SDPX 软件许可证为 `GPL-3.0-or-later and MIT`
 
-<a href="https://hellogithub.com/repository/7666ba91e01e4a59be5809b02d9e8ff6" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=7666ba91e01e4a59be5809b02d9e8ff6&claim_uid=H6YVMUy7ulev8R4&theme=dark" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+<br>
+
+
+
+<table align="center">
+  <tr>
+  <td>
+    <a href="https://trendshift.io/repositories/10744" target="_blank"><img src="https://trendshift.io/api/badge/repositories/10744" alt="RubyMetric%2Fchsrc | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+  </td>
+  <td>
+    <a href="https://hellogithub.com/repository/7666ba91e01e4a59be5809b02d9e8ff6" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=7666ba91e01e4a59be5809b02d9e8ff6&claim_uid=H6YVMUy7ulev8R4&theme=dark" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+  </td>
+  </tr>
+</table>
 
 <br>
 
-## 🤝 贡献
+
+
+## ❤️ 致所有的朋友们
+
+2025年8月11日，我因通宵重构本项目代码而被送去抢救（[#252](https://github.com/RubyMetric/chsrc/issues/252)，[突发！换源工具 chsrc 作者在重构过程中被送去 120 抢救](https://v2ex.com/t/1151802)）。大家给予的关心和帮助让我非常非常感动！在此，我衷心感谢每一位朋友！**无论是开源还是闭源，无论是否为职业程序员，我们其实都是一群使用软件、热心互助、充满友爱的人，这是一个温暖的大家庭**。
+
+我为 `chsrc` 采用 GPL 协议，怀着殷切的期望：**希望能够营造像 Richard Stallman 在创建 GNU 项目之前，在 MIT 那样的氛围——写自己用得上的软件，与大家一起开发、维护，简单纯粹，无关商业利益。就像小区、校园自发组建的足球篮球队，从一次偶然的加入，逐渐成长为互相支持的伙伴**。
+
+这次经历让我更加深刻地体会到：开源，是一种把大家联系在一起的方式，**它让友情、互助和协作成为可能，也让我们在共同的目标中建立起长期的纽带**。
+
+最后，希望大家能够**时刻关注**自己的身体，**你可以随时 `chsrc` `chown` `chgrp` `chmod` 无限次，但是无法 `chbody`**！
+
+<br>
+
+
+
+## 🤝 协作与贡献
 
 > [!TIP]
-> **`chsrc` 不仅是一个命令行工具，同时也是一个换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。**
+> **`chsrc` 不仅是一个命令行工具，同时也是一个体现了 Ruby on Rails 思想的 MVC 换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法 (recipe)。** 配合使用 [rawstr4c], 这将比写 shell 脚本更加轻松。 [如何编写 recipe?](./doc/10-如何编写recipe.md)
 
-立刻为一个新软件添加换源方法！[Write A Recipe Even If You Don't Know C](./doc/Write-A-Recipe-Even-If-You-Dont-Know-C.md)
+---
 
-- 案例：[Armbian](./src/recipe/os/APT/Armbian.c)
-- 挑战：[CentOS (Stream) Recipe Challenge!](https://github.com/RubyMetric/chsrc/issues/48)
+> [!NOTE]
+> 这也许是你可以参与的第一个现实世界中有用的C语言项目，[用 VS Code 一分钟内上手编译、运行、测试 chsrc](./doc/01-开发与构建.md)
+>
+> 欢迎对 GitHub、Gitee 协作不熟悉的人以此为契机学习参与贡献, 欢迎任何编程初学者。[从开发到提交PR，我们覆盖全流程文档](./doc/)
+---
+
+> [!IMPORTANT]
+> **`chsrc` 可换源 65+ 目标。每个人仅仅贡献和维护自己熟悉的部分，回报是得到其他所有领域专家的帮助。** [欢迎成为 recipe 维护者](https://github.com/RubyMetric/chsrc/issues/275)
 
 <br>
 
-📝 持续关注镜像站可用性的协作:
+可参与的任务与挑战：
 
-1. https://github.com/RubyMetric/chsrc/wiki
-2. https://github.com/RubyMetric/chsrc/discussions
+1. [Shell auto-completion 终端命令自动补全](https://github.com/RubyMetric/chsrc/issues/204)
+
+2. [搜集默认源地址，帮助使用 `reset` 功能](https://github.com/RubyMetric/chsrc/issues/111)
+
+3. [搜集测速地址，进行精准测速](https://github.com/RubyMetric/chsrc/issues/205)
+
+4. [chsrc-bootstrap: 为不存在预编译 `chsrc` 的平台提供支持](https://github.com/RubyMetric/chsrc/issues/230)
 
 <br>
 
-想通过 `flatpak`,`snap`,`pacman`,`apt`,`dnf` 等系统包管理工具来安装和更新`chsrc`？若您可提供维护，请访问 [issue#16 on GitHub](https://github.com/RubyMetric/chsrc/issues/16)
+<details>
+<summary>已由贡献者完成的挑战</summary>
+
+1. [[Challenge] 编写统一安装的 shell 和 PowerShell 脚本](https://github.com/RubyMetric/chsrc/issues/98)
+
+    已由 [@Efterklang] 与 [@wickdynex] 完成
+
+</details>
+
+<details>
+<summary>镜像站可用性</summary>
+
+1. <https://github.com/RubyMetric/chsrc/wiki>
+2. <https://github.com/RubyMetric/chsrc/discussions>
+
+</details>
+
+<details>
+<summary>打包</summary>
+
+想通过 `dnf`, `flatpak`, `snap` 等系统包管理工具来安装和更新`chsrc`？若可提供维护，请访问 [issue#16 on GitHub](https://github.com/RubyMetric/chsrc/issues/16)
 
 - [x] `Homebrew`
 - [x] `Scoop`
+- [x] `WinGet`
 - [x] `AUR`
 - [ ] `Flatpak`
 - [ ] `snap`
 - [ ] 缺乏其他平台/包维护者
 
+</details>
+
 <br>
 
+
+
 ## 📌 示例
 
+桌面端:
+
 <div align="center">
-  <img alt="chsrc set node" src="image/example-node.png"/>
-  <br>
-  <img alt="chsrc ls -en ruby" src="image/example-ls-ruby.png"/>
+  <img alt="chsrc set node" src="doc/image/example-set-nodejs.png"/>
 </div>
 
 <br>
 
+安卓:
+
+<div align="center">
+  <img alt="chsrc set python and chsrc set termux" src="doc/image/chsrc-on-Android-set-python-and-termux.jpg" width="300" height="750"/>
+</div>
+
+<br>
+
+
+
 ## 🚀 安装
 
 <a href="https://repology.org/project/chsrc/versions">
-    <img src="https://repology.org/badge/vertical-allrepos/chsrc.svg" alt="Packaging status" align="right">
+  <img src="https://repology.org/badge/vertical-allrepos/chsrc.svg" alt="Packaging status" align="right">
 </a>
 
 > [!IMPORTANT]
@@ -64,12 +152,35 @@
 <details>
 <summary>Windows</summary>
 
-- 可通过 `scoop` 安装，感谢 [@Gn3po4g](https://github.com/Gn3po4g) 与 [@niheaven](https://github.com/niheaven)
+- 可通过 `scoop` 安装，感谢 [@Gn3po4g] 与 [@niheaven]
 
 ```bash
-$ scoop install chsrc
+scoop install chsrc
 ```
 
+<br>
+
+- 可通过 `WinGet` 安装，感谢 [@YU-7]
+
+```bash
+winget install RubyMetric.chsrc
+```
+
+<br>
+
+- 可通过 `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
+```
+
+<br>
+
 - 或手动下载二进制文件，这是最新版，往往比 `scoop` 提供的更新，适用于修复 Bug、添加新功能后及时使用，以及未安装 `scoop` 时
 
 ```bash
@@ -79,21 +190,70 @@ curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windo
 # x86
 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x86-windows.exe -o chsrc.exe
 ```
+
 </details>
 
+
+
 <details>
 <summary>Linux</summary>
 
-- 支持 `AUR`，可通过 `yay` 安装，感谢 [@Jerry-Terrasse](https://github.com/Jerry-Terrasse)
+- 可通过 `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
+```
+
+<br>
+
+- 支持 `AUR`，可通过 `yay` 安装，感谢 [@Jerry-Terrasse]
 
 ```bash
 # AUR
 $ yay -S chsrc-bin # Binary from GitHub Release
-$ yay -S chsrc     # Build  from GitHub Release
 $ yay -S chsrc-git # Build  from the latest main branch (stable)
+$ yay -S chsrc     # Build  from GitHub Release
 ```
 
-- 手动下载二进制文件安装
+<br>
+
+- 可通过 `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://chsrc.run/posix | bash
+
+# root用户默认安装至 /usr/local/bin
+$ curl https://chsrc.run/posix | sudo bash
+
+# 使用 -d 指定目录安装
+$ curl https://chsrc.run/posix | bash -s -- -d ./
+
+# 使用 -v 指定版本 (不指定时默认为 pre)
+#   1. 安装 pre 版本; 这比从包管理器安装的总是更新一些
+#   2. 安装旧版本; 有时新版本可能引入某些 Bug，临时使用旧版本解决燃眉之急
+$ curl https://chsrc.run/posix | bash -s -- -v 0.2.1
+
+# 使用 -l en 输出英文
+$ curl https://chsrc.run/posix | bash -s -- -l en
+```
+
+<br>
+
+- 可手动下载二进制文件安装
 
 ```bash
 # x64
@@ -109,43 +269,115 @@ curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-riscv64-l
 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-armv7-linux -o chsrc; chmod +x ./chsrc
 ```
 
+如果你所在的处理器架构没有预编译版本，可以使用 [chsrc-bootstrap]
+
 </details>
 
+
+
 <details>
 <summary>macOS</summary>
 
-- 可通过 `homebrew` 安装，感谢 [@Aaron-212](https://github.com/Aaron-212) 与 [@chenrui333](https://github.com/chenrui333)
+- 可通过 `homebrew` 安装，感谢 [@Aaron-212] 与 [@chenrui333]
 
 ```bash
-$ brew install chsrc
+brew install chsrc
 ```
 
+<br>
+
+- 可通过 `shell` 脚本安装最新版，感谢 [@Efterklang] 与 [@wickdynex]
+
+    若下方链接无法访问，可使用 `https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.sh` 替代
+
+```bash
+# 非root用户默认安装至 ~/.local/bin
+$ curl https://chsrc.run/posix | bash
+
+# root用户默认安装至 /usr/local/bin
+$ curl https://chsrc.run/posix | sudo bash
+
+# 使用 -d 指定目录安装
+$ curl https://chsrc.run/posix | bash -s -- -d ./
+
+# 使用 -v 指定版本 (不指定时默认为 pre)
+#   1. 安装 pre 版本; 这比从包管理器安装的总是更新一些
+#   2. 安装旧版本; 有时新版本可能引入某些 Bug，临时使用旧版本解决燃眉之急
+$ curl https://chsrc.run/posix | bash -s -- -v 0.2.1
+
+# 使用 -l en 输出英文
+$ curl https://chsrc.run/posix | bash -s -- -l en
+```
+
+<br>
+
 - 或手动下载二进制文件，这是最新版，往往比 `homebrew` 提供的更新，适用于修复 Bug、添加新功能后及时使用
 
 ```bash
-# arm/aarch64
+# arm64/aarch64
 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-macos -o chsrc; chmod +x ./chsrc
 
 # x64
 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-macos -o chsrc; chmod +x ./chsrc
 ```
+
 </details>
 
+
+
 <details>
 <summary>BSD</summary>
 
+如果已安装好了编译 `chsrc` 所需要的依赖，可直接运行:
+
 ```bash
-$ git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc
-$ clang -Iinclude src/chsrc-main.c -o chsrc
+git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc
+clang -Iinclude -Ilib src/chsrc-main.c -o chsrc
 ```
+
+**如果还不存在这些依赖，你将会被死锁住: 我还没有换源，我该如何安装这些依赖呢？**
+
+这就是 [chsrc-bootstrap] 起作用的时刻，你可使用BSD系统的原生脚本语言编写 `bootstrapper`，[并向我们提交](https://github.com/RubyMetric/chsrc/issues/230)
+
+注: `chsrc` 实现的 `FreeBSD recipe` 长期存在问题，因此一个新的 `bootstrapper` 是相当必要的，请帮助你自己和大家!
+
 </details>
 
+
+
+<details>
+<summary>Android/Termux</summary>
+
+Termux 中默认无 `Wget`，我们都用 `cURL` 来下载安装
+
+```bash
+# arm64/aarch64
+curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-arm64-android -o chsrc; chmod +x ./chsrc
+```
+
+如果你所在的处理器架构没有预编译版本，可以使用 [chsrc-bootstrap]:
+
+```bash
+curl -L https://gitee.com/RubyMetric/chsrc/raw/main/bootstrap/Termux.bash | bash
+```
+
+</details>
+
+
+
 <details>
 <summary>其他平台</summary>
 
+若你所在的平台不存在预编译好的 `chsrc`，你需要手动编译。如果已安装好了编译 `chsrc` 所需要的依赖，可直接运行:
+
 ```bash
-$ git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; gmake
+git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; make
 ```
+
+**如果还不存在这些依赖，你将会被死锁住: 我还没有换源，我该如何安装这些依赖呢？**
+
+这就是 [chsrc-bootstrap] 起作用的时刻，你可使用该平台原生脚本语言编写 `bootstrapper`，[并向我们提交](https://github.com/RubyMetric/chsrc/issues/230)
+
 </details>
 
 <br>
@@ -153,54 +385,63 @@ $ git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; gmake
 ## 💡 使用
 
 ```bash
-使用: chsrc <command> [options] [target] [mirror]
+名称:
+   chsrc - Change Source - (GPLv3+)
 
-help                      # 打印此帮助，或 h, -h, --help
-issue                     # 查看相关issue
+使用:
+   chsrc <command> [options] [target] [mirror]
 
-list (或 ls, 或 l)        # 列出可用镜像源，和可换源目标
-list mirror/target        # 列出可用镜像源，或可换源目标
-list os/lang/ware         # 列出可换源的操作系统/编程语言/软件
+命令:
+   help,  h                   打印此帮助，或 -h, --help
+   issue, i                   查看相关issue
 
-measure <target>          # 对该目标所有源测速
-cesu    <target>
+   list, ls, l                列出可用镜像站和可换源目标
+   list  mirror|target        列出支持的: 镜像站/换源目标
+   list  os|lang|ware         列出支持的: 操作系统/编程语言/软件
+   list   <target>            查看该目标可用源与支持功能
 
-list <target>             # 查看该目标可用源与支持功能
-get  <target>             # 查看该目标当前源的使用情况
+   measure, m, cesu <target>  对该目标所有源测速
 
-set  <target>             # 换源，自动测速后挑选最快源
-set  <target>  first      # 换源，使用维护团队测速第一的源
-set  <target> <mirror>    # 换源，指定使用某镜像站 (通过list命令查看)
-set  <target> https://url # 换源，用户自定义源URL
-reset <target>            # 重置，使用上游默认使用的源
+   get, g <target>            查看该目标当前源的使用情况
+
+   set, s <target>            换源，自动测速后挑选最快源
+   set    <target>  first     换源，使用维护团队测速第一的源
+   set    <target> <mirror>   换源，指定使用某镜像站 (通过list <target>查看)
+   set    <target>  <URL>     换源，用户自定义源URL
+   reset  <target>            重置，使用上游默认使用的源
 
 选项:
--dry                      # Dry Run，模拟换源过程，命令仅打印并不运行
--para(llel)               # 并行测速 (默认的顺序测速更有参考意义)
--local                    # 仅对某项目而非全局换源 (仅部分软件如bundler,pdm支持)
--ipv6                     # 使用IPv6测速
--en(glish)                # 使用英文输出
--no-color                 # 无颜色输出
+   -dry                       Dry Run，模拟换源过程，命令仅打印并不运行
+   -local                     仅对本项目而非全局换源 (通过ls <target>查看支持情况)
+   -ipv6                      使用IPv6测速
+   -en(glish)                 使用英文输出
+   -no-color                  无颜色输出
 ```
 
-当你**不想自动测速的时候**，你可以直接指定某镜像站，源URL，以及指定维护团队已测试的最快镜像站。
+<br>
 
 ```bash
-chsrc set ruby           # 测速，寻找最快者，换源
-# 或
-chsrc ls  ruby           # 列出可用的镜像站
-chsrc set ruby rubychina # 使用 RubyChina 作为镜像站
-# 或您有自己的镜像地址
-chsrc set ruby https://gems.ruby-china.com/ # 使用自定义URL
-# 或
-chsrc set ruby first     # 使用维护团队测试的最快镜像站
-```
+自动测速，寻找最快者，换源
 
-对支持 **项目级** 换源的目标，可以避免全局（**系统级** 或 **用户级**）换源。
+    $ chsrc set ruby
 
-```bash
-chsrc set -local bundler
-chsrc set -local pdm
+不想自动测速的时候，可使用维护团队测试的最快镜像站
+
+    $ chsrc set ruby first
+
+先列出可用的镜像站，然后选择其一，如使用 RubyChina 作为镜像站
+
+    $ chsrc ls  ruby
+    $ chsrc set ruby rubychina
+
+若有自己的镜像，可以使用自定义URL
+
+    $ chsrc set ruby https://gems.ruby-china.com/
+
+对支持 *项目级* 换源的目标，可以避免全局（*系统级* 或 *用户级*）换源
+
+    $ chsrc set -local bundler
+    $ chsrc set -local pdm
 ```
 
 <br>
@@ -208,28 +449,41 @@ chsrc set -local pdm
 ## 编程语言开发
 
 ```bash
-chsrc set ruby    或 gem
-chsrc set python  或 pip / poetry / pdm # 同时换pip、poetry 和 pdm 这3个
+chsrc set ruby|rb|gem|bundler|rubygems
 
-chsrc set node|nodejs # 可同时换 npm, yarn 和 pnpm 3个，也可以3个独立换源
+chsrc set python | py | pypi # 同时换 pip, poetry, pdm, uv 这4个包管理器，也可以4个独立换源
+  chsrc set pip
+  chsrc set poetry
+  chsrc set pdm
+  chsrc set uv
+
+chsrc set rye
+
+chsrc set node | nodejs # 同时换 npm, yarn 和 pnpm 这3个包管理器，也可以3个独立换源
   chsrc set npm
   chsrc set yarn
   chsrc set pnpm
 
-chsrc set perl    或 cpan
-chsrc set php     或 composer
-chsrc set lua     或 luarocks
+chsrc set nvm
+chsrc set bun
+
+chsrc set perl | cpan
+chsrc set php  | composer
+chsrc set lua  | luarocks
+
+chsrc set rust | cargo | crate
+chsrc set rustup
 
 chsrc set go
-chsrc set rust    或 cargo / crate
-chsrc set java    或 maven / mvn / gradle
-chsrc set clojure 或 clojars
-chsrc set dart    或 pub / flutter # 同时会为flutter换源
-chsrc set haskell 或 hackage/cabal/stack
-chsrc set ocaml   或 opam
+chsrc set java    | maven | mvn | maven-daemon | mvnd | gradle
+chsrc set clojure | clojars
+chsrc set dart    | pub
+chsrc set flutter
+chsrc set haskell | hackage | cabal | stack
+chsrc set ocaml   | opam
 
 # 同时会为 bioconductor 换源
-chsrc set r       或 cran
+chsrc set r | cran
 chsrc set julia
 ```
 
@@ -239,33 +493,38 @@ chsrc set julia
 
 ```bash
 sudo chsrc set ubuntu
-sudo chsrc set linuxmint 或 mint
+sudo chsrc set zorinos
+sudo chsrc set linuxmint
 sudo chsrc set debian
 sudo chsrc set fedora
-sudo chsrc set suse  或 opensuse
+# 同时支持 Leap 和 Tumbleweed
+sudo chsrc set opensuse
 sudo chsrc set kali
 sudo chsrc set arch
 sudo chsrc set archlinuxcn
 sudo chsrc set manjaro
 sudo chsrc set gentoo
-sudo chsrc set rocky 或 rockylinux
-sudo chsrc set alma  或 almalinux
+sudo chsrc set rocky | rockylinux
+sudo chsrc set alma  | almalinux
 sudo chsrc set alpine
-sudo chsrc set void  或 voidlinux
+sudo chsrc set voidlinux
 sudo chsrc set solus
-sudo chsrc set ros   或 ros2
+sudo chsrc set ros   | ros2
 sudo chsrc set trisquel
-sudo chsrc set lite  或 linuxlite
-sudo chsrc set raspi 或 raspberrypi
+sudo chsrc set linuxlite
+sudo chsrc set raspi | raspberrypi
 sudo chsrc set armbian
 sudo chsrc set openwrt
 
 sudo chsrc set openeuler
-sudo chsrc set openanolis 或 anolis
+sudo chsrc set openanolis | anolis
 sudo chsrc set openkylin
 sudo chsrc set deepin
 
-chsrc set msys2 或 msys
+chsrc set msys2 | msys
+
+# Android
+chsrc set termux
 
 # BSD
 sudo chsrc set freebsd
@@ -279,34 +538,15 @@ sudo chsrc set netbsd
 
 ```bash
 chsrc set winget
-chsrc set brew      或 homebrew
-chsrc set cocoapods 或 cocoa / pod
-chsrc set dockerhub 或 docker
-chsrc set flathub   或 flatpak
+chsrc set brew      | homebrew
+chsrc set cocoapods | cocoa | pod
+chsrc set dockerhub | docker
+chsrc set flathub   | flatpak
 chsrc set nix
 chsrc set guix
-chsrc set emacs  或 elpa
-chsrc set tex    或 ctan / latex / texlive / miktex
-chsrc set conda  或 anaconda
-```
-
-<br>
-
-## 🛠️ 开发
-
-请安装好 `gcc`或`clang` 和 `make` 以及 `curl`
-
-```bash
-# 使用 dev 分支开发
-git clone https://gitee.com/RubyMetric/chsrc.git -b dev
-
-make          # 默认使用 cc 编译
-make CC=clang # 使用 clang 编译
-make CC=gcc   # 使用 gcc   编译
-
-make test    # 测试命令
-make test-xy # 测试 xy.h
-make clean
+chsrc set emacs  | elpa
+chsrc set tex    | ctan | latex | texlive | miktex
+chsrc set conda  | anaconda
 ```
 
 <br>
@@ -321,15 +561,39 @@ make clean
 ## ❤️ 致谢
 
 感谢各个镜像站提供的优质免费镜像服务
-1. [source.h](./include/source.h) 包含了通用的镜像站信息
+
+1. [mirror.c](./src/framework/mirror.c) 包含了通用的镜像站信息
 2. 各个recipe内部定义的专用镜像站
 
 另外特别感谢以下组织或项目:
 
-1. [MirrorZ 教育网镜像站](https://help.mirrors.cernet.edu.cn/)
+1. [校园网联合镜像站(MirrorZ)](https://help.mirrors.cernet.edu.cn/)
 2. [清华大学 Tuna](https://mirrors.tuna.tsinghua.edu.cn/)
 3. [上海交通大学软件源镜像服务](https://mirrors.sjtug.sjtu.edu.cn/)
 4. [中国科学技术大学 Linux 用户协会](https://github.com/ustclug)
 5. [Thanks Mirror 项目](https://github.com/eryajf/Thanks-Mirror) by [@eryajf](https://github.com/eryajf)
 
 <br>
+
+## 🚀 赞赏支持
+
+你是否因为 `chsrc` 而受到启发、节省了时间精力 or whatever?
+
+爱发电主页: <https://afdian.com/a/ccmywish>
+
+<img src="https://raw.githubusercontent.com/ccmywish/support-my-oss-work/main/wechat-reward.png" alt="wechat-reward" style="width:300px;"/>
+
+<br>
+
+[rawstr4c]:        https://github.com/RubyMetric/rawstr4c
+[chsrc-bootstrap]: ./bootstrap/
+
+[@Aaron-212]:      https://github.com/Aaron-212
+[@chenrui333]:     https://github.com/chenrui333
+[@niheaven]:       https://github.com/niheaven
+[@Gn3po4g]:        https://github.com/Gn3po4g
+[@Jerry-Terrasse]: https://github.com/Jerry-Terrasse
+[@Efterklang]:     https://github.com/Efterklang
+[@wickdynex]:      https://github.com/wickdynex
+[@YU-7]:           https://github.com/YU-7
+[@sanchuanhehe]:   https://github.com/sanchuanhehe

bootstrap/README.md

@@ -0,0 +1,104 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : (chsrc-bootstrap Introduction.md)
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2025-07-12>
+ ! Last Modified : <2025-07-22>
+ ! ---------------------------------------------------------- -->
+
+# Bootstrap
+
+```ruby
+begin
+  download_prebuilt_chsrc_binary_for_my_platform
+rescue NoReadyMadeBinary => e
+  bootstrap! e.my_platform
+end
+```
+
+<br>
+
+
+
+## 预编译产生的死锁问题
+
+我们支持预编译的操作系统目前只有 `Windows`, `Linux`, `macOS`，支持的架构请参考[项目 README](../README.md)
+
+某些操作系统如 BSD 家族，甚至是更小众的操作系统, 或者上述操作系统的某些架构，无法享受直接下载二进制立即使用的便利性，这导致用户需要自己编译 `chsrc`.
+
+然而用户自己编译则面临着一个问题: **需要提前安装项目依赖**
+
+1. 把代码 `git clone` 下来 或 下载 `zip` 包进行解压缩
+2. C语言编译器
+3. `GNU make` 或 `just` (这二者非强制，但是有了更好)
+
+可是如果用户还没有换源，他/她又如何获得上述这些程序呢？**这是一把死锁，导致用户最终回到手动换源的原始农耕时代。**
+
+<br>
+
+
+
+## `chsrc-bootstrap` to the Rescue
+
+`chsrc-bootstrap` 是一组使用原生脚本语言的脚本，每个脚本称为 `bootstrapper`，用来完成两件事情:
+
+1. 帮助用户进行最基本的换源，让用户能够立即开始使用该系统安装其他软件
+
+2. 用户自行决定是否需要安装 `chsrc`
+
+    - 若不需要: 流程直接结束，用户已可以完成基本日常工作
+
+    - 若需要: 帮助用户安装好所需的最少依赖，并编译安装 `chsrc`
+
+注意，最基本的换源，即不测速，由维护者暂时决定先切换到某一个具体的源，先让系统跑起来。
+
+### 支持的语言
+
+上述提到的原生脚本语言只能是这些:
+
+1. Windows: `PowerShell`, `CMD`
+
+2. Linux: `Bash`, `sh`
+
+    备选: `Perl`
+
+3. macOS: `Zsh`, `Bash`, `sh`
+
+    备选: `Ruby`, `Perl`
+
+4. BSD: `sh`
+
+    备选: 待议
+
+5. 其他平台: 一切该平台支持的脚本语言，无需额外安装
+
+<br>
+
+
+
+## `chsrc` 与 `chsrc-bootstrap`
+
+`chsrc` 需要实现 `chsrc-bootstrap` 中支持的平台。这是因为，`chsrc-bootstrap` 只换到了某一个具体的源，只是临时性的，后续用户可能还想要换到其他源，此时 `chsrc` 就可以接管。
+
+而事实上，`chsrc-bootstrap` 可以完成一些操作，使得系统已经满足一些前置条件，这样的话 `chsrc` 可以在这些前置条件存在时接着换源，从而大幅减轻 `recipe` 的实现难度。
+
+<br>
+
+
+
+## 帮助
+
+1. [FreeBSD 的换源](https://github.com/RubyMetric/chsrc/issues/11) 从项目一开始就是我们的目标之一，然而由于其:
+
+    - 换源所需的步骤太多
+    - 面临着特有的鸡蛋困境
+    - BSD 工具和 GNU 工具总是有不兼容之处
+    - 在C语言中实现困难重重
+
+    因此我们一直没有很好的办法去实现
+
+2. 任何你所在的平台，都可以添加到此

bootstrap/Termux.bash

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# ---------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# ---------------------------------------------------------------
+# File Name     : Termux.bash
+# File Authors  : Aoran Zeng <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+# Created On    : <2025-07-12>
+# Last Modified : <2025-07-22>
+#
+# Termux:
+#
+#   Bootstrap Termux: https://github.com/RubyMetric/chsrc/issues/173
+#
+#   @consult https://help.mirrors.cernet.edu.cn/termux/
+#
+#   我们默认采用校园网联合镜像站提供的源
+# ---------------------------------------------------------------
+
+bs_echo() {
+  echo "[chsrc-bootstrap] $*"
+}
+
+if command -v termux-change-repo &>/dev/null; then
+  termux-change-repo
+else
+
+  # $PREFIX 的值为:  /data/data/com.termux/files/usr
+  # 用户主目录 ~ 为: /data/data/com.termux/files/home
+
+  # 必要的
+  sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.cernet.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list
+  apt update
+
+  # x11-repo
+  sed -i 's@^\(deb.*x11 main\)$@#\1\ndeb https://mirrors.cernet.edu.cn/termux/apt/termux-x11 x11 main @' $PREFIX/etc/apt/sources.list.d/x11.list
+
+  # root-repo
+  sed -i 's@^\(deb.*root main\)$@#\1\ndeb https://mirrors.cernet.edu.cn/termux/apt/termux-root root main @' $PREFIX/etc/apt/sources.list.d/root.list
+fi
+
+# 立即更新测试换源状态
+apt update && apt upgrade
+
+bs_echo "基础换源已完成"
+
+read -p "是否需要安装 chsrc ? (y/n): " need_install_chsrc
+
+if [[ $need_install_chsrc == "y" || $need_install_chsrc == "Y" ]]; then
+  bs_echo "正在安装依赖项..."
+  apt-get install -y gcc make git
+  git clone https://gitee.com/RubyMetric/chsrc.git --depth 1
+  bs_echo "依赖安装完成!"
+
+  bs_echo "正在开始编译和安装"
+  cd chsrc
+  make build-in-release-mode
+  make install
+  bs_echo "chsrc 安装完成!"
+fi

doc/01-开发与构建.md

@@ -0,0 +1,143 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 01-开发与构建.md
+ ! Doc Authors   : 曾奥然       <ccmywish@qq.com>
+ ! Contributors  : Mikachu2333  <mikachu.23333@zohomail.com>
+ !               |
+ ! Created On    : <2024-12-27>
+ ! Last Modified : <2025-10-11>
+ ! ---------------------------------------------------------- -->
+
+# 开发 chsrc
+
+## 依赖与开发环境
+
+请安装好：
+
+  1. `GCC` 或 `Clang`
+  2. [just] 或 `make`
+  3. `curl`
+  4. [rawstr4c] (可选)
+
+**我推荐你使用 VS Code 开发，你可以在一分钟内成功编译、运行和 Debug `chsrc`**
+
+  1. `Ctrl-Shift-B` 直接构建
+  2. `F5` 直接开始 Debug
+
+<br>
+
+
+
+## 获取代码
+
+**请务必使用 dev 分支开发**
+
+```bash
+git clone https://gitee.com/RubyMetric/chsrc.git -b dev
+```
+
+关于分支的说明，可参考 [./03-CONTRIBUTING.md](./03-CONTRIBUTING.md)
+
+<br>
+
+
+
+## 编译运行
+
+共有四种构建模式：
+
+1. **`DEV mode`**
+2. **`DEBUG mode`**
+3. **`RELEASE mode`**
+4. **`CI-RELEASE mode`**
+
+开发时只需要前两种模式；第四种模式只在 GitHub Actions 使用。
+
+**如果你使用 `just`，可以在 VS Code 中获得更好的体验，按 `Ctrl-Shift-B` 直接使用 DEV mode 构建**
+
+```bash
+just (b)      # 在Windows上默认使用 gcc 编译，在macOS上默认使用 clang 编译，在其他系统上默认使用 cc 编译
+just CC=clang # 使用 clang 编译
+just CC=gcc   # 使用 gcc   编译
+
+# 编译出 debug 版本: chsrc-debug
+just bd
+# 编译出 release 版本: chsrc-release
+just br
+```
+
+<br>
+
+`make` 用户:
+
+```bash
+make (b)      # 在Windows上默认使用 cc 编译，在macOS上默认使用 clang 编译，在其他系统上默认使用 cc 编译
+make CC=clang # 使用 clang 编译
+make CC=gcc   # 使用 gcc   编译
+
+# 编译出 debug 版本: chsrc-debug
+make bd
+# 编译出 release 版本: chsrc-release
+make br
+```
+
+<br>
+
+
+
+## Debug
+
+**如果你使用 `just`，可以在 VS Code 中获得更好的体验，按 F5 即可立即开始 Debug**
+
+```bash
+# 重新编译出 ./chsrc-debug，并启动 GDB 调试 (在macOS上启动 LLDB 调试)
+$ just debug
+
+# 重新编译出 ./chsrc-debug，并启动 LLDB 调试
+$ just DEBUGGER=lldb debug
+```
+
+<br>
+
+`make` 用户:
+
+```bash
+# 重新编译出 ./chsrc-debug，并启动 GDB 调试 (在macOS上启动 LLDB 调试)
+$ make debug
+
+# 重新编译出 ./chsrc-debug，并启动 LLDB 调试
+$ make debug DEBUGGER=lldb
+```
+
+<br>
+
+
+
+## 测试
+
+`just` 用户只需要替换下述 `make` 为 `just`
+
+```bash
+make test-xy  # 测试 xy.h
+make test-fw  # 测试 framework
+make test     # 测试上述两个
+make test-cli # 测试命令
+make clean
+```
+
+<br>
+
+
+
+## 提交 PR
+
+关于分支的说明以及如何提交代码，请参考 [./03-CONTRIBUTING.md](./03-CONTRIBUTING.md)
+
+<br>
+
+
+
+[rawstr4c]: https://github.com/RubyMetric/rawstr4c
+[just]: https://github.com/casey/just

doc/02-提交与贡献.md

@@ -0,0 +1,54 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 02-提交与贡献.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2024-12-13>
+ ! Last Modified : <2025-08-22>
+ ! ---------------------------------------------------------- -->
+
+# 贡献说明
+
+## 分支
+
+- `gh-build`：仅仅在发布版本时由 `@ccmywish` 推送，触发编译到 GitHub Releases 中
+- `main`: stable，代码一定是可以编译运行的，我们假设 end users 在其他条件都得不到二进制时，会自己编译这个分支来运行 `chsrc`
+- `dev`：开发分支，工作分支，在此分支上解决冲突
+
+<br>
+
+## 提交与审阅
+
+当你提交 PR 的时候，一定要将 PR 指定 chsrc 原仓库的 dev 分支。
+
+### 一个简单的 Bug
+
+一个简单的 Bug fix，有写权限的维护者可以直接推送到主仓库的 `dev` 分支
+
+<br>
+
+### 不太容易修复的 Bug 以及新功能
+
+这里要分两种情况考虑。（1）recipe 相关的 （2）framework 相关的
+
+（1）
+
+**如果你是 recipe Chef，则你完全负责这个 recipe，如果你拥有写权限，你可以直接推送代码到 `dev` 分支**
+
+---
+
+（2）
+
+1. 需要先搜索你修改的部分涉及到的 recipe，然后提 issue @ 所有相关的 recipe Chef 来 review
+2. 如果涉及了所有 recipe，则 @ framework Chef，而无需把所有 recipe 的 Chef 都喊过来，但是如果觉得有必要，可以 @ 任意你觉得有能力 review 和能给出建议的人来 review
+
+<br>
+
+### 最好总是 issue 或 PR
+
+对于有写权限的维护者来说，即使是能够直接推代码，最好也都先提 issue 或 PR，因为这样能够让大家知道代码发生了哪些变动。
+
+如果你觉得要和大家讨论，则 issue；如果你觉得没有讨论的必要了，则直接 PR 后自己立即合并即可。之所以多此一举，是因为这能够显式地记录代码的加入过程，其相当于一份文档方便未来的自己和他人查阅

doc/03-为什么拒绝使用代码格式化工具.md

@@ -0,0 +1,122 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 03-为什么拒绝使用代码格式化工具.md
+ ! Doc Authors   :  曾奥然  <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ ! Created On    : <2025-08-10>
+ ! Last Modified : <2025-08-20>
+ ! ---------------------------------------------------------- -->
+
+# chsrc 代码风格
+
+Ruby 的语法优美性在编程行业中具有标杆地位。Matz（松本行弘）提出的 **代码应该为人类而写，偶尔为机器执行** 这一理念，已经成为现代编程语言设计的重要指导原则。`chsrc` 项目的第一作者深受 **Ruby** 语言哲学的影响。
+
+本项目起源于 AI 编程尚未流行的时代，所有代码全部依赖人类的耐心来维护。现在，我们的代码以及这篇文章不仅会由人类阅读，也会由 AI 阅读。我们始终坚持：**代码的可读性和维护性是项目长期发展的根本保障**。
+
+<br>
+
+
+
+## 为什么我们坚持不使用代码格式化工具
+
+代码格式化工具（code formatter）在多人协作的代码仓库中确实有其价值，**参与的人越多，统一格式的需求越迫切**。然而，`chsrc` 项目经过深思熟虑后，拒绝使用代码格式化工具。让我来说明这一决定背后的深层原因。
+
+### 被强迫使用
+
+像 `Prettier` 这样的工具表面上带来了统一性，但其代价是什么？**它是极度专制的（opiniated）**，我们必须**完全交出代码审美的自主权**。今天我们大部分人使用 `Prettier`，**并非出于真心的认同，而是因为整个前端生态圈的集体胁迫——不用就意味着被边缘化**。
+
+这种现象的本质令人深思：**少数 `Prettier` 维护者的个人偏好，竟然决定了全球数百万开发者的代码美学标准。这显然是一种技术独裁，坚决拒绝向格式化工具的霸权低头**。
+
+<br>
+
+### 一致性 ≠ 美观 ≠ 可读
+
+格式化工具只保证了表面的一致性，就像一些校服，一致不一定代表美。同样，一致不一定代表代码就是最易读易懂的。
+
+每一个有追求的程序员都应该保留**对代码美学的最后决定权，格式化工具的便利性不应该以牺牲美观性和可维护性为代价**。
+
+<br>
+
+### 满足不了我们的需求
+
+C语言的格式化工具通常选择 `clang-format`，它的配置选项十分丰富，比 `Prettier` 要理性得多。然而，即便如此，**其配置的复杂性和局限性仍然无法满足 chsrc 对代码格式的严苛要求**。如果你是一位 `clang-format` 的配置专家，我们诚挚邀请您告诉我们如何优雅地处理以下代码场景，**也许这能改变我的立场**。
+
+<br>
+
+
+
+### 挑战案例
+
+以下是我认为自动格式化工具很难完美处理的代码场景：
+
+`=` 对齐：
+
+```c
+char *name  = va_arg (args, char*);
+char *email = va_arg (args, char*);
+```
+
+复杂逻辑的 `=` 对齐：
+
+```c
+         bool matched = iterate_menu (chsrc_pl_menu, input, &target_tmp);
+if (!matched) matched = iterate_menu (chsrc_os_menu, input, &target_tmp);
+if (!matched) matched = iterate_menu (chsrc_wr_menu, input, &target_tmp);
+```
+
+预处理指令的层次缩进：
+
+```c
+#ifdef _WIN32
+  #define XY_Build_On_Windows 1
+  #define xy_on_windows true
+  #ifdef XY_DEBUG
+    #define xy_debug_mode 1
+  #endif
+#endif
+```
+
+...... 等等
+
+<br>
+
+
+
+## C语言代码风格
+
+- 整体上基于 `GNU style`，但我们坚持自己的美学原则，在细节上有所改进
+
+- 类型名: `PascalCase_t`，即 `UpperCamelCase_t`
+
+- 函数定义和调用时，**函数名和`()`之间始终保持一个空格**，如果是在宏中，可紧凑一些，无硬性规定
+
+- 函数和函数定义之间**一般保持2个空行**
+
+    - 若函数之间有高度关联性，**可用1个空行**
+    - 若一系列函数和一系列函数存在主题性区别，**可用3个空行**
+
+<br>
+
+
+
+## Markdown 写作风格
+
+维护者很多时候不是从渲染好的界面来看 Markdown 文件的，而是阅读 Markdown 源文件，所以 Markdown 在源文件层面也要易读。
+
+我们保持每个主题之间 **1个`<br>` + 3个空行** 的简单风格。
+
+拒绝使用 VS Code 的 `markdownlint` 插件，**因为它总是用它狭隘的标准给我们增加了巨多的黄色下划线**。
+
+<br>
+
+
+
+## 其他语言代码风格
+
+我们秉承 **入乡随俗、尊重传统** 的原则，尊重每种语言社区的既定传统。比如，`YAML` 使用2个空格，`JSON`使用4个空格，`Perl` 使用 Larry Wall 钟爱的4个空格。
+
+我们使用 `.editorconfig` 来确保这些格式的应用。
+
+<br>

doc/10-如何编写recipe.md

@@ -0,0 +1,118 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 10-如何编写recipe.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2024-08-19>
+ ! Last Modified : <2025-10-28>
+ ! ---------------------------------------------------------- -->
+
+# Write A Recipe Even If You Don't Know C
+
+## 介绍
+
+**`chsrc` 不仅是一个命令行工具，同时也是一个体现了 Ruby on Rails 思想的 MVC 换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。**
+
+<br>
+
+我鼓励你为新的软件添加换源支持，因为通过 `chsrc` 框架，这将比写 shell 脚本更加轻松，你的贡献也将非常有价值。理论上每一个 `recipe` 都需要有专人长时间维护 ([招募](https://github.com/RubyMetric/chsrc/issues/275))。
+
+- 本项目采用 `GPLv3+` 协议，是真正的**自由软件**，而非仅仅是开源软件
+- 代码规范灵活遵循 `GNU` 标准（若标准干扰了可维护性，则并不采纳）
+- 高度模块化，目录结构清晰易懂
+- 极小依赖，极易构建，只需要 `GCC` 或 `Clang` 即可编译 (`make` 和 `just`可简化编译，但不是必需的)
+- 易于将 `shell` 脚本转换为等价的 `recipe`
+- 已有大量 `recipe` 可提供参考，并提供了 [recipe template] 供直接使用
+- 本仓库外的子项目 [rawstr4c] 帮助你在C语言中维护复杂的字符串
+- [chsrc-bootstrap] 帮助你在没有预编译 `chsrc` 的平台上 bootstrap 自己
+
+<br>
+
+成功案例:
+
+- [Armbian](../src/recipe/os/APT/Armbian.c)
+- [uv](../src/recipe/lang/Python/uv.c)
+
+<br>
+
+## 基本概念
+
+- `target`: 所要换源的目标
+- `target group`: 一个 `target` 包含了多个子 `target`，比如 `Python group` 包含了该语言的多个包管理器
+
+- `category`: 是 `target category` 的简写，即 `target` 所属的类别，可以是 **编程语言**，**操作系统**，**软件** 三类之一
+
+    1. 在目录中，三者分别为 `lang`, `os`, `ware`
+    2. 在代码中，三者前缀分别为 `pl`, `os`, `wr`
+
+- `mirror`: 是 `mirror site` 的简写，指镜像站，如清华大学开源软件镜像站
+- `source`: 该 `target` 所能换的具体的源，由 `mirror` 提供服务，往往一个 `mirror` 会提供许多 `source`
+- `recipe`: 是为一个 `target` 定义的具体换源方法，请参考 `src` 目录中的 `recipe` 目录
+
+- `chef DSL`：是 `chef Domain Specific Language` 的简写，这是一组以 `chef_` 开头的函数，用来定义维护者信息、可用源等元信息
+
+- **换源链接**: 指镜像站所提供的某一个具体的换源使用的URL
+- **测速链接**: 用来测速的URL，与 "换源链接" 不同，可分为 **精准测速** 和 **模糊测速**
+
+- **镜像源**: 为了方便，**偶尔**我们将直接称`mirror`和/或`source`为**镜像源**，这只是一种方便性的称呼，可以统称二者，也可以根据上下文指代二者之一
+
+<br>
+
+## 编写 `recipe` 步骤
+
+1. 确定你要编写的 `target` 的标准名称，创建 `Target-Name.c` 文件
+
+    大小写需严格按官方，若名称包含空格，需使用 `-` 代替空格
+
+2. 根据类别将上述文件放在 `recipe/` 目录的某个子目录中
+
+3. 复制 [recipe template] 的内容到上述文件中，并替换 `<...>` 占位符
+
+4. 参考现有 `recipe` 的写法
+
+    1. 看一眼就能上手的参照物是 [PHP recipe](../src/recipe/lang/PHP.c)
+    2. 最好的参照物是 [Ruby recipe](../src/recipe/lang/Ruby/Ruby.c)
+    3. 组换源参照物是 [Python group recipe](../src/recipe/lang/Python/Python.c)
+
+5. 在 [Wiki] 中记录的镜像站中寻找可用源；可以额外补充镜像站
+
+6. 使用 chef DSL 定义 `_prelude()` 函数
+
+    该函数将填充 target 所有的必要信息，包括维护信息、换源信息
+
+7. [设置/修改 "换源链接" 和 "测速链接" (how?)](./11-如何设置换源链接与测速链接.md)
+
+8. 按需实现 `_setsrc()` `_getsrc()` `_resetsrc()`， 可以使用这些函数:
+
+    1. `framework/core.c` 中以 `chsrc_` 开头的所有函数或宏
+    2. `xy.h` 中以 `xy_` 开头的所有函数或宏
+    3. `chec.c` 中以 `chef_` 开头的所有函数或宏
+    4. `helper.c` 中以 `hp_` 开头的所有函数或宏
+
+    一个简单的方法是，在 VS Code 中按快捷键 `Ctrl-T` 搜索上述三种前缀
+
+9. 在 `recipe/menu.c` 中登记此 target
+
+10. [编译、运行、测试 (how?)](./01-开发与构建.md)，若无问题可提交 Pull Request
+
+<br>
+
+## 开发准则
+
+1. 代码高度可移植
+
+2. Convention over Configuration
+
+3. [NO UFO 原则: 不要乱丢文件到$HOME等目录，尤其是使用各种隐晦的文件名](https://www.yuque.com/ccmywish/blog/no-ufo)
+
+    `chsrc` 主程序不提供配置文件，不提供数据文件，干净无污染。那么在实现 `recipe` 的时候，除了备份文件外，也不要污染用户环境。
+
+<br>
+
+[rawstr4c]: https://github.com/RubyMetric/rawstr4c
+[chsrc-bootstrap]: ../bootstrap/
+[recipe template]: ../src/recipe/recipe-template.c
+[Wiki]: https://github.com/RubyMetric/chsrc/wiki

doc/11-如何设置换源链接与测速链接.md

@@ -0,0 +1,63 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 11-如何设置换源链接与测速链接.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2025-08-11>
+ ! Last Modified : <2025-08-11>
+ ! ---------------------------------------------------------- -->
+
+# 新增/修改 "换源链接"
+
+在 `_prelude()` 函数中，在 `def_sources_begin()` 的位置的**第二列**，新增/修改你想要替换的链接。
+
+**注: 以下代码仅起解释作用，JavaScript换源的真正实现可能不同**
+
+```c
+def_sources_begin()
+{&UpstreamProvider, "https://registry.npmjs.org/",                     FeedByPrelude},
+{&NpmMirror,        "https://registry.npmmirror.com",                  FeedByPrelude},
+{&Huawei,           "https://mirrors.huaweicloud.com/repository/npm/", FeedByPrelude},
+{&Tencent,          "https://mirrors.cloud.tencent.com/npm/",          FeedByPrelude},
+{&某新镜像站,       "某镜像站提供的换源链接"，                         FeedByPrelude}
+def_sources_end()
+```
+
+<br>
+
+
+# 设置/修改 "测速链接"
+
+在 `_prelude()` 函数中，在 `def_sources_begin()` 的位置的**第三列**，设置/修改你想要替换的链接。
+
+1. 在下面代码的第一行中，我们直接给了一个链接，**这就是精准测速链接**
+2. 在下面代码的第二行和第三行中，我们都设置了一个宏 `DelegateToMirror`，这意味着我们没有直接提供精准测速链接，而是让 `chsrc` 去测试其对应镜像站定义的测速链接
+
+    - `NpmMirror` 是专用镜像站，所以其测速链接被设置为了 `ACCURATE`，即精准测速
+    - `Huawei` 是通用镜像站，所以其测速链接被设置为了 `ROUGH `，即模糊测速
+
+3. 在下面代码的第四行中，我们设置了一个宏 `FeedByPrelude`，这意味着我们将在 `_prelude()` 函数的后续动态计算 URL
+
+**注: 以下代码仅起解释作用，JavaScript换源的真正实现可能不同**
+
+```c
+def_sources_begin()
+{&UpstreamProvider, "https://registry.npmjs.org/",                     "https://registry.npmjs.org/BigFile.tar.gz"},
+{&NpmMirror,        "https://registry.npmmirror.com",                  DelegateToMirror},
+{&Huawei,           "https://mirrors.huaweicloud.com/repository/npm/", DelegateToMirror},
+{&Tencent,          "https://mirrors.cloud.tencent.com/npm/",          FeedByPrelude},
+def_sources_end()
+
+// 把所有上述源的 "测速链接" 设置为 "换源链接" + postfix
+chef_set_sources_speed_measure_url_with_postfix (this, "/dir/BigFile.tar.gz");
+// 基于 "换源链接" 做更自定义的操作
+chef_set_sources_speed_measure_url_with_func (this, func, data);
+
+// 调整某一个镜像站(Provider)的 "测速链接"
+chef_set_provider_speed_measure_url (&Tencent, "https://mirrors.cloud.tencent.com/npm/BigFile.tar.gz")
+// 调整某一个镜像站(Provider)的 "测速精度"
+chef_set_provider_speed_measure_accuracy (&UpstreamProvider, ROUGH);;
+```

doc/50-协作者与维护者.md

@@ -0,0 +1,34 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : 50-协作者与维护者.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2024-12-06>
+ ! Last Modified : <2025-08-22>
+ ! ---------------------------------------------------------- -->
+
+# 协作者与维护者
+
+想要达到最理想的维护状态，每一个 recipe 都需要有专人长时间维护。**我们的代码里使用了 recipe (某个菜的烹饪方法) 这个词，因而整个项目便和 "饮食" 有关，比如 `menu`: 汇集了所有的 target 的菜单。因此，我们的维护者和贡献者身份依然使用了这个惯例：**
+
+1. **Chef**
+
+    品控 (主厨): 对一个 recipe 完全负责，有写权限时可以直接推代码
+
+    **目前项目的发展阶段还处于 *外行实现内行* 的情况，比如 Homebrew recipe，实现者根本不是 Homebrew 的真实用户，只是根据各种文档来实现，然后等待用户反馈。所以这里当前的实现者最多只能是 Cook，无法承担 Chef 的责任**
+
+2. **Cook**
+
+    掌勺：一个 recipe 的主要作者
+
+3. **Saucier**
+
+    调味：一个 recipe 的次要贡献者 (除主要作者外的其他人)
+
+<br>
+
+**Chef 采用申请制，每个 recipe 仅有1人，请提交 PULL REQUEST 在对应的 recipe 文件中添加自己，并在 [issue #275
+](https://github.com/RubyMetric/chsrc/issues/275) 留言。**

doc/README.md

@@ -0,0 +1,45 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : (Document Introduction.md)
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nul None <nul@none.org>
+ !               |
+ ! Created On    : <2024-12-27>
+ ! Last Modified : <2025-08-22>
+ ! ---------------------------------------------------------- -->
+
+# 文档说明
+
+E2E (End-to-End) 开发文档:
+
+- 开发环境准备，如何编译和测试，请参考 [01-开发与构建.md](./01-开发与构建.md)
+- 直接推送还是提交 PR，请参考 [02-提交与贡献.md](./02-提交与贡献.md)
+- 代码风格，请参考 [03-为什么拒绝使用代码格式化工具.md](./03-为什么拒绝使用代码格式化工具.md)
+
+<br>
+
+具体 recipe 相关:
+
+- 如何编写一个具体的 recipe，请参考 [10-如何编写recipe.md](./10-如何编写recipe.md)
+- 如何修改换源链接、模糊/精准测速链接，请参考 [11-如何设置换源链接与测速链接.md](./11-如何设置换源链接与测速链接.md)
+
+<br>
+
+- 关于维护者身份的说明，请参考 [50-协作者与维护者.md](./50-协作者与维护者.md)
+
+<br>
+
+用户手册：
+
+1. [chsrc.1](./chsrc.1)
+2. [chsrc.texi](./chsrc.texi)
+
+<br>
+
+## 贡献指导
+
+若有任何问题，可在 [GitHub discussions](https://github.com/RubyMetric/chsrc/discussions) 中询问和讨论
+
+<br>

doc/Write-A-Recipe-Even-If-You-Dont-Know-C.md

@@ -1,97 +0,0 @@
-<!-- -----------------------------------------------------------
- ! SPDX-License-Identifier: GFDL-1.3-or-later
- ! -------------------------------------------------------------
- ! Doc Type      : Markdown
- ! Doc Authors   : Aoran Zeng <ccmywish@qq.com>
- ! Contributors  :  Nul None  <nul@none.org>
- !               |
- ! Created On    : <2024-08-19>
- ! Last Modified : <2024-09-10>
- ! ---------------------------------------------------------- -->
-
-# Write A Recipe Even If You Don't Know C
-
-# 介绍
-
-**`chsrc` 不仅是一个命令行工具，同时也是一个换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。**
-
-<br>
-
-我鼓励你为新的软件添加换源支持，因为通过 `chsrc` 这将非常简单，你的贡献也将非常有价值。
-
-1. 本项目采用`GPLv3+`协议，是真正的**自由软件**，而非仅仅是开源软件
-2. 代码规范灵活遵循`GNU`标准（若标准干扰了可维护性，则并不采纳）
-3. 高度模块化，目录结构清晰易懂
-4. 极易构建，仅有一个C语言编译器即可
-5. 易于将`shell`脚本转换为等价的`recipe`
-6. 已有大量`recipe`可提供参考，并提供了 [recipe template] 供直接使用
-7. 提供持续关注镜像站可用性的协作平台:
-
-    1. https://github.com/RubyMetric/chsrc/wiki
-    2. https://github.com/RubyMetric/chsrc/discussions
-
-<br>
-
-成功案例: [Armbian](../src/recipe/os/APT/Armbian.c)
-
-<br>
-
-# 贡献指导
-
-若有任何问题，可在 [GitHub discussions](https://github.com/RubyMetric/chsrc/discussions) 中询问和讨论
-
-<br>
-
-# 基本概念
-
-1. `target`: 所要换源的目标
-
-2. `category`: 是 `target category` 的简写，即 `target` 所属的类别，可以是 **编程语言**，**操作系统**，**软件** 三类之一
-
-    1. 在目录中，三者分别为 `lang`, `os`, `ware`
-    2. 在代码中，三者前缀分别为 `pl`, `os`, `wr`
-
-2. `mirror`: 是 `mirror site` 的简写，指镜像站，如清华大学开源软件镜像站
-3. `source`: 该 `target` 所能换的具体的源，由 `mirror` 提供服务
-4. `recipe`: 是为一个 `target` 定义的具体换源方法，请参考 `src` 目录中的 `recipe` 目录
-
-5. `feature`: 一个 `target` 可以支持的功能，比如能否重置回默认上游源等
-
-<br>
-
-# 编写recipe步骤
-
-1. 务必使用 `dev` 分支
-
-2. 在 `recipe` 目录中根据类别添加新文件，该文件可基于其它 `recipe` 或 [recipe template]
-
-3. 最好的参照物是 [ruby.c recipe](../src/recipe/lang/Ruby.c)
-
-4. 在各大镜像站寻找可用源；可以额外补充镜像站
-
-    并创建或更新对应 `target` 的镜像站可用状态Wiki页: https://github.com/RubyMetric/chsrc/wiki
-
-5. 可以使用这些函数:
-
-    1. `chsrc.h` 中暴露出的任何 `chsrc_` 开头的函数或宏
-    2. `xy.h` 中以 `xy_` 开头的所有函数或宏
-
-6. 在 `menu.c` 中添加用户可以使用的 `target` 别名
-
-7. 构建并运行 `chsrc set <target>` 测试，若无问题可提交 Pull Request
-
-<br>
-
-# 开发准则
-
-1. 代码高度可移植
-
-2. Convention over Configuration
-
-3. [NO UFO 原则: 不要乱丢文件到$HOME等目录，尤其是使用各种隐晦的文件名](https://www.yuque.com/ccmywish/blog/no-ufo)
-
-    `chsrc` 主程序不提供配置文件，不提供数据文件，干净无污染。那么在实现 `recipe` 的时候，除了备份文件外，也不要污染用户环境。
-
-<br>
-
-[recipe template]: ../src/recipe/template.c

doc/chsrc.1

@@ -2,14 +2,14 @@
 .\" SPDX-License-Identifier: GFDL-1.3-or-later
 .\" --------------------------------------------------------------
 .\" Doc Type      : Man Page
-.\" Doc Authors   : Aoran Zeng <ccmywish@qq.com>
-.\" Contributors  :  Nul None  <nul@none.org>
+.\" Doc Authors   : 曾奥然 <ccmywish@qq.com>
+.\" Contributors  : Nul None <nul@none.org>
 .\"               |
 .\" Created On    : <2024-08-21>
-.\" Last Modified : <2024-09-04>
-.\" --------------------------------------------------------------
+.\" Last Modified : <2025-10-29>
+.\" ----------------------------------------------------------------
 
-.TH  chsrc  1  "2024-09-04"  "v0.1.8.1dev2"  "RubyMetric chsrc"
+.TH  chsrc  1  "2025-10-29"  "v0.2.3.1"  "RubyMetric chsrc"
 
 .SH NAME
 chsrc - Change Source for every software on every platform from the command line
@@ -62,7 +62,7 @@ chsrc - Change Source for every software on every platform from the command line
 .B set \fI<target>\fR \fI<mirror>\fR
 换源，指定使用某镜像站 (通过list <target>查看)
 .TP
-.B set \fI<target>\fR \fU<https://url>\fR
+.B set \fI<target>\fR \fI<https://url>\fR
 换源，用户自定义源URL
 .TP
 .B reset \fI<target>\fR
@@ -75,9 +75,6 @@ chsrc - Change Source for every software on every platform from the command line
 \fB-dry\fR
 Dry Run，模拟换源过程，命令仅打印并不运行
 .TP
-\fB-para(llel)\fR
-并行测速 (默认的顺序测速更有参考意义)
-.TP
 \fB-local\fR
 仅对本项目而非全局换源 (通过ls \fI<target>\fR查看支持情况)
 .TP
@@ -124,7 +121,7 @@ $ chsrc set ruby
 $ chsrc ls  ruby
 $ chsrc set ruby rubychina
 
-# 如果您有自己的镜像地址，使用自定义URL
+# 可以使用自定义URL
 $ chsrc set ruby https://gems.ruby-china.com/
 
 # 使用维护团队测试的最快镜像站
@@ -151,7 +148,7 @@ On Gitee:  https://gitee.com/RubyMetric/chsrc/issues
 On GitHub: https://github.com/RubyMetric/chsrc/issues
 
 .SH COPYRIGHT
-Copyright (C) 2024 Aoran Zeng, Heng Guo.
+Copyright (C) 2025 Aoran Zeng, Heng Guo.
 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
 .br
 This is free software: you are free to change and redistribute it.

doc/chsrc.texi

@@ -2,29 +2,29 @@
 @c SPDX-License-Identifier: GFDL-1.3-or-later
 @c --------------------------------------------------------------
 @c Doc Type      : Texinfo
-@c Doc Authors   : Aoran Zeng <ccmywish@qq.com>
-@c Contributors  :  Nul None  <nul@none.org>
+@c Doc Authors   : 曾奥然 <ccmywish@qq.com>
+@c Contributors  : Nul None <nul@none.org>
 @c               |
 @c Created On    : <2024-08-22>
-@c Last Modified : <2024-09-04>
+@c Last Modified : <2025-10-29>
 @c --------------------------------------------------------------
 
 \input texinfo
 @setfilename chsrc.info
 @settitle chsrc
 
-@set Chsrc_Version v0.1.8.1dev2
-@set Doc_Publish_Date 2024-09-04
+@set Chsrc_Version v0.2.3.1
+@set Doc_Publish_Date 2025-10-29
 
 @copying
 @comment 这是软件copyright，不是文档copyright，因此不放在titlepage
-Copyright @copyright{} 2024 Aoran Zeng, Heng Guo
+Copyright @copyright{} 2025 曾奥然, 郭恒
 @end copying
 
 @titlepage
 @title chsrc printed manual
 @subtitle Change Source everywhere for every software!
-@author Aoran Zeng
+@author 曾奥然
 @c @insertcopying
 For chsrc @value{Chsrc_Version}
 @page
@@ -134,9 +134,6 @@ Exit status:
 @item -dry
 Dry Run，模拟换源过程，命令仅打印并不运行
 
-@item -para(llel)
-并行测速 (默认的顺序测速更有参考意义)
-
 @item -ipv6
 使用IPv6测速
 
@@ -163,7 +160,7 @@ $ chsrc set ruby
 $ chsrc ls  ruby
 $ chsrc set ruby rubychina
 
-# 如果您有自己的镜像地址，使用自定义URL
+# 可以使用自定义URL
 $ chsrc set ruby https://gems.ruby-china.com/
 
 # 使用维护团队测试的最快镜像站

doc/image/chsrc.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 500 500" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g>
+        <path d="M13.392,207.176L130.909,79.868L369.203,79.868L486.608,207.055L486.608,210.821L255.801,459.814L244.311,459.814L13.392,210.7L13.392,207.176ZM250.056,118.434C186.007,118.434 134.008,170.433 134.008,234.482C134.008,298.53 186.007,350.53 250.056,350.53C314.104,350.53 366.104,298.53 366.104,234.482C366.104,170.433 314.104,118.434 250.056,118.434Z" style="fill:#a52019;"/>
+        <path d="M189.09,222.379C183.346,222.379 178.683,217.716 178.683,211.972C178.683,209.1 179.849,206.498 181.733,204.614L204.205,182.142C204.253,182.092 204.302,182.042 204.351,181.993C208.413,177.931 215.007,177.931 219.069,181.993C223.131,186.055 223.131,192.649 219.069,196.711C219.02,196.76 218.97,196.808 218.921,196.856L214.212,201.565L312.183,201.565C317.927,201.565 322.59,206.228 322.59,211.972C322.59,217.716 317.927,222.379 312.183,222.379L189.09,222.379Z" style="fill:#a52019;"/>
+        <path d="M311.547,245.378C317.29,245.378 321.954,250.042 321.954,255.785C321.954,258.657 320.788,261.259 318.904,263.143L296.431,285.616C296.383,285.665 296.335,285.715 296.286,285.764C292.224,289.826 285.629,289.826 281.568,285.764C277.506,281.703 277.506,275.108 281.568,271.046C281.617,270.997 281.666,270.949 281.716,270.901L286.424,266.193L188.453,266.193C182.71,266.193 178.046,261.529 178.046,255.785C178.046,250.042 182.71,245.378 188.453,245.378L311.547,245.378Z" style="fill:#a52019;"/>
+    </g>
+</svg>

include/source.h

@@ -1,170 +0,0 @@
-/** ------------------------------------------------------------
- * SPDX-License-Identifier: GPL-3.0-or-later
- * -------------------------------------------------------------
- * File Authors  : Aoran Zeng    <ccmywish@qq.com>
- *               | Heng Guo      <2085471348@qq.com>
- * Contributors  : Shengwei Chen <414685209@qq.com>
- *               |
- * Created on    : <2023-08-29>
- * Last modified : <2024-08-23>
- *
- * 镜像站与换源信息
- * ------------------------------------------------------------*/
-
-typedef struct MirrorSite_t {
-  const char *code; // 用于用户指定镜像站
-  const char *abbr; // 需要使用镜像站的英文名时，用这个代替，因为大部分镜像站没有提供正式的英文名
-  const char *name; // 镜像站中文名
-  const char *site;
-  const char *__bigfile_url;  // 用于对该镜像站测速
-} MirrorSite;
-
-// #define Big_File_ubuntu  "/indices/md5sums.gz"  这个是错的
-#define Big_File_ctan       "/systems/texlive/Images/texlive.iso"           // 4.8GB
-#define Big_File_debian     "/ls-lR.gz"                                     // 13.9 MB
-#define Big_File_archlinux  "/iso/latest/archlinux-x86_64.iso"              // 800MB 左右
-#define Big_File_deepin     "/20.9/deepin-desktop-community-20.9-amd64.iso" // 4GB左右
-
-
-/**
- * 教育网镜像
- *
- * 我们目前根据 https://github.com/mirrorz-org/oh-my-mirrorz 挑选速度前10位
- */
-MirrorSite
-MirrorZ       = {"mirrorz", "MirrorZ",       "MirrorZ 校园网镜像站",     "https://mirrors.cernet.edu.cn/",  NULL},
-
-Tuna          = {"tuna",    "TUNA",          "清华大学开源软件镜像站",     "https://mirrors.tuna.tsinghua.edu.cn/",
-                 "https://mirrors.tuna.tsinghua.edu.cn/speedtest/1000mb.bin"},
-
-Sjtug_Zhiyuan = {"sjtu",    "SJTUG-zhiyuan", "上海交通大学致远镜像站",     "https://mirrors.sjtug.sjtu.edu.cn/",
-                 "https://mirrors.sjtug.sjtu.edu.cn/ctan" Big_File_ctan},
-
-Zju           = {"zju",     "ZJU",           "浙江大学开源软件镜像站",     "https://mirrors.zju.edu.cn/",
-                 "https://mirrors.zju.edu.cn/debian" Big_File_debian},
-
-Lzuoss        = {"lzu",     "LZUOSS",        "兰州大学开源社区镜像站",     "https://mirror.lzu.edu.cn/",
-                 "https://mirror.lzu.edu.cn/CTAN" Big_File_ctan},
-
-Jlu           = {"jlu",     "JLU",           "吉林大学开源镜像站",         "https://mirrors.jlu.edu.cn/",
-                 "https://mirrors.jlu.edu.cn/_static/speedtest.bin"},
-
-Bfsu          = {"bfsu",    "BFSU",          "北京外国语大学开源软件镜像站","https://mirrors.bfsu.edu.cn/",
-                 "https://mirrors.bfsu.edu.cn/speedtest/1000mb.bin"},
-
-Pku           = {"pku",     "PKU",           "北京大学开源镜像站",         "https://mirrors.pku.edu.cn/",
-                 "https://mirrors.pku.edu.cn/debian" Big_File_debian},
-
-Bjtu          = {"bjtu",    "BJTU",          "北京交通大学自由与开源软件镜像站", "https://mirror.bjtu.edu.cn/",
-                 "https://mirror.bjtu.edu.cn/archlinux" Big_File_archlinux},
-
-Sustech       = {"sustech", "SUSTech",       "南方科技大学开源软件镜像站",  "https://mirrors.sustech.edu.cn/",
-                 "https://mirrors.sustech.edu.cn/site/speedtest/1000mb.bin"},
-
-Ustc          = {"ustc",    "USTC",          "中国科学技术大学开源镜像站",  "https://mirrors.ustc.edu.cn/",
-                 "https://mirrors.ustc.edu.cn/CTAN" Big_File_ctan},
-
-Hust          = {"hust",    "HUST",          "华中科技大学开源镜像站",     "https://mirrors.hust.edu.cn/",
-                 "https://mirrors.hust.edu.cn/debian" Big_File_debian},
-
-// 速度暂时处于10位以后，但是目前可用的源
-Nju           = {"nju",     "NJU",           "南京大学开源镜像站",         "https://mirrors.nju.edu.cn/",
-                 "https://mirrors.nju.edu.cn/archlinux" Big_File_archlinux};
-
-/**
- * @note by:ccmywish {
- *   [2023-09-05] 我只使用了不到5次，重庆大学镜像站就把我的ip封杀了，对用户来说封杀策略过严，暂时不可靠，暂时不用
- * }
- */
-//  Cqu       = {"cqu",     "CQU",           "重庆大学开源软件镜像站",     "https://mirrors.cqu.edu.cn/",
-//               "https://mirrors.cqu.edu.cn/speedtest/1000mb.bin"};
-
-
-
-/**
- * 商业公司提供的源
- *
- * @warning 腾讯软件源中，有很多链接都已失效，请仔细检查
- */
-MirrorSite
-  Ali      = {"ali",     "Ali OPSX", "阿里巴巴开源镜像站",  "https://developer.aliyun.com/mirror/",
-              "https://mirrors.aliyun.com/deepin-cd" Big_File_deepin},
-
-  Tencent  = {"tencent", "Tencent",  "腾讯软件源",         "https://mirrors.tencent.com/",
-              "https://mirrors.cloud.tencent.com/debian" Big_File_debian},
-
-  Huawei   = {"huawei",  "Huawei Cloud", "华为开源镜像站",  "https://mirrors.huaweicloud.com/",
-              "https://mirrors.huaweicloud.com/debian" Big_File_debian },
-
-  Volcengine = {"volc",  "Volcengine",   "火山引擎开源软件镜像站", "https://developer.volcengine.com/mirror/",
-              "https://mirrors.volces.com/debian" Big_File_debian },
-
-  Netease  = {"netease", "Netease",  "网易开源镜像站",      "https://mirrors.163.com/",
-              "https://mirrors.163.com/deepin-cd" Big_File_deepin},
-
-  Sohu     = {"sohu",    "SOHU",     "搜狐开源镜像站",      "https://mirrors.sohu.com/",
-              "https://mirrors.sohu.com/deepin-cd" Big_File_deepin};
-
-
-MirrorSite
-  Upstream = {"upstream",     "Upstream",     "上游默认源",     NULL,     NULL};
-MirrorSite
-  UserDefine = {"user",       "用户自定义",     "用户自定义",     NULL,     NULL};
-
-
-typedef struct SourceInfo_t {
-  const MirrorSite *mirror;
-  const char *url;
-} SourceInfo;
-
-#define def_sources_n(t) const size_t t##_sources_n = xy_arylen(t##_sources)
-
-enum StatusCan {
-  CanNot,
-  CanFully,
-  CanSemi
-};
-
-/* Target Feature Info */
-typedef struct FeatInfo_t {
-  bool can_get;
-  bool can_reset;       // 有的reset不是暂时没有实现，而是现在的实现根本就无法重置
-
-  bool can_english;
-
-  bool can_user_define; // 用户自定义换源URL
-
-  enum StatusCan stcan_locally;
-  char *locally;
-
-  char *note;
-} FeatInfo;
-
-/* Target Info */
-typedef struct TargetInfo_t {
-  void (*getfn)   (char *option);
-  void (*setfn)   (char *option);
-  void (*resetfn) (char *option);
-
-  FeatInfo (*featfn)  (char *option);
-
-  SourceInfo *sources;
-  size_t      sources_n;
-} TargetInfo;
-
-
-#define def_target_inner_s(t)    NULL,       t##_setsrc, NULL,         NULL
-#define def_target_inner_gs(t)   t##_getsrc, t##_setsrc, NULL,         NULL
-#define def_target_inner_gsr(t)  t##_getsrc, t##_setsrc, t##_resetsrc, NULL
-#define def_target_inner_gsf(t)  t##_getsrc, t##_setsrc, NULL,         t##_feat
-#define def_target_inner_gsrf(t) t##_getsrc, t##_setsrc, t##_resetsrc, t##_feat
-
-#define def_target_sourcesn(t)   t##_sources, t##_sources_n
-
-// 大部分target还不支持reset，所以暂时先默认设置为NULL来过渡
-#define def_target(t)      TargetInfo t##_target = {def_target_inner_gs(t),def_target_sourcesn(t)}
-#define def_target_gs(t)   TargetInfo t##_target = {def_target_inner_gs(t),def_target_sourcesn(t)}
-#define def_target_gsr(t)  TargetInfo t##_target = {def_target_inner_gsr(t),def_target_sourcesn(t)}
-#define def_target_gsf(t)  TargetInfo t##_target = {def_target_inner_gsf(t),def_target_sourcesn(t)}
-#define def_target_gsrf(t) TargetInfo t##_target = {def_target_inner_gsrf(t),def_target_sourcesn(t)}
-#define def_target_s(t)    TargetInfo t##_target = {def_target_inner_s(t),def_target_sourcesn(t)}

include/xy.h

@@ -1,773 +0,0 @@
-/** ------------------------------------------------------------
- * Copyright © 2023-2024 Aoran Zeng, Heng Guo
- * SPDX-License-Identifier: MIT
- * -------------------------------------------------------------
- * Lib Name      : xy.h
- * Lib Authors   : Aoran Zeng <ccmywish@qq.com>
- *               |  Heng Guo  <2085471348@qq.com>
- * Contributors  :  Nil Null  <nil@null.org>
- *               |
- * Created On    : <2023-08-28>
- * Last Modified : <2024-08-23>
- *
- * xy: 襄阳、咸阳
- * Corss-Platform C utilities for CLI applications in Ruby flavor
- * ------------------------------------------------------------*/
-
-#ifndef XY_H
-#define XY_H
-
-#define _XY_Version      "v0.1.4.2-2024/08/23"
-#define _XY_Maintain_URL "https://gitee.com/RubyMetric/chsrc/blob/main/include/xy.h"
-
-#include <assert.h>
-#include <stdarg.h>
-#include <stdbool.h>
-#include <stddef.h>
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <unistd.h>
-
-/* Global */
-bool xy_enable_color = true;
-
-// #define NDEBUG
-
-#ifdef _WIN32
-  #define XY_On_Windows 1
-  #define xy_on_windows true
-  #define xy_on_linux false
-  #define xy_on_macos false
-  #define xy_on_bsd false
-  #define xy_os_devnull "nul"
-  #include <windows.h>
-  #define xy_useutf8() SetConsoleOutputCP (65001)
-
-#elif defined(__linux__) || defined(__linux)
-  #define XY_On_Linux 1
-  #define xy_on_windows false
-  #define xy_on_linux true
-  #define xy_on_macos false
-  #define xy_on_bsd false
-  #define xy_os_devnull "/dev/null"
-  #define xy_useutf8()
-
-#elif defined(__APPLE__)
-  #define XY_On_macOS 1
-  #define xy_on_windows false
-  #define xy_on_linux false
-  #define xy_on_macos true
-  #define xy_on_bsd false
-  #define xy_os_devnull "/dev/null"
-  #define xy_useutf8()
-
-#elif defined(__OpenBSD__) || defined(__NetBSD__) || defined(__FreeBSD__)
-  #define XY_On_BSD 1
-  #define xy_on_windows false
-  #define xy_on_linux false
-  #define xy_on_macos false
-  #define xy_on_bsd true
-  #define xy_os_devnull "/dev/null"
-  #define xy_useutf8()
-#endif
-
-void putf (double n)         { printf ("%f\n", n);   }
-void puti (long long n)      { printf ("%lld\n", n); }
-void putb (bool n)           { if (n) puts ("true"); else puts ("false"); }
-void print (const char *s)   { printf ("%s", s);  }
-void println (const char *s) { printf ("%s\n", s);}
-void say (const char *s)     { printf ("%s\n", s);}
-void br ()                   { puts ("");}
-
-#define assert_str(a, b) assert (xy_streql ((a), (b)))
-
-#define xy_unsupport   assert(!"Unsuppoted")
-#define xy_unimplement assert(!"Unimplemented temporarily")
-#define xy_unreach     assert(!"This code shouldn't be reached")
-
-#define xy_arylen(x) (sizeof (x) / sizeof (x[0]))
-
-static inline void *
-xy_malloc0 (size_t size)
-{
-  void *ptr = malloc (size);
-  memset (ptr, 0, size);
-  return ptr;
-}
-
-
-/******************************************************
- *                      String
- ******************************************************/
-
-/**
- * 将str中所有的pat字符串替换成replace，返回一个全新的字符串
- */
-static char *
-xy_str_gsub (const char *str, const char *pat, const char *replace)
-{
-  size_t replace_len = strlen (replace);
-  size_t pat_len = strlen (pat);
-
-  int unit = replace_len - pat_len;
-  if (unit <= 0)
-    unit = 0;
-
-  size_t len = strlen (str);
-
-  const char *cur = str;
-  int count = 0;
-
-  while (cur < str + len)
-    {
-      char *fnd = strstr (cur, pat);
-      if (fnd)
-        {
-          count++;
-          cur = fnd + pat_len;
-        }
-      else
-        break;
-    }
-  // puti(count); DEBUG 匹配次数
-
-  char *ret = malloc (unit * count + len + 1);
-  char *retcur = ret;
-
-  cur = str;
-  while (cur < str + len)
-    {
-      char *fnd = strstr (cur, pat);
-      if (fnd)
-        {
-          ptrdiff_t diff = fnd - cur;
-          strncpy (retcur, cur, diff);
-          cur = fnd + pat_len;
-
-          retcur += diff;
-          strcpy (retcur, replace);
-          retcur += replace_len;
-        }
-      else
-        break;
-    }
-  strcpy (retcur, cur);
-
-  return ret;
-}
-
-static char *
-xy_2strjoin (const char *str1, const char *str2)
-{
-  size_t len = strlen (str1);
-  size_t size = len + strlen (str2) + 1;
-  char *ret = malloc (size);
-  strcpy (ret, str1);
-  strcpy (ret + len, str2);
-  return ret;
-}
-
-static char *
-xy_strjoin (unsigned int count, ...)
-{
-  size_t al_fixed = 128;
-  char *ret = calloc (1, al_fixed);
-  // 已分配次数
-  int al_times = 1;
-  // 当前已分配量
-  size_t al_cur = al_fixed;
-
-  const char *str = NULL;
-  // 需要分配的量
-  size_t al_need = 0;
-  // 用于 strcpy() 到 ret 的哪个位置
-  char *cur = ret + 0;
-
-  va_list args;
-  va_start (args, count);
-
-  for (int i = 0; i < count; i++)
-    {
-      // 是否需要重新分配
-      bool need_realloc = false;
-
-      str = va_arg (args, const char *);
-      al_need += strlen (str);
-      while (al_need > al_cur)
-        {
-          al_times += 1;
-          al_cur = al_times * al_fixed;
-          need_realloc = true;
-        }
-      // printf("al_times %d, al_need %zd, al_cur %zd\n", al_times, al_need,
-      // al_cur);
-      if (need_realloc)
-        {
-          ptrdiff_t diff = cur - ret;
-          ret = realloc (ret, al_cur);
-          cur = ret + diff;
-        }
-      if (NULL == ret)
-        {
-          fprintf (stderr, "xy.h: No availble memory!");
-          return NULL;
-        }
-      strcpy (cur, str);
-      // puts(ret);
-      cur += strlen (str);
-    }
-  va_end (args);
-
-  *cur = '\0';
-  return ret;
-}
-
-static char *
-xy_strdup (const char *str)
-{
-  size_t len = strlen (str);
-  char *new = xy_malloc0 (len + 1);
-  strcpy (new, str);
-  return new;
-}
-
-#define _XY_Str_Bold      1
-#define _XY_Str_Faint     2
-#define _XY_Str_Italic    3
-#define _XY_Str_Underline 4
-#define _XY_Str_Blink     5
-#define _XY_Str_Cross     9
-
-#define xy_str_to_bold(str)      _xy_str_to_terminal_style (_XY_Str_Bold, str)
-#define xy_str_to_faint(str)     _xy_str_to_terminal_style (_XY_Str_Faint, str)
-#define xy_str_to_italic(str)    _xy_str_to_terminal_style (_XY_Str_Italic, str)
-#define xy_str_to_underline(str) _xy_str_to_terminal_style (_XY_Str_Underline, str)
-#define xy_str_to_blink(str)     _xy_str_to_terminal_style (_XY_Str_Blink, str)
-#define xy_str_to_cross(str)     _xy_str_to_terminal_style (_XY_Str_Cross, str)
-
-#define _XY_Str_Red     31
-#define _XY_Str_Green   32
-#define _XY_Str_Yellow  33
-#define _XY_Str_Blue    34
-#define _XY_Str_Magenta 35
-#define _XY_Str_Cyan    36
-
-#define xy_str_to_red(str)     _xy_str_to_terminal_style (_XY_Str_Red, str)
-#define xy_str_to_green(str)   _xy_str_to_terminal_style (_XY_Str_Green, str)
-#define xy_str_to_yellow(str)  _xy_str_to_terminal_style (_XY_Str_Yellow, str)
-#define xy_str_to_blue(str)    _xy_str_to_terminal_style (_XY_Str_Blue, str)
-#define xy_str_to_magenta(str) _xy_str_to_terminal_style (_XY_Str_Magenta, str)
-#define xy_str_to_purple        xy_str_to_magenta
-#define xy_str_to_cyan(str)    _xy_str_to_terminal_style (_XY_Str_Cyan, str)
-
-static char *
-_xy_str_to_terminal_style (int style, const char *str)
-{
-  char *color_fmt_str = NULL;
-
-  if (!xy_enable_color)
-    {
-      color_fmt_str = "%s";
-      goto new_str;
-    }
-
-  switch (style)
-    {
-    case _XY_Str_Red:
-      color_fmt_str = "\e[31m%s\e[0m"; break;
-    case _XY_Str_Green:
-      color_fmt_str = "\e[32m%s\e[0m"; break;
-    case _XY_Str_Yellow:
-      color_fmt_str = "\e[33m%s\e[0m"; break;
-    case _XY_Str_Blue:
-      color_fmt_str = "\e[34m%s\e[0m"; break;
-    case _XY_Str_Magenta:
-      color_fmt_str = "\e[35m%s\e[0m"; break;
-    case _XY_Str_Cyan:
-      color_fmt_str = "\e[36m%s\e[0m"; break;
-    case _XY_Str_Bold:
-      color_fmt_str = "\e[1m%s\e[0m"; break;
-    case _XY_Str_Faint:
-      color_fmt_str = "\e[2m%s\e[0m"; break;
-    case _XY_Str_Italic:
-      color_fmt_str = "\e[3m%s\e[0m"; break;
-    case _XY_Str_Underline:
-      color_fmt_str = "\e[4m%s\e[0m"; break;
-    case _XY_Str_Blink:
-      color_fmt_str = "\e[5m%s\e[0m"; break;
-    case _XY_Str_Cross:
-      color_fmt_str = "\e[9m%s\e[0m"; break;
-    }
-
-
-  size_t len = 0;
-new_str:
-  // -2 把中间%s减掉
-  len = strlen (color_fmt_str) - 2;
-  char *buf = malloc (strlen (str) + len + 1);
-  sprintf (buf, color_fmt_str, str);
-  return buf;
-}
-
-static bool
-xy_streql (const char *str1, const char *str2)
-{
-  if (NULL==str1 || NULL==str2)
-    {
-      return false;
-    }
-  return strcmp (str1, str2) == 0 ? true : false;
-}
-
-static char *
-xy_str_to_quietcmd (const char *cmd)
-{
-  char *ret = NULL;
-#ifdef _WIN32
-  ret = xy_2strjoin (cmd, " >nul 2>nul ");
-#else
-  ret = xy_2strjoin (cmd, " 1>/dev/null 2>&1 ");
-#endif
-  return ret;
-}
-
-static bool
-xy_str_end_with (const char *str, const char *suffix)
-{
-  size_t len1 = strlen (str);
-  size_t len2 = strlen (suffix);
-
-  if (0 == len2)
-    return true; // 空字符串直接返回
-  if (len1 < len2)
-    return false;
-
-  const char *cur1 = str + len1 - 1;
-  const char *cur2 = suffix + len2 - 1;
-
-  for (int i = 0; i < len2; i++)
-    {
-      if (*cur1 != *cur2)
-        return false;
-      cur1--;
-      cur2--;
-    }
-  return true;
-}
-
-static bool
-xy_str_start_with (const char *str, const char *prefix)
-{
-  if (NULL==str || NULL==prefix)
-    {
-      return false;
-    }
-
-  size_t len1 = strlen (str);
-  size_t len2 = strlen (prefix);
-
-  if (0 == len2)
-    return true; // 空字符串直接返回
-  if (len1 < len2)
-    return false;
-
-  const char *cur1 = str;
-  const char *cur2 = prefix;
-
-  for (int i = 0; i < len2; i++)
-    {
-      if (*cur1 != *cur2)
-        return false;
-      cur1++;
-      cur2++;
-    }
-  return true;
-}
-
-static char *
-xy_str_delete_prefix (const char *str, const char *prefix)
-{
-  char *new = xy_strdup (str);
-  bool yes = xy_str_start_with (str, prefix);
-  if (!yes)
-    return new;
-
-  size_t len = strlen (prefix);
-  char *cur = new + len;
-  return cur;
-}
-
-static char *
-xy_str_delete_suffix (const char *str, const char *suffix)
-{
-  char *new = xy_strdup (str);
-  bool yes = xy_str_end_with (str, suffix);
-  if (!yes)
-    return new;
-
-  size_t len1 = strlen (str);
-  size_t len2 = strlen (suffix);
-  char *cur = new + len1 - len2;
-  *cur = '\0';
-  return new;
-}
-
-static char *
-xy_str_strip (const char *str)
-{
-  char *new = xy_strdup (str);
-
-  while (strchr ("\n\r\v\t\f ", new[0]))
-    {
-      new += 1;
-    }
-
-  size_t len = strlen (new);
-
-  char *last = new + len - 1;
-
-  while (strchr ("\n\r\v\t\f ", *last))
-    {
-      *last = '\0';
-      last -= 1;
-    }
-  return new;
-}
-
-
-/******************************************************
- *                      Logging
- ******************************************************/
-
-#define _XY_Log_Plain   000000001
-#define _XY_Log_Success 000000001 << 1
-#define _XY_Log_Info    000000001 << 2
-#define _XY_Log_Warn    000000001 << 3
-#define _XY_Log_Error   000000001 << 4
-
-#define xy_log(prompt, str)  _xy_log (_XY_Log_Plain,   prompt, str)
-#define xy_succ(prompt,str)  _xy_log (_XY_Log_Success, prompt, str)
-#define xy_info(prompt,str)  _xy_log (_XY_Log_Info,    prompt, str)
-#define xy_warn(prompt,str)  _xy_log (_XY_Log_Warn,    prompt, str)
-#define xy_error(prompt,str) _xy_log (_XY_Log_Error,   prompt, str)
-
-static void
-_xy_log (int level, const char *prompt, const char *content)
-{
-  char *str = NULL;
-
-  bool to_stderr = false;
-
-  /**
-   * 'app: content'
-   */
-  if (level & _XY_Log_Plain)
-    {
-      str = xy_strjoin (3, prompt,  ": ", content);
-    }
-  else if (level & _XY_Log_Success)
-    {
-      str = xy_strjoin (3, prompt,  ": ", xy_str_to_green (content));
-    }
-  else if (level & _XY_Log_Info)
-    {
-      str = xy_strjoin (3, prompt,  ": ", xy_str_to_blue (content));
-    }
-  else if (level & _XY_Log_Warn)
-    {
-      str = xy_strjoin (3, prompt,  ": ", xy_str_to_yellow (content));
-      to_stderr = true;
-    }
-  else if (level & _XY_Log_Error)
-    {
-      str = xy_strjoin (3, prompt,  ": ", xy_str_to_red (content));
-      to_stderr = true;
-    }
-  else
-    {
-      // xy_assert ("CAN'T REACH!");
-    }
-
-  if (to_stderr)
-    {
-      fprintf (stderr, "%s\n", str);
-    }
-  else
-    {
-      puts (str);
-    }
-  free (str);
-}
-
-
-/**
- * brkt 系列输出受 pip 启发，为了输出方便，使用 xy.h 的程序应该
- *
- *  1.若想完全自定义颜色和输出位置：
- *
- *    应基于下述 xy_log_brkt_to 定义自己的输出函数
- *
- *  2.若想自定义颜色，而保持输出到stdout：
- *
- *    应基于下述 xy_log_brkt 定义
- *
- *  3.若对log无细致要求，想要快速使用log功能：
- *
- *    应基于下述 xy_<level>_brkt 定义自己的 app_<level>_brkt()，或直接使用 xy_<level>_brkt
- */
-
-static void
-xy_log_brkt_to (const char *prompt, const char *content, FILE *stream)
-{
-  char *str = xy_strjoin (4, "[", prompt, "] ", content);
-  fprintf (stream, "%s\n", str);
-  free (str);
-}
-
-#define xy_log_brkt(prompt1,prompt2,content)   _xy_log_brkt(_XY_Log_Plain,  prompt1,prompt2,content)
-#define xy_succ_brkt(prompt1,prompt2,content)  _xy_log_brkt(_XY_Log_Success,prompt1,prompt2,content)
-#define xy_info_brkt(prompt1,prompt2,content)  _xy_log_brkt(_XY_Log_Info,   prompt1,prompt2,content)
-#define xy_warn_brkt(prompt1,prompt2,content)  _xy_log_brkt(_XY_Log_Warn,   prompt1,prompt2,content)
-#define xy_error_brkt(prompt1,prompt2,content) _xy_log_brkt(_XY_Log_Error,  prompt1,prompt2,content)
-
-static void
-_xy_log_brkt (int level, const char *prompt1, const char *prompt2, const char *content)
-{
-  char *str = NULL;
-
-  bool to_stderr = false;
-
-  if (level & _XY_Log_Plain)
-    {
-      str = xy_strjoin (6, "[", prompt1, " ", prompt2, "] ", content);
-    }
-  else if (level & _XY_Log_Success)
-    {
-      /* [app 成功]  [app success] */
-      str = xy_strjoin (6,
-        "[", xy_str_to_green (prompt1), " ", xy_str_to_bold (xy_str_to_green (prompt2)), "] ", xy_str_to_green (content));
-    }
-  else if (level & _XY_Log_Info)
-    {
-      /* [app 信息]  [app info]
-         [app 提示]  [app notice]
-      */
-      str = xy_strjoin (6,
-        "[", xy_str_to_blue (prompt1), " ", xy_str_to_bold (xy_str_to_blue (prompt2)), "] ", xy_str_to_blue (content));
-    }
-  else if (level & _XY_Log_Warn)
-    {
-      /* [app 警告]  [app warn] */
-      str = xy_strjoin (6,
-        "[", xy_str_to_yellow (prompt1), " ", xy_str_to_bold (xy_str_to_yellow (prompt2)), "] ", xy_str_to_yellow (content));
-      to_stderr = true;
-    }
-  else if (level & _XY_Log_Error)
-    {
-      /* [app 错误]  [app error] */
-      str = xy_strjoin (6,
-        "[", xy_str_to_red (prompt1), " ", xy_str_to_bold (xy_str_to_red (prompt2)), "] ", xy_str_to_red (content));
-      to_stderr = true;
-    }
-  else
-    {
-      // xy_assert ("CAN'T REACH!");
-    }
-
-  if (to_stderr)
-    {
-      fprintf (stderr, "%s\n", str);
-    }
-  else
-    {
-      puts (str);
-    }
-  free (str);
-}
-
-
-
-/******************************************************
- *                      System
- ******************************************************/
-/**
- * 执行cmd，返回某行输出结果，并对已经遍历过的行执行iter_func
- *
- * @param  cmd        要执行的命令
- * @param   n         指定命令执行输出的结果行中的某一行，0 表示最后一行，n (n>0) 表示第n行
- *                    该函数会返回这一行的内容
- * @param  iter_func  对遍历时经过的行的内容，进行函数调用
- *
- * @note 返回的字符串最后面一般有换行符号
- *
- * 由于目标行会被返回出来，所以 iter_func() 并不执行目标行，只会执行遍历过的行
- */
-static char *
-xy_run (const char *cmd,  unsigned long n,  void (*iter_func) (const char *))
-{
-  const int size = 512;
-  char *buf = (char *) malloc (size);
-
-  FILE *stream = popen (cmd, "r");
-  if (stream == NULL)
-    {
-      fprintf (stderr, "xy: 命令执行失败\n");
-      return NULL;
-    }
-
-  char *ret = NULL;
-  unsigned long count = 0;
-
-  while (true)
-    {
-      if (NULL == fgets (buf, size, stream))
-        break;
-      ret = buf;
-      count += 1;
-      if (n == count)
-        break;
-      if (iter_func)
-        {
-          iter_func (buf);
-        }
-    }
-
-  pclose (stream);
-  return ret;
-}
-
-#define xy_os_home _xy_os_home ()
-static char *
-_xy_os_home ()
-{
-  char *home = NULL;
-  if (xy_on_windows)
-    home = getenv ("USERPROFILE");
-  else
-    home = getenv ("HOME");
-  return home;
-}
-
-#define xy_win_powershell_profile _xy_win_powershell_profile ()
-#define xy_win_powershellv5_profile _xy_win_powershellv5_profile ()
-static char *
-_xy_win_powershell_profile ()
-{
-  return xy_2strjoin (
-      xy_os_home, "\\Documents\\PowerShell\\Microsoft.PowerShell_profile.ps1");
-}
-
-char *
-_xy_win_powershellv5_profile ()
-{
-  return xy_2strjoin (
-      xy_os_home,
-      "\\Documents\\WindowsPowerShell\\Microsoft.PowerShell_profile.ps1");
-}
-
-/**
- * @note Windows上，`path` 不要夹带变量名，因为最终 access() 不会帮你转换
- */
-static bool
-xy_file_exist (const char *path)
-{
-  const char *new_path = path;
-  if (xy_str_start_with (path, "~"))
-    {
-      new_path = xy_2strjoin (xy_os_home, path + 1);
-    }
-  // 0 即 F_OK
-  return (0==access (new_path, 0)) ? true : false;
-}
-
-/**
- * @note xy_file_exist() 和 xy_dir_exist() 两个函数在所有平台默认都支持使用 '~'，
- *       但实现中都没有调用 xy_uniform_path()，以防万一，调用前可能需要用户手动调用它
- */
-static bool
-xy_dir_exist (const char *path)
-{
-  const char *dir = path;
-  if (xy_on_windows)
-    {
-      if (xy_str_start_with (path, "~"))
-        {
-          dir = xy_2strjoin (xy_os_home, path + 1);
-        }
-    }
-
-  if (xy_on_windows)
-    {
-#ifdef XY_On_Windows
-      // 也可以用 opendir() #include <dirent.h>
-      DWORD attr = GetFileAttributesA (dir);
-
-      if (attr == INVALID_FILE_ATTRIBUTES)
-        {
-          // Q: 我们应该报错吗？
-          return false;
-        }
-      else if (attr & FILE_ATTRIBUTE_DIRECTORY)
-        {
-          return true;
-        }
-      else
-        {
-          return false;
-        }
-#endif
-    }
-  else
-    {
-      int status = system (xy_2strjoin ("test -d ", dir));
-
-      if (0==status)
-        return true;
-      else
-        return false;
-    }
-}
-
-/**
- * 该函数即使在非Windows下也可调用，作用是删除路径左右两边多出来的空白符
- */
-static char *
-xy_uniform_path (const char *path)
-{
-  char *new = xy_str_strip (path); // 防止开发者多写了空白符
-
-  // 这个函数仅在Windows上才进行替换
-  if (xy_on_windows)
-    {
-      if (xy_str_start_with (new, "~/"))
-        {
-          // 或 %USERPROFILE%
-          new = xy_strjoin (3, xy_os_home, "\\",
-                            xy_str_delete_prefix (new, "~/"));
-        }
-      new = xy_str_gsub (new, "/", "\\");
-    }
-
-  return new;
-}
-
-static char *
-xy_parent_dir (const char *path)
-{
-  char *dir = xy_uniform_path (path);
-  char *last = NULL;
-  if (xy_on_windows)
-    {
-      last = strrchr (dir, '\\');
-      *last = '\0';
-    }
-  else
-    {
-      last = strrchr (dir, '/');
-      *last = '\0';
-    }
-  return dir;
-}
-
-#endif

justfile

@@ -0,0 +1,161 @@
+#!/usr/bin/env just --justfile
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# Build File    : justfile
+# File Authors  : 曾奥然      <ccmywish@qq.com>
+# Contributors  : Mikachu2333 <mikachu.23333@zohomail.com>
+#               |
+# Created On    : <2025-06-18>
+# Last Modified : <2025-10-15>
+#
+# 该文件主要用于在原生Windows上执行项目的基本任务，而不借助于
+# GNU make 以及相应的 MSYS2、Cygwin 环境
+# --------------------------------------------------------------
+# just (build)											-> chsrc.exe
+# just bd (build-in-debug-mode)			-> chsrc-debug.exe
+# just br (build-in-release-mode)		-> chsrc-release.exe
+# just debug
+# just test
+# just clean
+#
+# just STATIC=1 br  	静态链接 (注意只能在 br 任务中使用)
+#
+# 不支持 just DEBUG=1，请直接使用 just bd (等价于 just build-in-debug-mode)
+#
+# --------------------------------------------------------------
+# 注意，由于我们要在 GitHub Actions 上编译 x32 版的 chsrc，所以需要使用 make，
+# 而不清楚 just 在 MINGW32 中的情况，所以我们在此 justfile 中并不实现关于 CI 的功能
+# --------------------------------------------------------------
+
+set windows-shell := ['cmd', '/c']
+
+CC := if os() == 'windows' {
+	"gcc"
+} else if os() == 'macos' {
+	"clang"
+} else {
+	"cc"
+}
+
+DEBUGGER := if os() == 'windows' {
+	"gdb"
+} else if os() == 'macos' {
+	"lldb"
+} else {
+	"gdb"
+}
+
+CFLAGS_chk_Clang := if os() == 'windows' {
+  if CC == 'clang' {
+    '-target x86_64-pc-windows-gnu'
+  } else {''}
+} else {''}
+
+
+CFLAGS_base := '-Iinclude -Ilib ' + CFLAGS_chk_Clang
+
+WARN := '-Wall -Wextra -Wno-unused-variable -Wno-unused-function -Wno-missing-braces -Wno-misleading-indentation' + ' ' + \
+	'-Wno-missing-field-initializers -Wno-unused-parameter -Wno-sign-compare'
+CFLAGS_warn := WARN
+
+
+CFLAGS_debug := '-g -DXY_DEBUG'
+
+DevMode-Target-Name     := 'chsrc'
+DebugMode-Target-Name   := 'chsrc-debug'
+ReleaseMode-Target-Name := 'chsrc-release'
+
+STATIC := '0'
+
+CFLAGS_static := "-static"
+
+CFLAGS_chk_static := if STATIC == '1' {
+	CFLAGS_static
+} else { "" }
+
+
+CFLAGS_optimization := "-O2"
+
+
+CFLAGS_dev_mode_prompt 	   := CFLAGS_base
+CFLAGS_debug_mode_prompt 	 := CFLAGS_base + ' ' + CFLAGS_debug
+CFLAGS_release_mode_prompt := CFLAGS_base + ' ' + CFLAGS_optimization + ' ' + CFLAGS_chk_static
+
+CFLAGS_dev_mode     := CFLAGS_dev_mode_prompt     + ' ' + CFLAGS_warn
+CFLAGS_debug_mode   := CFLAGS_debug_mode_prompt   + ' ' + CFLAGS_warn
+CFLAGS_release_mode := CFLAGS_release_mode_prompt + ' ' + CFLAGS_warn
+
+#=======================
+
+BIN_xy := if os() == 'windows' {'xy.exe'} else {'./xy'}
+BIN_fw := if os() == 'windows' {'fw.exe'} else {'./fw'}
+BIN_rm := if os() == 'windows' {'del'}    else {'rm'}
+#=======================
+alias b := build-in-dev-mode
+alias bd:= build-in-debug-mode
+alias br:= build-in-release-mode
+alias build:=build-in-dev-mode
+alias d := debug
+alias t := test
+alias check := test
+alias c := clean
+
+default: build-in-dev-mode
+
+build-in-dev-mode:
+	@echo Starting: Build in DEV mode: '{{CC}}' {{CFLAGS_dev_mode_prompt}} -o {{DevMode-Target-Name}}
+	@{{CC}} src/chsrc-main.c {{CFLAGS_dev_mode}} -o {{DevMode-Target-Name}}
+	@echo Finished: Build in DEV mode
+
+build-in-debug-mode:
+	@echo Starting: Build in DEBUG mode: '{{CC}}' {{CFLAGS_debug_mode_prompt}} -o {{DebugMode-Target-Name}}
+	@{{CC}} src/chsrc-main.c {{CFLAGS_debug_mode}} -o {{DebugMode-Target-Name}}
+	@echo Finished: Build in DEBUG mode
+
+build-in-release-mode:
+  @echo Starting: Build in RELEASE mode: '{{CC}}' {{CFLAGS_release_mode_prompt}} -o {{ReleaseMode-Target-Name}}
+  @{{ if os() == 'windows' { \
+        '(if exist chsrc.res del chsrc.res)' + \
+        ' & windres src/resource/chsrc.rc -O coff -o chsrc.res' \
+      } else { '' } }}
+  @{{ if os() == 'windows' { \
+      CC + ' src/chsrc-main.c chsrc.res ' + CFLAGS_release_mode + ' -o ' + ReleaseMode-Target-Name \
+    } else { \
+      CC + ' src/chsrc-main.c '           + CFLAGS_release_mode + ' -o ' + ReleaseMode-Target-Name \
+    } }}
+  @echo Finished: Build in RELEASE mode
+
+debug: build-in-debug-mode
+  @{{DEBUGGER}} {{DebugMode-Target-Name}}
+
+test: test-xy test-fw
+
+# 这两个测试文件都用 DEBUG mode
+test-xy:
+	@{{CC}} test/xy.c {{CFLAGS_debug_mode}} -o xy
+	@{{BIN_xy}}
+
+test-fw:
+	@{{CC}} test/fw.c {{CFLAGS_debug_mode}} -o fw
+	@{{BIN_fw}}
+
+fastcheck:
+	@perl ./test/cli.pl fastcheck
+
+test-cli:
+	@perl ./test/cli.pl
+
+clean:
+	-@{{BIN_rm}} *.exe
+	-@{{BIN_rm}} *.res
+	-@{{BIN_rm}} xy
+	-@{{BIN_rm}} fw
+	-@{{BIN_rm}} chsrc
+	-@{{BIN_rm}} chsrc-debug
+	-@{{BIN_rm}} chsrc-release
+	-@{{BIN_rm}} README.md.bak*
+
+# 使用: just rawstr4c [--debug] Markdown.md
+# rawstr4c *args:
+#	@{{ if os() == 'windows' { 'tool\\rawstr4c\\run\\run.bat' } else { 'bash ./tool/rawstr4c/run/run.sh' } }} {{args}}

lefthook.yml

@@ -0,0 +1,53 @@
+# ---------------------------------------------------------------
+# Lefthook File : lefthook.yml
+# File Authors  : 曾奥然 <ccmywish@qq.com>
+# Contributors  : Nul None <nul@none.org>
+#               |
+# Created On    : <2025-10-28>
+# Last Modified : <2025-10-30>
+# ---------------------------------------------------------------
+
+min_version: 2.0.1
+
+pre-commit:
+  only:
+    - ref: dev
+  parallel: false
+  jobs:
+    - name: 试运行 DEBUG mode
+      # 触发所有 _prelude() 函数检查
+      run: |
+        just build-in-debug-mode
+        ./chsrc-debug get pip
+      glob: "*.{c,h}"
+      exclude: test/*
+
+    - name: 测试 xy.h
+      run: just test-xy
+      glob:
+        - lib/xy.h
+        - test/xy.c
+
+    - name: 测试 framework
+      run: just test-fw
+      glob:
+        - "src/framework/*.{c,h}"
+        - src/chsrc-main.c
+        - test/fw.c
+
+post-merge:
+  only:
+    - ref: main
+  jobs:
+    - name: 测试编译 DEV mode
+      run: just build-in-dev-mode
+
+pre-push:
+  only:
+    - ref: gh-build
+  jobs:
+    - name: 测试编译 RELEASE mode
+      run: just build-in-release-mode
+
+    - name: 测试运行
+      run: just test-cli

pkg/AUR/README.md

@@ -0,0 +1,36 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : README.md
+ ! Doc Authors   : 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nil Null <nil@null.org>
+ !               |
+ ! Created On    : <2025-06-15>
+ ! Last Modified : <2025-06-16>
+ ! ---------------------------------------------------------- -->
+
+# AUR package
+
+本文档说明了 `chsrc` 项目的 AUR 包的相关情况
+
+<br>
+
+## 相关文件
+
+CI 维护者 [@Jerry-Terrasse](https://github.com/Jerry-Terrasse)
+
+- [.github/workflows/pub-AUR-chsrc-git.yml](../../.github/workflows/pub-AUR-chsrc-git.yml)
+- [.github/workflows/pub-AUR-chsrc-and-chsrc-bin.yml`](../../.github/workflows/pub-AUR-chsrc-git.yml)
+
+<br>
+
+## 分发
+
+位于 https://aur.archlinux.org/packages
+
+- [chsrc-bin](https://aur.archlinux.org/packages/chsrc-bin): 从 GitHub Releases 直接下载的二进制文件
+
+- [chsrc](https://aur.archlinux.org/packages/chsrc)：从 GitHub Releases 的代码构建
+
+- [chsrc-git](https://aur.archlinux.org/packages/chsrc-git)：从最新源码构建的版本，偶尔可能不稳定

pkg/README.md

@@ -1,19 +1,24 @@
 # Packages
 
-https://github.com/RubyMetric/chsrc/issues/16
+## 分发情况
 
 - [x] `Homebrew`
 - [x] `Scoop`
+- [x] `WinGet`
 - [x] `AUR`
 - [ ] `Flatpak`
 - [ ] `snap`
 - [ ] ...
 
+<br>
+
 ```bash
 $ brew install chsrc
 
 $ scoop install chsrc
 
+$ winget install RubyMetric.chsrc
+
 yay -S chsrc-bin # Binary from GitHub Release
 yay -S chsrc     # Build  from GitHub Release
 yay -S chsrc-git # Build  from the latest main branch (stable)
@@ -21,18 +26,31 @@ yay -S chsrc-git # Build  from the latest main branch (stable)
 
 <br>
 
-# Homebrew
+- Homebrew
 
-https://github.com/Homebrew/homebrew-core/blob/master/Formula/c/chsrc.rb
+  https://github.com/Homebrew/homebrew-core/blob/master/Formula/c/chsrc.rb
 
-# Scoop
+- Scoop
 
-https://github.com/ScoopInstaller/Main/blob/master/bucket/chsrc.json
+  https://github.com/ScoopInstaller/Main/blob/master/bucket/chsrc.json
 
-# AUR
+- WinGet
 
-[chsrc-bin](https://aur.archlinux.org/packages/chsrc-bin): 从GitHub Release直接下载的二进制文件
+  https://github.com/microsoft/winget-pkgs/tree/master/manifests/r/RubyMetric/chsrc
 
-[chsrc](https://aur.archlinux.org/packages/chsrc)：从GitHub Release的代码构建
+- AUR:
 
-[chsrc-git](https://aur.archlinux.org/packages/chsrc-git)：从最新源码构建的版本，偶尔可能不稳定
+  - https://aur.archlinux.org/packages/chsrc-bin
+
+  - https://aur.archlinux.org/packages/chsrc
+
+  - https://aur.archlinux.org/packages/chsrc-git
+
+<br>
+
+
+## 打包情况
+
+- [x] `deb`
+
+<br>

pkg/deb/BUILD.md

@@ -0,0 +1,126 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : BUILD.md
+ ! Doc Authors   : sanchuanhehe <wyihe5520@gmail.com>
+ ! Contributors  :  曾奥然 <ccmywish@qq.com>
+ !               |
+ ! Created On    : <2025-06-14>
+ ! Last Modified : <2025-06-16>
+ ! ---------------------------------------------------------- -->
+
+# 构建 deb package
+
+## 准备
+
+安装构建所需的依赖：
+
+```bash
+sudo apt-get update
+sudo apt-get install build-essential debhelper devscripts fakeroot
+```
+
+<br>
+
+## 构建
+
+```bash
+git clone https://github.com/RubyMetric/chsrc.git
+cd chsrc
+
+# 进入 deb 目录
+cd pkg/deb
+
+# 执行构建命令
+./Makefile deb-make
+```
+
+### 调试构建
+
+```bash
+# 启用详细输出
+DEB_BUILD_OPTIONS="nocheck" debuild -us -uc -b
+
+# 检查构建日志
+less ../chsrc_*.build
+
+# 检查包内容
+dpkg --contents ../chsrc_*.deb
+# 或
+dpkg-deb --contents ../chsrc_*.deb
+```
+
+### 交叉编译
+
+为不同架构进行构建：
+
+```bash
+# For ARM64
+CC=aarch64-linux-gnu-gcc dpkg-buildpackage -us -uc -b -aarm64
+
+# For ARMv7 (armhf)
+CC=arm-linux-gnueabihf-gcc dpkg-buildpackage -us -uc -b -aarmhf
+```
+
+<br>
+
+### 安装
+
+```bash
+sudo dpkg -i ../chsrc_*.deb
+sudo apt-get install -f  # 修复依赖问题
+```
+
+<br>
+
+### 测试安装情况
+
+```bash
+# 运行测试
+bash ./deb-installation-test.sh
+
+# 查看文档安装情况
+man chsrc
+
+# 查看 deb 包的 copyright
+cat /usr/share/doc/chsrc/copyright
+
+# 查看 deb 包 changelog
+zless /usr/share/doc/chsrc/changelog.Debian.gz
+```
+
+<br>
+
+### 清理构建产物
+
+```bash
+./Makefile deb-clean
+```
+
+<br>
+
+## 卸载
+
+```bash
+sudo apt-get remove chsrc
+```
+
+包括删除配置在内的完全删除：
+
+```bash
+sudo apt-get purge chsrc
+```
+
+<br>
+
+
+## 故障排查
+
+常见问题：
+
+1. **构建失败**: 检查 debian/control 中的依赖是否正确
+2. **交叉编译失败**: 确认目标架构的工具链已正确安装
+3. **安装测试失败**: 检查 postinst 脚本是否有错误
+
+<br>

pkg/deb/CI.md

@@ -0,0 +1,61 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : CI.md
+ ! Doc Authors   : sanchuanhehe <wyihe5520@gmail.com>
+ ! Contributors  :  曾奥然 <ccmywish@qq.com>
+ !               |
+ ! Created On    : <2025-06-14>
+ ! Last Modified : <2025-06-16>
+ ! ---------------------------------------------------------- -->
+
+# deb package CI/CD
+
+本文档说明了 chsrc 项目的 deb 包自动构建和发布流程。
+
+## CI 文件
+
+CI 维护者 [@sanchuanhehe](https://github.com/sanchuanhehe)
+
+- [.github/workflows/pkg-deb.yml](../../.github/workflows/pkg-deb.yml)
+
+<br>
+
+## 支持的架构
+
+当前支持以下架构的 deb 包构建：
+
+- `amd64` (x86_64)
+
+<br>
+
+## CI 构建产物
+
+每次 CI 构建会生成：
+
+1. **deb 包文件**: `chsrc_<version>-1_<arch>.deb`
+2. **仓库元数据**: `Packages` 和 `Packages.gz` 文件用于创建 APT 仓库
+
+<br>
+
+
+## 自动触发
+
+deb 包构建 CI 会在以下情况下自动触发：
+
+1. **Push 事件**：当 push 到 `gh-build` 分支时自动构建，并上传 deb 包 到 `pre` 这个特定的 release 中
+2. **Release 事件**: 当创建新的 release 时自动构建，并上传 deb 包到最新的这个 release 中
+2. **手动触发**: 可以在 GitHub Actions 页面手动触发构建
+
+<br>
+
+## 手动发布流程
+
+1. 确保所有代码已合并到主分支
+2. 更新版本号和 changelog
+3. 创建并推送 git tag: `git tag v1.2.3 && git push origin v1.2.3`
+4. 在 GitHub 上创建 release
+5. CI 将自动构建并上传 deb 包
+
+<br>

pkg/deb/Makefile

@@ -0,0 +1,37 @@
+#!/usr/bin/make -f
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# Build File    : Makefile
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+# Contributors  :  曾奥然 <ccmywish@qq.com>
+#								|
+# Created On    : <2025-06-14>
+# Last Modified : <2025-06-16>
+#
+# deb package targets
+#
+# @issue https://github.com/RubyMetric/chsrc/pull/206
+# 这些本是 debhelper 兼容性版本 (debian/compat) 为 9 时所需要定义的 targets
+# 然而现在已经为版本 13 (debian/compat已移除)，不再需要这些 targets，仅出于
+# 实用目的保留。由于以上原因，也不要修改这些 targets 的名称。
+# --------------------------------------------------------------
+
+all: deb-build
+
+deb-prepare:
+	@echo "Starting: Prepare for building deb package"
+	@echo "Finished: Prepare for building deb package"
+
+deb-build: deb-prepare
+	@echo "Starting: Build deb package"
+	@debuild -us -uc -b
+	@echo "Finished: Build deb package"
+
+deb-clean:
+	@echo "Starting: Clean deb build artifacts"
+	-@rm -rf debian/chsrc/
+	-@rm -f ../chsrc_*.deb ../chsrc-dbgsym_*.ddeb ../chsrc_*.changes ../chsrc_*.buildinfo ../chsrc_*.build
+	@echo "Finished: Clean deb build artifacts"
+
+.PHONY: deb-prepare deb-build deb-clean

pkg/deb/README.md

@@ -0,0 +1,64 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : README.md
+ ! Doc Authors   : sanchuanhehe <wyihe5520@gmail.com>
+ !               |  曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nil Null <nil@null.org>
+ !               |
+ ! Created On    : <2025-06-14>
+ ! Last Modified : <2025-06-16>
+ ! ---------------------------------------------------------- -->
+
+# deb package
+
+本文档说明了 `chsrc` 项目的 deb 包的相关情况
+
+<br>
+
+## 相关文件
+
+- `.github/workflows/pkg-deb.yml` - CI 配置文件
+- `./CI.md` - CI 情况说明
+
+<wbr>
+
+- `./debian/` - deb 包构建配置目录
+- `./BUILD.md` - 如何手动构建
+- `./Makefile` - deb 包构建 Makefile
+- `./deb-installation-test.sh` - deb 包 **已正确安装** 测试脚本
+
+<br>
+
+
+## 安装
+
+如果你是普通用户，你应该从 [GitHub Releases](https://github.com/RubyMetric/chsrc/releases) 下载合适的 deb 包，然后运行以下命令安装：
+
+```bash
+sudo dpkg -i chsrc_*.deb
+sudo apt-get install -f  # Fix any dependency issues
+```
+
+如果你是高级用户，你可以自己阅读本目录下的 [./BUILD.md](./BUILD.md) 来自己构建 deb 包并按照上述同样的方式安装。
+
+<br>
+
+
+## `debian/` 目录结构
+
+```
+debian/
+├── changelog      # 版本更新日志
+├── compat         # debhelper 兼容性版本
+├── control        # 包控制信息和依赖
+├── copyright      # 版权信息
+├── postinst       # 安装后脚本
+├── prerm          # 卸载前脚本
+└── rules          # 构建规则
+```
+
+其中，最后三个是 `+x` 的可执行文件。
+
+<br>

pkg/deb/deb-installation-test.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# Test File     : deb-installation-test.sh
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+# Contributors  :  曾奥然 <ccmywish@qq.com>
+#               |
+# Created On    : <2025-06-14>
+# Last Modified : <2025-06-16>
+#
+# Test script for deb package installation
+# --------------------------------------------------------------
+
+set -e
+
+echo "Testing installation of deb package 'chsrc' ..."
+
+# Test 1: Check if chsrc binary exists and is executable
+if [ ! -f "/usr/bin/chsrc" ]; then
+  echo "ERROR: /usr/bin/chsrc not found"
+  exit 1
+fi
+
+if [ ! -x "/usr/bin/chsrc" ]; then
+  echo "ERROR: /usr/bin/chsrc is not executable"
+  exit 1
+fi
+
+echo "✓ /usr/bin/chsrc binary exists and is executable"
+
+# Test 2: Check if man page exists
+if [ ! -f "/usr/share/man/man1/chsrc.1" ]; then
+  echo "WARNING: chsrc man page not found at /usr/share/man/man1/chsrc.1"
+else
+  echo "✓ chsrc man page exists"
+fi
+
+# Test 3: Test basic functionality
+echo "Testing basic chsrc functionality..."
+if /usr/bin/chsrc help >/dev/null 2>&1; then
+  echo "✓ command 'chsrc help' works"
+else
+  echo "ERROR: command 'chsrc help' failed"
+  exit 1
+fi
+
+if /usr/bin/chsrc list >/dev/null 2>&1; then
+  echo "✓ command 'chsrc list' works"
+else
+  echo "ERROR: command 'chsrc list' failed"
+  exit 1
+fi
+
+echo "All installation tests of deb package 'chsrc' passed!"

pkg/deb/debian/changelog

@@ -0,0 +1,19 @@
+chsrc (0.2.3-1) unstable; urgency=medium
+
+  * v0.2.3 已发布
+
+ -- 曾奥然 <ccmywish@qq.com>  Wed, 29 Oct 2025 11:29:05 +0800
+
+
+chsrc (0.1.9-1) unstable; urgency=medium
+
+  * v0.1.9 已发布
+
+ -- 曾奥然 <ccmywish@qq.com>  Sun, 15 Jun 2025 13:32:50 +0800
+
+
+chsrc (0.0.1-1) unstable; urgency=medium
+
+  * 首个 deb 包已完成!
+
+ -- sanchuanhehe <wyihe5520@gmail.com>  Mon, 10 Jun 2025 00:00:00 +0000

pkg/deb/debian/control

@@ -0,0 +1,18 @@
+Source: chsrc
+Section: utils
+Priority: optional
+Maintainer: sanchuanhehe <wyihe5520@gmail.com>
+Build-Depends: debhelper-compat (= 13), build-essential, libc6-dev
+Standards-Version: 4.6.0
+Homepage: https://chsrc.run/
+Vcs-Git: https://github.com/RubyMetric/chsrc.git
+Vcs-Browser: https://github.com/RubyMetric/chsrc
+
+Package: chsrc
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: Change Source - A tool for changing software sources
+ chsrc is a command-line tool for changing software sources (mirrors)
+ for various package managers and programming language ecosystems.
+ It supports automatic detection and switching of sources for better
+ download speeds in different regions.

pkg/deb/debian/copyright

@@ -0,0 +1,50 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: chsrc
+Upstream-Contact: 曾奥然 <ccmywish@qq.com>
+Source: https://github.com/RubyMetric/chsrc
+
+Files: *
+Copyright: 2023-2025 曾奥然 <ccmywish@qq.com>
+           2023-2025  郭恒  <2085471348@qq.com>
+License: GPL-3+
+Comment: The authors' names are indicated in each source code file's header.
+
+Files: lib/xy.h
+Copyright: 2023-2025 曾奥然 <ccmywish@qq.com>
+           2023-2025  郭恒  <2085471348@qq.com>
+License: MIT
+
+Files: pkg/deb/debian/*
+Copyright: 2025 sanchuanhehe <wyihe5520@gmail.com>
+License: GPL-3+
+
+License: GPL-3+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+ .
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
+ .
+ On Debian systems, the complete text of the GNU General
+ Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".
+Comment:
+ On Debian systems, the full text of the GNU General Public License
+ version 3 can be found in the file '/usr/share/common-licenses/GPL-3'.
+
+License: MIT
+ MIT License
+
+ Copyright (c) 2023-2025 曾奥然 (Aoran Zeng), 郭恒 (Heng Guo)
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pkg/deb/debian/postinst

@@ -0,0 +1,42 @@
+#!/bin/sh
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# deb File      : postinst
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+# Contributors  :   Nil Null   <nil@null.org>
+#	              |
+# Created On    : <2025-06-14>
+# Last Modified : <2025-06-16>
+#
+# postinst script for chsrc
+# --------------------------------------------------------------
+
+set -e
+
+case "$1" in
+    configure)
+        # Update man database
+        if command -v mandb >/dev/null 2>&1; then
+            mandb -q /usr/share/man/man1/chsrc.1 2>/dev/null || true
+        fi
+
+        # Make sure chsrc is executable
+        chmod +x /usr/bin/chsrc
+
+        echo "chsrc has been successfully installed!"
+        echo "Run 'chsrc help' to get started."
+        ;;
+
+    abort-upgrade|abort-remove|abort-deconfigure)
+        ;;
+
+    *)
+        echo "postinst called with unknown argument \`$1'" >&2
+        exit 1
+        ;;
+esac
+
+#DEBHELPER#
+
+exit 0

pkg/deb/debian/prerm

@@ -0,0 +1,33 @@
+#!/bin/sh
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# deb File      : prerm
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+# Contributors  :   Nil Null   <nil@null.org>
+#	              |
+# Created On    : <2025-06-14>
+# Last Modified : <2025-06-16>
+#
+# prerm script for chsrc
+# --------------------------------------------------------------
+
+set -e
+
+case "$1" in
+    remove|upgrade|deconfigure)
+        # Nothing special to do during removal
+        ;;
+
+    failed-upgrade)
+        ;;
+
+    *)
+        echo "prerm called with unknown argument \`$1'" >&2
+        exit 1
+        ;;
+esac
+
+#DEBHELPER#
+
+exit 0

pkg/deb/debian/rules

@@ -0,0 +1,49 @@
+#!/usr/bin/make -f
+# --------------------------------------------------------------
+# SPDX-License-Identifier: GPL-3.0-or-later
+# --------------------------------------------------------------
+# Build File    : rules
+# File Authors  : sanchuanhehe <wyihe5520@gmail.com>
+#               |  曾奥然 <ccmywish@qq.com>
+# Contributors  : Nil Null <nil@null.org>
+#								|
+# Created On    : <2025-06-14>
+# Last Modified : <2025-06-20>
+#
+# 该文件是 Makefile 格式
+# --------------------------------------------------------------
+#
+# debuild 调用 dpkg-buildpackage
+#
+# dpkg-buildpackage 通过调用 fakeroot debian/rules <target> 执行本文件
+#
+# 由于下面的 %，所有任务都将被传递给 dh
+#
+# 比如：
+#
+# 	 debian/rules <target>
+#
+# 会转换为：
+#
+#			dh <target>
+#
+# 来执行
+#
+# 简单理解，将顺序调用:
+#		1. dh clean
+#		2. dh build  (debian/rules override_dh_auto_build)
+#		3. dh binary (debian/rules override_dh_auto_install)
+# --------------------------------------------------------------
+
+# 由于 debuild 要寻找 debian/ 目录，因此当前工作目录一定在 pkg/deb 下
+Chsrc-Root-Dir = $(CURDIR)/../../
+
+%:
+	dh $@
+
+override_dh_auto_build:
+# 切换到 chsrc 根目录
+	@$(MAKE) -C $(Chsrc-Root-Dir) build-in-release-mode
+
+override_dh_auto_install:
+	@$(MAKE) -C $(Chsrc-Root-Dir) install DESTDIR=$(CURDIR)/debian/chsrc

src/framework/chef.c

@@ -0,0 +1,388 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * File Name     : chef.c
+ * File Authors  : 曾奥然 <ccmywish@qq.com>
+ * Contributors  : BingChunMoLi <bingchunmoli@bingchunmoli.com>
+ * Created On    : <2025-08-09>
+ * Last Modified : <2025-10-27>
+ *
+ * chef DSL: for chefs (recipe makers) to define a target
+ * ------------------------------------------------------------*/
+
+#pragma once
+
+void
+chef_debug_target (Target_t *target)
+{
+#ifdef XY_DEBUG
+  if (!target)
+    {
+      chsrc_debug2 ("target", "Target is NULL");
+      return;
+    }
+
+  say ("DEBUG Target Information:");
+  printf ("  Aliases: %s\n", target->aliases);
+
+  printf ("  Get Function: %p\n", target->getfn);
+  printf ("  Set Function: %p\n", target->setfn);
+  printf ("  Reset Function: %p\n", target->resetfn);
+  printf ("  Prelude Function: %p\n", target->preludefn);
+
+  printf ("  Inited?: %d\n", target->inited);
+
+  printf ("  Sources: %p\n", target->sources);
+  printf ("  Sources Count: %d\n", target->sources_n);
+
+  printf ("  Chef: %p\n", target->chef);
+  printf ("  Cooks: %p\n", target->cooks);
+  printf ("  Cooks Count: %d\n", target->cooks_n);
+  printf ("  Sauciers: %p\n", target->sauciers);
+  printf ("  Sauciers Count: %d\n", target->sauciers_n);
+#endif
+}
+
+
+void
+chef_debug_contributor (Contributor_t *contributor)
+{
+#ifdef XY_DEBUG
+  if (!contributor)
+    {
+      chsrc_debug2 ("contrib", "Contributor is NULL");
+      return;
+    }
+
+  say ("DEBUG Contributor Information:");
+  printf ("  ID:    %s\n", contributor->id);
+  printf ("  Name:  %s\n", contributor->name);
+  printf ("  Email: %s\n", contributor->email);
+  printf ("  DisplayName: %s\n", contributor->display_name);
+#endif
+}
+
+
+/**
+ * @brief 登记所有贡献者
+ *
+ * @param     id       贡献者 ID，这个ID最好是GitHub用户名，但也可以不是，只需要在 chsrc 内部进行区分即可
+ * @param display_name 如果没有提供该参数，则使用 name
+ */
+void
+chef_register_contributor (char *id, char *name, char *email, char *display_name)
+{
+  if (!id || !name || !email)
+    xy_unreached();
+
+  Contributor_t *contributor = xy_malloc0 (sizeof (Contributor_t));
+  contributor->id = xy_strdup (id);
+  contributor->name = xy_strdup (name);
+  contributor->email = xy_strdup (email);
+
+  if (!display_name)
+    contributor->display_name = xy_strdup (name);
+  else
+    contributor->display_name = xy_strdup (display_name);
+
+  xy_map_set (ProgStore.contributors, id, contributor);
+}
+
+
+/**
+ * @brief 修改 Provider 的测速地址
+ *
+ * @note 这个修改的是全局 Provider 里的信息。往往用来设置 UpstreamProvider
+ */
+void
+chef_set_provider_speed_measure_url (SourceProvider_t *provider, char *url)
+{
+  provider->psmi.skip = NotSkip;
+  provider->psmi.url = xy_strdup (url);
+  chsrc_debug ("m", xy_strcat (4, "recipe 重新为 ", provider->code, "(镜像站信息本身) 设置测速链接: ", url));
+}
+
+
+/**
+ * @brief 修改 Provider 的测速精度
+ *
+ * @note 这个修改的是全局 Provider 里的信息。往往用来设置 UpstreamProvider
+ */
+void
+chef_set_provider_speed_measure_accuracy (SourceProvider_t *provider, bool accuracy)
+{
+  provider->psmi.accurate = accuracy;
+  chsrc_debug ("m", xy_strcat (4, "recipe 重新为 ", provider->code, "(镜像站信息本身) 设置测速精度: ", accuracy ? "精准" : "粗略"));
+}
+
+
+/**
+ * @brief 提供一个函数，这个函数基于 "换源链接" 和用户提供的数据来构造和填充精准测速链接
+ */
+void
+chef_set_sources_speed_measure_url_with_func (
+  Target_t *target,
+  char *(*func)(const char *url, const char *user_data),
+  char *user_data)
+{
+  xy_cant_be_null (target);
+
+  Source_t *sources = target->sources;
+  int n = target->sources_n;
+
+  for (int i=0; i<n; i++)
+    {
+      Source_t *src = &sources[i];
+      ProviderType_t type = src->provider->type;
+      if (src->url)
+        {
+          /* 为空时才修改 或者里面是脏数据 */
+          if (NULL==src->speed_measure_url || !hp_is_url (src->speed_measure_url))
+            {
+              src->speed_measure_url = func (src->url, user_data);
+            }
+        }
+    }
+}
+
+
+/**
+ * @brief 给 "换源链接" 增加一个后缀来构造和填充专用测速链接
+ */
+void
+chef_set_sources_speed_measure_url_with_postfix (Target_t *target, char *postfix)
+{
+  chef_set_sources_speed_measure_url_with_func (target, xy_2strcat, postfix);
+}
+
+
+/**
+ * @note 用于: 组中的 item target 在 standalone 模式时正确填充源信息
+ */
+void
+chef_use_other_target_sources (Target_t *this, Target_t *other)
+{
+  if (!other->inited)
+    {
+      if (other->preludefn)
+        other->preludefn();
+      else
+        {
+          chef_debug_target (other);
+          chsrc_panic ("`other` 未定义 _prelude() !");
+        }
+    }
+
+  this->sources = other->sources;
+  this->sources_n = other->sources_n;
+}
+
+
+void
+chef_allow_english (Target_t *target)
+{
+  xy_cant_be_null (target);
+  target->can_english = true;
+}
+
+void
+chef_deny_english (Target_t *target)
+{
+  xy_cant_be_null (target);
+  target->can_english = false;
+}
+
+
+void
+chef_allow_local_mode (Target_t *target, Capability_t cap, const char *explain_zh, const char *explain_en)
+{
+  xy_cant_be_null (target);
+
+  target->cap_local = cap;
+
+  if (cap == FullyCan)
+    {
+      target->cap_local_explain = xy_strdup (CHINESE ? "完全支持项目级换源" : "Supports project-level source switching");
+      return;
+    }
+
+  if (cap == CanNot)
+    {
+      target->cap_local_explain = xy_strdup (CHINESE ? "无法进行项目级换源" : "Unable to perform project-level source switching");
+      return;
+    }
+
+  target->cap_local_explain = xy_strdup (CHINESE ? explain_zh : explain_en);
+}
+
+
+void
+chef_allow_user_define (Target_t *target)
+{
+  xy_cant_be_null (target);
+
+  target->can_user_define = true;
+  target->can_user_define_explain = NULL;
+}
+
+void
+chef_deny_user_define (Target_t *target)
+{
+  xy_cant_be_null (target);
+
+  target->can_user_define = false;
+
+  char *reason = CHINESE ? "URL将会根据内部实现重写,因此不能自定义"
+                         : "The URL will be rewritten based on internal implementation, so it cannot be customized";
+  target->can_user_define_explain = reason;
+}
+
+
+void
+chef_set_note (Target_t *target, const char *note_zh, const char *note_en)
+{
+  xy_cant_be_null (target);
+
+  const char *msg = CHINESE ? note_zh : note_en;
+
+  if (msg)
+    target->note = xy_strdup (msg);
+}
+
+
+
+/**
+ * @brief 验证该 `id` 所指的贡献者确有其人
+ */
+Contributor_t *
+chef_verify_contributor (const char *id)
+{
+  xy_cant_be_null (id);
+
+  Contributor_t *c = xy_map_get (ProgStore.contributors, id);
+  if (!c)
+    {
+      char error[256];
+      snprintf (error, sizeof (error), "贡献者 %s 不存在, 是否写错？或请在 chsrc-main.c 中登记该贡献者", id);
+      chsrc_panic (error);
+    }
+  return c;
+}
+
+
+/**
+ * @brief 设置 Chef (recipe 负责人)
+ */
+void
+chef_set_chef (Target_t *target, const char *id)
+{
+  xy_cant_be_null (target);
+
+  /* Chef 可为空 */
+  if (!id)
+    {
+      target->chef = NULL;
+      return;
+    }
+
+  Contributor_t *c = chef_verify_contributor (id);
+  target->chef = c;
+}
+
+
+/**
+ * @brief 设置 Cooks (recipe 核心作者)
+ */
+void
+chef_set_cooks (Target_t *target, size_t count, ...)
+{
+  xy_cant_be_null (target);
+
+  if (count == 0)
+    {
+      chsrc_panic ("recipe 一定至少有1位作者(cooks)");
+      return;
+    }
+
+  va_list args;
+  va_start (args, count);
+
+  target->cooks = xy_malloc0 (count * sizeof (Contributor_t*));
+  target->cooks_n = count;
+
+  for (size_t i = 0; i < count; i++)
+    {
+      char *id = va_arg (args, char*);
+      target->cooks[i] = chef_verify_contributor (id);
+    }
+
+  va_end (args);
+}
+
+void
+chef_set_sauciers (Target_t *target, uint32_t count, ...)
+{
+  xy_cant_be_null (target);
+
+  if (count == 0)
+    {
+      target->sauciers = NULL;
+      target->sauciers_n = 0;
+      return;
+    }
+
+  va_list args;
+  va_start (args, count);
+
+  target->sauciers = xy_malloc0 (count * sizeof (Contributor_t*));
+  target->sauciers_n = count;
+
+  for (uint32_t i = 0; i < count; i++)
+    {
+      char *id = va_arg (args, char*);
+      target->sauciers[i] = chef_verify_contributor (id);
+    }
+}
+
+
+
+void
+chef_set_created_on (Target_t *target, char *date)
+{
+  xy_cant_be_null (target);
+  xy_cant_be_null (date);
+
+  target->created_on = xy_strdup (date);
+}
+
+
+void
+chef_set_last_updated (Target_t *target, char *date)
+{
+  xy_cant_be_null (target);
+  xy_cant_be_null (date);
+
+  target->last_updated = xy_strdup (date);
+}
+
+
+void
+chef_set_sources_last_updated (Target_t *target, char *date)
+{
+  xy_cant_be_null (target);
+  xy_cant_be_null (date);
+
+  target->sources_last_updated = xy_strdup (date);
+}
+
+
+/**
+ * @note 某些 target 需要修改 User-Agent
+ * 由于单独测速 (chsrc measure) 的时候也需要进行此项修改，
+ * 所以该函数不能仅仅放在 _setsrc() 里，而是应当放在 _prelude() 里
+ */
+void
+chef_set_user_agent (char *user_agent)
+{
+  ProgStatus.user_agent = user_agent;
+}

src/framework/helper.c

@@ -0,0 +1,44 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * File Name     : helper.c
+ * File Authors  : 曾奥然 <ccmywish@qq.com>
+ * Contributors  : Nul None <nul@none.org>
+ * Created On    : <2025-07-14>
+ * Last Modified : <2025-10-28>
+ *
+ * For chefs (recipe makers) and sometimes framewoker
+ * to do some work not releated to OS operations
+ * ------------------------------------------------------------*/
+
+bool
+hp_is_url (const char *str)
+{
+  return (xy_str_start_with (str, "http://") || xy_str_start_with (str, "https://"));
+}
+
+/**
+ * @return 一律返回新字符串
+ */
+char *
+hp_remove_trailing_slash (char *str)
+{
+  char *newstr = xy_strdup (str);
+  size_t len = strlen (newstr);
+  if (len > 0 && newstr[len - 1] == '/')
+    newstr[len - 1] = '\0';
+  return newstr;
+}
+
+/**
+ * @return 一律返回新字符串
+ */
+char *
+hp_ensure_trailing_slash (char *str)
+{
+  size_t len = strlen (str);
+  if (len == 0 || str[len - 1] == '/')
+    return xy_strdup (str);
+
+  return xy_2strcat (str, "/");
+}

src/framework/mirror.c

@@ -0,0 +1,305 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * File Name     : mirror.c
+ * File Authors  :  曾奥然 <ccmywish@qq.com>
+ *               |   郭恒  <2085471348@qq.com>
+ * Contributors  : Shengwei Chen <414685209@qq.com>
+ *               |  Jialin Lyu  <jialinlvcn@aliyun.com>
+ *               |  Mikachu2333 <mikachu.23333@zohomail.com>
+ *               | BingChunMoLi <bingchunmoli@bingchunmoli.com>
+ *               |
+ * Created On    : <2023-08-29>
+ * Last Modified : <2025-10-07>
+ *
+ * 通用镜像站
+ * ------------------------------------------------------------*/
+
+#define Big_File_ubuntu     "/18.04/ubuntu-18.04.6-desktop-amd64.iso"       // 2.3 GB
+#define Big_File_ctan       "/systems/texlive/Images/texlive.iso"           // 4.8 GB
+#define Big_File_archlinux  "/iso/latest/archlinux-x86_64.iso"              // 800 MB
+#define Big_File_deepin     "/20.9/deepin-desktop-community-20.9-amd64.iso" // 4 GB
+
+/**
+ * 教育网镜像
+ *
+ * @sync https://github.com/RubyMetric/chsrc/wiki
+ *
+ * 排序部分参考 https://github.com/mirrorz-org/oh-my-mirrorz
+ */
+MirrorSite_t MirrorZ =
+{
+  IS_GeneralMirrorSite,
+  "mirrorz", "MirrorZ",  "校园网联合镜像站(MirrorZ)", "https://mirrors.cernet.edu.cn/",
+  {NotSkip,  NA, NA, "https://mirrors.cernet.edu.cn/ubuntu/dists/noble/Contents-amd64.gz", ROUGH}
+},
+
+Tuna =
+{
+  IS_GeneralMirrorSite,
+  "tuna", "TUNA", "清华大学开源软件镜像站", "https://mirrors.tuna.tsinghua.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.tuna.tsinghua.edu.cn/speedtest/1000mb.bin", ROUGH}
+},
+
+/**
+ * @note 2025-03-17 SJTUG 共设两台服务器。思源服务器同步新镜像，致远服务器兼容原 SJTU 镜像站。
+ * @note 有些target（例如flathub）思源站的兼容性不好，可以考虑将两个服务器分开测试
+ */
+
+Sjtug_Zhiyuan =
+{
+  IS_GeneralMirrorSite,
+  "sjtu-zy", "SJTUG-zhiyuan", "上海交通大学致远镜像站", "https://mirrors.sjtug.sjtu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.sjtug.sjtu.edu.cn/ctan" Big_File_ctan, ROUGH}
+},
+
+Sjtug_Siyuan =
+{
+  IS_GeneralMirrorSite,
+  "sjtu-sy", "SJTUG-siyuan", "上海交通大学思源镜像站", "https://mirror.sjtu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirror.sjtu.edu.cn/ctan" Big_File_ctan, ROUGH}
+},
+
+Bfsu =
+{
+  IS_GeneralMirrorSite,
+  "bfsu", "BFSU", "北京外国语大学开源软件镜像站", "https://mirrors.bfsu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.bfsu.edu.cn/speedtest/1000mb.bin", ROUGH}
+},
+
+Ustc =
+{
+  IS_GeneralMirrorSite,
+  "ustc", "USTC", "中国科学技术大学开源软件镜像", "https://mirrors.ustc.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.ustc.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Zju =
+{
+  IS_GeneralMirrorSite,
+  "zju", "ZJU", "浙江大学开源软件镜像站", "https://mirrors.zju.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.zju.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Jlu =
+{
+  IS_GeneralMirrorSite,
+  "jlu", "JLU", "吉林大学开源镜像站", "https://mirrors.jlu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.jlu.edu.cn/_static/speedtest.bin", ROUGH}
+},
+
+Lzuoss =
+{
+  IS_GeneralMirrorSite,
+  "lzu", "LZUOSS", "兰州大学开源社区镜像站", "https://mirror.lzu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirror.lzu.edu.cn/CTAN" Big_File_ctan, ROUGH}
+},
+
+Pku =
+{
+  IS_GeneralMirrorSite,
+  "pku", "PKU", "北京大学开源镜像站", "https://mirrors.pku.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.pku.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Bjtu =
+{
+  IS_GeneralMirrorSite,
+  "bjtu", "BJTU", "北京交通大学自由与开源软件镜像站", "https://mirror.bjtu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirror.bjtu.edu.cn/archlinux" Big_File_archlinux, ROUGH}
+},
+
+Sustech =
+{
+  IS_GeneralMirrorSite,
+  "sustech", "SUSTech", "南方科技大学开源软件镜像站", "https://mirrors.sustech.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.sustech.edu.cn/site/speedtest/1000mb.bin", ROUGH}
+},
+
+Nju =
+{
+  IS_GeneralMirrorSite,
+  "nju", "NJU", "南京大学开源镜像站", "https://mirrors.nju.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.nju.edu.cn/archlinux" Big_File_archlinux, ROUGH}
+},
+
+Xjtu =
+{
+  IS_GeneralMirrorSite,
+  "xjtu", "XJTU", "西安交通大学软件镜像站", "https://mirrors.xjtu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.xjtu.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Hust =
+{
+  IS_GeneralMirrorSite,
+  "hust", "HUST", "华中科技大学开源镜像站", "https://mirrors.hust.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.hust.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Iscas =
+{
+  IS_GeneralMirrorSite,
+  "iscas", "ISCAS", "中科院软件所智能软件研究中心开源镜像站", "https://mirror.iscas.ac.cn/",
+  {NotSkip, NA, NA, "https://mirror.iscas.ac.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Hit =
+{
+  IS_GeneralMirrorSite,
+  "hit", "HIT", "哈尔滨工业大学开源软件镜像站", "https://mirrors.hit.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.hit.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Scau =
+{
+  IS_GeneralMirrorSite,
+  "scau", "SCAU", "华南农业大学开源软件镜像站", "https://mirrors.scau.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.scau.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+NJTech =
+{
+  IS_GeneralMirrorSite,
+  "njtech", "NJTech", "南京工业大学开源软件镜像站", "https://mirrors.njtech.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.njtech.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Nyist =
+{
+  IS_GeneralMirrorSite,
+  "nyist", "NYIST", "南阳理工学院开源软件镜像站", "https://mirror.nyist.edu.cn/",
+  {NotSkip, NA, NA, "https://mirror.nyist.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Sdu =
+{
+  IS_GeneralMirrorSite,
+  "sdu", "SDU", "山东大学镜像站", "https://mirrors.sdu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.sdu.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Qlu =
+{
+  IS_GeneralMirrorSite,
+  "qlu", "QLU", "齐鲁工业大学开源镜像站", "https://mirrors.qlu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.qlu.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Cqupt =
+{
+  IS_GeneralMirrorSite,
+  "cqupt", "CQUPT", "重庆邮电大学开源镜像站", "https://mirrors.cqupt.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.cqupt.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+/**
+ * @note 2023-09-05 封杀策略过严，谨慎使用
+ */
+Cqu =
+{
+  IS_GeneralMirrorSite,
+  "cqu", "CQU", "重庆大学开源软件镜像站", "https://mirrors.cqu.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.cqu.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Neosoft =
+{
+  IS_GeneralMirrorSite,
+  "neosoft", "Neosoft", "大连东软信息学院开源镜像站", "https://mirrors.neusoft.edu.cn/",
+  {NotSkip, NA, NA, "https://mirrors.neusoft.edu.cn/ubuntu-releases" Big_File_ubuntu, ROUGH}
+};
+
+
+
+/**
+ * 商业公司提供的源
+ */
+MirrorSite_t Ali =
+{
+  IS_GeneralMirrorSite,
+  "ali", "Ali OPSX Public", "阿里巴巴开源镜像站(公网)", "https://developer.aliyun.com/mirror/",
+  {NotSkip, NA, NA, "https://mirrors.aliyun.com/ubuntu/ls-lR.gz", ROUGH} // 31MB左右
+},
+/*
+// https://mirrors.cloud.aliyuncs.com/
+Ali_ECS_VPC =
+{
+  IS_GeneralMirrorSite,
+  "ali-ECS-VPC", "Ali OPSX ECS VPC", "阿里巴巴开源镜像站(ECS VPC网络)", "https://developer.aliyun.com/mirror/",
+  {NotSkip, NA, NA, "https://mirrors.cloud.aliyuncs.com/deepin-cd" Big_File_deepin, ROUGH}
+},
+
+// https://mirrors.aliyuncs.com/
+Ali_ECS_classic =
+{
+  IS_GeneralMirrorSite,
+  "ali-ECS", "Ali OPSX ECS", "阿里巴巴开源镜像站(ECS 经典网络)", "https://developer.aliyun.com/mirror/",
+  {NotSkip, NA, NA, "https://mirrors.aliyuncs.com/deepin-cd" Big_File_deepin, ROUGH}
+},
+*/
+
+Tencent =
+{
+  IS_GeneralMirrorSite,
+  "tencent", "Tencent Public", "腾讯软件源(公网)", "https://mirrors.tencent.com/",
+  {NotSkip, NA, NA, "https://mirrors.cloud.tencent.com/mariadb/mariadb-12.1.0/winx64-packages/mariadb-12.1.0-winx64-debugsymbols.zip", ROUGH} // 110MB左右
+},
+/*
+Tencent_Intra =
+{
+  IS_GeneralMirrorSite,
+  "tencent-intra", "Tencent Intranet",  "腾讯软件源(内网)", "https://mirrors.tencent.com/",
+  {NotSkip, NA, NA, "https://mirrors.cloud.tencentyun.com/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+*/
+
+Huawei =
+{
+  IS_GeneralMirrorSite,
+  "huawei",  "Huawei Cloud", "华为开源镜像站",  "https://mirrors.huaweicloud.com/",
+  {NotSkip, NA, NA, "https://mirrors.huaweicloud.com/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+HuaweiCDN =
+{
+  IS_GeneralMirrorSite,
+  "huawei-cdn",  "Huawei Cloud CDN", "华为开源镜像站(CDN)",  "https://repo.huaweicloud.com/",
+  {NotSkip, NA, NA, "https://repo.huaweicloud.com/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+
+Volcengine =
+{
+  IS_GeneralMirrorSite,
+  "volc", "Volcengine", "火山引擎开源软件镜像站(公网)", "https://developer.volcengine.com/mirror/",
+  {NotSkip, NA, NA, "https://mirrors.volces.com/ubuntu-releases" Big_File_ubuntu, ROUGH}
+},
+/*
+Volceengine_Intra =
+{
+  IS_GeneralMirrorSite,
+  "volc-intra",  "Volcengine Intranet", "火山引擎开源软件镜像站(内网)",
+  "https://developer.volcengine.com/mirror/",
+  "https://mirrors.ivolces.com/ubuntu-releases" Big_File_ubuntu, ROUGH},
+*/
+
+
+/**
+ * @note 2025-06-20 网易开源镜像站的速度始终过低，不建议再使用
+ */
+Netease =
+{
+  IS_GeneralMirrorSite,
+  "netease", "Netease", "网易开源镜像站", "https://mirrors.163.com/",
+  {NotSkip, NA, NA, "https://mirrors.163.com/deepin-cd" Big_File_deepin, ROUGH}
+},
+
+/**
+ * @note 2025-06-20 搜狐开源镜像站的速度始终过低，不建议再使用
+ */
+Sohu =
+{
+  IS_GeneralMirrorSite,
+  "sohu", "SOHU", "搜狐开源镜像站", "https://mirrors.sohu.com/",
+  {NotSkip, NA, NA, "https://mirrors.sohu.com/deepin-cd" Big_File_deepin, ROUGH}
+};

src/framework/struct.h

@@ -0,0 +1,179 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * File Name     :  struct.h
+ * File Authors  :  曾奥然 <ccmywish@qq.com>
+ *               |   郭恒  <2085471348@qq.com>
+ * Contributors  : Shengwei Chen <414685209@qq.com>
+ *               |
+ * Created On    : <2023-08-29>
+ * Last Modified : <2025-08-22>
+ *
+ * chsrc struct
+ * ------------------------------------------------------------*/
+
+typedef struct ProviderSpeedMeasureInfo_t
+{
+  bool  skip;           /* 是否默认跳过 */
+  char *skip_reason_CN; /* 跳过的原因（中文）*/
+  char *skip_reason_EN; /* 跳过的原因（英文）*/
+  char *url;            /* 测速链接 */
+  bool  accurate;       /* 是否为精准测速，上游源和专用镜像站为 ACCURATE，通用镜像站为 ROUGH */
+}
+ProviderSpeedMeasureInfo_t;
+
+#define SKIP    true
+#define NotSkip false
+#define ToFill  NULL
+#define NA		  NULL
+
+#define ACCURATE true
+#define ROUGH    false
+
+typedef enum ProviderType_t
+{
+  IS_GeneralMirrorSite,   /* 通用镜像站 */
+  IS_DedicatedMirrorSite, /* 专用镜像站 */
+  IS_UpstreamProvider,    /* 上游默认源 */
+  IS_UserDefinedProvider, /* 用户提供   */
+}
+ProviderType_t;
+
+typedef struct SourceProvider_t
+{
+  const ProviderType_t type; /* 类型 */
+  const char *code; /* 用于用户指定某一 Provider */
+  const char *abbr; /* 需要使用 Provider 的英文名时，用这个代替，因为大部分 Provider 没有提供正式的英文名 */
+  const char *name; /* Provider 中文名 */
+  const char *site; /* Provider 首页   */
+  ProviderSpeedMeasureInfo_t psmi;
+}
+SourceProvider_t;
+
+typedef SourceProvider_t MirrorSite_t;
+
+SourceProvider_t UpstreamProvider =
+{
+  IS_UpstreamProvider,
+  /* 引入新的上游默认源时，请使下面第一行的前三个字段保持不变，只添加第四个字段 */
+  "upstream", "Upstream", "上游默认源", NULL,
+  /* 引入新的上游默认源时，请完全修改下面这个结构体，可使用 def_need_measure_info 宏 */
+  {SKIP, "URL未知，邀您参与贡献!", "URL unknown, welcome to contribute!", NULL, ACCURATE}
+};
+
+#define def_need_measure_info   {SKIP, "缺乏较大的测速对象，邀您参与贡献!", "Lack of large object URL, welcome to contribute!", NULL, ACCURATE}
+
+SourceProvider_t UserDefinedProvider =
+{
+  IS_UserDefinedProvider,
+  "user", "用户自定义", "用户自定义", NULL,
+  {SKIP, "用户自定义源不测速", "SKIP for user-defined source", NULL, ACCURATE}
+};
+
+
+typedef struct Source_t
+{
+  union {
+    SourceProvider_t *provider;
+    MirrorSite_t     *mirror;
+  };
+  /* 用于换源的 URL */
+  char *url;
+
+  /* 对该 source 的专用测速链接，这就是精准测速 */
+  char *speed_measure_url;
+}
+Source_t;
+
+/* 不用给专用测速链接，因为 Upstream 的整体测速链接已是精准测速 */
+#define DelegateToUpstream  NULL
+/* 不用给专用测速链接，因为该镜像站是专用镜像站，其整体测速链接已是精准测速 */
+#define DelegateToMirror    NULL
+/* 看到该注释的贡献者，你可以帮忙寻找专用测速链接 */
+#define NeedContribute      NULL
+/* 由 prelude() 填充 */
+#define FeedByPrelude NULL
+
+
+typedef enum Capability_t
+{
+  CanNot,
+  FullyCan,
+  PartiallyCan
+}
+Capability_t;
+
+
+
+typedef struct Contributor_t
+{
+  char *id;     /* 全局唯一贡献者标识符，防止反复写信息，以 @ 开头 */
+  char *name;   /* 贡献者姓名; 鉴于该项目完全依赖于贡献者，建议留下真实姓名或者昵称 */
+  char *email;
+  char *display_name; /* recipe 结束时会显示贡献者信息，如果你不愿显示真实姓名或者昵称，可以另外提供一个名字 */
+}
+Contributor_t;
+
+
+typedef struct Target_t
+{
+  /* 以 / 为分隔符的多个目标别名 */
+  char *aliases;
+
+  void (*getfn)   (char *option);
+  void (*setfn)   (char *option);
+  void (*resetfn) (char *option);
+
+  /* 初始化函数，用于填充该 struct 的各种信息 */
+  void (*preludefn) (void);
+  bool inited; /* 是否执行过了 preludefn() */
+
+  Source_t *sources;
+       int  sources_n;
+
+
+  /* Features */
+  bool  can_english;        /* 是否支持英文输出 */
+
+  bool  can_user_define;    /* 是否支持用户自定义URL来换源 */
+  char *can_user_define_explain; /* 用户自定义URL的说明 */
+
+  Capability_t cap_local;  /* 是否支持 local mode */
+  char *cap_local_explain; /* local mode 的说明 */
+
+  char *note;              /* 备注 */
+
+
+  /* recipe 维护信息 */
+  char *created_on;
+  char *last_updated;
+  char *sources_last_updated;
+
+  Contributor_t  *chef;     /* 该 recipe *当前*的总负责人 (可以任职也可以休职) */
+  Contributor_t **cooks;    /* 该 recipe 的主要作者 */
+            int   cooks_n;
+  Contributor_t **sauciers; /* 该 recipe 的次要贡献者 (除主要作者外的其他人) */
+            int   sauciers_n;
+}
+Target_t;
+
+
+
+#define def_target(t, aliases) void t##_getsrc(char *option);void t##_setsrc(char *option);void t##_resetsrc(char *option); Target_t t##_target={aliases};
+
+#define chef_allow_gsr(t) this->getfn = t##_getsrc; this->setfn = t##_setsrc; this->resetfn = t##_resetsrc;
+#define chef_allow_s(t)   this->getfn = NULL;       this->setfn = t##_setsrc; this->resetfn = NULL;
+#define chef_allow_sr(t)  this->getfn = NULL;       this->setfn = t##_setsrc; this->resetfn = t##_resetsrc;
+#define chef_allow_gs(t)  this->getfn = t##_getsrc; this->setfn = t##_setsrc; this->resetfn = NULL;
+#define chef_allow_NOOP(t)
+#define chef_prep_this(t,op) Target_t *this = &t##_target; this->inited = true; chef_allow_##op(t);
+
+#define use_this(t) Target_t *this = &t##_target;
+#define chsrc_use_this_source(t) Target_t *this = &t##_target; Source_t source = chsrc_yield_source_and_confirm (this, option);
+
+#define def_sources_begin()  Source_t sources[] = {
+#define def_sources_end()    }; \
+  this->sources_n = xy_c_array_len(sources); \
+  char *_sources_storage = xy_malloc0 (sizeof(sources)); \
+  memcpy (_sources_storage, sources, sizeof(sources)); \
+  this->sources = (Source_t *)_sources_storage;

src/framework/version.h

@@ -0,0 +1,23 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * File Name     : version.h
+ * File Authors  : 曾奥然      <ccmywish@qq.com>
+ *               | Mikachu2333 <mikachu.23333@zohomail.com>
+ * Contributors  : Nil Null    <nil@null.org>
+ *               |
+ * Created On    : <2025-10-10>
+ * Last Modified : <See 'Chsrc_Release_Date'>
+ *
+ * 发布新版本前请修改此文件
+ * ------------------------------------------------------------*/
+
+#define Chsrc_Version        "0.2.3.4"
+
+// 以下四个宏仅用于 resource/chsrc.rc
+#define Chsrc_Version_Major  0
+#define Chsrc_Version_Minor  2
+#define Chsrc_Version_Patch  3
+#define Chsrc_Version_Pre    4
+
+#define Chsrc_Release_Date   "2025/12/18"

src/rawstr4c.md

@@ -0,0 +1,225 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GPL-3.0-or-later
+ ! -------------------------------------------------------------
+ ! Config Type   : rawstr4c (Markdown)
+ ! Config Authors: 曾奥然 <ccmywish@qq.com>
+ ! Contributors  : Nil Null <nil@null.org>
+ ! Created On    : <2025-07-22>
+ ! Last Modified : <2025-10-29>
+ ! ---------------------------------------------------------- -->
+
+# [rawstr4c] input for chsrc
+
+`chsrc` 使用的 C标准 (最低要求) 是 `gnu11` (`c11` 的超集)，这也就是说，我们项目是可以，而且是 **推荐** 同时混用 `R"()"` 和 `rawstr4c` 的
+
+`LLVM` 对 `R"()"` 的支持是在 2024年07月 以后。但是在 GitHub Actions 中，所有出现的 `LLVM` 版本都太低了，
+这使得我们被迫把已经写过的 `R"()"` 全部再转换为 `rawstr4c`.
+
+用户端的编译器一般比较新，然而可能也没有新到如此的地步，通过使用 `rawstr4c` 我们也放宽了用户对编译器的要求。
+
+我们预计等2~3年后，在项目中重新开始 `R"()"` 的写法
+
+<br>
+
+- prefix = `RAWSTR_chsrc`
+- output = `:global-variable-only-header`
+- translate = `:oct`
+- no-postfix = `true`
+
+<br>
+
+## 中文帮助
+
+- name = `USAGE_CHINESE`
+
+```
+名称:
+   chsrc - Change Source - (GPLv3+)
+
+版本:
+   @ver@
+
+使用:
+   chsrc <command> [options] [target] [mirror]
+
+命令:
+   help,  h                   打印此帮助，或 -h, --help
+   issue, i                   查看相关issue
+
+   list, ls, l                列出可用镜像站和可换源目标
+   list  mirror|target        列出支持的: 镜像站/换源目标
+   list  os|lang|ware         列出支持的: 操作系统/编程语言/软件
+   list   <target>            查看该目标可用源与支持功能
+
+   measure, m, cesu <target>  对该目标所有源测速
+
+   get, g <target>            查看该目标当前源的使用情况
+
+   set, s <target>            换源，自动测速后挑选最快源
+   set    <target>  first     换源，使用维护团队测速第一的源
+   set    <target> <mirror>   换源，指定使用某镜像站 (通过list <target>查看)
+   set    <target>  <URL>     换源，用户自定义源URL
+   reset  <target>            重置，使用上游默认使用的源
+
+选项:
+   -dry                       Dry Run，模拟换源过程，命令仅打印并不运行
+   -local                     仅对本项目而非全局换源 (通过ls <target>查看支持情况)
+   -ipv6                      使用IPv6测速
+   -en(glish)                 使用英文输出
+   -no-color                  无颜色输出
+
+维护:
+   邀请您担任  Chef, 为用户把关您熟悉的 recipe
+
+   源代码地址: https://github.com/RubyMetric/chsrc
+   成为维护者: https://github.com/RubyMetric/chsrc/issues/275
+```
+
+<br>
+
+
+
+## 英文帮助
+
+- name = `USAGE_ENGLISH`
+
+```
+NAME:
+   chsrc - Change Source - (GPLv3+)
+
+VERSION:
+   @ver@
+
+USAGE:
+   chsrc <command> [options] [target] [mirror]
+
+COMMANDS:
+   help,  h                   Print this help, or -h, --help
+   issue, i                   See related issues
+
+   list, ls, l                List available mirror sites and supported targets
+   list  mirror|target        List supported:  mirror sites/supported targets
+   list  os|lang|ware         List supported: OSes/Programming Languages/Softwares
+   list   <target>            View available sources and supporting features for <target>
+
+   measure, m, cesu <target>  Measure velocity of all sources of <target>
+
+   get, g <target>            View the current source state for <target>
+
+   set, s <target>            Change source, select the fastest source by automatic speed measurement
+   set    <target>  first     Change source, select the fastest source measured by the maintainers team
+   set    <target> <mirror>   Change source, specify a mirror site (Via `list <target>`)
+   set    <target>  <URL>     Change source, using user-defined source URL
+   reset  <target>            Reset  source to the upstream's default
+
+OPTIONS:
+   -dry                       Dry Run. Simulate the source changing process, command only prints, not run
+   -local                     Change source only for this project rather than globally (Via `ls <target>`)
+   -ipv6                      Speed measurement using IPv6
+   -en(glish)                 Output in English
+   -no-color                  Output without color
+
+MAINTAIN:
+   We invite you to become a Chef to ensure the quality of recipes you are familiar with for users:
+
+   Source Code:               @url@
+   Become a Maintainer:       https://github.com/RubyMetric/chsrc/issues/275
+```
+
+<br>
+
+
+
+## for `chsrc -v`
+
+- name = `for__v_CHINESE`
+
+```
+chsrc @ver@
+
+Copyright (C) 2023-2025 曾奥然, 郭恒
+许可证 GPLv3+：GNU GPL 第 3 版或更高版本 <https://gnu.org/licenses/gpl.html>
+这是自由软件：您可以自由修改和分发它。
+在法律允许的最大范围内，本软件按'原样'提供，不作任何明示或暗示的保证。
+
+由作者：曾奥然、郭恒，协作者：Mikachu2333、Happy Game 以及各位贡献者开发。(详见 chsrc-main.c, 或 `chsrc ls <target>`)
+```
+
+<br>
+
+
+
+## for `chsrc -v -en`
+
+- name = `for__v_ENGLISH`
+
+```
+chsrc @ver@
+
+Copyright (C) 2023-2025 Aoran Zeng, Heng Guo
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+
+Written by authors: Aoran Zeng, Heng Guo, collaborators: Mikachu2333, Happy Game, and contributors. (See chsrc-main.c, or `chsrc ls <target>`)
+```
+
+<br>
+
+
+
+## for `chsrc issue`
+
+- name = `for_issue`
+
+```
+我们同时在 GitHub 和 Gitee 接受 issue 和 Bug 报告:
+
+  - https://github.com/RubyMetric/chsrc/issues
+  - https://gitee.com/RubyMetric/chsrc/issues
+
+
+欢迎参与具体任务:
+
+   Shell auto-completion 终端命令自动补全:
+
+        https://github.com/RubyMetric/chsrc/issues/204
+
+   搜集上游默认源地址，帮助进行 chsrc reset:
+
+        https://github.com/RubyMetric/chsrc/issues/111
+
+   搜集测速地址，进行精准测速:
+
+        https://github.com/RubyMetric/chsrc/issues/205
+
+   帮助没有预编译的平台编写 shell 脚本:
+
+        https://github.com/RubyMetric/chsrc/issues/230
+
+
+支持的通用镜像站:
+  - https://github.com/RubyMetric/chsrc/wiki
+
+```
+
+<br>
+
+
+
+## 最后告诉用户一些维护信息
+
+- name = `op_epilogue`
+
+```
+
+   * 精准测速: 能真实反映你未来使用该资源时的速度，因为它直接测量你关注的那个资源。
+   * 模糊测速: 仅代表该镜像站提供服务的一个可能速度。因而可能会出现测速数值较高，但实际使用体验不佳的现象。
+当你遇到模糊测速时，请尽可能向我们提交准确的测速链接: chsrc issue
+```
+
+<br>
+
+
+
+[rawstr4c]: https://github.com/RubyMetric/rawstr4c

src/recipe/lang/Clojure.c

@@ -1,33 +1,55 @@
 /** ------------------------------------------------------------
  * SPDX-License-Identifier: GPL-3.0-or-later
- * -------------------------------------------------------------
- * File Authors  : Aoran Zeng <ccmywish@qq.com>
- * Contributors  :  Nil Null  <nil@null.org>
- * Created On    : <2023-09-10>
- * Last Modified : <2024-08-09>
  * ------------------------------------------------------------*/
 
-/**
- * @time 2023-09-10 更新
- * @note 不太好换，且用户可能不多，我们暂时只给用户提供文档
- */
-static SourceInfo
-pl_clojure_sources[] = {
-  {&Upstream,       NULL},
-  {&Tuna,          "https://mirrors.tuna.tsinghua.edu.cn/help/clojars/"},
-  {&Ustc,          "https://mirrors.ustc.edu.cn/help/clojars.html"}
-};
-def_sources_n(pl_clojure);
+def_target(pl_clojure, "clojure/clojars/cloj/lein");
+
+void
+pl_clojure_prelude ()
+{
+  chef_prep_this (pl_clojure, s);
+
+  chef_set_created_on   (this, "2023-09-10");
+  chef_set_last_updated (this, "2025-08-10");
+  chef_set_sources_last_updated (this, "2025-08-21");
+
+  chef_set_chef (this, NULL);
+  chef_set_cooks (this, 1, "@ccmywish");
+  chef_set_sauciers (this, 1, "@hezonglun");
+
+  chef_allow_local_mode (this, FullyCan, NULL, NULL);
+  chef_deny_english(this);
+  chef_allow_user_define(this);
+
+  def_sources_begin()
+  {&UpstreamProvider,"https://repo.clojars.org/", DelegateToUpstream},
+  {&MirrorZ,         "https://mirrors.cernet.edu.cn/clojars/",        DelegateToMirror},
+  {&Tuna,            "https://mirrors.tuna.tsinghua.edu.cn/clojars/", DelegateToMirror},
+  {&Nju,             "https://mirror.nju.edu.cn/clojars/",             DelegateToMirror},
+  {&Nyist,           "https://mirror.nyist.edu.cn/clojars/",          DelegateToMirror},
+  {&Ustc,            "https://mirrors.ustc.edu.cn/clojars/",          DelegateToMirror},
+  {&Iscas,           "https://mirror.iscas.ac.cn/clojars/",           DelegateToMirror}
+  def_sources_end()
+}
 
 
 void
 pl_clojure_setsrc (char *option)
 {
-  chsrc_yield_source_and_confirm (pl_clojure);
+  chsrc_use_this_source (pl_clojure);
 
-  chsrc_note2 ("抱歉，Clojure换源较复杂，您可手动查阅并换源:");
-  puts (source.url);
-  chsrc_conclude (&source, ChsrcTypeManual);
+  if (chsrc_in_local_mode())
+    {
+      chsrc_note2 ("请在项目根目录中的 project.clj 中手动添加 :mirrors 关键字:");
+      char *config = xy_str_gsub (RAWSTR_pl_clojure_project_clj, "@url@", source.url);
+      println (config);
+    }
+  else
+    {
+      chsrc_note2 ("请在 ~/.lein/projfiles.clj 中手动添加 :mirrors 关键字:");
+      char *config = xy_str_gsub (RAWSTR_pl_clojure_projfiles_clj, "@url@", source.url);
+      println (config);
+    }
+
+  chsrc_conclude (&source);
 }
-
-def_target_s (pl_clojure);

src/recipe/lang/Dart.c

@@ -1,118 +0,0 @@
-/** ------------------------------------------------------------
- * SPDX-License-Identifier: GPL-3.0-or-later
- * -------------------------------------------------------------
- * File Authors  : Aoran Zeng <ccmywish@qq.com>
- * Contributors  :  Nil Null  <nil@null.org>
- * Created On    : <2023-09-10>
- * Last Modified : <2024-08-28>
- * Revision      :      2
- * ------------------------------------------------------------*/
-
-/**
- * @time 2023-09-10 更新
- * @note {
- *   我们这里挑选的必须也支持 Flutter
- *   我们将会在setsrc函数中生成
- *     1. https://mirrors.tuna.tsinghua.edu.cn/dart-pub
- *     2. https://mirrors.tuna.tsinghua.edu.cn/flutter
- * }
- */
-static SourceInfo
-pl_dart_sources[] = {
-  {&Upstream,       NULL},
-  // {&Sjtug_Zhiyuan, "https://mirror.sjtu.edu.cn/"}, // 不确定SJTUG的flutter镜像给的对不对
-  {&Tuna,          "https://mirrors.tuna.tsinghua.edu.cn/"},
-  {&Tencent,       "https://mirrors.cloud.tencent.com/"},
-  {&Nju,           "https://mirror.nju.edu.cn/"}
-};
-def_sources_n(pl_dart);
-
-
-void
-pl_dart_getsrc (char *option)
-{
-  char *cmd = NULL;
-  if (xy_on_windows)
-    {
-      cmd = "set PUB_HOSTED_URL & set FLUTTER_STORAGE_BASE_URL";
-      chsrc_run (cmd, RunOpt_Default);
-    }
-  else
-    {
-      cmd = "echo $PUB_HOSTED_URL; echo $FLUTTER_STORAGE_BASE_URL";
-      chsrc_run (cmd, RunOpt_Default);
-    }
-}
-
-/**
- * Dart pub 换源，参考：https://mirrors.tuna.tsinghua.edu.cn/help/dart-pub/
- */
-void
-pl_dart_setsrc (char *option)
-{
-  chsrc_yield_source_and_confirm (pl_dart);
-
-  char *towrite1, *towrite2 = NULL;
-
-  char *pub = xy_2strjoin (source.url, "dart-pub");
-  char *flutter = xy_2strjoin (source.url, "flutter");
-
-  if (xy_on_windows)
-    {
-      towrite1 = xy_strjoin (3, "$env:PUB_HOSTED_URL = \"", pub, "\"");
-      towrite2 = xy_strjoin (3, "$env:FLUTTER_STORAGE_BASE_URL = \"", flutter, "\"");
-
-      if (xy_file_exist (xy_win_powershell_profile))
-        {
-          chsrc_append_to_file (towrite1, xy_win_powershell_profile);
-          chsrc_append_to_file (towrite2, xy_win_powershell_profile);
-        }
-
-      if (xy_file_exist (xy_win_powershellv5_profile))
-        {
-          chsrc_append_to_file (towrite1, xy_win_powershellv5_profile);
-          chsrc_append_to_file (towrite2, xy_win_powershellv5_profile);
-        }
-    }
-  else
-    {
-      char *zshrc  = "~/.zshrc";
-      char *bashrc = "~/.bashrc";
-
-      chsrc_backup (zshrc);
-      towrite1 = xy_strjoin (3, "export PUB_HOSTED_URL=\"", pub, "\"");
-      towrite2 = xy_strjoin (3, "export FLUTTER_STORAGE_BASE_URL=\"", flutter, "\"");
-      chsrc_append_to_file (towrite1, zshrc);
-      chsrc_append_to_file (towrite2, zshrc);
-
-      if (xy_file_exist (bashrc))
-        {
-          chsrc_backup (bashrc);
-          chsrc_append_to_file (towrite1, bashrc);
-          chsrc_append_to_file (towrite2, bashrc);
-        }
-    }
-  chsrc_conclude (&source, ChsrcTypeAuto);
-}
-
-
-FeatInfo
-pl_dart_feat (char *option)
-{
-  FeatInfo fi = {0};
-
-  fi.can_get = true;
-  fi.can_reset = false;
-
-  fi.stcan_locally = CanNot;
-  fi.locally = NULL;
-  fi.can_english = true;
-
-  /* 该换源方案中，URL存在拼凑，因此不能让用户手动使用某URL来换源 */
-  fi.can_user_define = false;
-
-  fi.note = "该换源通过写入环境变量实现，若多次换源，请手动清理profile文件";
-  return fi;
-}
-
-def_target_gsf(pl_dart);

src/recipe/lang/Dart/Flutter.c

@@ -0,0 +1,88 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * ------------------------------------------------------------*/
+
+def_target(pl_dart_flutter, "flutter");
+
+void
+pl_dart_flutter_prelude (void)
+{
+  chef_prep_this (pl_dart_flutter, gsr);
+
+  chef_set_created_on   (this, "2023-09-10");
+  chef_set_last_updated (this, "2025-07-11");
+  chef_set_sources_last_updated (this, "2025-04-15");
+
+  chef_set_chef (this, NULL);
+  chef_set_cooks (this, 1, "@ccmywish");
+  chef_set_sauciers (this, 2, "@czyt", "@xrgzs");
+
+  chef_allow_local_mode (this, CanNot, NULL, NULL);
+  chef_allow_english(this);
+  chef_allow_user_define(this);
+
+  def_sources_begin()
+  {&UpstreamProvider, "https://storage.googleapis.com", FeedByPrelude},
+  {&FlutterCN,        "https://storage.flutter-io.cn",  FeedByPrelude},
+  {&Sjtug_Zhiyuan,    "https://mirror.sjtu.edu.cn",     FeedByPrelude }, /* 官方文档也没有给后缀，怀疑是否存在问题 */
+  {&Tuna,             "https://mirrors.tuna.tsinghua.edu.cn/flutter", FeedByPrelude},
+  {&Nju,              "https://mirror.nju.edu.cn/flutter", FeedByPrelude}
+  def_sources_end()
+
+  chef_set_sources_speed_measure_url_with_postfix (this, "/flutter_infra_release/releases/stable/linux/flutter_linux_v1.0.0-stable.tar.xz");
+}
+
+
+/**
+ * chsrc get flutter
+ */
+void
+pl_dart_flutter_getsrc (char *option)
+{
+  chsrc_view_env ("FLUTTER_STORAGE_BASE_URL", NULL);
+}
+
+
+/**
+ * @consult https://mirrors.tuna.tsinghua.edu.cn/flutter
+ * @consult https://mirror.sjtu.edu.cn/docs/flutter_infra
+ * @consult https://mirror.nju.edu.cn/mirrorz-help/flutter/?mirror=NJU
+ */
+void
+pl_dart_flutter_setsrc (char *option)
+{
+  chsrc_use_this_source (pl_dart_flutter);
+
+  char *w = NULL;
+  char *cmd = NULL;
+  if (xy.on_windows)
+    {
+      cmd = xy_strcat (3, "setx FLUTTER_STORAGE_BASE_URL \"", source.url, "\"");
+      chsrc_run (cmd, RunOpt_No_Last_New_Line);
+    }
+  else
+    {
+      char *zshrc  = xy_zshrc;
+      char *bashrc = xy_bashrc;
+
+      chsrc_backup (zshrc);
+      w = xy_strcat (3, "export FLUTTER_STORAGE_BASE_URL=\"", source.url, "\"\n");
+      chsrc_append_to_file (w, zshrc);
+
+      if (xy_file_exist (bashrc))
+        {
+          chsrc_backup (bashrc);
+          chsrc_append_to_file (w, bashrc);
+        }
+    }
+
+  chsrc_determine_chgtype (ChgType_Auto);
+  chsrc_conclude (&source);
+}
+
+
+void
+pl_dart_flutter_resetsrc (char *option)
+{
+  pl_dart_flutter_setsrc (option);
+}

src/recipe/lang/Dart/Pub.c

@@ -0,0 +1,85 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * ------------------------------------------------------------*/
+
+def_target(pl_dart, "dart/pub");
+
+void
+pl_dart_prelude (void)
+{
+  chef_prep_this (pl_dart, gsr);
+
+  chef_set_created_on   (this, "2023-09-10");
+  chef_set_last_updated (this, "2025-07-11");
+  chef_set_sources_last_updated (this, "2025-04-15");
+
+  chef_set_chef (this, NULL);
+  chef_set_cooks (this, 1, "@ccmywish");
+  chef_set_sauciers (this, 2, "@czyt", "@xrgzs");
+
+  chef_allow_local_mode (this, FullyCan, NULL, NULL);
+  chef_allow_english(this);
+  chef_allow_user_define(this);
+
+  def_sources_begin()
+  {&UpstreamProvider, "https://pub.dev",           FeedByPrelude},
+  {&FlutterCN,        "https://pub.flutter-io.cn", FeedByPrelude},
+  {&Sjtug_Zhiyuan,    "https://mirror.sjtu.edu.cn/dart-pub", FeedByPrelude},
+  {&Tuna,             "https://mirrors.tuna.tsinghua.edu.cn/dart-pub", FeedByPrelude},
+  {&Nju,              "https://mirror.nju.edu.cn/dart-pub", FeedByPrelude}
+  def_sources_end()
+
+  chef_set_sources_speed_measure_url_with_postfix (this, "/packages/flutter_vision/versions/1.1.4.tar.gz");
+}
+
+
+void
+pl_dart_getsrc (char *option)
+{
+  chsrc_view_env ("PUB_HOSTED_URL", NULL);
+}
+
+/**
+ * @consult https://mirrors.tuna.tsinghua.edu.cn/help/dart-pub/
+ * @consult https://mirror.sjtu.edu.cn/docs/dart-pub
+ * @consult https://mirror.nju.edu.cn/mirrorz-help/dart-pub/?mirror=NJU
+ */
+void
+pl_dart_setsrc (char *option)
+{
+  chsrc_use_this_source (pl_dart);
+
+  char *w = NULL;
+  char *cmd = NULL;
+  if (xy.on_windows)
+    {
+      cmd = xy_strcat (3, "setx PUB_HOSTED_URL \"", source.url, "\"");
+      chsrc_run (cmd, RunOpt_No_Last_New_Line);
+    }
+  else
+    {
+      char *zshrc  = xy_zshrc;
+      char *bashrc = xy_bashrc;
+
+      chsrc_backup (zshrc);
+      w = xy_strcat (3, "export PUB_HOSTED_URL=\"", source.url, "\"\n");
+
+      chsrc_append_to_file (w, zshrc);
+
+      if (xy_file_exist (bashrc))
+        {
+          chsrc_backup (bashrc);
+          chsrc_append_to_file (w, bashrc);
+        }
+    }
+
+  chsrc_determine_chgtype (ChgType_Auto);
+  chsrc_conclude (&source);
+}
+
+
+void
+pl_dart_resetsrc (char *option)
+{
+  pl_dart_setsrc (option);
+}