把简历编辑交给前端，把内容润色交给 Agent —— 聊聊 SmartCV 这个 AI 简历工具

一份 PDF 到「AI 智能优化」的一站式简历工具

最近在 GitHub 上看到一个有意思的项目 —— SmartCV。项目作者用一句话概括了它的核心理念：“把简历编辑交给前端，把内容润色交给 Agent。”

在线使用：124.220.191.123:5173/

作为一个常年被简历排版折磨、又对 AI 写作又爱又恨的人，我第一时间就被吸引住了。今天就来聊聊这个项目到底做了什么，以及它凭什么值得关注。

它解决了什么问题？

写简历这件事，说简单也简单，说难也难。

简单的是，你把自己的经历列出来就行；难的是——排版要好看、内容要精炼、措辞要专业、还要针对不同岗位做调整。传统的简历工具要么只有模板，没有智能优化；要么只有 AI 写作，没有可视化编辑。SmartCV 想做的，就是把这两件事拆开：

• 编辑交给前端——拖拽、排版、实时预览，所见即所得
• 润色交给 Agent——多 Agent 协同，诊断、优化、摘要、润色一条龙

核心功能一览

从 README 来看，SmartCV 的功能设计相当完整：

1. 导入解析 上传 PDF 或 Word 简历，通过 MinerU 云解析成结构化的简历 JSON。这意味着你现有的简历可以直接导入，不用从零开始。

2. 可视化编辑 7 种内容类型 + 命名预设，组件库拖拽排布，右侧实时预览 A4 成品，还有红线分页。这基本上就是把简历排版做成了“搭积木”式的体验。

3. AI 优化对话（最亮眼的部分） 这是我觉得最有意思的功能。通过 SSE 流式输出，整个优化过程完全透明：

• 诊断 → 按坐标就地改 JSON → 摘要
• 全程展示“思考过程 / 工具调用 / 回答”
• 前端分卡片展示：agent_start、delta（thinking/answer）、tool_call、tool_result、agent_end

关键设计是“按坐标改”：patch_content(s, r, c, i, text) —— 只替换文字、不增删结构，排版永远不乱。这个细节很见功力，说明作者在设计时充分考虑了简历格式的稳定性。

4. 导出 支持导出 JSON 文件和 PDF（后端用无头 Chromium 打印，与预览排版一致）。

技术栈：Vue 3 + FastAPI + LangGraph

从技术选型来看，SmartCV 是一个完整的前后端分离项目：

端	技术
前端	Vue 3 · Vite · Pinia · VueUse · naive-ui · vue-draggable-plus
后端	FastAPI · Pydantic · LangGraph · LangChain（OpenAI 兼容 / DeepSeek）
Agent	多 Agent：解析（md2json）、诊断、优化、摘要、润色
持久化	SQLite checkpoint（LangGraph）· SSE · UUID7 会话 id

特别值得一提的是，前端代码全程由 AI 生成——这本身就是一个很有意思的实践案例。

快速上手

想本地跑起来的话，步骤也不复杂：

# 后端
cd smartcv-api
python -m pip install -r requirements.txt
python -m playwright install chromium  # 导出 PDF 用
uvicorn main:app --port 8600

# 前端（另开一个终端）
cd smartcv-web
npm install
npm run dev
# 访问 http://localhost:5173

前置要求：Python 3.14+、Node 18+。

一些思考

看完这个项目，我有几个感受：

第一，AI 生成前端代码正在成为现实。 项目作者明确写了“前端代码全程由 AI 生成”——这不是噱头，而是一个可验证的实践。随着 AI 编程能力的提升，未来这种“AI 生成 + 人工调优”的开发模式可能会越来越普遍。

第二，“透明化 Agent”是一个好的设计方向。 很多 AI 工具是黑盒，给你一个结果，你不知道它怎么想的。SmartCV 把思考过程、工具调用、回答全部流式推送给前端展示，这种设计让用户对 AI 的输出更有掌控感，也更容易发现和纠正问题。

第三，简历这个场景选得巧妙。 简历既有结构化的数据（教育经历、工作经历），又有非结构化的内容（项目描述、自我评价），还有严格的排版要求。正好是“结构化编辑 + AI 润色”结合的最佳试验场。

总结

SmartCV 目前还是一个开源项目，但它的思路和架构已经相当完整。如果你正在找工作、需要频繁修改简历，或者对 AI + 简历工具这个方向感兴趣，不妨去 GitHub 上看看：SmartCV。喜欢的话给个星星感谢了

把编辑交给前端，把润色交给 Agent —— 这个分工，我觉得挺有道理的。