# @davidspekorg/semantic-release-jira-notes 中文文档

规范地址：https://npmcn.com/package/%40davidspekorg/semantic-release-jira-notes/

版本：1\.1\.2
npm 元数据更新时间：2026-08-19T10:58:55.294Z
中文译文更新时间：2026-11-11T16:27:57.928Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40davidspekorg/semantic-release-jira-notes
原文对照：https://npmcn.com/package/%40davidspekorg/semantic-release-jira-notes/?lang=original
项目主页：https://github.com/davidspek/semantic-release-jira-notes
源码仓库：https://github.com/davidspek/semantic-release-jira-notes

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：37.4 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.8\.1
- 运行依赖：0 个
- peer 依赖：@semantic-release/error 4\.0\.0，@semantic-release/release-notes-generator ^14\.1\.1
- 首次发布：2024-12-30T12:37:52.520Z
- 最新版本发布：2026-08-19T10:58:54.932Z
- 近 30 天下载量：6193（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 1 个）

## 中文简介

将 JIRA 问题链接添加到发布注释的语义发布插件

## 安装

```sh
npm install @davidspekorg/semantic-release-jira-notes
```

也可以使用：`pnpm add @davidspekorg/semantic-release-jira-notes`、`yarn add @davidspekorg/semantic-release-jira-notes`、`bun add @davidspekorg/semantic-release-jira-notes`

## README

# 语义 -- -- 释放 -- -- jira -- -- 注释

[![ESM-only package](https://img.shields.io/badge/package-ESM--only-ffe536.svg)](https://nodejs.org/api/esm.html) [![NPM version](https://img.shields.io/npm/v/semantic-release-jira-notes/latest.svg)](https://www.npmjs.com/package/semantic-release-jira-notes) [![Node version](https://img.shields.io/node/v/semantic-release-jira-notes/latest.svg)](https://nodejs.org/) [![Dependencies status](https://img.shields.io/librariesio/release/npm/semantic-release-jira-notes)](https://libraries.io/npm/semantic-release-jira-notes/tree) [![Install size](https://packagephobia.com/badge?p=semantic-release-jira-notes)](https://packagephobia.com/result?p=semantic-release-jira-notes)

[**语义释放**](https://github.com/semantic-release/semantic-release) 添加链接到 JIRA在发行说明中发布.

对于释放说明中发现的每个JIRA问题,它将添加一个链接,直接将这个问题带到JIRA上.

| 步骤 | 说明 |
| --- | :-: |
| `verifyConditions` | 验证配置选项 |
| `generateNotes` | 生成与 JIRA 问题相关的发布说明 |

## 预览

![Preview](https://npmcn.com/package/%40davidspekorg/semantic-release-jira-notes/docs/jira-link.png)

## 使用量

### 安装

```bash
# npm
npm install --save-dev @davidspekorg/semantic-release-jira-notes
# yarn
yarn add --dev @davidspekorg/semantic-release-jira-notes
# pnpm
pnpm add --save-dev @davidspekorg/semantic-release-jira-notes
```

### 投入

| 名称 | 需求 | 说明 |
| --- | :-: | --- |
| 齐拉霍斯特 | ✅ | 您的 JIRA 主机域名 |
| 票面前缀 | ❌ | 车票前缀相匹配. 如果不提供,请匹配所有门票前缀. |

### 配置

```json
{
  "plugins": [
    "@semantic-release/commit-analyzer",
    ["semantic-release-jira-notes", {
      "jiraHost": "davidspek.atlassian.net",
      "ticketPrefixes": ["ATP", "OMS"]
    }]
    "@semantic-release/git",
    "@semantic-release/github"
  ]
}
```

> **说明**: 此插件使用 `@semantic-release/release-notes-generator` 在引擎盖下,所以你不需要再使用它.

您也可以使用由 [@ semetic-release/release-note-generator (英语)](https://github.com/semantic-release/release-notes-generator#options)。 。 。 .

```json
{
  "plugins": [
    "@semantic-release/commit-analyzer",
    ["semantic-release-jira-notes", {
      "jiraHost": "davidspek.atlassian.net",
      "preset": "conventionalcommits",
      "presetConfig": {
        "types": [
          { "type": "feat", "section": "Features" },
          { "type": "fix", "section": "Bug Fixes" },
          { "type": "build", "section": "Dependencies Updates", "hidden": false }
        ]
      }
    }]
    "@semantic-release/git",
    "@semantic-release/github"
  ]
}
```

## 捐款

欢迎你们为这个存放处作出贡献。 请参考 [捐款额](https://npmcn.com/package/%40davidspekorg/semantic-release-jira-notes/CONTRIBUTING.md) 更多信息.

## 常见问题

### @davidspekorg/semantic-release-jira-notes 是什么？

将 JIRA 问题链接添加到发布注释的语义发布插件

### 如何安装 @davidspekorg/semantic-release-jira-notes？

在项目目录运行 npm install @davidspekorg/semantic-release-jira-notes，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@semantic-release/error（4\.0\.0）、@semantic-release/release-notes-generator（^14\.1\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @davidspekorg/semantic-release-jira-notes 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/davidspekorg\_\_semantic-release-jira-notes 是否存在。

### @davidspekorg/semantic-release-jira-notes 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @davidspekorg/semantic-release-jira-notes 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.8\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @davidspekorg/semantic-release-jira-notes 可以商用吗？

@davidspekorg/semantic-release-jira-notes 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @davidspekorg/semantic-release-jira-notes 的下载量有多少？

根据 npm 官方下载统计，@davidspekorg/semantic-release-jira-notes 在 2026/10/12 – 2026/11/10 这 30 天内被下载 6,193 次，日均约 206 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @davidspekorg/semantic-release-jira-notes 还在维护吗？

最新版本 1\.1\.2 发布于 2026/08/19（2 个月前）；至今共发布 3 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/12/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。