From 466021278b7b7fea10097e9b8cd0acfda659715b Mon Sep 17 00:00:00 2001 From: paperhammer Date: Tue, 15 Sep 2026 22:18:41 +0800 Subject: [PATCH 1/2] =?UTF-8?q?chore=EF=BC=9A=E4=BC=98=E5=8C=96=20reademe?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 171 ++++++++++++++++++------------------------------ README.zh-CN.md | 144 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 206 insertions(+), 109 deletions(-) create mode 100644 README.zh-CN.md diff --git a/README.md b/README.md index 211123e..676a0e3 100644 --- a/README.md +++ b/README.md @@ -1,39 +1,39 @@ -# XAML-Nexus +# XamlNexus -![NuGet Version](https://img.shields.io/nuget/v/XamlNexus) -[![GitHub stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2FPaperHammer%2FXamlNexus&query=stargazers_count&label=Stars&color=pink)](https://github.com/PaperHammer/XamlNexus/stargazers) -[![Documentation](https://img.shields.io/badge/Docs-Quickstart-green)](docs/user-guide/quickstart.zh-CN.md) -[![Issues](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2FPaperHammer%2FXamlNexus&query=open_issues&label=Issues&color=orange)](https://github.com/PaperHammer/XamlNexus/issues) +[![NuGet](https://img.shields.io/nuget/v/XamlNexus)](https://www.nuget.org/packages/XamlNexus) +[![Stars](https://img.shields.io/github/stars/PaperHammer/XamlNexus)](https://github.com/PaperHammer/XamlNexus/stargazers) +[![Issues](https://img.shields.io/github/issues/PaperHammer/XamlNexus)](https://github.com/PaperHammer/XamlNexus/issues) -XamlNexus is a .NET CLI for generating Windows desktop prototypes with WinUI 3 or a WinUI 3 frontend and WPF background host. It includes ArcXaml, navigation, MVVM, DI, configuration and logging. The default standard profile also includes settings, themes and language controls. +**English** | [简体中文](README.zh-CN.md) -[中文快速开始：创建 → 运行 → 修改首页 → 添加页面 → 添加能力](docs/user-guide/quickstart.zh-CN.md) +A .NET command-line tool for creating Windows desktop prototypes with WinUI 3. Generate a project, add pages and components, and start building your application. -## Installation +## Features -Windows and a .NET 8 / WinUI build environment are required. +- **Two architectures:** a WinUI 3 application, or a WinUI 3 frontend with a WPF background host. +- **Application foundations:** ArcXaml, navigation, MVVM, dependency injection, configuration, and logging. +- **Optional components:** settings, SQLite, tray integration, application updates, and EditorConfig. +- **Project maintenance:** preview changes, validate projects, diagnose configuration, and upgrade generated infrastructure. + +## Install + +Prepare Windows, the .NET 8 SDK, and the WinUI build environment. ```powershell dotnet tool install --global XamlNexus xamlnexus --version ``` -This guide describes the current source. Public packages gain new commands when the corresponding version is published. -Use `dotnet tool update --global XamlNexus` to update an installed tool. -For unreleased source, follow the source-build instructions in the quickstart. -Uninstall with `dotnet tool uninstall --global XamlNexus`. - -The installed command is `xamlnexus`; installation does not create an `xn` command or change your shell profile. -For an optional PowerShell shortcut, set the alias yourself: +Update or uninstall the tool: ```powershell -Set-Alias -Name xn -Value xamlnexus -xn --help +dotnet tool update --global XamlNexus +dotnet tool uninstall --global XamlNexus ``` -Both names then work in the current session. Add the `Set-Alias` line to `$PROFILE` to use the shortcut in new PowerShell sessions. +This README describes the current source; the published NuGet package may not yet include all changes. -## First development workflow +## Quick start ```powershell xamlnexus new MyApp @@ -41,9 +41,9 @@ cd MyApp xamlnexus run ``` -Press Ctrl+C to stop this run before editing and running again. -Edit `MyApp.MainPanel/MainPage.xaml` for the home layout and -`MyApp.MainPanel/ViewModels/MainViewModel.cs` for page state and logic. +Press **Ctrl+C** to stop before editing or running again. Edit `MyApp.MainPanel/MainPage.xaml` for the home page and `MyApp.MainPanel/ViewModels/MainViewModel.cs` for its state and logic. + +Add a page, then run the application: ```powershell xamlnexus page add Workspace --dry-run @@ -51,7 +51,7 @@ xamlnexus page add Workspace xamlnexus run ``` -The new ordinary page includes a ViewModel and navigation registration. Stop the app, then add capabilities when needed: +After stopping the application, add a component: ```powershell xamlnexus recipes @@ -59,45 +59,39 @@ xamlnexus add sqlite xamlnexus run ``` -`run` builds and starts Debug/x64/unpackaged applications. It selects the WinUI executable or hybrid host automatically. -It does not provide watch or hot reload. Use `run --dry-run` to inspect the plan or `run --no-build` to start existing output. +`run` builds and starts the appropriate executable in Debug/x64/unpackaged mode. It does not watch files or provide hot reload. Use `run --dry-run` to inspect the commands or `run --no-build` to use existing output. -## Choose a starting point +## Project options -```powershell -# Interactive architecture, profile and component selection -xamlnexus +Run `xamlnexus` without arguments for interactive setup, or select options explicitly: -# Core infrastructure without the full settings panel +```powershell xamlnexus new MinimalApp --profile basic - -# Compose capabilities during creation xamlnexus new DataApp --profile basic --features settings,sqlite - -# WinUI frontend with a WPF background host xamlnexus new HybridApp --preset hybrid ``` -`--preset winui|hybrid` selects architecture; `--profile standard|basic` selects initial capabilities. -The defaults are winui and standard. Basic retains theme, localization, configuration and logging infrastructure. - -| Recipe | Availability | +| Option | Choices | |---|---| -| `settings` | Optional in basic; included in standard | -| `sqlite` | Both architectures; hybrid data access belongs to the host | -| `tray` | Optional in pure WinUI; already built into hybrid | -| `updater` | Optional in pure WinUI, depends on settings and needs your update source; built into hybrid | -| `editorconfig` | Both architectures | +| `--preset` | `winui` (default) or `hybrid` | +| `--profile` | `standard` (default, includes settings) or `basic` (omits the full settings panel) | +| `--solution-format` | `sln` (default) or `slnx` (requires SDK 9.0.200+) | -For an existing basic project, `xamlnexus add settings,sqlite` installs both transactionally. -Do not add capabilities that are already installed. Creating pages does not generate business CRUD or RPC methods. +Both profiles retain theme, localization, configuration, and logging infrastructure. -SLNX is available with `--solution-format slnx` (requires the selected .NET SDK 9.0.200+). -The default remains `sln`. Upgrades preserve the existing format; they do not convert solutions. +| Component | Purpose and availability | +|---|---| +| `settings` | Settings panel; included in standard, optional in basic | +| `sqlite` | Local data storage; hybrid data access runs in the host | +| `tray` | System tray integration; optional in WinUI, built into hybrid | +| `updater` | Application updates; optional in WinUI and depends on settings, built into hybrid; requires an update source | +| `editorconfig` | Editor formatting configuration | + +Use `xamlnexus add settings,sqlite` to install multiple components. Already installed components are skipped. Read the generated component READMEs for configuration details. -## Project maintenance +## Maintain a project -Run from the generated project directory, or use `--project `: +Run these commands from the project directory, or specify `--project `: ```powershell xamlnexus list @@ -108,84 +102,43 @@ xamlnexus upgrade --dry-run xamlnexus --help ``` -`update sqlite` applies to projects with SQLite installed. -The generated `xamlnexus.json` records architecture, starting profile and installed capabilities. -Publication and signing are separate from development and remain maintainer-controlled. - -## Usage notes +- `update ` updates an installed component; `upgrade` updates scaffold infrastructure. Updating the CLI does not update existing projects. +- Generated files are editable. Component update/removal checks tracked files; scaffold upgrades report merge conflicts. +- `--dry-run` previews changes. `--json` only changes the output format and does not prevent writes. +- Installer creation, signing, and update distribution are configured separately in the generated publishing files. -- Generated source and configuration are yours to edit. Component update/removal stops when tracked files have changed or are missing; scaffold upgrades report changes they cannot merge safely. -- Use `--dry-run` before automatic changes. `--json` only changes output formatting and does not prevent writes. `upgrade --conflict-output` writes conflict files and cannot be combined with `--dry-run`. -- `new -p` selects a preset; project commands use `-p` for the project path. Quote paths containing spaces. -- Updating the CLI with `dotnet tool update --global XamlNexus` does not update existing projects. Use `update ` for a component or `upgrade` for scaffold infrastructure. -- `xn` requires the PowerShell alias above. Development running does not replace installer creation, signing, or release configuration. - -## 中文使用说明 - -在 Windows 上准备 .NET 8 SDK 和 WinUI 构建环境后，安装工具并创建项目。正式命令是 `xamlnexus`，安装不会自动提供 `xn` 或修改终端配置。下面演示可选的 PowerShell 别名，需要手动设置；不使用别名时，将示例中的 `xn` 写成 `xamlnexus` 即可： +For an optional shortcut in the current PowerShell session: ```powershell -dotnet tool install --global XamlNexus Set-Alias -Name xn -Value xamlnexus -xn new MyApp -cd MyApp -xn run +xn --help ``` -按 Ctrl+C 停止运行后，修改 `MyApp.MainPanel/MainPage.xaml` 和 `ViewModels/MainViewModel.cs`，再执行 `xn run`。添加页面用 `xn page add Orders`，查看可用组件用 `xn recipes`，按需添加用 `xn add sqlite`。 - -- `xn` 是当前 PowerShell 会话的别名；把 `Set-Alias` 那行加入 `$PROFILE` 才能在新会话中使用。 -- 默认生成标准版；需要省去完整设置界面时用 `--profile basic`。两者都保留配置、日志、导航、主题和多语言基础机制。 -- 所有生成源码和配置都可以修改。组件更新或移除遇到已修改、缺失的文件时会停止；脚手架升级无法安全合并时会报告冲突。 -- 自动修改前先保存或提交代码，并用 `--dry-run` 预览。`--json` 只控制输出格式，不代表预览。 -- `run` 使用 Debug/x64/非打包模式，没有热重载。安装包、签名和在线更新发布需配置生成项目的发布文件。 - -完整参数与示例：[English command reference](docs/user-guide/commands.md) | [中文命令详解](docs/user-guide/commands.zh-CN.md)。 - -## 命令帮助与列表 / Help and lists - -| 命令 / Command | 用途 / Purpose | -|---|---| -| `xamlnexus --help` 或 / or `xamlnexus help` | 查看命令、参数和示例 / Show commands, options, and examples | -| `xamlnexus new --help` | 查看帮助，目前仍显示全局帮助 / Show help; currently the same global help | -| `xamlnexus recipes` | 列出当前工具提供的可添加组件 / List available components | -| `xamlnexus list` | 列出当前项目已安装的模块 / List installed project modules | -| `xamlnexus list --project ./MyApp` | 查看指定项目的模块 / List modules in a specified project | -| `xamlnexus --version` | 查看工具版本 / Show the tool version | - -参数统一列在 `--help` 中，目前没有独立的参数列表命令或按子命令区分的帮助。`recipes` 和 `list` 支持 `--json`，方便脚本读取。设置上文的 PowerShell 别名后，这些命令也可以使用 `xn`。 - -Options are listed in `--help`; there is currently no separate option-list command or command-specific help. Both `recipes` and `list` support `--json` for scripts. After setting the PowerShell alias above, you can also use `xn`. - -完整参数说明 / Full command reference: [English](docs/user-guide/commands.md) | [简体中文](docs/user-guide/commands.zh-CN.md). - -## Guides +## Documentation -- Documentation: [English](docs/README.md) | [简体中文](docs/README.zh-CN.md) -- Architecture: [English](docs/technical/architecture.md) | [整体架构与关键流程](docs/technical/architecture.zh-CN.md) -- [Quickstart / 中文快速开始](docs/user-guide/quickstart.zh-CN.md) -- [Profiles and capability boundaries](docs/introduction/product-model.zh-CN.md) -- [Pages and ViewModels](docs/user-guide/business-page.zh-CN.md) -- [Navigation](docs/technical/navigation.md) +- [Documentation index](docs/README.md) +- [Quickstart](docs/user-guide/quickstart.md) +- [Command reference](docs/user-guide/commands.md) +- [Architecture](docs/technical/architecture.md) +- [Profiles and capabilities](docs/introduction/product-model.md) +- [Pages and ViewModels](docs/user-guide/business-page.md) - [SQLite](docs/user-guide/sqlite-recipe.md) -- [Settings and live localization](docs/user-guide/localization.md) -- [Project manifest](docs/technical/project-manifest.md) +- [Settings and localization](docs/user-guide/localization.md) - [Scaffold upgrades](docs/user-guide/project-upgrade.md) -- [Change previews and JSON output](docs/user-guide/change-plans.md) +- [Release policy](.github/RELEASING.md) -## Build from this repository +## Build from source ```powershell dotnet build ./src/XamlNexus/XamlNexus.csproj dotnet ./src/XamlNexus/bin/Debug/net8.0/XamlNexus.dll --help ``` -Generated-project build acceptance (PowerShell 7, no GUI launch): +To verify generated projects, use PowerShell 7 and the Windows/WinUI build toolchain: ```powershell ./eng/Test-GeneratedProjects.ps1 ./eng/Test-GeneratedProjects.ps1 -Profile standard ``` -Each invocation checks both architectures before and after adding a page and components. -Logs are saved under `.artifacts/generated-build-*/`; generated projects remain in the reported temporary directory. +Each invocation checks both architectures before and after adding a page and components, without launching the UI. Logs are written to `.artifacts/generated-build-*/`; generated projects are retained in the reported temporary directory. diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..cec0faf --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,144 @@ +# XamlNexus + +[![NuGet](https://img.shields.io/nuget/v/XamlNexus)](https://www.nuget.org/packages/XamlNexus) +[![Stars](https://img.shields.io/github/stars/PaperHammer/XamlNexus)](https://github.com/PaperHammer/XamlNexus/stargazers) +[![Issues](https://img.shields.io/github/issues/PaperHammer/XamlNexus)](https://github.com/PaperHammer/XamlNexus/issues) + +[English](README.md) | **简体中文** + +基于 .NET 的 Windows 桌面原型脚手架。通过命令行创建 WinUI 3 项目、添加页面和组件，快速开始应用开发。 + +## 功能 + +- **两种架构**：纯 WinUI 3 应用，或 WinUI 3 前端搭配 WPF 后台宿主。 +- **应用基础设施**：集成 ArcXaml、导航、MVVM、依赖注入、配置和日志。 +- **可选组件**：设置、SQLite、系统托盘、应用更新和 EditorConfig。 +- **项目维护**：预览变更、校验项目、诊断配置和升级脚手架基础代码。 + +## 安装 + +准备 Windows、.NET 8 SDK 和 WinUI 构建环境。 + +```powershell +dotnet tool install --global XamlNexus +xamlnexus --version +``` + +更新或卸载工具： + +```powershell +dotnet tool update --global XamlNexus +dotnet tool uninstall --global XamlNexus +``` + +本文对应当前源码，已发布的 NuGet 包可能尚未包含所有改动。 + +## 快速开始 + +```powershell +xamlnexus new MyApp +cd MyApp +xamlnexus run +``` + +修改代码或再次运行前，按 **Ctrl+C** 停止当前运行。首页布局位于 `MyApp.MainPanel/MainPage.xaml`，页面状态和逻辑位于 `MyApp.MainPanel/ViewModels/MainViewModel.cs`。 + +添加页面并运行： + +```powershell +xamlnexus page add Workspace --dry-run +xamlnexus page add Workspace +xamlnexus run +``` + +停止应用后，按需添加组件： + +```powershell +xamlnexus recipes +xamlnexus add sqlite +xamlnexus run +``` + +`run` 自动选择启动程序，以 Debug/x64/非打包模式构建并运行，不提供文件监听或热重载。使用 `run --dry-run` 查看执行命令，使用 `run --no-build` 启动已有构建产物。 + +## 项目选项 + +直接执行 `xamlnexus` 进入交互式创建，也可以指定参数： + +```powershell +xamlnexus new MinimalApp --profile basic +xamlnexus new DataApp --profile basic --features settings,sqlite +xamlnexus new HybridApp --preset hybrid +``` + +| 参数 | 可选值 | +|---|---| +| `--preset` | `winui`（默认）或 `hybrid` | +| `--profile` | `standard`（默认，包含设置面板）或 `basic`（省去完整设置面板） | +| `--solution-format` | `sln`（默认）或 `slnx`（需要 SDK 9.0.200+） | + +两种配置均保留主题、多语言、配置和日志基础设施。 + +| 组件 | 用途与适用范围 | +|---|---| +| `settings` | 设置面板；standard 已包含，basic 可选装 | +| `sqlite` | 本地数据存储；hybrid 的数据访问由宿主负责 | +| `tray` | 系统托盘；WinUI 可选装，hybrid 已内置 | +| `updater` | 应用更新；WinUI 可选装且依赖 settings，hybrid 已内置；需要配置更新源 | +| `editorconfig` | 编辑器格式配置 | + +使用 `xamlnexus add settings,sqlite` 一次安装多个组件，已安装的组件会跳过。具体配置请阅读生成项目中各组件的 README。 + +## 项目维护 + +在项目目录执行以下命令，或使用 `--project ` 指定项目： + +```powershell +xamlnexus list +xamlnexus validate +xamlnexus doctor +xamlnexus update sqlite --dry-run +xamlnexus upgrade --dry-run +xamlnexus --help +``` + +- `update ` 更新已安装组件，`upgrade` 升级脚手架基础代码；更新 CLI 不会自动更新已有项目。 +- 生成的文件可以自行修改。组件更新和移除会检查受管理文件，脚手架升级会报告合并冲突。 +- `--dry-run` 用于预览变更；`--json` 只改变输出格式，不会阻止文件写入。 +- 安装包、签名和在线更新分发，需要单独配置生成项目中的发布文件。 + +如需在当前 PowerShell 会话中使用简短命令，可设置别名： + +```powershell +Set-Alias -Name xn -Value xamlnexus +xn --help +``` + +## 文档 + +- [文档目录](docs/README.zh-CN.md) +- [快速开始](docs/user-guide/quickstart.zh-CN.md) +- [命令详解](docs/user-guide/commands.zh-CN.md) +- [整体架构与关键流程](docs/technical/architecture.zh-CN.md) +- [配置与能力边界](docs/introduction/product-model.zh-CN.md) +- [页面与 ViewModel](docs/user-guide/business-page.zh-CN.md) +- [SQLite](docs/user-guide/sqlite-recipe.zh-CN.md) +- [设置与多语言](docs/user-guide/localization.zh-CN.md) +- [脚手架升级](docs/user-guide/project-upgrade.zh-CN.md) +- [发布流程（英文）](.github/RELEASING.md) + +## 从源码构建 + +```powershell +dotnet build ./src/XamlNexus/XamlNexus.csproj +dotnet ./src/XamlNexus/bin/Debug/net8.0/XamlNexus.dll --help +``` + +使用 PowerShell 7 和 Windows/WinUI 构建环境，执行生成项目验收： + +```powershell +./eng/Test-GeneratedProjects.ps1 +./eng/Test-GeneratedProjects.ps1 -Profile standard +``` + +每次执行都会检查两种架构在添加页面、组件前后的构建结果，不启动界面。日志保存在 `.artifacts/generated-build-*/`，生成项目保留在脚本输出的临时目录中。 From 0f58b084e4cd3ddc0e58d2c0394037809f390188 Mon Sep 17 00:00:00 2001 From: paperhammer Date: Tue, 15 Sep 2026 22:26:01 +0800 Subject: [PATCH 2/2] =?UTF-8?q?chore=EF=BC=9A[skip=20ci]=20update=20md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/RELEASING.md | 8 +++- .../workflows/release-merged-pull-request.yml | 44 +++++++++++++++++-- .github/workflows/validate-pull-request.yml | 22 ++++++++++ 3 files changed, 70 insertions(+), 4 deletions(-) diff --git a/.github/RELEASING.md b/.github/RELEASING.md index bcfb027..ea8f6bf 100644 --- a/.github/RELEASING.md +++ b/.github/RELEASING.md @@ -10,7 +10,13 @@ Create these labels: - `release:preview` - `release:none` -Add a `NUGET_API_KEY` Actions secret with permission to publish the package named in `.github/release.json`. +Configure [NuGet Trusted Publishing](https://learn.microsoft.com/nuget/nuget-org/trusted-publishing): + +1. On nuget.org, create a trusted publishing policy for repository owner `PaperHammer`, repository `XamlNexus`, and workflow file `release-merged-pull-request.yml` (filename only). +2. Leave the environment field empty: the current release job does not bind a GitHub environment. Grant publishing permission for the `XamlNexus` package to the appropriate package owner. +3. In GitHub Settings > Secrets and variables > Actions, add a repository secret named `NUGET_USER` containing your nuget.org username (profile name, not email address). + +The release job requests an OIDC token and uses `NuGet/login@v1` to obtain a temporary API key immediately before uploading. A stored `NUGET_API_KEY` is no longer required. If an environment is added later, update both the job and the NuGet policy to match. Protect `main` and require: diff --git a/.github/workflows/release-merged-pull-request.yml b/.github/workflows/release-merged-pull-request.yml index 1eabfc1..6064c12 100644 --- a/.github/workflows/release-merged-pull-request.yml +++ b/.github/workflows/release-merged-pull-request.yml @@ -14,9 +14,40 @@ concurrency: cancel-in-progress: false jobs: - release: + check-skip: if: github.event.pull_request.merged == true + runs-on: ubuntu-latest + permissions: + contents: read + outputs: + skip: ${{ steps.check.outputs.skip }} + steps: + - name: Check commit messages for skip marker + id: check + uses: actions/github-script@v7 + with: + script: | + // Check the PR tip as well as the merged revision for merge and squash workflows. + const pr = context.payload.pull_request; + const refs = [...new Set([pr.head.sha, pr.merge_commit_sha])]; + let skip = false; + for (const ref of refs) { + const { data } = await github.rest.repos.getCommit({ ...context.repo, ref }); + if (/\[skip ci\]/i.test(data.commit.message)) { + skip = true; + break; + } + } + core.setOutput('skip', String(skip)); + core.info(skip ? 'Skipping release: commit contains [skip ci].' : 'Release policy checks enabled.'); + + release: + needs: check-skip + if: github.event.pull_request.merged == true && needs.check-skip.outputs.skip != 'true' runs-on: windows-latest + permissions: + contents: write + id-token: write steps: - name: Check out exact merged revision uses: actions/checkout@v4 @@ -60,14 +91,21 @@ jobs: RELEASE_VERSION: ${{ steps.metadata.outputs.version }} run: ./eng/release/Test-ReleasePackage.ps1 -Directory artifacts -PackageId $env:RELEASE_PACKAGE_ID -Version $env:RELEASE_VERSION + - name: Log in to NuGet with OIDC + if: steps.metadata.outputs.should_publish == 'true' + uses: NuGet/login@v1 + id: nuget-login + with: + user: ${{ secrets.NUGET_USER }} + - name: Publish package to NuGet if: steps.metadata.outputs.should_publish == 'true' shell: pwsh env: - NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }} + NUGET_API_KEY: ${{ steps.nuget-login.outputs.NUGET_API_KEY }} run: | if ([string]::IsNullOrWhiteSpace($env:NUGET_API_KEY)) { - throw "Define NUGET_API_KEY in the repository Actions secrets." + throw "NuGet OIDC login did not return a temporary API key." } $packages = @(Get-ChildItem -LiteralPath artifacts -Filter '*.nupkg' | Where-Object { $_.Name -notlike '*.snupkg' }) diff --git a/.github/workflows/validate-pull-request.yml b/.github/workflows/validate-pull-request.yml index 5445530..7c67af2 100644 --- a/.github/workflows/validate-pull-request.yml +++ b/.github/workflows/validate-pull-request.yml @@ -9,7 +9,27 @@ permissions: contents: read jobs: + check-skip: + runs-on: ubuntu-latest + outputs: + skip: ${{ steps.check.outputs.skip }} + steps: + - name: Check commit message for skip marker + id: check + uses: actions/github-script@v7 + with: + script: | + const { data } = await github.rest.repos.getCommit({ + ...context.repo, + ref: context.payload.pull_request.head.sha + }); + const skip = /\[skip ci\]/i.test(data.commit.message); + core.setOutput('skip', String(skip)); + core.info(skip ? 'Skipping PR checks: commit contains [skip ci].' : 'PR checks enabled.'); + validate: + needs: check-skip + if: needs.check-skip.outputs.skip != 'true' runs-on: windows-latest steps: - name: Check out pull request @@ -38,6 +58,8 @@ jobs: run: dotnet test src/XamlNexus.sln -c Release --no-build --no-restore -p:NuGetAudit=false generated-projects: + needs: check-skip + if: needs.check-skip.outputs.skip != 'true' runs-on: windows-latest timeout-minutes: 45 strategy: