minimum_pre_commit_version: 4.0.0

exclude: ^LICENSES/|\.(html|csv|svg)$



default_stages: [pre-commit]

ci:

  autofix_prs: false

  autoupdate_schedule: monthly



repos:

  # pre-commit 基础检查

  - repo: https://gitcode.com/pre-commit/pre-commit-hooks

    rev: v4.6.0

    hooks:

      - id: trailing-whitespace

      - id: end-of-file-fixer

      - id: check-yaml

        args: ["--allow-multiple-documents"]  # 兼容K8S

      - id: check-added-large-files  # 拦截>50MB文件（默认阈值）

      - id: check-merge-conflict     # 检测未解决的合并冲突（<<<<<<< HEAD）

      - id: detect-private-key       # 检测硬编码的私钥/密钥

      - id: check-json

      - id: no-commit-to-branch     # 禁止直接提交到main/master分支



# -------------------------- Python 核心检查 --------------------------

  # Ruff：Python 代码检查+格式化

  - repo: https://gitcode.com/gh_mirrors/ru/ruff-pre-commit

    rev: v0.14.14

    hooks:

      - id: ruff-check

        args: [--output-format, github, --fix]

        types: [python]

      - id: ruff-format

        types: [python]



  # codespell：注释/文档拼写检查（忽略项目专有名词）

  - repo: https://gitcode.com/gh_mirrors/co/codespell

    rev: v2.4.1

    hooks:

      - id: codespell

        args: [

            "-L",

            "CANN,cann,NNAL,nnal,ASCEND,ascend,EnQue,CopyIn,ArchType,AND,ND,tbe,copyin,alog",

            "--skip",

            "*.py,*.cpp,*.hpp,*.c,*.h", # 仅查文档/注释，跳过代码文件

          ]



  # typos：代码标识符拼写检查

  - repo: https://gitcode.com/gh_mirrors/ty/typos

    rev: v1.32.0

    hooks:

      - id: typos

        args: ["--force-exclude", "--config", "pre-commit/typos.toml"]



#--------------- C++ 核心检查 ---------------------------------------------

  # clang-format：C/C++ 代码格式化

  - repo: https://gitcode.com/pre-commit-clang/mirrors-clang-format

    rev: v18.1.8

    hooks:

      - id: clang-format

        files: \.(c|h|cpp|hpp|cc|hh|cxx|hxx)$

        types_or: [c, c++]

        args: ["--style={BasedOnStyle: google, IndentWidth: 4}"]

        exclude: ^build/|^tests/third_party/ 

        

  # markdownlint：Markdown 格式检查（仅CI手动执行）

  - repo: https://gitcode.com/gh_mirrors/ma/markdownlint-cli

    rev: v0.46.0

    hooks:

      - id: markdownlint

        exclude: '.*\.inc\.md$|.*report_template\.md$|.*contributors\.md$|.*PULL_REQUEST_TEMPLATE\.md$'

        stages: [manual]

        description: "Markdown format check (run in CI: pre-commit run markdownlint --all-files)"