@leviyuan/lodestar 0.21.31 → 0.21.33
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 +254 -249
- package/docs/claude-agent-backend.md +2 -2
- package/docs/models.md +1 -1
- package/docs/release.md +1 -0
- package/docs/usage.md +2 -1
- package/package.json +1 -1
|
@@ -44,9 +44,9 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
|
|
|
44
44
|
|
|
45
45
|
`session-activity.ts` 按实际存活的 Claude 订阅进程与账号绑定统计会话:执行中或最近 30 分钟收到用户消息即为活跃,启动、等待回答、排队和后台任务也计入;同群去重,当前待启动群排除后再加一。消息时间持久化,重启后可恢复近期活跃判断,不保存消息内容。
|
|
46
46
|
|
|
47
|
-
`claude-quota.ts` 以完整 5h
|
|
47
|
+
`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 尚未使用份额后的部分,距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;仍在预留期但专属周重复或数值无效时同样按 `MISS` 排除,专属周已用完时不再预留,预留后没有余量的账号按耗尽处理。真实耗尽账号不参与正常选号。
|
|
48
48
|
|
|
49
|
-
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份),账号余量为 `R` 份,则每会话份额为 `R / (N+1)`。能安排任务的 5h 账号整组优先:窗口额度不能结转,不在这里花掉,该账号的周额度就用不完。5h 组内仍按份额分摊,避免并发任务都压在同一个受限窗口上,其余同分时先接更早重置的 5h 窗口。没有 5h 限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、活跃会话数升序、余量降序、5h
|
|
49
|
+
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份),账号余量为 `R` 份,则每会话份额为 `R / (N+1)`。能安排任务的 5h 账号整组优先:窗口额度不能结转,不在这里花掉,该账号的周额度就用不完。5h 组内仍按份额分摊,避免并发任务都压在同一个受限窗口上,其余同分时先接更早重置的 5h 窗口。没有 5h 限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、活跃会话数升序、余量降序、5h 余量降序破同分。这里不预测任务用量,也不设 `fits`/`pressure`(Fable 预留按距总周重置不超过 2 天释放);计算不改真实额度,显式指定账号不经过这套自动排序。
|
|
50
50
|
|
|
51
51
|
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
52
52
|
|
package/docs/models.md
CHANGED
|
@@ -75,7 +75,7 @@ lodestar-claude 工作号 auth login
|
|
|
75
75
|
|
|
76
76
|
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已明确耗尽,自动启动回退到设备默认账号;恢复已有会话且该会话原来的账号也在耗尽账号中时,优先沿用原账号。默认账号尚未登录、又不是恢复原账号时,改用第一个通过同样校验的耗尽账号,不因自动选号失败阻断启动或 `rs` 恢复。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
|
|
77
77
|
|
|
78
|
-
所有账号使用同一套调度模型,不区分账号类型:一个完整 5
|
|
78
|
+
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,只能使用总周剩余中扣除 Fable 尚未使用份额后的部分,距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;Fable 模型缺少专属周按 `MISS` 排除,仍在预留期但专属周重复或数值无效时也按 `MISS` 排除,专属周已用完时不再预留。其他模型专属仅兼容接口实际返回的窗口。
|
|
79
79
|
|
|
80
80
|
选号先看能否在 5 小时窗口里安排任务,再按余量分散,不预测单个任务的用量。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把账号余量除以“活跃负载单位 + 1”,作为该账号的份额。
|
|
81
81
|
|
package/docs/release.md
CHANGED
|
@@ -24,4 +24,5 @@
|
|
|
24
24
|
- 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
|
|
25
25
|
- 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
|
|
26
26
|
- 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
|
|
27
|
+
- 工作流里 `bun run ci` 偶发失败在 Linux 专用用例 `src/pid-guard.test.ts`(`/proc/<pid>/cmdline` 读到空行,报「命令行为空」);这是既有的进程读取竞态,不是本次改动引起。确认日志只有这一条后 `gh run rerun <run-id> --failed` 重跑即可,不要为此改版本或移动已推送的 tag。
|
|
27
28
|
- `scripts/publish-verified-package.mjs` 只接受 `npm pack --json` 生成的清单(含 `name`、`version`、`filename`、`integrity`),并在 `NODE_AUTH_TOKEN` 缺失时直接拒绝发布。
|
package/docs/usage.md
CHANGED
|
@@ -93,11 +93,12 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
|
|
|
93
93
|
| 完整指令 | 缩写 / 别名 | 行为 |
|
|
94
94
|
| --- | --- | --- |
|
|
95
95
|
| `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀,同一个备注对应同一个群。基名跟随当前群:主群是 `<项目>`,WT 群是 `<项目>[分支]`。继承账号、模型并共享该目录配置,启动新会话 |
|
|
96
|
+
| `btwlist` | `bl` | 列出本机登记的全部临时会话:群名、所属项目、创建时间、模型和当前运行状态;当前群会标「本群」 |
|
|
96
97
|
| `fork` | `fk` | 选择一条用户输入,在临时群里从这条输入之前分叉 |
|
|
97
98
|
| `back` | `bk` | 选择一条用户输入,让本群接到这条输入之前的新分支 |
|
|
98
99
|
| `bye` | — | 自己退出临时群;最后一个人退出时停止会话并解散整个群 |
|
|
99
100
|
|
|
100
|
-
`btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*`
|
|
101
|
+
`btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。发送 `btwlist`(别名 `bl`)可按创建时间倒序查看本机登记的全部临时会话;它只读本地租约和已加载会话,不会联网刷新群列表。
|
|
101
102
|
|
|
102
103
|
`fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
|
|
103
104
|
|