TencentBlueKing · dengyh · Jan 9, 2026 · Dec 29, 2025 · Dec 30, 2025 · Jan 6, 2026
diff --git a/.flake8 b/.flake8
@@ -0,0 +1,29 @@
+[flake8]
+ignore = F405, W503, E203
+exclude =
+    *migrations*,
+    # python related
+    *.pyc,
+    .git,
+    __pycache__,
+    */node_modules/*
+    ./static/*
+    ./blueking/*
+    */blueking/*
+    ./blueapps/*
+    */blueapps/*
+    ./pipeline/*
+    ./sites/*
+    ./config/default.py
+    ./scripts_tools/*
+    ./support-files/*
+    ./upgrade.py
+    ./iam/*
+
+
+max-line-length=120
+max-complexity=26
+format=pylint
+show_source=False
+statistics=True
+count=True
diff --git a/.isort.cfg b/.isort.cfg
@@ -0,0 +1,4 @@
+[settings]
+profile = black
+known_first_party = bk_plugin_framework,bk_plugin_runtime
+line_length = 120
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -0,0 +1,32 @@
+default_stages: [pre-commit]
+repos:
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.21.2
+    hooks:
+      - id: pyupgrade
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-merge-conflict
+
+  - repo: https://github.com/psf/black
+    rev: 25.12.0
+    hooks:
+      - id: black
+        language_version: python3.10
+        args:
+          - "--line-length=120"
+
+  - repo: https://github.com/pycqa/isort
+    rev: 7.0.0
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.3.0
+    hooks:
+      - id: flake8
+        args:
+          - "--config"
+          - ".flake8"
diff --git a/bk-plugin-framework/.flake8 b/bk-plugin-framework/.flake8
diff --git a/bk-plugin-framework/bk_plugin/__init__.py b/bk-plugin-framework/bk_plugin/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin/versions/__init__.py b/bk-plugin-framework/bk_plugin/versions/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/__init__.py b/bk-plugin-framework/bk_plugin_framework/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/__version__.py b/bk-plugin-framework/bk_plugin_framework/__version__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/constants.py b/bk-plugin-framework/bk_plugin_framework/constants.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,6 +8,7 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
+
 from enum import Enum
 
 

diff --git a/bk-plugin-framework/bk_plugin_framework/envs.py b/bk-plugin-framework/bk_plugin_framework/envs.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,15 +8,17 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
-import os
+
 import base64
 import hashlib
 import logging
+import os
 
 try:
     from pydantic.v1 import BaseSettings
 except ImportError:
     from pydantic import BaseSettings
+
 from django.conf import settings as default_settings
 
 logger = logging.getLogger("bk_plugin")

diff --git a/bk-plugin-framework/bk_plugin_framework/hub/__init__.py b/bk-plugin-framework/bk_plugin_framework/hub/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -10,9 +9,10 @@
 specific language governing permissions and limitations under the License.
 """
 
+import logging
 import os
 import typing
-import logging
+
 from bk_plugin_framework.utils.module_load import load_form_module_path
 
 logger = logging.getLogger("bk-plugin-framework")

diff --git a/bk-plugin-framework/bk_plugin_framework/kit/__init__.py b/bk-plugin-framework/bk_plugin_framework/kit/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -14,13 +13,14 @@
     from pydantic.v1 import Field
 except ImportError:
     from pydantic import Field  # noqa
+
 from bk_plugin_framework.kit.plugin import (  # noqa
-    Plugin,
-    InputsModel,
+    Callback,
     Context,
-    OutputsModel,
     ContextRequire,
-    State,
-    Callback,
     FormModel,
+    InputsModel,
+    OutputsModel,
+    Plugin,
+    State,
 )
diff --git a/bk-plugin-framework/bk_plugin_framework/kit/api.py b/bk-plugin-framework/bk_plugin_framework/kit/api.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,18 +8,19 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
+
 import json
 
-from django.utils.decorators import method_decorator
+from apigw_manager.apigw.decorators import apigw_require
+from bkoauth import get_app_access_token
 from django.conf import settings as default_settings
-from rest_framework.views import APIView
+from django.utils.decorators import method_decorator
 from rest_framework.request import Request
-from bkoauth import get_app_access_token
-from apigw_manager.apigw.decorators import apigw_require
+from rest_framework.views import APIView
 
 from bk_plugin_framework.envs import settings
-from bk_plugin_framework.kit.decorators import login_exempt, inject_user_token
 from bk_plugin_framework.kit.authentication import CsrfExemptSessionAuthentication
+from bk_plugin_framework.kit.decorators import inject_user_token, login_exempt
 
 custom_authentication_classes = (
     [

diff --git a/bk-plugin-framework/bk_plugin_framework/kit/authentication.py b/bk-plugin-framework/bk_plugin_framework/kit/authentication.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,6 +8,7 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
+
 from rest_framework.authentication import SessionAuthentication
 
 

diff --git a/bk-plugin-framework/bk_plugin_framework/kit/decorators.py b/bk-plugin-framework/bk_plugin_framework/kit/decorators.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,6 +8,7 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
+
 from functools import wraps
 
 from bk_plugin_framework.envs import settings

diff --git a/bk-plugin-framework/bk_plugin_framework/kit/plugin.py b/bk-plugin-framework/bk_plugin_framework/kit/plugin.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -10,18 +9,21 @@
 specific language governing permissions and limitations under the License.
 """
 
+import inspect
 import re
 import typing
-import inspect
 
 try:
     from pydantic.v1 import BaseModel
 except ImportError:
     from pydantic import BaseModel
 
-from bk_plugin_framework.hub import VersionHub
 from bk_plugin_framework.constants import State
-from bk_plugin_framework.runtime.callback.api import prepare_callback, CallbackPreparation
+from bk_plugin_framework.hub import VersionHub
+from bk_plugin_framework.runtime.callback.api import (
+    CallbackPreparation,
+    prepare_callback,
+)
 
 VALID_VERSION_PATTERN = re.compile(r"^[0-9]+\.[0-9]+\.[0-9][a-z0-9]*$")
 
@@ -50,7 +52,7 @@ class ContextRequire(BaseModel):
     pass
 
 
-class Callback(object):
+class Callback:
     def __init__(self, callback_id: str = "", callback_data: dict = {}):
         self.id = callback_id
         self.data = callback_data

diff --git a/bk-plugin-framework/bk_plugin_framework/metrics.py b/bk-plugin-framework/bk_plugin_framework/metrics.py
@@ -1,10 +1,9 @@
-# -*- coding: utf-8 -*-
 import os
 import socket
 import time
 from functools import wraps
 
-from prometheus_client import Counter, Histogram, Gauge
+from prometheus_client import Counter, Gauge, Histogram
 
 
 def get_hostname():
@@ -129,14 +128,16 @@ def _wrapper(*args, **kwargs):
 
 # 正在执行的 EXECUTE 数量
 BK_PLUGIN_EXECUTE_RUNNING_PROCESSES = Gauge(
-    name="bk_plugin_execute_running_processes", documentation="count running state processes",
-    labelnames=["hostname", "version"]
+    name="bk_plugin_execute_running_processes",
+    documentation="count running state processes",
+    labelnames=["hostname", "version"],
 )
 
 # 正在执行的 SCHEDULE 数量
 BK_PLUGIN_SCHEDULE_RUNNING_PROCESSES = Gauge(
-    name="bk_plugin_schedule_running_processes", documentation="count running state schedules",
-    labelnames=["hostname", "version"]
+    name="bk_plugin_schedule_running_processes",
+    documentation="count running state schedules",
+    labelnames=["hostname", "version"],
 )
 
 # CALLBACK 异常次数

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/__init__.py b/bk-plugin-framework/bk_plugin_framework/runtime/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/callback/__init__.py b/bk-plugin-framework/bk_plugin_framework/runtime/callback/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/callback/api.py b/bk-plugin-framework/bk_plugin_framework/runtime/callback/api.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.
@@ -9,23 +8,24 @@
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
 """
-import uuid
-import time
+
 import json
 import logging
+import time
+import uuid
 
-from django.conf import settings as default_settings
 from celery import current_app
 from cryptography.fernet import Fernet
+from django.conf import settings as default_settings
 
+from bk_plugin_framework.constants import State
 from bk_plugin_framework.envs import settings
 from bk_plugin_framework.runtime.schedule.models import Schedule
-from bk_plugin_framework.constants import State
 
 logger = logging.getLogger("bk_plugin")
 
 
-class CallbackPreparation(object):
+class CallbackPreparation:
     def __init__(self, callback_id: str, callback_url: str):
         self.id = callback_id
         self.url = callback_url

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/callback/apps.py b/bk-plugin-framework/bk_plugin_framework/runtime/callback/apps.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/callback/celery/__init__.py b/bk-plugin-framework/bk_plugin_framework/runtime/callback/celery/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.

diff --git a/bk-plugin-framework/bk_plugin_framework/runtime/callback/celery/queues.py b/bk-plugin-framework/bk_plugin_framework/runtime/callback/celery/queues.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Tencent is pleased to support the open source community by making 蓝鲸智云 - PaaS平台 (BlueKing - PaaS System) available.
 Copyright (C) 2022 THL A29 Limited, a Tencent company. All rights reserved.