Skip to main content
Step Code 的输入框支持输入文本、粘贴图片、引用文件和执行 Shell 命令,也可通过命令切换审批、Plan 和目标模式。流式输出期间仍可发送消息。

输入框基本操作

Windows Terminal 还支持 Ctrl+Enter 换行。键位定义在 ~/.stepcode/agent/keybindings.json,修改后 /reload 生效。完整键位见键盘快捷键。 项目任务示例见常见使用案例。

粘贴图片

使用 Ctrl+V 粘贴剪贴板图片;Windows / WSL 使用 Alt+V。支持的终端也可以拖入图片路径。
请先选择支持图片输入的模型。默认图片缩放会将过大的图片限制在 2,000 px 以内,以减少输入体积;可通过 [images] 配置调整。终端内联显示与向模型发送图片分别控制,关闭内联显示后仍可发送图片。

斜杠命令

输入 / 打开补全菜单,Esc 关闭菜单。 Skills 使用 /skill:<名称> 调用。完整列表见斜杠命令。 会话恢复和上下文压缩见会话与上下文。

文件引用

输入 @ 搜索项目文件,使用 Tab 补全路径。Git 和非 Git 目录均可使用,也可以从命令行传入文件:
被引用或被工具读取的文件内容可能进入模型上下文。引用前请检查密钥、个人信息和业务敏感数据。

审批流程

Ask 模式或 Autopilot 遇到需确认项时,工具调用前显示确认框,标题为 Approve <工具名> 或 Dangerous <工具名>,正文列出拦截原因和参数摘要。批准后执行;拒绝后本次调用取消,模型收到拒绝原因继续对话。批量调用可能逐个询问。

权限模式

使用 /permissions 选择,或 /permissions cycle、Shift+Tab 循环切换。环境变量可覆盖初始模式,见环境变量。 被危险命令规则识别的操作仍需额外确认;Read Only 下拒绝执行。规则检查不能覆盖任意脚本或所有危险行为,不能作为沙箱使用。 非交互模式(step -p)默认拒绝需要审批的调用,可通过 --approval-mode 调整普通调用的审批策略;危险命令不因此豁免。详见 step 命令。

模式切换

Plan 模式

/plan 切换模式,/plan <任务> 直接开始规划;启动时也可以使用 step --plan。模型先勘察项目并写入计划文件。 Plan 模式下,文件编辑仅允许修改计划文件;Shell 命令仍按正常权限执行。批准计划后退出 Plan 模式并开始实施。

Shell 命令直通

! 执行本地 Shell 命令并将输出加入模型上下文;!! 执行但不将输出发给模型。这两个前缀对单条命令生效,无需切换模式;通过输入框执行的命令不支持后台运行。输出以卡片形式显示,长输出自动收起,可使用 Ctrl+O 展开。

目标模式

目标模式持续驱动多轮执行,直到目标达成或手动停止,适合几小时量级的长任务。任务期间请保持 Step Code 进程运行。 状态行显示活跃计时,例如 Goal: active · 12m 3s,仅累计目标活跃时间。 定时任务使用五字段 cron 表达式;持久任务保存在项目 .stepcode/cron/tasks.json,需要项目信任。持久任务仍需在 Step Code 进程运行期间调度。 多代理编排与授权见Agent 与 subagent。

流式输出期间

  • Enter 将新消息排队,当前助手轮次的工具调用结束后投递。
  • Esc 中止当前轮次,并将队列消息恢复到输入框。
  • Alt+↑ 取回排队消息;Windows / WSL 使用 Alt+Q。
  • Ctrl+O 折叠或展开工具输出。
steeringMode 和 followUpMode 控制消息投递方式,可在设置中调整。follow-up 默认没有单独快捷键。

外部编辑器

Ctrl+G 打开外部编辑器编辑当前输入,动作名为 app.editor.external。选择顺序为 externalEditor 设置、VISUAL、EDITOR,最后使用 Windows 记事本或其他系统的 nano。