omp Folio

▎ 左侧输入 · ⏱ 订阅额度 · $ 余额 · ≡ 原生状态栏

一个 omp Composer Shape：输入区保持 omp 原有行为，右侧只显示额度/余额，下方交还给 omp 原生状态栏。面向 omp 18.12.6 的普通 ANSI 终端。

安装

本地开发使用 link：

omp plugin install /path/to/omp_composer

从 npm 安装：

omp plugin install npm:omp-folio

从 GitHub 安装：

omp plugin install github:moesama228/omp-folio

需要可复现时，钉首个自动发布后的 tag，例如 #v0.1.1。

也可以在项目里临时加载：

omp --extension /path/to/omp_composer/index.ts

安装后在 Appearance → Composer Shape → Folio Gutter 选择，或直接写全局配置：

omp config set composer.shape omp-composer-folio-gutter

• 全局安装后不要再保留项目里的 .omp/extensions/folio.ts，否则会重复加载。
• 旧配置 composer.shape: omp-composer-dock 会在首次加载时自动迁移到新 id。
• GitHub 安装是克隆，不是 link；更新后重装新 tag 或运行 omp plugin upgrade。
• npm 安装使用 omp-folio 包；首次发布前需要先完成 npm 包配置。

布局

• ▎ 输入：编辑、Vim、历史、补全、粘贴、IME 和滚动全部沿用 omp。
• ⏱ / $ 额度栏：无分隔线；图标沿用 session accent，数值加粗并右对齐。订阅显示 ⏱ 7d 60%，余额显示 $ ¥42.00。
• ≡ 状态栏：使用 omp 原生 preset，不在插件里重写 model、mode、path、git、pr、context、cost、session 等 segment。
• 宽度：88 列起左右分栏，额度栏 22–26 列；窄屏或 tui.imeSafeCursor 时放在输入下方。
• 留白：输入上下各 1 行空白 rail；首行不贴顶，额度栏与输入首行对齐。
• 颜色：左侧 rail 跟随 statusLine.sessionAccent；关闭该设置后回到主题 accent。

Provider 与额度样式

额度读取宿主 authStorage.usage.reports()；DeepSeek 例外，读取官方余额端点。

• 百分比是剩余份额：100% 满额，0% 用完；≤25% / ≤10% 显示 warning/error。多个账号无法确认时显示 ⏱ 多账号，不会相加。
• 请求失败显示 ⏱ 获取失败；数据超过 10 分钟追加 ⚠ 过期；缺失数据不会被当成 100%。DeepSeek 账户不可用时追加 ⚠ 不可用。
• DeepSeek 成功缓存 5 分钟、失败缓存 30 秒；API key 不进入日志或错误信息。其他 provider 读取宿主缓存，不逐帧联网。

验证

./node_modules/.bin/tsc --noEmit
BUN_BE_BUN=1 omp test ./src/quota.test.ts ./src/quota-panel.test.ts ./src/register.test.ts

当前结果：24 个测试全部通过。真实 omp PTY 已验证 120/70 列、原生状态栏、额度栏、IME-safe、shape 切换、退出最后帧，以及 DeepSeek、Cursor、Kimi、Antigravity、Devin 的实际额度显示。

兼容边界

• 实现与 18.12.6 对齐；升级 omp 后应更新依赖并重跑类型检查和 PTY 验证。
• omp 在扩展加载前绘制的启动首帧仍可能回退为 box，插件无法早于宿主预绘制执行。
• 没有修改 omp 源码或二进制；TSP/Tern 原生 composer 不承诺复现这里的分栏外形。

Releasing

npm version patch
git push --follow-tags

推送 v* tag 后，.github/workflows/publish.yml 会运行类型检查、测试并发布到 npm。

开发约定和设计决定见 AGENTS.md。