@leviyuan/lodestar 0.20.2 → 0.20.4

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.
@@ -29,15 +29,15 @@ Token Source 管理账号凭据、模型目录、启动环境、默认模型、e
29
29
  | Claude Code 订阅 | `claude-sub` 复用本机原生订阅登录态;通过 SDK `accountInfo()` 确认账号,`supportedModels()` 读取模型和 effort,与第三方来源独立共存 |
30
30
  | GLM Coding Plan | `[token_source.glm]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
31
31
  | DeepSeek | `[token_source.deepseek]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
32
- | OpenRouter | `[token_source.openrouter]` 或本机 Claude settings;默认保留六款模型(含 Gemini、MiMo),账号目录验证能力,MD 面板维护增删 |
33
- | PackyAPI | `[token_source.packy]`、`[token_source.packy-secondary]`;按令牌目录筛选模型,Claude 入口默认展示 MiniMax、Opus、Fable 5.1(claude-fable-5-1)、Qwen;Codex 入口展示 Kimi、Grok 4.6,主令牌与 `packy-codex` 共用凭据 |
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` 共用凭据 |
34
34
  | DeepSeek Harness | `[token_source.deepseek-harness]`;模型、effort 与上下文容量来自当前安装的 DSH 原生目录 |
35
35
  | DSH GLM Coding Plan | `[token_source.dsh-glm]` 或复用 `glm`;账号接口返回模型,DSH 原生适配器提供能力和推理档位 |
36
36
  | Claude native | 沿用本机 Claude 配置,目录来自 SDK `supportedModels()`;有已启用的第三方 Claude 侧来源时让位 |
37
37
 
38
38
  `model` 按 Claude Code、Codex、DeepSeek Harness 分组,组 ID 由 `ELEMENTS.modelAgentGroup` 生成。两个 Agent 下的 DeepSeek 来源都显示为 DeepSeek,协议 id 保持不变。选账号后进入模型列表;多个档位才展示 effort 卡,只有一个档位时直接应用,获取失败显示 `MISS`。同 provider/source 的切换调用 `setModelSettings`:Claude 和 DSH 从后续 turn 使用,Codex 保存选择并在重启进程后应用。跨 provider/source 或需要变更项目启动配置时,只能在空闲状态更换进程。
39
39
 
40
- OpenRouter 和 PackyAPI 使用各自不重叠的显式精选列表,其余来源由 `withModelVisibility` 在真实接口目录上应用 `hidden_models`。接口项通过显示/隐藏调整可见性,新增上游模型自动进入列表。所有来源都支持用 `custom_models` 补录列表外模型,`origin` 区分接口项和补录项;GLM / DeepSeek 会先做端点验证,补录模型可直接选择请求档位使用,DSH 原生解析目录外模型,其余来源使用 Agent 请求档位;不能用目录白名单挡住用户补录。接口收录同名模型后按接口项管理,不重复展示。
40
+ OpenRouter 和 PackyAPI 默认按指定家族从兼容目录筛选最新数字版本;显隐保存增量,显式 `models` 仍保留为固定列表,不自动切换运行模型。其余来源由 `withModelVisibility` 在真实接口目录上应用 `hidden_models`。接口项通过显示/隐藏调整可见性,新增上游模型自动进入列表。所有来源都支持用 `custom_models` 补录列表外模型,`origin` 区分接口项和补录项;GLM / DeepSeek 会先做端点验证,补录模型可直接选择请求档位使用,DSH 原生解析目录外模型,其余来源使用 Agent 请求档位;不能用目录白名单挡住用户补录。接口收录同名模型后按接口项管理,不重复展示。
41
41
 
42
42
  `tokenSourceRuntimeModel(s)` 使用完整能力目录,隐藏不修改会话、`model`、`effort`、slots 或启动配置指纹。`model_custom_remove` 只删除补录项,拒绝删接口项;删除前要求会话不再选用该项,并清理默认模型和 slots 的悬空引用。补录/删除和显示/隐藏均串行写配置,旧面板失效。
43
43
 
@@ -65,10 +65,10 @@ Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TO
65
65
 
66
66
  - 来源 id 为 `openrouter`,通过 factory 注册 `openrouter-setup`。默认根地址 `https://openrouter.ai/api`,粘贴的 `/api/v1` 会规范成 SDK 根地址。API key 注入 `ANTHROPIC_AUTH_TOKEN`,`ANTHROPIC_API_KEY` 显式置空,模型 slug 完整透传,不自动追加 `[1m]`。
67
67
  - 主会话和委派共用 `agent-launch.ts`,将所选模型传给 `spawnEnv`。辅助角色在进程启动时绑定所选模型,可用 `slots` 配置 opus/sonnet/haiku;主模型后续切换不改动进程启动时的辅助角色。
68
- - 默认列表由 `src/openrouter-defaults.ts` 定义,共六项,详见[账号与模型](models.md#openrouter)。账号目录来自 `GET /api/v1/models/user`,遵循账号供应商、隐私和 guardrail 设置;过滤 OpenAI、GLM、DeepSeek 等被排除厂商、自动路由、非文本输出、无 tools 和 `:batch` 模型。厂商排除也在启动路由和 slot 校验中执行。
68
+ - 默认家族及版本筛选由 `src/openrouter-defaults.ts` 定义,共六个家族,详见[账号与模型](models.md#openrouter)。每 5 分钟目录刷新时按数字版本、发布日期选择最新模型,保留接口 ID;Hy 允许 preview 且同版本优先正式版,其他家族不自动纳入 preview。free、thinking、Flash Lite、ultraspeed 等变体须显式显示。账号目录来自 `GET /api/v1/models/user`,遵循账号供应商、隐私和 guardrail 设置;过滤 OpenAI、GLM、DeepSeek 等被排除厂商、自动路由、非文本输出、无 tools 和 `:batch` 模型。厂商排除也在启动路由和 slot 校验中执行。
69
69
  - `modelSelection` 保存可见模型 id 和完整允许候选;`models` 只暴露面板可见项。`model_list_open` / `model_add` / `model_remove` 对应接口项显示/隐藏,服务端校验当前页、模式与配置版本。`model_custom_remove` 删除补录记录,不能用于接口项;厂商排除也应用于手动补录。
70
- - `models` 未配置时使用默认六项,空字符串表示用户主动清空,不能当作未配置。默认模型、effort、slots、Key 及相邻配置节保留;启动和 slots 按完整允许目录验证。上游不再返回的已选项显示 `unavailableReason`,不能启动,但可以删除。
71
- - effort 来自 `reasoning.supported_efforts`,仅暴露 Claude SDK 支持的档位;显式 `null` 表示全部网关档位。没有 effort 选择器的模型使用 `default`,含义是请求不携带 `output_config.effort`,不代表关闭推理,选择模型后直接应用并跳过 effort 卡。其他缺失的默认档位保留 `null`,要求用户明确选择。已选榜单代表模型使用榜单明确的档位或账号目录的默认档位。
70
+ - `models` 未配置时使用六家族自动精选;显隐以 `shown_models` / `hidden_models` 保存增量,自动精选项同时记录 `family:` 家族键与当前 ID,保持后续版本和已隐藏旧默认的隐藏状态;手动显示的旧版本仍按 ID 管理。已有 `models` 是固定列表,空字符串表示用户主动清空,不能当作未配置。默认模型、effort、slots、Key 及相邻配置节保留;启动和 slots 按完整允许目录验证。上游不再返回的已选项显示 `unavailableReason`,不能启动,但可以删除。
71
+ - effort 来自 `reasoning.supported_efforts`,仅暴露 Claude SDK 支持的档位;显式 `null` 表示全部网关档位。没有 effort 选择器的模型使用 `default`,含义是请求不携带 `output_config.effort`,不代表关闭推理,选择模型后直接应用并跳过 effort 卡。其他缺失的默认档位保留 `null`,要求用户明确选择。自动精选家族沿用明确的默认档位偏好;新版本仍需上游声明支持该档位,否则保留 `null`,不自动降档。
72
72
  - `default` 用显式启动档位配合子进程环境中的 `CLAUDE_CODE_EFFORT_LEVEL=unset`,避免 CLI 为请求补上 effort。`settings.env` 不能替代真实环境,单纯省略 SDK 选项也不成立。显式 `max` 通过 `effortLevel: 'max'` 下发,不能映射成 `ultracode`。
73
73
  - `modelEnvironmentRevision` 参与进程配置比较。`default` 与显式档位之间切换需要新进程环境,Session 在空闲时保存并恢复原生 session;相同模式继续走 `setModelSettings`。slots 不能混合两种参数模式,避免辅助任务继承不适用的环境。模型切换不触发 daemon 重启。
74
74
  - 余额直接来自 `GET /api/v1/credits`:`total_credits - total_usage`,USD。权限以实际 HTTP 结果为准;失败显示 `余额 MISS`,不能改用 `/key` 限额、单 Key 累计用量或旧余额。
package/docs/models.md CHANGED
@@ -41,7 +41,7 @@ GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下
41
41
  | 补录模型 | 添加接口目录外的模型,可选择推理档位并使用 |
42
42
  | 删 | 删除补录记录;仍有会话选用时需先切换模型 |
43
43
 
44
- 除 OpenRouter 和 PackyAPI 使用内置精选列表外,各来源默认显示接口目录中的模型,新模型会随后台目录刷新出现。隐藏、显示和补录只修改本地列表,不重拉全部来源。所有来源都支持补录,记录保存在 `custom_models`;补录按本地规则检查模型 ID 和请求档位,不在交互中查询上游;实际调用不支持时由后端报告错误。目录未收录不会阻止选择,实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项,不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
44
+ OpenRouter 和 PackyAPI 默认按指定家族精选最新数字版本,其他来源默认显示接口目录中的模型;新模型会随后台目录刷新出现。隐藏、显示和补录只修改本地列表,不重拉全部来源。所有来源都支持补录,记录保存在 `custom_models`;补录按本地规则检查模型 ID 和请求档位,不在交互中查询上游;实际调用不支持时由后端报告错误。目录未收录不会阻止选择,实际不支持的请求由后端报告错误。接口后来收录同名模型时自动转为接口项,不重复显示。删除补录记录也会清理默认模型和辅助模型中的相关引用。
45
45
 
46
46
  同账号切换 Claude 或 DSH 模型从后续回复生效;Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
47
47
 
@@ -80,22 +80,27 @@ api_key = "填写自己的 OpenRouter API key"
80
80
  # base_url = "https://openrouter.ai/api" # SDK 自动追加 /v1/messages
81
81
  # model = "moonshotai/kimi-k3" # 可选:默认运行模型,须获账号目录确认
82
82
  # effort = "max" # 可选:仅覆盖默认运行模型的档位
83
- # models = "moonshotai/kimi-k3,google/gemini-3.8-flash" # 可选:自定义可选列表
83
+ # models = "moonshotai/kimi-k3,google/gemini-3.8-flash" # 可选:固定列表,停止自动追新
84
+ # shown_models = "moonshotai/kimi-k3" # 可选:在自动精选之外显示指定接口模型
84
85
  # slots = "haiku=moonshotai/kimi-k3" # 可选:辅助任务模型,须获账号目录确认且使用相同的 effort 参数模式
85
86
  ```
86
87
 
87
- 内置默认列表保留以下 **6 项**,定义见[默认模型配置](../src/openrouter-defaults.ts)。Gemini 和 MiMo 使用 OpenRouter;这是项目提供的初始列表,可在面板中自行调整,其他兼容模型仍可从账号目录显示或补录。
88
+ 默认从账号目录为以下 **6 个家族**各选最新数字版本,定义见[默认模型配置](../src/openrouter-defaults.ts)。精选随每 5 分钟目录刷新更新,保留接口原始 ID;其他兼容模型仍可从账号目录显示或补录。
88
89
 
89
- | 厂商 | 模型 ID | 默认档位 |
90
+ | 厂商 | 自动精选家族 | 默认档位 |
90
91
  | --- | --- | --- |
91
- | Tencent | `tencent/hy4-preview` | high |
92
- | Google | `google/gemini-3.8-flash` | high |
93
- | Meta | `meta/muse-spark-1.2` | xhigh |
94
- | Xiaomi | `xiaomi/mimo-v2.5-pro` | 模型默认 |
95
- | 字节跳动 | `bytedance-seed/seed-2-1-turbo` | 模型默认 |
96
- | 美团 | `meituan/longcat-2.0` | 模型默认 |
92
+ | Tencent | Hy | high |
93
+ | Google | Gemini Flash | high |
94
+ | Meta | Muse Spark | xhigh |
95
+ | Xiaomi | MiMo Pro | 模型默认 |
96
+ | 字节跳动 | Seed Turbo | 模型默认 |
97
+ | 美团 | LongCat | 模型默认 |
97
98
 
98
- 在 `md` → Claude Code → OpenRouter 中,点「显示模型」进入账号目录,再点「显」加入列表,点「隐」移出面板列表。可见性自动保存,不改当前运行模型;全部隐藏后也能继续显示或补录。未配置 `models` 时才使用上述六项;`models = ""` 表示没有已显示的接口模型,刷新或重启不会补回默认项。内置列表更新不会覆盖用户维护的列表。
99
+ 版本逐段按数字比较,同版本再比较发布日期。腾讯 Hy 沿用 preview 候选,同版本优先正式版;其他家族不自动纳入 preview。Flash Lite、Pro(Gemini)、Flash(MiMo)、ultraspeed、thinking、free 等独立变体不会混入对应精选家族,仍可手动显示。家族默认档位必须在上游声明中受支持,否则保留缺失状态,要求明确选择。
100
+
101
+ 在 `md` → Claude Code → OpenRouter 中,点「显示模型」进入账号目录,再点「显」加入列表,点「隐」移出面板列表。自动精选项隐藏后,同家族后续版本保持隐藏;手动显示的旧版本按 ID 独立显隐。显隐增量保存为 `shown_models` 和 `hidden_models`(自动精选项同时记录 `family:` 家族键与当前 ID),不会冻结整个精选列表。当前运行模型、已配置的 `model` 和 `custom_models` 保持不变;全部隐藏后也能继续显示或补录。
102
+
103
+ 未配置 `models` 时使用自动精选;已有 `models` 仍是固定列表,`models = ""` 表示没有已显示的接口模型,刷新或重启不会补回默认项。已有固定列表要启用自动追新,需删除该来源的 `models` 字段;额外显示或隐藏的选择使用上述增量字段保存。
99
104
 
100
105
  候选目录来自 `/api/v1/models/user`,按账号供应商和隐私设置筛选,仅纳入支持文本和工具调用的交互模型;OpenAI、GLM、DeepSeek 及无法保证厂商范围的自动路由不会出现在添加候选中。目录刷新失败显示 `MISS`。显式配置但已下线的模型保留为可删除的 `MISS` 项。
101
106
 
@@ -107,7 +112,11 @@ OpenRouter 余额来自 `/api/v1/credits`,按 `total_credits - total_usage`
107
112
 
108
113
  PackyAPI 提供三个来源入口:Claude Code 下的 `PackyAPI`、`PackyAPI · 令牌2`,以及 Codex 下的 `PackyAPI`。第二令牌独立保存;Codex 与主令牌共用一次存储的 Key 和平台地址,模型、effort、可见性分别维护。
109
114
 
110
- Packy 的 Claude 入口默认展示 MiniMax-M3、claude-opus-5、claude-fable-5-1、qwen3.8-max-0902;Codex 入口默认展示 kimi-k3 和 grok-4.6。Fable 5.1 的 API ID 使用连字符 `claude-fable-5-1`;Grok 4.6 通过 Responses 接口调用。Packy 目录中其余兼容模型只放在「显示模型」目录,不会自动出现在选择面板;已配置的 `model`、`models` 或 `custom_models` 仍按显式配置保留。
115
+ 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 等变体,也不构造不存在的模型。
116
+
117
+ 精选随现有每 5 分钟目录刷新更新;当前运行模型与 effort 不随目录切换。点「隐」隐藏自动精选项后,同家族后续版本保持隐藏;手动显示的旧版本仍可独立显隐。「显示模型」中加入的额外接口项保存到 `shown_models`,隐藏记录保存到 `hidden_models`(自动家族同时记录 `family:opus` 等标记与当前 ID),显隐操作不会冻结整个精选列表。已配置的 `model` 和 `custom_models` 保留。
118
+
119
+ 显式 `models` 仍是固定列表,优先于自动精选;`models = ""` 保持空列表。以前通过面板显隐生成的 `models` 也按固定列表保留,移除该配置项后才恢复自动精选。其余兼容模型继续留在「显示模型」目录,可手动显示或补录。
111
120
 
112
121
  ```toml
113
122
  [token_source.packy]
@@ -115,7 +124,8 @@ api_key = "填写主令牌"
115
124
  base_url = "https://cf.api.fan"
116
125
  model = "MiniMax-M3"
117
126
  effort = "default"
118
- # models = "MiniMax-M3,qwen3.8-max-0902" # 可选:显式覆盖默认精选列表
127
+ # models = "MiniMax-M3,qwen3.8-max-0902" # 可选:固定列表,停止默认精选自动追新
128
+ # shown_models = "other-model" # 可选:在自动精选之外保留指定接口模型
119
129
  management_token = "填写个人设置中的系统访问令牌"
120
130
  management_user_id = "填写该账号用户 ID"
121
131
  management_url = "https://www.packyapi.ai"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.20.2",
3
+ "version": "0.20.4",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },