跳转到主要内容
公共包源码与发包流程在 magic-resume-kit。本页中的 schema、模板、设计系统、图标、utils 和 MCP 源码路径及构建命令均相对此仓库;应用通过 npm 使用 @magic-resume-kit/*,不再包含这些工作区。 知遇是一个 pnpm + Turborepo monorepo。根 package.json 将包管理器钉死为 pnpm@10.28.1,让 CI 和本地安装行为保持一致。

有哪些 workspace?

包之间有哪些依赖边界?

这些规则靠 code review 来执行,工具不强约束。请遵守:
@magic-resume-kit/mcp 不能引入:
  • Next.js 或任何 React 组件库
  • 浏览器 API(window、localStorage、IndexedDB)
  • apps/web 里的任何东西
它是一个纯 Node ESM 库 + CLI。如果不小心引了浏览器侧的东西,node --test 会直接挂、npm publish 也会出问题。
  • apps/web 可以依赖任意 packages/*。
  • packages/resume-templates 依赖 packages/resume-schema。反过来不行 —— Schema 是叶子节点。
  • packages/mcp 依赖 packages/resume-schema 和 packages/resume-templates,不依赖 apps/*。
  • 新的共享形状放进 packages/resume-schema,不要在 apps/web 里再复制一份。

怎么用 Turborepo 运行命令?

根 package.json 把所有命令都过一遍 Turbo:
只想跑单个 workspace 时,绕过 Turbo,用 pnpm filter:

workspace:* 协议怎么用?

本仓库内部的跨 workspace 依赖在 package.json 里都写成 workspace:*。这意味着 必须从仓库根目录运行 pnpm install,不能在 workspace 内部跑,否则 pnpm 解析不出 link。 发布 @magic-resume-kit/mcp 时,pnpm 会在打包时把 workspace:* 改写成真实的 semver 版本 —— 不用手动 bump。 应用对 @magic-resume-kit/* 使用固定的 npm 版本;只有同仓包(如 GenUI)继续使用 workspace:*。公共包发布由 magic-resume-kit 的 GitHub Actions 处理。