From 6bf80571d4987a4f4a033ae533b4d78c486e3800 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B8=AD=E9=B8=AD=E3=80=8C=E3=82=AB=E3=83=A2=E3=80=8D?= <89643991+DuckDuckStudio@users.noreply.github.com> Date: Wed, 29 Oct 2025 06:48:41 +0800 Subject: [PATCH 1/5] =?UTF-8?q?docs:=20=E9=85=8D=E7=BD=AE=E6=96=87?= =?UTF-8?q?=E4=BB=B6=201.2=20=E8=8D=89=E6=A1=88=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/config/1.1/README.md | 2 +- docs/config/1.2/README.md | 20 +++++++++ docs/config/1.2/config.jsonc | 81 ++++++++++++++++++++++++++++++++++++ 3 files changed, 102 insertions(+), 1 deletion(-) create mode 100644 docs/config/1.2/README.md create mode 100644 docs/config/1.2/config.jsonc diff --git a/docs/config/1.1/README.md b/docs/config/1.1/README.md index 46439fb..19a32ed 100644 --- a/docs/config/1.1/README.md +++ b/docs/config/1.1/README.md @@ -7,7 +7,7 @@ ## 描述 这是 Sundry 的配置文件 (`~/DuckStudio/Sundry/config.json`) 的 1.1 版本。**有关配置文件的详细说明，请参见 jsonc 中的注释。** -此版本的配置文件适用 Sundry 1.4.2 及后续版本。 +此版本的配置文件适用 Sundry 1.4.2 - Sundry 1.4.3。 ### 与 1.0 版本的区别 > [!WARNING] diff --git a/docs/config/1.2/README.md b/docs/config/1.2/README.md new file mode 100644 index 0000000..967869d --- /dev/null +++ b/docs/config/1.2/README.md @@ -0,0 +1,20 @@ +# Sundry 配置文件 版本 1.2 + +| jsonc | json schema | +|-----|-----| +| [config.jsonc](config.jsonc) | [1.2.json](https://github.com/DuckDuckStudio/yazicbs.github.io/blob/main/Tools/Sundry/config/schema/1.2.json) | + +## 描述 +这是 Sundry 的配置文件 (`~/DuckStudio/Sundry/config.json`) 的 1.2 版本。**有关配置文件的详细说明，请参见 jsonc 中的注释。** + +此版本的配置文件适用 Sundry 1.5.x 版本。 + +### 与 1.1 版本的区别 + +1.2 版本的配置文件添加了几个可选配置: + +| 配置项 | 作用 | 默认值 | +|-----|-----|-----| +| `debug` | 调试模式开关，打开后会输出一些调试信息，除非需要不建议打开 | `false` (bool) | +| `cache.*` | 缓存开关，用于控制是否自动缓存某些内容 | / | +| `cache.validate.schema` | 控制是否缓存验证清单时使用的 yaml schema | `true` (bool) | diff --git a/docs/config/1.2/config.jsonc b/docs/config/1.2/config.jsonc new file mode 100644 index 0000000..a5e8596 --- /dev/null +++ b/docs/config/1.2/config.jsonc @@ -0,0 +1,81 @@ +// Sundry config.json 版本 1.2 示例 +// 相关配置项的 key 必须使用小写 + +{ + "$schema": "https://duckduckstudio.github.io/yazicbs.github.io/Tools/Sundry/config/schema/1.1.json", + + // 配置文件的版本 + // develop: DuckDuckStudio/Sundry main 分支最新提交的版本 + "version": "1.2", // str + + // 调试模式开关 + "debug": false, // bool + + "paths": { + // 您的 winget-pkgs 本地仓库路径 + "winget-pkgs": "", // str + + // 您的 winget-tools 本地仓库路径 + "winget-tools": "" // str + }, + + "repos": { + // 您的 winget-pkgs 仓库 + "winget-pkgs": "", // str, owner/repo + + // 您的 winget-tools 仓库 + "winget-tools": "" // str, owner/repo + }, + + "git": { + // 是否对提交签名 + "signature": false // bool + }, + + "github": { + "pr": { + // 是否允许维护者修改您的 PR 内容 + "maintainer_can_modify": false // bool + } + }, + + "tools": { + "verify": { + // 暂未实现 + // verify 时验证清单中的 URL 是否有效 (#68) + "check_url": false, // bool + + // 暂未实现 + // 在非干净的 Windows 上验证时显示警告 (#99) + // TODO: 这个配置会不会太长了？ + "show_warning_on_non-clean_windows": false // bool + }, + "prune": { + "remote": { + // 暂未实现 + // prune 时清理远程中已合并的 PR 的分支 (#98) + "prune_merged_branches": false, // bool + + // 暂未实现 + // prune 时清理远程中已关闭的 PR 的分支 (#98) + "prune_closed_branches": false // bool + } + } + }, + + // 缓存开关 + "cache": { + "validate": { + // 是否缓存验证清单时使用的 yaml schema + "schema": true // bool + } + }, + + // ================= 待定 / 其他分支兼容 ================= + + "i18n": { + // 仅 Sundry-Locale i18n 分支 + // Sundry 运行时使用的语言 + "lang": "zh-cn" // zh-cn | en-us - 全小写 + } +} From c194be360861e01df9742567519d9b19595a636b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B8=AD=E9=B8=AD=E3=80=8C=E3=82=AB=E3=83=A2=E3=80=8D?= <89643991+DuckDuckStudio@users.noreply.github.com> Date: Fri, 7 Nov 2025 22:30:24 +0800 Subject: [PATCH 2/5] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E8=8D=89?= =?UTF-8?q?=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/config/1.2/README.md | 10 +++++++++- docs/config/1.2/config.jsonc | 21 ++++++++++----------- 2 files changed, 19 insertions(+), 12 deletions(-) diff --git a/docs/config/1.2/README.md b/docs/config/1.2/README.md index 967869d..d8f0cee 100644 --- a/docs/config/1.2/README.md +++ b/docs/config/1.2/README.md @@ -11,10 +11,18 @@ ### 与 1.1 版本的区别 -1.2 版本的配置文件添加了几个可选配置: +1.2 版本的配置文件添加了几个可选配置并弃用了一个配置。 +新增了这几个配置项: | 配置项 | 作用 | 默认值 | |-----|-----|-----| | `debug` | 调试模式开关，打开后会输出一些调试信息，除非需要不建议打开 | `false` (bool) | +| `github.pr.mention_self_when_reviewer` | 自己在 [Auth.csv](https://github.com/microsoft/winget-pkgs/blob/master/Tools/ManualValidation/Auth.csv) 中作为包修改的审查者时，是否在 PR 中请求自己审查 | `false` (bool) | | `cache.*` | 缓存开关，用于控制是否自动缓存某些内容 | / | | `cache.validate.schema` | 控制是否缓存验证清单时使用的 yaml schema | `true` (bool) | + +弃用了这些配置项: + +| 配置项 | 原先作用 | 为何弃用 | +|-----|-----|-----| +| `tools.verify.check_url` | `sundry verify` 时验证清单中的 URL 是否有效 ([#68](https://github.com/DuckDuckStudio/Sundry/issues/68)) | 我试过在 `sundry validate` 中实现这个功能，但我发现这会严重拖慢 `sundry validate` 的速度。无论这个功能之后是否会在 `sundry validate` 中实现，它都不会在 `sundry verify` 中实现。 | diff --git a/docs/config/1.2/config.jsonc b/docs/config/1.2/config.jsonc index a5e8596..c4911b9 100644 --- a/docs/config/1.2/config.jsonc +++ b/docs/config/1.2/config.jsonc @@ -35,21 +35,14 @@ "github": { "pr": { // 是否允许维护者修改您的 PR 内容 - "maintainer_can_modify": false // bool + "maintainer_can_modify": false, // bool + + // 自己在 Auth.csv 中作为包修改的审查者时，是否在 PR 中请求自己审查 + "mention_self_when_reviewer": false // bool } }, "tools": { - "verify": { - // 暂未实现 - // verify 时验证清单中的 URL 是否有效 (#68) - "check_url": false, // bool - - // 暂未实现 - // 在非干净的 Windows 上验证时显示警告 (#99) - // TODO: 这个配置会不会太长了？ - "show_warning_on_non-clean_windows": false // bool - }, "prune": { "remote": { // 暂未实现 @@ -60,6 +53,12 @@ // prune 时清理远程中已关闭的 PR 的分支 (#98) "prune_closed_branches": false // bool } + }, + "verify": { + // 暂未实现 + // 在非干净的 Windows 上验证时显示警告 (#99) + // TODO: 这个配置会不会太长了？ + "show_warning_on_non-clean_windows": false // bool } }, From bbb100387e1e1598c53ba4e38506f72e6242707d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B8=AD=E9=B8=AD=E3=80=8C=E3=82=AB=E3=83=A2=E3=80=8D?= <89643991+DuckDuckStudio@users.noreply.github.com> Date: Sat, 8 Nov 2025 03:29:52 +0800 Subject: [PATCH 3/5] =?UTF-8?q?fix:=20=E6=9B=B4=E6=AD=A3=20$schema?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/config/1.2/config.jsonc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/config/1.2/config.jsonc b/docs/config/1.2/config.jsonc index c4911b9..a1cb22b 100644 --- a/docs/config/1.2/config.jsonc +++ b/docs/config/1.2/config.jsonc @@ -2,7 +2,7 @@ // 相关配置项的 key 必须使用小写 { - "$schema": "https://duckduckstudio.github.io/yazicbs.github.io/Tools/Sundry/config/schema/1.1.json", + "$schema": "https://duckduckstudio.github.io/yazicbs.github.io/Tools/Sundry/config/schema/1.2.json", // 配置文件的版本 // develop: DuckDuckStudio/Sundry main 分支最新提交的版本 From 6d1b4e0134acb5d2ec062c618579538c337d1250 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B8=AD=E9=B8=AD=E3=80=8C=E3=82=AB=E3=83=A2=E3=80=8D?= <89643991+DuckDuckStudio@users.noreply.github.com> Date: Sun, 9 Nov 2025 05:42:05 +0800 Subject: [PATCH 4/5] =?UTF-8?q?docs:=20=E5=9C=A8=E9=85=8D=E7=BD=AE?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E6=96=87=E6=A1=A3=E7=9B=AE=E5=BD=95=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6=201.2=20=E7=9A=84?= =?UTF-8?q?=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/config/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/config/README.md b/docs/config/README.md index 696b173..2d25305 100644 --- a/docs/config/README.md +++ b/docs/config/README.md @@ -3,7 +3,8 @@ | 配置文件版本 | 适用 Sundry 版本 | 状态 | |-----|-----|-----| -| [1.1](1.1) | 1.4.2+ | ✓ | +| [1.2](1.2) | 1.5.x | ✓ | +| [1.1](1.1) | 1.4.2 - 1.4.3 | O | | [1.0](1.0) | 1.2.0 - 1.4.1 | ✕ | | [0.3](0.3) | 1.1.11 - 1.1.14 | ✕ | | [0.2](0.2) | 1.0.2 - 1.1.10 | ✕ | From 43c3320abcc19a04c4fda555bd756c9deea0c59f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B8=AD=E9=B8=AD=E3=80=8C=E3=82=AB=E3=83=A2=E3=80=8D?= <89643991+DuckDuckStudio@users.noreply.github.com> Date: Mon, 10 Nov 2025 01:34:56 +0800 Subject: [PATCH 5/5] =?UTF-8?q?docs:=20=E8=AF=A6=E7=BB=86=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E8=BF=87=E6=97=B6=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E7=9A=84=E6=9B=B4=E6=96=B0=E6=96=B9=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/config/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/config/README.md b/docs/config/README.md index 2d25305..989388d 100644 --- a/docs/config/README.md +++ b/docs/config/README.md @@ -14,5 +14,5 @@ 状态: - ✓ 当前使用的配置文件版本。 -- O 过时的配置文件版本，但可以在最新的 Sundry 中设置兼容。 -- ✕ 弃用的配置文件版本，新版本的 Sundry 不再允许设置兼容。 +- O 过时的配置文件版本，但可以在最新的 Sundry 使用 `sundry config update` 更新。 +- ✕ 弃用的配置文件版本，新版本的 Sundry 不再支持。