FAQ 与排错
遇到问题先别急着描述，按下面的顺序自查一遍，多半五分钟就能定位。顺序很重要：先确认环境，再排除干扰，最后才怀疑插件本身。
本页内容
一、先按这个顺序自查五步
铁律：每次只改一项，改完立刻测一次。一次改三处，出了问题就说不清是哪一处。
- 确认环境：Revit 版本在支持范围内（2020–2027），且插件已加载——功能区出现「小泰迪」选项卡，含基模 / 深化 / 出图 / 族库 / AI 助手五个面板。没有选项卡，见症状 A。
- 用默认建筑样板复测一次：新建空项目再试一遍，排除项目模板、项目内族、视图设置带来的干扰。
- 排除法：临时禁用其他第三方插件（尤其是功能重叠或同类族库插件），再试一次，确认是不是插件冲突。
- 确认版本：确认插件是最新版本，且
TeddyForge.*.dll是同一批次。不同 Revit 年份目录各自独立，切勿混装不同批次的 DLL，混装典型症状是启动崩溃并报TypeLoadException。 - 仍不行：按第三部分「反馈清单」带齐信息找我们。
补丁与更新都走手动流程：关闭 Revit 后运行安装包或覆盖 DLL，不要在有旧批次文件残留的目录上直接叠放。
二、按症状找
对号入座，先做「先做什么」那一栏，再往下走。
| 症状 | 先做什么 | 编号 |
|---|---|---|
| 装完功能区没有「小泰迪」选项卡 | 查 .addin 与 DLL 是否落在同一年份目录、DLL 是否同批次；关闭 Revit 后重新部署再启动 | A |
| 提示未授权 / 某个面板不可用 | 先登录会员，再用授权码在线激活；确认该模块在你的授权范围内 | B |
| 换电脑或重装后提示需要重新激活 | 授权是一机一码，先联系支持释放旧机名额（当前走人工），再在新机激活 | C |
| 试用到期 | 新用户免费试用 30 天、覆盖全部模块；到期后按需购买（年度套装 299 元/年、族库 99 元永久、AI 99 元永久） | D |
| 命令点了没反应 / 弹出错误窗 | 先确认当前文档可编辑、不在只读视图；再把弹窗错误原文加上诊断日志一起反馈 | E |
| 族库打开慢、看不到缩略图、族加载不出来 | 首次打开会建缓存，稍等再试；仍不对见 F（缓存与日志） | F |
| 出图 / 标注结果不对 | 先确认样板与视图设置是否到位；带截图与项目复现说明反馈 | G |
| Revit 启动慢或启动崩溃 | 查 DLL 是否同批次、是否多版本目录混放；对照禁用其他插件是否恢复 | A |
| AI 助手一直是「没有结果」 | 看 AI 桥状态与日志，并确认 Revit 处于空闲状态（执行命令时不会触发轮询） | H |
| 会员 / 积分 / 云端族仓相关 | 二期三期功能，尚未上线，统一按「即将上线」处理 | I |
三、出问题怎么反馈才有效
带齐下面六项，通常一轮就能定位；缺项往往要多来回两三次。
- Revit 版本号 与 插件版本号
- 操作步骤：点了什么、按什么顺序
- 报错截图，或错误原文
- 是否只在某个项目 / 某台机器复现
- 诊断日志（路径见下）
- 你的联系方式
日志在哪（路径可直接复制给我们）
- 插件启动日志：
%APPDATA%\Autodesk\Revit\Addins\<Revit年份>\TeddyForgeBIM\TeddyForgeBIM.log - 运行时 / 诊断日志目录：
%LocalAppData%\TeddyForgeBIM\logs\ - AI 助手桥：状态
%LocalAppData%\TeddyForgeBIM\AiBridge\status.json，日志%LocalAppData%\TeddyForgeBIM\AiBridge\logs\bridge.log
四、逐条问答
点开每条看细节；与价格、授权相关的口径以这里为准。
Q1 小泰迪支持哪些 Revit 版本？
支持 Revit 2020–2027，八个年份各自独立安装、互不影响；一次获取覆盖你在用的版本。
Q2 怎么安装？
下载对应年份的安装包 → 按提示安装 → 打开 Revit 即可用。部署位置为 %APPDATA%\Autodesk\Revit\Addins\<Revit年份>\TeddyForgeBIM\，同目录下 TeddyForge.addin 是入口。
安装包里所有 TeddyForge.*.dll 必须同批次，不要手工混装不同版本。
Q3 怎么激活？
在 Revit 里打开授权管理 → 登录会员（邮箱 + 密码）→ 输入授权码（TF-XXXX-XXXX）→ 在线激活并绑定本机。
未登录会员不能用授权码激活；TF- 开头是服务器授权码，旧的本地注册码不再支持在线激活。
Q4 试用怎么算？
新用户注册后可免费试用 30 天，试用覆盖全部模块（基模 / 深化 / 出图 / 族库 / AI 助手）。试用到期后需要购买对应授权才能继续使用。
Q5 怎么收费？
基模 / 深化 / 出图三个模块合在一份「年度套装」里：299 元/年，到期即锁，续费后用新授权码重新激活；族库 99 元永久买断、AI 助手 99 元永久买断，均为一机一码。
价格只有这三项，不按会员等级分档打包。
Q6 换电脑了怎么办？
授权与机器码绑定（一机一码）。换机流程：先联系支持释放旧机名额，再在新机登录会员并重新激活。目前不提供自助解绑入口，走人工处理。
Q7 怎么更新到新版本？
手动更新：关闭 Revit → 运行新安装包（或用新版 DLL 覆盖对应年份目录）→ 重新打开 Revit。
前后注意 DLL 同批次，不要在新旧版本目录之间混装。
Q8 提示「未授权」或「已到期」怎么排查？
三步走：① 是否已登录会员；② 授权码是否已在本机激活（换机 / 重装后需重新激活）；③ 该模块是否在授权范围内、授权到期日是哪天。
三步都对仍提示异常，按第三部分带日志反馈。
Q9 出图 / 标注结果和我预期不一样，是 bug 吗？
先排除样板与视图设置（第 2 步自查），再用默认建筑样板复测一次。确认是插件的问题，请带上「期望结果 vs 实际结果」的截图和项目复现范围。
Q10 AI 助手点了没反应？
先看 AI 桥状态（status.json 里的 running 是否为 true），再看 logs\bridge.log。另外 AI 命令执行期间 Revit 不会触发轮询，等它跑完再试。
Q11 官网上的会员中心、积分、云端族仓现在能用吗？
尚未上线，统一标注「即将上线」，不写具体时间；上线后再补细则。
Q12 怎么联系你们？
微信优先，要发文件就加 QQ：即时问题、截图、短描述走个人微信；诊断日志或长附件加 QQ 411190866 直接传文件，日志打成一个包并写明 Revit 版本与复现步骤。
微信为个人号、单人值守，工作日内 24 小时回应，非工作时间可能延后。加好友请先发「Revit 版本 + 问题一句话」。
自查卡住了？把日志发过来
微信优先：先发一句「Revit 版本 + 问题一句话」，再说细节。
要发诊断日志或长附件，加 QQ 411190866，文件打成一个包。
工作日内 24 小时回应，非工作时间可能延后。