nbdev3：筆記本驅動開發，設定遷移至 pyproject.toml
使用 Jupyter Notebooks 創建令人愉悅的軟體。文件支援 LaTeX、可搜尋、自動超連結（包括透過 nbdev-index 對許多包的開箱即用支援）將包發佈到 PyPI 和 conda 以及簡化包發布的工具。
秒懂
- 它是什麼？
- nbdev 從 Jupyter 筆記本產生文件、測試、持續整合和打包；nbdev3 將設定從 settings.ini 遷移至 pyproject.toml。
- 適合誰用？
- nbdev3 保留了筆記本驅動的工作流程，同時將專案設定遷移至 pyproject.toml，README 將 nbdev-migrate-config 作為從 nbdev2 升級的路徑。專案採用 Apache 2.0 授權，版權歸 fast.ai, Inc.，自 2019 年起。
- 可以商用嗎？
- 可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 Jupyter Notebook（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
nbdev3 將設定遷移至 pyproject.toml
README 開頭是一則針對 nbdev3 的破壞性變更通知，日期為 2026 年 1 月。設定已從 settings.ini 遷移到 pyproject.toml，遵循 PEP 621。專案中繼資料現在位於標準的 [project] 區段，而 nbdev 特有的設定放在 [tool.nbdev] 區段。要從 nbdev2 遷移，README 說明在專案根目錄執行 nbdev-migrate-config，它會將 settings.ini 轉換為 pyproject.toml，並把 GitHub Actions 工作流程更新為相容 nbdev3 的版本。根據 README 的說法，現有的筆記本和程式碼不需要任何變更。
筆記本驅動的開發平台
nbdev 是一個筆記本驅動的開發平台。你用輕量標記編寫筆記本，就能得到高品質的文件、測試、持續整合和打包。README 認為，相比傳統程式設計環境，除錯和重構更容易，因為活躍物件始終在手邊；同時，由於測試和文件是一等公民，這個平台推動了軟體工程最佳實務。倉庫本身以 Jupyter Notebook 格式編寫，截至撰寫時有 5,303 個星標和 517 個 fork。README 的 FAQ 中也提到，nbdev 過去三年被用於多種嚴肅軟體專案，包括深度學習函式庫、API 用戶端、Python 語言擴充和終端使用者介面。
使用 Quarto 產生文件
文件使用 Quarto 自動產生，並託管在 GitHub Pages 上。產生的文件支援 LaTeX、可搜尋，超連結會自動加入，包括透過 nbdev-index 對許多套件的開箱即用支援。多個指令支撐這條管線：nbdev-docs 建立 Quarto 文件和 README.md，nbdev-preview 在本機預覽文件，nbdev-filter 是 Quarto 的筆記本過濾器，nbdev-install-quarto 在 macOS 或 Linux 上安裝最新版 Quarto，並在 Windows 上列印安裝說明。安裝 Quarto 時，nbdev 在首次設定專案時會嘗試自動下載並安裝它，這可能需要 root 權限。
測試與持續整合
測試以普通筆記本儲存格的形式編寫，用一條指令即可平行執行。持續整合開箱即用，藉助 GitHub Actions 執行測試並重建文件。指令清單包括 nbdev-test，它平行測試與路徑相符的筆記本並傳遞旗標；還有 nbdev-prepare，它匯出、測試、清理筆記本，並在需要時渲染 README。README 沒有給出基準測試或實測測試執行時間，來源中也不包含任何效能數據，因此這些指令的實際速度需要自行驗證。
雙向同步與 git 友善的筆記本
筆記本與純文字原始碼之間的雙向同步讓你可以使用 IDE 進行程式碼導覽或快速編輯。每個匯出的儲存格都帶有它唯一的身分，即筆記本儲存格 ID，因此 nbdev-update 總能更新正確的儲存格。git 友善特性包括 Jupyter 和 git 鉤子，它們清理不需要的中繼資料，並以人類可讀的格式呈現合併衝突。相關指令有 nbdev-clean、nbdev-fix、nbdev-merge 和 nbdev-install-hooks，後者安裝 Jupyter 和 git 鉤子以自動清理、信任和修復合併衝突。README 也提到 nbdev-migrate 指令，用於將 v1 的 markdown 和筆記本檔案轉換為 v2。
安裝與平台支援
安裝方式是 pip install nbdev。該套件適用於 macOS、Linux 和大多數 Unix 風格的作業系統；在 Windows 上，它可在 WSL 下執行，但不能在 cmd 或 Powershell 下執行。README 指出，nbdev 必須安裝到與 Jupyter 和你的專案相同的 Python 環境中。首頁是 https://nbdev.fast.ai/，截至撰寫時倉庫有 185 個未關閉的問題；README 沒有描述支援管道或回應時間承諾，也沒有提供任何安全保證。
命令列工具一覽
在終端機執行 nbdev-help 會顯示全部主控台指令碼的清單。清單包括 nbdev-new（建立專案）、nbdev-create-config（建立 pyproject.toml 設定檔）、nbdev-export（將筆記本匯出為 Python 模組）、nbdev-docs（建立 Quarto 文件和 README.md）、nbdev-pypi 和 nbdev-conda（建立並上傳套件到 PyPI 和 conda）、nbdev-release-both（同時發佈兩者）、nbdev-changelog（根據已關閉並標記的 GitHub issue 建立 CHANGELOG.md）、nbdev-requirements（根據 pyproject.toml 編寫 requirements.txt）、nbdev-sidebar（建立 sidebar.yml）等。README 中的說明輸出為每個指令列出了一行描述，但沒有記錄每個旗標。
FAQ、授權與貢獻：FAQ 回答了三個問題。第一，關於包含匯入和計算混合的儲存格的警告：解決辦法是將匯入和其他程式碼拆分為不同的儲存格，因為在建構文件網站時 nbdev 會執行匯入、匯出儲存格和 show_doc 函式，混合會導致錯誤或變慢；只有頂層陳述句算數，try 區塊中的 import 和函式定義內的 import 不受影響。第二，Quarto 安裝可能需要 root 權限；README 為 Linux 提供了非 root 安裝路徑，包括下載 Quarto、解包並符號連結到 ~/.local/bin。專案版權歸 fast.ai, Inc. 所有，時間從 2019 年至今，採用 Apache 2.0 授權。該授權授予永久、全球性、非獨占、免費、免版稅的版權授權，允許複製、準備衍生作品、公開展示、公開表演、再授權和散布。授權文字沒有提及支援、擔保或安全態勢。README 也引用了貢獻指南和行為準則，並要求貢獻者透過 nbdev-install-hooks 安裝 git 鉤子。
以專案記號完成核驗
升級 nbdev3 時，先在專案根目錄執行 `nbdev-migrate-config`，檢查 `pyproject.toml` 的 `[project]` 與 `[tool.nbdev]`，再用 `nbdev-prepare` 確認匯出、測試和文件流程。Windows 必須透過 WSL，且 nbdev、Jupyter 與專案要在同一 Python 環境。
answerdotai-nbdev-deep-analysis 的實務判讀不能只看功能名稱。應把 README 中提到的入口放進與正式環境隔離的工作目錄，逐項記錄安裝版本、輸入、輸出與錯誤。對 fastcore，觀察匯入後的 L、store_attr 與 delegates；對 nbdev，觀察 pyproject.toml、nbdev-export 和 nbdev-test 是否互相一致；對 Claude 外掛與技能，觀察 plugin.json、SKILL.md、commands 與 MCP 連接器是否被正確載入；對知識工作外掛，觀察 marketplace 與斜線命令；對 ds4，觀察模型佈局、KV 快取與 TCP 連線；對 Antrea，觀察 Kubernetes 節點的 OVS、NodeIPAM 與 pod network；對 Anubis，觀察 HTTP 請求被允許或阻擋的理由；對 github-readme-stats，觀察 SVG、快取與 API 速率限制。這些結果才足以支撐本專案的採用決策。
文章中的判斷範圍也要和來源保持一致。README 有寫出的能力可以作為測試案例，沒有寫出的效能、相容性、資安承諾與服務可用性則只能列為未知。若測試結果與文件不一致，先保存完整命令和輸出，再檢查版本標籤、設定檔與依賴版本；不要用單次成功掩蓋失敗案例。對涉及外部服務、權杖、網路流量或使用者資料的功能，測試資料應採用可撤銷的憑證與非生產內容，並確認日誌沒有洩漏敏感值。對需要長期維護的整合，還要記錄升級後同一命令的輸出差異，將結果回填到該專案自己的 issue 或變更紀錄。這能讓本文的結論落在 answerdotai-nbdev-deep-analysis 的實際行為，而不是抽象的工具推薦。
判讀時還要把人員、權限與回滾一起寫進紀錄。對需要 GitHub 權杖的功能，先限制權限範圍，確認請求只觸及預期的儲存庫與端點，再刪除測試權杖。對會修改檔案的工具，先複製測試目錄，保存修改前後的差異，確認失敗時能回到原狀。對網路服務，分開檢查成功回應、拒絕回應、逾時和上游服務不可用四種情況。對文件生成流程，檢查產物是否可重建，避免只看到一次成功便推定每次都一致。對模型推理，除了速度，也要記錄顯存、記憶體、快取命中和輸入長度。這些紀錄都必須附上 answerdotai-nbdev-deep-analysis 這個專案的具體檔案或命令，才有辦法在版本更新後重做同一項檢查。
編輯結論
nbdev3 保留了筆記本驅動的工作流程，同時將專案設定遷移至 pyproject.toml，README 將 nbdev-migrate-config 作為從 nbdev2 升級的路徑。專案採用 Apache 2.0 授權，版權歸 fast.ai, Inc.，自 2019 年起。 採用前先依 answerdotai-nbdev-deep-analysis 的 README 具體命令、設定檔與限制完成隔離核驗，再決定是否納入正式工作流程。
社群筆記