> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 版本记录

## v0.1.7

2026 年 11 月 5 日

### 新功能

* 自动压缩阈值配置：支持通过 `compaction.triggerRatio` 设置上下文自动压缩比例，默认 90%，可在 50%～95% 之间调整；支持按模型单独配置，也可设置 token 数量上限。小上下文窗口会提前触发，为后续回复预留空间。

### 优化

* 长回复渲染：流式 Markdown 改为增量渲染，复用已完成段落和代码高亮结果，减少长回复、代码块持续输出时的重复计算，降低终端卡顿。
* 会话日志体积：JSON / RPC 输出默认不再重复记录流式中间帧，避免子代理运行时日志持续膨胀。需要实时展示进度的客户端，可加 `--include-live-events` 保留这些事件。
* 上下文摘要：压缩和分支摘要不再重复输入模型的思考内容，保留可见回复、工具调用和诊断信息；摘要输出预算根据模型能力与剩余上下文计算，不再使用固定上限。
* 执行控制：计划模式改为仅由用户通过 `/plan` 或 `--plan` 开启，Agent 不再自行进入；子代理委派指引改为要求明确授权，不再因为任务复杂就默认启动。

### 修复

* 计划审批：修复提交计划后可能绕过用户决定继续执行的问题。等待审批期间，定时任务、目标续跑和后台子代理通知不会自动启动执行；批准时核对实际审阅的计划版本，取消或关闭审批不会被当作同意。
* 空回复恢复：修复模型只返回思考内容、没有可见回答或有效工具调用时任务直接结束的问题。现在会自动尝试恢复一次；连续空回复则明确提示失败，非交互模式和子代理也不再误报成功。
* 命令结果判定：区分命令执行失败与工具调用异常，准确保留退出码、超时和信号终止信息。`then_run` 验证失败不会再混淆已经完成的文件修改。
* 编辑差异展示：文件已修改、但后续验证被取消或结果处理失败时，工具卡片不再隐藏已应用的 diff。
* 子代理结果保留：修复后续追问、执行失败或手动停止可能覆盖子代理已完成答案的问题。状态查询和结束通知会保留已完成结果，同时明确报告当前失败或中断状态。
* 文件搜索：修复启动目录被删除后，即使指定了有效的绝对搜索目录，包含路径的 glob 搜索仍可能失败的问题。

## v0.1.6

2026 年 10 月 23 日

### 新功能

* 子代理后台运行：subagent 新增 `run_in_background`，后台任务立即返回通道编号，结束后推送含摘要、用量与子会话路径的通知；`agent_send` 按通道编号操作，支持 reply / stop / status（旧的别名、分组、扇出寻址已移除）。并发上限 8，空闲 10 分钟自动停止，`[subagent] background = false` 可退回前台。
* 飞书（Lark）远程连接（实验性）：`/connect lark` 将终端会话连接到飞书：授权后向机器人发首条消息绑定会话（群聊需 @机器人），工具审批同步为飞书卡片，可远程批准/拒绝；远程审批需在连接成功后完成一次回调配置。`/connect lark off` 断开。
* 一次性侧问：`/btw <问题>` 在浮层中提问并作答，不写入会话文件、不进入主对话的模型上下文；回答基于当前对话分支的副本生成。侧问历史仅存内存（20 条），只用于追问。
* 指定工作目录：新增 `-C` / `--cwd <目录>` 参数，供脚本与 IDE 集成固定项目目录，会话存储与设置发现均以该路径为准；路径无效则启动即报错。
* 终端标签页忙碌指示：Agent 工作或压缩上下文时，终端标签页显示忙碌指示（Otty / Ghostty 默认开启，其余终端可在 `/settings` 强制）；失败的工具行不再显示恢复提示行。
* 最近使用的模型：`/model` 选择器顶部新增 Recent 区，显示最近选用过的模型（最多 10 个，重复选用置顶），全局保存、跨会话共享。
* 会话搜索索引：新增 SQLite 全文会话索引供 Web / 桌面端搜索，JSONL 仍是唯一数据源、可随时重建，子代理会话不入搜索；CLI 新增 `step session-index status / reindex / clear`。
* 反馈报告附带证据：`/feedback` 自动附上排查证据：会话摘要（模型、token、成本、缓存命中率等）、请求耗时与中断阶段、超长对话首尾归档及工具输出；统一脱敏并记录版本环境，提交前有确认页。

### 优化

* 计划模式不再使提示缓存失效：提示缓存按请求公共前缀命中，工具列表位于前缀最前；此前进入计划模式会重排工具列表、令整段对话缓存失效（实测 233k token 只回 1.6k，约 0.7%）。现在默认工具列表不动，只读限制由执行时守卫拦截编辑类工具的越界写入。
* 任务状态快照只在变化时追加：上下文状态提示也固定在原始位置，请求前缀更稳定，缓存复用更好。
* `/model` 回车即保存：回车直接选中并保存为默认模型（`/model <provider/id>` 同样保存），Ctrl+S 移除；此前回车仅当次会话生效，两条路径会悄悄漂移。
* `run_command` 标题按宽度截断：折叠时标题只显示命令首行、按终端宽度截断，长脚本与 heredoc 不再占满会话记录；展开仍见完整命令。

