diff --git a/docs/plugin/dev/extension.md b/docs/plugin/dev/extension.md
index a6040cb43..a5ef49945 100644
--- a/docs/plugin/dev/extension.md
+++ b/docs/plugin/dev/extension.md
@@ -1,5 +1,9 @@
 # 组件扩展
 
+::: warning
+2025年3月～4月：我们正在进行 4.0 版本重构，组件定义变化较大，现阶段不建议使用组件扩展。请优先考虑使用基于事件的插件接口。
+:::
+
 > 请先阅读[插件介绍页](/plugin/plugin-intro)  
 
 :::info 目录