@leviyuan/lodestar 0.21.9 → 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 +8 -8
- package/dist/lodestar-claude.js +60 -0
- package/dist/lodestar-setup.js +7 -7
- package/dist/lodestar-stop.js +3 -3
- package/dist/lodestar-update.js +13 -13
- package/dist/lodestar-version.js +7 -7
- package/dist/lodestar.js +230 -230
- package/docs/claude-agent-backend.md +6 -0
- package/docs/configuration.md +1 -0
- package/docs/models.md +14 -2
- package/package.json +8 -4
|
@@ -38,6 +38,12 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
|
|
|
38
38
|
|
|
39
39
|
`claude-accounts.ts` 管理默认及按 `hi 备注` 首次收录的账号元数据,原生登录由用户手动完成;来源内部使用独立账号视图、模型目录和额度缓存。MD 汇总可用账号目录,启动时再校验实际选中的账号;默认账号未登录不会遮住已收录的可用账号。`claude-account-selection.ts` 只在启动时选号,不负责耗尽轮换。主会话首次提交输入前完成原生身份验证,账号实际变化会使旧模型/额度缓存失效。
|
|
40
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
|
+
|
|
41
47
|
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
42
48
|
|
|
43
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 或需要变更项目启动配置时,只能在空闲状态更换进程。
|
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
|
@@ -65,10 +65,22 @@ Codex 启动和换号优先使用最近一次成功的额度缓存;能选出
|
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
67
|
# desc: 手动登录备注为工作号的 Claude 订阅
|
|
68
|
-
|
|
68
|
+
lodestar-claude 工作号 auth login
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
|
|
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 小时余量更多的账号,最后保持默认账号及收录顺序。预留不修改真实额度,也没有临期绝对优先。自动选择只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
72
84
|
|
|
73
85
|
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和各账号凭据、设置保留。重复收录只检查共享链接,不再次清理。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
74
86
|
|
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",
|