第12章：常见问题与故障排除

产品官网：https://shandianweihu.com/

本章是同文（Tongwen）的故障排除与常见问题解答手册。当您在使用过程中遇到问题时，可按照本章提供的分类索引快速定位到对应问题，并根据分步骤的解决方案逐一排查。如果问题仍然无法解决，本章末尾提供了问题报告模板和技术支持的联系方式，帮助您向技术团队提交有效的问题描述。

12.1 问题分类索引

建议您首先在索引中找到与您遇到的问题最匹配的分类，然后跳转到对应章节阅读详细内容。如果无法确定问题属于哪一类，可从 12.2 节开始逐节浏览。

12.2 安装与启动问题

12.2.1 AutoCAD 版本未检测到

现象描述：

• 运行 Studio 后，在项目管理页面创建翻译任务时，提示”未检测到可用的 AutoCAD 版本”或”请先安装 AutoCAD”。
• 在 Studio 的”设置 → CAD 环境”页面中，AutoCAD 版本列表为空。

可能原因：

1. 本机未安装同文支持的 AutoCAD 版本（2019、2021、2025、2026）。
2. 安装了不受支持的 AutoCAD 版本（如 AutoCAD LT、AutoCAD 2018 或更早版本）。
3. AutoCAD 安装路径未被系统正确注册，导致 Studio 无法自动探测到。
4. 以非管理员身份运行 Studio，导致无法读取注册表中的 CAD 安装信息。

解决方案：

1. 确认是否安装了受支持的 AutoCAD 版本：
   • 打开 AutoCAD，执行 ABOUT 命令，查看产品名称和版本号。
   • 确认版本号属于以下之一：AutoCAD 2019、AutoCAD 2021、AutoCAD 2025、AutoCAD 2026。
   • 如果版本符合，继续下一步排查。
   • 如果版本不符合，请从 Autodesk 官方网站下载并安装受支持的 AutoCAD 版本。
2. 排除 AutoCAD LT：
   • 如果您安装的是 AutoCAD LT，请注意：AutoCAD LT 不提供完整的 .NET API 接口，同文完全不支持在任何版本的 AutoCAD LT 上运行。您需要安装 AutoCAD 的完整版本（非 LT 版本）。
3. 手动指定 AutoCAD 安装路径：
   • 打开 Studio，进入”设置 → CAD 环境”页面。
   • 点击”手动添加 AutoCAD 路径”按钮。
   • 在弹出的文件选择对话框中，浏览到 AutoCAD 安装目录，选择 acad.exe（图形界面版本）或 accoreconsole.exe（Core Console 可执行文件）。
   • AutoCAD 的默认安装路径通常为：
     • C:\Program Files\Autodesk\AutoCAD 2025\acad.exe
     • C:\Program Files\Autodesk\AutoCAD 2021\acad.exe
   • 添加完成后，点击”检测”按钮验证路径是否正确，然后保存设置。
4. 以管理员身份运行 Studio：
   • 关闭 Studio。
   • 右键点击 Studio 的桌面快捷方式或可执行文件。
   • 选择”以管理员身份运行”。
   • 再次进入”设置 → CAD 环境”页面，查看是否能自动检测到 AutoCAD。
5. 检查注册表信息（适用于高级用户）：
   • 按 Win + R，输入 regedit，打开注册表编辑器。
   • 导航到 HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD。
   • 查看是否有对应版本的子键（如 R24.2 对应 AutoCAD 2025）。
   • 如果子键缺失，说明 AutoCAD 安装不完整，建议重新安装。
6. 重新安装 AutoCAD：
   • 如果以上步骤均无法解决问题，建议卸载当前 AutoCAD 后重新安装。安装时请使用默认路径，并确保选择”完整安装”（而非”最小安装”）。

12.2.2 插件加载失败

现象描述：

• 启动 AutoCAD 后，命令行显示”未能加载 Tongwen 插件”或”加载失败”。
• 在 AutoCAD 中执行 NETLOAD 命令手动加载插件 DLL 时，提示错误。
• Studio 在调用 Core Console 执行提取任务时，报错”插件加载失败，Core Console 已退出”。

可能原因：

1. 插件 DLL 文件缺失或不完整（安装包损坏、安装过程中被中断）。
2. 插件版本与 AutoCAD 版本不匹配（例如：将 .NET 8.0 版本的插件尝试加载到 AutoCAD 2019 中）。
3. 所需的 .NET 运行时未安装。
4. 杀毒软件或 Windows Defender 拦截了插件 DLL 的加载。
5. 插件依赖的其他程序集缺失。

解决方案：

1. 验证插件文件完整性：
   • 关闭所有 AutoCAD 实例。
   • 以管理员身份运行同文的安装包，选择”修复”安装。
   • 修复完成后重新启动 AutoCAD，查看插件是否正常加载。
2. 确认 .NET 运行时已安装：
   • 对照以下表格，确认您已安装了对应 AutoCAD 版本所需的 .NET 运行时：

   AutoCAD 版本	所需运行时	下载地址
   AutoCAD 2019	.NET Framework 4.7.2+	Windows 通常已内置
   AutoCAD 2021	.NET 6.0 桌面运行时	Microsoft 官方下载页
   AutoCAD 2025/2026	.NET 8.0 桌面运行时	Microsoft 官方下载页

   • 打开 PowerShell，运行 dotnet --list-runtimes，确认对应版本的 Microsoft.WindowsDesktop.App 条目存在。
3. 检查并配置杀毒软件排除项：
   • 将同文的安装目录添加到杀毒软件的白名单/排除列表中。
   • 将同文的插件 DLL 所在目录添加到 Windows Defender 的排除项中：
     • 打开 Windows 安全中心 → “病毒和威胁防护” → “管理设置”。
     • 点击”添加或删除排除项”，将同文安装目录添加进去。
   • 详细操作参见 12.2.5 节”杀毒软件拦截”。
4. 手动加载插件排查：
   • 打开 AutoCAD。
   • 在命令行输入 NETLOAD，回车。
   • 在弹出的文件选择框中，浏览到同文插件安装目录（通常为 C:\Program Files\Tongwen\CAD Plugin\ 或类似路径）。
   • 选择对应的插件 DLL 文件（文件名通常包含 Tongwen 字样和 AutoCAD 版本标识）。
   • 如果加载失败，AutoCAD 命令行会显示具体的错误信息，请截图保存该错误信息，方便后续排查。
5. 查看 AutoCAD 加载日志：
   • AutoCAD 在启动时会记录插件加载情况。按 F2 打开 AutoCAD 文本窗口，查看启动日志中是否有与”Tongwen”相关的错误信息。
   • 常见错误信息及对应处理方法：

   错误信息	含义	处理方法
   “System.IO.FileNotFoundException”	依赖的 DLL 缺失	修复安装同文插件
   “Could not load file or assembly”	.NET 版本不匹配	安装对应的 .NET 运行时
   “The module was expected to contain an assembly manifest”	DLL 文件损坏	修复安装同文插件
   “Access is denied”	权限不足	以管理员身份运行 AutoCAD

12.2.3 Core Console 未检测到

现象描述：

• 在 Studio 中创建提取任务时，提示”Core Console 未检测到”或”请先配置 Core Console 路径”。
• 点击”开始提取”后，进度条立即显示”提取失败”，并提示”找不到 accoreconsole.exe”。

可能原因：

1. AutoCAD 安装组件不完整——安装 AutoCAD 时未勾选”Core Console”组件。
2. Studio 中的 Core Console 路径配置不正确。
3. accoreconsole.exe 文件被误删或损坏。
4. 系统中安装了多个 AutoCAD 版本，但 Core Console 路径指向了不存在或已卸载的版本。

解决方案：

1. 确认 accoreconsole.exe 文件存在：
   • 打开文件资源管理器，浏览到 AutoCAD 安装目录。
   • 默认路径为 C:\Program Files\Autodesk\AutoCAD 20XX\（其中 20XX 为版本年份）。
   • 在该目录下查找 accoreconsole.exe 文件。
   • 如果文件不存在，说明 AutoCAD 安装时未包含 Core Console 组件，需要补充安装。
2. 补充安装 Core Console 组件：
   • 打开控制面板 → “程序和功能”。
   • 找到已安装的 AutoCAD 条目，右键选择”卸载/更改”。
   • 在 Autodesk 安装向导中选择”添加或删除功能”。
   • 在组件列表中，确保勾选了”Core Console”（有时显示为”AutoCAD Core Console”或”命令行控制台”）。
   • 完成组件添加后，再次检查 accoreconsole.exe 是否存在。
3. 在 Studio 中正确配置 Core Console 路径：
   • 打开 Studio，进入”设置 → CAD 环境”页面。
   • 在”Core Console 路径”配置项中，浏览并选择 accoreconsole.exe 文件。
   • 如果您安装了多个 AutoCAD 版本，请为每个版本分别指定对应的 Core Console 路径。
   • 选择后点击”测试连接”，Studio 会尝试启动一次 Core Console 以验证路径的正确性。
4. 手动验证 Core Console 是否正常工作：
   • 打开命令提示符（cmd），输入以下命令（将路径替换为您实际的 AutoCAD 安装路径）：

     "C:\Program Files\Autodesk\AutoCAD 2025\accoreconsole.exe" /s "C:\Temp\test.scr"
     

   • 其中 C:\Temp\test.scr 可以是一个简单的 AutoCAD 脚本文件（内容可为 _quit 即退出命令）。
   • 如果 Core Console 能正常启动并退出，说明 Core Console 本身没有问题。
   • 如果报错”应用程序无法正常启动”或类似错误，可能是 .NET 运行时缺失或 Visual C++ 运行库缺失。
5. 安装 Visual C++ 运行库：
   • AutoCAD 依赖特定版本的 Microsoft Visual C++ Redistributable。
   • 如果 Core Console 启动时报错”缺少 MSVCP140.dll”或”缺少 VCRUNTIME140.dll”，请从 Microsoft 官方网站下载并安装最新的 Visual C++ 运行库。
   • 建议同时安装 x64 和 x86 版本。

12.2.4 .NET 环境不匹配

现象描述：

• 启动 Studio 时弹出错误对话框，提示”需要安装 .NET 8.0 桌面运行时”或类似信息。
• AutoCAD 插件加载时，AutoCAD 命令行显示”.NET 版本不匹配”。
• Core Console 启动后立即退出，报相关 .NET 错误。

可能原因： 同文的不同组件依赖不同的 .NET 运行时，必须确保对应的运行时已安装。以下表格列出了各组件的依赖关系：

.NET 桌面运行时 与 .NET 运行时 是不同的安装包。桌面运行时包含了运行时，并且额外包含了 WPF 和 Windows Forms 等桌面应用所需的组件。同文的 Studio 和 AutoCAD 插件都需要的是桌面运行时（WindowsDesktop），而不是基础运行时。

解决方案：

1. 确认当前已安装的 .NET 版本：
   • 打开 PowerShell，运行：

     dotnet --list-runtimes
     

   • 在输出中查找以下条目：
     • Microsoft.NETCore.App 8.0.x
     • Microsoft.WindowsDesktop.App 8.0.x
     • Microsoft.NETCore.App 6.0.x
     • Microsoft.WindowsDesktop.App 6.0.x
   • 如果某个条目的 Microsoft.WindowsDesktop.App 缺失，说明只安装了基础运行时，还需要安装桌面运行时。
2. 安装缺失的 .NET 桌面运行时：
   • .NET 8.0 桌面运行时（Studio 和 AutoCAD 2025/2026 插件需要）：
     • 访问 https://dotnet.microsoft.com/en-us/download/dotnet/8.0
     • 在页面中找到”Windows”分类下的”桌面运行时”（Desktop Runtime）。
     • 选择 x64 版本下载并安装。
   • .NET 6.0 桌面运行时（AutoCAD 2021 插件需要）：
     • 访问 https://dotnet.microsoft.com/en-us/download/dotnet/6.0
     • 同样下载”桌面运行时”的 x64 版本。
3. 检查 .NET Framework 4.7.2（AutoCAD 2019 插件需要）：
   • Windows 10 版本 1803 及以上、Windows 11 所有版本均已内置 .NET Framework 4.7.2，通常不需要手动安装。
   • 如需验证：打开注册表编辑器，导航到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full，检查 Release 数值。如果大于或等于 461808，则表示已安装 4.7.2 或更高版本。
   • 如需重新安装：从 Microsoft 官方网站下载 .NET Framework 4.8.1（向下兼容 4.7.2）的在线安装包进行安装。
4. 注意区分 x64 和 x86：
   • 同文全部组件均为 64 位，请务必下载 x64 版本的 .NET 运行时。
   • 即使您的系统是 64 位的，如果误安装了 x86 版本的运行时，同文也无法正常工作。
5. 安装后重启系统：
   • .NET 运行时安装完成后，建议重启计算机以确保环境变量和系统路径正确生效。

12.2.5 杀毒软件拦截

现象描述：

• 安装同文时，安装程序被阻止运行，或安装进度到一半时突然退出。
• 安装完成后，Studio 或 AutoCAD 插件无法正常启动，双击后无反应。
• Core Console 在提取过程中被强制终止，没有任何错误提示。
• Studio 中的 Pipe 服务（Sidecar）启动失败。
• Windows Defender 或第三方杀毒软件弹出”已阻止潜在威胁”的通知。

可能原因：

• 同文的 AutoCAD 插件需要通过 Named Pipe（命名管道）与 Studio 进行进程间通信，部分杀毒软件会将此行为标记为可疑。
• 同文的部分可执行文件（如 Core Console 的启动脚本、Pipe 服务程序）没有数字签名或签名来自较新的证书颁发机构，被杀毒软件误判为潜在风险。
• 同文的安装包体积较大，部分安全软件在解压和安装过程中会自动拦截。

解决方案：

1. 临时禁用杀毒软件（仅用于安装和首次运行验证）：
   • 在安装同文之前，临时禁用 Windows Defender 实时保护：
     • 打开”Windows 安全中心” → “病毒和威胁防护” → “管理设置”。
     • 关闭”实时保护”开关。
   • 如果使用第三方杀毒软件（如 360、腾讯电脑管家、火绒等），右键点击任务栏图标，选择”退出”或”暂停防护”（选择暂停 15 分钟即可）。
   • 完成同文的安装和首次启动验证后，重新启用杀毒软件保护。
2. 将同文添加到杀毒软件的白名单/排除项（推荐方案）：
   • Windows Defender 添加排除项：
     • 打开”Windows 安全中心” → “病毒和威胁防护” → “管理设置”。
     • 滚动到”排除项”，点击”添加或删除排除项”。
     • 依次添加以下路径/文件到排除列表：
       • 同文的安装目录（例如 C:\Program Files\Tongwen\）
       • %LocalAppData%\Tongwen\（即 C:\Users\<用户名>\AppData\Local\Tongwen\）
     • 添加方式建议选择”文件夹”，将整个目录排除。
   • 第三方杀毒软件添加白名单：
     • 各杀毒软件的白名单设置位置各不相同，通常在”设置 → 安全 → 信任区/白名单/排除项”中。
     • 将同文的安装目录和 %LocalAppData%\Tongwen\ 两个目录添加到信任区。
3. 验证拦截是否已解除：
   • 在同文的安装目录下找到 Studio 主程序，双击启动。
   • 如果能正常启动并显示主界面，说明拦截已解除。
   • 创建一个简单的测试项目，进行一次提取→翻译→回写的完整流程验证。
4. 如果仍然被拦截：
   • 查看杀毒软件的”保护日志”或”拦截历史”，找到与同文相关的拦截记录。
   • 在拦截记录中通常会有一个”允许”或”还原”操作按钮，点击后将文件恢复并加入信任。
   • 如果杀毒软件已删除了同文的某些文件，需要重新运行安装程序进行修复安装。

12.2.6 安装权限不足

现象描述：

• 运行安装包时，提示”权限不足，请以管理员身份运行”。
• 安装过程中出现”无法写入文件”或”无法创建目录”的错误。
• 安装程序在写入注册表时失败。
• 安装完成后 Studio 无法保存设置（每次重启设置丢失）。

可能原因：

• 当前 Windows 用户账户不是管理员账户，或者没有管理员权限。
• 安装目录（默认 C:\Program Files\）受 UAC（用户账户控制）保护，需要管理员权限才能写入。
• 用户的 %LocalAppData% 目录权限异常。

解决方案：

1. 以管理员身份运行安装包：
   • 右键点击同文安装包（.exe 或 .msi 文件）。
   • 在弹出的菜单中选择”以管理员身份运行”。
   • 如果出现 UAC 提示框，点击”是”确认。
2. 更改安装目录（适用于非管理员账户）：
   • 在安装向导的”选择安装目录”步骤中，将默认路径从 C:\Program Files\Tongwen\ 改为用户目录下的路径，例如 C:\Users\<用户名>\AppData\Local\Programs\Tongwen\。
   • 用户目录通常不需要管理员权限即可写入。
3. 修改用户账户类型：
   • 打开”设置” → “账户” → “家庭和其他用户”（Windows 11）或”账户” → “家庭和其他人员”（Windows 10）。
   • 找到当前用户账户，点击”更改账户类型”。
   • 选择”管理员”，然后点击”确定”。
   • 注销并重新登录，再次运行安装包。
4. 修复 %LocalAppData% 目录权限（适用于高级用户）：
   • 打开文件资源管理器，在地址栏输入 %LocalAppData% 并回车。
   • 找到 Tongwen 文件夹（如果存在）。
   • 右键点击该文件夹，选择”属性” → “安全”选项卡。
   • 确认当前用户账户具有”完全控制”权限。如果没有，点击”编辑”按钮添加。
5. 检查组策略限制（企业环境）：
   • 如果您在公司网络中，IT 部门可能通过组策略限制了软件安装权限。
   • 联系您公司的 IT 管理员，申请安装同文的权限。

12.3 文字提取问题

12.3.1 提取失败/超时

现象描述：

• 点击”开始提取”后，进度条长时间停滞在某个百分比不动。
• 最终提示”提取失败：操作超时”或”Core Console 超时（1200 秒）”。
• Core Console 进程在任务管理器中一直显示”正在运行”但无实际进展。

可能原因：

1. 图纸文件过大，包含海量文字实体，提取超过了 1200 秒（20 分钟）的超时限制。
2. 图纸中包含损坏或异常的文字实体，导致 Core Console 在处理时陷入死循环。
3. Core Console 在后台遇到了错误对话框（如”字体未找到”、”代理对象”等），但没有用户界面可以点击确认，导致卡住。
4. Named Pipe 通信阻塞——Core Console 已完成提取但无法将数据发送给 Studio 的 Sidecar 服务。
5. 系统资源紧张（内存不足、CPU 满载），导致 Core Console 运行极为缓慢。

解决方案：

1. 检查系统资源使用情况：
   • 按 Ctrl + Shift + Esc 打开任务管理器。
   • 查看 CPU、内存、磁盘的使用率。如果某项接近 100%，说明系统资源紧张。
   • 关闭其他不必要的程序（特别是浏览器、大型办公软件），释放资源后再试。
2. 终止卡住的提取并重试：
   • 在 Studio 的提取进度页面中，点击”终止提取”按钮。
   • 如果”终止提取”按钮无响应，手动打开任务管理器，找到 accoreconsole.exe 进程，右键选择”结束任务”。
   • 同时检查是否有残留的 Tongwen.PipeService.exe 或类似名称的进程，一并结束。
   • 重新启动 Studio，再次创建提取任务。
3. 在 AutoCAD 图形界面中预处理图纸：
   • 用 AutoCAD 打开待提取的 DWG 文件。
   • 执行以下命令进行图纸清理：
     • PURGE（输入后选择”全部清理”）：移除图纸中无用的命名对象（图层、样式、块定义等）。
     • AUDIT（输入后输入 Y 确认修复）：检查并修复图纸数据库中的错误。
     • OVERKILL（选择性使用）：删除重复的重叠对象。
   • 保存文件，再用 Studio 提取。
4. 拆分大图纸：
   • 如果图纸包含大量布局（Layout）或多个图框，尝试在每个布局中仅保留需要翻译的部分内容。
   • 在 AutoCAD 中使用 WBLOCK 命令将需要翻译的文字所在区域导出为一个新的 DWG 文件，减小单次提取的范围。
5. 检查 Named Pipe 通信：
   • 详细排查方法参见 12.10 节”Pipe/管道通信问题”。
   • 简而言之：确保防火墙未拦截 Named Pipe 通信；检查 %LocalAppData%\Tongwen\Logs\ 中最近的 pipe_*.log 日志文件。
6. 增加超时时间（适用于已知大图纸场景）：
   • 在 Studio 的”设置 → 提取设置”中，查找”Core Console 超时”选项。
   • 将默认的 1200 秒调整为更大的值（如 3600 秒，即 1 小时）。
   • 注意：仅在确认图纸确实需要更长处理时间时才调整此参数，否则超时本身就是诊断问题的信号。
7. 查看 Core Console 日志：
   • Core Console 的运行日志位于 %LocalAppData%\Tongwen\Logs\ 目录下。
   • 文件名格式通常为 cad2025.log 或 accoreconsole_*.log。
   • 打开最近的日志文件，搜索 “Error”、”Exception”、”Failed” 等关键词，找出具体的错误原因。

12.3.2 提取不完整（部分文字没提取到）

现象描述：

• 提取完成后，在翻译工作区中看到的翻译条目数量明显少于图纸中实际包含的文字数量。
• 已知图纸中的某些文字标注没有被提取为翻译条目。
• 多个图框中，有些图框的文字被提取了，有些没有。

可能原因：

1. 图纸中部分文字已被设置为”不可见”或位于被冻结/关闭的图层上。
2. 某些文字实体是块（Block）内的属性（Attribute），提取时可能因为块引用方式不同而遗漏。
3. 提取范围设置不正确（例如在 AutoCAD 插件中手动提取时只选择了部分区域）。
4. 文字实体的类型不受支持——例如某些代理对象（Proxy Object）中的文字、自定义对象中的文字。
5. 图纸中存在外部参照（Xref）中的文字，而提取设置中未包含外部参照。

解决方案：

1. 在 AutoCAD 中检查遗漏的文字：
   • 用 AutoCAD 打开图纸。
   • 确保所有图层均已解冻并开启（使用 LAYTHW 命令解冻所有图层，使用 LAYON 命令开启所有图层）。
   • 使用 PROPERTIES（属性面板）查看遗漏文字的属性——特别是”所属图层”和”可见性”。
   • 如果文字所属的图层被关闭或冻结，提取时会被跳过。将该图层设置为可见并保存图纸后重新提取。
2. 检查块属性和外部参照：
   • 如果遗漏的是图框中的标题栏文字，它们很可能是块属性（Block Attribute）。
   • 在提取设置中（Studio 的项目管理页面或 AutoCAD 插件的提取配置中），确保启用了”提取块属性”选项。
   • 如果图纸包含外部参照（Xref），确保在提取设置中启用了”包含外部参照”选项。
3. 在 AutoCAD 中通过插件执行手动提取：
   • 如果 Studio 端的自动提取遗漏了某些文字，可以尝试在 AutoCAD 图形界面中使用同文插件执行手动提取。
   • 打开 AutoCAD，加载同文插件。
   • 使用插件提供的”提取选择”功能，手工框选需要提取的文字区域。
   • 这种方式可以提供更精确的提取范围控制，尤其适用于分区提取的场景。
4. 检查代理对象和自定义对象：
   • 在 AutoCAD 中执行 PROXYSHOW 命令，确认该值设置为 1（显示代理对象图形）。
   • 查看图纸中是否有显示为方框的代理对象——这些对象可能包含文字但同文无法直接读取。
   • 如果可能，请在生成图纸的原始软件中将代理对象分解（Explode）为基本文字实体后再提取。
5. 更换提取策略：
   • 在 Studio 的”提取设置”中，尝试切换提取策略。
   • 如果之前使用了”按图层提取”，改为”按图框提取”（反之亦然），不同的策略可能覆盖不同的文字范围。

12.3.3 图框文字被错误提取/未提取

现象描述：

• 图框标题栏中的固定文字（如”项目名称”、”设计阶段”等标签）被当作翻译内容提取了。
• 图框中的变量内容（如实际的项目名称、图号）反而没有被提取。
• 提取结果中图框区域的文字杂乱排列，无法区分哪些是标签、哪些是变量值。

可能原因：

1. 图框识别算法未能正确解析图框的边界和内部结构。
2. 图框中的文字排列顺序与预期不一致（例如标签和变量值是横向排列而非纵向排列）。
3. 图框模板与同文内置的图框模板库不匹配。
4. 部分图框文字使用了特殊的字体或编码方式。

解决方案：

1. 手动配置图框模板：
   • 在 Studio 的”翻译项目 → 提取设置”中，找到”图框管理”或”图框模板”配置项。
   • 点击”新建图框模板”，按照提示步骤操作：
     • 首先框选图框的边界。
     • 然后分别标记”标签”区域和”变量值”区域。
     • 指定标签与变量的对应关系（如”图号 → DRAWING_NO”、”项目名称 → PROJECT_NAME”）。
   • 保存自定义模板，下次提取同类图框时将自动应用。
2. 在 AutoCAD 中调整图框文字排列：
   • 如果控制源文件可行，在 AutoCAD 中调整图框内文字的布局：
     • 确保标签文字在左侧，对应变量值在右侧，且两者对齐。
     • 确保标签文字和变量值文字属于不同的图层或使用不同的文字样式，方便同文区分。
3. 使用”忽略标签文字”选项：
   • 在提取设置中，启用”忽略图框标签文字”选项。
   • 这样同文会自动跳过被识别为固定标签的文字，仅提取变量内容。
   • 如果某些标签被错误地识别为变量（或反之），请在”图框管理”中调整识别规则。
4. 分区域提取：
   • 如果自动图框识别效果不佳，可以采用分区域提取策略：
     • 首先在 AutoCAD 中使用同文插件手动提取图框外的工程注释文字。
     • 然后单独对图框区域执行提取，并在提取后手动调整图框中的条目对应关系。

12.3.4 Core Console 无法启动

现象描述：

• 点击”开始提取”后，Studio 立即报错”Core Console 启动失败”。
• 状态信息显示”正在启动 Core Console…“然后迅速变为”提取失败”。
• 任务管理器中看不到 accoreconsole.exe 进程。

可能原因：

1. accoreconsole.exe 文件路径不正确（见 12.2.3 节）。
2. Core Console 依赖的 DLL 文件缺失或损坏。
3. Core Console 启动时需要的临时目录不存在或没有写入权限。
4. 系统环境变量 PATH 中缺少 AutoCAD 相关的路径信息。
5. .NET 桌面运行时未正确安装。

解决方案：

1. 直接在命令行中测试 Core Console 启动：
   • 打开命令提示符（cmd），输入（路径替换为实际路径）：

     "C:\Program Files\Autodesk\AutoCAD 2025\accoreconsole.exe" /s "C:\Temp\dummy.scr"
     

   • 先确保 C:\Temp 目录存在。创建一个 dummy.scr 文件，内容仅为 _quit（注意：文件名本身不需要特定内容，只需要一个存在的 .scr 文件路径即可让 Core Console 启动后立即退出）。
   • 如果命令行中能看到 Core Console 的输出信息并正常退出，说明 Core Console 本身正常工作。
   • 如果报错，请记录错误信息。

2. 常见 Core Console 命令行错误及解决：

   错误信息	原因	解决方法
   “The application was unable to start correctly (0xc000007b)”	32位/64位不匹配或.NET运行时缺失	安装对应.NET桌面运行时x64版本
   “The code execution cannot proceed because MSVCP140.dll was not found”	缺少Visual C++运行库	安装最新的Visual C++ Redistributable
   “FATAL ERROR: Unhandled Access Violation”	系统内存问题或显卡驱动冲突	重启计算机后重试；更新显卡驱动

3. 检查并设置 TEMP 环境变量：
   • Core Console 需要临时目录来存放运行时的中间文件。
   • 按 Win + R，输入 %TEMP%，确认该目录存在且可访问。
   • 如果 TEMP 变量指向了不存在的路径，打开”系统属性 → 高级 → 环境变量”，修正 TEMP 和 TMP 的值。
4. 以管理员身份运行 Studio：
   • 右键 Studio 快捷方式 → “以管理员身份运行”。
   • 管理员权限可以确保 Core Console 进程具有足够的权限访问系统资源。
5. 重置 AutoCAD 用户配置：
   • 有时 AutoCAD 的用户配置文件（Profile）损坏会导致 Core Console 无法启动。
   • 在文件资源管理器的地址栏输入 %AppData%\Autodesk，找到对应的 AutoCAD 版本文件夹。
   • 将配置文件夹重命名（添加 .bak 后缀），然后重新启动 Core Console，AutoCAD 会自动创建新的配置。

12.3.5 提取后项目中没有数据显示

现象描述：

• 提取过程显示”提取完成”，进度条到达 100%。
• 但进入翻译工作区后，左侧的原文列表为空，没有任何翻译条目。
• 项目的统计信息显示”总条目数：0”。

可能原因：

1. 图纸中确实没有任何可提取的文字实体（全部为线条、图形等非文字对象）。
2. 提取过程中数据成功生成，但未正确同步到翻译工作区的数据库中。
3. 提取到了文字，但全部被过滤规则排除了（例如全部为纯数字或空格）。
4. 项目文件损坏或数据库读写异常。

解决方案：

1. 确认图纸中确实存在文字：
   • 用 AutoCAD 打开该 DWG 文件。
   • 使用 QSELECT（快速选择）命令：对象类型选择”文字”或”多行文字”，运算符选择”全部”，确认是否有文字实体被选中。
   • 如果确实没有文字实体，那么”0 条提取结果”是正确的行为——该图纸不需要翻译。
2. 在 AutoCAD 中使用插件直接查看提取结果：
   • 用 AutoCAD 打开图纸，加载同文插件。
   • 使用插件的”提取预览”功能（如果提供），查看插件本身能否成功识别文字内容。
   • 如果插件也无法提取到文字，说明文字可能属于不可提取的类型（如代理对象）。
3. 检查过滤规则设置：
   • 在 Studio 的”项目设置 → 提取设置”中，查看”过滤规则”配置。
   • 确认以下过滤选项未过度排除：
     • “排除纯数字”——如果勾选，图纸中所有的纯数字标注（如”100”、”200”）将被跳过。
     • “排除纯符号”——如果勾选，仅包含标点符号的条目将被跳过。
     • “最短字符数”——如果设置了最小字符数（如”3”），短于该长度的文字将被跳过。
   • 暂时关闭所有过滤规则，重新提取一次，确认问题是否由过滤规则导致。
4. 重建项目数据库：
   • 在 Studio 中，右键点击出现问题的项目。
   • 选择”修复项目”或”重建数据库”（如果支持）。
   • 如果项目数据已损坏，考虑删除当前项目，重新创建新项目并重新提取。
5. 查看提取日志文件：
   • 打开 %LocalAppData%\Tongwen\Logs\ 目录。
   • 找到与提取时间对应的日志文件，搜索关键词”extracted”、”count”、”entities”。
   • 日志中通常会显示提取了多少个文字实体、过滤后剩余多少个条目。根据这些数值定位问题环节。

12.3.6 Named Pipe 连接失败

现象描述：

• 提取过程中报错”Named Pipe 连接失败”或”无法连接到 Pipe 服务”。
• Core Console 日志中显示”无法连接到命名管道”。
• Studio 的 Sidecar/Pipe 服务状态显示”未启动”或”错误”。

可能原因：

1. Pipe 服务（Sidecar）未随 Studio 启动而自动启动。
2. 防火墙或安全软件拦截了 Named Pipe 通信。
3. Pipe 端口或名称冲突（已有其他程序占用了相同的管道名称）。
4. Pipe 服务程序文件损坏或被删除。

解决方案：

更详细的 Pipe 问题排查请参见 12.10 节”Pipe/管道通信问题”。以下为快速排查步骤：

1. 重启 Studio 和 Pipe 服务：
   • 完全关闭 Studio（确保任务管理器中无 Studio 进程）。
   • 重新启动 Studio，观察”设置 → 服务状态”页面中 Pipe 服务是否显示为”运行中”。
2. 手动重启 Pipe 服务：
   • 在 Studio 的”设置 → 服务状态”页面中，找到 Pipe 服务，点击”重启”按钮。
3. 检查防火墙设置：
   • 确保 Windows Defender 防火墙或第三方防火墙允许同文的 Pipe 服务通过。
   • 如需要，在防火墙中为同文的 Pipe 服务程序（通常位于安装目录的 Sidecar\ 或 Pipe\ 子目录）添加入站规则。
4. 使用管理员权限运行：
   • 右键 Studio → “以管理员身份运行”。Named Pipe 在创建时可能需要较高的权限级别。

12.4 翻译问题

12.4.1 翻译引擎连接失败

现象描述：

• 在翻译工作区中点击”开始翻译”或”批量翻译”后，所有条目状态显示”翻译失败”或”连接错误”。
• Studio 底部状态栏显示”翻译引擎连接失败”。
• 日志中显示”API Key 无效”、”401 Unauthorized”、”网络连接超时”等错误信息。

可能原因：

1. DeepSeek API Key 未配置、配置错误或已过期。
2. API Key 的额度已耗尽。
3. 本机网络无法访问 DeepSeek API 的服务器地址（https://api.deepseek.com）。
4. 网络代理设置不正确，导致请求无法发出。
5. 防火墙或企业网络策略拦截了 HTTPS 请求。

解决方案：

1. 检查 API Key 配置：
   • 打开 Studio，进入”设置 → 翻译引擎”页面。
   • 在”DeepSeek API Key”输入框中，确认 API Key 已经填写。
   • 检查 API Key 是否有多余的空格——开头和结尾的空格可能导致 API Key 无效。
   • 点击”测试连接”按钮。如果测试成功，会显示”连接成功”及账户余额信息；如果测试失败，会显示具体错误信息。
2. 获取或更新 API Key：
   • 访问 DeepSeek 平台官网（https://platform.deepseek.com）。
   • 注册账号或登录已有账号。
   • 在”API Keys”页面中创建新的 API Key，或检查现有 API Key 的状态。
   • 将获取的 API Key 完整复制到 Studio 的设置中。
3. 检查 API 额度：
   • 在 DeepSeek 平台的后台中，查看账户的可用余额或 API 调用额度。
   • 如果额度已耗尽，需要进行充值或等待下一个计费周期。
   • 注意区分”免费额度”和”付费额度”——免费额度通常有每日调用次数限制。
4. 测试网络连通性：
   • 打开命令提示符（cmd），执行：

     ping api.deepseek.com
     

   • 如果能 ping 通，说明网络可达。如果 ping 不通，继续下一步排查。
   • 如果 ping 不通，尝试在浏览器中访问 https://api.deepseek.com，看是否能加载页面。
   • 如果浏览器也无法访问，说明网络环境可能限制了对外部 API 的访问。
5. 配置网络代理：
   • 如果您需要通过代理服务器访问外网：
     • 在 Studio 的”设置 → 网络”页面中，找到”代理设置”。
     • 填写代理服务器的地址、端口，以及（如果需要的）用户名和密码。
     • 代理格式通常为 http://127.0.0.1:8080 或 socks5://127.0.0.1:1080。
   • 如果您使用的是系统级代理（如 Clash、V2Ray 等），Studio 通常会自动使用系统代理设置。如果自动检测失败，可以手动填写代理地址。
6. 检查防火墙和企业网络：
   • 如果您在公司网络环境中，IT 部门可能限制了对外部 HTTPS API 的访问。
   • 联系 IT 管理员，申请开放对 api.deepseek.com（端口 443）的访问权限。
   • 如果公司提供了内部的 API 网关或代理，请询问正确的代理配置信息。

12.4.2 翻译结果不准确

现象描述：

• 某些工程术语的翻译明显不符合行业习惯。
• 同一术语在不同位置被翻译成了不同的英文表达。
• 翻译结果存在语法错误或不通顺。
• 特定语境的翻译完全错误（如将”标高”翻译成”bid height”而非正确的”elevation”）。

可能原因：

1. 术语库中没有配置该术语的标准译法。
2. 术语库中配置了标准译法但没有生效（详见 12.4.3 节）。
3. 上下文记忆（CM）库中缺少该图纸类型的翻译记录。
4. 作为兜底的 DeepSeek 大模型对特定工程领域的知识有限。
5. 待翻译文本中包含特殊格式码或占位符，干扰了大模型的理解。

解决方案：

1. 将术语添加到术语库：
   • 在翻译工作区中，选中被翻译错误的术语。
   • 右键点击，选择”添加到术语库”。
   • 在弹出窗口中填写标准译法和备注信息，保存。
   • 术语添加后，重新执行翻译，新术语将生效。
   • 更多术语库操作请参见 12.6 节。
2. 切换翻译引擎模式：
   • 在”设置 → 翻译引擎”中，查看”引擎模式”配置。
   • DeepSeek 提供不同的翻译模型（如 deepseek-chat、deepseek-v4-flash、deepseek-v4-pro）。
   • 切换到更高质量的模式（如从 Flash 切换到 Pro），翻译准确度会显著提升，但耗时会增加。
   • 对于专业术语密集的图纸，建议使用 Pro 模式。
3. 利用上下文记忆（CM）提升一致性和准确度：
   • 在翻译工作中，每当您手动修正了一条翻译，系统会自动将源文本和修正后的译文保存到上下文记忆中。
   • 翻译同类图纸时，系统会优先从 CM 中命中匹配记录，确保同一语境下翻译结果的一致性。
   • 定期检查和维护 CM 库，删除过时或不准确的记忆记录。
4. 细化翻译提示词（Prompt）：
   • 在”设置 → 翻译引擎 → 高级设置”中，查看”自定义提示词”配置。
   • 可以在提示词中加入领域说明，例如：

     请将以下中文工程文本翻译为英文。这是一份土木工程结构图纸的文字标注，请使用专业工程术语。例如："混凝土"应翻译为"concrete"，"标高"应翻译为"elevation"。
     

   • 提示词的优化可以显著提升特定领域的翻译质量。
5. 人工审校与质量检查：
   • 翻译完成之后，务必进行人工审校。
   • 使用同文的 QA 功能（质量检查）自动检测术语一致性问题（详见第 8 章）。
   • 对于 QA 标记为”高风险”或”严重”的条目，优先进行人工复核和修正。

12.4.3 术语表未生效

现象描述：

• 已经在术语库中添加了某条术语（例如”混凝土 → concrete”），但在翻译结果中该术语仍然被翻译为其他表达。
• 术语库中明明配置了大量术语，但翻译结果看起来完全没有参考术语表。

可能原因：

1. 术语条目添加后未保存或保存失败。
2. 术语表未与当前翻译项目关联。
3. 术语的大小写/全半角不匹配——术语库中的源语言术语与图纸中的实际文字存在微小差异（如全角括号 vs 半角括号）。
4. 术语的优先级设置导致在匹配时被其他优先级更高的术语覆盖。
5. 术语表来源冲突——全局术语表和项目术语表同时存在相同词条，但配置不一致。

解决方案：

1. 确认术语已保存并关联到项目：
   • 打开术语库管理页面（在 Studio 中通过”工具 → 术语库”进入）。
   • 搜索您添加的术语，确认其状态为”已启用”。
   • 检查该术语所属的术语表是否已关联到当前翻译项目。
     • 在翻译项目的”项目设置 → 术语库”中，查看已关联的术语表列表。
     • 如果术语表未在列表中，点击”关联术语表”并选择对应的术语表文件。
2. 检查术语匹配精度：
   • 术语匹配默认是精确匹配（Exact Match），即源文本与术语的”源语言”字段必须完全一致。
   • 由于 CAD 图纸中文字可能包含前后空格、特殊字符、多行文字中的换行符等，导致无法精确匹配。
   • 解决方法：
     • 在术语编辑页面中，检查源文本是否与图纸文字完全一致（包括空格和标点符号）。
     • 如果图纸文字存在多个变体（如”混凝土”和” 混凝土 “——带前后空格），需要为每个变体分别添加术语条目。
     • 在术语库设置中，如果支持”模糊匹配”选项，可以启用它以增强匹配鲁棒性。
3. 区分全局术语表和项目术语表：
   • 全局术语表：适用于所有翻译项目的通用术语集合。
   • 项目术语表：仅适用于当前项目的专用术语集合。
   • 当全局术语表和项目术语表中存在相同源语言词条的术语时，系统默认以项目术语表的条目为准（项目术语表优先级高于全局术语表）。
   • 在术语库管理页面中，检查项目中是否创建了同名的术语但配置了不同的译法。如有冲突，以项目术语表为准调整。
4. 重置术语缓存：
   • 在术语库管理页面中，查找”刷新缓存”或”重建术语索引”按钮并点击。
   • 术语缓存用于提升匹配速度，但偶尔可能过期导致新增术语未立即生效。
   • 缓存刷新后，回到翻译工作区，选中相关条目，执行”重新翻译”或”应用术语表”。
5. 清空翻译结果后重新翻译：
   • 如果术语添加前该条目已被翻译过，且系统中存在该条目的 CM（上下文记忆）记录，CM 的优先级高于术语表。
   • 解决：选中该条目，点击”清除译文”，然后”重新翻译”——这样系统将跳过 CM 命中，重新走术语表匹配流程。

12.4.4 翻译进度卡住

现象描述：

• 批量翻译时，进度条长时间停在某个百分比不变。
• 翻译工作区中某几条记录始终显示”翻译中”状态，且不变化。
• 已等待超过 5 分钟，但没有任何新的翻译结果返回。

可能原因：

1. 网络连接不稳定——某个翻译请求的 TCP 连接中断但客户端未检测到超时。
2. DeepSeek API 服务端限流——短时间内发送了太多请求，服务端放慢了响应速度。
3. 某条待翻译文本内容异常（如超长文本、包含特殊字符），导致 API 处理时间极长。
4. Studio 的并发翻译数量设置过高，导致本地资源耗尽。

解决方案：

1. 检查网络状态并重试：
   • 首先检查本机是否能正常访问互联网（打开浏览器访问任意网站确认）。
   • 如果网络正常，在翻译工作区中点击”暂停翻译”，等待 30 秒后点击”继续翻译”。
   • 如果仍然卡住，点击”停止翻译”，然后重新点击”开始翻译”。
2. 降低并发翻译数量：
   • 进入”设置 → 翻译引擎 → 高级设置”。
   • 找到”最大并发请求数”选项，将其从默认值降低（如从 10 降低到 3）。
   • 降低并发可以减少对 API 服务端的压力，同时降低本地网络拥塞的概率。
   • 重新开始批量翻译。
3. 排查卡住的特定条目：
   • 在翻译工作区中，按状态排序，找出所有”翻译中”且长时间未完成的条目。
   • 选中这些条目，点击”清除译文”，将它们重置为”待翻译”状态。
   • 观察这些条目中是否存在特殊文本（超长文本、含特殊格式字符、含大量占位符等）。
   • 尝试逐条手动翻译这些特殊条目，以隔离问题。
4. 检查 DeepSeek API 服务状态：
   • 访问 DeepSeek 平台的状态页面或官方公告，确认是否有服务中断或维护通知。
   • 如果 DeepSeek 服务本身出现了问题，只能等待服务恢复后再继续翻译。
5. 切换为 Mock 引擎测试：
   • 将翻译引擎暂时切换为 Mock 引擎（本地离线引擎）。
   • 执行一次批量翻译，确认问题是否与 DeepSeek API 相关。
   • 如果 Mock 引擎翻译正常，问题基本可以确定是 API 连接或服务端问题。
   • Mock 引擎的作用见 12.4.7 节。

12.4.5 某些条目一直显示”待翻译”

