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

跨仓库共享配置与任务，统一默认值，一次渲染整个仓库集合。

## 命令 

[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 remove](https://ulisescm.github.io/navori-harness/zh-cn/docs/remove)[navori adopt](https://ulisescm.github.io/navori-harness/zh-cn/docs/adopt)[navori configure](https://ulisescm.github.io/navori-harness/zh-cn/docs/configure)[navori preset](https://ulisescm.github.io/navori-harness/zh-cn/docs/preset)[navori render](https://ulisescm.github.io/navori-harness/zh-cn/docs/render)[navori sync](https://ulisescm.github.io/navori-harness/zh-cn/docs/sync)[navori update](https://ulisescm.github.io/navori-harness/zh-cn/docs/update)[navori refresh](https://ulisescm.github.io/navori-harness/zh-cn/docs/refresh)[navori scan](https://ulisescm.github.io/navori-harness/zh-cn/docs/scan)[navori doctor](https://ulisescm.github.io/navori-harness/zh-cn/docs/doctor)[navori status](https://ulisescm.github.io/navori-harness/zh-cn/docs/status)[navori bench](https://ulisescm.github.io/navori-harness/zh-cn/docs/bench)[navori codex](https://ulisescm.github.io/navori-harness/zh-cn/docs/codex)[navori audit](https://ulisescm.github.io/navori-harness/zh-cn/docs/audit)[navori backup](https://ulisescm.github.io/navori-harness/zh-cn/docs/backup)[navori migrations](https://ulisescm.github.io/navori-harness/zh-cn/docs/migrations)[navori registry](https://ulisescm.github.io/navori-harness/zh-cn/docs/registry)[navori workspace](https://ulisescm.github.io/navori-harness/zh-cn/docs/workspace)[navori ticket](https://ulisescm.github.io/navori-harness/zh-cn/docs/ticket)[navori dominio](https://ulisescm.github.io/navori-harness/zh-cn/docs/dominio)[navori tools](https://ulisescm.github.io/navori-harness/zh-cn/docs/tools)[navori receipt](https://ulisescm.github.io/navori-harness/zh-cn/docs/receipt)[navori plan](https://ulisescm.github.io/navori-harness/zh-cn/docs/plan)[navori spec](https://ulisescm.github.io/navori-harness/zh-cn/docs/spec)[navori handoff](https://ulisescm.github.io/navori-harness/zh-cn/docs/handoff)[navori master](https://ulisescm.github.io/navori-harness/zh-cn/docs/master)[navori gate](https://ulisescm.github.io/navori-harness/zh-cn/docs/gate) 暂无 man 手册，本页为命令参考。 

navori

# workspace 

跨仓库共享配置与任务，统一默认值，一次渲染整个仓库集合。 

## 用法 

```
navori workspace <init|ls|show|link|add-repo|set-default|render|rename|delete> [args]
```

## 参数 

init <name> [--description <txt>] [--yes] 在 ~/.navori/workspaces/<name>.json 创建工作区。 

ls [--json] 列出已知工作区。 

show <name> [--json] 显示路径、默认值和注册仓库。 

link [<name>] [--cwd <dir>] 注册当前仓库并记录到 navori.config.json；未传名称时使用配置声明的工作区。 

add-repo <workspace> --name <n> --path <p> [--stack <s>] [--description <d>] 按路径注册仓库，无需进入目录。 

set-default <workspace> <key> <value> 适用于工作区所有仓库的默认值：engines 逗号分隔，plugins 使用 true|false。 

render <workspace> [--apply] [--force] [--verbose] 渲染全部注册仓库，不带 --apply 只预览。 

rename <from> <to> [--yes] 重命名并保留任务、仓库及默认值。 

delete <name> [--yes] 移到 ~/.navori/.trash，可恢复。 

## 示例 

### 创建并关联

```
$ navori workspace init bonum --yes
◆  Wrote ~/.navori/workspaces/bonum/workspace.json

$ navori workspace link bonum
◆  Registered 'demo' in workspace 'bonum'.
◆  workspace → 'bonum' saved in navori.config.json
```

### 查看详情

```
$ navori workspace show bonum
│    ticketsDir : tickets
│    defaults   : {"engines":["claude"]}
│    repos      : 1
│  Repos:
│      · demo  /Users/you/dev/demo
```

### 批量渲染预览

```
$ navori workspace render bonum
│    · demo  up-to-date  45 unchanged
└  Preview 1/1 ok · 0 would change · 0 conflict · 1 warning · 0 failed
```

## 注意事项 

- 工作区在 ~/.navori/workspaces/，仅属于本机，仓库只保留 navori.config.json 的 workspace 键。 
- link 在仓库内关联，add-repo 从外部按路径执行相同注册。 
- render 无 --apply 时预览完整仓库，以衡量预设变更的影响范围。 
- delete 移到 ~/.navori/.trash，不直接删除。