文档 / 入门
GenPM 的工作原理
一个 GenPM 包由三层组成,它们一起交付并固定在同一个提交上:
| 层 | 内容 | 放置位置 |
|---|---|---|
| 代码 | 模块的源代码 | d,例如 src/lib/auth/ |
| 上下文 | 给 AI 智能体的规则(x) |
<d>/AGENTS.md,以及带作用范围的 IDE 规则文件 |
| 连接 | 模块需要的 MCP 服务器(m) |
.mcp.json、.cursor/mcp.json……仅在你同意后写入 |
注册表只存储元数据
注册表索引清单并指向 Git。安装时,CLI 直接从 Git 托管方下载确切提交(c)的代码并进行验证:git rev-parse HEAD 必须等于 c,且每个文件都必须与该提交的文件树一致。
先计划,再执行
plan() 从不写入你的项目。它解析依赖、下载到全局缓存并扫描文件。apply() 通过日志写入:任何一步失败,都会全部回滚。
绝不运行脚本
GenPM 没有生命周期脚本,包里的任何东西都不会在你的机器上运行。会被其他工具自动执行的文件(postinstall、.npmrc、.envrc、.vscode/tasks.json……)会被拒绝。