resume-builder

Resume Builder

YAML 数据 + 布局 → 简历产物的轻量构建系统。

一键产出 HTML / PDF / 分页 PNG / 长图，适合 AI 与用户协作生成、迭代简历。

特性

• 数据驱动：简历内容全部由 data/{person}/ 下的 YAML 定义
• AI 记忆区：每个 YAML 末尾的 reference: 会被构建器截断，不参与渲染，用于记录口径、红线、决策与用户原话
• 样式 / 主题 / 布局：通过 style、theme.yaml、--layout 控制视觉
• 一键导出：HTML、PDF、长图、分页 PNG
• 多人物 / 多版本：一个人物一个目录，互不干扰

效果预览

python make.py build --person demo

然后打开 output/demo-/demo-.html 查看构建结果。

作为 dsh 插件使用

本项目同时是 DeepSeek Harness 插件，包名 dsh-resume-cv。

dsh plugin --profile  add dsh-resume-cv

桌面版可在 插件 → 添加插件 中填入包名。

安装后左栏新增「简历」入口，首次进入时选择简历项目目录，插件会写入随包模板。该会话使用「简历顾问」模式，仅修改项目内的 YAML 与 CSS，右栏显示实时预览；export 工具导出 HTML、PDF 或长图。

快速开始

# 校验所有 YAML
python make.py validate --person demo

# 完整构建（HTML + PDF + 长图 + 分页 PNG）
python make.py build --person demo

# 指定布局
python make.py build --person demo --layout two-column

# 只构建 HTML/长图，不导出 PDF
python make.py build --person demo --no-pdf

# 监听 YAML 变化自动重建
python make.py watch

项目用法（AI）

使用本项目和 AI 协作时：

1. 先加载仓库根目录的 AGENTS.md

2. 按其中的“简历顾问”角色开始聊天

3. 直接围绕用户简历内容讨论，不需要先介绍项目

4. 一个 YAML 一个 YAML 来，边讨论、边确认、边修改

AI 不需要做：代码审查、项目结构讲解、git 状态汇报、内部流程说明。

使用方式

创建一份新简历

data/{person}/

每个目录代表一份简历。目录下放顶层板块 YAML，也可以放子目录作为 collection。

添加一个板块

# data/{person}/education.yaml
type: entry-list
title: 教育背景
order: 1
style:
  - underline-title
items:
  - heading:
      text: 山东大学 · 工商管理 · 本科
    meta: 2023.09 - 2027.06
    body: