菜单
处理 upgrading/tool 下的 Zongsoft.Tools.Upgrader dotnet-upgrade 命令行工具。用于修改或审查 pack、checksum、publish 命令，发布 manifest 生成，ZIP 条目选择和重复处理，变量替换，执行器选项，runtime 命名，Amazon S3 或 Web 发布，本地化命令资源，NuGet 工具打包，或 Zongsoft 自动升级 tool 文档。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
创建、编辑或审查 Zongsoft.Data `.mapping` XML 数据映射文件。当 Codex 需要定义 Zongsoft 数据实体、属性、组合键、导航/复合属性、命令脚本，或根据 `Zongsoft.Data.xsd` 以及相关项目中的约定校验 `.mapping` 文件时使用。
处理 upgrading/deployer 下的 Zongsoft.Upgrading.Deployer Native AOT 可执行程序。用于修改或审查 .deployment 描述文件处理、完整/增量文件部署、清理/复制规则、部署执行器事件、服务/Web/终端重启启动器、平台相关发布脚本、Visual Studio 发布配置，或 Zongsoft 自动升级 deployer 文档。
处理 upgrading/upgrader 下的 Zongsoft.Upgrading.Upgrader 客户端组件。用于修改或审查自动升级发现、File/Web fetcher、发布选择、包下载与校验和验证、解压、.deployment 交接生成、worker 启动调度、deployer 启动行为、upgrader plugin/option/deploy 产物、执行器注册，或 Zongsoft 自动升级 upgrader 文档。
处理 upgrading/web 下的 Zongsoft.Upgrading.Web 包管理器。用于修改或审查发布仓库 API、应用/版本分支/发布/实例服务、manifest 导入、包上传与存储、发布状态、升级器发现端点、评估器注册、数据库映射/脚本、HTTP 文档，或 Zongsoft 自动升级 Web 模块打包相关工作。
| name | tool |
| description | 处理 upgrading/tool 下的 Zongsoft.Tools.Upgrader dotnet-upgrade 命令行工具。用于修改或审查 pack、checksum、publish 命令，发布 manifest 生成，ZIP 条目选择和重复处理，变量替换，执行器选项，runtime 命名，Amazon S3 或 Web 发布，本地化命令资源，NuGet 工具打包，或 Zongsoft 自动升级 tool 文档。 |
修改行为前，优先读取最小且有用的文件集合：
README.md：了解公开命令语法、选项、示例和发布流程。Program.cs：命令注册和命令行表达式处理。Packager.Pack.cs：pack 选项、变量替换、条目选择、排除规则、runtime 命名和 manifest 生成。Packager.Checksum.cs：校验和重算规则和 manifest 配对。Packager.Publish.cs：amazon.s3 和 web 发布流程。Packager.cs：ZIP 写入、重复条目处理和共享 packager 辅助逻辑。Normalizer.cs：$(Variable) 和 %Variable% 替换。AmazonS3.cs：S3 兼容上传行为。Dumper.cs：修改诊断输出时读取。Properties/Resources*.resx：修改面向用户的命令消息时读取。Zongsoft.Tools.Upgrader.csproj：dotnet-upgrade 工具打包、目标框架、链接的 .shared 文件和包元数据。../.shared/*.cs：触碰发布、manifest、执行器、平台、架构、runtime、checksum 或 reader/writer 契约时读取。保持工具围绕三个子命令：
dotnet-upgrade pack [options...] [arguments...]
dotnet-upgrade checksum [options] <package-file...>
dotnet-upgrade publish [options] <package-file...>
对 pack，保留以下顺序：
name、version、platform 和 framework。Runtime 和 RuntimeIdentifier。--exclude 规则应用到整目录打包和基于参数的打包。.manifest。对 checksum，接受 .zip、.manifest 或无扩展名的包名，定位配对 manifest，重新计算校验和并更新 manifest。
对 publish，保持 amazon.s3、s3 和 web 通道别名兼容已有命令行。
此工具生成的 manifest 和包会被 Zongsoft.Upgrading.Web、Zongsoft.Upgrading.Upgrader 和 Zongsoft.Upgrading.Deployer 消费。
修改 Manifest、Release、ReleaseKind、Executor、runtime 命名、checksum 算法、包路径约定或 XML reader/writer 行为，可能破坏整个升级流水线。此类契约变化时检查其它子项目。
保留 Zongsoft 命令行工具使用的选项解析风格，包括冒号形式：
--name:Zongsoft.Daemon
--version:1.1.0
--source:"D:\build\$(compilation)\$(framework)"
包参数规则：
--source 的相对路径处理。* 和 ? 通配符。source:target 在包内重命名或重定位条目。~ 和 / 视为包根目录。--source、--output 等路径时，优先使用正斜杠或双反斜杠，避免 \t 等片段被命令行层解析成转义字符。--exclude 是以分号分隔的目录、文件或通配符规则；排除运行中 terminal 的运行数据和日志时使用 --exclude:".garnet/;logs/;"，不要假设支持 **/.garnet/** 这类 globstar 语法。.zip 和配对 .manifest 存在，并查看日志是否出现错误文本。执行器选项保留 --executor.<name>@<event>:"command" 格式。缺少事件名的执行器定义应警告并忽略。保持执行器名称兼容共享 deployer 命令：Copy、Move、Link、Delete。
Web 发布时，保持 URL 标准化兼容指向站点根、/Upgrading、/Upgrading/Upgrader 或 /Upgrading/Releases 的输入。流程是导入 manifest、为每个导入的发布上传包，然后将发布标记为已发布。
Amazon S3 发布时，保持包和 manifest 上传路径兼容配置的 --destination 和发布文件名。
不要记录来自 --secret、--access、--authorization 或 --credential 的密钥值。
本机没有 aws 或 mc 时，可复用工具输出目录或 NuGet 缓存中的 AWSSDK.Core.dll、AWSSDK.S3.dll 做只读 ListObjectsV2 验证，确认包和 manifest 都已发布到预期 bucket/prefix。
命令行为变化时同步更新文档：
README.md 和 README.zh-Hans.md，说明公开命令语法、选项语义、示例或发布行为。Properties/Resources.resx 和本地化资源文件。Zongsoft.Tools.Upgrader.csproj 支持的目标框架。优先执行聚焦验证：
dotnet build Zongsoft.Tools.Upgrader.slnx
命令变化时，针对临时输出目录运行代表性 CLI 命令：
pack 命令；.manifest 的 checksum 命令；Web 发布变化时，在本地 Web 包管理器可用的情况下验证 manifest 导入、包上传和发布状态更新。S3 变化时，优先使用本地 S3 兼容端点，避免直接触碰真实存储。