Print 模式

Print 模式让 Kimi CLI 以非交互方式运行，适合脚本调用和自动化场景。

基本用法

使用 --print 参数启用 Print 模式：

# 通过 -c 传入指令
kimi --print -c "列出当前目录的所有 Python 文件"

# 通过 stdin 传入指令
echo "解释这段代码的作用" | kimi --print

Print 模式的特点：

• 非交互：执行完指令后自动退出
• 自动审批：隐式启用 --yolo 模式，所有操作自动批准
• 文本输出：AI 的回复输出到 stdout

仅输出最终消息

使用 --final-message-only 选项可以只输出最终的 assistant 消息，跳过中间的工具调用过程：

kimi --print -c "根据当前变更给我一个 Git commit message" --final-message-only

--quiet 是 --print --output-format text --final-message-only 的快捷方式，适合只需要最终结果的场景：

kimi --quiet -c "根据当前变更给我一个 Git commit message"

JSON 格式

Print 模式支持 JSON 格式的输入和输出，方便程序化处理。输入和输出都使用 Message 格式。

JSON 输出

使用 --output-format=stream-json 以 JSONL（每行一个 JSON）格式输出：

kimi --print -c "你好" --output-format=stream-json

输出示例：

{"role":"assistant","content":"你好！有什么可以帮助你的吗？"}

如果 AI 调用了工具，会依次输出 assistant 消息和 tool 消息：

{"role":"assistant","content":"让我查看一下当前目录。","tool_calls":[{"type":"function","id":"tc_1","function":{"name":"Shell","arguments":"{\"command\":\"ls\"}"}}]}
{"role":"tool","tool_call_id":"tc_1","content":"file1.py\nfile2.py"}
{"role":"assistant","content":"当前目录有两个 Python 文件。"}

JSON 输入

使用 --input-format=stream-json 接收 JSONL 格式的输入：

echo '{"role":"user","content":"你好"}' | kimi --print --input-format=stream-json --output-format=stream-json

这种模式下，Kimi CLI 会持续读取 stdin，每收到一条用户消息就处理并输出响应，直到 stdin 关闭。

Message 格式

输入和输出都使用统一的 Message 格式。

User 消息

{"role": "user", "content": "你的问题或指令"}

也可以使用数组形式的 content：

{"role": "user", "content": [{"type": "text", "text": "你的问题"}]}

Assistant 消息

{"role": "assistant", "content": "回复内容"}

带工具调用的助手消息：

{
  "role": "assistant",
  "content": "让我执行这个命令。",
  "tool_calls": [
    {
      "type": "function",
      "id": "tc_1",
      "function": {
        "name": "Shell",
        "arguments": "{\"command\":\"ls\"}"
      }
    }
  ]
}

Tool 消息

{"role": "tool", "tool_call_id": "tc_1", "content": "工具执行结果"}

使用场景

CI/CD 集成

在 CI 流程中自动生成代码或执行检查：

kimi --print -c "检查 src/ 目录下是否有明显的安全问题，输出 JSON 格式的报告"

批量处理

结合 shell 循环批量处理文件：

for file in src/*.py; do
  kimi --print -c "为 $file 添加类型注解"
done

与其他工具集成

作为其他工具的后端，通过 JSON 格式进行通信：

my-tool | kimi --print --input-format=stream-json --output-format=stream-json | process-output