第11章：设置与配置

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

同文（Tongwen）的配置系统采用”图形界面 + 配置文件”双层架构。日常使用中，您通过 Studio 工作台的设置页面完成绝大多数配置操作，修改结果会自动写入底层的 JSON 配置文件中；对于高级用户，直接编辑配置文件可以实现更精细的参数调优。本章将从上到下、从表到里，逐一拆解设置页面的每个选项、每个配置文件的每个字段，以及它们背后的工作机制。

阅读完本章后，您将能够：

• 独立完成 AutoCAD Core Console 的检测与路径配置
• 根据工作习惯选择最合适的输出保存策略
• 配置并验证翻译引擎（包含 API 密钥的安全存储）
• 管理本地用户数据和日志目录
• 理解 tongwen.p1.json、launcher.json、deepseek.p1.json 三个核心配置文件的每一个字段
• 在多台机器之间同步配置，或在新电脑上快速恢复工作环境

11.1 设置概述

11.1.1 设置页面的入口

在 Studio 桌面工作台中，打开设置页面有三种方式：

1. 导航栏点击：点击左侧导航栏最下方的 ⚙️ 图标，切换到设置页面。
2. 快捷键：按下设置页面对应的键盘快捷键（默认快捷键请参考快捷键配置文件，可在设置页面的”本地目录”区域找到配置文件夹查看）。
3. 菜单栏：点击顶部菜单栏的”工具 → 选项”（如果当前版本启用了顶部菜单栏），同样可进入设置页。

设置页顶部有一个分页标签栏，其中”⚙️ 设置”标签即为本章讨论的全部内容。其他标签（如快捷键、外观等）不在本章讨论范围之内。

11.1.2 设置页面的整体布局

设置页面的主体分为四个分区，从上到下依次排列：

四个分区之下是底部操作栏，包含”恢复默认”和”保存设置”两个按钮。

11.1.3 配置的存储方式

所有设置在页面上的修改，点击”保存设置”按钮后，会写入以下位置：

• 用户级全局配置：文档\Tongwen\tongwen.p1.json —— 保存语言、引擎、输出模式等全局配置。
• 引擎配置：文档\Tongwen\deepseek.p1.json —— 保存 DeepSeek 引擎的专用参数（API 地址、模型名、超时等）。
• 启动器配置：文档\Tongwen\launcher.json —— 保存 AutoCAD 版本选择和插件注册状态。
• API 密钥（加密存储）：API 密钥不直接写入明文 JSON，而是通过 Windows DPAPI（数据保护 API） 加密后存储，仅当前 Windows 用户账户可以解密。

配置文件的详细结构将在本章后续各节中逐一说明。

11.2 分区一：AutoCAD 检测

AutoCAD 检测分区用于确认本地计算机上是否安装了可用的 AutoCAD Core Console（核心控制台），并显示其版本信息。这是同文能够正常工作的前提条件——没有 Core Console，翻译后的 DWG 将无法自动回写生成。

11.2.1 什么是 Core Console？

AutoCAD Core Console（核心控制台，可执行文件名为 accoreconsole.exe）是 Autodesk 提供的一个无图形界面的命令行版 AutoCAD 引擎。它不需要打开 AutoCAD 主窗口即可执行 DWG 文件的打开、编辑、保存等操作。

在同文的工作流中，Core Console 的作用如下：

1. 图纸回写：翻译完成后，同文通过 Core Console 在后台静默打开目标 DWG 文件，将翻译后的文本精确写回对应的文字对象中，并保存为新的 DWG。
2. 批量处理：多个 DWG 文件需要翻译时，Core Console 可以依次处理，无需人工干预。
3. 属性读取：提取阶段如需读取某些复杂对象（如动态块属性、多行文字格式），也会通过 Core Console 获取。

关键理解：Core Console 是 AutoCAD 安装包自带的组件，不需要单独下载。只要是完整版 AutoCAD（非 LT），安装后就一定存在 accoreconsole.exe。它的路径通常在 AutoCAD 安装目录下，例如：

C:\Program Files\Autodesk\AutoCAD 2025\accoreconsole.exe

但在 64 位系统上，某些版本的 AutoCAD 还会在 Program Files (x86) 下安装一个 32 位的辅助版本，路径如下：

C:\Program Files (x86)\Autodesk\AutoCAD 2025\accoreconsole.exe

11.2.2 界面元素

AutoCAD 检测分区包含以下界面元素：

11.2.3 检测流程

当您首次打开设置页面（或点击”重新检测”按钮）时，同文会执行以下检测流程：

1. 读取注册表：依次查询以下注册表位置，寻找已安装的 AutoCAD 版本：
   • HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD\...
   • HKEY_CURRENT_USER\SOFTWARE\Autodesk\AutoCAD\...
   • （64 位系统还会查询 SOFTWARE\WOW6432Node 下的对应路径）

2. 逐版本定位 Core Console：对于每个找到的 AutoCAD 版本，在安装目录下查找 accoreconsole.exe。优先查找 Program Files 下的 64 位版本，其次查找 Program Files (x86) 下的 32 位版本。

3. 版本验证：找到文件后，读取文件属性获取版本号，确认其属于受支持的 AutoCAD 版本（2019、2021、2025、2026）。

4. 选择最高版本：如果系统中安装了多个 AutoCAD 版本，且每个版本都有 Core Console，同文会自动选择版本号最新的那一个。您也可以在分区下方的下拉框或启动器页面中手动指定要使用的版本。

