持久运行时
cordy-runtime 如何让终端、TUI 与智能体保持存活——监督、运行时状态与环境变量覆盖。
在 Cordy 的终端与智能体之下,运行着 cordy-runtime——一个用 Rust 编写、随应用捆绑的持久跨平台进程监督器。正是它让你的 shell、TUI 与 CLI 智能体能在窗口重载、渲染进程崩溃,或(在 Windows 上)收起到托盘之后依然存活。
cordy-runtime 是一个终端与进程监督器,而不是 LLM 网关。它不做任何模型调用、不组装 prompt、不管理上下文窗口——那些完全是它所启动的外部 CLI 智能体的职责。
终端与智能体为何持久
你的终端会话(PTY)与 CLI 智能体子进程并不存在于 Electron 窗口内部,而是存在于独立的 cordy-runtime 进程中。窗口只会通过本地通道对会话进行挂接(attach)与分离(detach),从不拥有进程本身。
- 切换工作区、卸载某个面板,或重载渲染进程,都只是分离。
- 只有当你关闭终端标签页,或进程自行退出时,会话才会结束。
因此,只要运行时仍然存活,一个长时间运行的构建、vim 会话或智能体都会在界面分离又返回时继续运行。完整退出应用会结束 PTY 与进程。
以快照方式挂接
每个会话在运行时内部都跑着一个无头终端模拟器,它接收 PTY 的每一个字节输出,并与真实终端同步调整尺寸。当界面重新挂接时,运行时会返回以下两者之一:
- 增量(delta)——仅包含界面上次看到该会话之后缓冲的帧(在同一视图仍存活且间隔较小时使用);或
- 快照(snapshot)——终端当前尺寸下完整序列化的屏幕状态(在全新重载、托盘恢复,或缓冲的增量窗口已被淘汰时使用)。
以运行时模拟器快照重新挂接,可以让全屏 TUI 返回,而无需重放渲染器中的旧字节流。
完整退出后的冷恢复
渲染器释放终端前,会在本地保存有界的屏幕 / 历史快照及捕获尺寸,并排除备用屏幕与终端模式序列。完整退出后,Cordy 恢复这些文字,并在下方启动新 Shell。历史可以恢复,旧进程不能。见终端。
监督与自动重启
Electron 主进程会监督运行时,并在其意外退出时重启它。重启采用指数退避,因此一个每次启动都崩溃的运行时不会拖垮你的机器:
- 退避时长按 1s → 2s → 4s → 8s → 16s 增长,上限为 30s。
- 一旦运行时保持健康(
ready)达 60 秒,退避便重置为基础时长。 - 重启次数没有固定上限;每次崩溃只会再安排一次受控的重启。
每一次自动重启(尝试次数、退避、退出码、信号)都会写入诊断日志。运行时重启后,终端可以继续使用,智能体状态也保持准确;重启前的运行不会被显示为仍在运行。
如需手动重启运行时,点击运行时状态指示器并使用其中的重启操作。若有智能体正在运行,Cordy 会说明将停止几个并先询问你。
运行时可以让终端在渲染器重载和关闭到托盘的分离期间保持存活。重启或崩溃运行时会结束其中的会话。
运行时状态
运行时状态指示器显示 Runtime: <状态>。运行时首次进入故障状态时,Cordy 还会弹出 toast 提示。
| 状态 | 含义 | 该怎么做 |
|---|---|---|
starting | 运行时进程正在启动。 | 稍候片刻。 |
ready | 健康且已连接;终端与智能体正常工作。 | 无需操作。 |
unresponsive | 运行时进程仍在运行,但已有数秒没有任何响应。一旦重新响应,便回到 ready。 | 稍候。若一直无响应,请重启运行时。 |
binary-missing | 未找到运行时二进制。应用会列出它尝试过的每个路径。 | 重新安装 Cordy。 |
incompatible | 运行时的协议版本与当前应用构建不匹配。 | 重新安装 Cordy,使应用与运行时来自同一构建。 |
crashed | 运行时意外退出;已安排一次受控的自动重启。 | 通常会自愈。若持续重启,请查看诊断日志。 |
stopped | 运行时被有意停止(例如应用关闭时)。 | 重启应用或运行时。 |
不存在单独的"崩溃循环"状态——崩溃循环表现为诊断日志中 crashed 反复出现,且重启计数不断增加。
环境变量覆盖
以下环境变量都是可选的;对于常规使用,默认值即为正确设置。
CORDY_WINDOW_CLOSE_MODE
控制在 Windows 上将窗口收起到托盘时的行为。取值:hide 或 destroy。默认:destroy。
destroy(默认)在完成数据安全挂起握手后销毁渲染进程以释放其内存,同时运行时、PTY 与智能体继续运行。重新打开时会重新挂接到一切。hide则让渲染进程常驻内存。
CORDY_USER_DATA_DIR
覆盖 Cordy 存储用户数据(项目、工作区、笔记、布局、设置、主题)的位置。未设置时,Cordy 使用隐私中列出的各操作系统位置。
新终端使用的 Shell 在设置 → Shell 中选择,而不是通过环境变量。Cordy 没有仓库级配置文件;它不会读取或运行 .cordy/ 文件夹中的任何内容。
永不进行模型调用
cordy-runtime 监督终端与进程,不进行语言模型调用,也不管理智能体凭据或上下文窗口。它会为渲染、回滚历史与状态处理终端输出;渲染器还能在本地持久化终端历史快照。每个 CLI 智能体在自己的进程中连接自己的服务商。见智能体与隐私。