开源简历工具 YAMLResume 更新： AI 翻译、智能编辑器和多语言简历样例

hey 各位好，

YAMLResume 最近连续发布了 v0.15 和 v0.16 ，想来分享一下这两次更新。

YAMLResume 是一个用 YAML 管理简历的开源工具。简历内容可以放进 Git 做版本管理，并生成 PDF 、HTML 、Markdown 等格式。这两版主要补齐了多语言、编辑体验和 Node.js 集成方面的能力。

v0.16：AI 翻译、智能编辑器和 Node.js API

1. 用 AI 翻译整份简历

新增了 yamlresume ai translate 命令，可以把已有简历翻译成 YAMLResume 支持的其他语言：

export OPENAI_API_KEY=sk-...

yamlresume ai translate \
  --to zh-hans \
  resume.en.yml \
  resume.zh-hans.yml

目前支持 12 种语言和地区格式，包括简体中文、繁体中文、英语、日语、德语、法语、西班牙语等。

这里不是简单地让模型重新生成一份文本。翻译过程中会尽量保留：

YAML 的字段、顺序、注释和布局配置
URL 、邮箱、电话号码、日期和地点
学位、语言水平、技能等级等 Schema 枚举值
原有章节、条目和多段文本结构

翻译结果写入文件前还会经过 YAMLResume Schema 校验；如果校验失败，错误信息会反馈给模型并自动重试。模型、Provider 、Base URL 和重试次数都可以配置。

2. Playground 支持 Schema 感知编辑

YAMLResume Playground 不再只是一个普通的 YAML 编辑器。接入 monaco-yaml 和 YAMLResume JSON Schema 后，现在支持：

字段和预定义值自动补全
实时格式与 Schema 校验
字段悬浮文档
本地 Web Worker 中运行的 YAML Language Server

编辑简历时，字段拼错、层级不对或枚举值无效会直接提示，比对着文档手写方便不少。

一个简单的 demo： https://www.bilibili.com/video/BV17ktd6FEoG

体验地址：https://yamlresume.dev/playground

3. 新增 `@yamlresume/node`

这一版把原来 CLI 中依赖 Node.js 的运行时抽成了独立包：

npm install @yamlresume/node

可以直接在 Node.js 应用中读取、校验和构建简历：

import { buildResumeFile, readResumeFile } from '@yamlresume/node'

const { resume, validated, errors } = readResumeFile('resume.yml')
const { outputs } = await buildResumeFile('resume.yml', {
  output: 'dist',
})

还提供文件监听、新建简历、AI 生成和 AI 翻译等 API 。对一些自动化场景会比较有用。

4. LaTeX 构建更可靠

LaTeX 的页码和交叉引用有时需要多轮编译才能稳定。以前长简历可能要手动执行两次构建；现在会检测 .aux 文件变化并自动进行额外编译，一次命令即可得到正确结果。

v0.15：内置多语言简历样例

v0.15 新增了 @yamlresume/samples，首批提供 5 类岗位样例：

软件工程师
数据分析师
数据科学家
产品经理
UX 设计师

每个样例都有 12 种语言和地区版本。可以先查看已有样例：

yamlresume samples list

然后按岗位和语言创建简历：

yamlresume new my-resume.yml \
  --sample software-engineer \
  --language zh-hans

生成的文件会保留 Schema 提示注释和默认布局，可以直接修改和构建。yamlresume new 默认也会从软件工程师样例开始，对第一次使用的人更友好。

此外，yamlresume ai generate 新增了 --retry 参数，可以控制 AI 生成结果校验失败后的重试次数：

yamlresume ai generate \
  --position "Software Engineer" \
  --language zh-hans \
  --retry 5 \
  resume.yml

安装与升级

npm install -g yamlresume@latest

# 或者使用 Homebrew
brew install yamlresume

# or
brew upgrade yamlresume

项目主页：https://yamlresume.dev

GitHub：https://github.com/yamlresume/yamlresume

v0.15 更新说明：https://yamlresume.dev/blog/v0.15

v0.16 更新说明：https://yamlresume.dev/blog/v0.16

如果大家平时会用 Markdown 、JSON Resume 、LaTeX 或其他方式维护简历，也很想听听你们对这类工具的看法。欢迎试用、提 Issue ，或者分享你希望后续加入的功能。