5. 显示结果：检测完成后，状态指示器更新为 ✅ 或 ❌，路径和版本信息同步显示在界面上。

11.2.4 手动指定 Core Console 路径

如果自动检测未找到 Core Console（状态显示 ❌），但您确信已安装 AutoCAD，可以手动定位路径：

1. 打开 Windows 文件资源管理器。
2. 导航到 AutoCAD 安装目录（通常是 C:\Program Files\Autodesk\AutoCAD 20XX\）。
3. 找到 accoreconsole.exe 文件。
4. 复制该文件的完整路径。
5. 回到 Studio 设置页面，在 Core Console 路径的文字框中直接粘贴路径。
6. 点击路径框右侧的”验证”按钮，系统会尝试验证该路径是否有效。
7. 如果验证通过，版本信息会自动更新。

11.2.5 常见检测问题

以下是用户最常遇到的几个 AutoCAD 检测问题及其解决方法：

问题一：状态显示 ❌，但已安装 AutoCAD 2025

问题二：检测到多个版本，但选中的不是我要用的

解决方法：在启动器页面（🚀）中，找到”默认版本设置”区块，在下拉列表中选择您希望优先使用的 AutoCAD 版本。设置保存后，AutoCAD 检测分区会优先显示该版本的 Core Console。

问题三：重新检测按钮点击后没有变化

• 确认您是以管理员身份运行的 Studio。如果没有管理员权限，读取注册表时可能无法获取完整的 AutoCAD 安装信息。右键 Studio 快捷方式 → “以管理员身份运行”后，再次点击重新检测。
• 如果仍然无法检测到，请手动指定路径（见 11.2.4 节）。

问题四：Core Console 路径正确但验证失败

可能的原因：

• Core Console 文件损坏，请尝试修复 AutoCAD 安装。
• AutoCAD 许可证过期或未激活，Core Console 同样无法运行。
• Core Console 被安全软件拦截。请将 accoreconsole.exe 添加到杀毒软件的白名单中。

11.3 分区二：输出设置

输出设置分区控制翻译完成后 DWG 文件的保存位置和方式。三种模式各有利弊，选择哪一种取决于您的工作习惯和项目组织方式。

11.3.1 模式一：与原文件同目录（默认）

选项描述：翻译后的 DWG 文件保存在源 DWG 文件所在的同一目录中。

文件命名规则：在原文件名后附加语言后缀，例如：

语言后缀由 tongwen.p1.json 中 translation.target_language 的语言代码决定（详见 11.7.1 节）。

适用场景：

• 图纸文件数量少，目录结构简单。
• 希望翻译版和原版放在一起，方便对比查看。
• 中文原图和英文版存放在同一交付包中，直接打包发送。

注意事项：

• 如果同一目录下已有同名翻译文件，回写时会覆盖旧文件。覆盖前，同文会在 %LocalAppData%\Tongwen\backups\ 目录中自动生成备份（见 11.5.3 节），您可以从备份中恢复。
• 如果项目目录受到版本管理（如 Git），翻译文件可能被误提交。建议在 .gitignore 中添加 *_EN.dwg、*_JA.dwg 等语言后缀规则。

11.3.2 模式二：每次询问保存位置

选项描述：每次翻译回写（即生成翻译版 DWG）时，系统弹出”另存为”对话框，由用户手动指定保存路径和文件名。

适用场景：

• 每张图纸需要保存到不同的位置（例如按专业分目录存放）。
• 希望每次都有机会自定义输出文件名（不满足于默认的语言后缀规则）。
• 翻译批次较小，手动选择不构成负担。

注意事项：

• 批量处理模式下（命令行批量回写），此选项会导致每条回写都弹出对话框，严重影响批处理效率。如果您需要使用批量模式，请将输出设置切换为”与原文件同目录”或”保存到固定目录”。
• 弹出的”另存为”对话框默认定位到源文件所在目录，但您可以自由浏览到任何位置。

11.3.3 模式三：保存到固定目录

选项描述：所有翻译后的 DWG 文件统一保存到一个预先指定的固定目录中。

文件命名规则：与模式一相同（原文件名 + 语言后缀），但目标目录变为固定目录。

界面操作：

1. 选择”保存到固定目录”选项。
2. 点击右侧的”浏览”按钮，打开文件夹选择对话框。
3. 浏览到目标目录（例如 D:\项目输出\英文图纸\），点击”选择文件夹”。
4. 选中的路径会显示在文本框中。
5. 如需更改，再次点击”浏览”重新选择。

适用场景：

• 需要将原图（中文）和翻译图（英文）严格分离存放。
• 多个项目的翻译输出需要集中管理。
• 甲方/监理要求所有英文图纸放在同一个交付文件夹中。

注意事项：

• 如果固定目录中已存在同名文件，同样会触发备份和覆盖。
• 确保目标目录有足够的磁盘空间和写入权限。
• 如果多个不同项目的图纸恰好有相同的文件名，后处理的会覆盖先处理的。建议在固定目录下按项目名称创建子目录，或在文件名规则中加入项目标识（目前版本不支持自定义命名模板，如有此需求可通过编辑 tongwen.p1.json 的 writeback 段实现部分控制，详见 11.7.4 节）。

11.3.4 三种模式的对比总结

推荐：对于大多数用户，”与原文件同目录”是最省心的选择。如果您需要统一管理输出文件，切换到”保存到固定目录”并指定一个专门的中转/交付文件夹。

11.4 分区三：翻译引擎

翻译引擎分区是同文配置的核心。这里决定了使用哪种翻译引擎、何种模型、以及用什么语言对进行翻译。配置的正确与否直接影响翻译质量。

11.4.1 默认源语言

界面：一个下拉选择框，列出 26 种语言。

作用：设定翻译任务的默认源语言。每当您在翻译工作区中新建一个翻译任务时，源语言会自动填充为此处设定的值，无需每次手动切换。

26 种语言完整列表：

工程图纸常见场景：绝大多数国内设计院的图纸源语言为中文（zh），因此建议将此选项保持为”中文”，无需修改。如果您拿到的图纸本身已经是英文版（如国际总包提供的底图），需要翻译为中文，则将源语言切换为英语（en）。

11.4.2 默认目标语言

界面：与源语言相同的下拉列表，25 种目标语言（除去源语言选中的那一种）。

作用：设定翻译任务的默认目标语言。新建翻译任务时，目标语言自动填充。

常用配置组合：

提示：此处的默认值仅作用于”新建任务”时的初始值。您可以在翻译工作区中随时为某个特定任务修改语言对，不会影响全局默认设置。

11.4.3 引擎选择

界面：两个单选按钮 —— “DeepSeek（生产引擎）”和”Mock（测试引擎）”。

DeepSeek（生产引擎）

这是同文真正的翻译引擎。选择此选项后，翻译请求通过 HTTPS 发送到 DeepSeek API 服务，由 DeepSeek 大语言模型完成翻译。

• 适用于：正式生产环境，需要高质量的图纸文本翻译。
• 需要配置：API 密钥（见 11.4.5 节）。
• 需要联网：翻译过程中必须保持互联网连接（除非部署了本地代理，见 11.8.2 节）。

Mock（测试引擎）

Mock 引擎是一个本地虚拟翻译引擎，不联网，不调用真实 AI。它的行为是：将源文本复制一份，在前面加上固定的前缀（如 [MOCK_TRANSLATION]），模拟翻译完成的结果返回。

Mock 引擎的用途：

1. 功能测试：在不消耗 API 额度的情况下，测试同文的完整工作流（提取→翻译→回写）是否正常运转。
2. 演示/培训：向新用户展示同文的界面和操作流程，无需配置 API 密钥。
3. 开发调试：（仅供开发者参考）测试数据处理管道是否正确。

Mock 引擎的翻译结果示例：

注意：Mock 引擎不产生任何有意义的翻译。如果您需要真实的翻译输出，必须切换到 DeepSeek 引擎并完成 API 密钥配置。

11.4.4 模型选择

界面：在 DeepSeek 引擎下，显示两个可选的模型：

两个模型的差异：

选择建议：

• 初次使用或试译：先用 flash 快速跑通流程，确认工作流正常。
• 日常翻译：flash 对绝大多数图纸文本已经足够。
• 关键交付：重要的图纸（如报审图纸、最终竣工图）切换到 pro，以获得最佳翻译质量。
• 混合策略：没有一刀切的最优选择。您可以先批量用 flash 处理，再将关键图纸切换到 pro 重新翻译。在翻译工作区中，可以针对单个任务覆盖全局模型设置。

11.4.5 API 密钥配置

调用 DeepSeek API 需要提供有效的 API 密钥（API Key）。同文通过以下方式管理 API 密钥：

密钥的存储方式：Windows DPAPI 加密

API 密钥属于敏感信息，同文不会以明文形式存储在配置文件中。取而代之的是使用 Windows DPAPI（数据保护 API） 进行加密存储：

• 加密范围：加密后的密钥仅能被当前 Windows 用户账户解密。即使别人获取了您的硬盘，也无法在没有您登录凭据的情况下读取密钥。
• 存储位置：加密后的数据保存在同文的内部数据存储中（不是明文 JSON 文件）。
• 传输安全：API 密钥在发送到 DeepSeek 服务器时，通过 HTTPS（TLS 1.2+）加密传输，不会被中间人截获。

获取 DeepSeek API 密钥

如果您还没有 DeepSeek API 密钥，请按以下步骤获取：

1. 打开浏览器，访问 DeepSeek 开放平台。
2. 注册或登录您的 DeepSeek 账户。
3. 进入控制台（Dashboard），在左侧导航栏中找到”API Keys”（API 密钥）页面。
4. 点击”创建新的 API Key”按钮。
5. 为密钥输入一个描述性名称（例如”同文-翻译专用”），方便日后识别。
6. 点击”创建”，系统将生成一个新的 API 密钥字符串（格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）。
7. 立即复制并保存：此密钥仅显示一次。关闭页面后无法再次查看完整密钥，只能重新生成。

重要：

• 请将 API 密钥视为密码保管，不要分享给他人，不要上传到公开仓库。
• DeepSeek API 按调用量计费。请关注您的账户余额和使用量，避免因余额不足导致翻译中断。
• 建议为同文创建独立的 API Key，不要与其他应用共用，以便单独管理额度和审计调用日志。

在 Studio 中输入和保存密钥

1. 在设置页面的”翻译引擎”分区，找到”API 密钥”输入框。
2. 将从 DeepSeek 平台获取的密钥（sk-...）粘贴到输入框中。
3. 点击输入框右侧的”验证”按钮（见 11.4.6 节），测试密钥是否有效。
4. 验证通过后，点击页面底部的”保存设置”按钮。系统会将密钥通过 DPAPI 加密后存入本地。
5. 输入框中的明文字符在保存后会被清空（仅显示占位符，如 ********），以保护密钥不被旁观。

