# jianli

**Repository Path**: deardhp/jianli

## Basic Information

- **Project Name**: jianli
- **Description**: No description available
- **Primary Language**: HTML
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 我的简历 - Resume Editor

一款**轻量、开源、多功能**的在线简历编辑器。无需注册账号，无需搭建后端服务器，打开浏览器即可编辑和导出简历。支持多份简历管理、所见即所得编辑、11 种简历模块自由组合、PDF 导出等功能。

## ✨ 功能特性

### 简历管理
- **多份简历管理** — 首页卡片网格展示，创建、编辑、重命名、删除多份简历
- **数据持久化** — 所有数据自动保存至浏览器 localStorage，关闭页面不丢失
- **离线可用** — Service Worker 预缓存静态资源，断网也可正常编辑

### 简历编辑
- **所见即所得** — 左侧编辑表单，右侧实时预览，修改即看到效果
- **11 个简历模块** — 基本信息、教育背景、校园经历、专业技能、实习经历、工作经历、项目经历、获奖经历、证书信息、个人评价、科研成果
- **模块拖拽排序** — 随意调整模块前后顺序，支持显示/隐藏
- **自定义模块** — 可添加自定义模块，支持「工作经历」和「个人评价」两种排版格式
- **Markdown 内容编辑** — 内容区域支持 Markdown 语法，工具栏提供加粗、斜体、列表等快捷操作
- **头像裁剪上传** — 支持 JPG/PNG 格式，裁剪后自动保存为 Base64

### 模板与排版
- **自定义主题色** — 6 种预设颜色（蓝/橙/绿/紫/粉/青）+ 自定义取色器
- **自由排版配置** — 姓名大小、模块标题大小、内容大小、行高、模块间距、页边距（四边独立设置）
- **基本信息排版** — 支持居中对齐/左对齐
- **头像控制** — 缩放倍率（0.5x–2.0x）、上下左右微调平移

### PDF 导出
- **两种预览模式** — 默认视图（连续滚动）和分页视图（A4 分页）
- **PDF 导出** — 后端通过 Edge headless 浏览器渲染，精确保持排版样式
- **浏览器预览** — 也可在新标签页中预览简历效果

### 自动部署
- **一键启动** — 双击 `start.bat`，自动检测 Python 环境、安装依赖、释放端口、启动前后端服务
- **智能依赖检查** — 安装前自动检测依赖是否已就绪，已安装则跳过，避免重复安装
- **多镜像源重试** — 清华/阿里云/中科大/豆瓣镜像源依次尝试，全部失败后回退到官方源
- **环境自适应** — 未安装 Python 时自动下载安装（多版本多镜像源 + winget 兜底）

## 🚀 快速开始 (目前只支持Windows系统一键部署)

### 一键启动（推荐）
## 一、前置准备
先确认电脑安装了 Git
下载地址：https://git-scm.com/ ，按系统安装默认下一步即可
安装完成后，右键桌面 → 选择 Git Bash Here，弹出终端窗口

1、Git 命令克隆（推荐，标准开源项目用法）
打开你想要存放项目的文件夹（比如 D:\项目\简历）
在文件夹空白处右键 → 打开 Git Bash
执行克隆命令：```git clone https://gitee.com/deardhp/jianli.git```
等待下载完成，文件夹内会多出一个 jianli 文件夹，就是本地项目源码。

2、双击：

```
start.bat
```
![输入图片说明](image.png)
脚本通过 **PowerShell**（`start.ps1`）执行 6 个步骤：

1. ✅ **[1/6] 检测 Python 环境** — 优先使用系统已安装的 Python（≥ 3.8），未安装或版本过低则自动下载 Python 3.12.x
   - 下载顺序：华为云镜像 → 清华镜像 → Python 官网
   - 版本回退：3.12.10 → 3.12.9 → 3.12.8 → 3.12.7
   - 兜底方案：winget 安装
2. ✅ **[2/6] 检测 pip** — 确保 pip 可用，失败则自动修复（`ensurepip` / `get-pip.py`）
3. ✅ **[3/6] 安装后端依赖** — 先检查 `fastapi`、`uvicorn`、`pydantic` 是否已安装，已就绪则跳过；缺失则通过镜像源安装
4. ✅ **[4/6] 检查端口冲突** — 自动释放 3000 / 8080 端口
5. ✅ **[5/6] 启动后端服务** — FastAPI PDF 导出服务（端口 8080）
6. ✅ **[6/6] 启动前端服务** — HTTP 开发服务器（端口 3000）→ 自动打开浏览器

> 如 PowerShell 不可用，脚本会自动回退到 **Python 启动器**（`start_all.py`）执行 7 个步骤。



> PDF 导出功能需要后端服务支持，请使用一键启动。

## 🏗️ 技术栈

| 层次 | 技术 |
|------|------|
| 前端 | 原生 HTML + CSS + JavaScript（零框架依赖） |
| Markdown 渲染 | [marked.js](https://cdn.jsdelivr.net/npm/marked/marked.min.js) |
| 后端 | Python FastAPI + uvicorn（仅 PDF 导出） |
| 数据存储 | 浏览器 localStorage |
| 离线支持 | Service Worker（预缓存 + 运行时缓存） |
| PDF 生成 | Microsoft Edge headless 模式（`--print-to-pdf`） |
| 开发服务器 | Python http.server（智能缓存策略） |
| 启动器 | PowerShell（`start.ps1`，主力）+ Python（`start_all.py`，回退） |

## 📁 项目结构

```
├── index.html              # 首页 — 简历列表（卡片网格展示 + 增删改查）
├── resume-editor.html      # ⭐ 核心页面 — 简历编辑器（4000+ 行，含模板引擎）
├── about.html              # 更多资料 / 关于页面
├── styles.css              # 全局样式（CSS 变量设计系统）
├── server.py               # 前端开发服务器（智能缓存：HTML 禁用 / CSS/JS 1天 / 图片 7天）
├── sw.js                   # Service Worker 离线缓存（v2）
├── favicon.svg             # 网站图标
├── start.bat               # Windows 批处理入口（调用 start.ps1）
├── start.ps1               # PowerShell 一键启动（6 步自动启动，520 行）
├── start_all.py            # Python 启动器（回退方案，7 步启动）
└── back/
    ├── main.py             # FastAPI PDF 导出服务（Edge headless 渲染）
    └── requirements.txt    # Python 依赖（fastapi / uvicorn / pydantic）
```

## 📄 使用须知

本工具仅供个人学习与交流使用，**严禁用于任何商业用途**。未经作者许可，不得将本工具或其衍生版本用于商业目的。

本项目基于 **Apache License 2.0** 开源协议。

## 📱 获取更多资料

关注微信公众号或添加作者微信，免费获取简历模板和编程学习资料。

> 关注公众号 阿鹏随笔录 后回复「简历」即可领取