@leviyuan/lodestar 0.18.24 → 0.18.26

package/docs/models.md

@@ -6,7 +6,7 @@
 
 ## 配置 API Key
 
-GLM Key 可在首次安装时跳过，之后用群命令添加或更换。以下命令先向对应平台校验凭据和模型目录，通过后才保存；认证、网络或响应错误均保留原配置并给出原因。校验无需调用付费模型，也不要求先安装对应 Agent。
+GLM Key 可在首次安装时跳过，之后用群命令添加或更换。以下命令先返回回执，后台向对应平台校验凭据，通过后才保存；认证、网络或响应错误均保留原配置并给出原因。校验无需调用付费模型，也不要求先安装对应 Agent。
 
 | 账号 | 群命令 |
 | --- | --- |
@@ -24,11 +24,15 @@ GLM Key 可在首次安装时跳过，之后用群命令添加或更换。以下
 
 `[base_url]` 表示可选参数，命令中不输入方括号；API Key 只填原值，不加 `Bearer`。`glm-setup <base_url> <api_key>` 的原有格式仍可使用，GLM 的 Key 与平台地址必须对应。保存后发送 `md` 选择模型。账号配置由本机所有群共用，更新 Key 保留已有模型、档位和可见性设置。
 
-如果凭据校验通过，但保存后的模型加载因 Agent 未安装等原因失败，会明确提示“配置已保存，但暂不可用”；按提示处理后发送 `md` 刷新。认证失败会提示核对 Key，网络失败会提示检查连接和代理，不会将错误正文误报为“缺少 data 数组”。
+凭据校验通过后会明确返回“配置已保存”，模型目录和额度随后在后台加载；若 Agent 未安装或目录刷新失败，`md` 显示具体错误。处理后等待后台刷新即可。认证失败会提示核对 Key，网络失败会提示检查连接和代理，不会将错误正文误报为“缺少 data 数组”。
 
 ## 选择与管理模型
 
-发送 `model`（`md`），在 Claude Code、Codex、DeepSeek Harness 分组下选择账号，再选择模型。有多个推理档位（effort）时继续选择档位，只有一个档位时直接应用。
+发送 `model`（`md`），在 Claude Code、Codex、DeepSeek Harness 分组下选择账号，再选择模型。面板直接使用缓存，不等待平台接口或 Codex 账号查询。有多个推理档位（effort）时继续选择档位，只有一个档位时直接应用。
+
+模型目录每 5 分钟、额度每 60 秒独立在后台刷新，只有 daemon 启动会等待首次加载。`md`、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存；打开面板不会启动额外查询，某个来源变慢也不会占住交互。Codex 邮箱复用后台原生账号查询的结果。
+
+同一来源和账号的并发刷新会合并，刷新完成后一次更新缓存。网络或限流失败保留成功快照，错误写入日志，目录刷新错误也会显示在模型面板；失败按 1、2、4、5 分钟退避并遵守平台更长的限流冷却。没有缓存或认证已失效时立即显示加载中或 `MISS`。修改凭据会隔离并清除受影响账号的缓存，旧请求结果不能覆盖新配置；其他账号继续可用。
 
 | 操作 | 作用 |
 | --- | --- |
@@ -37,7 +41,7 @@ GLM Key 可在首次安装时跳过，之后用群命令添加或更换。以下
 | 补录模型 | 添加接口目录外的模型，可选择推理档位并使用 |
 | 删 | 删除补录记录；仍有会话选用时需先切换模型 |
 
-除 OpenRouter 和 PackyAPI 使用内置精选列表外，各来源默认显示接口目录中的模型，新模型会随目录刷新出现。所有来源都支持补录，记录保存在 `custom_models`；支持端点验证的来源会先验证。目录未收录不会阻止选择，实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项，不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
+除 OpenRouter 和 PackyAPI 使用内置精选列表外，各来源默认显示接口目录中的模型，新模型会随后台目录刷新出现。隐藏、显示和补录只修改本地列表，不重拉全部来源。所有来源都支持补录，记录保存在 `custom_models`；补录按本地规则检查模型 ID 和请求档位，不在交互中查询上游；实际调用不支持时由后端报告错误。目录未收录不会阻止选择，实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项，不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
 
 同账号切换 Claude 或 DSH 模型从后续回复生效；Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
 
@@ -51,7 +55,7 @@ GLM Key 可在首次安装时跳过，之后用群命令添加或更换。以下
 
 回复底部显示 `agent · 模型名/effort`，其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`，分别表示重置倒计时与已用百分比，方括号内为周窗口；余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时，回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存，账号列表仍展示本次调度失败原因。
 
-Codex 启动和换号优先使用最近一次成功的额度缓存；能选出账号就直接启动，不等待其他账号刷新。其他账号未参与选号的诊断保留在日志和 `codex-accounts` 中，不主动发送“部分账号 MISS”警告。只有无法启动或继续任务时，才主动展示相应失败或等待状态。
+Codex 启动和换号优先使用最近一次成功的额度缓存；能选出账号就直接启动，不等待其他账号刷新；没有可用缓存时明确显示 MISS，后台继续刷新。其他账号未参与选号的诊断保留在日志和 `codex-accounts` 中，不主动发送“部分账号 MISS”警告。只有无法启动或继续任务时，才主动展示相应失败或等待状态。
 
 ## Claude Code 订阅
 
@@ -61,7 +65,7 @@ Codex 启动和换号优先使用最近一次成功的额度缓存；能选出
 
 账号和模型目录通过 Claude Code 原生 SDK 查询，模型与 effort 随目录更新；未登录会显示启用引导，查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`，支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用，`enabled = true` 或省略时沿用本机登录检测；群命令更新该字段。
 