密钥的有效性与续期

• API 密钥通常是长期有效的，直到您在 DeepSeek 平台上手动撤销（Revoke）。
• 如果在 DeepSeek 平台上撤销了某个密钥，同文再次使用该密钥调用 API 时将收到认证错误。此时请重新生成密钥并按上述步骤更新。
• 建议定期（如每季度）检查一次密钥状态，在平台控制台中确认密钥仍处于”Active”状态。

11.4.6 验证按钮：测试 API 密钥

“验证”按钮位于 API 密钥输入框的右侧。点击该按钮后，同文会执行一次轻量级的 API 连通性测试：

1. 发送测试请求：使用您输入的密钥，向 DeepSeek API 的模型列表端点（GET /models）发送一个 HTTPS 请求。
2. 检查响应：
   • 如果返回 HTTP 200 状态码和有效的模型列表，说明密钥有效，网络通畅。
   • 如果返回 HTTP 401（Unauthorized），说明密钥无效或已被撤销。
   • 如果返回超时或其他网络错误，说明当前网络无法访问 DeepSeek API（可能是防火墙或代理问题）。
3. 显示结果：验证结果会以弹窗或内联消息的形式显示：
   • ✅ “API 密钥验证成功。检测到可用模型：deepseek-v4-flash, deepseek-v4-pro”
   • ❌ “API 密钥验证失败：无效的认证凭据”
   • ⏱️ “API 密钥验证超时：无法连接到 DeepSeek 服务，请检查网络设置”

提示：验证操作不会消耗 API 调用额度（模型列表端点是免费的）。您可以随时重复验证，不必担心成本。

11.5 分区四：本地目录

本地目录分区提供了三个快捷打开按钮，帮助您快速定位同文的本地数据目录。这些目录在日常使用中可能需要手动访问（如查看日志、备份配置、清理临时文件）。

11.5.1 用户文件夹

按钮文本：”打开用户文件夹”（或类似表述）

目标路径：文档\Tongwen\（即 %USERPROFILE%\Documents\Tongwen\）

目录内容：

使用场景：

• 需要手动备份配置文件（复制整个 Tongwen 文件夹即可完成备份）。
• 需要在另一台电脑上恢复配置（将此文件夹复制到新电脑的”文档”目录下）。
• 需要直接编辑 JSON 配置文件（高级用户）。
• 需要查看或管理术语表文件。

11.5.2 配置文件夹

按钮文本：”打开配置文件夹”

目标路径：同文安装目录下的配置子目录（具体路径取决于安装位置，通常在 C:\Program Files\Tongwen\config\ 或用户选择的安装路径下）。

目录内容：

• 系统级默认配置文件（新用户首次启动时，用户配置由此复制生成）。
• 快捷键映射文件。
• 界面主题和布局配置文件。
• 日志记录级别配置文件。

注意：大多数用户不需要修改此目录的内容。此目录中的文件影响的是应用程序的整体行为（非用户特定的设置）。如果修改不当，可能导致 Studio 启动异常。除非您明确知道自己在做什么，否则请勿手动编辑此目录下的文件。

11.5.3 日志文件夹

按钮文本：”打开日志文件夹”

目标路径：%LocalAppData%\Tongwen\logs\（即 C:\Users\<用户名>\AppData\Local\Tongwen\logs\）

目录内容：

使用场景：

• 排查问题：程序出现异常时，技术支持人员通常会要求您提供对应日期的日志文件。您可以使用此快捷按钮打开日志目录，将相关文件打包发送。
• 了解运行状态：日志中记录了每次翻译调用的耗时、API 返回状态、回写操作的结果等详细信息。
• 清理磁盘空间：如果长期使用，日志文件可能占用较多磁盘空间（通常每个文件不超过几 MB）。您可以手动删除超过三个月以上的旧日志。

日志文件命名规则：<模块>_<日期>.log，日期格式为 YYYYMMDD（如 studio_20250115.log 表示 2025 年 1 月 15 日的 Studio 日志）。

11.5.4 其他重要目录

除了在设置页面上有快捷按钮的三个目录外，同文还在系统中使用了以下目录：

磁盘空间提示：如果发现 C 盘空间不足，可以先检查 %LocalAppData%\Tongwen\temp\ 目录，安全删除其中的所有文件。备份目录 backups\ 中的文件可根据需要保留或删除——建议保留最近一个月的备份，以防万一。

11.6 底部操作栏

设置页面的底部操作栏固定显示两个按钮：

11.6.1 恢复默认

按钮文本：”恢复默认”

作用：将当前设置页面上的所有选项恢复到出厂默认值。

注意：

• 点击此按钮后，界面上的选项会立即变为默认值，但尚未保存到配置文件。如果您反悔，只需关闭设置页面或切换到其他页面，修改即被丢弃。
• 只有再次点击”保存设置”按钮，默认值才会正式写入配置文件。
• 恢复的是全局默认值，不会删除您已配置的 API 密钥（密钥存储在独立的加密存储中）。

出厂默认值一览：

11.6.2 保存设置

按钮文本：”保存设置”

作用：将当前页面上的所有修改写入到配置文件（tongwen.p1.json、launcher.json、deepseek.p1.json）和加密存储中。

