Communitygithub.com

Revayat — 英语→波斯语书籍翻译技能

将整本书籍翻译成出版级波斯语，并构建专业的Word文件：支持扫描PDF和混合PDF的OCR、保留原始尺寸的插图、Word原生脚注、可点击目录、从右到左排版以及锁定名称词汇表。适用于Claude Code、Kiro、Codex、Cursor和Cline。

Revayat — 英语→波斯语书籍翻译技能 是什么？

Revayat是一个专业的AI代理技能，专为将整本英语书籍翻译成出版级波斯语（波斯学）而设计，最终输出为高质量的Microsoft Word (.docx)文件。它拥有全面的流水线，有九个严格排序的步骤，涵盖从提取（包括对扫描或混合PDF进行OCR，借助MinerU分离插图）到最终验证的整个过程。该技能执行关键规则：从不反转波斯文本以强制从右到左方向（依赖构建器）、从不更改 `@@ id` 头或手编辑 `book.json` 进行翻译（强制通过工作表进行修复）、通过 `[[fn:…]]` 标记和 `**粗体**`/`*斜体*` 等内联格式保留原脚注的完整性和格式完整性。其核心翻译步骤使用子代理，每个子代理接收详细的指令，确保独立翻译每个句子单元，同时遵循锁定词汇表、上下文特定名称介绍和严格的格式保留（包括无法翻译的标记）。QA步骤验证各种指标，例如未翻译的块、丢失/伪造的脚注标记、可能遗漏、锁定词汇表的偏移以及OCR置信度，以防用户从有问题的基础文本开始。构建器生成一个完全成型的Word文件，具有从右到左排版（例如使用Vazirmatn字体）、可点击目录、Word原生脚注和保留原始尺寸的插图，突出显示它适应波斯语言和文件格式的独特特性。该技能与一系列AI代理工具（Claude Code、Codex、Cursor、Cline、Kiro）兼容，使其成为需要专业级、文化准确的波斯语书籍翻译的出版商、翻译人员或内容创作者的强大工具。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add KiaroSama/Revayat-Skill
查看原文→浏览所有技能

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

文档

Revayat — 英语 → 波斯语书籍翻译

按顺序执行以下九个步骤。每个步骤包含一个命令及其输出处理规则。不要擅自改变顺序，也不要因为上一步看起来没问题就跳过任何步骤。

设置两个变量，然后在各处使用它们：

  • SKILL_DIR — 存放此文件的文件夹。在 Claude Code 插件中，它为 ${CLAUDE_PLUGIN_ROOT}/skills/revayat。
  • WORK — 用于处理本书的工作文件夹，例如 work/。

每个命令都是 python3 $SKILL_DIR/scripts/revayat.py <阶段> …。

五项绝不可违反的规则

  1. 切勿反转波斯语文本 使其从右向左读取。方向由构建器设置。反转会产生一个除特定查看器外处处出错的文件。
  2. 切勿编造、删除、合并、拆分或重排 @@ id 标题。 原样返回你收到的标题。
  3. 切勿删除 [[fn:…]]、**粗体**、*斜体* 或 `原样` 标记。 这些标记会被计数；不匹配会导致 QA 失败。
  4. 切勿手编辑 book.json 来修复翻译。 请修复工作表并重新运行合并。
  5. 切勿缩短书籍。 不得概括、跳过难句或弱化内容。如果某一步报告内容缺失，请重新运行该块。

步骤 1 — 检查工具

python3 $SKILL_DIR/scripts/revayat.py doctor
  • "ready": true → 继续。
  • "ready": false → 运行 pip install -r $SKILL_DIR/requirements.txt，然后重新运行 doctor。
  • optional_tools 显示 not found 暂时可以。步骤 2 会告诉你是否真的需要 OCR。

步骤 2 — 提取

python3 $SKILL_DIR/scripts/revayat.py extract "<输入文件>" --out $WORK

对于波斯语源文件，添加 --ocr-lang fas。对于其他语言，使用 Tesseract 代码（deu、fra、ara 等）。

读取它打印的 JSON 并按照下表操作：

你看到的内容你需要做什么
"kind": "digital"无需操作；不需要 OCR
"kind": "scanned" 或 "mixed"OCR 已自动运行；检查 ocr.probe_after.text_share 是否高于 0.7
报错提及 OCRmyPDF按消息提示安装，然后重新运行此步骤
clean_scan.cleaned 大于 0已从相应页面移除彩色水印
ocr.warning 不为 null阅读该警告；文件仍可用，请继续
page_scans_dropped 大于 0已将相应数量的整页光栅视为扫描本身而非图片

