mofox-plugin-dev-toolkit 0.5.2__tar.gz → 0.6.0__tar.gz

{mofox_plugin_dev_toolkit-0.5.2/mofox_plugin_dev_toolkit.egg-info → mofox_plugin_dev_toolkit-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.5.2
+Version: 0.6.0
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://docs.mofox.studio/mpdt
 Project-URL: Repository, https://github.com/MoFox-Studio/mofox-plugin-toolkit
 Project-URL: Bug Tracker, https://github.com/MoFox-Studio/mofox-plugin-toolkit/issues
 Keywords: mofox,plugin,toolkit,cli,development
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Programming Language :: Python :: 3
@@ -30,11 +30,11 @@ Requires-Dist: watchdog>=3.0.0
 Requires-Dist: websockets>=12.0
 Requires-Dist: libcst>=1.8.6
 Requires-Dist: aiohttp>=3.9.0
-Requires-Dist: pillow>=11.2.0
 Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: fastapi>=0.104.0
 Requires-Dist: ruff>=0.1.6
 Requires-Dist: mypy>=1.7.0
+Requires-Dist: packaging>=23.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.3; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
@@ -225,8 +225,8 @@ mpdt dev
 # 指定主程序路径
 mpdt dev --neo-mofox-path /path/to/neo-mofox
 
-# 指定插件路径
-mpdt dev --plugin-path /path/to/plugin
+# 指定插件路径（作为参数）
+mpdt dev /path/to/plugin
 
 # 首次运行会提示配置
 # 之后会自动：
@@ -306,62 +306,7 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 发布到插件市场
-
-MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
-
-准备 GitHub token，至少需要仓库创建和 Release 写入权限：
-
-```bash
-set GITHUB_TOKEN=ghp_xxx
-set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
-set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
-```
-
-也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
-
-```bash
-mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
-```
-
-如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
-
-在插件目录执行一键发布：
-
-```bash
-mpdt market publish --owner your-github-user-or-org
-```
-
-该命令会依次执行：
-
-1. 读取 `manifest.json`。
-2. 构建 `.mfp` 包并计算 sha256。
-3. 如果 GitHub 仓库不存在则自动创建。
-4. 初始化或复用本地 git 仓库。
-5. 提交当前插件代码。
-6. 创建版本 tag，例如 `v1.0.0`。
-7. 推送分支和 tag 到 GitHub。
-8. 创建或复用 GitHub Release。
-9. 上传 `.mfp` Release 资产。
-10. 注册或更新中心服务器插件元数据。
-11. 提交新版本；如果版本已存在则同步版本元数据。
-
-常用参数：
-
-```bash
-mpdt market publish \
-  --owner MoFox-Studio \
-  --repo my_plugin \
-  --release-notes "First public release"
-```
-
-如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
-
-```bash
-mpdt market publish --owner MoFox-Studio --skip-push
-```
-
-### 7. 配置管理
+### 6. 配置管理
 
 ```bash
 # 交互式配置向导
@@ -391,7 +336,6 @@ mpdt config set-mofox /path/to/neo-mofox
 mpdt [OPTIONS] COMMAND [ARGS]...
 
 选项:
-  -v, --verbose    详细输出模式
   --no-color       禁用彩色输出
   --version        显示版本信息
   --help           显示帮助信息
@@ -423,7 +367,7 @@ mpdt init [PLUGIN_NAME] [OPTIONS]
 生成插件组件代码，始终生成异步方法，支持交互式和命令行两种模式。
 
 ```bash
-mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
+mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [PATH] [OPTIONS]
 
 组件类型:
   action          Action 组件 - 执行具体操作
@@ -437,16 +381,19 @@ mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
   service         Service 组件 - 服务类
   config          Config 组件 - 配置类
 
+位置参数:
+  PATH                      插件根目录路径（默认为当前目录）
+
 选项:
   -d, --description TEXT    组件描述信息
-  -o, --output PATH        输出目录（默认自动选择对应组件目录）
   -f, --force              覆盖已存在的文件
+  --root                   在插件根目录生成组件文件，而不是 components/ 文件夹
 
 示例:
   mpdt generate                                  # 交互式生成
   mpdt generate action SendMsg -d "发送消息"    # 命令行生成
   mpdt generate tool Formatter --force           # 强制覆盖
-  mpdt generate service DataService              # 生成服务类
+  mpdt generate service DataService ./my_plugin  # 在指定插件中生成服务类
 ```
 
 **注意**：不提供参数时将进入交互式问答模式，更易于使用。
@@ -517,11 +464,13 @@ mpdt build [PLUGIN_PATH] [OPTIONS]
 启动带热重载的开发模式，实时监控文件变化并自动重载插件。
 
 ```bash
-mpdt dev [OPTIONS]
+mpdt dev [PATH] [OPTIONS]
+
+位置参数:
+  PATH                     插件路径（默认当前目录）
 
 选项:
   --neo-mofox-path PATH    Neo-MoFox 主程序路径
-  --plugin-path PATH       插件路径（默认当前目录）
 
 功能特性:
   - 🔄 自动检测文件变化并热重载
@@ -544,6 +493,7 @@ mpdt dev [OPTIONS]
 
 示例:
   mpdt dev                                      # 在插件目录中运行
+  mpdt dev /path/to/plugin                      # 指定插件路径
   mpdt dev --neo-mofox-path /path/to/neo-mofox  # 指定主程序路径
 ```
 

{mofox_plugin_dev_toolkit-0.5.2 → mofox_plugin_dev_toolkit-0.6.0}/README.md

@@ -172,8 +172,8 @@ mpdt dev
 # 指定主程序路径
 mpdt dev --neo-mofox-path /path/to/neo-mofox
 
-# 指定插件路径
-mpdt dev --plugin-path /path/to/plugin
+# 指定插件路径（作为参数）
+mpdt dev /path/to/plugin
 
 # 首次运行会提示配置
 # 之后会自动：
@@ -253,62 +253,7 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 发布到插件市场
-
-MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
-
-准备 GitHub token，至少需要仓库创建和 Release 写入权限：
-
-```bash
-set GITHUB_TOKEN=ghp_xxx
-set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
-set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
-```
-
-也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
-
-```bash
-mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
-```
-
-如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
-
-在插件目录执行一键发布：
-
-```bash
-mpdt market publish --owner your-github-user-or-org
-```
-
-该命令会依次执行：
-
-1. 读取 `manifest.json`。
-2. 构建 `.mfp` 包并计算 sha256。
-3. 如果 GitHub 仓库不存在则自动创建。
-4. 初始化或复用本地 git 仓库。
-5. 提交当前插件代码。
-6. 创建版本 tag，例如 `v1.0.0`。
-7. 推送分支和 tag 到 GitHub。
-8. 创建或复用 GitHub Release。
-9. 上传 `.mfp` Release 资产。
-10. 注册或更新中心服务器插件元数据。
-11. 提交新版本；如果版本已存在则同步版本元数据。
-
-常用参数：
-
-```bash
-mpdt market publish \
-  --owner MoFox-Studio \
-  --repo my_plugin \
-  --release-notes "First public release"
-```
-
-如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
-
-```bash
-mpdt market publish --owner MoFox-Studio --skip-push
-```
-
-### 7. 配置管理
+### 6. 配置管理
 
 ```bash
 # 交互式配置向导
@@ -338,7 +283,6 @@ mpdt config set-mofox /path/to/neo-mofox
 mpdt [OPTIONS] COMMAND [ARGS]...
 
 选项:
-  -v, --verbose    详细输出模式
   --no-color       禁用彩色输出
   --version        显示版本信息
   --help           显示帮助信息
@@ -370,7 +314,7 @@ mpdt init [PLUGIN_NAME] [OPTIONS]
 生成插件组件代码，始终生成异步方法，支持交互式和命令行两种模式。
 
 ```bash
-mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
+mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [PATH] [OPTIONS]
 
 组件类型:
   action          Action 组件 - 执行具体操作
@@ -384,16 +328,19 @@ mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
   service         Service 组件 - 服务类
   config          Config 组件 - 配置类
 
+位置参数:
+  PATH                      插件根目录路径（默认为当前目录）
+
 选项:
   -d, --description TEXT    组件描述信息
-  -o, --output PATH        输出目录（默认自动选择对应组件目录）
   -f, --force              覆盖已存在的文件
+  --root                   在插件根目录生成组件文件，而不是 components/ 文件夹
 
 示例:
   mpdt generate                                  # 交互式生成
   mpdt generate action SendMsg -d "发送消息"    # 命令行生成
   mpdt generate tool Formatter --force           # 强制覆盖
-  mpdt generate service DataService              # 生成服务类
+  mpdt generate service DataService ./my_plugin  # 在指定插件中生成服务类
 ```
 
 **注意**：不提供参数时将进入交互式问答模式，更易于使用。
@@ -464,11 +411,13 @@ mpdt build [PLUGIN_PATH] [OPTIONS]
 启动带热重载的开发模式，实时监控文件变化并自动重载插件。
 
 ```bash
-mpdt dev [OPTIONS]
+mpdt dev [PATH] [OPTIONS]
+
+位置参数:
+  PATH                     插件路径（默认当前目录）
 
 选项:
   --neo-mofox-path PATH    Neo-MoFox 主程序路径
-  --plugin-path PATH       插件路径（默认当前目录）
 
 功能特性:
   - 🔄 自动检测文件变化并热重载
@@ -491,6 +440,7 @@ mpdt dev [OPTIONS]
 
 示例:
   mpdt dev                                      # 在插件目录中运行
+  mpdt dev /path/to/plugin                      # 指定插件路径
   mpdt dev --neo-mofox-path /path/to/neo-mofox  # 指定主程序路径
 ```
 

{mofox_plugin_dev_toolkit-0.5.2 → mofox_plugin_dev_toolkit-0.6.0/mofox_plugin_dev_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.5.2
+Version: 0.6.0
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://docs.mofox.studio/mpdt
 Project-URL: Repository, https://github.com/MoFox-Studio/mofox-plugin-toolkit
 Project-URL: Bug Tracker, https://github.com/MoFox-Studio/mofox-plugin-toolkit/issues
 Keywords: mofox,plugin,toolkit,cli,development
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Programming Language :: Python :: 3
@@ -30,11 +30,11 @@ Requires-Dist: watchdog>=3.0.0
 Requires-Dist: websockets>=12.0
 Requires-Dist: libcst>=1.8.6
 Requires-Dist: aiohttp>=3.9.0
-Requires-Dist: pillow>=11.2.0
 Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: fastapi>=0.104.0
 Requires-Dist: ruff>=0.1.6
 Requires-Dist: mypy>=1.7.0
+Requires-Dist: packaging>=23.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.3; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
@@ -225,8 +225,8 @@ mpdt dev
 # 指定主程序路径
 mpdt dev --neo-mofox-path /path/to/neo-mofox
 
-# 指定插件路径
-mpdt dev --plugin-path /path/to/plugin
+# 指定插件路径（作为参数）
+mpdt dev /path/to/plugin
 
 # 首次运行会提示配置
 # 之后会自动：
@@ -306,62 +306,7 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 发布到插件市场
-
-MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
-
-准备 GitHub token，至少需要仓库创建和 Release 写入权限：
-
-```bash
-set GITHUB_TOKEN=ghp_xxx
-set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
-set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
-```
-
-也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
-
-```bash
-mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
-```
-
-如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
-
-在插件目录执行一键发布：
-
-```bash
-mpdt market publish --owner your-github-user-or-org
-```
-
-该命令会依次执行：
-
-1. 读取 `manifest.json`。
-2. 构建 `.mfp` 包并计算 sha256。
-3. 如果 GitHub 仓库不存在则自动创建。
-4. 初始化或复用本地 git 仓库。
-5. 提交当前插件代码。
-6. 创建版本 tag，例如 `v1.0.0`。
-7. 推送分支和 tag 到 GitHub。
-8. 创建或复用 GitHub Release。
-9. 上传 `.mfp` Release 资产。
-10. 注册或更新中心服务器插件元数据。
-11. 提交新版本；如果版本已存在则同步版本元数据。
-
-常用参数：
-
-```bash
-mpdt market publish \
-  --owner MoFox-Studio \
-  --repo my_plugin \
-  --release-notes "First public release"
-```
-
-如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
-
-```bash
-mpdt market publish --owner MoFox-Studio --skip-push
-```
-
-### 7. 配置管理
+### 6. 配置管理
 
 ```bash
 # 交互式配置向导
@@ -391,7 +336,6 @@ mpdt config set-mofox /path/to/neo-mofox
 mpdt [OPTIONS] COMMAND [ARGS]...
 
 选项:
-  -v, --verbose    详细输出模式
   --no-color       禁用彩色输出
   --version        显示版本信息
   --help           显示帮助信息
@@ -423,7 +367,7 @@ mpdt init [PLUGIN_NAME] [OPTIONS]
 生成插件组件代码，始终生成异步方法，支持交互式和命令行两种模式。
 
 ```bash
-mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
+mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [PATH] [OPTIONS]
 
 组件类型:
   action          Action 组件 - 执行具体操作
@@ -437,16 +381,19 @@ mpdt generate [COMPONENT_TYPE] [COMPONENT_NAME] [OPTIONS]
   service         Service 组件 - 服务类
   config          Config 组件 - 配置类
 
+位置参数:
+  PATH                      插件根目录路径（默认为当前目录）
+
 选项:
   -d, --description TEXT    组件描述信息
-  -o, --output PATH        输出目录（默认自动选择对应组件目录）
   -f, --force              覆盖已存在的文件
+  --root                   在插件根目录生成组件文件，而不是 components/ 文件夹
 
 示例:
   mpdt generate                                  # 交互式生成
   mpdt generate action SendMsg -d "发送消息"    # 命令行生成
   mpdt generate tool Formatter --force           # 强制覆盖
-  mpdt generate service DataService              # 生成服务类
+  mpdt generate service DataService ./my_plugin  # 在指定插件中生成服务类
 ```
 
 **注意**：不提供参数时将进入交互式问答模式，更易于使用。
@@ -517,11 +464,13 @@ mpdt build [PLUGIN_PATH] [OPTIONS]
 启动带热重载的开发模式，实时监控文件变化并自动重载插件。
 
 ```bash
-mpdt dev [OPTIONS]
+mpdt dev [PATH] [OPTIONS]
+
+位置参数:
+  PATH                     插件路径（默认当前目录）
 
 选项:
   --neo-mofox-path PATH    Neo-MoFox 主程序路径
-  --plugin-path PATH       插件路径（默认当前目录）
 
 功能特性:
   - 🔄 自动检测文件变化并热重载
@@ -544,6 +493,7 @@ mpdt dev [OPTIONS]
 
 示例:
   mpdt dev                                      # 在插件目录中运行
+  mpdt dev /path/to/plugin                      # 指定插件路径
   mpdt dev --neo-mofox-path /path/to/neo-mofox  # 指定主程序路径
 ```
 

{mofox_plugin_dev_toolkit-0.5.2 → mofox_plugin_dev_toolkit-0.6.0}/mofox_plugin_dev_toolkit.egg-info/SOURCES.txt

@@ -11,9 +11,29 @@ mofox_plugin_dev_toolkit.egg-info/top_level.txt
 mpdt/__init__.py
 mpdt/__main__.py
 mpdt/cli.py
+mpdt/checkers/__init__.py
+mpdt/checkers/base.py
+mpdt/checkers/fixers/__init__.py
+mpdt/checkers/fixers/attribute_fixer.py
+mpdt/checkers/fixers/decorator_fixer.py
+mpdt/checkers/fixers/import_fixer.py
+mpdt/checkers/fixers/manifest_fixer.py
+mpdt/checkers/fixers/method_fixer.py
+mpdt/checkers/fixers/style_fixer.py
+mpdt/checkers/fixers/transformers.py
+mpdt/checkers/validators/__init__.py
+mpdt/checkers/validators/component_validator.py
+mpdt/checkers/validators/config_validator.py
+mpdt/checkers/validators/import_validator.py
+mpdt/checkers/validators/metadata_validator.py
+mpdt/checkers/validators/structure_validator.py
+mpdt/checkers/validators/style_validator.py
+mpdt/checkers/validators/type_validator.py
 mpdt/commands/__init__.py
 mpdt/commands/build.py
+mpdt/commands/bump.py
 mpdt/commands/check.py
+mpdt/commands/depend.py
 mpdt/commands/dev.py
 mpdt/commands/generate.py
 mpdt/commands/init.py
@@ -24,12 +44,6 @@ mpdt/dev/bridge_plugin/dev_config.py
 mpdt/dev/bridge_plugin/file_watcher.py
 mpdt/dev/bridge_plugin/manifest.json
 mpdt/dev/bridge_plugin/plugin.py
-mpdt/market/__init__.py
-mpdt/market/client.py
-mpdt/market/config.py
-mpdt/market/git.py
-mpdt/market/github.py
-mpdt/market/manifest.py
 mpdt/templates/__init__.py
 mpdt/templates/action_template.py
 mpdt/templates/adapter_template.py
@@ -45,19 +59,15 @@ mpdt/templates/tool_template.py
 mpdt/utils/__init__.py
 mpdt/utils/code_parser.py
 mpdt/utils/color_printer.py
-mpdt/utils/config_loader.py
-mpdt/utils/config_manager.py
 mpdt/utils/file_ops.py
 mpdt/utils/license_generator.py
-mpdt/utils/manifest_metadata.py
 mpdt/utils/plugin_parser.py
 mpdt/utils/template_engine.py
-mpdt/validators/__init__.py
-mpdt/validators/auto_fix_validator.py
-mpdt/validators/base.py
-mpdt/validators/component_validator.py
-mpdt/validators/config_validator.py
-mpdt/validators/metadata_validator.py
-mpdt/validators/structure_validator.py
-mpdt/validators/style_validator.py
-mpdt/validators/type_validator.py
+mpdt/utils/managers/__init__.py
+mpdt/utils/managers/config_manager.py
+mpdt/utils/managers/git_manager.py
+mpdt/utils/managers/github_manager.py
+mpdt/utils/managers/manifest_manager.py
+mpdt/utils/managers/market_manager.py
+mpdt/utils/managers/package_manager.py
+mpdt/utils/managers/pypi_manager.py

{mofox_plugin_dev_toolkit-0.5.2 → mofox_plugin_dev_toolkit-0.6.0}/mofox_plugin_dev_toolkit.egg-info/requires.txt

@@ -10,11 +10,11 @@ watchdog>=3.0.0
 websockets>=12.0
 libcst>=1.8.6
 aiohttp>=3.9.0
-pillow>=11.2.0
 uvicorn>=0.24.0
 fastapi>=0.104.0
 ruff>=0.1.6
 mypy>=1.7.0
+packaging>=23.0
 
 [check]
 mypy>=1.7.0

{mofox_plugin_dev_toolkit-0.5.2 → mofox_plugin_dev_toolkit-0.6.0}/mpdt/__init__.py

@@ -4,7 +4,7 @@ MoFox Plugin Dev Toolkit
 一个用于 MoFox-Bot 插件开发的工具集
 """
 
-__version__ = "0.4.11"
+__version__ = "0.6.0"
 __author__ = "MoFox-Studio"
 __license__ = "GPL-3.0-or-later"
 

mofox_plugin_dev_toolkit-0.6.0/mpdt/checkers/__init__.py

@@ -0,0 +1,15 @@
+"""检查器模块
+
+包含验证器（validators）和修复器（fixers）两个子模块
+"""
+
+from .base import BaseFixer, BaseValidator, FixResult, ValidationIssue, ValidationLevel, ValidationResult
+
+__all__ = [
+    "BaseValidator",
+    "ValidationResult",
+    "ValidationIssue",
+    "ValidationLevel",
+    "BaseFixer",
+    "FixResult",
+]

{mofox_plugin_dev_toolkit-0.5.2/mpdt/validators → mofox_plugin_dev_toolkit-0.6.0/mpdt/checkers}/base.py

@@ -36,6 +36,9 @@ class ValidationResult:
     validator_name: str
     issues: list[ValidationIssue] = field(default_factory=list)
     success: bool = True
+    fixes_applied: list[str] = field(default_factory=list)
+    fixes_failed: list[str] = field(default_factory=list)
+    fixed_issues: list[ValidationIssue] = field(default_factory=list)
 
     def add_error(self, message: str, file_path: str | None = None, line_number: int | None = None, suggestion: str | None = None) -> None:
         """添加错误"""
@@ -97,6 +100,47 @@ class ValidationResult:
             self.success = True
 
 
+@dataclass
+class FixResult:
+    """修复结果"""
+
+    fixer_name: str
+    fixes_applied: list[str] = field(default_factory=list)
+    fixes_failed: list[str] = field(default_factory=list)
+    fixed_issues: list[ValidationIssue] = field(default_factory=list)
+    success: bool = True
+
+    def add_fix(self, message: str, issue: ValidationIssue | None = None) -> None:
+        """添加成功的修复
+
+        Args:
+            message: 修复描述
+            issue: 被修复的问题（可选）
+        """
+        self.fixes_applied.append(message)
+        if issue:
+            self.fixed_issues.append(issue)
+
+    def add_failure(self, message: str) -> None:
+        """添加失败的修复
+
+        Args:
+            message: 失败原因描述
+        """
+        self.fixes_failed.append(message)
+        self.success = False
+
+    @property
+    def fix_count(self) -> int:
+        """成功修复数量"""
+        return len(self.fixes_applied)
+
+    @property
+    def failure_count(self) -> int:
+        """失败修复数量"""
+        return len(self.fixes_failed)
+
+
 class BaseValidator(ABC):
     """验证器基类"""
 
@@ -118,6 +162,49 @@ class BaseValidator(ABC):
         """
         pass
 
+    def _get_plugin_name(self) -> str | None:
+        """获取插件名称（从目录名）
+
+        插件结构: my_plugin/plugin.py
+        """
+        return extract_plugin_name(self.plugin_path)
+
+
+class BaseFixer(ABC):
+    """修复器基类"""
+
+    def __init__(self, plugin_path: Path):
+        """初始化修复器
+
+        Args:
+            plugin_path: 插件路径
+        """
+        self.plugin_path = plugin_path
+        self.result = FixResult(fixer_name=self.__class__.__name__)
+
+    @abstractmethod
+    def fix(self, issues: list[ValidationIssue]) -> FixResult:
+        """执行修复
+
+        Args:
+            issues: 需要修复的问题列表
+
+        Returns:
+            FixResult: 修复结果
+        """
+        pass
+
+    def can_fix(self, issue: ValidationIssue) -> bool:
+        """判断是否可以修复某个问题
+
+        Args:
+            issue: 验证问题
+
+        Returns:
+            bool: 是否可以修复
+        """
+        return False
+
     def _get_plugin_name(self) -> str | None:
         """获取插件名称（从目录名）