@leviyuan/lodestar 0.21.20 → 0.21.23
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 +336 -249
- package/docs/AGENTS.md +1 -1
- package/docs/claude-agent-backend.md +2 -2
- package/docs/configuration.md +3 -1
- package/docs/models.md +29 -45
- package/package.json +3 -3
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
|
|
|
@@ -43,7 +40,7 @@ Codex 订阅的模型目录和额度主动轮询均为每 2 小时;其他来
|
|
|
43
40
|
| 补录模型 | 添加接口目录外的模型,可选择推理档位并使用 |
|
|
44
41
|
| 删 | 删除补录记录;仍有会话选用时需先切换模型 |
|
|
45
42
|
|
|
46
|
-
OpenRouter
|
|
43
|
+
OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点协议读取 `/v1/models`,不绑定具体厂商;`anthropic` 站点提供 Claude Code,`openai` 站点同时提供 Codex 和 DeepSeek Harness。模型选择为“中转站 → 站点 → 模型 → effort”。
|
|
47
44
|
|
|
48
45
|
同账号切换 Claude 或 DSH 模型从后续回复生效;Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
|
|
49
46
|
|
|
@@ -76,13 +73,13 @@ lodestar-claude 工作号 auth login
|
|
|
76
73
|
|
|
77
74
|
在 Claude Code 会话发送 `hi 工作号`,Lodestar 只检查这个备注对应的目录。新增备注账号通过原生订阅身份验证后,卡片显示“已登录,正在完成首次同步”,保留认证进程等待 Skills 和插件云同步完成,再收录并启动;不会扫描其他目录或代办登录。首次同步最长等待 120 秒,期间不查询该账号的模型或额度、不参与自动选号,也不能启动任务或切换到该账号。失败保留账号和原因,按提示稍后再次发送 `hi 工作号` 重试;连续失败的重试间隔依次为 1、2、4、5 分钟,不由后台额度轮询自动重试。`hi default` 指定原生默认账号。指定账号只影响本次启动;同号正在运行时显示状态,忙碌时不能切换其他号,空闲时可用 `hi 另一备注` 切换并恢复原会话。
|
|
78
75
|
|
|
79
|
-
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。5 小时、总周以及接口实际返回的 OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS`
|
|
76
|
+
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。5 小时、总周以及接口实际返回的 OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已明确耗尽,自动启动回退到设备默认账号,不因自动选号失败阻断启动或 `rs` 恢复。
|
|
80
77
|
|
|
81
78
|
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10 份,分别受各自重置时间约束;有效周比例仍是 `min(总周剩余比例 × 50%, Fable 专属周剩余比例)`。缺少 Fable 专属窗口时按 `MISS` 排除,其他模型专属仅兼容接口实际返回的窗口。
|
|
82
79
|
|
|
83
80
|
选号同时考虑同一账号正在承载的会话。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为活跃;等待回答、排队和后台任务也计入,同群不重复计算。每个活跃会话预计未来一小时使用完整 5 小时额度的 `10%`,选号再为本次启动加入一份同样的需求。例如账号已有两个活跃会话,新会话加入后,一小时预计共用 `30%` 的完整 5 小时额度。
|
|
84
81
|
|
|
85
|
-
每个额度窗口独立预留预计用量;一小时内重置的窗口按重置前后分段计算,不把未来恢复的额度当作当前余额。预计能承载所有需求的账号优先,再比较预留后的剩余分配速率。若所有真实可用账号都预计不足,继续按“预计需求 ÷
|
|
82
|
+
每个额度窗口独立预留预计用量;一小时内重置的窗口按重置前后分段计算,不把未来恢复的额度当作当前余额。预计能承载所有需求的账号优先,再比较预留后的剩余分配速率。若所有真实可用账号都预计不足,继续按“预计需求 ÷ 可用额度”的压力从低到高分摊;这是调度估计,认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按上一条规则回退默认账号。各项相同时优先活跃会话更少、5 小时余量更多的账号,最后保持默认账号及收录顺序。预留不修改真实额度,也没有临期绝对优先。自动选择只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
86
83
|
|
|
87
84
|
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
88
85
|
|
|
@@ -141,56 +138,43 @@ effort 按上游声明提供。小米、MiniMax、字节等没有 effort 选择
|
|
|
141
138
|
|
|
142
139
|
OpenRouter 余额来自 `/api/v1/credits`,按 `total_credits - total_usage` 计算;接口权限和错误以实际响应为准。账号目录可见不代表所有工具和请求都能成功,上游拒绝或路由不可用会明确报错。兼容接口、模型与档位的处理见[后端说明](claude-agent-backend.md#openrouter)。
|
|
143
140
|
|
|
144
|
-
##
|
|
141
|
+
## 通用中转站(覆盖 Packy)
|
|
145
142
|
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
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 等变体,也不构造不存在的模型。
|
|
149
|
-
|
|
150
|
-
精选随现有每 5 分钟目录刷新更新;当前运行模型与 effort 不随目录切换。点「隐」隐藏自动精选项后,同家族后续版本保持隐藏;手动显示的旧版本仍可独立显隐。「显示模型」中加入的额外接口项保存到 `shown_models`,隐藏记录保存到 `hidden_models`(自动家族同时记录 `family:opus` 等标记与当前 ID),显隐操作不会冻结整个精选列表。已配置的 `model` 和 `custom_models` 保留。
|
|
151
|
-
|
|
152
|
-
显式 `models` 仍是固定列表,优先于自动精选;`models = ""` 保持空列表。以前通过面板显隐生成的 `models` 也按固定列表保留,移除该配置项后才恢复自动精选。其余兼容模型继续留在「显示模型」目录,可手动显示或补录。
|
|
143
|
+
中转站不绑定具体厂商,只配置站点标识、API Key、地址和协议类型。Packy 的旧 `[token_source.packy]`、`packy-secondary`、`packy-codex` 配置不再读取,需要按新格式重新配置。
|
|
153
144
|
|
|
154
145
|
```toml
|
|
155
|
-
[
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
#
|
|
161
|
-
# shown_models = "other-model" # 可选:在自动精选之外保留指定接口模型
|
|
162
|
-
management_token = "填写个人设置中的系统访问令牌"
|
|
163
|
-
management_user_id = "填写该账号用户 ID"
|
|
164
|
-
management_url = "https://www.packyapi.ai"
|
|
165
|
-
|
|
166
|
-
[token_source.packy-secondary]
|
|
167
|
-
api_key = "填写第二令牌"
|
|
168
|
-
model = "qwen3.8-max-0902"
|
|
169
|
-
effort = "default"
|
|
170
|
-
billing_source = "packy" # 仅当第二令牌也属于同一余额账号
|
|
171
|
-
|
|
172
|
-
[token_source.packy-codex]
|
|
173
|
-
model = "kimi-k3"
|
|
174
|
-
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"
|
|
175
152
|
```
|
|
176
153
|
|
|
177
|
-
|
|
154
|
+
协议类型为 `anthropic` 或 `openai`:
|
|
178
155
|
|
|
179
|
-
|
|
156
|
+
- `anthropic`:在 Claude Code → 中转站下显示,使用 Anthropic Messages。
|
|
157
|
+
- `openai`:同时在 Codex → 中转站和 DeepSeek Harness → 中转站下显示;Codex 使用 Responses,DSH 使用 OpenAI Completions。
|
|
180
158
|
|
|
181
|
-
|
|
159
|
+
发送 `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` 可校验模型目录并保存站点。模型面板路径为“中转站 → 站点 → 模型 → effort”。模型目录读取站点的 `/v1/models`,模型 ID 和显示名称按上游返回保留;未声明 effort 时按当前 Agent 提供可用档位。
|
|
182
160
|
|
|
183
|
-
|
|
161
|
+
余额查询是可选的。发送 `relay-balance-setup <site_id> <script_path>` 绑定脚本。脚本通过 stdin 接收 JSON:
|
|
184
162
|
|
|
185
|
-
|
|
163
|
+
```json
|
|
164
|
+
{"site_id":"packy","base_url":"https://gateway.example","protocol":"anthropic","api_key":"..."}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
stdout 返回统一额度快照,例如:
|
|
186
168
|
|
|
187
|
-
|
|
169
|
+
```json
|
|
170
|
+
{"state":"ok","kind":"balance","balance":{"remaining":12.34,"currency":"USD"},"windows":[]}
|
|
171
|
+
```
|
|
188
172
|
|
|
189
|
-
|
|
173
|
+
没有余额脚本时显示“余额 —”;脚本超时、退出失败或返回无效 JSON 时显示 `MISS`。脚本通过直接可执行文件启动,Key 不放在命令行参数中。
|
|
190
174
|
|
|
191
|
-
|
|
175
|
+
受管 Agent 不需要重启 Lodestar:使用继承的 `LODESTAR_AGENT_URL` 与 `LODESTAR_AGENT_CAPABILITY` 调用 `POST /agents/relays/test`(只读验证)、`POST /agents/relays/configure`(保存并刷新单个站点)或 `POST /agents/relays/reload`(重新读取并刷新站点)。项目绑定的 Agent 不允许修改全局 relay 配置。
|
|
192
176
|
|
|
193
|
-
|
|
177
|
+
OpenRouter 保持独立来源,不纳入通用中转站。
|
|
194
178
|
|
|
195
179
|
## DeepSeek Harness
|
|
196
180
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@leviyuan/lodestar",
|
|
3
|
-
"version": "0.21.
|
|
3
|
+
"version": "0.21.23",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -70,7 +70,7 @@
|
|
|
70
70
|
"node": ">=18.15"
|
|
71
71
|
},
|
|
72
72
|
"dependencies": {
|
|
73
|
-
"@hono/node-server": "1.
|
|
73
|
+
"@hono/node-server": "2.1.5",
|
|
74
74
|
"@larksuiteoapi/node-sdk": "^1.73.0",
|
|
75
75
|
"@modelcontextprotocol/sdk": "1.32.1",
|
|
76
76
|
"@resvg/resvg-js": "^2.6.2",
|
|
@@ -97,7 +97,7 @@
|
|
|
97
97
|
"mathjax-full"
|
|
98
98
|
],
|
|
99
99
|
"overrides": {
|
|
100
|
-
"@hono/node-server": "1.
|
|
100
|
+
"@hono/node-server": "2.1.5",
|
|
101
101
|
"@modelcontextprotocol/sdk": "1.32.1",
|
|
102
102
|
"@xmldom/xmldom": "0.9.12",
|
|
103
103
|
"axios": "1.20.0",
|