核心模式

夜航与配速

两种旗舰模式:让 AI 跑得更远、更稳、更省。

夜航模式

当你有一大段工作要推进、不想被频繁打断时,可以进入夜航模式:

/spiry-yehang

夜航模式下,AI 会:

  • 像你一样在岔路做决定——每次遇到分岔路口,基于对你的项目和偏好的理解、站在你的立场替你选,不拿小事来打断你
  • 到语义边界自动收尾——完成一个独立小任务后,直接跑收尾落盘、不停下问
  • 只放行简单本地 commit——带消息的 commit 自动放行

核心亮点:岔路决定清单

能自动跑的工具很多——它们都会进所谓的"全自动模式"。但夜航模式真正的价值区别在于:跑完一整块任务后,它会给你一份岔路决定清单——每个替你做过的岔路决定,来龙去脉一个不落地梳理出来,让你一目了然、快速确认。

你放的不是"手",是"放心":工作干完了,你依然完全掌控每一个关键决策的走向。

安全阀(夜航也不逾越)

即使夜航模式开启,以下操作仍然会停下来问你

  • 删除文件(rm -rf
  • 删除数据库(drop
  • 硬重置(git reset --hard
  • 清理工作区(git clean
  • 推送到远端(git push
  • 修改提交历史(git commit --amend--no-verify

总之:破坏性、难回滚、影响面大的动作,夜航也必须停下问人。

退出夜航

/spiry-yehang-off

退出后恢复日间交互节奏——commit 恢复逐次弹确认。

诚实边界夜航是「本回合内自决不打断」,不是「跨回合无人值守跑整夜」。回合结束(或上下文压缩)后,需要你再推一次才能继续。例外:若配速模式同时开着(无论先开后开),压缩后由配速接力自动注入续跑——那是配速的接力,不是夜航擅自续跑。

配速模式(Pacing Mode)

马拉松式的上下文管理——不冲刺、不撞墙,按节奏稳步向前。

配速模式解决一个核心痛点:被动的"撞墙才压缩"会丢失关键细节、推高 token 成本。两类用户尤其受益:

  • 使用按量计费模型——上下文不断膨胀,每一轮对话都裹挟着越来越长的历史向前推进,token 消耗随之飙升。配速模式按预算主动规划压缩节奏,把上下文体积控制在合理区间,每一轮都省着花
  • 使用小上下文窗口模型——免费额度的模型窗口有限(如三十多万 token),任务推进中随时可能猝不及防地触及上限。系统自动压缩突然触发,关键细节在毫无准备的情况下丢失,压缩后的工作质量明显下滑。配速模式在压缩前主动铺路、把关键信息提前落盘,让压缩不再是猝不及防的断片

简单说:配速模式把被动的"撞墙才压缩"变成主动的"规划好再压缩"。

/spiry-pacing

配速模式下,Spiry 会:

  1. 预埋压缩点——规划任务时对着上下文预算权衡切分颗粒度,用哨兵串 SPIRY-CKPT 标注独立可收口的边界项(机器精确匹配,编号写在其后如 SPIRY-CKPT-A
  2. 到点自动铺路——压缩点项做完时,先把热屋游标/下一步/待办轻度落盘(不 commit)
  3. 自动压缩+自动续跑——回合结束后插件自动触发压缩,压缩后自动注入续跑消息,AI 凭热屋+摘要无缝接续,全程无需人工干预

若上下文失控增长越过阈值(保险丝),插件会自动触发同一套接力。干完全部 todo 后 AI 必停下汇报、绝不自己找活。配速的作用域就是本次任务的 todo 清单:清单全部完成(或取消)时自动关闭并提示一次,无需手动 /spiry-pacing-off(想提前中止才用它)。

必须附上任务描述

/spiry-pacing 完成登录模块重构

命令后跟的内容是本次要配速的任务描述——配速以该任务规划出的 todo 清单为作用对象,没有任务描述就没有可配速的对象,空着敲会被命令级拦下要求补齐。上下文预算阈值固定为 256000 token(经真机验证足够,不支持自定义)。

关闭配速模式

/spiry-pacing-off

关闭后,上下文管理回归默认行为(由 opencode 的自动压缩处理)。

双模合一

两种模式配合使用:夜航和配速可以同时开启,两者正交互不干扰。推荐用一行命令同时开启(命令后跟的内容即本次配速任务):

/spiry-cruise 完成登录模块重构

这样 AI 一次性收到夜航与配速两份契约,立即开工、无需中途打断。裸 /spiry-yehang(不带任务)仍是纯夜航。也可以分别开启(先 /spiry-yehang/spiry-pacing 任务描述),但两条命令之间 AI 可能先按夜航方式动起来,体验不如一行到位。

这是长时间工作的最佳组合:夜航让 AI 本回合内自主推进不打断(破坏性动作仍停下问),配速按压缩节奏自动接力(铺路→压缩→续跑),干完 todo 必停的红线在两种模式下都焊死。

作用域与自动收尾:配速只作用于本次任务的 todo 清单——清单全部完成(或取消)时配速自动关闭并提示一次,AI 停下汇报、不会自己去找新活(夜航仍开着也一样)。下一个长任务请重新发起(/spiry-cruise 任务描述,或只要配速就 /spiry-pacing 任务描述)。

旧敲法说明旧版本用 /spiry-yehang 任务描述 一行双模启动——该敲法已随 0.25.0 移除,改用 /spiry-cruise 任务描述。裸 /spiry-yehang(纯夜航)不受影响。