@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/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、PackyAPI 和 DeepSeek Harness 的支持说明。
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
- | PackyAPI | `[token_source.packy]`、`[token_source.packy-secondary]`;按令牌目录筛选模型,Claude 入口默认精选 MiniMax M、Opus、Fable、Qwen Max 家族最新版;Codex 入口精选 Kimi K、Grok 家族最新版,主令牌与 `packy-codex` 共用凭据 |
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 和 PackyAPI 默认按指定家族从兼容目录筛选最新数字版本;显隐保存增量,显式 `models` 仍保留为固定列表,不自动切换运行模型。其余来源由 `withModelVisibility` 在真实接口目录上应用 `hidden_models`。接口项通过显示/隐藏调整可见性,新增上游模型自动进入列表。所有来源都支持用 `custom_models` 补录列表外模型,`origin` 区分接口项和补录项;GLM / DeepSeek 会先做端点验证,补录模型可直接选择请求档位使用,DSH 原生解析目录外模型,其余来源使用 Agent 请求档位;不能用目录白名单挡住用户补录。接口收录同名模型后按接口项管理,不重复展示。
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
 
@@ -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 默认模型和 DSH 接入见[模型与账号](models.md)。手动修改配置后需重启 daemon;群内设置自行保存。
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
- | PackyAPI 主令牌 | `packy-setup [base_url] <api_key>` |
18
- | PackyAPI 第二令牌 | `packy-secondary-setup [base_url] <api_key>` |
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 分组下选择账号,再选择模型。面板直接使用缓存,不等待平台接口或 Codex 账号查询。有多个推理档位(effort)时继续选择档位,只有一个档位时直接应用。
28
+ 发送 `model`(`md`),在 Claude Code、Codex、DeepSeek Harness 分组下选择账号,再选择模型。首页直接使用缓存;手动点开账号模型列表时立即发起目录查询,卡片显示刷新状态,完成后呈现目录。有多个推理档位(effort)时继续选择档位,只有一个档位时直接应用。
32
29
 
33
- 模型目录每 5 分钟、额度每 60 秒独立在后台刷新,只有 daemon 启动会等待首次加载。`md`、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存;打开面板不会启动额外查询,某个来源变慢也不会占住交互。Codex 邮箱复用后台原生账号查询的结果。
30
+ Codex 订阅的模型目录和额度主动轮询均为每 2 小时;其他来源仍为模型目录每 5 分钟、额度每 60 秒。daemon 启动时完成首次预热。`md` 首页、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存。手动进入账号模型列表会额外查询,但不会占住其他交互;翻页和显隐后的列表重绘复用快照。Codex 邮箱复用后台原生账号查询的结果。
34
31
 
35
- 同一来源和账号的并发刷新会合并,刷新完成后一次更新缓存。网络或限流失败保留成功快照,错误写入日志,目录刷新错误也会显示在模型面板;失败按 1、2、4、5 分钟退避并遵守平台更长的限流冷却。没有缓存或认证已失效时立即显示加载中或 `MISS`。修改凭据会隔离并清除受影响账号的缓存,旧请求结果不能覆盖新配置;其他账号继续可用。
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 和 PackyAPI 默认按指定家族精选最新数字版本,其他来源默认显示接口目录中的模型;新模型会随后台目录刷新出现。隐藏、显示和补录只修改本地列表,不重拉全部来源。所有来源都支持补录,记录保存在 `custom_models`;补录按本地规则检查模型 ID 和请求档位,不在交互中查询上游;实际调用不支持时由后端报告错误。目录未收录不会阻止选择,实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项,不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
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`、账号列表、页脚和自动选号共用账号级缓存。模型目录每 5 分钟、额度每 60 秒在后台刷新;普通交互只读已提交缓存,不等待上游查询,同账号并发请求合并。启动首次预热及显式首次收录账号可以等待查询完成。失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟;上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
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
- ## PackyAPI
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
- 显式 `models` 仍是固定列表,优先于自动精选;`models = ""` 保持空列表。以前通过面板显隐生成的 `models` 也按固定列表保留,移除该配置项后才恢复自动精选。其余兼容模型继续留在「显示模型」目录,可手动显示或补录。
143
+ 中转站不绑定具体厂商,只配置站点标识、API Key、地址和协议类型。Packy 的旧 `[token_source.packy]`、`packy-secondary`、`packy-codex` 配置不再读取,需要按新格式重新配置。
151
144
 
152
145
  ```toml
153
- [token_source.packy]
154
- api_key = "填写主令牌"
155
- base_url = "https://cf.api.fan"
156
- model = "MiniMax-M3"
157
- effort = "default"
158
- # models = "MiniMax-M3,qwen3.8-max-0902" # 可选:固定列表,停止默认精选自动追新
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
- 目录由各令牌的 `GET /v1/models` 实时返回,保留原始 ID 和大小写。预设只筛选真实目录项;目录外模型须显式补录,不把预设伪装成上游模型。Claude Code 默认列声明 `anthropic` 的模型,Codex 默认列声明 `openai-response` 的模型。目录声明可能不完整:确认某个模型实际兼容后,可以通过补录或 `custom_models` 显式启用;条目仍标记为补录项,不改写上游协议声明。隐藏/显示、补录/删除与其他来源一致;目录失败显示 MISS,不更换令牌或模型。
154
+ 协议类型为 `anthropic` 或 `openai`:
176
155
 
177
- 有推理档位声明时沿用声明。目录只给模型 ID 和协议、未声明推理档位时,面板提供 Agent 的请求选项:Claude Code 默认 `default`(不发送 effort),Codex 默认请求 `medium`;这些请求选项不保证所有上游模型接受,拒绝会如实报错。`effort` 可覆盖本来源默认请求档位。
156
+ - `anthropic`:在 Claude Code → 中转站下显示,使用 Anthropic Messages。
157
+ - `openai`:同时在 Codex → 中转站和 DeepSeek Harness → 中转站下显示;Codex 使用 Responses,DSH 使用 OpenAI Completions。
178
158
 
179
- Claude Code 使用官方 SDK 和 `/v1/messages`,辅助角色也使用当前令牌与所选模型,保留项目 MCP、Skill 和原生 resume。Codex 使用独立 Responses provider 和进程环境变量注入 Key;不要求 ChatGPT 登录,不参与 Codex 订阅自动选号、重置卡或订阅额度查询,也不加载需要订阅认证的 ChatGPT 连接器。模型目录由 Lodestar 直接读取;上游 Codex 自身的模型元数据刷新若遇到 New API 的 `data` / `models` 格式差异,仍保留原始诊断,不伪造原生元数据。
159
+ 发送 `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` 可校验模型目录并保存站点。模型面板路径为“中转站 → 站点 → 模型 → effort”。模型目录读取站点的 `/v1/models`,模型 ID 和显示名称按上游返回保留;未声明 effort 时按当前 Agent 提供可用档位。
180
160
 
181
- Gemini 3.8 Flash 默认使用 OpenRouter 的 `google/gemini-3.8-flash`,Packy 默认隐藏。Packy 的 Messages 转换可能拒绝 Claude 工具 schema 中的 `propertyNames`、`const`;显式使用该路由时会显示真实 HTTP 400 错误。
161
+ 余额查询是可选的。发送 `relay-balance-setup <site_id> <script_path>` 绑定脚本。脚本通过 stdin 接收 JSON:
182
162
 
183
- Gemini 3.8 Flash 使用 Claude Code 原生重试:请求超时 `API_TIMEOUT_MS=60000`、字节流空闲超时 `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS=45000`、请求重试预算 `CLAUDE_CODE_MAX_RETRIES=2`,关闭无限重试看门狗。该策略只在选择 Gemini 3.8 Flash 为 Claude 主模型时注入;切换请求策略会替换空闲进程并保留原生会话。宿主不重放整轮用户输入或已完成的工具,不更换 Key、模型或来源;SDK 判定的最终失败仍会显示。
163
+ ```json
164
+ {"site_id":"packy","base_url":"https://gateway.example","protocol":"anthropic","api_key":"..."}
165
+ ```
166
+
167
+ stdout 返回统一额度快照,例如:
184
168
 
