# 排查手册

这里不是教程，是排错的地方

要学功能、看操作演示 → 去 基础教程 (opens new window)（详解第三期 12 集 / 164 条功能点，搜功能名就能跳到视频对应时间）
本手册负责：装不上、用不了、报错、卡死、生成结果不对、数据丢失

# 第一步：先按这个顺序自查

绝大多数「插件没反应」都在前三步解决。按顺序做，别跳步：

优先测试：是否是族升级造成卡死 —— 打开需默认载入族的工具时如果 Revit 直接未响应，先看输入法兼容那条
优先测试：在 Revit 默认建筑样板中测同一个命令
核心排查：用排除法禁用其他第三方插件，检查插件冲突
检查更新：确认插件为最新版，并把问题反馈给开发者（怎么反馈才有用）
最终手段：修复安装 → 重装 Revit

铁律

每次只改一项，改完立刻测一次。 一次动三样，最后不知道是哪样修好的。

# 按症状找

你遇到的情况	去这里
装不上、装完在 Revit 里找不到插件	安装 · 未加载
提示未授权 / 授权失效 / 换电脑	激活与授权
插件在，但点命令没反应、按钮是灰的、Revit 卡死	命令无效排查
族库打开慢、下载卡死、贴图丢失、族改不动	族库
龙骨生成位置不对、少构件、生成失败	龙骨
饰面层的楼板 / 屋顶 / 过门石生成不出来	饰面层
标注错乱、尺寸被清掉、材质标注刷新不了	标注与出图
材质替换没反应、贴图显示不出来	材质与渲染
模型一大就卡、生成要等很久	卡顿与性能
小鲶鱼云连不上、同步失败	小鲶鱼云
想查内置参数清单、取值、命名规范	参数与清单速查

# 出问题怎么反馈才有效

按下面清单提供信息，基本一轮就能定位；只说一句「插件坏了」通常要来回好几轮。

Revit 版本（2018 / 2020 / 2021…2027 哪一版，具体到年份）
插件版本（在族库 → 关于或桌面独立窗口里看）
操作步骤（点到哪个命令、点了哪一步出的问题）
报错截图或 Revit 的提示原文
是否只在某个项目/样板里出现，还是所有项目都这样
诊断日志：插件支持打开诊断日志，开启后复现一次操作，把日志目录发来即可 —— 见激活与授权 → 诊断日志

# 相关链接

安装 · 未加载 →