@leviyuan/lodestar 0.22.0 → 0.22.1
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 +236 -236
- package/docs/claude-agent-backend.md +2 -2
- package/docs/models.md +5 -5
- package/docs/release.md +3 -0
- 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
|
@@ -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
|
|
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` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
|