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

2026-09-11 13:49:34 +08:00
parent 5ee00bd2c4
commit e958784d10
5 changed files with 92 additions and 1 deletions
@@ -74,6 +74,8 @@ export const { jsx, jsxs, Fragment } = window.__ASO_PLUGIN_HOST__.jsxRuntime
 | 单文件 ≤ 8MB | 超限拒绝装载 |
 | 仅开发版装载 | 用户版第三方装载关闭（`ASO_EXTERNAL_PLUGINS=1` 豁免） |

+装载失败/白屏/hooks 报错？直接查 [常见错误速查](./09-troubleshooting.md) §3。
+
 ## 5. 样式

 组件直接跑在宿主树里——**宿主的 Tailwind 类与 token 全部可用**。标准模式已代码化：优先 `import { Button, SettingRow, LoadingState, ErrorState, EmptyState, Switch } from '@aso/plugin-sdk/ui'`（组件目录与三态铁律见 [L6](./07-ui-components.md)），不要手写；遵守 [DESIGN.md](./DESIGN.md) 的类名词汇，禁止硬编码色值/阴影。