ByteNoteByteNote

字节笔记本

2026年3月13日

Immersive Translate Prompts:沉浸式翻译 AI 专家插件

API中转
¥120

本文介绍 Immersive Translate Prompts,沉浸式翻译的 AI 专家插件系统。该项目提供了通过定制化 AI 翻译策略来提高翻译质量的完整指南,包括 AI 专家的配置规范、本地调试方法、变量支持等,是创建高质量翻译插件的专业参考。

项目简介

Immersive Translate Prompts 是沉浸式翻译的 AI 专家插件仓库。项目通过精心设计的提示词(Prompts)实现专业化的翻译策略,用户可以安装不同的"AI专家"来满足多样化的翻译需求,如金融专家、学术论文专家、文学翻译专家等。

核心特性

  • AI 专家系统:可定制的 AI 翻译策略
  • 多领域支持:金融、学术、文学等专业翻译
  • 插件化架构:易于安装和切换专家
  • 本地调试:支持自定义 AI 助手
  • 变量支持:灵活的提示词变量
  • 社区贡献:开放的贡献机制

如何使用 AI 专家

在沉浸式翻译中使用

  1. 打开沉浸式翻译设置页面
  2. 找到【AI专家】Tab
  3. 安装需要的"AI专家"
  4. 在插件面板中选择专家
  5. 开始翻译

默认专家

  • 通用:适合大多数场景的默认翻译策略

如何贡献 AI 专家

贡献方式

方式一:发起 Issue

如果你不具备编写 Prompts 文件的能力:

  1. GitHub Issues 发起讨论
  2. 描述你想要的 AI 专家
  3. 社区会帮助你实现

方式二:提交 PR

如果你可以编写 Prompts:

  1. Fork 本仓库
  2. 参考 plugins/ 文件夹下的现有格式
  3. 创建或修改 AI 专家文件
  4. 提交 Pull Request

参考格式

yaml
// 基础信息
id: custom
version: 1.0.0
name: Financial Expert
description: 专业金融领域翻译
avatar: https://example.com/avatar.png
details: 该专家专为专业金融领域翻译而设计
author: Your Name
homepage: https://example.com

// 多语言支持(必需)
i18n:
  zh-CN:
    name: 金融专家
    description: 特别为金融领域优化
    details: 适合翻译财经、金融类文章
  zh-TW:
    name: 金融專家
    description: 特別為金融領域優化
    details: 適合翻譯財經、金融類文章

// 提示词
env:
  sourceText: 源文本
  targetText: 翻译文本

systemPrompt: 你是一位专业的金融翻译专家...

prompt: 翻译以下金融文本...

multiplePrompt: 批量翻译以下文本...

subtitlePrompt: 翻译以下字幕...

本地调试

开发者设置

  1. 打开沉浸式翻译设置
  2. 找到【开发者设置】
  3. 选择【Custom AI Assistant】
  4. 编辑 YAML 格式配置

调试流程

bash
# 1. 创建自定义专家
# 编辑 plugins/my-expert.yaml

# 2. 本地测试
# 在开发者设置中加载

# 3. 验证效果
# 翻译测试文本

# 4. 调整优化
# 根据结果调整提示词

AI Prompt 配置

支持的变量

在提示词中可使用以下占位符:

变量说明
sourceText源文本字段
targetText翻译文本字段
sourceSubtitle源字幕字段
targetSubtitle翻译字幕字段
sourceLanguage源语言
targetLanguage目标语言

提示词类型

systemPrompt

系统级别的提示,定义 AI 专家的角色和功能:

yaml
systemPrompt: |
  你是一位专业的翻译专家,专注于:
  - 准确传达原文含义
  - 保持专业术语一致性
  - 适应目标语言习惯

prompt

单句翻译的提示词:

yaml
prompt: |
  将以下文本从 {sourceLanguage} 翻译为 {targetLanguage}:
  {sourceText}

  要求:
  - 保持专业术语准确
  - 符合目标语言习惯

multiplePrompt

多段翻译的提示词(保存更多上下文):

yaml
multiplePrompt: |
  翻译以下文本段落,保持上下文连贯性:

  段落 1: {sourceText1}
  段落 2: {sourceText2}
  段落 3: {sourceText3}

subtitlePrompt

字幕翻译的提示词(处理多句断句):

yaml
subtitlePrompt: |
  翻译以下字幕,注意时间轴和断句:
  {sourceSubtitles}

配置文件规范

必需字段

yaml
id: unique-id          # 唯一标识符
version: 1.0.0          # 版本号
name: Expert Name      # 名称(唯一)
description: Text      # 描述
i18n:                  # 多语言支持(至少 zh-CN、zh-TW)
  zh-CN:
    name: 专家名称
    description: 描述
  zh-TW:
    name: 專家名稱
    description: 描述

可选字段

yaml
avatar: https://example.com/image.png   # 头像 URL
details: 详细信息(支持 markdown 和 html)
author: 作者名称
homepage: https://example.com         # 主页

提示词字段

yaml
systemPrompt: 系统提示
multipleSystemPrompt: 多段系统提示
prompt: 单句翻译提示
multiplePrompt: 多段翻译提示
subtitlePrompt: 字幕翻译提示

实际案例

GitHub 专家

yaml
id: github
version: 1.0.0
name: GitHub Expert
description: 专业的 GitHub 相关内容翻译
avatar: https://github.githubassets.com/favicon.ico
details: 专注于 GitHub 仓库、代码、技术文档的翻译
i18n:
  zh-CN:
    name: GitHub 专家
    description: 适合翻译 GitHub README、文档等
    details: 专业翻译 GitHub 相关内容
  zh-TW:
    name: GitHub 專家
    description: 適合翻譯 GitHub README、文檔等
    details: 專業翻譯 GitHub 相關內容
author: Community
homepage: https://github.com

systemPrompt: |
  你是一位精通 GitHub 的技术翻译专家,熟悉:
  - Git 和 GitHub 工作流
  - 开源社区文化
  - 技术术语规范

prompt: |
  将以下 GitHub 内容翻译为 {targetLanguage}:
  {sourceText}

  注意:
  - 保留专业术语(如 pull request、commit)
  - 保持代码示例不变
  - 遵循 GitHub 风格指南

金融专家

yaml
id: financial
version: 1.0.0
name: Financial Expert
description: 专业金融领域翻译
i18n:
  zh-CN:
    name: 金融专家
    description: 特别为金融领域优化
  zh-TW:
    name: 金融專家
    description: 特別為金融領域優化

systemPrompt: |
  你是一位专业的金融翻译专家,精通:
  - 金融术语规范
  - 财经专业表达
  - 国际金融标准

prompt: |
  翻译以下金融文本:
  {sourceText}

  要求:
  - 使用标准金融术语
  - 准确传达数字和比率
  - 保持专业性

提交指南

PR 流程

  1. Fork 仓库

    bash
    git clone https://github.com/your-username/prompts.git
  2. 创建分支

    bash
    git checkout -b feature/my-expert
  3. 添加专家

    bash
    # 在 plugins/ 目录创建 YAML 文件
    cp plugins/github.yaml plugins/my-expert.yaml
    # 编辑文件
  4. 测试验证

    bash
    # 在沉浸式翻译中测试
    # 验证翻译质量
  5. 提交 PR

    bash
    git add .
    git commit -m "Add: my expert"
    git push origin feature/my-expert
    # 在 GitHub 上创建 PR

PR 审查标准

  • 遵循 YAML 格式规范
  • 包含完整的 i18n 配置
  • 提示词经过测试验证
  • 文档清晰完整
  • 遵循现有代码风格

本地开发

环境设置

bash
# 克隆仓库
git clone https://github.com/immersive-translate/prompts.git
cd prompts

# 安装依赖(如果有)
npm install

# 启动开发服务器
npm run dev

测试工具

bash
# 验证 YAML 格式
npm run validate

# 测试提示词
npm run test --expert=github

# 批量测试
npm run test:all

最佳实践

1. 提示词设计

  • 明确角色:清晰定义 AI 专家身份
  • 具体要求:提供详细的翻译指导
  • 示例驱动:包含正面和反面示例
  • 上下文感知:考虑文本的上下文环境

2. 变量使用

yaml
# 正确使用变量
prompt: |
  翻译从 {sourceLanguage} 到 {targetLanguage}:
  {sourceText}

# 避免过度使用变量
prompt: |
  简单翻译:{sourceText}

3. 多语言支持

yaml
# 至少支持简体和繁体中文
i18n:
  zh-CN: ...
  zh-TW: ...
  # 可选:en, ja, ko 等

4. 版本管理

yaml
# 遵循语义化版本
version: 1.0.0  # MAJOR.MINOR.PATCH

资源链接

相关项目

项目链接

分享: