reactive-resume 插件怎么用?安装配置与使用全流程
简历这件事,很多人一年才碰一次,但每次碰都像上刑。排版调半天、导出格式乱、更新个联系方式要重发三遍——这些痛点,Reactive Resume 基本都给你解决了。它是一个免费且开源的简历构建器,GitHub 上已经拿了 41k+ 星标,主打隐私、可控、可自托管。今天这篇就带你走一遍它的安装、配置和日常使用全流程。
它到底解决什么问题?
先说痛点。传统简历工具要么收费、要么把数据存在别人服务器上、要么导出格式死板。Reactive Resume 的思路很直接:
- 隐私优先:代码完全开源(MIT 许可证),无追踪、无广告、无隐藏费用,数据默认不经过第三方。
- 即时预览:输入内容时右侧实时渲染,所见即所得。
- 导出灵活:支持 PDF、JSON、DOCX 多种格式,PDF 生成在客户端完成,不需要额外打印服务。
- 自托管自由:整个应用可以部署在你自己的服务器上,数据完全由你掌控。
简单说,它把简历从“一次性文档”变成了“可维护的数据资产”。
安装前提:先有 dsh 引擎
在 DeepSeek Harness (dsh) 插件体系里,安装 reactive-resume 前需要确保你的环境里已经装好了 dsh CLI 引擎。这是所有插件运行的基础设施,类似包管理器的角色。如果你还没装,先去 dsh 官网看下安装命令,装好后再继续。
安装方式:两种路径,按需选择
方式一:本地快速体验(Docker Compose)
如果你只是想先跑起来看看效果,这是最快的方式:
git clone --depth=1 https://github.com/amruthpillai/reactive-resume.git
cd reactive-resume
docker compose up -d
然后浏览器打开 http://localhost:3000 就能用了。这个方式适合尝鲜,基本使用不需要注册账户,选模板、填信息、导出 PDF 三步走。
方式二:自托管部署(Docker 镜像)
如果你要长期用、或者想部署到自己的服务器上,直接拉镜像:
docker pull amruthpillai/reactive-resume:latest
或者从 GitHub Container Registry 拉:
docker pull ghcr.io/amruthpillai/reactive-resume:latest
自托管的技术栈依赖包括 PostgreSQL(存用户数据和简历)和可选的 SeaweedFS(S3 兼容存储,用于文件上传)。注意,从 v5.1.0 开始,PDF 生成完全在客户端运行,不再需要 Browserless 或 Chromium 这类外部打印服务,PRINTER_ 和 BROWSERLESS_ 环境变量已经废弃,可以直接从 .env 里删掉。完整的自托管指南在 docs.rxresu.me,具体环境变量配置以仓库 README 为准。
核心功能使用场景
1. 简历制作:实时预览 + 拖拽排序
这是最常用的场景。左边编辑、右边预览,支持拖拽调整板块顺序。如果你有特殊需求,还可以自定义板块,支持任意内容类型。富文本编辑器让你能加粗、换色、调整格式,不用再切到 Word 里折腾。
2. 模板选择:专业设计,自由定制
内置了多个模板,名字挺有意思——Azurill、Bronzor、Chikorita、Ditto、Gengar、Lapras、Pikachu 这些,都是宝可梦风格命名。每个模板支持 A4 和 Letter 两种纸张尺寸,颜色、字体、间距都能调。结构化样式规则让你能精细控制板块和文本的样式。
3. 数据导出与迁移
- 导出 PDF 用于投递,JSON 用于备份或迁移。
- 支持从 JSON Resume 格式导入,如果你之前用过其他工具,数据可以无缝搬过来。
- 随时完整导出你的所有数据,也可以一键永久删除——这个功能在隐私敏感场景下特别实用。
4. 分享与协作
通过唯一链接分享简历,别人打开就能看,不需要注册。多语言支持让非中文用户也能用。深色模式对夜间党友好。还支持通行密钥和双因素认证,安全性这块考虑得比较周全。
5. AI 辅助(可选)
集成了 OpenAI、Google Gemini、Anthropic Claude 三家 AI 服务,具体怎么配置 API Key 和调用逻辑,以仓库 README 为准——这部分功能是锦上添花,不是核心路径。
常见问题
Q:本地跑起来后数据存在哪?
A:默认用 Docker Compose 起的话,PostgreSQL 数据在容器卷里。自托管时数据完全在你自己的服务器上。
Q:导出 PDF 需要额外装什么吗?
A:不需要。v5.1.0 之后 PDF 生成完全客户端化,不需要 Chromium 或 Browserless。
Q:想改代码或者贡献功能?
A:仓库欢迎贡献。流程是 Fork → 建功能分支 → 提交 → 推分支 → 开 PR。开发环境设置和项目架构文档在 docs.rxresu.me 里有详细说明。
Q:免费吗?会不会跑路?
A:MIT 许可证,免费且开源。项目靠赞助商支持(目前有 Atlas Cloud 赞助),未来也会保持免费。如果你用着好,可以去 GitHub 加个星标,或者帮忙改进文档和翻译。
总结
Reactive Resume 的价值在于把简历从“一次性文档”变成了“可维护的数据资产”。隐私可控、导出灵活、可自托管,这几个特性让它在一众简历工具里比较突出。如果你受够了传统工具的种种限制,值得花十分钟跑起来试试。
想安装这个插件?去 DeepSeek Harness 插件站点搜索 reactive-resume,就能看到完整的安装命令和中文 README,跟着操作就行。