[navori](https://ulisescm.github.io/navori-harness/zh-cn/quickstart) · 简体中文

四步开始使用 navori。

快速开始 

# 从零开始高效工作 
只需四步。 

本指南要求 Node 22.12+ 与已初始化的 git 仓库。如果已有手写的 .claude/，navori 可以共存并保留其内容。 

01 

## 安装 CLI 

无需全局安装。使用日常习惯的 npx、pnpm dlx 或 bunx 即可。 

```
# npm
npx navori init

# pnpm
pnpm dlx navori init

# bun
bunx navori init
```

02 

## 回答向导 

init 检测技术栈并询问必要信息，一分钟内生成 navori.config.json 和所选引擎的受管理 harness。没有官方预设？使用 `navori preset init <id>` 创建本地预设并自动接入配置。 

```
? Wizard › English
→ stack: Next.js · pnpm
? Engines › claude, codex
? Preset › nextjs
? Plugins › engram, codegraph, tgrep

✓ navori.config.json
✓ rendered:
   CLAUDE.md · AGENTS.md
   .claude/  ·  agents · skills · hooks · settings
✓ Done — 34 created
```

03 

## 提交并正常工作 

navori.config.json 是唯一事实来源。受管理块有明确标记，其余内容由你管理。 

```
$ git add navori.config.json CLAUDE.md .claude/
$ git commit -m "chore: bootstrap navori harness"
```

04 

## 变化后重新渲染 

add 在同一步自动渲染。手动编辑配置、切换预设等其他操作后，render 默认预览，--apply 才写入。sync 仅处理受管理块，保留自定义代码。 

```
# Add a plugin (renders on its own)
$ npx navori add codegraph

# Upgrade to the latest version
$ npx navori@latest update

# Something drifted?
$ npx navori doctor
```

### 开始之前 

- 已安装 Node.js 22.12 或更高版本。 
- 当前位于 git 仓库内。init 不修改 .git，但假设它存在。 
- navori 可渲染六种引擎：Claude Code、Codex、AGENTS.md、Cursor、Copilot 和 Pi，由向导选择。 
- render 默认仅预览，直到传入 --apply 才写入。 

### 下一步 

- [navori init](https://ulisescm.github.io/navori-harness/zh-cn/docs/init) 
- [navori add](https://ulisescm.github.io/navori-harness/zh-cn/docs/add) 
- [navori sync](https://ulisescm.github.io/navori-harness/zh-cn/docs/sync)