同文 Tongwen — 用户使用手册

产品名称：同文（Tongwen CAD Suite）
适用范围：P1/P1.5 已交付工作流；具体安装包版本、已验证宿主与已知限制以稳定发行说明为准。

定位：面向工程领域的无损 CAD/BIM 图纸翻译套件
状态：Active；最后核对 2026-08-28

1. 产品简介

同文是一套面向 AutoCAD 的 CAD 图纸翻译工具。它从 DWG/DXF 图纸中提取文本，结合术语、翻译记忆和人工校对生成译文，并按用户确认的写回策略输出结果。默认的安全工作流应保留源图或输出副本；插件端的直接写回会作用于当前 DWG，必须先保存并确认备份与写回范围。

核心特性

• 无损提取：保留图层、坐标、字体、块属性、尺寸标注等全部 CAD 元数据
• 术语约束翻译：基于术语表（CSV）和翻译记忆辅助大模型，保证专业术语翻译一致性
• 人工校对工作台：多标签页表格化双语对照、内联编辑、批量审批
• 质量检查：自动检测术语冲突、文本溢出等风险
• 非破坏性回写：译文写入新图层或新文件，原始数据不受影响
• AutoCAD 插件：侧边面板直接管理项目关联和文字提取，工作台在 AutoCAD 中校对翻译
• 语言感知回写：切换目标语言时智能匹配已有译文，不匹配则自动清空
• 本地优先与可控联网：会话、术语表和本机配置保存在本地；使用在线翻译 Provider、更新检查或网络诊断时需要网络连接。处理受限图纸前，请按组织的数据策略确认可使用的 Provider 和内容范围

当前版本（P1/P1.5）功能状态

2. 安装与启动

系统要求

安装步骤

1. 运行安装包 同文-{版本号}.msi，建议以管理员权限安装
2. 安装目录默认为 C:\Program Files\Tongwen\
3. 安装包内置示例术语表，新建安装后术语库页面会自动包含 3 条示例术语
4. 安装完成后，桌面和开始菜单均会生成快捷方式

交互式安装会检查 PowerShell 7。缺失、版本过低或 PATH 不可解析时，安装器会提示安装或修复方式，但不会阻断主程序安装；只有独立网络诊断中的 Windows 防火墙、Defender 和事件日志采集需要该运行时。Windows PowerShell 5.1 不受支持。

启动与退出

• 双击桌面快捷方式 同文 启动
• 启动后，程序自动在后台启动命名管道服务，等待 AutoCAD 连接
• 关闭窗口即可退出，退出时自动停止管道服务并保存日志

数据存储位置

3. 界面概览

同文工作台分为四个主要页面，通过左侧深色侧边栏导航：

4. 首页 — 项目管理

4.1 项目卡片

首页以卡片形式列出所有项目，每个卡片显示：

右侧操作按钮：

• ⚙️ 项目设置 — 打开右侧抽屉，编辑项目信息、语言对、术语表引用
• 🗑️ 删除 — 删除项目及其所有数据

点击项目卡片可展开图纸列表。

4.2 项目设置（右侧抽屉）

点击项目卡片上的 ⚙️ 按钮，从右侧滑入项目设置面板：

• 基础信息：修改项目名称和描述
• 语言对：设置源语言和目标语言
• 项目级术语表：
  • 「已引用 (N)」区域：查看和管理当前引用的术语表，点击 ✕ 移除
  • 「从术语库添加」区域：点击 ➕ 引用 将术语表添加到本项目
  • 新增翻译任务时，图纸将自动继承项目当前的术语表引用
• 图纸会话文件：查看项目内所有图纸和回写记录
• 点击 保存项目设置 生效

4.3 新建项目

点击 + 新建项目 按钮，弹出新建项目对话框：

1. 输入项目名称（必填）
2. 输入项目描述（可选）
3. 选择源语言和目标语言
4. 勾选需要引用的术语表（全局术语表默认预选）
5. 点击「创建项目」完成

5. 首页 — 提取图纸文字

5.1 操作流程

1. 展开一个项目，选择一张图纸或点击 + 新建翻译任务
2. 在弹出对话框中双击选择 DWG 或 DXF 文件
3. 选择提取模式——Core Console 模式（当前唯一可用模式）
4. 程序启动后台提取，底部显示提取进度条

5.2 提取进度

提取进度条紧贴页面内容区下方，显示：

进度条右侧有 ✕ 终止提取 按钮，点击后强制结束 Core Console 进程并取消提取。

总超时时间：5 分钟。超时未完成将自动终止并报错。

5.3 提取完成

提取成功后在页面顶部显示绿色提示框，列出提取的文本对象数量。点击 查看结果 → 进入翻译工作区。会话文件自动保存到 文档\Tongwen\projects\。

5.4 提取失败处理

常见失败原因：

• 未安装 AutoCAD 2026
• Core Console 启动失败
• DWG 文件损坏或受保护
• 提取超时（超过 5 分钟）

失败时红色提示框会显示错误原因。可查看 %LocalAppData%\Tongwen\logs\ 中的日志了解详情。

5.5 AutoCAD 插件模式 — 侧边面板提取

除客户端外，同文还提供 AutoCAD 插件 GUI 模式——在 AutoCAD 内部直接操作，无需离开 CAD 环境。

侧边面板通过 TW_SHOW_PANEL 命令打开（插件加载后自动显示），固定在 AutoCAD 窗口左侧。面板包含三个功能区：

提取设置：

• ☑ 不提取图框文字 — 勾选后整图/框选提取跳过图框（BlockReference）内的属性文字

项目匹配：

• 单匹配时显示绿色已关联状态
• 多匹配时显示 "还有 N 个项目也包含此图纸"，点击展开候选列表切换

提取流程：

打开 DWG → 侧边栏自动匹配项目 → 点击「整图提取」或「框选提取」
  → 面板显示进度（正在收集文字实体... 耗时: 1.2s）
  → 提取完成弹出 MessageBox → 自动打开翻译工作台

详情参见下方第 7～11 节的翻译工作区使用说明（插件端和客户端界面一致）。

6. 首页 — 管道服务与会话管理

6.1 IPC 通信管道服务

页面最底部显示命名管道的状态和地址，始终可见：

• 使用 启动 和 停止 按钮手动控制
• 正常使用时服务自动运行，一般无需手动操作

7. 翻译工作区 — 整体布局

翻译工作区是同文的核心页面，布局如下：

┌─ 文件标签页 ───────────────────────────────────────────────────┐
│ ● 项目名/drawing.dwg (42)  ✕  │ ● 项目名/drawing2.dwg (18)  ✕ │
├─ 工具栏第一行 ───────────────────────────────────────────────────┤
│ [保存] [导入] [导出] │ [源语言 ▼] → [目标语言 ▼] │ [专业 ▼]     │
│ [翻译未翻项] [审批选中(N)]                                       │
├─ 工具栏第二行 ───────────────────────────────────────────────────┤
│ [搜索原文、译文...] │ 状态筛选 │ 清空 │ 📗 术语表 [N] │          │
│ [跳过非译内容 ☐] │ 回写模式 ▼ │ [合并图层 ☑] │ [回写到图纸]    │
├─ 表格 ────────────────────────────┬─ 详情面板 ─────────────────┤
│ ☐ │ 原文 │ 译文 │ 置信度 │ 状态 │   │ 匹配记录               │
│   │      │      │        │ 风险 │   │ 术语命中               │
│   │      │      │        │ 来源 │   │ 基础信息               │
│   │      │      │        │ ...  │   │ 图层 & 位置            │
│   │      │      │        │      │   │ 文本样式               │
│   │      │      │        │      │   │ QA 发现                │
├──────────────────────────────────┴────────────────────────────┤
│ 待翻译 N · 已翻译 N · 已回写 N · 失败 N │ 已选择 N 条          │
├────────────────────────────────────────────────────────────────┤
│ ● 翻译工作台就绪  zh → en  DeepSeek (deepseek-v4-flash) ✓ 就绪 │
└────────────────────────────────────────────────────────────────┘

8. 翻译工作区 — 工具栏

8.1 第一行：翻译操作

8.2 第二行：搜索与回写

8.3 术语表抽屉

点击 📗 术语表按钮，从右侧滑入术语表配置面板：

• 已引用 (N)：当前图纸关联的术语表，点击 ✕ 移除
• 从术语库添加：术语库中可用的术语表，点击 ➕ 引用 添加
• 点击「✅ 完成」生效。引用的术语表在翻译时优先使用。

9. 翻译工作区 — 翻译与校对

9.1 表格列说明

9.2 译文来源类型

9.3 内联编辑译文

1. 在表格中双击译文列单元格
2. 直接输入或修改翻译文本
3. 按 Enter 或点击其他单元格完成编辑
4. 修改后的译文来源自动标记为「手动编辑」，状态变为「已翻译」

⚠️ 清空译文内容会使条目重置为「待翻译」状态。

9.4 翻译流程

1. 点击 ▶️ 翻译未翻项 按钮
2. 程序自动识别所有译文为空的条目
3. 根据「跳过非译内容」设置，自动跳过纯数字/符号文本
4. 将其余条目批量提交给 DeepSeek 大模型翻译
5. 底部状态栏显示实时进度
6. 翻译完成后弹出汇总对话框

ℹ️ 翻译时自动注入当前图纸引用的术语表条目作为上下文约束。

9.6 切换目标语言

当切换目标语言时（如从英语切换到日语），程序会自动清空所有已有译文并重置为「待翻译」状态。如果 DWG 中已有针对新语言的回写结果（通过 Xrecord 元数据记录），程序会自动从 DWG 中匹配并预填对应译文。

⚠️ 切换语言前请确认已保存当前译文。旧语言的译文在切换后将无法恢复（除非重新切换回来并匹配 DWG 中的旧回写数据）。

9.5 批量审批

1. 在表格中勾选要审批的条目（支持全选/单选）
2. 点击 ✅ 审批选中(N) 按钮
3. 已审批的条目状态变为绿色「已审批」

ℹ️ 已审批的条目在下次翻译时不会被覆盖。

10. 翻译工作区 — 回写图纸

10.1 回写模式

10.2 输出模式

在设置页中配置输出目录策略：

10.3 合并图层

勾选「合并图层」后，所有译文合并写入一个统一的翻译图层（如 TRANSLATION_EN），而非按原始图层分别创建翻译图层。

10.4 回写步骤

客户端：

1. 选择回写模式、确认输出设置
2. 点击 回写到图纸 按钮
3. 弹出确认对话框，显示回写条目数量和状态分布
4. 确认后，Core Console 在后台执行回写
5. 回写完成后显示输出文件路径

插件端（AutoCAD 内直接回写）：

1. 确认当前 DWG 已保存
2. 选择回写模式，点击 回写到图纸
3. 弹出备份确认对话框
4. 确认后在当前 DWG 的事务内直接执行回写（跳过 Core Console 和 Pipe）
5. 回写完成后译文实体附加 TW_TRANSLATION_META Xrecord 元数据（记录源句柄、目标语言等）

10.5 语言感知回写

回写时会在译文实体上记录目标语言元数据。再次提取时：

• 如果当前目标语言与 Xrecord 记录的语言一致 → 译文自动预填到工作台
• 如果不一致 → 不预填，用户切换语言后重新匹配新语言的译文

这个机制确保同一 DWG 可以支持多种目标语言的翻译，互不干扰。

10.6 MText 格式保护

多行文字（MText）的回写过程中，内联格式控制码（字体切换 \f、颜色 \C、字高 \H、下划线 \L、对齐 \pxq 等）通过占位符保护，确保翻译后格式完整无损。

⚠️ 所有回写模式都不修改原始 DWG 文件（插件端原位替换模式除外）。

11. 翻译工作区 — 详情面板

点击表格中的任意一行，右侧详情面板显示该条目的详细信息：

基础信息

• 对象类型：MText、DBText、INSERT+ATTRIB 等
• 句柄：CAD 内部唯一标识符（十六进制）
• 空间/布局：模型空间或图纸空间

图层 & 位置

• 图层：文本所属图层名称，附带「已锁定」「未锁定」「可见」「隐藏」状态标签
• X / Y / Z 坐标：文本锚点坐标

文本样式

• 字体：如 仿宋_GB2312、Simplex 等
• 字高：如 3.5 mm
• 对齐：如 左下、中心、右上

QA 发现

术语命中

显示该条目的术语表匹配结果，色标与表格中的"来源"列一致。

12. 术语库

术语库页面用于管理存储在 文档\Tongwen\glossaries\ 下的全部 CSV 术语表文件。

12.1 页面布局

• 左侧面板（248px）：搜索框 + 术语表文件列表 + 底部统计（共 N 个术语表 · N 条术语）
• 右侧面板：选中术语表的预览，包含操作按钮和 8 列数据表格

12.2 数据表格列

12.3 CSV 文件格式

术语表为 UTF-8 编码的 CSV 文件，第一行为标题行：

source_text,target_text,source_language,target_language,domain,priority,do_not_translate,notes

以 # 开头的行为注释行，会被自动忽略。

12.4 操作按钮

12.5 术语匹配规则

翻译时，术语表匹配遵循以下规则：

1. 语言匹配：仅当 source_language 和 target_language 与当前翻译方向匹配时生效。* 为通配符，匹配所有语言。
2. 精确匹配：源文本与术语表中的 source_text 完全相同时命中
3. 优先级选择：同一术语有多个译法时，选 priority 最高的
4. 不翻译：do_not_translate 为 true 的术语，译文保留原文

13. 设置页

设置页采用左侧导航 + 右侧内容的两栏布局，底部固定保存栏。

13.1 AutoCAD 检测

• 设置页检测当前受控的 AutoCAD 2026 Core Console，显示安装路径
• 状态标识：✅ 已检测到（绿色）或 ❌ 未检测到（红色）
• 点击 重新检测 手动刷新

13.2 输出设置

13.3 翻译引擎

13.4 本地目录

快捷打开按钮：

13.5 保存设置

• 恢复默认：将所有设置恢复为出厂默认值
• 保存设置：将更改写入配置文件，加密存储 API 密钥

14. 工作流速查

标准客户端流程（单人单张图纸）

首页                                  翻译工作区
┌─────────────────┐    ┌────────────────────────────────────┐
│ 1. 新建/展开项目   │    │ 2. 检查表格中的原文和自动翻译         │
│ 2. + 新建翻译任务  │───▶│ 3. 点击「翻译未翻项」                 │
│ 3. 选择 DWG 文件   │    │ 4. 双击校对 + 编辑译文                │
│ 4. 等待提取完成    │    │ 5. 勾选 + 点击「审批选中」             │
│ 5. 点击「查看结果 →」│   │ 6. 选择回写模式 + 点击「回写到图纸」    │
└─────────────────┘    └────────────────────────────────────┘

插件端流程（AutoCAD 内操作）

AutoCAD 侧边面板                      翻译工作台窗口
┌─────────────────────┐    ┌────────────────────────────────────┐
│ 1. 打开 DWG           │    │ 2. 自动弹出 — 检查表格             │
│ 2. 关联/新建项目       │    │ 3. 选择目标语言 → 翻译未翻项       │
│ 3. 整图提取/框选提取   │───▶│ 4. 双击校对 + 编辑译文             │
│    (进度+耗时显示)     │    │ 5. 审批选中 + 回写到图纸           │
│    提取完自动开工作台   │    │ 6. 译文写入当前 DWG               │
└─────────────────────┘    └────────────────────────────────────┘

