HELP & SUPPORT

让它顺利
来到手边。

Codex Quota Key 的安装、使用与排查指南。

01 / 安装前确认

商城提交准备中，目前没有正式商城下载入口。请勿把此页面理解为已通过罗技审核。

确认设备与环境
当前目标为 Windows 与 MX Creative Keypad，需要已安装并运行的 Logi Options+。尚未验证的设备与 Mac 不在支持范围内。
准备 Codex CLI
按 OpenAI 官方指南安装并登录 Codex CLI。插件通过 CLI 查询额度，不要求你向作者提供密码或 API 密钥。
安装插件
正式发布后使用商城安装入口；若获得作者提供的测试 .lplug4 包，可用 Logi 的插件安装器打开。测试包的安装不等于商城审核通过。
添加按键
在 Options+ 的“所有操作 → Codex Quota Key → CODEX 工具”中，把需要的操作拖到空闲键。插件无需覆盖你的现有配置。

综合面板外层显示额度与整体状态圆点。按下展开，左上角由罗技提供返回键；右上进入对话列表，右中查看固定对话，右下进入独立桌宠页。四个额度相关按键保持原布局。

点击列表中的对话查看详情，并固定或取消固定。详情中的“打开 Codex”会跳转到该对话；已验证应用运行时的跳转，冷启动仍待实测。语言可在插件设置中选择中文、英文或日文。

独立“额度总览”可选双击打开 Codex；综合面板入口由 Logi 管理，不提供相同的双击行为。

为什么额度和桌面看到的不一样？

插件使用 Codex CLI 当前登录账号。如果桌面使用另一个账号，两者额度可能不同。先核对账号；再按额度键重新查询。

为什么显示“未知”或空心圆点？

实时状态依赖正在运行的 Codex 桌面应用及兼容的本地通信协议。未连接、协议不兼容或没有可用会话快照时显示未知，不按静默时长猜测空闲。额度查询仍使用 CLI，可独立工作。

为什么 ChatGPT 普通聊天不在列表里？

当前只支持本机 Codex 对话，不包含 ChatGPT 云端普通聊天或远程会话。最多监控 32 个未归档的本机会话，并优先包含固定对话。

编辑器里的数字没有变？

Options+ 编辑器可能缓存按键预览。先查看实体键，并比较展开面板和返回后的数值。如果实体键也不更新，检查 CLI 登录、网络和 Logi 服务。

怎么识别颜色？

外层额度数字与顶部进度条：大于 30% 为绿，10%–30% 为黄，低于 10% 为红；周额度用完也会标红。状态圆点：蓝色运行中，黄色等待输入或批准，红色失败，绿色完成待查看，灰色空闲或已停止，空心为未知。

卸载后还会留下什么？

通过 Logi 插件管理卸载。CodexQuotaKey 本地应用数据目录中可能保留额度缓存、固定会话 ID、桌宠设置与素材缓存、状态诊断；可按需清理。不要删除包含 Codex 自身数据的 .codex 目录。

可在你看到插件的作者发布帖下反馈，并附以下信息。作者的 GitHub 账号是 fuxiyc（七月七夕）↗。独立问题仓库尚未开放。

插件版本：
Windows / Logi Options+ 版本：
设备型号：
操作步骤：
预期结果：
实际结果：
实体键是否复现（或仅编辑器预览）：

不要附上账号凭据、auth.json、完整聊天日志或包含私人对话的截图。只需提供能说明问题的最少信息。