From 1a4a59e9c5bd8c915353e26ea871decaae2b3043 Mon Sep 17 00:00:00 2001
From: Aoran Zeng <ccmywish@qq.com>
Date: Tue, 24 Feb 2026 11:09:00 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BE=9B=20`chef=5Fset=5Fos=5Fscope()?=
 =?UTF-8?q?`=20=E5=BF=AB=E6=8D=B7=E5=87=BD=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/framework/chef.c | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/src/framework/chef.c b/src/framework/chef.c
index ab9e607..ee53f1c 100644
--- a/src/framework/chef.c
+++ b/src/framework/chef.c
@@ -5,7 +5,7 @@
  * File Authors  : @ccmywish
  * Contributors  : @BingChunMoLi
  * Created On    : <2025-08-09>
- * Last Modified : <2026-01-21>
+ * Last Modified : <2026-02-24>
  *
  * chef DSL: for chefs (recipe makers) to define a target
  * ------------------------------------------------------------*/
@@ -341,6 +341,21 @@ chef_set_default_scope (Target_t *target, Scope_t scope)
 }
 
 
+/**
+ * @brief 由于操作系统相关的 target 换源都是系统级，所以 scope 都是固定的，我们提供此快捷函数来设置
+ */
+void
+chef_set_os_scope (Target_t *target)
+{
+  xy_cant_be_null (target);
+
+  chef_set_scope_cap (target, ProjectScope, ScopeCap_Unable);
+  chef_set_scope_cap (target, UserScope,    ScopeCap_Unable);
+  chef_set_scope_cap (target, SystemScope,  ScopeCap_Able_And_Implemented);
+
+  chef_set_default_scope (target, SystemScope);
+}
+
 
 void
 chef_allow_local_mode (Target_t *target, Capability_t cap, const char *explain_zh, const char *explain_en)