Sundry DuckStudio

• 别名: 移除, remove

• 作用: 移除一个指定的软件包的指定版本，并在移除前自动检查该版本是否确实存在问题。可以指定理由或跳过自动检查。默认理由为“安装程序URL在GitHub Action上返回了404”。

• 用法: sundry remove <软件包标识符> <软件包版本> [是否跳过自动检查] [理由]

• 示例:

  • 最少参数: sundry remove DuckStudio.FufuTools 1.3.10
  • 跳过自动检查: sundry remove DuckStudio.FufuTools 1.3.10 True
  • 指定理由: sundry remove DuckStudio.FufuTools 1.3.10 "该版本存在一个已知问题"
  • 指定理由的同时跳过自动检查: sundry remove DuckStudio.FufuTools 1.3.10 True "该版本存在一个已知问题"

  sundry modify

• 别名: 单改, 单修改, modify

• 作用: 修改一个指定的软件包的指定版本的清单，并在修改完后自动提交拉取请求。

• 用法: sundry modify <软件包标识符> <版本> [理由/解决的议题]

• 示例:

  • 最少参数: sundry modify XBMCFoundation.Kodi 18.2.0.0 (https://github.com/microsoft/winget-pkgs/pull/267613)
  • 指定理由: sundry modify XBMCFoundation.Kodi 18.3.0.0 "替换 HTTP 为 HTTPS" (https://github.com/microsoft/winget-pkgs/pull/267614)
  • 链接议题:
    • 使用议题 URL: sundry modify DuckStudio.Sundry 1.2.6 "https://github.com/microsoft/winget-pkgs/issues/267539"
    • 使用议题纯数字编号: sundry modify DuckStudio.Sundry 1.2.6 "267539"
    • 使用议题编号: sundry modify DuckStudio.Sundry 1.2.6 "#267539"
  • 指定理由的同时链接议题:

    sundry modify DuckStudio.Sundry 1.2.6 "一些修改。
    - Resolves https://github.com/microsoft/winget-pkgs/issues/267539"
    

    > GitHub Docs: 使用关键词将拉取请求链接到议题

  sundry logs-analyse

• 别名: 日志分析, logs-analyse, logs_analyse, Azure日志分析

• 作用: 分析 Azure Validation Pipeline Run 失败时的日志，来自动查找具体哪里失败了。

• 用法:

  • 分析日志: sundry logs-analyse [是否保留日志文件] [是否显示一般错误/异常]
  • 清理之前下载的日志: sundry logs-analyse cleanup

• 示例:

  • 分析日志 > 这里的 Azure Validation Pipeline Run 是 https://github.com/microsoft/winget-pkgs/pull/267849#issuecomment-2998878757 的。
    • 最少参数: sundry logs-analyse "https://dev.azure.com/shine-oss/8b78618a-7973-49d8-9174-4360829d979b/_build/results?buildId=137464" (需要用户输入)
    • 不保留日志文件: sundry logs-analyse "https://dev.azure.com/shine-oss/8b78618a-7973-49d8-9174-4360829d979b/_build/results?buildId=137464" n
    • 保留日志文件: sundry logs-analyse "https://dev.azure.com/shine-oss/8b78618a-7973-49d8-9174-4360829d979b/_build/results?buildId=137464" y (运行后将打开日志文件所在目录)
    • 不显示一般错误/异常: 默认，不需要传递额外参数。
    • 显示一般错误/异常: sundry logs-analyse "https://dev.azure.com/shine-oss/8b78618a-7973-49d8-9174-4360829d979b/_build/results?buildId=137464" 占位 y
    • 保留日志文件且不显示一般错误/异常: 默认不显示一般错误/异常，同保留日志文件的示例。
    • 保留日志文件且显示一般错误/异常: sundry logs-analyse "https://dev.azure.com/shine-oss/8b78618a-7973-49d8-9174-4360829d979b/_build/results?buildId=137464" y y
  • 清理之前下载的日志: sundry logs-analyse cleanup

  sundry verify

> 截图是在 Hyper-V Windows 10 x64 虚拟机上的测试。

• 别名: verify, test, 验证, 测试
• 作用: 用于测试本地或 PR 上的清单的安装和卸载，并获取 ARP 条目变更。
• 用法:
  • 本地清单: sundry verify <软件包标识符> <软件包版本>
  • PR 清单: sundry verify
• 示例:
  • 测试本地清单: sundry verify DuckStudio.FufuTools 1.3.10
  • 测试 PR 清单: sundry verify <打开的PR>

⚠ 注意

1. 它只能获取 HEAD 分支没被删除的 PR 的清单，如果 HEAD 分支被删除了 GitHub API 会响应 404 Not Found。
2. 它暂时无法获取 UpgradeCode。
3. 对于本地清单，配置文件指向的 winget-pkgs 文件夹中至少要有以下文件:
   - Tools/ManualValidation/Auth.csv (Sundry 1.3.5 及以后)
   - manifests/清单所在文件夹/清单文件 (例如 manifests/d/DuckStudio/Sundry/1.3.5/*)
4. 对于 PR 清单，它会将清单文件下载到 %temp%/Sundry/Verify/PRManifest/PR编号 下。

sundry ignore

• 别名: 忽略, 检查忽略, ignore

• 作用: 管理 winget-tools 中的检测脚本的忽略字段。

• 用法: sundry ignore [忽略字段] [理由]

• 示例:

  • 添加忽略字段: sundry ignore add "https://www.argyllcms.com/" "服务器冲不动咖啡 (418)"
  • 移除忽略字段: sundry ignore remove "https://www.argyllcms.com/" "又冲得动了"
  • 编辑忽略字段: sundry ignore edit
  • 列出所有忽略字段: sundry ignore list

  sundry cat

• 别名: 没有别名，只能用 cat。

• 作用: 获取指定软件包标识符的指定版本的清单，可以指定获取所有清单或某个类型的清单。

• 用法: sundry cat <软件包标识符> <版本> [清单类型] [区域设置(如果是locale类型)]

• 示例:

  • 获取所有清单: sundry cat DuckStudio.Sundry 1.2.3
    • 亦可使用 sundry cat DuckStudio.Sundry 1.2.3 all
    • 除 all 外还可用 全部, 所有
  • 获取指定类型的清单:
    • 安装程序清单: sundry cat DuckStudio.Sundry 1.2.3 i
      • 可以用 installer, 安装程序, 安装, i
    • 区域清单: sundry cat DuckStudio.Sundry 1.2.3 l zh-CN
      • 可以用 locale, 区域, 区域设置, l
      • 必须指定具体哪个区域设置的清单
    • 版本清单: sundry cat DuckStudio.Sundry 1.2.3 v
      • 可以用 version, ver, v, 版本

  sundry sync

• 别名: sync, 同步, synchronize, sync-fork

• 作用: 同步 fork 仓库和上游仓库的修改。

• 用法: sundry sync

• 示例: sundry sync

  sundry repr

• 别名: 没有别名，只能用 repr。

• 作用: 等效于 Python 的 repr()，用于获取字符串真实的样子。

• 用法: sundry repr <文件路径/文本内容> [编码(默认 UTF-8)]

• 示例:

  • 文本:

    sundry repr "第一行
    第二行"
    

  • 文件 (假设编码为 gbk): sundry repr "D:/文件路径/文件.txt" "gbk"

  sundry config

• 别名: config, 配置

• 作用: 初始化和修改 Sundry 配置。

• 用法: sundry config <参数...>

• 示例:

  • 初始化配置: sundry config init
  • 显示当前配置: sundry config show
  • 修改配置项: sundry config signature no

  sundry revert

• 别名: 还原, revert

• 作用: 还原本地仓库的修改，如果 Sundry 在修改的某个过程中崩溃了，则可以使用此命令还原 Sundry 做的修改。

• 用法: sundry revert <仓库> <是否已提交> <是否丢弃>

• 示例:

  • 还原所有仓库、未提交、丢弃: sundry revert all n y
  • 其他类似

  sundry fun

• 别名: 没有别名，只能用 fun。
• 作用: 管理 Sundry 的 fun.txt。
• 用法: sundry fun [参数...]
• 示例:
  • 随机一个: sundry fun 或 sundry fun random
    • 还可以使用 sundry fun 随机
  • 列出所有: sundry fun list
    • 可以用 获取, 读取, get, list
  • 编辑 fun.txt: sundry fun edit
    • 可以用 编辑, edit, 打开, open
  • 添加新的: sundry fun add "提问: 罗浮六御中谁最幸福? 答案: 符玄。因为她姓符。"
    • 可以用 add, 添加
  • 移除原来的: sundry fun remove "Ciallo～(∠・ω< )⌒☆"
    • 可以用 remove, 移除
  • 从其他文件导入(覆盖): sundry import "D:/文件路径/另一个fun.txt"
    • 可以用 import, 导入

Ubuntu 支持

自己构建

Windows

> [!TIP] > 仓库下有一个适用于 Windows 的构建流，你可以 fork 后直接运行，它会将结果上传为工件。

1. 克隆后 cd 到项目所在目录
2. 更新代码中的版本号

python "自动化脚本/修改版本号.py" "2025.520.1314"

3. 安装依赖

python -m venv .venv
& ".venv\Scripts\Activate.ps1"
python.exe -m pip install --upgrade pip
pip install -r "requirements.txt"

4. 转换图标格式 (可选)

python "自动化脚本/png-2-ico.py"

5. 构建

pyinstaller --onefile --distpath="Release" --name="sundry.exe" "src/sundry.py" --icon "icon/Sundry.ico"
# 如果前面没转换图标格式，参数中的图标请用 icon/Sundry.png，Pyinstaller 会尝试自己转换格式。

6. 复制所需文件

Copy-Item -Path "src/fun.txt" -Destination "Release" -Verbose
Copy-Item -Path "LICENSE" -Destination "Release" -Verbose

7. Release 下就是构建结果

Ubuntu

set -e
echo "克隆源码..."
git clone https://github.com/DuckDuckStudio/Sundry.git
cd Sundry
echo "创建虚拟环境并安装依赖..."
python3 -m venv .venv
source .venv/bin/activate
pip install -r "requirements.txt"
echo "构建二进制文件..."
python3 "自动化脚本/修改版本号.py" "2025.520.1314"
pyinstaller --onefile --distpath="Release" --name="sundry" "src/sundry.py"
deactivate
cp -v "src/fun.txt" "Release"
cp -v "LICENSE" "Release"
echo "整理文件..."
cd ..
cp -rv "Sundry/Release" "./Release"
rm -rvf Sundry
cd Release
echo "配置 Sundry..."
./sundry ver
./sundry config init

然后 ./Release 下就是构建结果。