@leviyuan/lodestar 0.22.0 → 0.22.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lodestar.js +268 -267
- package/docs/claude-agent-backend.md +2 -2
- package/docs/models.md +8 -6
- package/docs/release.md +3 -0
- package/docs/usage.md +1 -1
- package/package.json +1 -1
|
@@ -45,9 +45,9 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
|
|
|
45
45
|
|
|
46
46
|
`session-activity.ts` 按实际存活的 Claude 订阅进程与账号绑定统计会话:执行中或最近 30 分钟收到用户消息即为活跃,启动、等待回答、排队和后台任务也计入;同群去重,当前待启动群排除后再加一。消息时间持久化,重启后可恢复近期活跃判断,不保存消息内容。
|
|
47
47
|
|
|
48
|
-
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口、OAuth 及模型专属周窗口为 10 份,Fable 专属周窗口为 5 份(总周的一半)。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 模型缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2
|
|
48
|
+
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口、OAuth 及模型专属周窗口为 10 份,Fable 专属周窗口为 5 份(总周的一半)。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 模型缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,总周剩余中相当于 Fable 尚未使用份额的部分只按四分之一计入余量和节奏(`own = max(0, 剩余 − 预留)`,`room = own + 0.25 × (剩余 − own)`),距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;仍在预留期但专属周重复或数值无效时同样按 `MISS` 排除,专属周已用完时不再预留。折价只会降低排名,随余量连续变化、不分档,预留也不会使账号耗尽。任一适用窗口已用满才是真实耗尽,不参与正常选号,同时给出 `recoversAt`:全部用光窗口中最晚的重置时间(缓存里已过期的时间照用),任一缺失则为 `null`。通过模型和档位校验的账号全部真实耗尽时,`claude-account-selection.ts` 沿用恢复会话的原账号(须在耗尽账号中),否则选 `recoversAt` 最早的耗尽账号,`null` 排最后,同值按账号列表顺序(默认账号在前)。
|
|
49
49
|
|
|
50
|
-
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent
|
|
50
|
+
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份)。每个适用窗口的节奏为 `room / span`,`span` 取距重置小时数且至少 1 小时(请求是突发的,快重置的窗口仍须撑一小时):5h 窗口 `span = clamp(小时数, 1, 5)`,跟上节奏(已用比例不超过已过时间比例,也不超过 80%)的窗口都与满窗同分;尚未启动的窗口(`claudeFiveHourUnstarted` 识别读取时的估算)按 `span = 5`、到期时间为当前时间加 5 小时计,不因快照变旧而显得紧迫;有 5h 窗口的账号逐窗花周额度,周类窗口 `span = clamp(小时数, 1, 24)`,周额度须够按满窗节奏撑过一天或撑到重置,距重置一天以上时剩不到 4.8 份即降权,5h 窗口有余量、周额度够用时这类账号一般排在只有周额度的账号之前;没有 5h 窗口的账号周类窗口 `span = max(小时数, 1)`,离重置远或快用完的周额度节奏低。账号节奏 `pace` 取各窗口最小值,`score = min(pace, 0.2) / (N+1)`:每次启动最多按每 5 小时一个满窗计,因为会话在窗口或周重置后仍留在原账号继续消耗,快作废的额度最多与满窗并列,不能把新任务都吸走。`compareClaudeQuota` 依次比较:分数降序、活跃负载升序、`pace` 降序(额度更需要尽快花掉的优先)、到期时间升序(有 5h 窗口取其重置时间,否则取该模型实际生效的周额度重置时间)、余量降序,其余保持账号列表顺序;不按有无 5h 窗口、重置先后或是否动用 Fable 预留整组排队。这里不预测任务用量,也不设 `fits`/`pressure`(Fable 预留按距总周重置不超过 2 天释放);计算不改真实额度,显式指定账号不经过这套自动排序。
|
|
51
51
|
|
|
52
52
|
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
53
53
|
|
package/docs/models.md
CHANGED
|
@@ -48,7 +48,7 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
|
|
|
48
48
|
|
|
49
49
|
## 额度
|
|
50
50
|
|
|
51
|
-
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
51
|
+
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;Claude 订阅账号行末另显示登录凭据剩余天数,如 `凭据 24–27d`(见 [Claude Code 订阅](#claude-code-订阅));GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
52
52
|
|
|
53
53
|
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存,刷新周期见[选择与管理模型](#选择与管理模型)。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
54
54
|
|
|
@@ -73,15 +73,15 @@ lodestar-claude 工作号 auth login
|
|
|
73
73
|
|
|
74
74
|
在 Claude Code 会话发送 `hi 工作号`,Lodestar 只检查这个备注对应的目录。新增备注账号通过原生订阅身份验证后,卡片显示“已登录,正在完成首次同步”,保留认证进程等待 Skills 和插件云同步完成,再收录并启动;不会扫描其他目录或代办登录。首次同步最长等待 120 秒,期间不查询该账号的模型或额度、不参与自动选号,也不能启动任务或切换到该账号。失败保留账号和原因,按提示稍后再次发送 `hi 工作号` 重试;连续失败的重试间隔依次为 1、2、4、5 分钟,不由后台额度轮询自动重试。`hi default` 指定原生默认账号。指定账号只影响本次启动;同号正在运行时显示状态,忙碌时不能切换其他号,空闲时可用 `hi 另一备注` 切换并恢复原会话。
|
|
75
75
|
|
|
76
|
-
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS`
|
|
76
|
+
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已真实耗尽,自动启动仍从中选一个,不因自动选号失败阻断启动或 `rs` 恢复:恢复已有会话且该会话原来的账号也在耗尽账号中时,沿用原账号;否则选最早恢复的耗尽账号,即全部用光的窗口都已重置的时间最早。用光的窗口缺少重置时间时恢复时间未知,排在最后;时间相同按账号列表顺序,设备默认账号在前。Fable 预留只影响排名,不会使账号判为耗尽(见下文)。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
|
|
77
77
|
|
|
78
|
-
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2
|
|
78
|
+
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,总周剩余中相当于 Fable 尚未使用份额的部分只按四分之一计入余量和节奏:这只会降低账号排名,不排除账号、不分档,也不会因此判为耗尽;距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;Fable 模型缺少专属周按 `MISS` 排除,仍在预留期但专属周重复或数值无效时也按 `MISS` 排除,专属周已用完时不再预留。其他模型专属仅兼容接口实际返回的窗口。
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
选号按各账号可持续的消耗节奏分散任务,不预测单个任务的用量:每个适用窗口的节奏是剩余份数除以距其重置的小时数(不足 1 小时按 1 小时计),账号节奏取最慢的那个窗口,且每次启动最多按每 5 小时一个满窗(每小时 0.2 份)计。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把封顶后的账号节奏除以“活跃负载单位 + 1”,作为该账号的分数,分数高者优先。
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
封顶是因为会话在窗口或周额度重置后仍留在原账号继续消耗:快作废的额度最多与满窗并列,不会把新任务都吸走。不足 1 小时按 1 小时计是因为请求是突发的:5 小时窗口至少剩 0.2 份才算满窗节奏,已用比例不超过窗口已过时间比例(也不超过 80%)的窗口都与满窗同分,其余按实际节奏降低。有 5 小时窗口的账号逐窗花周额度,周窗口最多按 24 小时折算:周额度须够按满窗节奏撑过一天或撑到周重置,否则拉低分数(距重置一天以上时即剩不到 4.8 份);窗口有余量、周额度够用时,这类账号一般排在只有周额度的账号之前。没有 5 小时限额的账号按到周重置为止的节奏计算,离重置远或快用完的周额度节奏低。同分时依次取活跃负载少、封顶前节奏高(额度更需要尽快花掉)、到期早(有 5 小时窗口看其重置时间,否则看该模型实际生效的周额度重置时间)、余量大的账号。尚未启动的 5 小时窗口不会作废,被使用时才开始计时:无论额度缓存读取了多久,都按完整 5 小时、从现在起 5 小时到期计,不会因缓存变旧而排到真正在计时、额度会作废的窗口之前。
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
选择只看真实余量、各窗口的重置时间和当前负载:不按有无 5 小时窗口、重置先后或是否动用 Fable 预留整组排队,不预留未来用量,也不设“预计是否装得下”的门槛。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按前述规则回退。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
85
85
|
|
|
86
86
|
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
87
87
|
|
|
@@ -97,6 +97,8 @@ lodestar-claude 工作号 auth login
|
|
|
97
97
|
|
|
98
98
|
订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时;已取消 5 小时限额的账号只显示周额度,不显示 5h 的 `MISS`。回复底部同样只显示实际存在的窗口:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,没有 5 小时窗口时省略该段,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
|
|
99
99
|
|
|
100
|
+
`hi` 的每个 Claude 订阅账号行末显示登录凭据剩余时间。数据来自原生 `claude auth status --json` 的 `loginExpiresAt`(需 Claude Code 2.1.325 及以上),以该账号与会话相同的配置目录、进程环境和进程级设置读取,只在本机运行、不联网,也不读取钥匙串、凭据文件或令牌。这个时刻是登录的最晚到期时间,续期不会延后;原生 Claude Code 按实际最多提前 3 天结束来提示,因此按整天显示区间,如 `凭据 24–27d`;显示的上限不超过 10 天(原生开始提醒)时为橙色。最早到期已不足 1 天时登录随时可能结束,只显示上限并标红,如 `凭据 ≤2.4d`;已过该时刻显示红色的 `凭据 可能已到期`,此时原生多半已结束登录,需要在本机重新登录。读取随该账号每 60 秒的后台额度刷新进行:距到期超过 10 天时最多每 5 分钟重读一次,更近、已过期或未知时每次都重读,重新登录后很快更新。超时、账号正在收录等临时失败沿用上次结果;原生输出无法识别(如版本不兼容)、没有结果或原生未提供日期时显示 `凭据 MISS`。账号未登录或额度查询失败时该行只显示 `MISS` 原因;回复底部不显示凭据时间。
|
|
101
|
+
|
|
100
102
|
订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi` 和回复底部共用该来源的账号与额度。
|
|
101
103
|
|
|
102
104
|
旧版“Claude”本机配置入口已移除;使用该入口的用户升级后请通过 `md` 选择“Claude Code 订阅”及模型。
|
package/docs/release.md
CHANGED
|
@@ -21,6 +21,9 @@
|
|
|
21
21
|
|
|
22
22
|
## 常见坑
|
|
23
23
|
|
|
24
|
+
- 打标签前先推送 `main` 并等 `CI` 工作流通过。它在 Linux 上跑全量测试、在 Windows 上跑更新流程用例,本机(macOS)全绿不代表这两处通过:Linux 会立刻复用刚删除目录的 inode,Windows 的文件时间与改名语义也不同。标签指向的提交若在 CI 才暴露问题,就得再发一个版本。
|
|
25
|
+
- `Production dependency audit` 或发布工作流的 `npm audit` 报出新公告时,先升级 `overrides` 中对应的安全依赖,运行 `bun scripts/sync-security-deps.ts` 并用 Bun 同步 `bun.lock`,`bun audit --production` 无告警后再发布;新公告与本次改动无关也会拦住发布。
|
|
26
|
+
|
|
24
27
|
- 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
|
|
25
28
|
- 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
|
|
26
29
|
- 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
|
package/docs/usage.md
CHANGED
|
@@ -75,7 +75,7 @@ Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会
|
|
|
75
75
|
|
|
76
76
|
账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文先显示“邮箱:…”,再按接口实际返回显示周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
|
|
77
77
|
|
|
78
|
-
`hi` 的额度区紧凑展示全部账号,一账号一行;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,GLM
|
|
78
|
+
`hi` 的额度区紧凑展示全部账号,一账号一行;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,GLM 月工具只显示百分比,不显示次数与重置时间。Claude 订阅账号行末显示登录凭据剩余天数,如 `凭据 24–27d`,上限 10 天内橙色,随时可能到期(`凭据 ≤2.4d`)或已过期红色,规则见[账号与模型](models.md#claude-code-订阅)。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注,账号尚未确定时省略该备注,自动换号后再次查看会显示新账号;待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口,不展示 Spark、gpt-reserve 等附加额度;footer 只显示当前实际使用账号,footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式并在其后追加消费积分,自动换号后跟随新账号;已结束回复始终显示该回复所属账号的积分。重置卡次数出现在 `hi` 和 `codex-reset` 回执中。
|
|
79
79
|
|
|
80
80
|
## 独立工作区
|
|
81
81
|
|