185
- 官方推理入口为 `https://cf.api.fan`,管理入口为 `https://www.packyapi.ai`。真实余额使用系统访问令牌及 `New-Api-User` 用户 ID 请求 `/api/user/self`,读取账户剩余 `quota`,按 `/api/status` 声明的 `quota_per_unit` 换算 USD。`hi` 与回复页脚显示同一余额;不会使用 API Key 的令牌配额或无限额度占位值代替。
169
+ ```json
170
+ {"state":"ok","kind":"balance","balance":{"remaining":12.34,"currency":"USD"},"windows":[]}
171
+ ```
186
172
 
187
- 系统访问令牌与模型 Key 分开保存,余额凭据不传入 Agent。`packy-codex` 自动共用主来源的余额;第二令牌只有显式设置 `billing_source = "packy"` 才共用。此引用只复用余额凭据,第二个模型 Key 保持独立,同一余额账号在 `hi` 中只列一行。第二令牌属于其他账号时,用 `packy-secondary-balance-setup [management_url] <user_id> <system_token>` 配置独立余额。模型与余额配置命令均先调用上游验证,失败不覆盖已有配置。
173
+ 没有余额脚本时显示“余额 —”;脚本超时、退出失败或返回无效 JSON 时显示 `MISS`。脚本通过直接可执行文件启动,Key 不放在命令行参数中。
188
174
 
189
- 同一余额凭据跨 Agent、模型 Key 共享 60 秒惰性缓存与并发查询;刷新失败显示 MISS,遵守失败冷却和 Retry-After,不展示旧成功余额或改查令牌配额。余额配置更新不改变 Agent 的启动身份。自建地址未指定 `management_url` 时按自己的 API 根地址查询管理接口,系统令牌请求拒绝重定向。引用其他余额来源时使用被引用来源的管理地址。
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
- 未配置系统访问令牌时,只能通过 `/api/usage/token/` 查询令牌配额:有限令牌显示“额度”,无限令牌显示 `余额 —`。这不代表真实账户余额。
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
- 启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。所有来源、群和 Agent 的额度查询共用一分钟惰性缓存,并合并同账号并发请求;过期后按需查询,失败冷却依次为 1、2、4、5 分钟,并遵守上游更长的等待时间。这不是每分钟自动刷新全部账号。`hi`、`codex-accounts` 也遵守缓存与冷却,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
58
+ 启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。群和 Agent 共用账号级额度缓存,并合并同账号并发请求。Codex 订阅额度和模型目录均每 2 小时主动刷新;同账号有运行中的原生进程时,额度优先复用其连接,每分钟兜底,并在额度通知、回合结束时及时回读。本地会话与委派共用同账号快照;无运行进程时,其他地方的消费变化可能等待下次主动查询;其他来源仍每 60 秒刷新。启动首次预热和显式操作后的必要回读可以立即执行。用户任务首次启动或真实耗尽换号时,若缓存无法选出账号,会按需确认一次额度;等待期间只有已知的真实重置时间到达时才额外确认,每分钟状态检查不冷启动查询。手动拉取模型列表及常驻 Codex 自身刷新属于额外的被动刷新,不受主动周期限制。Codex 主动额度查询失败后至少等待 2 小时;运行连接的被动额度刷新和其他来源沿用 1、2、4、5 分钟失败冷却,均遵守上游更长的等待时间。运行连接失败不另起控制进程。`hi`、`codex-accounts` 只读缓存,不额外发起查询,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
59
59
 
60
60
  自动选号成功后,其他账号的缓存过期、模型档位不支持或查询失败不会单独发送警告卡或消息;具体原因保留在日志中,也可用 `codex-accounts` 主动查看。此规则同时适用于首次启动、恢复会话和自动换号。无法选出账号、任务必须等待额度恢复或当前账号实际执行失败时,仍会明确提示。
61
61
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.21.19",
3
+ "version": "0.21.21",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },