變更紀錄
變更紀錄
標題為「變更紀錄」的區段NextPDF 生態系橫跨多個儲存庫中的眾多套件。本頁是跨儲存庫索引，說明變更的記錄方式，以及每個套件自身變更紀錄的位置。請將它視為索引與慣例參考，而不是每一筆提交的重述。每個套件都在自己的儲存庫中維護權威且已發行的變更紀錄。此處的摘要表僅彙整 每個已發行版本的變更類別，由各儲存庫的 Conventional Commits 歷史推導而來。
作為一份文件索引，本頁不對任何套件做出行為宣稱。若要閱讀每個套件在撰寫提交、切出發行版時遵循的規則，請參閱 變更紀錄慣例。
變更如何被記錄
標題為「變更如何被記錄」的區段每個公開的 NextPDF 儲存庫皆遵循兩項約定：
- Conventional Commits 1.0.0 — 每筆提交主旨採用
type(scope): description格式，其中type為feat、fix、perf、refactor、docs、test、build、ci、chore或revert之一。在 type/scope 後加上!，或加上BREAKING CHANGE:註腳，即標示為不相容的變更。與安全性相關的修正會被標記，方便你篩選出來。 - Semantic Versioning 2.0.0 —
feat會提升次版號，fix/perf會提升修訂號，而破壞性變更會提升主版號。每個儲存庫中已發行的CHANGELOG.md會依版本分組人類可讀的條目，並使用 Keep a Changelog 區段。
以下摘要僅涵蓋 使用者可見 的類別：feat（新功能）、fix（修正後的行為）、perf（效能）、security（與安全性相關的修正），以及破壞性變更。僅供內部使用的提交類型（docs、test、ci、chore、refactor）刻意不納入跨儲存庫摘要。它們不會改變套件使用者所觀察到的內容。
每個套件的變更紀錄存放於何處
標題為「每個套件的變更紀錄存放於何處」的區段每個套件權威的敘述式變更紀錄，都位於該套件自身儲存庫中的 CHANGELOG.md，並依已發行版本分組。若需完整的條目文字，請使用該儲存庫的發行頁面或其 CHANGELOG.md。本索引不會重複那些文字。
| 套件 | 儲存庫 | 權威變更紀錄 |
|---|---|---|
nextpdf/core | nextpdf | CHANGELOG.md（Keep a Changelog） |
nextpdf/server | nextpdf-server | CHANGELOG.md |
nextpdf/laravel | nextpdf-Laravel | CHANGELOG.md |
nextpdf/symfony | nextpdf-Symfony | CHANGELOG.md |
nextpdf/codeigniter | nextpdf-CodeIgniter | CHANGELOG.md |
nextpdf/artisan | nextpdf-Artisan | CHANGELOG.md |
nextpdf/gotenberg | nextpdf-Gotenberg | CHANGELOG.md |
nextpdf/cloudflare | nextpdf-Cloudflare | CHANGELOG.md |
nextpdf/compat-legacy | nextpdf-compat-tcpdf | CHANGELOG.md |
nextpdf（Python 綁定） | nextpdf-python | CHANGELOG.md |
跨儲存庫摘要 — 各套件最新已發行版本的類別
標題為「跨儲存庫摘要 — 各套件最新已發行版本的類別」的區段本表以唯讀方式產生。它讀取每個儲存庫截至其最新已發行標籤的 Conventional Commits 歷史，並計算使用者可見的類別。它 僅回報類別計數 — 從不揭露原始提交主旨 — 因此不會暴露任何內部識別碼、分支名稱或規劃參照。若需任一列的敘述式細節，請參照該套件自身的 CHANGELOG.md。
| 套件 | 最新已發行 | 新功能（feat） | 修正（fix） | 效能（perf） | 安全性 | 破壞性 |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | 是 |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | 否 |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | 否 |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | 否 |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | 否 |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | 否 |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | 否 |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | 否 |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | 否 |
nextpdf（Python） | v1.1.0 | 7 | 5 | 0 | 0 | 否 |
這些計數是累計到指定標籤為止的數量。 對每個整合套件而言，第一個帶標籤的發行版包含其完整的 1.0 之前歷史。 其中
nextpdf/core的「破壞性」欄位顯示yes，是因為核心引擎曾發行過破壞性的主版本。 每個版本的詳細內容及各自的遷移路徑， 位於核心儲存庫的CHANGELOG.md及其migration/指南中。 本索引不會重述它們。
本頁刻意略去的內容
標題為「本頁刻意略去的內容」的區段為避免公開變更紀錄洩漏任何內部資訊，本索引從不揭露下列任何項目：
- 原始提交主旨或內文；
- 內部議題、工單、週期、波次或工作項目識別碼；
- 私有分支名稱或尚未發行且仍在進行的工作；
- 藍圖或未公布的功能；
- 自動產生的貢獻者署名。
只有當某項變更成為某個公開套件已發行且已帶標籤版本的一部分時，它才會在此處可見。尚未發行的工作不會出現。