# iKho CLI

> 在终端里访问你的 iKho 录音:浏览、搜索、读取逐字稿、下载音频、查看智能笔记,无需打开应用。

iKho CLI 处于内测阶段,命令行为与参数以联调时提供的正式文档为准;账号由对接工程师开通,见联系我们。

## 前置条件

  
- Node.js 20 或更高版本
  
- 一个 iKho 账号

## 安装

全局安装 @ikho/mcp 包,它会同时提供 ikho 命令行工具:

  bash
    
  

  
```
npm install -g @ikho/mcp
```

内测阶段,@ikho/mcp 的正式安装源随账号开通邮件发放,请以邮件中的说明为准。

## 登录

通过浏览器登录,令牌会自动保存到本地,后续命令无需重复登录:

  bash
    
  

  
```
ikho login
```

## 命令参考

  | 命令 | 说明 

  | ikho login | 通过浏览器登录,令牌自动保存 
| ikho list | 列出录音,支持关键词与日期筛选 
| ikho show <id> | 显示单条录音的完整元数据 
| ikho transcript <id> | 输出逐字稿,可带说话人与时间戳 
| ikho note <id> | 查看 iKho 智能引擎生成的笔记 
| ikho download <id> | 下载录音音频到本地文件 

### ikho list

  bash
    
  

  
```
ikho list                                     # 最新一页录音
ikho list --query "销售拜访"                    # 按名称关键词筛选
ikho list --from 2026-04-01 --to 2026-04-30    # 按日期区间筛选
```

### ikho show

  bash
    
  

  
```
ikho show <id>    # 查看单条录音的元数据与可用产物
```

### ikho transcript

  bash
    
  

  
```
ikho transcript <id>              # 逐字稿
ikho transcript <id> --speaker    # 附带说话人标注
ikho transcript <id> --ts         # 附带每段时间戳
```

### ikho note

  bash
    
  

  
```
ikho note <id>            # 查看智能笔记(Markdown)
ikho note <id> -o note.md    # 保存到文件
```

### ikho download

  bash
    
  

  
```
ikho download <id> -o meeting.mp3    # 下载音频到指定文件
```

## 组合用法

加上 --json 后,输出可直接交给 jq 等工具做管道处理。例如列出本月录音并只保留 id 与名称:

  bash
    
  

  
```
ikho list --from 2026-07-01 --to 2026-07-31 --json | jq '.items[] | {id, name}'
```

## 输出格式

不带参数时,命令输出适合阅读的表格;加上 --json 则输出结构化 JSON,便于脚本与管道组合。所有错误信息写入 stderr,保持 stdout 干净,方便管道使用。