批量项目翻译流程

首页
┌─────────────────────────────────────────┐
│ 1. + 新建项目（命名、选语言、引用术语表）    │
│ 2. 项目内创建多个翻译任务（自动继承术语表）   │
│ 3. 逐个进入工作区校对翻译                   │
│ 4. 逐个回写图纸                            │
│ 5. 查看项目进度条追踪完成度                  │
└─────────────────────────────────────────┘

术语管理流程

术语库页面
┌─────────────────────────────────────────┐
│ 1. 导入或新建术语表 CSV                    │
│ 2. 用 Excel 编辑术语内容                   │
│ 3. 标记常用术语表为「全局」                  │
│ 4. 翻译工作区中 📗 按钮引用术语表到图纸       │
│   （或项目设置中引用到项目级）               │
│ 5. 翻译时自动应用术语约束                    │
└─────────────────────────────────────────┘

15. 常见问题

提取相关

Q: 点击提取后提示"未找到 AutoCAD Core Console"？
A: 请确认已安装 AutoCAD 2026。设置页可查看检测结果。默认检查路径为 C:\Program Files\Autodesk\AutoCAD 2026\accoreconsole.exe。

Q: 提取进度一直等待，怎么办？
A: 点击进度条右侧的 ✕ 终止提取 手动终止。超时 5 分钟后也会自动终止。如果频繁超时，尝试简化 DWG 文件或检查 AutoCAD 许可状态。

Q: 提取后提示"提取失败，Core Console 退出码非零"？
A: 查看 %LocalAppData%\Tongwen\logs\ 中的日志文件了解详细错误。常见原因包括 DWG 文件损坏或 AutoCAD 许可证问题。

翻译相关

Q: 翻译需要多长时间？
A: 取决于条目数量和文本长度。通常每条约 1-3 秒，批量翻译时并发处理。

Q: 如何让翻译更准确？
A: 1) 在术语库中建立完善的术语表；2) 翻译时选择正确的专业领域；3) 在翻译工作区中通过 📗 按钮引用相关术语表；4) 校对后审批的译文不会被后续翻译覆盖。

Q: "跳过非译内容"有什么用？
A: 图纸中常见的纯数字标注（如"1200"、"Φ25"）和工程符号不需要翻译。勾选此选项后，程序自动识别这类内容，直接以原文作为译文，节省 API 调用。

Q: 术语表写了但没有生效？
A: 请确认：1) 术语表已在项目设置或翻译工作区被引用；2) source_language 和 target_language 列使用了正确的语言代码（如 zh、en）或 * 通配符；3) 术语原文与 CAD 中提取的文本完全一致（区分大小写和标点）。

网络诊断相关

Q: 安装或网络诊断提示缺少 PowerShell 7，主程序还能使用吗？

A: 可以。Studio、AutoCAD 插件和普通翻译网络探测不依赖 PowerShell。请安装 PowerShell 7.0 或更高版本，并确认命令行运行 pwsh -NoLogo -Command "$PSVersionTable.PSVersion" 可以返回版本；完成后重新打开诊断工具，即可执行 Windows 防火墙、Defender 和事件日志策略采集。不要改用 Windows PowerShell 5.1。

回写相关

Q: 回写后文件在哪里？
A: 客户端默认保存在原始 DWG 同目录下，文件名为 {原名}_translated.dwg。可在设置页中更改输出位置。插件端回写直接修改当前 DWG（自动备份到 文档\Tongwen\backups\）。

Q: 回写模式应该选哪个？
A: 推荐使用默认的「创建新图层」+「合并图层」勾选。此模式将所有译文写入一个统一翻译图层，原始内容完全保留，随时可以关闭新图层恢复原状。

Q: 双语追加模式是什么效果？
A: 翻译后每条文本显示为"原文 / 译文"格式。例如 "设备基础 / Equipment Foundation"。适合施工对照图。

Q: 切换目标语言后再次提取，为什么译文不见了？
A: 这是设计行为。回写时译文附加了目标语言元数据，再次提取时只有匹配当前语言的译文才会预填。切换语言后需重新翻译（或切换回之前语言以匹配已有译文）。

Q: 为什么多行文字回写后字体/颜色变了？
A: 此问题已在 v0.2.0 修复。MText 内联格式码现在通过占位符保护，翻译后自动还原。

插件相关

Q: 插件端和客户端有什么区别？
A: 插件端在 AutoCAD 内部运行（侧边面板 + 工作台窗口），直接操作当前 DWG；客户端是独立 WPF 程序，通过 Core Console 无头模式操作 DWG 文件。插件端更适合单张图纸快速翻译，客户端适合批量项目管理。

Q: 插件端打开 DWG 后为什么提示"请先关联项目"？
A: 打开已保存的 DWG 后，侧边栏会按文件路径自动匹配项目。如果未匹配到（新图纸或未注册），需要点击"关联已有"或"新建"来建立项目关联。

Q: 为什么编辑保存后项目关联会自动消失？
A: 此问题已在 v0.2.0 修复。现在基于路径哈希自动匹配，且已关联的项目不受编辑保存影响。

Q: 如何在 AutoCAD 中打开侧边面板？
A: 插件加载后自动显示。也可在命令行输入 TW_SHOW_PANEL 切换显示/隐藏。

会话与数据

Q: .tw 文件可以手动编辑吗？
A: .tw 文件是 JSON 格式，可以使用文本编辑器打开查看。但建议通过同文工作台编辑以确保数据一致性。

Q: 如何在不同电脑之间迁移数据？
A: 复制以下目录即可：

• 文档\Tongwen\projects\ — 所有翻译会话和项目数据
• 文档\Tongwen\glossaries\ — 术语表文件
• 文档\Tongwen\tongwen.p1.json — 全局配置和 API 密钥

Q: 卸载同文后数据会被删除吗？
A: 不会。卸载程序只删除安装目录下的程序文件。用户数据（文档\Tongwen\）和日志（%LocalAppData%\Tongwen\）保留在磁盘上。

Q: 术语表的语言代码应该怎么写？
A: 使用标准 ISO 639 两字母代码，如 zh（中文）、en（英语）、ja（日语）、ko（韩语）等。如果希望该术语在所有语言组合下都生效，填写 *。

16. 插件端使用指南

同文 AutoCAD 插件在 AutoCAD 内部运行，提供侧边面板和翻译工作台窗口，让用户无需离开 CAD 环境即可完成项目管理、文字提取、翻译校对和回写。

16.1 加载插件

插件支持 AutoCAD 2019–2026，共 8 个版本，3 个 SDK 代：

加载方式：

1. 通过同文启动器：在客户端启动器页面选择 CAD 版本 → 点击「启动」，自动通过 SCR 脚本加载插件 DLL
2. 设置自启动：勾选「自启动」后，插件写入注册表，每次打开 AutoCAD 自动加载
3. 手动 NETLOAD：在 AutoCAD 命令行输入 NETLOAD，选择对应版本的 Tongwen.Plugin.AutoCAD.dll

插件加载后在命令行输入 TW_STATUS 确认加载成功，会列出所有可用命令。

16.2 侧边面板

插件加载后自动显示侧边面板（TW_SHOW_PANEL 命令切换显示/隐藏），固定在 AutoCAD 窗口左侧，宽度约 268px。面板包含三个区域：

16.2.1 状态栏（顶部）

显示当前 DWG 文件名和项目关联状态：

• 🟡 未关联：当前图纸未关联项目，需先保存图纸
• 🟢 已关联：显示项目名称，绿色已关联标记
• 🟢 已提取：项目已关联且存在 .tw 翻译会话文件

当同一 DWG 在多个项目中存在匹配时，显示「还有 N 个项目也包含此图纸」，点击展开候选列表切换。

16.2.2 项目关联（折叠区）

未关联状态：

• 「🔗 关联已有」按钮 — 打开项目选择对话框，从已扫描的所有项目中关联
• 「＋ 新建」按钮 — 新建项目，配置名称、语言对、术语表引用
• 两个按钮在图纸未保存时禁用（灰色）

已关联状态：

• 显示项目名（绿色）和「切换」按钮
• 点击「切换」解除当前关联

16.2.3 文字提取（折叠区）

提取设置：

• ☑ 不提取图框文字 — 勾选后跳过图框（BlockReference）内的属性文字

提取进度：

• 面板显示当前步骤（「正在收集文字实体...」→「正在提取 N 个文字实体...」→「正在保存翻译会话...」）
• 实时耗时显示（每 250ms 刷新，如「耗时: 1.2s」）
• 提取完成弹出 MessageBox 显示详情（实体数、继承已有译文数、新增数、批次、耗时）
• 提取完成后自动打开翻译工作台

框选提取流程：

1. 点击「框选提取」→ 面板提示「请在图纸中框选文字区域...」
2. 在 AutoCAD 绘图区拖动框选范围，Enter 确认
3. 面板切换到提取中状态，显示进度
4. 提取完成 → MessageBox → 自动打开工作台

16.2.4 翻译工作区（折叠区）

• 「📄 打开翻译工作区」按钮 — 打开翻译工作台窗口
• 按钮在 .tw 文件存在时可用（提取后自动变为可用）

16.3 翻译工作台窗口

翻译工作台是一个独立的 WPF 窗口（非 AutoCAD PaletteSet），宽度 900px，高度 620px。基于 Syncfusion SfDataGrid，界面与客户端工作区一致。

关键操作：

• 定位实体：点击 🎯 按钮 → AutoCAD 中缩放到对应实体位置（合并行支持多个 handle）
• 内联编辑：双击译文列 → 直接编辑 → Enter 提交，来源自动标记为「手动编辑」
• 术语表抽屉：点击 📗 按钮 → 右侧滑入术语表面板，可引用/移除图纸级术语表
• 异步加载：窗口先弹出加载遮罩（「⟳ 正在加载翻译会话...」），数据后台加载完毕后遮罩自动消失

16.4 插件端回写

与客户端不同，插件端回写直接在 AutoCAD 事务内执行，不走 Core Console 和 Pipe：

1. 确认当前 DWG 已保存
2. 选择回写模式（创建新图层 / 原位替换 / 双语追加）
3. 点击「回写到图纸」→ 弹出备份确认对话框
4. 确认后执行回写，译文写入当前 DWG
5. 译文实体附加 TW_TRANSLATION_META Xrecord（记录源句柄、目标语言等）

⚠️ 插件端回写直接修改当前 DWG。回写前会自动备份到 文档\Tongwen\backups\。

16.5 语言感知回写

回写时译文实体记录目标语言。再次提取时：

• 当前目标语言与 Xrecord 记录一致 → 译文自动预填
• 不一致 → 不预填，切换语言后重新匹配新语言的译文

切换目标语言时清空所有译文并重新扫描 DWG 中匹配新语言的 Xrecord。

16.6 MText 格式保护

多行文字（MText）的格式控制码通过占位符保护：

16.7 项目匹配机制

打开 DWG 时自动匹配已注册的项目：

1. 路径优先匹配：按 DWG 完整文件路径匹配 manifest 中的 DwgFilePath
2. 哈希 fallback：路径未匹配时按路径 SHA256 前 12 位匹配（文件被移动/复制时）
3. 信任显式关联：已关联的项目保存后不会丢失（不重算哈希）

多候选处理：同一 DWG 在多个项目中匹配时，侧边栏展开候选列表，用户可选择切换。

16.8 可用命令

16.9 插件 vs 客户端 对比

📄 文档状态：线上帮助 MVP 的 Markdown 源之一

📅 最后核对：2026-08-28

🔗 公开安装包与发行说明：https://github.com/FeiSiPub/TongWenReleases/releases