Poster Resume｜海报简历

一个把简历当作海报来设计的自由排版编辑器。

Poster Resume 不要求用户把内容塞进固定模板，而是让工作经历、项目、技能和教育背景成为可以编辑、拖动、组合的视觉模块。你可以像排版一张高质量海报一样，构成一页有秩序、有重点、可以真正投递的简历。

为什么使用 Poster Resume

一句话理解

传统简历编辑器通常先规定框架，再让内容去适应框架。Poster Resume 反过来：先判断你想突出什么，再让模块、时间轴和版面结构为信息服务。它更像排版一张海报，但仍然保留一页边界、可读性和稳定导出这些简历必须具备的约束。

这款编辑器的优势

• 可以自由改变简历的结构，不被固定模板限制表达思路。
• 正式、商务、自由三种视觉方案，分别对应传统岗位、商业岗位和设计/创意岗位。
• 工作经历支持垂直时间轴，项目、技能、教育、语言等内容可以按版面逻辑重新组合。
• 默认文字保持清晰克制，新增模块会融入当前纸面，不会凭空出现突兀的白色卡片。
• 支持 Markdown、JSON 和轻量 CLI，方便 Agent 查看、修改、排版和验证简历内容。
• 本地优先，不要求内置 API；内容可以由用户选择自己的 Agent 工作流来处理。

与 Agent 协作

Agent 可以通过 JSON 精确读写模块、字段、坐标、尺寸和布局，也可以先用 Markdown 快速整理文字，再回到视觉编辑器检查最终效果。每次结构化修改都应该经过布局诊断和浏览器/导出验证，避免出现文字挤压、模块重叠或导出字体不一致。

欢迎来信交流：dalesededierge@gmail.com · 访问 GitHub 仓库

自由，但不是混乱

模块可以拖动、缩放、对齐和吸附；布局可以使用单栏、侧栏、双栏、垂直时间轴和水平时间轴。自由度服务于信息层级，而不是为了装饰而装饰。

三种真实的求职场景

• 正式：白底、深色文字、宋体/黑体取向，适合传统公司和正式岗位。
• 商务：克制的蓝灰层级、主栏与侧栏分工，适合产品、运营、咨询和商业岗位。
• 自由：更高的设计自由度，适合设计师、创意、品牌和视觉相关岗位。

模块化表达经历

工作经历可以用垂直时间轴呈现，项目可以突出成果，技能可以使用紧凑列表或进度表达，教育、证书、语言能力等模块可以按版面逻辑重新组合。

一页简历的真实约束

编辑器提供一页边界、模块溢出检查、重叠诊断和打印/PDF 验证。目标不是“看起来像画布”，而是让最终导出的简历稳定、清晰、可阅读。

本地优先与隐私安全

默认示例使用虚构身份和示例联系方式。用户内容保存在本地工作流中，仓库不包含个人履历、真实联系方式或长期 API Key。

对 Agent 友好

项目同时提供：

• 根目录 AGENTS.md：代码 Agent 的修改边界和协作协议；
• npm run agent:context：给下载仓库的 Agent 快速读取项目上下文；
• window.ResumeAgent：运行时的结构化模块和布局命令面；
• npm run cli：连接当前编辑器页面的轻量 CLI；
• docs/agent/ 与 docs/architecture/：项目地图和接口约定。

快速开始

使用源码运行

npm install
npm run dev

打开 http://localhost:5173。

Windows 快速启动

双击 start.bat，或在终端执行：

npm run dev

运行时 CLI

编辑器打开后，可通过 DevTools 连接当前页面：

npm run cli -- status
npm run cli -- list-modules
npm run cli -- diagnose-layout

默认连接 127.0.0.1:9227 和 127.0.0.1:5173，可以用 --cdp-port、--app-port 覆盖。

编辑模式：Markdown / JSON（可选）

默认界面始终是视觉编辑器；如果需要批量改写或精确调整，可以从顶部的“编辑模式”打开：

• Markdown 视图：适合快速改姓名、简介、经历、项目和技能等文本内容。
• JSON 视图：适合 Agent 精确修改模块、坐标、尺寸与样式数据。

编辑完成后点击“应用到简历”，系统会回到视觉排版；Ctrl/Cmd + Enter 也可以直接应用。它是辅助视图，不会取代海报式编辑器。

给代码 Agent 的入口

下载仓库后，先运行：

npm run agent:context
npm run agent:context -- --task "优化商务版默认布局"
npm run agent:context -- --format=json

然后阅读 AGENTS.md 和 docs/agent/project-map.md。仓库级 Agent 修改项目源代码；运行时 CLI 修改当前打开的简历，两者职责不同。

项目结构

index.html              编辑器界面骨架
css/                    系统 UI、简历视觉和打印样式
js/                     模块、编辑器、布局、导出和 Agent 逻辑
desktop/                Electron 桌面壳
scripts/                构建、测试、上下文和 CLI 工具
docs/architecture/      数据模型与运行时命令说明
docs/agent/             代码 Agent 项目地图与修改协议
AGENTS.md               仓库级 Agent 入口

验证与构建

npm test
npm run build
npm run test:browser
npm run test:browser:cdp

桌面发布

项目使用 Electron 桌面壳，通过 GitHub Actions 在对应系统上构建：

• Windows：便携式 .exe；
• macOS：.dmg 与 .zip；
• 版本发布由 v* Git tag 触发。

当前发布包未配置 Apple Developer 签名或 Windows 代码签名，首次启动时系统可能显示安全提示。发布流程见 .github/workflows/release.yml。

设计原则

1. 信息层级先于装饰。
2. 颜色控制在少量层级内，默认文字保持深色、可读。
3. 简历字体和系统 UI 字体相互隔离。
4. 每个新增模块都必须融入当前版面，而不是生成白边卡片。
5. Agent 修改必须可验证、可回滚，不能直接操作任意 DOM。

许可证

MIT License。详见 LICENSE。