跳转到主要内容
公共包源码与发包流程在 magic-resume-kit。本页中的 schema、模板、设计系统、图标、utils 和 MCP 源码路径及构建命令均相对此仓库;应用通过 npm 使用 @magic-resume-kit/*,不再包含这些工作区。 模板住在 packages/resume-templates 里,一个模板是描述 design token、布局和按 section 渲染规则的 MagicTemplateDSL 值。本包里的渲染器把一个 DSL 值和一份 Resume 渲染成 JSX,Web 应用和 PDF 导出共用一套渲染器。 也就是说,模板是 数据,不是组件。Web 应用和 PDF 导出共用一套渲染器。

一个模板长什么样?

渲染器按 sections 的顺序遍历,查找 Resume 中对应的子值,然后渲染。没在 sections 里出现的 section 在这套模板下就不会渲染。

模板注册表如何与 Schema 对齐?

所有模板在 packages/resume-templates/src/registry.ts 里注册:
模板 ID 必须与 packages/resume-schema 中的 templateIds 完全一致。Schema 的 Zod enum 校验 selectedTemplate 字段 —— 漂移会让保存过的简历校验失败。

怎么添加一套新模板?

1

在 Schema 里加 ID

在 packages/resume-schema/src/ 里,把新 ID 追加到 templateIds 元组。
2

写 DSL 配置

在 packages/resume-templates/src/config/ 下加一个新文件,导出 MagicTemplateDSL。从布局形状最接近的现有模板开始改。
3

注册它

4

加缩略图

把一张 JPEG 放在:
模板库按 ID 取图;文件名必须与模板 ID 完全相同。
5

重新构建

三个地方必须同步:Schema 里的 templateIds、resume-templates 里的 templateRegistry、apps/web/public/templates/jpg/ 里的缩略图文件名。任何一个缺失都会以 404 或 Zod 校验错的形式浮出来。

TemplateCustomizer 有什么用?

@magic-resume-kit/resume-templates/TemplateCustomizer 是一个子导出 —— Web 应用嵌入它,让用户在不 fork DSL 的前提下调整模板的 design token。如果你新增了 token,也要在这里加对应的控件。

模板如何渲染成预览和 PDF?

预览和 PDF 走同一个渲染器。预览能跑通的,导出也能跑通;预览挂的,导出也会挂。