现象描述：

• 批量翻译完成后，少数条目仍然显示”待翻译”状态，没有被自动翻译。
• 手动点击”翻译选中条目”也无效，状态不改变。
• 这些条目无法被正常翻译，但其他大部分条目都已翻译完成。

可能原因：

1. 这些条目的源文本为空（空字符串或仅包含空格/换行）。
2. 源文本仅包含占位符代码，没有实际的文字内容需要翻译。
3. 条目的”锁定”状态被启用，系统自动跳过被锁定的条目。
4. 这些条目曾翻译失败（如 API 返回了错误），且系统记录了失败状态，未自动重试。

解决方案：

1. 检查源文本内容：
   • 在翻译工作区中双击这些条目，查看原文编辑框中的源文本内容。
   • 如果源文本确实为空或仅包含格式代码，这些条目不需要翻译，属于正常行为。
   • 可以手动将这些条目的状态标记为”已翻译（无需操作）”或直接设置为完成状态。
2. 检查条目的锁定状态：
   • 在翻译工作区的列表视图中，查看”锁定”列（通常显示为锁的图标）。
   • 如果锁图标处于锁定状态，点击解锁，然后重新翻译。
3. 清除失败状态并重试：
   • 选中这些”待翻译”的条目。
   • 右键点击，选择”清除状态”或”重置为待处理”。
   • 再点击”翻译选中条目”，强制系统重新发起翻译请求。
4. 检查是否存在翻译规则排除：
   • 在”项目设置 → 翻译设置”中，查看”排除规则”。
   • 确认是否设置了”跳过包含特定字符的条目”等规则，且这些规则匹配了待翻译的条目。
   • 如果是，调整排除规则后重新翻译。

12.4.6 置信度始终很低

现象描述：

• 翻译工作区中的”置信度”列显示大部分条目都低于 50%（显示为红色或橙色警告色）。
• 质量检查报告中大量条目被标记为”低置信度”。
• 即使是简单的中文文本，翻译后的置信度评分也很低。

可能原因：

1. 当前正在使用 Mock 引擎，Mock 引擎会为所有翻译结果赋予固定的较低置信度。
2. 翻译时使用了 DeepSeek Flash 模式，该模式给出的自评估分数较 Pro 模式偏低。
3. 源文本高度专业化或包含大量缩写、代码、编号，大模型对该领域的信心不足。
4. 翻译引擎的自评估机制本身偏向保守——对工程类文本会给出较低的自评估分数。

解决方案：

1. 理解置信度的含义：
   • 置信度是翻译引擎对自身翻译结果的自评估分数，并非人工评分。
   • 低置信度不一定意味着翻译错误，而是表示引擎对这条译文”不太有把握”。
   • 低置信度条目的高发场景包括：专业术语密集、缩写多、文本片段化（无上下文）、包含非标准符号等。
   • 置信度低是提醒您优先审校这些条目的信号，不是翻译质量不合格的判决。
2. 区分 Mock 引擎和 DeepSeek 引擎的置信度差异：
   • Mock 引擎是本地离线引擎，不具备真正的翻译能力。它会给所有译文赋予一个固定的低置信度值。如果当前使用的是 Mock 引擎，请切换到 DeepSeek 引擎后再翻译——详见 12.4.7 节。
   • DeepSeek Flash 模式速度快但评估较宽松，Pro 模式翻译质量更高且自评估更准确。对质量要求高的项目，建议使用 Pro 模式。
3. 改善翻译上下文：
   • 如果图纸中文本高度碎片化，大模型缺少上下文来做出高置信度的翻译。
   • 在”设置 → 翻译引擎 → 高级设置”中，可以调整发送给模型的上下文窗口大小。
   • 更大的上下文窗口会让模型参考更多周边文本做出翻译决策，可能提升置信度。
4. 以人工审校补充：
   • 对于置信度低的条目，结合质量检查报告的提示，进行人工审校。
   • 经过人工审校确认无误的条目，可以手动将其置信度状态标记为”已确认”。
   • 随着您不断在 CM（上下文记忆）和术语库中积累正确的翻译对，后续同类文本的置信度会自然提升。

12.4.7 Mock 引擎与 DeepSeek 引擎的区别

同文提供了两种翻译引擎供用户选择。理解它们各自的特点和适用场景，有助于避免因引擎选择不当导致的问题。

常见误解：

• “Mock 引擎翻译质量差” —— Mock 引擎不是翻译质量差，而是完全不提供翻译功能。它的设计目的是让用户在不消耗 API 额度的情况下测试系统的提取、回写、格式处理等核心功能。
• “切换引擎就能立刻看到效果差异” —— 是的，切换引擎后重新执行翻译，就能看到两者在译文质量和置信度上的显著差异。
• “Mock 引擎完全没用” —— 恰好相反，Mock 引擎在日常工作中非常有用：测试新图纸的提取兼容性、验证回写后格式的正确性、在断网环境中演示系统工作流等场景下，Mock 引擎是高效的工具。

如何切换引擎：

1. 打开 Studio，进入”设置 → 翻译引擎”。
2. 在”翻译引擎”下拉选择框中，在”Mock（本地测试）”和”DeepSeek”之间切换。
3. 如果选择 DeepSeek，请确保已配置了有效的 API Key，并点击”测试连接”确认。
4. 切换引擎后，需要重新执行翻译（之前用旧引擎翻译的结果不会自动更新）。

12.5 回写问题

12.5.1 回写后 DWG 文件打不开

现象描述：

• 回写完成后，尝试用 AutoCAD 打开生成的 DWG 文件，AutoCAD 报错”无法打开文件”或”无效的 DWG 文件”。
• 文件大小看起来比原始文件小很多（可能只有几 KB）。
• AutoCAD 在加载文件时崩溃。

可能原因：

1. 回写过程中 Studio 异常退出或崩溃，导致输出文件写入不完整（文件只写了一部分就被中断）。
2. 回写时磁盘空间不足，文件写入失败但没有完整的错误提示。
3. 原始 DWG 文件本身存在损坏，提取时勉强成功，但回写时暴露了文件数据库的错误。
4. Core Console 在回写过程中意外终止。
5. 回写的目标路径是网络驱动器或移动存储设备，写入过程中连接不稳定。

解决方案：

1. 始终保留原始文件备份：
   • 这是一个非常重要的习惯：在执行回写之前，务必将原始 DWG 文件复制一份作为备份。
   • 同文的回写操作会生成新的 DWG 文件（不会修改原始文件），但这个生成过程依赖原始文件的完整性。
   • 最佳实践：将原始 DWG 文件复制到 项目文件夹\backup\ 目录中，然后再从 Studio 中指定原始文件路径开始回写。
2. 使用 AutoCAD 的修复功能尝试恢复文件：
   • 打开 AutoCAD（图形界面版）。
   • 在”文件”菜单中选择”图形实用工具 → 恢复”（或直接执行 RECOVER 命令）。
   • 在文件选择对话框中选择回写失败的 DWG 文件。
   • AutoCAD 将尝试扫描并修复文件中的数据库错误。
   • 如果修复成功，保存修复后的文件。
3. 检查磁盘空间：
   • 回写生成的 DWG 文件通常与原文件大小相近（或稍大一些，因为部分文字的英文版可能比中文版更长，但不会显著增加文件体积）。
   • 如果生成的文件异常小，检查输出目录所在磁盘的剩余空间是否充足。
   • 确保至少有原文件 2 倍以上的可用空间。
4. 重新执行回写：
   • 在 Studio 中，删除失败的回写记录。
   • 确保 Studio 运行稳定（没有频繁崩溃的前兆迹象）。
   • 重新选择原始 DWG 文件（建议使用备份的原始文件），再次执行回写。
   • 观察回写进度，确保进度条到达 100% 且没有错误提示。
5. 在 AutoCAD 中先修复原始图纸：
   • 用 AutoCAD 打开原始 DWG 文件。
   • 执行 AUDIT 命令，输入 Y 来修复检测到的所有错误。
   • 执行 PURGE 命令，选择”全部清理”。
   • 将修复后的文件另存为一个新文件，然后用这个新文件作为回写的原始文件。
6. 避免回写到网络路径：
   • 将原始 DWG 文件复制到本地硬盘（如 C:\Users\<用户名>\Desktop\ 或 D:\Projects\）。
   • 将回写输出路径也设置为本地硬盘。
   • 网络驱动器和移动存储设备在写入大文件时容易因连接波动导致文件损坏。

12.5.2 译文写入位置错误

现象描述：

• 回写后用 AutoCAD 打开图纸，发现某些译文出现在了错误的位置（与原文字位置不匹配）。
• 部分翻译后的文字偏移到了图纸的其他区域。
• 同一段文字的不同部分被分散到了不同的位置。

可能原因：

1. 提取过程中文字实体的位置坐标记录出现偏差。
2. MText（多行文字）的格式化信息（如对齐方式、段落缩进）在回写时被错误地重新计算。
3. 原始文字使用了非标准的插入点或对齐方式，回写时未能正确还原。
4. 图纸在提取和回写之间被修改过（包括图层变更、比例缩放等操作）。

解决方案：

1. 确保图纸在提取和回写之间未被修改：
   • 从提取完成到回写完成的整个过程中，不要用 AutoCAD 打开并编辑原始 DWG 文件。
   • 如果需要查看图纸内容，可以打开备份副本或只读模式查看。
   • 任何对图纸几何结构、图层状态、坐标系的修改都可能导致回写位置偏移。
2. 检查并调整对齐方式设置：
   • 在 Studio 的”项目设置 → 回写设置”中，查找”文字对齐方式”选项。
   • 尝试切换对齐方式策略（如”保持原始”、”自动适配”、”居中对齐”等），不同策略对位置偏移的处理方式不同。
   • 对于 MText，通常建议使用”保持原始对齐”策略。
3. 在 AutoCAD 中验证原始文字属性：
   • 用 AutoCAD 打开原始 DWG 文件。
   • 选中位置偏移的文字实体，按 Ctrl + 1 打开属性面板。
   • 查看其”插入点”、”对齐方式”、”宽度”等属性。
   • 如果发现原始文字使用了非标准设置（如对齐方式为”拟合”），尝试将其调整为标准对齐（如”左上”或”中上”）后保存，再重新提取和回写。
4. 分区域回写：
   • 如果图纸很大且包含多个独立区域，尝试分区域执行提取和回写。
   • 每次只处理一个区域，可以降低跨区域的坐标偏移风险。
   • 分区域提取的方法：在 AutoCAD 中使用插件的手动选择提取功能。
5. 检查 UCS（用户坐标系）：
   • 在 AutoCAD 中打开原始 DWG 文件。
   • 检查当前 UCS 是否为”世界坐标系”（WCS）。如果不是，执行 UCS → W（世界）切换到世界坐标系。
   • 非 WCS 坐标系下的文字提取可能导致位置偏移，建议在 WCS 下保存图纸后再进行提取和回写。

12.5.3 文字样式/字体丢失

现象描述：

• 回写后的 DWG 文件中，某些文字的字体变了（例如从”宋体”变成了”Simplex”）。
• 图纸中的文字样式列表缺少了原本存在的一些样式。
• 部分文字在 AutoCAD 中显示为方框或问号（缺少对应字体文件）。

可能原因：

1. 原始图纸中使用了系统中未安装的特殊字体（如某些 SHX 字体或第三方 TrueType 字体）。
2. 回写过程中文字样式被合并或简化，导致原有样式信息丢失。
3. 翻译后的英文文本使用了与中文原文不同的字体设置。

解决方案：

1. 安装缺失的字体：
   • 当图纸中的文字显示为方框或问号时，说明系统缺少原图纸中使用的 SHX 字体文件或 TrueType 字体。
   • 确认原始图纸使用的字体类型：
     • 在 AutoCAD 中打开原始文件。
     • 执行 STYLE 命令，打开文字样式管理器。
     • 查看每种文字样式使用的字体名称。
   • 从原始设计单位获取缺失的字体文件（.shx 或 .ttf），安装到系统中：
     • SHX 字体：复制到 AutoCAD 安装目录下的 Fonts 文件夹中。
     • TrueType 字体：右键 .ttf 文件，选择”安装”。
2. 在回写设置中保留文字样式：
   • 在 Studio 的”项目设置 → 回写设置”中，确认”保留原始文字样式”选项已启用。
   • 如果启用了”合并相似文字样式”选项，建议暂时关闭，以保持每个文字实体的样式独立性。
3. 处理 SHX 字体的特殊情况：
   • SHX 字体（AutoCAD 的矢量字体）通常只支持英文字符。当中文内容被翻译为英文后，原 SHX 字体可能能够正常显示。
   • 但如果 SHX 字体定义不完整（缺少某些字符形状），可能在英文环境下仍然显示异常。
   • 解决方式：在 AutoCAD 中执行 STYLE 命令，将相关文字样式的字体替换为等价的 TrueType 字体（如 “Arial” 或 “ISOCP”），保存后再进行回写。
4. 使用字体映射：
   • 在 Studio 的”回写设置 → 字体映射”中，可以定义字体替换规则。
   • 例如：将所有使用 “ROMANS.shx” 的样式映射为 “Arial.ttf”。
   • 配置好映射规则后，回写时会自动将原始字体替换为目标字体。

12.5.4 MText 格式乱码

现象描述：

• 回写后，MText（多行文字）中出现了奇怪的格式符号（如 \fArial|b0|i0|c0|p34;、\P、\C256; 等）。
• 原本的加粗、斜体、颜色、下划线等格式全部失效，显示为原始格式代码。
• MText 的行间距、段落缩进发生变化，文字堆叠在一起或间隔过大。
• 翻译后的英文文字仍然显示为中文格式码的片段。

可能原因：

1. 翻译过程中，译文意外保留了或错误插入了 MText 的内嵌格式码（Embedded Format Codes）。
2. 提取和回写过程中，MText 格式码的编码/解码出现了错误——占位符替换机制未能正确还原。
3. 翻译引擎（特别是大模型）在处理包含占位符的文本时，自行修改或删除了某些占位符。
4. MText 中存在堆叠文字（Stacked Text，如分数格式），其格式码在翻译过程中被破坏。

解决方案：

1. 检查译文中的占位符完整性（优先步骤）：
   • 在翻译工作区中，将鼠标悬停在某条翻译条目上。
   • 查看原文和译文中是否包含占位符标记（通常显示为 {0}、{1} 或带颜色的标签）。
   • 确认原文和译文中的占位符数量和顺序一致——这是 MText 格式正确还原的前提。
   • 如果译文中占位符缺失或数量不对，说明在翻译过程中占位符被破坏。需要手动修复或重新翻译该条目。
2. 使用 QA 功能检测占位符问题：
   • 在翻译工作区中，点击”运行 QA 检查”。
   • QA 报告中的”占位符验证器”会自动检测原文和译文之间占位符数量和类型的一致性。
   • 所有占位符异常的条目都会被标记出来，逐一修复即可。
   • 修复方式：在译文编辑框中手动补全或删除多余的占位符，确保与原文匹配。
3. 检查翻译是否意外修改了格式码：
   • 某些翻译引擎在处理包含特殊字符的文本时，可能会将占位符视为普通文本进行翻译（例如将 {0} 翻译为某种特殊标记）。
   • 如果经常出现此类问题：
     • 在”设置 → 翻译引擎 → 高级设置”中，查看”占位符保护”选项是否已启用。
     • 如果有自定义提示词，可以在提示词中强调”不要翻译 {} 包裹的标记，保持它们原样不变”。
   • 或者，在提取阶段使用更明确的占位符前缀/后缀（如在 Studio 的提取设置中配置），降低被误翻译的概率。
4. 处理堆叠文字（Stacked Text）：
   • 堆叠文字（如 \A1;2/3 表示的分数 2/3）的格式码结构非常敏感。
   • 如果翻译后堆叠文字出现问题，建议将堆叠文字拆分为普通文字形式再翻译（例如将分数字符串 2/3 替换为普通文字 2/3），或直接跳过堆叠文字的翻译。
   • 在提取设置中，可以配置”跳过堆叠文字”选项。
5. 回写后在 AutoCAD 中手动修复：
   • 如果回写后 MText 的格式码问题无法通过上述步骤完全避免，可以在 AutoCAD 中手动修复：
     • 双击有问题的 MText 实体，进入编辑模式。
     • 删除错误的格式码字符，或使用 MText 编辑器的格式化工具栏重新设置格式。
   • 如果此类问题频繁出现且手动修复工作量大，建议联系技术支持寻求自动化修复方案。
6. 使用”原位替换”模式排查：
   • 切换到”原位替换”模式进行回写测试（注意备份原始文件！），观察该模式下 MText 格式是否能正确保持。
   • 如果原位替换模式下格式正常，说明问题出在”合并图层”或”新建图层”模式的多实体合并逻辑中。
   • 不同回写模式的说明见 12.5.6 节。

12.5.5 图层名称不符合预期

现象描述：

• 回写后，翻译文字的图层名称与原始文字的图层名称不一致。
• 新生成的图层名称不符合公司或项目的图层命名规范。
• 图层列表中出现了预期以外的额外图层。

可能原因：

1. 回写模式选择了”合并图层”，系统自动将翻译文字归入了一个统一的图层（如”TONGWEN_TRANSLATED”），而非保留在原始图层上。
2. 回写模式选择了”新建图层”（如创建”原图层名_TRANSLATED”的镜像图层），生成的图层名不符合自定义需求。
3. 项目设置中的”图层命名规则”配置了特定的前缀或后缀，但遗漏了部分设置。

解决方案：

1. 理解三种回写模式的图层行为：
   • 原位替换：直接修改原始文字实体的文本内容，不创建新图层。翻译文字保留在原始图层上。
   • 合并图层：将翻译文字从各自原始图层上移除，统一放置到一个新的合并图层（默认名为”TONGWEN_TRANSLATED”或类似名称）上。
   • 新建图层：为每个原始图层创建一个对应的翻译图层。默认命名规则是在原始图层名后添加后缀（如 _EN 或 _TRANSLATED）。
2. 根据需求选择正确的回写模式：
   • 如果您希望翻译后图层结构完全不变，选择”原位替换”模式——但务必先备份原始文件，因为该模式直接修改原始 DWG。
   • 如果您希望翻译文字和原文字在同一图层上共存（原文保留，译文在旁边），选择”新建图层”模式，并配置图层名后缀。
   • 如果您希望所有翻译文字集中在一个图层上方便管理，选择”合并图层”模式，并可自定义合并后的图层名称。
3. 自定义图层命名规则：
   • 在 Studio 的”项目设置 → 回写设置 → 图层”中，找到”新建图层命名规则”配置项。
   • 您可以自定义后缀（如将 _TRANSLATED 改为 _EN，或根据项目需求改为 _英文版）。
   • 也可以输入模板格式，例如 {原图层名}-EN 或 翻译_{原图层名}。
   • 修改后，对于已回写的项目，需要重新执行回写才能应用新的命名规则。
4. 合并图层的名称自定义：
   • 在”合并图层”模式下，可以在”回写设置 → 图层”中指定合并图层的名称。
   • 默认值可能为”TONGWEN_TRANSLATED”，您可以修改为符合公司标准的图层名（如”TEXT-TRANSLATED”、”ANNO-EN”等）。
5. 注意事项——合并图层后的译文堆叠问题：
   • 在”合并图层”模式下，所有翻译文字都被放置到同一个图层。如果图纸中存在不同位置使用相同图层且文字内容不同的场景，合并图层后可能导致不同区域的译文在视觉上重叠。
   • 这并不是技术错误，而是合并图层模式的固有行为——所有文字实体合并后失去了原始图层的隔离。
   • 如果您的图纸中大量依赖图层来管理文字显示/隐藏，建议使用”新建图层”模式而非”合并图层”模式。
   • 更多关于合并图层后译文堆叠的解决方案见 12.5.7 节。

12.5.6 回写后原文消失（误用原位替换模式）

现象描述：

• 回写后打开 DWG 文件，发现原始的中文文字全部消失，只剩下了翻译后的英文文字。
• 原本期望的是”原文保留，译文在旁边”或”原文在原始图层、译文在新图层”，但实际结果是原文被替换掉了。

可能原因：

• 回写模式选择了”原位替换”，该模式会直接修改原始文字实体的内容——将中文原文替换为英文译文。这是该模式的设计行为，不是 Bug。

解决方案：

1. 确认您选择的回写模式：
   • 在 Studio 的回写确认页面中，查看”回写模式”下拉选择框的当前值。
   • 三种模式的区别：
     • 原位替换：原文被译文直接替换。原始 DWG 文件被修改。务必在回写前备份原始 DWG 文件。
     • 新建图层：译文写入到新建的图层中。原始文字保持不变。原始 DWG 文件不被修改，生成一个新的 DWG 文件。
     • 合并图层：译文写入到一个统一的新图层中。原始文字保持不变。原始 DWG 文件不被修改，生成一个新的 DWG 文件。
2. 如果误用了”原位替换”且没有备份：
   • 如果您确实没有备份原始文件，且原始 DWG 文件被覆盖了：
     • 检查回收站：Windows 可能会保留旧版本文件。
     • 检查版本历史：如果该文件存储在 OneDrive、SharePoint 或支持版本历史的网络驱动器上，可以尝试恢复之前的版本。
     • 联系源文件提供方：请求重新提供原始 DWG 文件。
   • 这是不可逆的操作，因此反复强调：使用原位替换模式前必须备份原始 DWG 文件。
3. 切换为更安全的回写模式：
   • 如果您需要保留原文并同时查看译文，请选择”新建图层”或”合并图层”模式。
   • “新建图层”模式通常最符合工程图纸翻译的实际需求——原文保留在原始图层，译文放置在以 _EN 或 _TRANSLATED 后缀命名的镜像图层中。
4. 在 Studio 中设置默认回写模式：
   • 进入”设置 → 回写设置”，将默认回写模式设置为”新建图层”或”合并图层”。
   • 这样可以避免在每次回写时因疏忽而误选”原位替换”。

12.5.7 合并图层后译文堆叠

现象描述：

• 使用”合并图层”模式回写后，在 AutoCAD 中打开图纸，发现不同位置的译文文字重叠在一起，文字互相覆盖，无法辨识。
• 本来应在图框 A 中的译文出现在图框 B 的位置，或反之。
• 在 AutoCAD 中关闭/开启某些图层后，译文显示不正常。

可能原因：

• 合并图层模式将所有翻译文字放置到同一个图层上。由于所有文字实体共享同一个图层，当这些实体来自不同的原始位置时，它们在视觉上可能堆叠在一起。
• 如果图纸中原本使用了图层管理来控制文字的显示和隐藏（例如某些注释只在特定图层可见），合并后会丢失这种显示控制能力。
• 如果原始图纸中多个位置的文字在原始图层上坐标相近（例如多个布局中的图框标题栏有相同的坐标），合并到一个图层后就会位置碰撞。

解决方案：

1. 切换为”新建图层”模式（推荐）：
   • 对于绝大多数工程图纸翻译场景，推荐使用”新建图层”模式而非”合并图层”模式。
   • “新建图层”模式会为每个原始图层创建一个镜像翻译图层，保留了原始图层的隔离逻辑。
   • 图层可以按需单独显示或隐藏，不会出现跨图层的文字堆叠问题。
2. 如果必须使用”合并图层”模式：
   • 在回写设置中，可以配置合并图层的空间偏移量。
   • 为合并后的文字实体应用一个全局偏移（如向右偏移 100 单位），将译文与原文在空间上区分开。
   • 偏移量可以在”回写设置 → 图层 → 合并图层偏移”中配置。
3. 利用布局空间隔离：
   • 如果图纸使用布局（Layout）来组织内容，合并图层模式通常不会造成跨布局的文字重叠——因为每个布局是一个独立的图纸空间。
   • 确认您的图纸是否使用了布局。如果全部内容都在模型空间（Model Space）中，合并图层模式的堆叠风险会更高。
4. 回写后手动调整：
   • 如果已经回写完成且译文堆叠了，可以在 AutoCAD 中通过以下方式手动整理：
     • 使用 QSELECT 按图层选择所有翻译文字。
     • 使用 MOVE 命令将它们移动到一个合适的偏移位置。
     • 或者使用数据提取功能将堆叠的文字按位置分散排列。
   • 这种方法仅适用于少量堆叠场景，不适合大规模图纸的批量处理。

12.6 术语库问题

12.6.1 CSV 导入失败（格式不对）

现象描述：

• 在术语库管理页面点击”导入 CSV”后，系统提示”导入失败：格式不正确”。
• 某些术语条目导入后源语言或目标语言列为空。
• 大量术语条目没有被导入，总数远少于 CSV 中的行数。

可能原因：

1. CSV 文件的列结构不符合同文术语库要求的格式。
2. CSV 文件的编码不是 UTF-8，导致中文乱码或解析错误。
3. CSV 文件中包含了表头之外的额外行（空行、注释行等）。
4. CSV 中的分隔符不是逗号（例如使用了分号或制表符）。
5. CSV 文件中某些字段包含逗号或换行符但没有用双引号包裹。

解决方案：

1. 使用标准的 CSV 格式模板：
   • 同文术语库的 CSV 导入格式要求如下表：

   列序号	列名称	必填	说明
   1	源语言（Source）	是	中文源术语，如”混凝土”
   2	目标语言（Target）	是	英文译法，如”concrete”
   3	备注（Note）	否	额外的说明信息，如”土木工程通用术语”
   4	领域（Domain）	否	所属领域，如”结构”、”建筑”、”暖通”
   5	优先级（Priority）	否	数字越大优先级越高（默认 0）

   • CSV 第一行为表头（列名），从第二行开始为数据行。表头不是必需的，但如果存在，系统会自动跳过第一行。
2. 确保 CSV 文件编码为 UTF-8：
   • CSV 文件必须使用 UTF-8 编码保存，否则中文内容会出现乱码。
   • 检查方法：
     • 用记事本（Notepad）打开 CSV 文件。
     • 点击”文件 → 另存为”。
     • 在”保存”对话框底部的”编码”下拉框中，查看当前编码。
     • 如果不是 UTF-8，选择”UTF-8”并保存。
   • 注意：Windows 记事本的”UTF-8”选项（不带 BOM）可能会导致部分软件在读取时出问题。如果导入仍失败，尝试使用”带有 BOM 的 UTF-8”重新保存。
3. 避免 Excel 导致的编码和格式问题：
   • 直接用 Excel 编辑和保存 CSV 文件时，Excel 可能会破坏 UTF-8 编码（Excel 默认使用 ANSI 编码保存 CSV）。
   • 推荐做法：
     • 不要用 Excel 直接编辑 CSV。使用纯文本编辑器（如 Notepad++、VS Code、Sublime Text）编辑，这些编辑器可以明确指定 UTF-8 编码。
     • 如果必须用 Excel 编辑，在保存时选择”CSV UTF-8（逗号分隔）”（Excel 2019 及以上版本支持），注意不要选普通的”CSV（逗号分隔）”格式。
     • 保存后用记事本打开确认编码是否正确。
4. 清理 CSV 文件中的问题行：
   • 删除所有空行。
   • 删除所有以 # 开头的注释行（除非系统明确支持注释）。
   • 确保源语言和目标语言列没有缺失值——任何一行为空都会导致该行导入失败。
   • 如果字段值中包含逗号，必须用双引号将该字段包裹起来，例如："钢管,无缝","seamless steel pipe"。
   • 如果字段值中包含双引号，需要用两个双引号转义，例如："他说""你好""","He said ""Hello"""。
5. 分批导入大术语库：
   • 如果 CSV 文件包含数千甚至上万条术语，建议分批次导入（每批 500-1000 条）。
   • 大文件一次性导入可能会因为内存限制或超时而失败——单次导入 500 条以内通常可以稳定完成。

12.6.2 术语表不生效

此问题的排查与 12.4.3 节”术语表未生效”完全一致，请参见该节获取详细的排查步骤和解决方案。以下为快速要点回顾：

1. 确认术语条目状态为”已启用”。
2. 确认术语表已关联到当前翻译项目。
3. 确认源语言术语与图纸文字精确匹配（包括空格和标点）。
4. 确认没有项目级术语覆盖了全局术语（项目术语优先级更高）。
5. 重置术语缓存。
6. 清除已有翻译结果的条目后重新翻译（避免 CM 命中绕过术语匹配）。

12.6.3 Excel 打开后中文乱码

现象描述：

• 从同文导出的术语 CSV 文件，用 Excel 打开后，中文列显示为乱码（问号、方块、或其他不可读字符）。
• 但用记事本打开同样的文件，中文显示正常。

可能原因：

• Excel 默认以 ANSI 编码（在中文系统中通常是 GBK/GB2312）尝试打开 CSV 文件，而 CSV 文件的实际编码是 UTF-8。
• 这导致 Excel 错误地解释了 UTF-8 编码的中文内容，显示出乱码。

解决方案：

1. 使用 Excel 的”导入数据”功能（推荐方法）：
   • 不要直接双击 CSV 文件打开。
   • 打开 Excel，新建一个空白工作簿。
   • 点击”数据”选项卡 → “从文本/CSV”（在 Excel 2016+ 中）。
   • 选择 CSV 文件，点击”导入”。
   • 在弹出的预览窗口中，”文件原始格式”下拉框中选择 “65001: Unicode (UTF-8)”。
   • 确认分隔符为”逗号”。
   • 点击”加载”。
   • 此时数据应该正确显示中文。
2. 使用”另存为”转换编码：
   • 用记事本打开 CSV 文件。
   • 点击”文件 → 另存为”。
   • 在编码下拉框中选择”带有 BOM 的 UTF-8”。
   • 保存后，再用 Excel 打开这个新保存的文件。
   • BOM（字节顺序标记）是文件开头的几个特殊字节，可以告诉 Excel “这个文件是 UTF-8 编码”。添加 BOM 后，Excel 就能正确识别编码了。
3. 使用其他工具查看：
   • 对于术语库的查看和轻量编辑，推荐使用以下工具而非 Excel：
     • Notepad++（免费）：打开后会自动检测 UTF-8 编码，中文显示正常。
     • VS Code（免费）：同样自动检测编码。
     • LibreOffice Calc（免费）：在打开 CSV 的对话框中可以手动选择 UTF-8 编码。
   • 这些工具在处理 UTF-8 CSV 方面比 Excel 更加可靠。

12.6.4 全局术语表找不到

现象描述：

• 在术语库管理页面中，全局术语表列表为空。
• 之前创建的全局术语表莫名其妙消失了。
• 在其他项目中能看到的全局术语表，在当前项目中看不到。

可能原因：

1. 全局术语表文件被误删或移动了存储位置。
2. 当前 Studio 的术语库数据目录与之前不一致（例如重装系统、更换用户账户后）。
3. 全局术语表文件损坏导致无法正常加载。

解决方案：

1. 确认全局术语表的存储位置：
   • 打开 Studio，进入”设置 → 术语库”页面。
   • 查看”全局术语表存储路径”配置，确认路径指向了正确的目录。
   • 全局术语表的默认存储路径通常为：
     • %LocalAppData%\Tongwen\Glossary\ 或
     • %AppData%\Tongwen\Glossary\
   • 用文件资源管理器打开该路径，确认 .json 或 .db 术语表文件是否存在。
2. 重新关联全局术语表：
   • 如果全局术语表文件存在但 Studio 未显示：
     • 在术语库管理页面，点击”导入全局术语表”或”添加已有术语表”。
     • 浏览到全局术语表的存储路径，手动选择文件导入。
     • 导入成功后，全局术语表将重新出现在列表中。
3. 从备份中恢复：
   • 检查您是否有术语库的备份文件（CSV 导出文件或项目备份）。
   • 如果有 CSV 备份，在术语库管理页面使用”导入 CSV”功能重新导入。
   • 关于项目数据备份的更多信息，请参见 12.8.1 节。
4. 重建术语库索引：
   • 在术语库管理页面中，查找”重建术语库索引”或”刷新”按钮。
   • 重建索引后，Studio 将重新扫描存储目录并加载所有术语表。

12.7 性能与稳定性

12.7.1 Studio 启动慢

现象描述：

• 双击 Studio 图标后，需要等待很长时间（超过 30 秒甚至数分钟）才能看到主界面。
• 启动过程中，任务管理器显示 Studio 的 CPU 和磁盘使用率很高，但界面迟迟不出现。

可能原因：

1. 首次启动正在初始化系统组件（.NET 运行时预热、数据库初始化），这是正常的一次性开销。
2. Studio 启动时自动加载了大量项目数据和缓存，导致启动时间延长。
3. 系统磁盘为机械硬盘（HDD），读写速度慢。
4. 杀毒软件在 Studio 启动时进行实时扫描，拖慢了启动速度。
5. 系统中同时运行了大量其他程序，资源竞争导致 Studio 启动缓慢。

解决方案：

1. 区分首次启动与后续启动：
   • 如果是首次启动：Studio 需要进行 .NET 运行时（JIT）编译、数据库初始化、配置目录创建等一次性操作。首次启动耗时 30 秒到 2 分钟属于正常范围。第二次及之后的启动速度应显著加快（通常在 10 秒以内）。
   • 如果是每次启动都很慢：继续下面的排查步骤。
2. 将 Studio 和项目数据放置在固态硬盘（SSD）上：
   • 如果您的系统盘是机械硬盘（HDD），Studio 的启动速度会显著受影响。
   • 检查 Studio 的安装位置：如果安装在机械硬盘上，考虑重新安装到 SSD 驱动器上。
   • 同时，%LocalAppData%\Tongwen\ 目录默认位于系统盘。如果系统盘是 SSD，这不会有影响；如果系统盘是 HDD，启动速度会受影响。
3. 关闭杀毒软件的实时扫描（临时排查）：
   • 临时禁用 Windows Defender 的实时保护，再次启动 Studio 对比速度。
   • 如果速度明显变快，说明杀毒软件造成了启动延迟。将 Studio 的安装目录和 %LocalAppData%\Tongwen\ 目录添加到杀毒软件的排除列表中（详见 12.2.5 节）。
4. 清理缓存和临时文件：
   • 关闭 Studio。
   • 打开文件资源管理器，在地址栏输入 %LocalAppData%\Tongwen\Cache\。
   • 删除该目录下的所有文件（这些是缓存文件，删除不会丢失项目数据）。
   • 同样清理 %LocalAppData%\Tongwen\Temp\ 目录。
   • 重新启动 Studio，观察启动速度是否改善。
5. 减少同时打开的项目数量：
   • Studio 启动时，如果设置了”恢复上次打开的项目”，它会尝试加载之前的所有项目数据。
   • 在”设置 → 常规”中，关闭”启动时恢复上次打开的项目”选项。
   • 以后每次启动 Studio 时手动打开需要的项目。

12.7.2 大图纸处理缓慢

现象描述：

• 处理大型 DWG 文件（文件大小超过 50 MB 或包含数千个文字实体）时，提取、翻译、回写各个阶段都非常缓慢。
• 系统似乎卡住了，但实际上仍在运行（任务管理器中能看到 CPU 和内存使用）。
• 提取或回写过程中，进度条长时间不更新。

可能原因：

1. 图纸确实包含大量数据，处理时间长是正常现象。
2. Core Console 的单线程处理限制——某些版本的 AutoCAD Core Console 在处理特定操作时不能充分利用多核 CPU。
3. 系统内存不足，导致大量数据被交换到磁盘（虚拟内存），读写速度骤降。
4. 图纸中包含大量不必要的冗余数据（如未使用的块定义、图层过滤器等）。

解决方案：

1. 在 AutoCAD 中预处理图纸以减小体积：
   • 用 AutoCAD 打开大型 DWG 文件。
   • 执行以下命令序列进行彻底清理：

     PURGE → 选择"全部清理" → 确认
     AUDIT → 输入 Y → 等待修复完成
     -PURGE → 输入 R（Regapps，清理注册应用程序）→ 输入 * → 输入 N
     

   • 清理后，使用 WBLOCK 命令，选择”整个图形”，将清理后的内容导出为一个新的 DWG 文件。这个新文件的体积通常会显著减小（有时可以减少 50% 以上）。
   • 用这个清理后的文件进行提取和处理。
2. 拆分处理：
   • 如果图纸包含多个独立的区域、图框或布局，分批次处理。
   • 在 AutoCAD 中将大图纸拆分为多个小图纸（每个文件对应一个图框或一个楼层区域），分别提取和翻译。
   • 回写时，可以将译文数据按区域分别回写到对应的子图纸中。
3. 增加系统虚拟内存：
   • 打开”系统属性 → 高级 → 性能设置 → 高级 → 虚拟内存”。
   • 将虚拟内存的初始大小和最大值设置为更高值（如物理内存的 2-4 倍）。
   • 确保虚拟内存所在的磁盘有足够的可用空间。
4. 关闭非必要的后台程序：
   • 处理大图纸时，关闭浏览器、办公软件、即时通讯软件等占用内存的程序。
   • 特别是浏览器，可能占用大量内存。释放更多内存给 Core Console 和 Studio 使用。
5. 分阶段执行并保存中间结果：
   • 不要在提取完成后立即执行翻译和回写的全自动流水线。
   • 分阶段执行：提取 → 保存项目 → 手动翻译 → 保存 → 回写。
   • 每个阶段完成后，让系统”休息”一下，避免资源持续紧张。
6. 考虑硬件升级：
   • 如果频繁处理超大图纸（100 MB 以上），建议确保系统至少有 32 GB 内存和充足的 SSD 存储空间。
   • 更大的内存可以显著减少 Core Console 处理大图纸时的磁盘交换，从而提升处理速度。

12.7.3 Core Console 内存占用高

现象描述：

• 提取或回写过程中，任务管理器显示 accoreconsole.exe 进程的内存占用非常高（超过 4 GB 甚至更高）。
• 系统变得非常卡顿，其他程序响应缓慢。
• 最终系统内存耗尽，Core Console 崩溃或 Windows 强制终止进程。

可能原因：

1. 图纸非常庞大（包含数万个实体和大量复杂几何结构），Core Console 需要加载全部图纸数据到内存中。
2. 图纸中包含大量高分辨率的栅格图像或 OLE 对象。
3. 图纸中有大量复杂的填充图案（Hatch）或三维实体数据。
4. 系统中同时运行了多个 Core Console 实例（例如多个提取任务并发执行）。

解决方案：

1. 限制并发提取任务数量：
   • 不要同时启动多个提取或回写任务。每次只运行一个 Core Console 实例。
   • 如果上一个提取任务尚未完成，等待其结束后再启动下一个。
2. 清理图纸中的非必要数据：
   • 用 AutoCAD 打开大型图纸。
   • 删除或分离不必要的栅格图像（IMAGE 命令管理）。
   • 如果图纸中有三维模型数据且不需要翻译相关的三维标注，考虑将二维文字提取到一个简化后的平面图纸中。
   • 使用 PURGE 和 AUDIT 命令清理冗余数据（操作方法见 12.7.2 节）。
3. 增加系统物理内存：
   • 对于处理大图纸的工作站，建议配置充足的内存。
   • 处理 100 MB 左右的 DWG 文件，建议至少有 16 GB 物理内存。
   • 处理 200 MB 以上的 DWG 文件，建议至少有 32 GB 物理内存。
4. 在提取设置中降低处理精度（如果支持）：
   • 在 Studio 的”提取设置 → 高级”中，查找与”精度”或”详细程度”相关的选项。
   • 降低某些非关键操作的处理精度，可以适当减少内存占用。
5. 使用 AutoCAD 的”局部打开”功能：
   • 如果只需要提取图纸中特定图层或区域中的文字，可以使用 AutoCAD 的 PARTIALOAD 功能只加载需要的部分。
   • 在 AutoCAD 中用”局部打开”加载需要的图层，然后另存为一个精简的 DWG 文件用于提取。

12.7.4 频繁崩溃/闪退

现象描述：

• Studio 在使用过程中突然关闭，没有任何错误提示。
• 翻译到一半时程序崩溃，之前未保存的翻译进度丢失。
• Core Console 在提取过程中突然退出，显示”accoreconsole.exe 已停止工作”。
• Studio 频繁出现”未响应”状态。

可能原因：

1. .NET 运行时版本过旧或有 Bug——需要更新到最新补丁版本。
2. 项目数据文件损坏，导致 Studio 在读取或写入时发生异常。
3. 显卡驱动程序不兼容（Studio 使用了基于 WPF 的图形界面，依赖显卡驱动）。
4. 系统内存不稳定或硬盘存在坏道。
5. 与其他运行中的软件存在冲突（如另一个 AutoCAD 实例、其他 AutoCAD 插件）。

解决方案：

1. 更新 .NET 运行时到最新补丁版本：
   • 访问 https://dotnet.microsoft.com/en-us/download/dotnet/8.0。
   • 在页面中下载最新的 .NET 8.0 桌面运行时补丁版本（注意选择 x64）。
   • 安装后重启计算机。
   • 补丁版本可能修复了导致崩溃的已知 Bug。
2. 更新显卡驱动程序：
   • WPF 应用程序依赖显卡的硬件加速功能。过时的显卡驱动可能导致渲染异常和崩溃。
   • 访问您显卡制造商（NVIDIA、AMD 或 Intel）的官方网站，下载并安装最新的驱动程序。
   • 如果更新驱动后问题仍然存在，尝试在 Studio 的”设置 → 显示”中关闭”硬件加速”选项（如果支持），切换为软件渲染模式。
3. 检查并修复项目数据文件：
   • 关闭 Studio。
   • 打开 %LocalAppData%\Tongwen\ 目录。
   • 找到当前项目的数据库文件（通常以项目名称或 UUID 命名，扩展名为 .db 或 .sqlite）。
   • 如果有数据库管理工具，可以使用 SQLite 的完整性检查功能（PRAGMA integrity_check）来验证数据库是否损坏。
   • 如果数据库损坏，尝试恢复：在 Studio 中新建项目，将图纸重新提取。如果旧项目中有重要的翻译进度，联系技术支持寻求数据恢复帮助。
4. 在干净启动环境下测试：
   • 按 Win + R，输入 msconfig，打开系统配置。
   • 在”服务”选项卡中，勾选”隐藏所有 Microsoft 服务”，然后点击”全部禁用”。
   • 在”启动”选项卡中，打开任务管理器，禁用所有启动项。
   • 重启计算机后，只运行 Studio，测试是否仍然崩溃。
   • 如果崩溃消失，说明是某个其他软件与 Studio 冲突。逐个启用服务/启动项来定位冲突源。
5. 查看 Windows 事件查看器获取崩溃信息：
   • 按 Win + R，输入 eventvwr.msc，打开事件查看器。
   • 导航到”Windows 日志 → 应用程序”。
   • 在右侧点击”筛选当前日志”，筛选”错误”和”严重”级别的事件。
   • 查找来源为”.NET Runtime”或”Application Error”且与 Studio 相关的错误事件。
   • 记录事件中的”异常代码”和”故障模块”信息，这些信息对技术支持排查崩溃原因至关重要。
6. 收集崩溃日志并联系技术支持：
   • 打开 %LocalAppData%\Tongwen\Logs\ 目录。
   • 按修改时间排序，找到崩溃时间点前后生成的日志文件。
   • 将日志文件、Windows 事件查看器中的错误信息以及崩溃时的操作步骤一同提供给技术支持（联系方式见 12.12 节）。

12.8 数据与存储

12.8.1 项目数据如何备份

项目数据（包括翻译条目、译文、术语关联、CM 记录等）存储在本地，定期备份可以有效防止数据丢失。以下是推荐备份方法：

方法一：复制整个 Tongwen 数据目录（完整备份）

