docs: 新增常见错误速查页（症状→原因→修复）+ 明确重载宿主级粒度；L4/L7/索引交叉引用

2026-09-11 13:49:34 +08:00
parent 5ee00bd2c4
commit e958784d10
5 changed files with 92 additions and 1 deletions
@@ -204,3 +204,8 @@ packages/plugin-template  →  npm i（workspace 引 @aso/plugin-sdk）
  页面：vite build --watch → dist/      # 改即重编
 宿主：开发者模式开 fs.watch → 自动 plugins:reload → iframe 换 src
 ```
+
+**重载粒度**：`plugins:reload` 是宿主级动作——重扫全部插件目录 + 重导入 main.mjs +
+清内联 UI + 重建运行时（所有插件短暂重激活）。没有单插件重载粒度（工具聚合在同一个
+pi 运行时里，无法热替换单个）；改了哪个插件都执行同一个重载。排障走
+[docs/plugins/09-troubleshooting.md](./plugins/09-troubleshooting.md)。