@leviyuan/lodestar 0.21.19 → 0.21.21
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/dsh-bridge.js +1 -1
- package/dist/lodestar.js +348 -261
- package/docs/AGENTS.md +1 -1
- package/docs/claude-agent-backend.md +2 -2
- package/docs/configuration.md +3 -1
- package/docs/models.md +33 -47
- package/docs/usage.md +1 -1
- package/package.json +1 -1
package/docs/AGENTS.md
CHANGED
|
@@ -11,7 +11,7 @@ README 保留项目哲学、项目介绍、最短快速开始、常用指令表
|
|
|
11
11
|
- `models.md`:账号、模型与 effort、OpenRouter 默认列表、DSH 与 GLM 接入。
|
|
12
12
|
- `claude-agent-backend.md`:后端实现、模型路由和会话行为。
|
|
13
13
|
|
|
14
|
-
- 保留 Codex、Claude Code 订阅、GLM、DeepSeek、OpenRouter
|
|
14
|
+
- 保留 Codex、Claude Code 订阅、GLM、DeepSeek、OpenRouter、通用中转站和 DeepSeek Harness 的支持说明。
|
|
15
15
|
- 只写已实现的行为。删除失效接口、历史方案、重复规则和无法复现的验证结论;不另建产品规范或计划。
|
|
16
16
|
- 不记录凭据、真实 session id、群成员或本机配置。临时测试报告、排障流水和某次测试通过数不作为长期文档;维护文档保留可复现的验证方法及适用边界。
|
|
17
17
|
- 文字变更检查引用的路径、方法和命令;伴随实现变化时按对应目录指引运行测试。
|
|
@@ -30,7 +30,7 @@ Token Source 管理账号凭据、模型目录、启动环境、默认模型、e
|
|
|
30
30
|
| GLM Coding Plan | `[token_source.glm]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
|
|
31
31
|
| DeepSeek | `[token_source.deepseek]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
|
|
32
32
|
| OpenRouter | `[token_source.openrouter]` 或本机 Claude settings;默认精选六个家族最新版(含 Gemini Flash、MiMo Pro),账号目录验证能力,MD 面板维护显隐 |
|
|
33
|
-
|
|
|
33
|
+
| 通用中转站 | `[relay.<site_id>]`;`anthropic` 站点用于 Claude Code,`openai` 站点提供 Codex 和 DeepSeek Harness 两个来源视图 |
|
|
34
34
|
| DeepSeek Harness | `[token_source.deepseek-harness]`;模型、effort 与上下文容量来自当前安装的 DSH 原生目录 |
|
|
35
35
|
| DSH GLM Coding Plan | `[token_source.dsh-glm]` 或复用 `glm`;账号接口返回模型,DSH 原生适配器提供能力和推理档位 |
|
|
36
36
|
|
|
@@ -52,7 +52,7 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
|
|
|
52
52
|
|
|
53
53
|
`model` 按 Claude Code、Codex、DeepSeek Harness 分组,组 ID 由 `ELEMENTS.modelAgentGroup` 生成。两个 Agent 下的 DeepSeek 来源都显示为 DeepSeek,协议 id 保持不变。选账号后进入模型列表;多个档位才展示 effort 卡,只有一个档位时直接应用,获取失败显示 `MISS`。同 provider/source 的切换调用 `setModelSettings`:Claude 和 DSH 从后续 turn 使用,Codex 保存选择并在重启进程后应用。跨 provider/source 或需要变更项目启动配置时,只能在空闲状态更换进程。
|
|
54
54
|
|
|
55
|
-
OpenRouter
|
|
55
|
+
OpenRouter 保持自己的精选模型规则。通用中转站只按站点协议读取 `/v1/models`,每个站点按其协议生成可用 Agent 来源;`openai` 站点的 Codex 与 DSH 视图共享 Key 和地址,但分别使用 Responses 与 OpenAI Completions。
|
|
56
56
|
|
|
57
57
|
`tokenSourceRuntimeModel(s)` 使用完整能力目录,隐藏不修改会话、`model`、`effort`、slots 或启动配置指纹。`model_custom_remove` 只删除补录项,拒绝删接口项;删除前要求会话不再选用该项,并清理默认模型和 slots 的悬空引用。补录/删除和显示/隐藏均串行写配置,旧面板失效。
|
|
58
58
|
|
package/docs/configuration.md
CHANGED
|
@@ -31,6 +31,8 @@ lodestar-setup
|
|
|
31
31
|
| `lodestar-claude <备注> [原生参数...]` | 用户终端入口,使用 Lodestar 管理的当前 Claude 安装和对应账号目录;例如 `lodestar-claude 工作号 auth login`,不自动收录账号或清理历史 |
|
|
32
32
|
| `lodestar-agent` | 调用已配置模型执行任务;不支持 Claude 订阅,遵守 Claude 用户协议,中转站等第三方 Claude 模型仍可调用 |
|
|
33
33
|
|
|
34
|
+
群内可用 `relay-setup <站点标识> <anthropic|openai> <base_url> <api_key>` 配置通用中转站。`anthropic` 提供 Claude Code 来源;`openai` 同时提供 Codex 和 DeepSeek Harness 来源。余额脚本可用 `relay-balance-setup <站点标识> <脚本路径>` 绑定,具体 JSON 接口见[模型与账号](models.md#通用中转站覆盖-packy)。
|
|
35
|
+
|
|
34
36
|
启动和停止命令会核对 PID 对应的实际入口,读取进程信息失败时明确报错。无法识别的运行时选项、macOS 无法区分边界的含空格入口、Windows 相对入口也会拒绝操作,请通过对应服务管理器处理。旧式单行 PID 文件缺少入口标识,`lodestar-stop` 会拒绝发送信号;请先核对该 PID 的完整命令行,再通过服务管理器或精确 PID 停止。停止命令以进程退出为准,删除 PID 文件不会被当作停止成功。
|
|
35
37
|
|
|
36
38
|
daemon 启动时不检查 Agent 版本,也不安装或更新 Agent。自动更新默认关闭;首次安装缺少运行文件或需要更新时,运行 `lodestar-update --agents-only`。手动更新和显式开启的自动更新都选择上游 `latest`,独立于 Lodestar 发版,不设置兼容版本白名单。
|
|
@@ -101,7 +103,7 @@ bin = "/abs/path/to/claude-wrapper" # 可选的 Claude 可执行文件
|
|
|
101
103
|
|
|
102
104
|
Claude 后端启用项目 MCP 时,缺少 `.mcp.json` 表示未配置;文件存在但无法读取、JSON 损坏或缺少有效的 `mcpServers` 对象会阻止会话启动,并显示具体错误。修正配置后再启动会话。
|
|
103
105
|
|
|
104
|
-
账号配置、OpenRouter
|
|
106
|
+
账号配置、OpenRouter 默认模型、通用中转站和 DSH 接入见[模型与账号](models.md)。手动修改配置后需重启 daemon;群内设置自行保存。
|
|
105
107
|
|
|
106
108
|
## HTTP 代理
|
|
107
109
|
|
package/docs/models.md
CHANGED
|
@@ -14,11 +14,8 @@ GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下
|
|
|
14
14
|
| Z.ai GLM(两个 Agent 共用) | `glm-setup https://api.z.ai/api/anthropic <api_key>` |
|
|
15
15
|
| DeepSeek(两个 Agent 共用) | `deepseek-setup [base_url] <api_key>` |
|
|
16
16
|
| OpenRouter | `openrouter-setup [base_url] <api_key>` |
|
|
17
|
-
|
|
|
18
|
-
|
|
|
19
|
-
| PackyAPI / Codex(复用主令牌) | `packy-codex-setup [base_url] <api_key>` |
|
|
20
|
-
| PackyAPI 真实余额(主令牌与 Codex 共用) | `packy-balance-setup [management_url] <user_id> <system_token>` |
|
|
21
|
-
| PackyAPI 第二令牌共用主账号余额 | `packy-secondary-balance-setup share packy` |
|
|
17
|
+
| 通用中转站 | `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` |
|
|
18
|
+
| 中转站余额脚本 | `relay-balance-setup <site_id> <script_path>` |
|
|
22
19
|
| DeepSeek 旧命令,同样更新共享账号 | `deepseek-harness-setup [base_url] <api_key>` |
|
|
23
20
|
| GLM 旧命令,同样更新共享账号 | `dsh-glm-setup [base_url] <api_key>` |
|
|
24
21
|
|
|
@@ -28,11 +25,13 @@ GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下
|
|
|
28
25
|
|
|
29
26
|
## 选择与管理模型
|
|
30
27
|
|
|
31
|
-
发送 `model`(`md`),在 Claude Code、Codex、DeepSeek Harness
|
|
28
|
+
发送 `model`(`md`),在 Claude Code、Codex、DeepSeek Harness 分组下选择账号,再选择模型。首页直接使用缓存;手动点开账号模型列表时立即发起目录查询,卡片显示刷新状态,完成后呈现目录。有多个推理档位(effort)时继续选择档位,只有一个档位时直接应用。
|
|
32
29
|
|
|
33
|
-
|
|
30
|
+
Codex 订阅的模型目录和额度主动轮询均为每 2 小时;其他来源仍为模型目录每 5 分钟、额度每 60 秒。daemon 启动时完成首次预热。`md` 首页、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存。手动进入账号模型列表会额外查询,但不会占住其他交互;翻页和显隐后的列表重绘复用快照。Codex 邮箱复用后台原生账号查询的结果。
|
|
34
31
|
|
|
35
|
-
|
|
32
|
+
这些周期和主动查询流量预算仅约束 Lodestar 的定时轮询。常驻 Codex 自身刷新、用户手动拉取模型列表属于允许额外消耗的被动刷新,不受主动周期限制。同账号有运行中的 Codex 进程时,额度复用已有连接,每分钟兜底刷新,并在额度通知和回合结束时及时回读。无运行进程、也没有用户按需操作时,其他地方的消费变化可能到下次主动查询才显示。
|
|
33
|
+
|
|
34
|
+
同一来源和账号的并发刷新会合并,刷新完成后一次更新缓存。网络或限流失败保留成功快照,错误写入日志,目录刷新错误也会显示在模型面板;Codex 订阅失败后至少等待对应正常刷新间隔;其他来源按 1、2、4、5 分钟退避,均遵守平台更长的限流冷却。没有缓存或认证已失效时立即显示加载中或 `MISS`。修改凭据会隔离并清除受影响账号的缓存,旧请求结果不能覆盖新配置;其他账号继续可用。
|
|
36
35
|
|
|
37
36
|
| 操作 | 作用 |
|
|
38
37
|
| --- | --- |
|
|
@@ -41,7 +40,7 @@ GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下
|
|
|
41
40
|
| 补录模型 | 添加接口目录外的模型,可选择推理档位并使用 |
|
|
42
41
|
| 删 | 删除补录记录;仍有会话选用时需先切换模型 |
|
|
43
42
|
|
|
44
|
-
OpenRouter
|
|
43
|
+
OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点协议读取 `/v1/models`,不绑定具体厂商;`anthropic` 站点提供 Claude Code,`openai` 站点同时提供 Codex 和 DeepSeek Harness。模型选择为“中转站 → 站点 → 模型 → effort”。
|
|
45
44
|
|
|
46
45
|
同账号切换 Claude 或 DSH 模型从后续回复生效;Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
|
|
47
46
|
|
|
@@ -51,7 +50,7 @@ OpenRouter 和 PackyAPI 默认按指定家族精选最新数字版本,其他
|
|
|
51
50
|
|
|
52
51
|
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅保留主窗口和模型专属周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
53
52
|
|
|
54
|
-
所有群、Agent、`hi
|
|
53
|
+
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存。Codex 订阅模型目录和额度均每 2 小时主动刷新,其他来源仍为 5 分钟和 60 秒;普通交互只读已提交缓存,手动打开模型列表允许立即额外查询,同账号并发刷新合并。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
55
54
|
|
|
56
55
|
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时,回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存,账号列表仍展示本次调度失败原因。
|
|
57
56
|
|
|
@@ -139,56 +138,43 @@ effort 按上游声明提供。小米、MiniMax、字节等没有 effort 选择
|
|
|
139
138
|
|
|
140
139
|
OpenRouter 余额来自 `/api/v1/credits`,按 `total_credits - total_usage` 计算;接口权限和错误以实际响应为准。账号目录可见不代表所有工具和请求都能成功,上游拒绝或路由不可用会明确报错。兼容接口、模型与档位的处理见[后端说明](claude-agent-backend.md#openrouter)。
|
|
141
140
|
|
|
142
|
-
##
|
|
143
|
-
|
|
144
|
-
PackyAPI 提供三个来源入口:Claude Code 下的 `PackyAPI`、`PackyAPI · 令牌2`,以及 Codex 下的 `PackyAPI`。第二令牌独立保存;Codex 与主令牌共用一次存储的 Key 和平台地址,模型、effort、可见性分别维护。
|
|
145
|
-
|
|
146
|
-
Packy 的 Claude 入口默认展示 MiniMax M、Claude Opus、Claude Fable、Qwen Max 四个家族在兼容目录中的最新数字版本;Codex 入口展示 Kimi K、Grok 两个家族的最新版。Opus 5.5 的 API ID 为 `claude-opus-5-5`,目录包含时自动进入精选。版本逐段按数字比较,同版本再比较发布日期;保留接口原始 ID,不自动纳入 preview、thinking 等变体,也不构造不存在的模型。
|
|
147
|
-
|
|
148
|
-
精选随现有每 5 分钟目录刷新更新;当前运行模型与 effort 不随目录切换。点「隐」隐藏自动精选项后,同家族后续版本保持隐藏;手动显示的旧版本仍可独立显隐。「显示模型」中加入的额外接口项保存到 `shown_models`,隐藏记录保存到 `hidden_models`(自动家族同时记录 `family:opus` 等标记与当前 ID),显隐操作不会冻结整个精选列表。已配置的 `model` 和 `custom_models` 保留。
|
|
141
|
+
## 通用中转站(覆盖 Packy)
|
|
149
142
|
|
|
150
|
-
|
|
143
|
+
中转站不绑定具体厂商,只配置站点标识、API Key、地址和协议类型。Packy 的旧 `[token_source.packy]`、`packy-secondary`、`packy-codex` 配置不再读取,需要按新格式重新配置。
|
|
151
144
|
|
|
152
145
|
```toml
|
|
153
|
-
[
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
#
|
|
159
|
-
# shown_models = "other-model" # 可选:在自动精选之外保留指定接口模型
|
|
160
|
-
management_token = "填写个人设置中的系统访问令牌"
|
|
161
|
-
management_user_id = "填写该账号用户 ID"
|
|
162
|
-
management_url = "https://www.packyapi.ai"
|
|
163
|
-
|
|
164
|
-
[token_source.packy-secondary]
|
|
165
|
-
api_key = "填写第二令牌"
|
|
166
|
-
model = "qwen3.8-max-0902"
|
|
167
|
-
effort = "default"
|
|
168
|
-
billing_source = "packy" # 仅当第二令牌也属于同一余额账号
|
|
169
|
-
|
|
170
|
-
[token_source.packy-codex]
|
|
171
|
-
model = "kimi-k3"
|
|
172
|
-
effort = "medium"
|
|
146
|
+
[relay.packy]
|
|
147
|
+
display = "Packy"
|
|
148
|
+
api_key = "填写 API Key"
|
|
149
|
+
base_url = "https://gateway.example"
|
|
150
|
+
protocol = "anthropic" # Claude Code;OpenAI 类型同时提供 Codex 和 DSH
|
|
151
|
+
# balance_script = "/abs/path/relay-balance"
|
|
173
152
|
```
|
|
174
153
|
|
|
175
|
-
|
|
154
|
+
协议类型为 `anthropic` 或 `openai`:
|
|
176
155
|
|
|
177
|
-
|
|
156
|
+
- `anthropic`:在 Claude Code → 中转站下显示,使用 Anthropic Messages。
|
|
157
|
+
- `openai`:同时在 Codex → 中转站和 DeepSeek Harness → 中转站下显示;Codex 使用 Responses,DSH 使用 OpenAI Completions。
|
|
178
158
|
|
|
179
|
-
|
|
159
|
+
发送 `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` 可校验模型目录并保存站点。模型面板路径为“中转站 → 站点 → 模型 → effort”。模型目录读取站点的 `/v1/models`,模型 ID 和显示名称按上游返回保留;未声明 effort 时按当前 Agent 提供可用档位。
|
|
180
160
|
|
|
181
|
-
|
|
161
|
+
余额查询是可选的。发送 `relay-balance-setup <site_id> <script_path>` 绑定脚本。脚本通过 stdin 接收 JSON:
|
|
182
162
|
|
|
183
|
-
|
|
163
|
+
```json
|
|
164
|
+
{"site_id":"packy","base_url":"https://gateway.example","protocol":"anthropic","api_key":"..."}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
stdout 返回统一额度快照,例如:
|
|
184
168
|
|
|
185
|
-
|
|
169
|
+
```json
|
|
170
|
+
{"state":"ok","kind":"balance","balance":{"remaining":12.34,"currency":"USD"},"windows":[]}
|
|
171
|
+
```
|
|
186
172
|
|
|
187
|
-
|
|
173
|
+
没有余额脚本时显示“余额 —”;脚本超时、退出失败或返回无效 JSON 时显示 `MISS`。脚本通过直接可执行文件启动,Key 不放在命令行参数中。
|
|
188
174
|
|
|
189
|
-
|
|
175
|
+
受管 Agent 不需要重启 Lodestar:使用继承的 `LODESTAR_AGENT_URL` 与 `LODESTAR_AGENT_CAPABILITY` 调用 `POST /agents/relays/test`(只读验证)、`POST /agents/relays/configure`(保存并刷新单个站点)或 `POST /agents/relays/reload`(重新读取并刷新站点)。项目绑定的 Agent 不允许修改全局 relay 配置。
|
|
190
176
|
|
|
191
|
-
|
|
177
|
+
OpenRouter 保持独立来源,不纳入通用中转站。
|
|
192
178
|
|
|
193
179
|
## DeepSeek Harness
|
|
194
180
|
|
package/docs/usage.md
CHANGED
|
@@ -55,7 +55,7 @@ Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方
|
|
|
55
55
|
|
|
56
56
|
其余账号按分数从高到低选择,同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算(原生套餐标识为 `plus`、`prolite`、`pro`),周分数为 **周剩余份额 ÷(距周重置小时数 − 5)**,提前 5 小时安排消耗;临期账号直接按优先级处理,不做零或负分母计算。Plus 仅在接口返回 5h 窗口时按完整窗口 0.15 份计算,短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**,普通评分取周分数和短窗分数的较小值。未返回 5h 窗口的 Plus 和 Pro 使用周分数。两种窗口约束同一份消耗,不相加。
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。群和 Agent 共用账号级额度缓存,并合并同账号并发请求。Codex 订阅额度和模型目录均每 2 小时主动刷新;同账号有运行中的原生进程时,额度优先复用其连接,每分钟兜底,并在额度通知、回合结束时及时回读。本地会话与委派共用同账号快照;无运行进程时,其他地方的消费变化可能等待下次主动查询;其他来源仍每 60 秒刷新。启动首次预热和显式操作后的必要回读可以立即执行。用户任务首次启动或真实耗尽换号时,若缓存无法选出账号,会按需确认一次额度;等待期间只有已知的真实重置时间到达时才额外确认,每分钟状态检查不冷启动查询。手动拉取模型列表及常驻 Codex 自身刷新属于额外的被动刷新,不受主动周期限制。Codex 主动额度查询失败后至少等待 2 小时;运行连接的被动额度刷新和其他来源沿用 1、2、4、5 分钟失败冷却,均遵守上游更长的等待时间。运行连接失败不另起控制进程。`hi`、`codex-accounts` 只读缓存,不额外发起查询,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
|
|
59
59
|
|
|
60
60
|
自动选号成功后,其他账号的缓存过期、模型档位不支持或查询失败不会单独发送警告卡或消息;具体原因保留在日志中,也可用 `codex-accounts` 主动查看。此规则同时适用于首次启动、恢复会话和自动换号。无法选出账号、任务必须等待额度恢复或当前账号实际执行失败时,仍会明确提示。
|
|
61
61
|
|