1. 关闭 Studio。
2. 打开文件资源管理器，在地址栏输入 %LocalAppData%\Tongwen\ 并回车。
3. 复制整个 Tongwen 文件夹。
4. 将复件粘贴到备份位置（如移动硬盘、网络驱动器或云存储同步目录）。
5. 为备份文件夹添加日期标识，方便识别，如：Tongwen_Backup_20260722。

方法二：在 Studio 中使用项目导出功能

1. 打开 Studio，进入项目管理页面。
2. 选中需要备份的项目，右键点击。
3. 选择”导出项目”（如果支持），在弹出的对话框中选择导出格式和保存路径。
4. 导出的文件通常包含项目的全部数据，可以直接在其他 Studio 实例中导入恢复。

方法三：利用云存储实时同步（推荐）

1. 确保 %LocalAppData%\Tongwen\ 目录被包含在您的云存储同步目录中（如 OneDrive、坚果云等）。
2. 如果云存储客户端的默认同步路径不同，可以使用符号链接（mklink）或第三方同步工具（如 FreeFileSync）定期同步该目录。
3. 注意：同步应在 Studio 关闭时进行，避免文件锁定冲突。

方法四：导出 CSV/Excel 格式的翻译数据

1. 在翻译工作区中，使用导出功能将翻译条目导出为 CSV 或 Excel 格式。
2. 这仅备份了翻译文本数据，不包括项目配置和术语关联信息，但文本数据是最核心的资产。

备份频率建议：

• 大型项目（1000+ 条目）：建议每天备份一次。
• 进行重大操作前（如回写、批量删除）：操作前备份一次。
• 日常小项目：每周备份一次即可。

12.8.2 误删项目后如何恢复

现象描述：

• 在 Studio 的项目管理页面中，误删了一个正在进行的翻译项目。
• 项目中包含大量已完成的人工翻译工作，恢复需求迫切。

解决方案：

1. 首先检查 Studio 中的”回收站”或”最近删除”功能：
   • 在项目管理页面上，查找”回收站”、”已删除项目”或”最近删除”标签页或筛选选项。
   • 如果存在，找到被误删的项目，点击”恢复”。
   • 并非所有版本的 Studio 都支持此功能，如果没有，继续下一步。
2. 检查 Windows 回收站：
   • 打开桌面上的”回收站”。
   • 搜索包含项目名称或 “Tongwen” 字样的文件。
   • Studio 在删除项目时可能会将数据库文件移动到回收站。如果找到了相关文件，右键选择”还原”。
   • 还原后，重新启动 Studio，查看项目是否重新出现。
3. 从备份中恢复（最可靠的方法）：
   • 找到最近的 %LocalAppData%\Tongwen\ 备份目录。
   • 关闭 Studio。
   • 将备份目录中的项目数据文件复制到当前的 %LocalAppData%\Tongwen\ 目录中，覆盖现有文件。
   • 重新启动 Studio，检查项目是否恢复。
   • 如果之前使用了云存储同步，检查云存储的版本历史功能，可能可以恢复被删除前的版本。
4. 使用文件恢复工具（最后的手段）：
   • 如果以上方法都不可行，可以尝试使用文件恢复软件（如 Recuva、EaseUS Data Recovery 等）扫描 %LocalAppData%\Tongwen\ 所在磁盘。
   • 恢复被删除的数据库文件（.db 或 .sqlite 扩展名）。
   • 注意：删除后使用恢复工具的成功率随着磁盘写入操作的增多而降低，因此发现误删后应尽快停止使用电脑并立即执行恢复。
5. 防止再次发生：
   • 删除项目前养成备份的习惯。
   • 在 Studio 中，如果支持，调整删除确认对话框的敏感度（如增加二次确认步骤）。
   • 定期执行数据备份（见 12.8.1 节）。

12.8.3 磁盘空间不足

现象描述：

• 提取或回写过程中弹出错误提示”磁盘空间不足”。
• Studio 运行缓慢，频繁卡顿。
• 系统通知区域提示 C 盘空间不足。

可能原因：

1. 系统盘（通常是 C 盘）可用空间极少。
2. %LocalAppData%\Tongwen\ 目录中的日志、缓存和临时文件长时间未清理，占用了大量空间。
3. 提取和回写过程中生成的中间文件占用大量临时空间。

解决方案：

1. 清理 Tongwen 的临时文件：
   • 打开文件资源管理器，在地址栏输入 %LocalAppData%\Tongwen\Temp\。
   • 删除该目录下的所有文件和文件夹。这些是处理过程中产生的临时文件，可以安全删除。
   • 同样清理 %LocalAppData%\Tongwen\Cache\ 目录（缓存文件，删除后会重新生成）。
2. 清理日志文件：
   • 打开 %LocalAppData%\Tongwen\Logs\ 目录。
   • 日志文件随时间累积可能会占用数 GB 空间。
   • 按文件大小排序，删除较早日期的日志文件（保留最近一个月的日志即可）。
   • 或者删除该目录下的全部日志文件（除非您正在排查问题需要保留日志）。
3. 清理 Windows 系统临时文件：
   • 按 Win + R，输入 cleanmgr（磁盘清理），选择 C 盘。
   • 勾选”临时文件”、”回收站”等选项，执行清理。
   • 此外，可以打开”设置 → 系统 → 存储”，使用”存储感知”功能自动清理临时文件。
4. 更改 Tongwen 的数据存储位置（如果支持）：
   • 在 Studio 的”设置 → 常规 → 数据目录”中，将数据存储路径从默认的 %LocalAppData%\Tongwen\ 更改到另一个有更多可用空间的磁盘（如 D 盘）。
   • 更改后，Studio 会将新数据写入新的路径。但已有的项目数据仍保留在原路径——您可以手动将它们移动到新路径。
5. 扩展系统盘空间：
   • 如果 C 盘持续空间紧张，考虑使用磁盘管理工具扩展 C 盘分区，或者将大型个人文件（视频、照片、文档）迁移到其他磁盘。

12.8.4 临时文件清理

临时文件的位置和清理方法：

同文在工作过程中会在多个位置生成临时文件，以下是完整的清理指南：

手动清理步骤：

1. 关闭 Studio 和所有 AutoCAD 实例。
2. 打开文件资源管理器，在地址栏分别输入上述路径。
3. 删除对应目录中的文件和子文件夹。
4. 重新启动 Studio，系统会自动创建必要的目录结构。

自动清理设置（如果 Studio 支持）：

• 在 Studio 的”设置 → 常规 → 存储”中，查看是否有”自动清理临时文件”或”日志保留天数”等选项。
• 如果支持，启用自动清理并设置合适的保留天数（如 7 天），系统将自动管理临时文件。

12.9 授权与网络

12.9.1 API Key 如何获取

获取 DeepSeek API Key 的完整步骤：

1. 注册 DeepSeek 平台账号：
   • 打开浏览器，访问 https://platform.deepseek.com。
   • 点击”注册”或”Sign Up”。
   • 使用邮箱或手机号完成注册流程。如果已有账号，直接登录即可。
2. 进入 API Keys 管理页面：
   • 登录后，在左侧导航栏或顶部菜单中找到”API Keys”或”密钥管理”。
   • 点击进入 API Keys 管理页面。
3. 创建新的 API Key：
   • 点击”创建 API Key”或”Create API Key”按钮。
   • 为这个 Key 设置一个名称（方便您区分不同用途的 Key，如”Tongwen-Studio”）。
   • 点击”创建”或”Create”。
   • 重要：创建完成后，页面会显示 API Key 的完整字符串。立即复制并保存——关闭页面后，出于安全原因，平台通常不会再显示完整的 API Key。如果丢失了，只能重新创建一个新的。
4. 将 API Key 配置到同文 Studio 中：
   • 打开同文 Studio。
   • 进入”设置 → 翻译引擎”页面。
   • 在”DeepSeek API Key”输入框中，粘贴刚才复制的 API Key。
   • 点击”测试连接”按钮。
   • 如果测试成功，会显示连接成功的信息和当前账户的余额/额度情况。
   • 如果测试失败，请参考 12.4.1 节”翻译引擎连接失败”进行排查。
5. 安全注意事项：
   • API Key 等同于您账户的密码，请勿分享给他人。
   • 不要在公开场合（如截图中、视频录制中、群聊消息中）暴露 API Key。
   • 如果怀疑 API Key 已泄露，请立即在 DeepSeek 平台上删除该 Key 并重新创建。

12.9.2 DeepSeek API 额度不足

现象描述：

• 翻译时提示”API 额度不足”或”账户余额不足”。
• 测试连接时显示余额为 0 或负数。
• 翻译请求返回 HTTP 402（Payment Required）或类似错误。

解决方案：

1. 查看账户余额：
   • 在 Studio 的”设置 → 翻译引擎”页面中，点击”测试连接”按钮。
   • 测试成功后，通常会在结果信息中显示当前的余额或可用额度。
   • 也可以在浏览器中登录 DeepSeek 平台，在”账户”或”Billing”页面查看详细余额和用量统计。
2. 进行充值：
   • 登录 DeepSeek 平台。
   • 进入”充值”或”Top Up”页面。
   • 选择适合的充值金额和支付方式（支持支付宝、微信支付等常见方式）。
   • 完成支付后，额度通常在几分钟内到账。
3. 控制 API 消耗：
   • 如果您发现 API 额度消耗过快，可以采取以下措施降低消耗：
     • 使用 DeepSeek Flash 模式代替 Pro 模式——Flash 模式的价格显著低于 Pro 模式。
     • 充分利用术语库和上下文记忆（CM）——当术语匹配或 CM 命中时，系统不会调用 API，从而节省额度。
     • 翻译前先在术语库中配置好所有常见术语，让术语匹配承担更多翻译工作，减少对大模型的依赖。
     • 对于不需要翻译的文本（如图框中的纯数字编号），在提取阶段使用过滤规则排除。
   • 在 Studio 的”设置 → 翻译引擎”中，可以配置”仅当无 TM/术语命中时才使用 API”的选项，将大模型翻译作为兜底而非主力。
4. 监控 API 使用情况：
   • 定期在 DeepSeek 平台的后台中查看 API 调用次数和消耗趋势。
   • 设置平台提供的”用量告警”功能（如果支持），当余额低于某个阈值时收到通知。

12.9.3 离线环境能否使用

能否离线使用——分功能说明：

离线环境的推荐工作流：

1. 在联网环境中完成以下准备工作：
   • 配置并测试 DeepSeek API Key。
   • 积累上下文记忆（CM）——通过翻译一些典型图纸，让系统学习正确的翻译模式。
   • 配置术语库——导入所有项目相关的术语表。
   • 将常用的翻译引擎切换为 Mock 引擎（准备离线演示或测试）。
2. 在离线环境中可以执行的操作：
   • 创建和管理项目。
   • 提取图纸中的文字。
   • 使用 Mock 引擎进行流程验证（但不会生成真实译文）。
   • 编辑和维护术语库。
   • 执行质量检查。
   • 回写图纸（前提是已经有译文——如果之前在线翻译过并保存了译文，离线时可以回写）。
   • 利用已有的 CM 记录对新文本进行填充。
3. 限制：
   • 离线时无法执行新的翻译请求（无论 DeepSeek Flash 还是 Pro 都需要联网）。
   • 离线时 CM 不会自动更新（因为没有新翻译产生新的记忆记录）。

12.9.4 网络代理配置

如果您需要通过代理服务器访问互联网（常见于企业内网环境或使用科学上网工具的场景），同文 Studio 支持配置 HTTP/HTTPS 代理。

代理配置步骤：

1. 打开代理设置：
   • 在 Studio 中，进入”设置 → 网络”页面。
   • 找到”代理设置”或”HTTP 代理”配置区域。
2. 配置代理类型和地址：
   • 选择代理类型：通常为”HTTP”或”SOCKS5”。
   • 填写代理服务器地址：如 127.0.0.1 或代理服务器的具体 IP 地址。
   • 填写端口号：如 8080、1080、7890 等。
   • 如果代理需要身份验证，填写用户名和密码。
3. 代理格式示例：
   • HTTP 代理：http://192.168.1.100:8080
   • SOCKS5 代理：socks5://127.0.0.1:1080
   • 带认证的代理：http://username:password@192.168.1.100:8080
4. 测试代理是否生效：
   • 保存代理设置后，进入”设置 → 翻译引擎”页面。
   • 点击”测试连接”按钮。
   • 如果连接成功，说明代理配置正确且 API 可达。
   • 如果连接失败，检查代理地址、端口、代理服务是否正常运行。
5. 使用系统代理设置（自动模式）：
   • 如果您在 Windows 的”设置 → 网络和 Internet → 代理”中已经配置了系统级代理，Studio 通常会自动使用系统代理。
   • 如果自动检测不生效，可以在 Studio 的代理设置中手动选择”使用系统代理”选项。

6. 常见代理问题排查：

   问题	可能原因	解决方法
   配置代理后仍无法连接	代理地址或端口错误	核对代理软件中显示的监听地址和端口
   代理连接超时	代理服务未启动或网络不通	确认代理软件正在运行；测试代理端口是否监听
   证书错误	代理使用自签证书进行 HTTPS 拦截	在代理设置中启用”忽略 SSL 证书验证”（不推荐用于生产环境）
   身份验证失败	用户名/密码错误	确认认证凭据；如代理不需要认证则清空用户名密码字段

12.10 Pipe/管道通信问题

12.10.1 什么是 Pipe（命名管道）

Pipe（Named Pipe，命名管道）是同文 Studio 与 AutoCAD Core Console 之间进行进程间通信（IPC）的核心机制。

在同文的工作流中，当 Studio 发起一次图纸提取或回写操作时：

1. Studio 启动一个内部的 Sidecar/Pipe 服务，创建一个命名管道并进入监听状态。
2. Studio 启动 Core Console（accoreconsole.exe），并传递管道名称作为参数。
3. Core Console 加载同文的 AutoCAD 插件，插件连接到这个命名管道。
4. 提取的数据通过管道传输——Core Console 将提取结果序列化后通过管道发送给 Sidecar 服务。
5. Sidecar 服务接收数据后存入数据库，翻译工作区即可展示提取结果。

理解这个机制对排查 Pipe 相关问题非常有帮助：如果 Pipe 不通，Studio 和 Core Console 之间就无法交换数据，提取和回写都会失败。

12.10.2 Pipe 无法启动

现象描述：

• Studio 启动后，在”设置 → 服务状态”页面中，Pipe 服务状态显示”停止”或”启动失败”。
• 尝试手动点击”启动”按钮后，状态短暂变为”启动中”然后回到”停止”。

可能原因：

1. Pipe 服务程序文件缺失或损坏（被误删或杀毒软件拦截）。
2. Pipe 所使用的端口或管道名称已被其他程序占用。
3. Pipe 服务需要的 .NET 运行时未正确安装。
4. 用户权限不足——创建命名管道需要特定权限级别。
5. Pipe 服务的配置文件损坏，导致无法读取正确的配置。

解决方案：

1. 以管理员身份运行 Studio：
   • 右键 Studio 快捷方式 → “以管理员身份运行”。
   • 管理员权限可以确保 Pipe 服务有足够权限创建命名管道。
   • 重新检查”服务状态”页面，查看 Pipe 是否正常启动。
2. 验证 Pipe 服务程序完整性：
   • 浏览到同文的安装目录，找到 Sidecar 或 Pipe 子目录。
   • 确认 Tongwen.PipeService.exe（或类似名称）文件存在。
   • 如果文件缺失，重新运行同文安装包并选择”修复”安装。
3. 检查端口/管道名称冲突：
   • 打开命令提示符（管理员模式），输入：

     netstat -ano | findstr <管道相关端口号>
     

   • 注意：命名管道不一定占用 TCP 端口。如果同文使用的是 Windows 命名管道（Named Pipe），需要检查是否有其他程序使用了相同的管道名称。
   • 在 Studio 的”设置 → 服务 → Pipe”中，可以尝试更改管道名称（添加自定义后缀）。
   • 更改后点击”启动”，看是否能成功。
4. 查看 Pipe 服务日志：
   • 打开 %LocalAppData%\Tongwen\Logs\ 目录。
   • 查找 pipe_*.log 或 sidecar_*.log 文件。
   • 打开最近的日志文件，搜索 “Error”、”Failed”、”Exception”，获取具体的启动失败原因。
5. 手动启动 Pipe 服务（命令行）：
   • 打开命令提示符（管理员模式），切换目录到 Pipe 服务程序所在位置。
   • 执行 Tongwen.PipeService.exe（或对应的可执行文件名）。
   • 观察命令行输出，通常会显示启动失败的具体错误信息。

12.10.3 Pipe 连接断开

现象描述：

• 提取过程中，进度条中途停止，并报错”Pipe 连接断开”或”TW_PIPE_DISCONNECTED”。
• Core Console 仍在任务管理器中显示为运行状态，但数据不再传输。
• 翻译工作区数据显示不完整（部分文字未提取到，且提取过程异常终止）。

可能原因：

1. Core Console 在处理图纸时崩溃，导致连接被动断开。
2. 防火墙或安全软件在数据传输过程中阻止了连接。
3. Pipe 服务所在进程的 CPU 或内存资源被耗尽，导致服务无响应而超时断开。

解决方案：

1. 重试操作：
   • TW_PIPE_DISCONNECTED 是一个可重试的错误。
   • 在收到此错误后，先确保所有相关进程（Core Console、Pipe 服务）都已退出。
   • 重新启动 Studio，再次执行提取操作。
2. 检查 Core Console 是否崩溃：
   • 在错误发生后，打开 Windows 事件查看器（eventvwr.msc）。
   • 导航到”Windows 日志 → 应用程序”。
   • 查找来源为”Application Error”且涉及 accoreconsole.exe 的事件。
   • 如果有崩溃事件，按照 12.7.4 节的方法排查 Core Console 稳定性问题。
3. 延长 Pipe 超时配置：
   • 在 Studio 的”设置 → 服务 → Pipe 高级设置”中，查找”连接超时”和”心跳间隔”配置项。
   • 将超时时间从默认值（如 30 秒）延长到更大的值（如 120 秒）。
   • 将心跳间隔适当调小（如从 10 秒调为 5 秒），让 Studio 更频繁地检测连接状态。
   • 这可以避免因短暂的处理延迟而误判为连接断开。
4. 禁用防火墙/安全软件（临时测试）：
   • 临时禁用 Windows Defender 防火墙和任何第三方安全软件。
   • 执行一次提取操作，看 Pipe 连接是否保持稳定。
   • 如果稳定，说明是安全软件干扰了通信——将 Pipe 服务添加为例外（见 12.2.5 节）。

12.10.4 Pipe 状态一直显示”监听中”

现象描述：

• 在 Studio 的”设置 → 服务状态”页面中，Pipe 服务状态一直显示为”监听中”（或”等待连接”）。
• 启动提取后，Core Console 似乎启动了但一直没有连接到管道。
• 最终提取超时失败，Pipe 始终没有收到数据。

可能原因：

1. Core Console 启动失败（虽然 Studio 尝试启动了它，但实际上进程未能成功运行）。
2. Core Console 成功启动了，但插件加载失败，导致插件未能连接到管道。
3. Core Console 使用的管道名称与 Studio 创建的管道名称不一致（配置不匹配）。
4. Core Console 启动后卡在某个加载步骤（如缺少字体文件、遇到代理对象对话框等），无法执行到连接管道的步骤。

解决方案：

1. 确认 Core Console 是否真正在运行：
   • 在 Studio 显示”监听中”时，打开任务管理器。
   • 在”详细信息”选项卡中查找 accoreconsole.exe 进程。
   • 如果找不到该进程，说明 Core Console 启动失败——参见 12.3.4 节排查启动问题。
   • 如果找到了该进程但 CPU 使用率持续为 0%，说明 Core Console 卡住了——参见下面第 4 点。
2. 检查插件是否正常加载：
   • 打开 AutoCAD 图形界面版本，手动加载同文插件（使用 NETLOAD 命令），确认插件能够正常加载。
   • 如果图形界面版能正常加载，Core Console 版也应该能加载——问题可能在于 Core Console 的启动参数或环境变量。
3. 验证管道名称一致性：
   • 在 Studio 的”设置 → 服务 → Pipe”中，查看当前的管道名称。
   • 在”设置 → CAD 环境 → Core Console 启动参数”中，查看传递给 Core Console 的管道名称参数是否正确。
   • 如果手动修改过管道名称，确保两处的名称一致。
4. 手动终止卡住的 Core Console 并重试：
   • 在任务管理器中找到 accoreconsole.exe 进程，右键”结束任务”。
   • 回到 Studio，点击”终止提取”（如果有此按钮）。
   • 重新启动提取流程。
   • 如果每次都卡在同一个位置，可能是该图纸中有触发 Core Console 卡死的问题实体——在 AutoCAD 中打开该图纸，执行 AUDIT 和 PURGE 修复后重试。
5. 增加 Core Console 启动等待时间：
   • 在 Studio 的”设置 → 提取设置 → 高级”中，查找”Core Console 启动等待时间”选项。
   • 将默认值从（例如）30 秒增加到 120 秒。在某些配置较慢的计算机上，Core Console 的启动和插件加载可能需要更长的时间。

12.10.5 TW_PIPE_TIMEOUT 错误

错误含义：Pipe 请求超时。Studio 通过 Pipe 向 Core Console 发送了一个请求，但在指定的超时时间内没有收到响应。

常见触发场景：

• 提取大量文字时，Core Console 处理时间超过了 Pipe 超时阈值。
• Core Console 在执行某个耗时操作时（如解析复杂图纸），无法及时响应心跳检测。
• 系统负载过高，导致 Pipe 消息处理延迟。

解决方案：

1. 该错误通常是可重试的。关闭当前提取任务，重启 Studio，重试提取。
2. 在”设置 → 服务 → Pipe 高级设置”中，增加”请求超时”时间。
3. 确保系统资源充足（参考 12.7.3 节）。
4. 如果频繁触发且重试无效，参见 12.10.3 节的全面排查方案。

12.10.6 TW_PIPE_DISCONNECTED 错误

错误含义：管道连接断开。Core Console 与 Studio 之间的 Pipe 连接意外中断。

常见触发场景：

• Core Console 崩溃或异常退出。
• 网络连接的 Pipe 配置下网络波动。
• 防火墙在传输过程中关闭了连接。

解决方案：

1. 该错误通常是可重试的。重试提取操作。
2. 检查 Core Console 稳定性（参考 12.7.4 节和 12.3.4 节）。
3. 检查防火墙设置（参考 12.2.5 节）。
4. 如果频繁出现，参见 12.10.3 节的全面排查方案。

12.10.7 TW_AUTOCAD_BUSY 错误

错误含义：CAD 正忙。Core Console 当前正在执行其他命令或处理中，无法立即响应 Pipe 请求。

常见触发场景：

• 上一个提取或回写操作尚未完全完成，新的指令已发出。
• 同一个 Core Console 实例被多个操作同时调用（并发冲突）。
• Core Console 正在处理复杂操作（如重生成图形），无法处理外部请求。

解决方案：

1. 该错误通常是可重试的。等待几十秒后重试即可。
2. 确保单任务运行：一次只运行一个提取或回写任务，不要并发操作。
3. 如果上一个操作已完成但 Core Console 进程仍在后台残留，手动在任务管理器中结束 accoreconsole.exe 进程后重试。
4. 在 Studio 的”设置 → 提取设置”中，增加”操作间隔”时间——在多任务场景下给 Core Console 足够的空闲窗口完成上一个操作。

12.11 错误代码速查

当同文在运行中遇到错误时，会在日志、状态信息或错误提示中显示以 TW_ 为前缀的错误代码。以下是所有错误代码的完整速查表。

12.11.1 TW_PIPE_PROTOCOL_MISMATCH

12.11.2 TW_PIPE_TIMEOUT

12.11.3 TW_PIPE_DISCONNECTED

12.11.4 TW_PIPE_BAD_MESSAGE

12.11.5 TW_AUTOCAD_BUSY

12.11.6 TW_EXTRACT_FAILED

12.11.7 TW_WRITEBACK_FAILED

12.11.8 TW_ENTITY_NOT_FOUND

12.12 问题报告与技术支持

12.12.1 在联系技术支持之前

在联系技术支持之前，请先完成以下自查步骤——这不仅能帮助您更快定位问题，也能让技术团队更高效地帮您解决问题：

1. 确认您已阅读本章对应的问题章节。大多数常见问题的解决方案已在上述章节中详细列明。
2. 确认您使用的是最新版本的同文。在 Studio 中，进入”帮助 → 关于”查看当前版本号，然后访问产品官网确认是否有更新的版本可用。
3. 重启 Studio 和计算机。许多临时性的问题可以通过简单的重启解决。
4. 收集必要的诊断信息（见 12.12.2 节）。完整的问题描述、日志文件和操作步骤是技术团队定位问题的关键依据。

12.12.2 日志文件位置和收集方法

日志文件的位置：

快速打开日志目录的方法：

1. 按 Win + R 打开”运行”对话框。
2. 输入 %LocalAppData%\Tongwen\Logs\，回车。
3. 这将直接打开日志文件夹。

打包日志文件提交给技术支持：

1. 关闭 Studio。
2. 打开日志目录（见上文）。
3. 按修改时间排序，找到与问题发生时间对应的日志文件（通常文件名或修改时间可以帮助定位）。
4. 将这些日志文件打包为一个 ZIP 压缩文件。
5. 不要只发送单个日志文件——通常问题涉及多个组件的交互，完整的日志集合更有价值。

12.12.3 问题报告模板

请使用以下模板向技术支持团队提交问题报告。信息越完整，问题定位和解决越迅速。

问题报告模板

基本信息

• 报告人姓名/单位：
• 联系方式（邮箱/电话）：
• 报告日期：

环境信息

• 同文版本号（在 Studio 中：帮助 → 关于）：
• 操作系统版本（Win + R → 输入 winver）：
• AutoCAD 版本（在 AutoCAD 中：ABOUT 命令）：
• .NET 运行时版本（PowerShell → dotnet --list-runtimes）：
• 计算机硬件配置（CPU、内存、硬盘类型）：
• 是否使用管理员身份运行：

问题描述

• 问题发生的具体时间和操作步骤（越详细越好）：
  • 第 1 步：
  • 第 2 步：
  • 第 3 步：
  • （以此类推）
• 期望的结果（您预期会发生什么）：
• 实际的结果（实际发生了什么）：
• 问题是否可重现（每次都会发生？还是偶尔发生？）：

错误信息

• 屏幕上显示的错误提示文字（截图最佳）：
• 错误代码（如有 TW_ 前缀的错误代码）：
• 该问题是否在重启软件/计算机后仍然存在：

涉及的图纸信息（如适用）

• 图纸文件大小：
• 图纸中包含的文字实体数量（估算）：
• 图纸格式（DWG 版本年份，如 DWG 2018）：
• 是否包含外部参照（Xref）、块属性、代理对象等特殊内容：

已尝试的排查步骤

• 您已经尝试了哪些解决方法？结果如何？
  • （例如：重启了 Studio、修复安装了 .NET 运行时、以管理员身份运行等）

附件

• 日志文件（已打包为 ZIP）
• 错误截图
• 问题相关的 DWG 文件（如有必要且文件不涉密）

提交方式：

• 通过产品官网的联系方式提交：https://shandianweihu.com/
• 如果官网提供了工单系统、在线客服或邮件地址，请通过对应渠道提交。

12.12.4 技术支持联系方式指引

• 产品官网：https://shandianweihu.com/
• 在官网上您可以找到：
  • 在线客服入口
  • 技术支持邮箱
  • 用户社区/论坛（如果提供）
  • 最新版本下载链接
  • 产品更新公告
• 请优先通过官网提供的正式支持渠道提交问题，以确保您的问题被正确记录和追踪。

12.12.5 调试模式开启方法

如果您被技术支持人员要求开启调试模式以提供更详细的诊断信息，请按以下步骤操作：

1. 关闭 Studio。

2. 找到配置文件：
   • 打开 %LocalAppData%\Tongwen\ 目录。
   • 查找 settings.json、config.json 或 appsettings.json 配置文件。
3. 启用调试模式：
   • 用记事本（或任意文本编辑器）打开配置文件。
   • 查找 "LogLevel" 或 "Debug" 配置项。
   • 将日志级别从默认的 "Information"（或 "Info"）修改为 "Debug" 或 "Verbose"（详细）。
   • 例如："LogLevel": "Debug"
   • 如果有单独的 "EnableDiagnosticMode" 开关，将其设置为 true。

4. 保存配置文件并重启 Studio。

5. 重现问题：
   • 重新执行导致问题的操作步骤。
   • 调试模式下，系统会记录更详细的日志信息。
6. 收集调试日志：
   • 操作完成后，打开 %LocalAppData%\Tongwen\Logs\ 目录。
   • 找到在调试模式期间生成的日志文件（按时间戳排序，最近的文件即为调试日志）。
   • 将这些日志文件打包发送给技术支持人员。
7. 关闭调试模式：
   • 问题排查完成后，建议将日志级别恢复为 "Information"，以避免生成过多的日志文件占用磁盘空间。

注意：调试模式会产生大量日志文件，磁盘空间占用会显著增加。仅在技术支持人员要求时开启，排查完毕后请及时关闭。

（第12章完）