清理器永远不会编辑你的文件：原始文件保持不变，清理后的副本写入 $WORK/cleaned.pdf，并在 clean_scan 中为每一页记录删除了什么、保留了什么。传递 --clean-scan off 可完全跳过它，或传递 --clean-scan force 以处理残留印章的情况。

如果书籍是扫描版，请立即执行以下两个额外步骤。

识别置信度 — 没有它，误读的词与正确的词无法区分，因为两者都是流利的波斯语：

python3 $SKILL_DIR/scripts/revayat.py ocr-sidecar   --pdf $WORK/ocr.pdf --out $WORK --lang fas --book $WORK/book.json

这将写入 source.ocr.json（每个词、行、块和页面：边界框、置信度、阅读顺序以及执行的预处理）和 source.ocr.txt，然后在 book.json 中为每个块标记其来源区域的置信度。分级为 low 的块会被 qa check 报告为 ocr-low-confidence，接受一个意味着查看页面图像。阈值默认为 85 和 60，可通过 --high / --low 调整。

扫描版内的插图 — 扫描页是一张平面图像，因此上面的照片不会自动成为独立图片：

mineru -p $WORK/cleaned.pdf -o $WORK/mineru -b pipeline -l arabic
python3 $SKILL_DIR/scripts/revayat.py extract "<输入文件>" --out $WORK   --figures-from-mineru $WORK/mineru

在 cleaned.pdf 上运行 MinerU，不要在原始文件上运行，否则它会将水印裁剪为图片。仅从 MinerU 获取图片。 它自身对波斯语的识别文本会返回词及其内部字母都反转的结果；使用 fas 的 Tesseract 能正确读取同一页面，因此文本保持不动。当 MinerU 在某个页面范围上运行时，使用 --figures-page-offset N。

然后在继续之前查看结果：

python3 $SKILL_DIR/scripts/revayat.py qa check --book $WORK/book.json --allow-incomplete

此处忽略 untranslated-block — 尚未进行任何翻译。你只需关注 asset-missing。如果对于一本真实书籍，stats.text_blocks 低于 20，则提取失败：请参阅 references/extraction.md。

步骤 3 — 词汇表

python3 $SKILL_DIR/scripts/revayat.py glossary scan \
  --book $WORK/book.json --out $WORK/glossary.json

报告列出 needs_persian，最频繁的在前。打开 $WORK/glossary.json，为前 20 个条目中的每一个填写四个字段：

"target":      "الیزابت بنت",
"later_form":  "الیزابت بنت",
"first_form":  "الیزابت بنت (Elizabeth Bennet)",
"locked":      true

保持 first_block_id 完全不变 — 流水线用它来决定哪个单个块引入该名称。不要编辑它，也不要自行决定首次提及的位置。

删除非真实名称的条目。然后继续。

步骤 4 — 分块

python3 $SKILL_DIR/scripts/revayat.py chunk build \
  --book $WORK/book.json --out $WORK/chunks --glossary $WORK/glossary.json

注意块的数量。每个块成为一个翻译任务。

如果你已经翻译了一些工作表，而输入文件后续发生了变化，此步骤会拒绝执行并在 "refused" 中给出原因 "stale-worksheets"，而不是静默地提供不再匹配书籍的工作表。重新阅读给出的原因；仅当你确定现有翻译仍然可用时才添加 --force。

步骤 5 — 翻译

对于每个 $WORK/chunks/chunkNNNN.md，生成 $WORK/chunks/out_chunkNNNN.md。如果你的运行环境中有子代理，则每个块使用一个独立的子代理，一次最多 8 个。如果没有，则逐个执行 — 结果相同，只是速度较慢。

向子代理提供以下精确指令：

读取 $WORK/chunks/chunkNNNN.md 并写入 $WORK/chunks/out_chunkNNNN.md。

翻译成波斯语。首先读取 $SKILL_DIR/references/translation-policy.md 并遵守它。

输出格式 — 这是机械性要求，必须完全正确：

  • 逐行复制每个 @@ <id> <kind> 行，保持原样，顺序不变。
  • 在其下方行上放置波斯语翻译。
  • 不输出其他任何内容：无前言，无英语，无评论，无摘要。

规则：

  • “名称”表格具有约束力。如果某行说“首次提及，在此处介绍”，则使用较长形式。所有其他情况使用短形式。不要自行决定 — 表格已经决定好了。
  • “周围文字”仅作为上下文。切勿翻译或复制它们。
  • 保持 **粗体**、*斜体*、`原样` 和 [[fn:…]] 完全不变，放在对应的波斯语词周围。不要添加或删除任何标记。
  • 完全翻译每个单元。切勿概括或跳过。
  • 要添加自己的脚注：在句子中写入 [[fn:tr-01]]，并在末尾添加一个包含其文本的 @@ tr-01 footnote 块。仅用于真正的文化引用或文字游戏。

随时检查剩余进度：

python3 $SKILL_DIR/scripts/revayat.py chunk status --chunks $WORK/chunks

步骤 6 — 合并

python3 $SKILL_DIR/scripts/revayat.py merge --book $WORK/book.json --chunks $WORK/chunks
字段含义操作
"ok": true所有内容已归位继续到步骤 7
missing_outputs这些块从未被翻译翻译它们
missing_units标题被删除重新运行这些块
unknown_units标题被编造重新运行这些块

修复后重新运行合并始终是安全的。

步骤 7 — 波斯语排版

python3 $SKILL_DIR/scripts/revayat.py falint fix --book $WORK/book.json

仅涉及机械性操作，可安全运行两次。如果书籍必须保留拉丁数字，添加 --digits keep。

步骤 8 — 门控，然后构建

python3 $SKILL_DIR/scripts/revayat.py qa check \
  --book $WORK/book.json --assets $WORK/assets --glossary $WORK/glossary.json

当 "ok" 为 false 时不要构建。 根据错误代码进行修复：

代码含义操作
untranslated-block某个块没有波斯语翻译该块
footnote-marker-lost某个 [[fn:…]] 被删除重新运行该块
footnote-marker-invented某个标记指向空处重新运行该块
possible-omission目标文本远短于源文本阅读它；通常是一个从句被删除
untranslated英语残留在波斯语中重新运行该块
asset-missing / asset-modified图片丢失或更改重新提取
copied-source-run源文本的某个从句存在于波斯语中重新运行该块
duplicate-translation两个不同源文本得到相同波斯语某份工作表回复被粘贴两次；重新运行两者
first-mention-repeated名称在多个地方被介绍保留第一个，删除其余
image-order包内图片顺序错误重新构建
bookmarks-missing / bookmark-duplicate目录链接到不存在或错误的地方重新构建
emphasis-parity（警告）粗体/斜体计数变化随机检查一个；通常没问题
glossary-drift（警告）锁定名称渲染方式不同重新运行该块
ocr-low-confidence（警告）引擎对该块不确定打开页面图像并比较

对于出版工作，添加 --strict 以使最后三个也变为阻塞性错误。

将书籍的标题和作者翻译到 book.json 中的 meta.title_target 和 meta.author_target — 这是唯一一次预期的手动编辑，因为没有对应的工作表。

然后构建：

python3 $SKILL_DIR/scripts/revayat.py build \
  --book $WORK/book.json --assets $WORK/assets --out out/book.fa.docx \
  --font "Vazirmatn" --size 11.5

有用的标志：当文件必须在没有波斯语字体的机器上渲染时，使用 --font Tahoma；--heading-size source 可重现原始标题字号；--template ref.docx 可从现有 Word 文件继承样式。完整列表请参阅 references/docx-and-ooxml.md。

步骤 9 — 验证并报告

python3 $SKILL_DIR/scripts/revayat.py qa docx --file out/book.fa.docx --book $WORK/book.json

如果 "ok": false，请先修复它再告知用户文件已就绪。

然后报告：文件位置、章节数、图片数和脚注数、任何 QA 标记但您选择不处理的内容，以及以下限制声明 —

Word 会重新排列文本，因此可编辑的波斯语文档无法在页面上与源 PDF 完全一致。图片字节和物理尺寸、章节结构、强调、脚注和章节链接是精确的。

参考文献

仅在步骤指向它们时阅读这些文件：

  • references/translation-policy.md — 提供给翻译子代理的内容
  • references/persian-typography.md — 从右到左、ZWNJ、标点、混合脚本
  • references/extraction.md — OCR 路由、水印、难以处理的书籍
  • references/glossary-and-voice.md — 命名策略、别名、角色语态
  • references/docx-and-ooxml.md — 每个构建选项及其生成内容
  • references/troubleshooting.md — 你最可能遇到的失败

相关技能

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community