Steam 创意工坊与词库管理

TransBox 的主题、术语库、语言包、翻译引擎等都可以做成 扩展（MOD）。玩家可在 Steam 创意工坊 订阅；开发者可放到本地目录热调试。

入口：设置中心 → 扩展工坊。

---

1. 扩展工坊面板

• 双轨模式
  • Steam 创意工坊模式：订阅的 MOD 会被扫描加载（Steam AppID：1316080）。
  • 本地独立扩展模式：使用本机 extensions 目录（开发调试用）。
• 分类筛选：字幕主题、专有术语库、流水线中间件、ASR / MT / TTS、UI 语言包、输入源/字幕等。
• 状态标签：正在生效、内置、工坊、已启用、已停用、常驻基底等。
• 操作：刷新、浏览 Steam 创意工坊、打开本地 MOD 目录、导出、配置、启用/停用。
• 安全重置：一键停用所有第三方扩展，回到可启动基线。
• 首次进入会看到 社区扩展与 MOD 安全须知：纯数据包（主题/词库/语言包）风险较低；代码脚本类插件与主程序同权限运行，请只安装可信来源。

在 Steam 创意工坊网页点「订阅」后，回到软件点 刷新 即可看到。无需每次重启。

---

2. 专有术语库（解决机翻错名）

通用模型会把游戏黑话、人名、药名译歪。术语库在翻译前后做强制映射，并可注入提示词。

推荐格式：terms.json

{
  "Elden Ring": "艾尔登法环",
  "Tarnished": "褪色者",
  "Malenia": "玛莲妮亚"
}

或数组形式：

[
  { "src": "Elden Ring", "tgt": "艾尔登法环" }
]

文本格式：terms.txt / terms.tsv

• 空行忽略；# 开头为注释；
• 分隔符只能是 = 或 Tab（\t）；
• 不支持 -> 或 =>（这两种旧写法会被整行丢弃）。

# 正确
Elden Ring=艾尔登法环
Tarnished	褪色者

错误示例（不要用）：

Elden Ring -> 艾尔登法环
Elden Ring => 艾尔登法环

软件内置示例：《艾尔登法环》游戏专有术语库（terms.json）。在扩展工坊启用后，翻译管道会应用这些词条。

---

3. 字幕主题与 UI 语言包

• 主题：改配色、透明度、可选 QML 视觉组件。全量主题（style_layer: full）通常互斥，一次只启用一个。
• 语言包：启用即切换界面语言；缺失词条会回退到官方英语/中文。第三方语言包之间互斥。

悬浮条上的 界面语言 按钮可在已启用语言间循环。

---

4. 安全建议

1. 优先订阅 术语库 / 主题 / 语言包 这类数据型扩展。
2. 安装 Python 引擎 / 中间件 前确认作者与源码。
3. 出问题先用扩展工坊的 安全重置，再逐个排查。
4. 不要把 API Key 写进要上传到工坊的文件；客户端配置里用密码型输入框保存的密钥会留在本机。

---

5. 我是开发者？

请阅读开发者中心的 插件规范 与 工坊打包发布。
本地调试：设置 → 扩展工坊 → 打开本地 MOD 目录 → 放入你的文件夹 → 刷新。