保存过程：

1. 校验输入内容的合法性（例如检查固定目录路径是否存在、API 密钥格式是否正确等）。
2. 将 API 密钥通过 DPAPI 加密后存入安全存储。
3. 将其他配置项序列化为 JSON，写入对应文件。
4. 显示保存成功提示（通常是底部状态栏的一条短暂消息或右上角的通知条）。

保存失败的可能原因及处理：

11.7 全局配置文件 tongwen.p1.json 详解

tongwen.p1.json 是同文的全局用户配置文件，保存了绝大多数的用户级设置。文件位于 文档\Tongwen\tongwen.p1.json。

本节将逐一解释该文件中的每个配置段和字段。您可以直接用文本编辑器（如记事本、VS Code）打开并编辑此文件，保存后重新启动 Studio 即可生效。

11.7.1 配置文件整体结构

{
  "autocad": { ... },
  "pipe": { ... },
  "translation": { ... },
  "writeback": { ... }
}

tongwen.p1.json 包含四个顶层配置段：

11.7.2 autocad 段

{
  "autocad": {
    "version": "2025",
    "accore_console_path": "C:\\Program Files\\Autodesk\\AutoCAD 2025\\accoreconsole.exe",
    "console_language": "zh-CN",
    "timeout_seconds": 300
  }
}

timeout_seconds 调优建议：

注意：超时值设得过大不会带来副作用，只是异常情况下等待时间更长。如果您经常处理大型图纸，建议适当增大此值，避免正常回写被误判为超时。

11.7.3 pipe 段

{
  "pipe": {
    "name_prefix": "Tongwen_Pipe_"
  }
}

一般用户无需修改此字段。除非您的环境中存在管道名称冲突（极罕见情况），否则保持默认值即可。

11.7.4 translation 段

{
  "translation": {
    "source_language": "zh",
    "target_language": "en",
    "translator": "deepseek",
    "model": "deepseek-v4-flash",
    "base_url": "https://api.deepseek.com/v1",
    "api_key_env": "",
    "batch_size": 20,
    "max_tokens": 4096,
    "timeout_seconds": 60
  }
}

这是配置文件中最核心、最常被修改的段。

各字段调优详解

source_language 和 target_language

这两个字段支持的语言代码列表见 11.4.1 节。直接在 JSON 中修改时，确保使用小写两字母代码。例如将目标语言从英语改为日语：

"target_language": "ja"

translator

• 设为 "deepseek" 使用真实的 AI 翻译引擎。
• 设为 "mock" 使用虚拟测试引擎（不消耗 API 额度，不联网）。

model

• "deepseek-v4-flash"：速度优先，适合批量处理。
• "deepseek-v4-pro"：质量优先，适合关键图纸。

base_url

• 默认值为 DeepSeek 官方 API 地址：https://api.deepseek.com/v1。
• 如果您通过本地代理（如自建的 API 网关、内网转发服务器）访问 DeepSeek API，请将此处修改为代理地址。例如：

  "base_url": "http://192.168.1.100:8080/v1"
  

• 如果您使用兼容 OpenAI 接口格式的其他模型服务（如通过 Ollama 部署的本地模型、或者第三方中转服务），也可将此处修改为对应的 API 端点。具体兼容性需要您自行验证。

api_key_env

• 此字段允许通过环境变量来指定 API 密钥，而不是在 Studio 界面中输入。
• 使用方式：在系统环境变量中创建一个变量（如 TONGWEN_DEEPSEEK_KEY），将其值设为您的 API 密钥。然后在配置文件中设置：

  "api_key_env": "TONGWEN_DEEPSEEK_KEY"
  

• 当此字段非空时，同文会优先从环境变量读取密钥，忽略 Studio 界面中存储的 DPAPI 加密密钥。
• 适用场景：在多台机器的部署脚本中统一管理密钥；在 CI/CD 流水线中使用同文的命令行模式。

batch_size（批次大小）

批次大小决定了每次 API 请求中包含几条待翻译文本。这个参数需要在效率和精度之间权衡：

推荐：

• 标准图纸：保持默认 20。
• 文字条目非常多（>1000 条）且以短标签为主：可适当增大到 30-40。
• 文字条目少但每条内容较长（如详图注释、长段落）：减小到 5-10。

max_tokens

此字段限制了模型单次响应的最大 token 数。对于图纸翻译，4096 通常足够。但如果您遇到以下情况，可以适当增大：

• 图纸中有大量长段落文本（如施工说明、材料备注）。
• 使用 pro 模型时，模型输出通常更详细，可能消耗更多 token。
• 一批次中包含大量条目（batch_size 设为 50+），回包 token 数可能超过上限。

增大此值不会直接影响翻译质量，但可能略微增加 API 调用成本（按 token 计费）。建议范围：2048 ~ 8192。

timeout_seconds

API 调用的单次超时时间。默认 60 秒对大多数请求已经足够。但在以下情况下，建议增大：

• 网络环境较慢（如通过 VPN 访问海外 API）。
• batch_size 设置较大（如 50+），服务器端需要更长时间处理。
• 使用 pro 模型时，模型推理时间比 flash 更长。

建议范围：30 ~ 120 秒。

11.7.5 writeback 段

{
  "writeback": {
    "mode": "same_directory",
    "modify_source": false,
    "expected_target_layer": ""
  }
}

mode 的可选值

