用途:当 XerahS 需要跟进本地 ShareX 仓库最新的 ShareX.ImageEditor 状态时,使用该工作流把上游改动按其行为语义移植进 XerahS 子模块,而非机械 cherry-pick。
主要能力与规则:以本地 ShareX 检出为上游参照,不重复克隆;独立解析 $ShareXRepo 与 $XerahSRoot,支持 Windows、macOS、Linux 路径;先在 $XerahSRoot/ShareX.ImageEditor/PORT_STATUS.md 读取上次同步点,列出待移植提交并做风险分级;在修改前必须发布 implementation manifest,逐项列出漏洞修复与增强、源提交、影响文件、XerahS 现状与决策;移植后需构建通过,并在子模块中按项分别提交;无本地 ShareX 时允许以 blobless 方式克隆到 /tmp/ShareX。
用法要点:先对齐 XerahS 根仓库与子模块状态,确认 ShareX 检出是否最新及是否浅克隆,浅克隆需用 fetch --shallow-since 加深;用 git log/diff/show 检查上游增量,按路径映射把上游目录对应到子模块的 src/ShareX.ImageEditor;命令使用正斜杠以跨平台。
限制:XerahS 仅英文,不得移植 ShareX 本地化资源;不得添加对 ShareX.Avalonia 等项目的 ProjectReference;不得盲目覆盖 XerahS 特有修复或改回上游目录命名;资料未提供具体验证命令与完整流程后续步骤,暂未提供。