权限模式
从 v0.1.4 起,交互界面提供以下模式:
两个自动档默认启用模型错误后的自动重试,重试次数有上限。
Ask 和 Approve for Me 对检测到的危险或无法完整分析的命令要求确认。Full Access 在风险确认后跳过这类逐次确认;为个别工具设置的禁止或确认规则仍然生效。规则检查不能覆盖任意脚本或所有危险行为,不能作为沙箱使用。
选择权限模式
未取得风险确认不会进入 Full Access;没有交互界面的运行不会仅凭配置获得 Full Access。权限模式不是系统沙箱。- 在交互输入框中运行
/permissions。 - 根据任务选择模式。首次处理项目时,建议选择 Ask,检查工具参数后再批准操作。
- 工作范围变化时,重新检查当前模式。也可以使用 Shift+Tab 或
/permissions cycle切换。
信任项目资源
项目信任决定是否加载项目配置、扩展和资源。使用/trust 管理信任;命令行的 --approve 和 --no-approve 控制本次是否加载需要信任的项目资源。
信任项目前,请检查 .stepcode/ 中的配置与资源。项目指引的加载范围见项目指引,配置覆盖关系见配置文件。
限制工具范围
只需要分析项目时,选择 Ask,并在任务中说明文件范围。需要限制可用工具时,使用--tools 或 --exclude-tools,工具名称应与当前注册的工具一致,见内置工具。
defaultTools 管理原生内置工具集合;Step 工具、扩展与 MCP 工具还需按各自配置处理。MCP 可通过 enabled_tools 和 disabled_tools 筛选工具,见MCP。
权限模式和工具筛选不提供操作系统级隔离。处理不可信代码或要求限制文件、网络访问的任务时,请使用容器、虚拟机或操作系统权限。
设置非交互任务的审批策略
step -p 没有交互审批界面。通过 --approval-mode 和 --non-interactive-approval 设置任务的审批策略,并明确可用工具。参数格式见 step 命令。
--non-interactive-denial 控制遇到需人工确认的操作被拒绝后的行为:默认 terminate 终止任务;continue 将失败原因返回模型,由其尝试其他方式。继续执行仍受所选权限限制。
保护数据与凭据
- 模型请求会发送提示词、相关文件和工具结果。提供材料前,请确认服务有权接收这些数据。
- MCP 与插件可能执行本地程序或访问外部服务。只加载可信来源,并使用最小必要凭据。
- 日志和导出的会话可能包含代码、路径或错误详情,分享前请审查。
- 部署会上传构建产物,执行前请检查其中的密钥、私有配置和用户数据。