其中，选择 "fixed_directory" 时，固定目录路径的配置在另外一个单独的字段中（通常由设置页面的 UI 管理，不直接暴露在此 JSON 文件中，或者存储在 deepseek.p1.json 的扩展字段里——具体取决于当前版本实现）。如果您需要在 JSON 中手动指定固定目录，请先在设置页面用 UI 选择一次路径并保存，然后查看生成的 JSON 文件来确认字段名称和格式。

modify_source

• 设为 true 时，回写操作会直接覆盖源 DWG 文件，不生成新文件。
• 这是高风险操作——一旦翻译结果不满意，原始 DWG 已经被修改。虽然同文在修改前会在 %LocalAppData%\Tongwen\backups\ 中生成备份，但恢复仍然需要额外步骤。
• 强烈建议保持 false（默认），除非您有特殊需求且已经充分理解风险。

expected_target_layer

• 在某些项目中，翻译后的图纸需要将翻译文本放在一个特定的图层上（而非保持原图层）。例如，甲方要求所有英文标注放在名为 "TEXT_EN" 的图层上，而中文原标注保持在 "TEXT_CN" 图层。
• 如果设置了此字段（如 "TEXT_EN"），回写完成后系统会校验该图层是否存在且包含预期的文字对象。
• 大多数用户不需要设置此字段，保持空字符串即可。

11.8 DeepSeek 引擎配置 deepseek.p1.json

deepseek.p1.json 是 DeepSeek 翻译引擎的专用配置文件，位于 文档\Tongwen\deepseek.p1.json。它包含了与 DeepSeek API 交互的详细参数。

11.8.1 配置文件示例

{
  "api_base_url": "https://api.deepseek.com/v1",
  "default_model": "deepseek-v4-flash",
  "models": {
    "deepseek-v4-flash": {
      "max_tokens": 4096,
      "temperature": 0.3,
      "top_p": 0.9,
      "frequency_penalty": 0.0,
      "presence_penalty": 0.0
    },
    "deepseek-v4-pro": {
      "max_tokens": 8192,
      "temperature": 0.1,
      "top_p": 0.95,
      "frequency_penalty": 0.0,
      "presence_penalty": 0.0
    }
  },
  "request": {
    "timeout_seconds": 60,
    "max_retries": 3,
    "retry_delay_seconds": 2
  },
  "batch": {
    "default_size": 20,
    "max_size": 100,
    "max_chars_per_item": 2000
  }
}

11.8.2 各字段说明

顶层字段

models 对象

models 对象中为每个可用的模型定义了调用参数。目前支持两个模型条目：

模型参数字段解释：

temperature 在图纸翻译中的调优：

frequency_penalty 和 presence_penalty：

• 工程图纸翻译中，这两个参数通常建议保持 0.0。
• 图纸文本的特点是大量重复性术语（同一词汇在多处出现），我们不希望模型”避免重复”——恰恰相反，我们希望同一个术语在同一张图纸中的翻译保持一致。
• 如果增大这两个值，可能导致相同术语在不同位置被翻译成不同表述，违反术语一致性原则。

request 对象

重试机制：当 API 调用因网络波动、服务器临时繁忙等原因失败时，同文会自动按照 retry_delay_seconds 的间隔重试，最多重试 max_retries 次。如果全部重试后仍然失败，该批次翻译任务会标记为”失败”，您可以在翻译工作区中手动重新提交。

• 网络不稳定时可以增大 max_retries 到 5。
• 如果是偶尔的服务器限流（429 状态码），增大 retry_delay_seconds 到 5 或 10 可能更有效。

batch 对象

max_chars_per_item 特别说明：工程图纸中偶尔会出现超长的注释文本（如几条合并的施工说明）。此字段限制了每条待翻译文本的最大字符数。如果某条文本超过此限制，同文会将其拆分为多条发送或在截断处标记。如果您经常遇到超长文本被截断导致翻译不完整的问题，可以适当增大此值到 3000 或 4000。但请注意：单条文本过长会增加单次 API 调用的 token 消耗，并可能影响翻译的上下文连贯性。

11.9 启动器配置 launcher.json

launcher.json 位于 文档\Tongwen\launcher.json，用于保存启动器页面（🚀）的配置信息。

11.9.1 配置文件示例

{
  "default_autocad_version": "2025",
  "plugin_registration": {
    "2019": true,
    "2021": true,
    "2025": true,
    "2026": false
  },
  "last_used_version": "2025"
}

11.9.2 字段说明

11.9.3 插件注册状态

plugin_registration 中的每个条目对应一个 AutoCAD 版本的插件注册状态：

• true：该版本的 AutoCAD 已经注册了同文插件。启动该版本 AutoCAD 时，同文侧边面板会自动加载。
• false：该版本的 AutoCAD 尚未注册同文插件，或注册失败。您需要在启动器页面中点击对应版本的”注册插件”按钮来完成注册。

注意：手动修改此 JSON 文件的 false 为 true 并不会真正注册插件——插件注册需要实际向 AutoCAD 注册表写入正确的加载项信息。如需注册插件，请在 Studio 启动器页面中操作，或通过同文提供的命令行工具执行注册命令。

11.10 用户数据目录结构总览

为了方便备份、迁移和排查问题，以下是同文所有用户数据目录的完整结构图：

文档\Tongwen\                          ← 用户数据主目录
├── tongwen.p1.json                    ← 全局配置文件
├── launcher.json                      ← 启动器配置
├── deepseek.p1.json                   ← DeepSeek 引擎配置
├── glossaries\                        ← 术语表目录
│   ├── 建筑专业术语.csv
│   ├── 暖通标准术语.xlsx
│   └── ...
├── projects\                          ← 项目数据目录
│   ├── 某商业综合体项目\
│   │   ├── project_info.json          ← 项目元数据
│   │   ├── task_001\                  ← 翻译任务数据
│   │   └── ...
│   └── ...

%LocalAppData%\Tongwen\                ← 应用程序本地数据
├── logs\                              ← 日志目录
│   ├── studio_20250115.log
│   ├── translation_20250115.log
│   └── ...
├── temp\                              ← 临时文件（可安全清理）
└── backups\                           ← DWG 回写前自动备份
    ├── 一层平面图_20250115_143022.dwg
    └── ...

11.11 配置备份与恢复

同文的配置文件和用户数据全部存储在本地，定期备份是防止数据丢失的好习惯。

11.11.1 备份哪些内容

必须备份（配置类）：

建议备份（数据类）：

不需要备份：

11.11.2 一键备份方法

最简单的备份方法是将整个 文档\Tongwen\ 文件夹复制到安全位置（如外置硬盘、云盘同步目录）：

1. 打开文件资源管理器。
2. 在地址栏中输入 %USERPROFILE%\Documents\Tongwen 并回车。
3. 选中所有文件和文件夹，右键 → 复制。
4. 导航到备份目标位置（如 D:\备份\Tongwen_20250115\），右键 → 粘贴。

技巧：建议在文件夹名称中加上备份日期，方便区分不同时间的备份版本。

11.11.3 恢复配置

当您更换电脑或重装系统后，恢复同文配置的步骤如下：

1. 确保新电脑上已安装同文（至少运行过一次，以便生成默认的目录结构）。
2. 关闭 Studio 程序（确保配置文件不被占用）。
3. 将之前备份的 Tongwen 文件夹中的所有文件和子目录复制到 文档\Tongwen\，覆盖已有文件。
4. 重新启动 Studio。
5. 进入设置页面，检查各项配置是否正确加载。
6. 如果有新的 AutoCAD 版本（如从 2025 升级到 2026），需要重新执行 Core Console 检测，并更新 launcher.json 中的版本信息。

11.11.4 API 密钥的迁移注意事项

由于 API 密钥通过 Windows DPAPI 加密存储，且加密与当前 Windows 用户账户绑定，直接将加密数据从一台电脑复制到另一台电脑是无法解密的。

因此，迁移到新电脑后，您需要重新输入 API 密钥：

1. 在新电脑上打开 Studio → 设置页面。
2. 在 API 密钥输入框中重新粘贴您的密钥。
3. 点击”验证”确认密钥有效。
4. 点击”保存设置”。

或者，如果您在多台机器上使用同一个 API 密钥，可以考虑使用环境变量方式（见 11.7.4 节 api_key_env 字段），避免在每台机器上重复输入。

11.12 多用户/多机器配置同步建议

在实际工程团队中，同一个项目可能由多位工程师在不同的电脑上协同翻译。以下是一些配置管理和同步的建议：

11.12.1 使用云盘同步用户数据

将 文档\Tongwen\ 目录设置为云盘同步目录（如 OneDrive、坚果云、Dropbox），可以实现多台机器之间的配置和术语表自动同步。

操作步骤（以 OneDrive 为例）：

1. 确保 OneDrive 已登录并正常运行。
2. 确认 文档 文件夹已在 OneDrive 同步范围内（OneDrive 默认会同步”文档”文件夹，您可以在 OneDrive 设置中确认）。
3. 同文的配置和术语表文件会自动随 OneDrive 同步到云端。
4. 在其他使用相同 Microsoft 账户的电脑上，OneDrive 会自动将文件下载到本地的 文档\Tongwen\。

注意事项：

• API 密钥不支持通过云盘同步——每台机器需要单独配置。
• 如果两台机器同时编辑配置文件，可能产生冲突副本。建议以一台机器为主进行配置修改。
• 日志和临时文件不在 文档\Tongwen\ 下，不会被云盘同步（这反而是好的，避免无谓的网络传输）。

11.12.2 团队统一配置分发

如果团队有多位成员使用同文，您可以为团队准备一份标准配置文件模板，分发给大家：

1. 在一台”标准机”上完成全部配置（语言对、引擎、模型、输出策略等）。
2. 在”标准机”上运行一次 Mock 翻译，验证配置正确。
3. 复制以下文件作为模板：
   • tongwen.p1.json
   • deepseek.p1.json
   • 团队共用的术语表文件（glossaries\ 目录下）
4. 通过内部文件共享、邮件或即时通讯工具分发给团队成员。
5. 每位成员收到后，覆盖自己 文档\Tongwen\ 下的对应文件。
6. 每位成员各自在设置页面配置自己的 API 密钥。

重要：配置文件中不要包含任何 API 密钥明文。分发的模板应将 api_key_env 留空，由每位成员自行配置密钥。

11.12.3 环境变量统一管理 API 密钥（团队/企业场景）

对于有 IT 管理员的团队环境，可以通过组策略或登录脚本统一设置环境变量来管理 API 密钥：

1. IT 管理员在每台工作站的系统环境变量中设置 TONGWEN_DEEPSEEK_KEY，值为团队共享的 DeepSeek API 密钥。
2. 在分发的 tongwen.p1.json 模板中，将 api_key_env 设为 "TONGWEN_DEEPSEEK_KEY"。
3. 同文启动时会自动从环境变量中读取密钥，成员无需手动输入。

