Skip to content

交互与输入 ​

CLI 和 TUI 是一个终端界面,由输入框、对话视图和状态栏组成。本页讲输入与粘贴、审批流程,以及可以切换的模式。

输入框基本操作 ​

输入框接受自由文本:Enter 发送,Shift-Enter / Ctrl-J 插入换行。输入框为空时按 ↑ / ↓ 浏览在当前工作目录输入过的内容,包括跑过的 Shell 命令。

退出 CLI:输入框为空时连按两次 Ctrl-D 或两次 Ctrl-C,或输入 /exit。有草稿时 Ctrl-C 只清空草稿;轮次运行中,输入框为空时的 Ctrl-C 会中断轮次而不是退出。Ctrl-D 和 /exit 不等待正在运行的轮次:它会在共享的 daemon 中继续运行,可用 kiki -r 恢复会话。

粘贴图片与视频 ​

图片和视频可以直接粘进输入框:报错截图、UI 设计稿、架构图、代码演示,粘进去就能讨论,不必先上传或转存。

操作方式:

  • macOS / Linux:Ctrl-V
  • Windows:Alt-V

粘贴后输入框里是一个可编辑的占位符,发送时会被真实内容替换。剪贴板里是纯文本就照常粘贴。能否使用媒体取决于当前模型是否接受图片 / 视频输入(image_in / video_in 能力字段);登录 Kimi Code 账号后默认开启。

斜杠命令 ​

以 / 开头的内容会被识别为斜杠命令。输入 / 后弹出补全菜单,随后续字符实时过滤;按 Esc 关闭菜单,匹配失败时内容会作为普通消息发送给 Agent。

已激活的 Agent Skills(扩展 Agent 能力的技能包)会注册成斜杠命令:普通外部 Skill 用 /skill:<name> 调用,外部子 Skill 显示为 /parent.child 这样的点分命令,内置 Skill 直接是 /<name>。外部 Skill 名称不和系统命令冲突时,可以省掉 skill: 前缀直接输入 /<name>。

在长提示词里,空白字符后(包括后续行的行首)输入 / 会打开只含 Skill 的补全菜单,一条提示词里可以引用多个 Skill:Kiki 会一起激活并作为同一轮次执行,一次 /undo 撤销整次提交。提示词中的 Skill 引用只按名称激活,不能带参数;要传参数仍需单独写 /skill:<name> args。内置命令和 plugin 命令只能放在输入开头。

部分命令仅在 Agent 空闲时可用,需要先用 Esc 或 /stop 中断正在运行的轮次。/yolo、/plan、/help、/btw 等切换和查询类命令始终可用。全部命令见斜杠命令参考。

文件引用 ​

键入 @ 触发文件路径补全,选中后插入相对路径,Agent 读到这条消息时会直接加载该文件。git 和非 git 目录都可用;文件夹候选以 / 结尾,可以继续往下补全。安装了 fd 时补全会使用它;没有 fd 时退回基础的文件系统扫描。隐藏路径会出现在候选中,.git 不会。

@ 和 / 是两套机制:@ 给 Agent 补文件上下文,/ 调用内置功能或 Skill。空白后的 / 只补 Skill,内置命令和 plugin 命令要用开头的 /。

审批流程 ​

工具调用有副作用时(执行命令、在工作区信任边界之外改文件),TUI 会弹出审批面板。已信任工作目录内的 Write / Edit 不再逐项询问;manual 模式下,Shell 命令、工作区外写入、工作区里指向外部目标的链接和敏感文件访问都会先问。YOLO 模式下的普通工具调用、Plan 模式下对计划文件的写入都不触发审批。

用方向键选、Enter 确认,或按 1/2/3 直接选数字项。Esc、Ctrl-C、Ctrl-D 都表示拒绝。

选择 Approve for this session(本会话批准),本次会话内符合条件的调用就无需再次审批。涉及敏感文件、受保护的 .git 控制路径或指向工作区外的链接时,批准只适用于同样的目标和操作,详见文件审批规则。要跨会话生效的规则,在配置文件里写 allow / deny。

模式切换 ​

Plan 模式 ​

Plan 模式下,Agent 先调研并写出行动计划,再动手修改其他文件,适合复杂或高风险任务;规划期间的工具限制见 Plan 模式工具。

  • 切换:Shift-Tab 或 /plan
  • 清除当前计划:/plan clear(仅空闲时)

在默认的 free Plan gate 下,Agent 调用 ExitPlanMode 会直接退出 Plan 模式而无需人工确认(记录中标为 "Auto-approved",同时提醒 Agent 你尚未审阅该计划,是否开始执行遵循你的原始指令)。将 Plan gate 设为 gated 后,Manual 模式下退出 Plan 模式会停下来等你批准、拒绝或要求修改;Auto、「替我审批」和 YOLO 模式则会自动批准退出。

权限模式 ​

/permission 在 Manual、Auto、「替我审批」和 YOLO 之间切换。

YOLO 模式(/yolo)自动批准 Agent 的文件访问(包括 .env、SSH 私钥等敏感目标)以及 gated 下的计划退出。显式 deny 规则仍优先,Agent 也仍可能向你提问。

Auto 模式(/auto)自动批准普通工具调用和计划退出,访问敏感文件和工作区里指向外部目标的链接时才会问。显式 deny 规则仍会拦截,危险 Bash 命令默认也仍会请求审批,除非关掉该检查。

「替我审批」模式(review)和 Auto 一样处理普通操作,但策略产生的审批请求先交给已配置的审查者。显式 ask 规则始终交给你。审查者高置信的决定会记录来源;不确定或审查者不可用时回到你的审批面板,同一轮里连续三次被拒后,这一轮余下的请求直接交给你。Agent 提问不经过审查者,是否阻塞当前轮由交互设置决定。

没有审批接收方时(例如无人值守的定时运行),需要你确认的请求会被取消而不是放行,提问也会被撤销,不会一直挂着。

注意

YOLO 模式会跳过文件写入和命令执行的确认,请只在受信任的工作目录下使用。

Shell 模式 ​

Shell 模式让你不离开对话就能跑终端命令,输出写进对话上下文,Agent 在后续轮次能看到结果。

  • 进入:在空输入框中键入 !,或粘贴以 ! 开头的命令。
  • 退出:在空输入框中按 Backspace 或 Esc;提交命令后也会自动回到普通模式。
  • 召回历史命令:在 Shell 模式的空输入框中按 ↑,召回后仍在 Shell 模式,可再次作为命令执行。

Shell 模式下输入框左侧显示 ! 提示符(桌面版 GUI 中边框还会变紫)。例如 !git status 不用另开终端就能查看仓库状态,输出直接进入对话上下文。

流式输出期间 ​

轮次运行时,活动行显示 Working 和本轮已运行的时间(已知轮次起点时从第 0 秒开始计时),后面是中断方法:Esc to interrupt,输入框里有草稿时为 Esc twice to interrupt。Agent 开始输出且有响应时间记录后,last response … ago 显示距最近一次观察到的输出多久。轮次在等待你审批或回答时,活动行改为 Waiting for your approval 或 Waiting for your answer。终端较窄时活动行保持一行,先省略这些细节,最后才省略中断提示。会话同步失败时,恢复提示会保持可见,输入 /reload 重试。

Agent 思考或调用工具时,输入框仍然可用,支持以下额外操作:

  • Esc:中断当前轮次(有草稿时需连按两次);Ctrl-C 先清空草稿,再中断;/stop 不需要特殊按键也能中断
  • Ctrl-O 或 /expand:展开或折叠工具输出、思考、已完成的过程和提醒

如果在 Agent 输出任何文字或调用工具前中断轮次,Kiki 会把这条消息放回输入框。

外部编辑器 ​

按 Ctrl-G 把当前输入发给外部编辑器,保存关闭后写回输入框,不保存则原样保留。输入大段文字或带格式内容时这样最省事。

编辑器选取顺序:/editor 配置 → $VISUAL → $EDITOR。三个都没有时,先运行 /editor 选一个。

下一步 ​