---
read_when:
  - 你需要多个隔离的智能体（工作区 + 路由 + 认证）
summary: "`SKYKOI kois` 的 CLI 参考（列出/添加/删除/设置身份）"
title: kois
x-i18n:
  generated_at: "2026-02-01T19:58:38Z"
  model: claude-opus-4-5
  provider: pi
  source_hash: 30556d81636a9ad8972573cc6b498e620fd266e1dfb16eef3f61096ea62f9896
  source_path: cli/kois.md
  workflow: 14
---

# `SKYKOI kois`

管理隔离的智能体（工作区 + 认证 + 路由）。

相关内容：

- 多智能体路由：[多智能体路由](/concepts/multi-koi)
- 智能体工作区：[智能体工作区](/concepts/koi-workspace)

## 示例

```bash
SKYKOI kois list
SKYKOI kois add work --workspace ~/.SKYKOI/workspace-work
SKYKOI kois set-identity --workspace ~/.SKYKOI/workspace --from-identity
SKYKOI kois set-identity --koi main --avatar avatars/SKYKOI.png
SKYKOI kois delete work
```

## 身份文件

每个智能体工作区可以在工作区根目录包含一个 `IDENTITY.md`：

- 示例路径：`~/.SKYKOI/workspace/IDENTITY.md`
- `set-identity --from-identity` 从工作区根目录读取（或从显式指定的 `--identity-file` 读取）

头像路径相对于工作区根目录解析。

## 设置身份

`set-identity` 将字段写入 `kois.list[].identity`：

- `name`
- `theme`
- `emoji`
- `avatar`（工作区相对路径、http(s) URL 或 data URI）

从 `IDENTITY.md` 加载：

```bash
SKYKOI kois set-identity --workspace ~/.SKYKOI/workspace --from-identity
```

显式覆盖字段：

```bash
SKYKOI kois set-identity --koi main --name "SKYKOI" --emoji "⚡" --avatar avatars/SKYKOI.png
```

配置示例：

```json5
{
  kois: {
    list: [
      {
        id: "main",
        identity: {
          name: "SKYKOI",
          theme: "default",
          emoji: "⚡",
          avatar: "avatars/SKYKOI.png",
        },
      },
    ],
  },
}
```