指南
三条命令，让你的仓库对智能体就绪。
AI 智能体辅助翻译。如有出入，以英文页面为准。如果你发现文本有任何问题，欢迎提交议题或发起拉取请求。
你很可能是通过那枚徽章来到这里的。它表示智能体可以从该仓库的上下文层启动，而且维护者已经在自己的机器上完成校验与评分，并作出自我声明。要让自己的仓库也对智能体就绪，只需运行下面三条命令。
leji start 打开的是一个已经存在的上下文层，因此还没有上下文层的仓库要先接入。第 02 步做的就是这件事；已经有leji.json 的仓库可以直接跳到第 03 步。快速上手提供了更完整的流程，从接入现有仓库，到评估其所声明的一致性级别。
01 · 安装 CLI
npm install -g @leji-org/leji02 · 接入这个仓库
leji adopt03 · 进入上下文层
leji start刚刚发生了什么
leji start从仓库根目录启动了一个检测到的智能体宿主，并带上唯一一条指令：先读引导配置，这样它最先获得的上下文来自团队，而不是自行揣测代码树。这是一条指令，不是一项检查；leji 只是把智能体指向那份文件，绝不核实它是否真的读了。如果没有检测到宿主，或者是在脚本化的运行里，就不会启动任何东西，命令会改为打印出你该运行的那一行。- 在启动之前，
leji start为这份克隆打印了一段 Setup 信息：这个仓库所声明的 Leji CLI 在这里是否解析到了该层规范版本系列所需的版本、MCP 服务器是否已为选定的宿主注册、共享的.mcp.json是否已提交，以及 pre-commit 钩子是否已安装。每一处缺口都会随相应的修复命令一起报告，但都不会阻止你进入上下文层。 - 检查这个层本身是另一回事：
leji validate负责 schema 与 lint 规则，leji conformance负责它所声明的级别。两者都由你刚安装的那个包在你自己的机器上运行，中间没有任何服务。 - 工具本身不会打开任何连接，背后也没有账号、注册表或托管服务。会触及网络的部分，都由你自己调用：联邦相关的抓取只与你所指明的那个仓库通信，而
leji init与leji adopt中的依赖步骤，只在你明确同意时才运行你自己的包管理器。leji 所启动的智能体，就是你本来就在用的那个，它的网络行为归它自己。
这枚徽章声明了什么
徽章是在本地生成的：leji badge 用 leji conformance评估仓库，为该次离线运行验证到的级别生成 SVG，并输出一行用于嵌入徽章的 markdown。
leji badge对于一个验证到 governed 级别的上下文层，徽章是这样的：
把它嵌进 README 的那行 markdown：
[](https://leji.org/agent-ready/)级别有 core、indexed、governed 与 federated，每一级都包含前一级。一致性检查清单写明了每个级别对团队的要求，而其中每一个级别，仅凭开放的规范与参考工具就能达到。
因此，真正值得关注的是检查结果，而不是徽章图片：在同一个仓库中运行 leji conformance，看看它报告什么。信任一页讲的是谁在维护 Leji、1.0 版本系列承诺了什么，以及受托方消失会怎样。