@leviyuan/lodestar 0.21.20 → 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
 
@@ -43,7 +40,7 @@ Codex 订阅的模型目录和额度主动轮询均为每 2 小时;其他来
43
40
  | 补录模型 | 添加接口目录外的模型,可选择推理档位并使用 |
44
41
  | 删 | 删除补录记录;仍有会话选用时需先切换模型 |
45
42
 
46
- OpenRouter 和 PackyAPI 默认按指定家族精选最新数字版本,其他来源默认显示接口目录中的模型;新模型会随后台目录刷新出现。隐藏、显示和补录只修改本地列表,不重拉全部来源。所有来源都支持补录,记录保存在 `custom_models`;补录按本地规则检查模型 ID 和请求档位,不在交互中查询上游;实际调用不支持时由后端报告错误。目录未收录不会阻止选择,实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项,不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
43
+ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点协议读取 `/v1/models`,不绑定具体厂商;`anthropic` 站点提供 Claude Code,`openai` 站点同时提供 Codex 和 DeepSeek Harness。模型选择为“中转站 → 站点 → 模型 → effort”。
47
44
 
48
45
  同账号切换 Claude 或 DSH 模型从后续回复生效;Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
49
46
 
@@ -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
- ## PackyAPI
141
+ ## 通用中转站(覆盖 Packy)
145
142
 
146
- PackyAPI 提供三个来源入口:Claude Code 下的 `PackyAPI`、`PackyAPI · 令牌2`,以及 Codex 下的 `PackyAPI`。第二令牌独立保存;Codex 与主令牌共用一次存储的 Key 和平台地址,模型、effort、可见性分别维护。
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
- [token_source.packy]
156
- api_key = "填写主令牌"
157
- base_url = "https://cf.api.fan"
158
- model = "MiniMax-M3"
159
- effort = "default"
160
- # models = "MiniMax-M3,qwen3.8-max-0902" # 可选:固定列表,停止默认精选自动追新
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
- 目录由各令牌的 `GET /v1/models` 实时返回,保留原始 ID 和大小写。预设只筛选真实目录项;目录外模型须显式补录,不把预设伪装成上游模型。Claude Code 默认列声明 `anthropic` 的模型,Codex 默认列声明 `openai-response` 的模型。目录声明可能不完整:确认某个模型实际兼容后,可以通过补录或 `custom_models` 显式启用;条目仍标记为补录项,不改写上游协议声明。隐藏/显示、补录/删除与其他来源一致;目录失败显示 MISS,不更换令牌或模型。
154
+ 协议类型为 `anthropic` 或 `openai`:
178
155
 
179
- 有推理档位声明时沿用声明。目录只给模型 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。
180
158
 
181
- 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 提供可用档位。
182
160
 
183
- 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:
184
162
 
185
- 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 返回统一额度快照,例如:
186
168
 
187
- 官方推理入口为 `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
+ ```
188
172
 
189
- 系统访问令牌与模型 Key 分开保存,余额凭据不传入 Agent。`packy-codex` 自动共用主来源的余额;第二令牌只有显式设置 `billing_source = "packy"` 才共用。此引用只复用余额凭据,第二个模型 Key 保持独立,同一余额账号在 `hi` 中只列一行。第二令牌属于其他账号时,用 `packy-secondary-balance-setup [management_url] <user_id> <system_token>` 配置独立余额。模型与余额配置命令均先调用上游验证,失败不覆盖已有配置。
173
+ 没有余额脚本时显示“余额 —”;脚本超时、退出失败或返回无效 JSON 时显示 `MISS`。脚本通过直接可执行文件启动,Key 不放在命令行参数中。
190
174
 
191
- 同一余额凭据跨 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 配置。
192
176
 
193
- 未配置系统访问令牌时,只能通过 `/api/usage/token/` 查询令牌配额:有限令牌显示“额度”,无限令牌显示 `余额 —`。这不代表真实账户余额。
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.20",
3
+ "version": "0.21.21",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },