visa-doc-translate

visa-doc-translate 技能概览

visa-doc-translate 是一个工作流技能，用于把签证申请材料图片转换成“双语 PDF”，左侧保留原始页面，右侧给出英文译文。它最适合需要快速、结构化翻译证明材料的用户，例如银行存款证明、在职证明、退休证明、收入证明、房产记录、营业执照或身份证件。

visa-doc-translate 的用途

visa-doc-translate skill 的目标很明确：把图片文件中的文字可靠提取出来，专业地翻译，并尽量保留文档结构，满足签证审查场景的使用需求。它不是通用翻译提示词，而是面向文档处理的工具，尤其看重版式、日期、姓名和金额这些关键信息。

谁应该安装它

如果你经常处理扫描件或拍照版签证材料，希望有一套可重复使用的流程，而不是每次临时发挥，那么就应该安装 visa-doc-translate。当你需要双语输出、需要 OCR 兜底方案，或者希望技能自动处理旋转和 HEIC 转换时，它尤其有用。

它有什么不同

和普通的“把这张图片翻译一下”提示词相比，visa-doc-translate 把文档场景常见处理直接内置进去了：图像转换、EXIF 旋转、OCR 方法回退以及 PDF 输出格式。这让它在签证材料场景里更稳，因为漏掉一个数字、读错一个姓名，结果就可能直接失效。

如何使用 visa-doc-translate 技能

安装 visa-doc-translate

使用仓库上下文中引用的安装命令：

npx skills add affaan-m/everything-claude-code --skill visa-doc-translate

安装后，确认该技能已经在你的环境中可用，并且可以通过文档图片路径调用它。如果你的工作流不是 Claude Code，不要默认同样的命令语法在所有环境里都能直接使用，而是要把这套技能逻辑适配到你的 agent 或脚本执行器中。

传入正确的输入

visa-doc-translate usage 的使用方式很简单：传本地图片文件，而不是一句模糊的任务描述。更好的输入示例如下：

• /visa-doc-translate ./documents/BankStatement.HEIC
• /visa-doc-translate ./scan/employment-certificate.jpg

如果想要更好的输出，建议在提示里补充文档类型和特殊要求，例如“公司名称保留原文”或“金额和日期必须逐字保留”。这样能帮助技能更安全地选择术语和排版方式。

先阅读这些文件

为了最快上手，先看 SKILL.md，再看 README.md。这两个文件会说明预期流程、支持的文档类型、输出形态以及所需库。由于这个仓库没有额外的辅助目录，这两个文件基本承载了 visa-doc-translate guide 的主要实现意图。

会影响结果的工作流建议

尽量使用干净、端正的扫描件；如果做不到，就依赖技能内置的旋转和 OCR 回退能力。HEIC 文件如果本来就是源格式，可以先保持原样，技能会处理转换。想要更好的翻译质量，要尽量避免裁掉边缘、对比度过低，以及“截图的截图”，因为这些都会在翻译开始前先降低 OCR 准确率。

visa-doc-translate 技能常见问题

visa-doc-translate 只适用于签证材料吗？

是的，这个技能主要面向签证相关证明文件。你可以把它适配到类似的官方材料上，但 visa-doc-translate skill 最有说服力的使用场景，仍然是那些需要保留版式并提供英文译文以供申请审查的文档。

需要先安装 OCR 工具吗？

通常需要，因为这个技能依赖于你当前环境里可用的 OCR 路径。仓库里列出了 macOS Vision、EasyOCR 和 Tesseract 作为回退选项。如果你要安装 visa-doc-translate，请先检查环境再用于生产，尤其是在非 macOS 系统上批量处理文档时更要注意。

它比普通翻译提示词更好吗？

对于文档图片来说，是的。通用提示词也许能翻译文字，但往往会漏掉旋转处理、文本提取和 PDF 组装。visa-doc-translate 加入了官方材料更需要的流程控制：转换、OCR 回退、结构保留以及双语输出。

什么时候不该用它？

当你只需要大致摘要、源文件本来就是干净的文本 PDF，或者你需要的是法律意见而不是翻译时，不要使用它。如果图片损坏严重或几乎不可辨认，技能仍然可能产出草稿，但你应当预期需要人工修正。

如何改进 visa-doc-translate 技能

提供更干净的源材料

质量提升最大的地方，通常不是模型，而是输入图片。运行 visa-doc-translate 之前，先裁掉无关边框，确保文字清晰可读，尽量使用整页图片而不是局部截图。如果文档明显是横着或倒着的，且从文件名或拍摄环境就能看出来，建议直接在提示里说明。

明确哪些内容必须保留

这个技能在你明确签证审查最在意的约束时效果最好：姓名必须准确、护照号要原样保留、日期和币种格式不能改、官方标签不要意译。如果中文姓名需要转成拼音，不要默认它会自动猜对，应该在提示里明确说明。

对照原图检查输出

第一次生成后，把 PDF 译文和原始图片逐项对照，重点看数字、日期、印章文字和机构名称。如果有问题，直接指出具体行或字段来迭代，不要笼统地要求“重新翻得更准确”。这种方式比泛泛地说“更准确一点”更能得到好的 visa-doc-translate 结果。

用文档类型上下文增强提示

visa-doc-translate for Translation 这个工作流在你先点明文档类别后会更强，比如银行证明、在职证明或房产证明。这样技能更容易选择自然的签证材料术语，避免用过于通用的翻译选择把正式措辞变平。