问题排查与命令

状态: Active Last verified: 2026-08-30 @ user-help content audit 适用范围: Studio、AutoCAD 插件、已保存项目和会话的安全排查。

排查的第一原则是保留证据：当前 DWG、会话、错误提示、发生步骤和脱敏日志比“删除后重装”更有价值。不要为了重新开始而删除项目目录、术语表或未知译文图层。

适用场景

现象	先检查	安全的下一步
`TW_STATUS` 无结果或面板不出现	插件 DLL 是否与当前 AutoCAD 代际匹配、是否已加载	停止强行加载其他版本 DLL；记录路径和错误。
Studio 无法提取/写回	DWG 是否已保存；AutoCAD 2026 Core Console 是否可用	保留错误提示；先修复宿主前提，不要删除会话。
框选提取没有预期内容	选择范围、是否取消、对象是否为支持文字	在副本上用小范围普通文字复测。
提取数量不合理	图框属性选项、范围、当前 DWG、已有会话	查看摘要，停止写回；不要把整图重提当成清理命令。
翻译失败	服务设置、网络、代理、凭据和服务状态	用 Studio 网络诊断或独立诊断工具；失败结果不能写回。
术语表未命中	CSV 是否关联并保存、语言/领域/优先级/列名	修正 CSV 后只重译相关范围。
找不到项目/会话	DWG 是否移动、项目目录是否完整、是否误删/改名	保留现有目录和错误，重新确认关联；不要创建同名空项目遮盖旧数据。
写回失败或版面异常	当前 DWG、范围、目标文本、输出位置、对象错误	停止后续写回，保留源图/输出图/会话，针对失败项检查。

PowerShell 7+ 仅是仓库脚本和 Windows 策略采集的要求；普通翻译不依赖 Windows PowerShell 5.1。不要把切换 PowerShell 版本当成翻译服务的通用修复方案。

命令	用途	安全边界
`TW_STATUS`	显示插件加载状态与可用命令	不会修复加载或版本问题。
`TW_SHOW_PANEL`	显示/隐藏侧边面板	不会创建项目或会话。
`TW_EXTRACT_ALL`	提取整图支持文字	合并已有会话，不是清空命令。
`TW_EXTRACT_WINDOW`	框选局部支持文字	取消不创建空批次。
`TW_WORKSPACE`	打开现有会话工作区	没有会话时不产生可写回数据。
`TW_WORKSPACE_EDITOR`	打开并行的连续编辑入口	与旧工作区的界面能力不同，仍使用同一图纸/项目安全边界。
`TW_CHECK_META`	诊断选中译文和关联对象	不修改 DWG。
`TW_NETWORK_DIAG`	生成当前插件进程的脱敏网络诊断	不读取、锁定或修改 DWG。
`TW_SOURCE_TEXT_HIDE` / `TW_SOURCE_TEXT_SHOW`	精确隐藏/恢复关联源文字	不会关闭源图层或影响无关联对象。
`TW_CLEAR_TRANSLATIONS`	确认后清理独立译文	不按图层/文字猜测删除，也不撤销原位替换。
`TW_TRANSLATION_EDITOR`	对照并编辑 DWG 中有关联元数据的译文	保存时仍受对象与事务安全检查。
`TW_WRAP_TRANSLATIONS`	对选择的独立译文进行保守适配排版	不移动文字、不修改原文，也不调用翻译服务。

排查完成后，你应知道问题属于以下哪一类：加载/宿主、图纸保存与关联、提取范围、翻译服务与知识、会话数据，或 CAD 写回。每一类都应留下可复现的下一步，而不是通过删除数据让问题消失。