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 ,或者分享你希望后续加入的功能。