Repository navigation
Cortex v0.1.37
[0.1.37] - 2026-10-24
输入框底部加了一条用量状态栏：这一轮真的花了多少。
新增
- 生成速度（tok/s）、输入/输出 token、缓存命中率、上下文填充率（占模型窗口
百分之几）、工具步数，挂在工作区/权限/模型那排 chip 的同一行右端；
每一项悬停都有明细。 - 供应商没报的项整项不画（比如有的端点不说缓存）——不画一个 0，
免得读起来像「缓存一次都没命中」。 - 生成中每秒刷新；停顿（模型去跑一条长命令）时那个速度会自己掉下去。
cortex chat）与服务端必须同一版本线一起换：
服务端会开始发 usage 事件，而老 CLI 遇到不认识的 type 会把那一轮
当中断。桌面端不受影响（老客户端静默忽略）。
修复
- 会话改动（会话列表别处连动）与图片页两处布局溢出。
- main 分支上一轮 CI 红（格式校验与一条 widget 测试的 pending timer）。
内部（行为不变）
- agent 循环新增
AgentEvent变体携带供应商报的 token 用量，经事件桥送进
SSE；CLI 收尾一行报↑输入 ↓输出 速度。服务器重启之后不在它管理之列。
Web 版打开快了很多，外加几处打磨。
Web 界面首屏下载量降到约三分之一
浏览器打开 Web 版时要先下载的代码从 4.6MB（压缩后）压到 1.6MB —— 换了
dart2wasm 构建管线（同时切到 wasm-gc），慢网络下「白屏等半天」的那段时间
明显变短。
修复
- 图片页点「新对话」按钮：此前每点一次都会多造一条空会话，现在不会了。
打磨
- 密钥类输入框（模型 API key 等）现在分三种状态：没填、已保存且没动、
改过了 —— 界面照实说，不会再出现「看着像被清空、其实还在」的误解。 - 会话列表的加载/出错状态统一按一套约定显示。
自托管运维可见
- LLM 调用失败重试现在数得出来：恢复账与耗尽账落日志，调用边界有
tracing span —— 「为什么这轮慢了/失败了」可以直接查。 - 逐账号数据迁移埋了量具：只有真的慢过观察线才告警，告警文案带处理动作。
内部（行为不变）
一轮针对代码健康的集中整理：五个热点巨文件（tools/dto/routes/turn×2 与
Flutter API 双生）按域拆开、纯移动无行为变化；CI 测试接上了真数据库，
此前静默跳过的集成测试现在真跑；unwrap/expect 与无 LIMIT SQL 都有了
防增量闸。
服务端（agent 编排）：这一版只发 docker 镜像
从 0.1.2 起不再发裸二进制（cortex-vX-<平台>.tar.gz / .zip）。
前期迭代快，四个平台各编一份占掉了整条发版流水线的绝大部分时间。
能力没少 —— 镜像里该有的都在；少的是
「不想用 docker 就下个二进制跑」这条路。要 CLI 又不想要 docker：
cargo install --git https://github.com/weironz/cortex cortex-cli。
docker pull registry.cn-shenzhen.aliyuncs.com/willspace/cortex-agentd:v0.1.37
docker pull willdockerhub/cortex-agentd:v0.1.37
记忆服务是单独一个产品，在 Cormex：
它管存储、检索与 MCP 门面，独立发版、也能单独用。自托管要两个都起 ——
先记忆后 agent（agent 连不上记忆服务时一条对话都开不了）。
自托管完整步骤见 docs/install.md。
第一步一定是生成凭据 —— 没有 CORTEX_AUTH_TOKEN_SHA256 时记忆服务拒绝启动。
Windows 桌面端
cortex-desktop-v0.1.37-x86_64-pc-windows-msvc-setup.exe 是客户端 GUI，
不是服务端 —— 它仍然需要一台记忆服务（地址在装完第一屏里填）。
这个安装程序没有代码签名，Windows SmartScreen 会拦一次：
点「更多信息」→「仍要运行」。要不要点请自己判断 ——
判断依据是 SHA256SUMS，用 certutil -hashfile <文件> SHA256 对一遍。
macOS / Linux 桌面端这一版不发，自己 flutter build，理由见 CHANGELOG。
产物校验和见 SHA256SUMS。