Highlights【免费下载链接】medusaThe worlds most flexible commerce platform for agents and developers项目地址: https://gitcode.com/GitHub_Trending/me/medusa(仅当存在符合条件的高亮项时包含 —— 判定标准见 release-types.md)FeaturesBugsDocumentationChoresOther ChangesNew ContributorsFull Changelog: vX.Y.Z-prev...vX.Y.Z其中 Full Changelog 行有严格的三个永远约束**永远在最后一行、永远存在、永远是加粗文本而非标题**不写成 ## 或 # 标题。 ## 条目格式Bullet Format三空格、作者链接、PR 链接 Features、Bugs、Documentation、Chores 与 Other Changes 五个章节中的**每一条**都必须使用如下精确格式 * type(scope): description by [username](https://github.com/username) in [#NNNN](https://github.com/medusajs/medusa/pull/NNNN) 三个关键细节 1. **三空格缩进**星号后跟三个空格写作 * 不是常见的 * 单空格。 2. **作者链接**[username](https://github.com/username)使用 PR 元数据中的 GitHub 用户名handle而非真实姓名或显示名。 3. **PR 链接**[#NNNN](https://github.com/medusajs/medusa/pull/NNNN)**必须始终链接**不可省略或写成纯文本 #NNNN。 4. **提交前缀原样沿用**直接使用 commit / PR 标题中的 Conventional Commits 前缀不做改写例如 feat(cart):、fix(order):、chore(deps):。 规范中给出的标准示例 * feat(cart): add support for gift card line items by [shahednasser](https://github.com/shahednasser) in [#14500](https://github.com/medusajs/medusa/pull/14500) 这一作者 PR 链接的格式约定与仓库中的真实产物完全一致。例如 [packages/core/core-flows/CHANGELOG.md](https://link.gitcode.com/i/e6adc26cdbddd82d9710eeb07669043d) 中 2.20.1 版本的条目即为 - [#16704](https://github.com/medusajs/medusa/pull/16704) ... Thanks [shahednasser](https://github.com/shahednasser)! - fix(core-flows): add a name for when step可见作者与 PR 编号是发布产物的必备要素。 ## 提交前缀到章节的映射表 把 commit 前缀归类到章节遵循下表这是本规范的核心判定逻辑 | Conventional commit prefix | 章节Section | |---------------------------|-----------------| | feat: / feat(scope): | Features | | fix: / fix(scope): | Bugs | | docs: / docs(scope): | Documentation | | chore: / chore(scope): | Chores | | refactor:、perf:、build:、ci: | Chores | | test: | Chores | | 翻译 / i18n 类 PR | Other Changes | | 无法干净归入以上任一类的改动 | Other Changes | 从源码侧佐证仓库根目录 [CHANGELOG.md](https://link.gitcode.com/i/9ba4e2a3712f9de0f53fc46ff025cecc) 记录的早期条目即按 Bug Fixes 等章节聚合而 [packages/core/core-flows/CHANGELOG.md](https://link.gitcode.com/i/e6adc26cdbddd82d9710eeb07669043d) 中可同时看到 feat(core-flows):、fix(core-flows):、chore(core-flows): 等前缀混排在 Patch Changes 下正是这些前缀驱动了最终 Release Notes 的章节归类。 ## Highlights 章节不是所有 PR 都配得上高亮 ### 何时写 Highlights 发布类型判定详见 [reference/release-types.md](https://link.gitcode.com/i/902e1aab90fa0daa62e9a8d37474cce1) - **无 HighlightsMinimal**补丁版本只有例行修复与杂务无用户可见的新行为、无需要用户操作的内容时整篇发布说明不包含 Highlights 章节 - **单高亮Single Highlight**有一个改动是该版本发布的主要原因如关键回归修复或有一个重要新功能伴随少量修复 - **多高亮Multi-Highlight**多个改动各自值得单独解释或 minor / major 版本携带多个值得注意的功能。 ### 什么样的改动才算 Highlight 至少满足以下条件之一 - **新模块**在 packages/modules/ 或 packages/plugins/ 下引入全新商业模块如订阅模块、Loyalty 插件 - **大范围 API 面**为某个领域新增一批端点到服务方法而不是单个新字段或过滤器 - **新架构模式**引入框架级能力如新的工作流原语、新插件架构、新事件系统 - **重大新商业能力**解锁此前不可能的主要用例如 B2B 定价、数字商品、多仓履约、新支付流程架构。 **不构成 Highlight**只进 Features 普通条目即可单个新过滤参数、现有资源的单个可选字段、管理后台的小型 UI 改进、只加一个方法的非破坏性 API 扩展、新翻译/语言、无用户可见行为变化的依赖升级、测试基础设施改进、常规 DX 优化更好的报错文案、新 CLI 标志。 规则很简单**读者需要改代码或改架构才能用上的改动是 Highlight读者会感到有意思的改动是 Highlight读者完全可以忽略、一切照常的改动大概率不是**。 ### Highlight 子章节的写法 每个 Highlight 是一个 H3 子章节多高亮时子章节之间用 --- 分隔线隔开。结构为H3 标题 → 正文散文 → 可选代码块 → PR 链接列表 markdown ## Highlights ### Priority-based Event Processing The event bus now supports assigning a priority level to events. Higher-priority events are processed before lower-priority ones within the same queue, enabling time-sensitive workflows (such as payment confirmations) to run ahead of background tasks. [#14520](https://github.com/medusajs/medusa/pull/14520) **H3 标题要求**用简短、描述性的标题概括**结果或能力**而非照抄 PR 标题使用 Title Case聚焦用户/开发者获得了什么而不是内部实现细节。 - 好标题Priority-based Event Processing、Fix credit line computation on order cancellation - 坏标题feat(events): add priority queue to event bus照抄 PR 标题、Event Bus Update过于含糊 **正文要求**1–4 句话说明改了什么、为什么重要、如果是破坏性变更还需要什么行动用现在时或过去时的主动语态避免 we写成 Medusa now supports…**全文禁用 em-dash——**。 **PR 链接要求**放在每个 Highlight 子章节的最底部每个链接独占一行、裸链接形式不包裹任何说明文字例如 markdown [#14441](https://github.com/medusajs/medusa/pull/14441) [#14520](https://github.com/medusajs/medusa/pull/14520) 不要写成 See #14441 and #14520 这种带引导语的形式。 ### 破坏性变更内嵌在 Highlight 中且必须加 破坏性变更的判定PR 的 changeset 声明为 minor而非 patch或 PR 带有 breaking-change 标签两者满足其一即可工作流会在 prompt 上下文中预先统计 minor_changesets 总数。 破坏性变更的处理规则这是本技能最重要的约束之一 1. **必须出现在 Highlights 章节**且**不允许**存在独立的 ## Breaking Changes 顶层章节 2. Highlight 子章节以单独一行的 Breaking change 开头 3. 迁移步骤配置变更、import 路径更新、CLI 命令必须放进 fenced code block 4. 如果只影响部分用户在 行之后追加 引用块说明受影响人群。 标准示例 markdown ### Zod Dependency Restructuring Breaking change Zod has been moved from a peer dependency to a direct dependency of medusajs/framework. If you previously installed Zod explicitly in your project to satisfy the peer dependency requirement, you can remove it. [#14441](https://github.com/medusajs/medusa/pull/14441) 带仅部分用户受影响引用块的示例 markdown Breaking change This change only affects projects that manually configure the event bus priority settings. If you use the default configuration, no action is required. Zod has been moved... ### 需要用户动手的 Highlight 必须附带代码块 凡涉及开发者必须执行的操作安装包、运行命令、改配置、更新 import 路径、执行迁移Highlight 中必须在正文之后、PR 链接之前放置 fenced code block给出**精确可复制的命令** markdown ### Improved pnpm Support Medusas CLI and starter templates now fully support pnpm as a package manager. Pass --package-manager pnpm when creating a new project: bash npx create-medusa-applatest my-store --package-manager pnpm [#14600](https://github.com/medusajs/medusa/pull/14600) ## New Contributors 章节首次贡献者 当存在首次贡献者时添加该章节。注意此章节的条目格式与普通条目不同是单行作者 PR 链接 markdown ## New Contributors * username made their first contribution in [#NNNN](https://github.com/medusajs/medusa/pull/NNNN) ## Full Changelog 行永远的最后一行 Full Changelog 行永远是发布说明正文的最后一行格式如下 markdown **Full Changelog**: [vX.Y.Z-prev...vX.Y.Z](https://github.com/medusajs/medusa/compare/vX.Y.Z-prev...vX.Y.Z)【免费下载链接】medusaThe worlds most flexible commerce platform for agents and developers项目地址: https://gitcode.com/GitHub_Trending/me/medusa创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考