### 修复

* Windows 上 `step update` 始终失败：下载与校验成功后仍必失败，原因是更新器按 Unix 包的外层目录查找 `step.exe`，而 Windows zip 为平铺布局；现按二进制实际位置判定根目录。
* 更新失败可诊断：安装失败信息附带最后 20 行安装器输出（注明省略行数），不再只有退出码。
* 非交互命令提前返回：`-p` / JSON 模式下 `/plan <任务>` 这类命令会在回合进行中销毁会话（报 ctx is stale、不写会话文件）；现在等回合结束才返回。
* `search_files` 行号误判：匹配文本含 `:数字:` 时被误当行号，读错源码行或误报无匹配；现直接读取结构化匹配结果，不再二次解析渲染文本。
* `find_files` 误丢路径：以 `[` 或 `WARNING:` 开头的路径被误当通知丢弃；现优先读取结构化匹配列表。
* workflow `phase()` 静默零运行：`phase(title)` 只是里程碑标签，把 agent 调用包进回调传给它会零运行却报告完成；现在静态检查直接拒绝并指出行号。
* 压缩失败重试：压缩遇响应流不完整（SSE 提前断开）时按瞬态错误重试；仍失败则将脱敏诊断写入会话文件。

## v0.1.5

2026 年 10 月 16 日

### 新功能

* 用量面板：新增 `/usage` 命令，提供总览与账户两个标签页：总览展示近期活跃热力图和每日 token 用量，账户页查询个人 Step Plan 剩余额度与重置时间。`/usage overview`、`/usage account` 可直接打开对应页。
* 状态面板：新增 `/status` 命令，一屏查看当前模型、思考档位、权限模式、工作目录和账户信息。
* 任务自查：在 `-p`/JSON 非交互模式中，加 `--completion-review` 可让 Agent 收尾前对照原始任务自查一遍，检查是否做全、接口与边界是否覆盖、测试是否跑过；发现问题先修再总结。

### 优化

* 编辑后验证：`edit_file` / `write_file` 的 `then_run` 改走与 `run_command` 一致的执行路径，超时、输出上限和审批规则与 `run_command` 相同。
* 无界面模式计划审批：`-p`/JSON 非交互模式下提交计划后，若无法直接询问用户，会明确返回计划内容并停止。

### 修复

* 技能冲突提示：修复同一技能同时安装于 `~/.agents/skills` 和 `~/.claude/skills` 时启动刷屏的问题。
* 无套餐账户登录：修复没有套餐的账户登录后无法使用的问题，现在会引导改用 API Key 登录。
* Workflow 重试与并发：修复 workflow 重试与限流误判的问题，按错误类型而非错误文本判断是否重试；同时修复 workflow 与并行子代理同时运行可能超过并发上限的问题。
* Workflow 恢复与失败上报：修复断点恢复时单个调用失败会拖累后续调用全部重跑的问题；失败节点和回调错误现在会出现在最终结果中。

## v0.1.4

2026 年 10 月 12 日

### 新功能

* 新增 CLM（Context Language Models）上下文管理。长对话接近上下文上限时默认启用，由模型选择性精简较早的上下文，原始会话日志不被覆盖；精简失败时回退到原有的摘要压缩。`/clm` 提供 `status`、`on`、`off`、`diff`、`reset` 子命令管理状态，`/clm-compact` 主动请求模型整理上下文，相关模型用量计入会话统计。
* 权限模式调整为 Ask、Approve for Me 和 Full Access。Ask 在修改文件或运行命令前询问；Approve for Me 自动执行常规操作，对检测到的危险命令或无法完整分析的命令仍要求确认；Full Access 允许直接执行风险命令，不再逐次确认。开启 Full Access 前需确认风险，可选择仅本次会话生效或记住选择。

### 优化

* 思考档位统一使用 `/effort` 调整，原 `/thinking` 命令已移除。
* 重新打开同一会话时，自动恢复此前设置的 Ultracode 开关及状态栏提示；新会话仍默认关闭。

### 修复

* 修复首次启动时 StepPage 尚未就绪即连接失败、导致当前会话无法使用网页发布功能的问题。StepPage 准备失败不影响 Step Code 的其他功能，后续启动时会重试。
* 修复安装或升级后重新打开终端可能提示找不到 `step` 命令的问题。
* 修复在用户主目录下启动时同一插件被重复识别、错误提示存在插件覆盖冲突的问题。
* 修复在全局配置中禁用 MCP 服务后，同名插件声明仍可能使其被重新发现的问题。
* 修复工具已经完成、界面却仍显示 Running、Reading 或 Editing 的问题。
* 修复不同项目路径映射到同一会话目录时，会话列表混入其他项目记录、`--continue` 继续到错误项目会话的问题。
* 修复子代理多步骤任务返回结果不完整、后台任务完成后未继续处理，以及长报告被截断的问题；同时修复任务状态显示错误、列表闪烁和进度通知刷屏的问题。
* 修复 Git 安装在自定义目录时误用 WSL 环境运行命令、导致找不到 Windows 中已安装工具的问题。
* 修复 Windows 下 Git Bash 后台命令退出失败、日志为空的问题。

## v0.1.3

2026 年 10 月 9 日

### 新功能

* 新增 Step Plan 远程登录。在 SSH、远程服务器或容器中运行 `step login --no-browser`，会返回完整的授权链接，可在本机或其他设备的浏览器中打开并完成登录，不依赖本地回调端口。
* `edit_file` 与 `write_file` 新增可选参数 `then_run`：文件修改成功后直接运行验证命令并返回结果，无需再单独发起一次验证调用。
* 新增 `--completion-check git-committed` 选项。在 `-p` 或 JSON 模式下，检查本轮改动是否已提交、是否还有未提交文件，以及是否已给出最终答复；未满足条件时会在原会话中提醒 Agent 继续完成，默认最多追加两轮。配合 `--completion-review` 可再进行一次自查，两者共用追加轮次。

### 优化

* 可通过 `STEP_CODING_AGENT_PLAN_DIR` 将计划文件存放在工作区之外，计划文件不会进入代码提交，也不影响工作区状态检查。

### 修复

* 修复已有 Skill 未被自动扫描的问题。`~/.claude/skills`、已信任项目的 `.claude/skills` 与 `~/.stepcode/skills` 现在会自动加载，无需手动配置路径。
* `run_command` 默认超时调整为 120 秒，可通过 `timeout_ms` 参数指定其他值，减少命令长时间无响应导致任务挂起的情况。
* 修复 Linux 下子进程残留导致任务持续等待的问题；命令被系统信号终止时，会正确报告为失败状态。
* 修复命令输出被缩短时完整日志路径或退出状态丢失的问题。退出码、超时或中止原因会一并保留，便于 Agent 查看完整日志后继续排查。
* 修复多次压缩上下文时已有历史摘要未被保留的问题，长任务可以继续使用此前总结的工作信息；同时修复摘要输出超过模型允许上限的问题。
* 修复 Ultracode 欢迎提示与命令入口不一致、缺少使用帮助与命令补全，以及开启状态在常见终端宽度下不可见的问题。
* 新增 `/ultracode` 命令，用于开启、关闭和查看多代理协作状态；原 `/ultraloop` 命令保留，两者功能相同。

## v0.1.2

2026 年 9 月 30 日

### 新功能

* 新增 `--non-interactive-denial continue` 选项。在非交互运行中（如 `-p` 模式），需要人工确认的危险操作被拦截后，将失败原因反馈给 Agent，由其尝试更安全的方式继续执行任务。默认值仍为 `terminate`，即终止任务；两种策略均遵循原有权限限制。

### 优化

* 插件市场的插件列表支持搜索，并移除同名重复项。在交互界面添加市场时显示进度，支持取消，添加成功后进入插件列表。
* 过长的工具返回文本以预览形式呈现，并提供全文文件路径，减少模型上下文占用。
* 对话中仅展示最近一次成功的任务计划更新，减少重复内容；恢复会话时同样生效。
* 优化单行输入时使用上方向键浏览历史记录的行为。全屏模式新增 `Ctrl+End` 快捷键，可返回底部并跟随新输出。

### 修复

* 修复启动或切换 Step 模型时，思考级别被强制设置为最高级别的问题。
* 修复 Skill 扫描卡住，以及 Skill 命令无法识别换行输入的参数的问题。
* 修复内置上下文压缩后丢失已加载 Skill 指令的问题。
* 上下文压缩的摘要请求超限时，尝试缩减旧历史记录并重试。
* 修复已安装插件的 Skill 和提示词命令未加载的问题，重新加载资源后即可使用。
* 修复插件 MCP 的配置识别、服务器名称识别和登录授权复用问题；本地 MCP 服务器默认从插件目录启动。
* 修复 MCP 分页工具列表加载不完整，以及后加载的可用 MCP 工具和扩展工具无法被搜索到的问题；工具列表随服务器通知更新。

## v0.1.1

2026 年 9 月 24 日

### 新功能

* 首次启动时自动预装 StepPage 插件；用户主动卸载后不会重复安装。

### 优化

* 减少子代理任务列表的频繁重绘，减轻闪烁，提升任务信息的可读性。
* macOS / Linux 安装完成后新增启动提示，引导用户运行 `step`。
* 更新中英文 README，补充 StepPage 发布说明与演示。

### 修复

* 修复正式安装版中 Workflow 和 Ultraloop 无法使用的问题，工作流沙箱由 `isolated-vm` 切换为 QuickJS WebAssembly。
* 修复 Workflow 在未等待异步任务、并行任务运行较久及资源清理等场景下的异常退出和错误超时。
* 修正 Step Plan 联网搜索的计费路径，改用订阅对应接口。
* 修复已登录用户仍被插件诊断提示缺少 `STEPFUN_API_KEY` 的问题。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.