AutoCAD 插件

状态: Active Last verified: 2026-08-30 @ user-help content audit 适用范围: AutoCAD 2019–2026 对应的 Tongwen 插件构建；真实宿主可用性以稳定发行说明为准。

插件适合在当前打开的 DWG 中完成关联、提取、核对和受控写回。它不接管 AutoCAD 的保存、Undo、图层管理或项目归档；每次写回前仍必须确认当前图纸和备份。

适用场景

• 要在 AutoCAD 图面上下文中框选待翻译文字；
• 需要从译文定位回 CAD 对象并核对版面；
• 希望在当前 DWG 内使用项目会话和受控写回。

开始前确认

• 当前 DWG 已保存，不是模板、备份或临时文件；路径可写且源图可恢复。
• 已加载与当前 AutoCAD 版本匹配的插件 DLL。不要跨 SDK 代际加载其他目录的 DLL。
• 输入 TW_STATUS 后能看到 Tongwen 的状态和命令；没有这一步的确认，不要把面板未出现误判为会话或翻译问题。
• 如需在线翻译，Studio/本机全局翻译配置已经可用；失败时不会产生可安全写回的替代文本。

操作步骤

加载并确认面板

1. 按稳定发行说明通过 Studio 启动器、已配置的自启动或匹配版本的 NETLOAD 加载插件。
2. 在 AutoCAD 命令行输入 TW_STATUS。
3. 侧边面板未显示时输入 TW_SHOW_PANEL。
4. 只在状态可用且 DWG 已保存后继续关联项目。

关联正确项目

1. 在侧边面板查看当前图纸的项目状态。
2. 无自动匹配时选择“关联已有”，从项目列表选择正确项目；或者选择“新建”，设置项目名称、语言与术语表引用。
3. 出现多个候选时，不要凭文件名猜测：核对项目、图纸路径和语言方向后显式选择。
4. 关联完成后确认面板不再显示未关联状态，再提取文字。

明确的关联优先于自动匹配。图纸改名或移动后，如果项目目录仍存在，先复核关联而不是假定路径变化已经被自动纠正。

提取与打开工作区

1. 首次处理整张图，使用面板中的整图提取或命令 TW_EXTRACT_ALL。
2. 仅处理局部或补充修改时，使用面板中的框选提取或 TW_EXTRACT_WINDOW；按 AutoCAD 提示框选范围。
3. 提取过程中等待进度和摘要；取消框选不会创建空批次，也不应覆盖已有会话。
4. 提取完成后，从面板打开工作区，或输入 TW_WORKSPACE。若安装包提供连续编辑入口，也可用 TW_WORKSPACE_EDITOR；两者共用图纸、项目和底层安全边界，但界面能力并不完全相同。

在图纸上下文中检查与写回

1. 在工作区选择明确范围并检查原文、译文和 QA 信息；搜索和状态筛选不能扩大翻译或写回范围。
2. 使用定位功能回到 CAD 核对对象、图层和版面；编辑译文后保存当前会话。
3. 首次优先选择“创建新图层（保留原文）”；原位替换只适用于已备份、明确要求单语成图的场景。
4. 阅读写回确认提示，确认当前 DWG、范围和模式无误后执行。插件对当前 DWG 执行受控事务，不会自动另存为 Studio 风格的 _translated.dwg 副本。
5. 写回后保存 DWG，并重新检查关键文字。批次允许部分成功：不要因有成功提示就跳过失败项的检查。

预期结果

• 图纸与项目的关联可在侧边面板中确认；
• 提取范围形成可追踪会话和批次；
• 译文可定位回图面，写回前能够明确选择范围；
• 写回后的独立译文可与原文对照，原位写回则已有明确备份。

常用命令

常见问题与安全恢复

• 插件无法加载或 TW_STATUS 没有结果：停止操作，不要把其他 AutoCAD 代际的 DLL 强行加载到当前宿主；记录 AutoCAD 版本、插件路径和错误。
• 面板显示未关联或找不到项目：先确认 DWG 已保存、项目目录仍在；通过“关联已有”显式选择正确项目，不要创建同名项目掩盖旧会话。
• 定位、写回或图面结果异常：立即停止后续写回，保留 DWG、会话、错误和受影响对象信息。TW_CHECK_META 可帮助收集已关联对象状态；详细恢复原则见 校对与安全写回。