-订阅额度通过原生 `/usage` 控制接口读取，无需发送模型对话。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时。回复底部同时显示 5 小时额度与周额度：本轮所选模型有专属周额度时显示该模型的额度，否则显示总周额度，沿用紧凑格式。查询失败或缺失数据显示 `MISS`，不使用旧额度替代，也不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口，版本不支持或接口变化时明确报错。
+订阅额度通过原生 `/usage` 控制接口读取，无需发送模型对话。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时。回复底部同时显示 5 小时额度与周额度：本轮所选模型有专属周额度时显示该模型的额度，否则显示总周额度，沿用紧凑格式。后台瞬态查询失败保留成功缓存；没有缓存、认证失效或专属窗口缺数值时显示 `MISS`，不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口，版本不支持或接口变化时明确报错。
 
 订阅进程保留本机和项目的 Claude 设置，并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude native 继续保留为使用本机完整配置的来源。
 

package/docs/usage.md

@@ -26,7 +26,7 @@
 | `hi 备注` | — | 指定本次启动的 Codex 账号；`hi default` 使用设备默认账号，运行中换号会重启并恢复原 thread |
 | `codex-account [备注]` | — | 查看本群选号策略；带备注指定后续启动的账号，`default` 表示设备默认账号 |
 | `codex-account-delete 备注` | — | 删除额外账号的本地记录与独立凭据，清除各群对它的指定 |
-| `codex-auto` | — | 清除本群手动指定，恢复自动选择最高分账号 |
+| `codex-auto` | — | 清除本群手动指定，恢复按优先级与额度评分自动选号 |
 | `task` | — | 创建、查看或删除绑定的飞书任务清单 |
 | `files` | — | 查看当前工作目录的交付模式及本群文件夹入口 |
 | `files on` | — | 开启当前工作目录的云空间交付，创建或复用本群文件夹 |
@@ -38,7 +38,7 @@
 
 默认账号沿用设备上直接执行 `codex` 的登录态：使用 daemon 原始环境中的 `CODEX_HOME`，未设置时为 `~/.codex`。`codex-account` 只改变当前群后续 Codex 进程的认证选择，不覆盖默认账号，也不改变其他群。额外账号的备注名可包含中文和空格，不能包含换行或路径分隔符；`default`、`默认` 为保留名称。
 
-发送 `codex-reset` 直接为当前运行的 Codex 账号使用一次重置卡；`codex-reset 工作` 为指定账号使用，`codex-reset default` 为设备默认账号使用。当前没有运行的 Codex 账号或正在等待选号时，必须带备注。命令不会切换账号或重启会话，额度不足时也不会自动使用重置卡。回执区分已重置、本次请求此前已完成、没有可重置窗口、没有可用卡，并重新读取剩余卡数和额度；查询失败显示 `MISS`，已确认的扣卡结果仍保留。同一消息的网络重试复用幂等标识，重新发送命令则是新的一次使用请求。接口失败或结果未知时，先用 `codex-accounts` 核对额度和卡数。
+发送 `codex-reset` 直接为当前运行的 Codex 账号使用一次重置卡；`codex-reset 工作` 为指定账号使用，`codex-reset default` 为设备默认账号使用。当前没有运行的 Codex 账号或正在等待选号时，必须带备注。命令不会切换账号或重启会话，额度不足时也不会自动使用重置卡。回执区分已重置、本次请求此前已完成、没有可重置窗口、没有可用卡，并重新读取剩余卡数和额度；查询失败显示 `MISS`，已确认的扣卡结果仍保留。同一消息的网络重试复用幂等标识，重新发送命令则是新的一次使用请求。接口失败或结果未知时，先用 `hi` 核对卡数、`codex-accounts` 核对额度。
 
 额外账号不再使用时，发送 `codex-account-delete 工作`。删除会移除该账号的本地记录、独立认证目录和额度缓存，并清除所有群对它的指定，这些群下次启动恢复自动选号；共享会话历史、配置和其他账号保留。正在被会话、委派任务、额度或模型查询使用的账号不能删除；登录中的账号先用 `codex-login-cancel 工作` 取消。备注必填，设备默认账号不能通过此命令删除。需要重新添加时使用 `codex-login 工作`；本地删除不会注销 OpenAI 账号或取消订阅。
 