优点：密钥集中管理，成员无法看到明文密钥，更换密钥时只需更新环境变量。 缺点：密钥对所有使用该机器的人可见（通过环境变量查看），适用于单人单机的办公环境。

11.13 常见配置问题

问题一：保存设置后，翻译时仍然使用了旧的配置

原因：配置更改后，当前已打开的翻译任务可能缓存了旧的设置。新配置仅对新创建的任务生效。

解决方法：

1. 关闭当前翻译任务（如果任务尚未翻译，可以重新打开）。
2. 在翻译工作区中新建一个翻译任务。
3. 新任务会加载保存后的最新配置。

问题二：修改配置文件后重启 Studio，设置没有生效

原因：JSON 文件存在语法错误（如缺少逗号、引号不匹配、注释等），导致文件解析失败，系统回退到了内置默认值。

解决方法：

1. 用文本编辑器打开对应的 JSON 文件。
2. 检查 JSON 语法是否正确。可以使用在线 JSON 校验工具（如 jsonlint.com）将内容粘贴进去验证。
3. 常见的错误：
   • 最后一个属性或数组元素后多了一个逗号（trailing comma）。
   • 属性名或字符串值未用双引号包围。
   • JSON 文件中包含注释（// 或 /* */）。JSON 标准不支持注释。
4. 修正错误后保存文件，重启 Studio。

问题三：Core Console 检测到，但回写时提示”Core Console 启动失败”

可能原因及解决方法：

问题四：翻译一直显示”请求中…“，但很久没有反应

排查步骤：

1. 打开日志文件夹（设置页面 → 本地目录 → 打开日志文件夹），查看最新的 translation_*.log 文件。
2. 寻找包含 Error、Timeout、HTTP 关键字的内容。
3. 常见原因：
   • API 密钥无效或额度不足 → 在设置页面重新验证密钥。
   • 网络无法访问 api.deepseek.com → 检查网络连接和防火墙规则。
   • 代理设置不正确 → 如果通过代理上网，确认 base_url 指向了正确的代理地址。
   • timeout_seconds 设置过短 → 尝试增大到 120。
4. 如果日志显示持续 429 Too Many Requests，说明触发了 API 限流。请在 deepseek.p1.json 中增大 retry_delay_seconds，或降低 batch_size。

问题五：翻译结果中的术语与术语库不一致

可能原因：

1. 模型选择问题：flash 模型的术语遵守能力弱于 pro。尝试切换到 pro 模型。
2. temperature 设置过高：检查 deepseek.p1.json 中的 temperature 值。对于要求严格术语一致的场景，建议设为 0.1 或更低。
3. 术语库格式问题：确认术语表文件格式正确（CSV 编码为 UTF-8，列名为 源术语,目标术语）。
4. 术语库未加载：在翻译工作区中确认当前任务已关联了正确的术语表。
5. 批次大小过大：batch_size 过大时，模型在处理大批次文本时可能忽略术语约束。尝试降低 batch_size 到 10 或 5。

问题六：如何查看 API 调用量和费用

DeepSeek 的 API 调用量和费用查询不在同文产品内完成，您需要登录 DeepSeek 开放平台：

1. 访问 https://platform.deepseek.com/。
2. 登录您的账户。
3. 进入控制台（Dashboard）。
4. 在”Usage”（用量）页面，可以查看按日期分布的 API 调用次数、消耗的 token 数和费用明细。
5. 建议定期查看，了解翻译成本，必要时调整 model 和 batch_size 来优化成本。

问题七：输出文件中文字体显示为问号或乱码

这不是配置问题，但常被用户误认为是设置错误。原因和解决方法如下：

原因：目标语言的字体文件未安装在系统中，或者 DWG 文件的文字样式中指定的字体不支持目标语言（例如指定了仅含中文字形的 SHX 字体来显示英文）。

解决方法：

1. 在 AutoCAD 中打开翻译后的 DWG 文件。
2. 执行 STYLE 命令，打开文字样式管理器。
3. 找到显示异常的字体所对应的文字样式。
4. 将字体更改为支持目标语言 + 源语言的字体（例如 Arial、SimSun、微软雅黑）。
5. 如果使用了 SHX 大字体，确保大字体文件 （.bigfont） 支持目标语言的字符集。

本章小结

本章从设置页面的四个分区出发，逐步深入到三个核心配置文件的每个字段，覆盖了从日常使用到高级调优的全部内容。要点回顾：

1. AutoCAD 检测是同文工作的基础，确保 Core Console 路径正确是使用前的第一要务。
2. 输出设置根据您的工作习惯三选一，推荐”与原文件同目录”作为起点。
3. 翻译引擎配置是最核心的环节：选对语言对、选好模型（日常用 flash，交付用 pro）、配好 API 密钥。
4. 本地目录管理是日常维护的一部分——定期清理日志和临时文件，备份配置和术语表。
5. 配置文件提供了比设置页面更细致的调优能力，理解每个字段的含义后，您可以精确控制翻译行为。
6. 配置备份是防范数据丢失的最低成本保险——花一分钟复制文件夹，省去数小时的重配置时间。

如有任何配置相关的问题未在本章中覆盖，请通过产品官网 https://shandianweihu.com/ 联系技术支持团队获取帮助。