用途：指导在 Chart.js（v4.5.1）中创建和使用自定义插件。插件是定制或改变 Chart.js 默认行为最高效的方式，通过钩子接入图表生命周期执行自定义代码。
插件类型：内联插件在 chart config 中直接定义，仅作用于单个图表实例，无法全局注册、不可复用；共享插件定义一次后可被多个图表使用；全局插件通过 Chart.register(myPlugin) 注册一次后自动应用于所有图表。
结构与命名：插件需有唯一 id，可选 defaults 默认选项，并可实现多个生命周期钩子。id 遵循 npm 包命名约定：仅小写字母、数字、连字符，不以点或下划线开头，公开包以 chartjs-plugin- 为前缀。
生命周期钩子：初始化有 beforeInit、afterInit；更新有 beforeUpdate、afterUpdate、beforeLayout、afterLayout、beforeDatasetsUpdate、afterDatasetsUpdate；渲染有 beforeRender、beforeDraw、afterDraw、afterRender；事件有 beforeEvent、afterEvent；销毁有 afterDestroy。其中部分钩子可取消（Cancelable）。
配置与禁用：通过 options.plugins.{plugin-id} 配置插件选项，可覆盖 defaults；将某插件设为 false 可在单个图表禁用该全局插件，options.plugins 设为 false 可禁用全部插件。
常见模式：画布背景色、图表区域边框、自定义文字覆盖、空状态处理（无数据时显示提示）。可通过 chart 对象访问 ctx、canvas、width、height、chartArea、scales、data、options、config；用 scale 的 getPixelForValue / getValueForPixel 在数据值与像素间换算。TypeScript 下可声明 PluginOptionsByType 获得类型提示。
最佳实践：beforeDraw/afterDraw 每次渲染都会调用，应节约使用，把重计算缓存到 afterUpdate 钩子，并用 ctx.save()/ctx.restore() 避免副作用；用 try/catch 包裹插件逻辑做错误处理；用 options.enabled 做条件渲染。更多参考见 references/plugin-api.md 与 examples 目录示例。