@@ -46,7 +46,9 @@
 
 默认账号检查通过后，`codex-login 工作` 会显示登录卡片，并在同一张卡里更新连接、授权、校验和结果。验证码与授权入口突出显示，结束后移除验证码。在手机或电脑浏览器中登录要保存的账号，输入验证码；授权结果会自动发回原群。凭据由 Codex 保存并刷新，不需要把密码或 Token 发给机器人。设备码登录须已在 ChatGPT 个人安全设置或工作区权限中启用；登录等待上限为 15 分钟，失败后重新发送命令。
 
-新会话和委派任务启动时默认自动选号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算（原生套餐标识为 `plus`、`prolite`、`pro`），周分数为 **周剩余份额 ÷ 距周重置小时数**。Plus 的满 5h 窗口按 0.15 份计算，短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**，最终取周分数和短窗分数的较小值；Pro 使用周分数。所有模式都选择最高分，同分优先当前可连续使用额度更多的账号。两种窗口约束同一份消耗，不相加。
+新会话和委派任务启动时默认自动选号。首先优先使用一次周额度完整未使用的账号：原始已用比例为 0，且读取时仍是完整 7 天周窗口；显示取整后的 `0%` 或 `7.0d` 不足以判定。实际产生用量后，同周旧缓存不再获得这项优先级。其次优先距离周重置不超过 5 小时的账号，越早重置越优先。两类账号仍须通过模型、套餐和所有额度检查。
+
+其余账号按分数从高到低选择，同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算（原生套餐标识为 `plus`、`prolite`、`pro`），周分数为 **周剩余份额 ÷（距周重置小时数 − 5）**，提前 5 小时安排消耗；临期账号直接按优先级处理，不做零或负分母计算。Plus 的满 5h 窗口按 0.15 份计算，短窗分数仍为 **5h 剩余份额 ÷ 距5h重置小时数**，普通评分取周分数和短窗分数的较小值；Pro 使用周分数。两种窗口约束同一份消耗，不相加。
 
 启动和换号优先使用最近一次成功的额度缓存，能选出账号就直接启动，不等待额外查询。所有来源、群和 Agent 的额度查询共用一分钟惰性缓存，并合并同账号并发请求；过期后按需查询，失败冷却依次为 1、2、4、5 分钟，并遵守上游更长的等待时间。这不是每分钟自动刷新全部账号。`hi`、`codex-accounts` 也遵守缓存与冷却，网络或限流导致刷新失败时，额度区域保留同账号的成功缓存，账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时，按原格式显示本条回复所属账号的成功缓存，没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存，认证失败也不会继续显示旧额度；已由实际请求确认耗尽的账号，必须通过实时查询确认恢复，不能用旧缓存解除耗尽记录。
 
@@ -60,9 +62,9 @@
 
 Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会话、Skills、插件文件和会话写锁，SQLite 状态使用共享目录；认证文件、模型缓存和临时运行文件保持独立。Windows 创建文件软链接需要系统允许；失败直接报告，不自动改用复制。账号备注与群选择位于 Lodestar 数据目录的 `codex-accounts.json`，额外认证位于 `codex-accounts/<内部 ID>/auth.json`。这些文件不应进入项目仓库。
 
-账号命令统一回复简洁卡片：长错误可展开查看；`codex-accounts` 仅展示主额度，进度条为六格，每页显示 4 个记录，同时标出当前模式下的顺序和 `份/h` 分数，后续页用 `codex-accounts 2` 等命令查看。每页底部列出全部 Codex 账号命令，包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重，未知身份或查询失败显示 `MISS`。
+账号命令统一回复简洁卡片：长错误可展开查看；`codex-accounts` 按调度顺序排列，每页显示 4 个记录，标题为 `#1·备注「0.111/h」`；距离重置不超过 5 小时的账号显示「临期优先」。正文依次显示“邮箱：…”、周额度和可选的 5h 额度，每个窗口一行，包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令，包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重，未知身份或查询失败显示 `MISS`。
 
-`hi` 的额度区紧凑展示全部账号，一账号一行；DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注，重置卡显示为“重置 N”，GLM 月工具只显示百分比，不显示次数与重置时间。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注，账号尚未确定时省略该备注，自动换号后再次查看会显示新账号；待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口，不展示 Spark、gpt-reserve 等附加额度；footer 只显示当前实际使用账号，footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式，自动换号后跟随新账号。重置卡次数出现在账号明细、`hi` 和 `codex-reset` 回执中。
+`hi` 的额度区紧凑展示全部账号，一账号一行；DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注，重置卡显示为“重置 N”，GLM 月工具只显示百分比，不显示次数与重置时间。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注，账号尚未确定时省略该备注，自动换号后再次查看会显示新账号；待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口，不展示 Spark、gpt-reserve 等附加额度；footer 只显示当前实际使用账号，footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式，自动换号后跟随新账号。重置卡次数出现在 `hi` 和 `codex-reset` 回执中。
 
 ## 独立工作区
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.18.24",
+  "version": "0.18.26",
   "publishConfig": {
     "access": "public"
   },