@leviyuan/lodestar 0.21.8 → 0.21.10
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-agent.js +54 -59
- package/dist/lodestar-claude.js +60 -0
- package/dist/lodestar-setup.js +54 -59
- package/dist/lodestar-stop.js +3 -3
- package/dist/lodestar-update.js +52 -57
- package/dist/lodestar-version.js +14 -19
- package/dist/lodestar.js +251 -251
- package/docs/claude-agent-backend.md +10 -0
- package/docs/configuration.md +1 -0
- package/docs/models.md +26 -1
- package/docs/usage.md +1 -1
- package/package.json +8 -4
|
@@ -36,6 +36,16 @@ Token Source 管理账号凭据、模型目录、启动环境、默认模型、e
|
|
|
36
36
|
|
|
37
37
|
Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度,在 `md` 中选择“Claude Code 订阅”。
|
|
38
38
|
|
|
39
|
+
`claude-accounts.ts` 管理默认及按 `hi 备注` 首次收录的账号元数据,原生登录由用户手动完成;来源内部使用独立账号视图、模型目录和额度缓存。MD 汇总可用账号目录,启动时再校验实际选中的账号;默认账号未登录不会遮住已收录的可用账号。`claude-account-selection.ts` 只在启动时选号,不负责耗尽轮换。主会话首次提交输入前完成原生身份验证,账号实际变化会使旧模型/额度缓存失效。
|
|
40
|
+
|
|
41
|
+
`session-activity.ts` 按实际存活的 Claude 订阅进程与账号绑定统计会话:执行中或最近 30 分钟收到用户消息即为活跃,启动、等待回答、排队和后台任务也计入;同群去重,当前待启动群排除后再加一。消息时间持久化,重启后可恢复近期活跃判断,不保存消息内容。
|
|
42
|
+
|
|
43
|
+
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口为 10 份,Fable 总周为 5 份、专属周为 10 份。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 缺少唯一专属周也不参与选号。真实窗口耗尽与预测不足分别处理。
|
|
44
|
+
|
|
45
|
+
令已有活跃会话为 `N`、新增后每小时需求 `d = 0.1 × (N+1)`,某窗口当前余额为 `R`、完整容量为 `C`、距重置为 `H` 小时。当前段需求为 `d × min(H,1)`,分数为 `(R - d × min(H,1)) / max(H,1)`;若 `H < 1`,另检查重置后需求 `d × (1-H)`,其分数为 `C - d × (1-H)`(按一小时计)。账号 `score` 取所有段分数的最小值,`pressure` 取各段需求/额度的最大值,全部段满足需求才是 `fits`。先选 fits 账号并按 score 降序、pressure 升序;预测不足但真实可用的账号保留 `ready`,按 pressure 升序、score 降序分摊。之后按活跃会话数升序、5h 剩余降序及默认/收录顺序排序。各窗口始终使用自己的重置时间,预留不改真实额度,也不从速率再次扣除;不设临期绝对优先,显式指定账号不经过这套自动排序。
|
|
46
|
+
|
|
47
|
+
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
48
|
+
|
|
39
49
|
`model` 按 Claude Code、Codex、DeepSeek Harness 分组,组 ID 由 `ELEMENTS.modelAgentGroup` 生成。两个 Agent 下的 DeepSeek 来源都显示为 DeepSeek,协议 id 保持不变。选账号后进入模型列表;多个档位才展示 effort 卡,只有一个档位时直接应用,获取失败显示 `MISS`。同 provider/source 的切换调用 `setModelSettings`:Claude 和 DSH 从后续 turn 使用,Codex 保存选择并在重启进程后应用。跨 provider/source 或需要变更项目启动配置时,只能在空闲状态更换进程。
|
|
40
50
|
|
|
41
51
|
OpenRouter 和 PackyAPI 默认按指定家族从兼容目录筛选最新数字版本;显隐保存增量,显式 `models` 仍保留为固定列表,不自动切换运行模型。其余来源由 `withModelVisibility` 在真实接口目录上应用 `hidden_models`。接口项通过显示/隐藏调整可见性,新增上游模型自动进入列表。所有来源都支持用 `custom_models` 补录列表外模型,`origin` 区分接口项和补录项;GLM / DeepSeek 会先做端点验证,补录模型可直接选择请求档位使用,DSH 原生解析目录外模型,其余来源使用 Agent 请求档位;不能用目录白名单挡住用户补录。接口收录同名模型后按接口项管理,不重复展示。
|
package/docs/configuration.md
CHANGED
|
@@ -28,6 +28,7 @@ lodestar-setup
|
|
|
28
28
|
| `lodestar-stop` | 停止 daemon |
|
|
29
29
|
| `lodestar-update` | 升级 Lodestar 及实际使用的 Codex、Claude Code/SDK、DSH;`--agents-only` 仅立即更新 Agent |
|
|
30
30
|
| `lodestar-version` | 查看 Lodestar、实际 Agent 版本及运行目录 |
|
|
31
|
+
| `lodestar-claude <备注> [原生参数...]` | 用户终端入口,使用 Lodestar 管理的当前 Claude 安装和对应账号目录;例如 `lodestar-claude 工作号 auth login`,不自动收录账号或清理历史 |
|
|
31
32
|
| `lodestar-agent` | 调用已配置模型执行任务;不支持 Claude 订阅,遵守 Claude 用户协议,中转站等第三方 Claude 模型仍可调用 |
|
|
32
33
|
|
|
33
34
|
启动和停止命令会核对 PID 对应的实际入口,读取进程信息失败时明确报错。无法识别的运行时选项、macOS 无法区分边界的含空格入口、Windows 相对入口也会拒绝操作,请通过对应服务管理器处理。旧式单行 PID 文件缺少入口标识,`lodestar-stop` 会拒绝发送信号;请先核对该 PID 的完整命令行,再通过服务管理器或精确 PID 停止。停止命令以进程退出为准,删除 PID 文件不会被当作停止成功。
|
package/docs/models.md
CHANGED
|
@@ -51,7 +51,7 @@ OpenRouter 和 PackyAPI 默认按指定家族精选最新数字版本,其他
|
|
|
51
51
|
|
|
52
52
|
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅保留主窗口和模型专属周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
53
53
|
|
|
54
|
-
所有群、Agent、`hi
|
|
54
|
+
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存。模型目录每 5 分钟、额度每 60 秒在后台刷新;普通交互只读已提交缓存,不等待上游查询,同账号并发请求合并。启动首次预热及显式首次收录账号可以等待查询完成。失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟;上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
55
55
|
|
|
56
56
|
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时,回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存,账号列表仍展示本次调度失败原因。
|
|
57
57
|
|
|
@@ -61,6 +61,31 @@ Codex 启动和换号优先使用最近一次成功的额度缓存;能选出
|
|
|
61
61
|
|
|
62
62
|
在运行 Lodestar 的本机通过 `claude auth login` 登录 Claude 订阅后,发送 `md` → Claude Code → **Claude Code 订阅**。来源 id 为 `claude-sub`,可与 GLM、DeepSeek、OpenRouter 同时使用;无需复制登录凭据或填写 API key。
|
|
63
63
|
|
|
64
|
+
额外账号由用户自行登录,目录固定为 `~/.claude-accounts/备注名`。例如:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
# desc: 手动登录备注为工作号的 Claude 订阅
|
|
68
|
+
lodestar-claude 工作号 auth login
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
`lodestar-claude <备注> [原生参数...]` 选择对应账号目录并将其余参数传给原生 Claude Code。上例的账号目录与 `CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/工作号" claude auth login` 一致。命令本身不收录账号、不清理历史,登录后仍需在群内发送 `hi 工作号`。
|
|
72
|
+
|
|
73
|
+
该入口仅供用户本机终端使用,受管 Agent 上下文中拒绝启动;使用 Lodestar 当前选中的已安装 Claude 运行时,缺失时报错,不自动安装或回退。它保留终端的 `HOME` 和工作目录;`default` 保留终端 `CLAUDE_CONFIG_DIR` 的未设置状态或原始路径,不读取 `[claude.env]`。
|
|
74
|
+
|
|
75
|
+
在 Claude Code 会话发送 `hi 工作号`,Lodestar 只检查这个备注对应的目录,通过原生订阅身份验证后收录并启动;不会扫描其他目录或代办登录。`hi default` 指定原生默认账号。指定账号只影响本次启动;同号正在运行时显示状态,忙碌时不能切换其他号,空闲时可用 `hi 另一备注` 切换并恢复原会话。
|
|
76
|
+
|
|
77
|
+
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。5 小时、总周以及接口实际返回的 OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽也不能入选。
|
|
78
|
+
|
|
79
|
+
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10 份,分别受各自重置时间约束;有效周比例仍是 `min(总周剩余比例 × 50%, Fable 专属周剩余比例)`。缺少 Fable 专属窗口时按 `MISS` 排除,其他模型专属仅兼容接口实际返回的窗口。
|
|
80
|
+
|
|
81
|
+
选号同时考虑同一账号正在承载的会话。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为活跃;等待回答、排队和后台任务也计入,同群不重复计算。每个活跃会话预计未来一小时使用完整 5 小时额度的 `10%`,选号再为本次启动加入一份同样的需求。例如账号已有两个活跃会话,新会话加入后,一小时预计共用 `30%` 的完整 5 小时额度。
|
|
82
|
+
|
|
83
|
+
每个额度窗口独立预留预计用量;一小时内重置的窗口按重置前后分段计算,不把未来恢复的额度当作当前余额。预计能承载所有需求的账号优先,再比较预留后的剩余分配速率。若所有真实可用账号都预计不足,继续按“预计需求 ÷ 可用额度”的压力从低到高分摊;这是调度估计,真实耗尽、认证失败或 `MISS` 的账号仍不会入选。各项相同时优先活跃会话更少、5 小时余量更多的账号,最后保持默认账号及收录顺序。预留不修改真实额度,也没有临期绝对优先。自动选择只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
84
|
+
|
|
85
|
+
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和各账号凭据、设置保留。重复收录只检查共享链接,不再次清理。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
86
|
+
|
|
87
|
+
默认账号保留原生配置目录的“未设置”状态或原始路径;不要把默认登录改成显式 `CLAUDE_CONFIG_DIR=~/.claude` 来代替,macOS 上这可能对应不同的钥匙串登录项。登录和续期由原生 Claude Code 管理,Lodestar 不读取或复制凭据文件。`hi` 按备注显示每个账号的额度,回复页脚使用实际执行该轮任务的账号。
|
|
88
|
+
|
|
64
89
|
发送 `claude-sub` 查看开关和可用状态,`claude-sub on` 启用,`claude-sub off` 禁用。开关对这台 Lodestar 的所有群生效并持久保存,只控制「Claude Code 订阅」来源,保留本机登录态及其他来源。禁用后不查询订阅模型和额度、不接受新任务;尚未送入 Agent 的排队消息会提示重发,已经在执行的任务继续完成。再次启用后仍须有有效订阅登录。
|
|
65
90
|
|
|
66
91
|
账号和模型目录通过 Claude Code 原生 SDK 查询,模型与 effort 随目录更新;未登录会显示启用引导,查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`,支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用,`enabled = true` 或省略时沿用本机登录检测;群命令更新该字段。
|
package/docs/usage.md
CHANGED
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
| `codex-login-cancel [备注]` | — | 取消本人在本群发起的 Codex 登录;只有一个等待任务时可省略备注 |
|
|
24
24
|
| `codex-accounts [页码]` | — | 卡片列出账号额度、调度分数、顺序与当前/优先账号标记 |
|
|
25
25
|
| `codex-reset [备注]` | — | 直接使用一次 Codex 重置卡;省略备注为当前运行账号,`default` 指定设备默认账号 |
|
|
26
|
-
| `hi 备注` | — |
|
|
26
|
+
| `hi 备注` | — | 按当前 Agent 指定本次启动的订阅账号;Claude 账号首次使用时按备注发现并收录,`hi default` 使用设备默认账号;Claude 忙碌时拒绝换号,空闲时恢复同一历史 |
|
|
27
27
|
| `codex-account [备注]` | — | 查看本群选号策略;带备注指定后续启动的账号,`default` 表示设备默认账号 |
|
|
28
28
|
| `codex-account-delete 备注` | — | 删除额外账号的本地记录与独立凭据,清除各群对它的指定 |
|
|
29
29
|
| `codex-auto` | — | 清除本群手动指定,恢复按优先级与额度评分自动选号 |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@leviyuan/lodestar",
|
|
3
|
-
"version": "0.21.
|
|
3
|
+
"version": "0.21.10",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -41,7 +41,8 @@
|
|
|
41
41
|
"build:update": "bun build src/update-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-update.js",
|
|
42
42
|
"build:version": "bun build src/version-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-version.js",
|
|
43
43
|
"build:agent": "bun build src/agent-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-agent.js",
|
|
44
|
-
"build": "bun
|
|
44
|
+
"build:claude": "bun build src/claude-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-claude.js",
|
|
45
|
+
"build": "bun run build:daemon && bun run build:setup && bun run build:stop && bun run build:update && bun run build:version && bun run build:agent && bun run build:claude && bun run build:dsh",
|
|
45
46
|
"prepublishOnly": "bun run ci",
|
|
46
47
|
"postinstall": "node scripts/postinstall.cjs",
|
|
47
48
|
"build:dsh": "bun build src/dsh-bridge.ts --target=node --packages=external --outfile=dist/dsh-bridge.js"
|
|
@@ -52,7 +53,8 @@
|
|
|
52
53
|
"lodestar-stop": "./dist/lodestar-stop.js",
|
|
53
54
|
"lodestar-update": "./dist/lodestar-update.js",
|
|
54
55
|
"lodestar-version": "./dist/lodestar-version.js",
|
|
55
|
-
"lodestar-agent": "./dist/lodestar-agent.js"
|
|
56
|
+
"lodestar-agent": "./dist/lodestar-agent.js",
|
|
57
|
+
"lodestar-claude": "./dist/lodestar-claude.js"
|
|
56
58
|
},
|
|
57
59
|
"files": [
|
|
58
60
|
"dist/",
|
|
@@ -76,6 +78,7 @@
|
|
|
76
78
|
"cross-spawn": "^7.0.6",
|
|
77
79
|
"fast-uri": "3.1.8",
|
|
78
80
|
"fflate": "0.8.3",
|
|
81
|
+
"follow-redirects": "1.16.1",
|
|
79
82
|
"hono": "4.13.12",
|
|
80
83
|
"http-proxy-agent": "^7.0.2",
|
|
81
84
|
"https-proxy-agent": "^7.0.6",
|
|
@@ -103,7 +106,8 @@
|
|
|
103
106
|
"protobufjs": "7.6.5",
|
|
104
107
|
"proxy-addr": "2.0.8",
|
|
105
108
|
"qs": "6.16.0",
|
|
106
|
-
"ws": "8.21.3"
|
|
109
|
+
"ws": "8.21.3",
|
|
110
|
+
"follow-redirects": "1.16.1"
|
|
107
111
|
},
|
|
108
112
|
"devDependencies": {
|
|
109
113
|
"@anthropic-ai/claude-agent-sdk": "latest",
|