@leviyuan/lodestar 0.21.27 → 0.21.30
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 +227 -227
- package/docs/claude-agent-backend.md +4 -4
- package/docs/models.md +9 -7
- 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 额度为一份,所有账号统一:普通完整周窗口为 10 份,Fable 总周为 5 份、专属周为 10
|
|
47
|
+
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口为 10 份,Fable 总周为 5 份、专属周为 10 份。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数,真实耗尽账号不参与正常选号。
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份),账号余量为 `R` 份,则每会话份额为 `R / (N+1)`。能安排任务的 5h 账号整组优先:窗口额度不能结转,不在这里花掉,该账号的周额度就用不完。5h 组内仍按份额分摊,避免并发任务都压在同一个受限窗口上,其余同分时先接更早重置的 5h 窗口。没有 5h 限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、活跃会话数升序、余量降序、5h 余量降序破同分。这里不预测任务用量、不按重置时间分段,也不设 `fits`/`pressure`;计算不改真实额度,显式指定账号不经过这套自动排序。
|
|
50
50
|
|
|
51
51
|
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
52
52
|
|
|
@@ -60,7 +60,7 @@ OpenRouter 保持自己的精选模型规则。通用中转站只按站点协议
|
|
|
60
60
|
|
|
61
61
|
`md` 等待模型目录刷新完成后生成账号卡。刷新开始会清空能力数据,不能先取此时的空数组生成“0 个模型”卡片;失败状态显示 `MISS`,用户明确清空的就绪列表才显示零项。面板记录实际 `message_id`,在模型列表、添加目录和分页间保持一致。
|
|
62
62
|
|
|
63
|
-
活跃、续卡和结束 footer 的模型标识共用 `footerModelLabel`,固定为 `agent · 模型名/effort`,Agent id 小写,模型名剥除 `claude:`、`[1m]`;模型或 effort 缺失时显示对应的 `MISS`。footer 的窗口额度保留原格式 `4.1h·7%·[6.9d·17%]
|
|
63
|
+
活跃、续卡和结束 footer 的模型标识共用 `footerModelLabel`,固定为 `agent · 模型名/effort`,Agent id 小写,模型名剥除 `claude:`、`[1m]`;模型或 effort 缺失时显示对应的 `MISS`。footer 的窗口额度保留原格式 `4.1h·7%·[6.9d·17%]`,即重置倒计时与已用百分比,周窗口放在方括号中;Claude 订阅账号没有 5h 窗口时省略该段,只显示 `[6.9d·17%]`,不补 `MISS`。不添加“额度 5h 已用”等标签或月度工具明细。结构化余额通过 `unifiedUsageSummary` 显示 `余额 $…` / `余额 ¥…`,控制台仍可展示完整窗口明细。失败明确显示 MISS。
|
|
64
64
|
|
|
65
65
|
`[claude.models.<name>].model` 保留旧 `claude:<name>` 路由的解析。账号、显示名和模型目录由 Token Source 管理;Claude 槽位映射使用账号的 `slots`。
|
|
66
66
|
|
|
@@ -111,7 +111,7 @@ Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TO
|
|
|
111
111
|
|
|
112
112
|
## DeepSeek Harness 原生后端
|
|
113
113
|
|
|
114
|
-
`DshProcess` 使用当前安装的运行目录启动 Node DSH 子进程,以 `sdk` profile 加载 `dsh-bridge` Cordis 插件,替换默认 SDK JSON-RPC server
|
|
114
|
+
`DshProcess` 使用当前安装的运行目录启动 Node DSH 子进程,以 `sdk` profile 加载 `dsh-bridge` Cordis 插件,替换默认 SDK JSON-RPC server。启动补丁先读取所装 `@deepseek-ai/dsh-sdk-app/cordis.patch.yml`:profile 已自带 ask-user 工具时不再插入同插件(重复注册会让 DSH 启动失败),读取不到时保留插入以兼容旧版。0.2.2 起模型接入链需要的 credentials 服务保持启用,凭据仍只由 Lodestar 注入的环境变量提供,不写登录态。Lodestar 的 stdio 协议只承载控制和事件;Agent 循环、工具执行、持久化及子 Agent 由 DSH 管理。
|
|
115
115
|
|
|
116
116
|
Agent 运行依赖由 `src/agent-updates.ts` 独立安装,daemon 启动时不检查或更新。自动更新默认关闭;手动运行 `lodestar-update --agents-only`,或在 `[runtime.agent_auto_update]` 中分别开启 `codex`、`claude`、`dsh` 后,各自每 6 小时检查 upstream latest。安装成功直接启用,旧任务继续使用各自目录。更新失败不修改当前安装记录,只记更新日志并向更新调用方返回失败;已有安装照常供新任务使用,已开启自动更新的 Agent 下个 6 小时周期再试。启动和版本查询不显示历史更新错误;没有可用安装记录或安装损坏仍报错。DSH 子包的 dist-tag 可能不同步,因此从主包最新版本递归读取 dependencies/peerDependencies/optionalDependencies,整族安装该次动态选中的版本。不存在兼容版本白名单;不兼容直接报告并后续适配。`dsh-bridge` 被放入选中运行目录,从同一依赖树加载,握手版本来自实际 package.json。开发依赖和 Bun 锁文件只是本地测试快照,不限制生产更新。普通安全 overrides 同时用于独立运行目录,tarball 验收真实执行更新器、包审计和原生查询。
|
|
117
117
|
|
package/docs/models.md
CHANGED
|
@@ -48,11 +48,11 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
|
|
|
48
48
|
|
|
49
49
|
## 额度
|
|
50
50
|
|
|
51
|
-
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude
|
|
51
|
+
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
52
52
|
|
|
53
53
|
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存。Codex 订阅模型目录和额度均每 2 小时主动刷新,其他来源仍为 5 分钟和 60 秒;普通交互只读已提交缓存,手动打开模型列表允许立即额外查询,同账号并发刷新合并。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
54
54
|
|
|
55
|
-
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]
|
|
55
|
+
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;Claude 订阅账号已取消 5 小时限额时省略 5h 段,只显示 `[6.9d·17%]`,不补 `MISS`。余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时,回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存,账号列表仍展示本次调度失败原因。
|
|
56
56
|
|
|
57
57
|
Codex 启动和换号优先使用最近一次成功的额度缓存;能选出账号就直接启动,不等待其他账号刷新;没有可用缓存时明确显示 MISS,后台继续刷新。其他账号未参与选号的诊断保留在日志和 `codex-accounts` 中,不主动发送“部分账号 MISS”警告。只有无法启动或继续任务时,才主动展示相应失败或等待状态。
|
|
58
58
|
|
|
@@ -73,13 +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
|
-
|
|
76
|
+
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已明确耗尽,自动启动回退到设备默认账号;恢复已有会话且该会话原来的账号也在耗尽账号中时,优先沿用原账号。默认账号尚未登录、又不是恢复原账号时,改用第一个通过同样校验的耗尽账号,不因自动选号失败阻断启动或 `rs` 恢复。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
|
|
77
77
|
|
|
78
|
-
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10
|
|
78
|
+
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10 份。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。缺少 Fable 专属窗口时按 `MISS` 排除,其他模型专属仅兼容接口实际返回的窗口。
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
选号先看能否在 5 小时窗口里安排任务,再按余量分散,不预测单个任务的用量。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把账号余量除以“活跃负载单位 + 1”,作为该账号的份额。
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
能安排任务的 5h 账号整组优先:5 小时窗口的额度不能结转,不在窗口里花掉,该账号的周额度就用不完。5h 组内按份额从高到低接任务,份额相同时先接更早重置的 5 小时窗口。没有 5 小时限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、余量、5h 余量排序。
|
|
83
|
+
|
|
84
|
+
选择只看真实余额、到期时间和当前会话数:不按重置时间分段、不预留未来用量,也不设“预计是否装得下”的门槛。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按上一条规则回退。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
83
85
|
|
|
84
86
|
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
85
87
|
|
|
@@ -93,7 +95,7 @@ lodestar-claude 工作号 auth login
|
|
|
93
95
|
|
|
94
96
|
账号和模型目录通过 Claude Code 原生 SDK 查询,模型与 effort 随目录更新;未登录会显示启用引导,查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`,支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用,`enabled = true` 或省略时沿用本机登录检测;群命令更新该字段。
|
|
95
97
|
|
|
96
|
-
订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5
|
|
98
|
+
订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时;已取消 5 小时限额的账号只显示周额度,不显示 5h 的 `MISS`。回复底部同样只显示实际存在的窗口:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,没有 5 小时窗口时省略该段,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
|
|
97
99
|
|
|
98
100
|
订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi` 和回复底部共用该来源的账号与额度。
|
|
99
101
|
|