@leviyuan/lodestar 0.21.37 → 0.22.1
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/README.md +1 -1
- package/dist/lodestar-agent.js +33 -77
- package/dist/lodestar-claude.js +19 -19
- package/dist/lodestar-setup.js +41 -83
- package/dist/lodestar-stop.js +3 -3
- package/dist/lodestar-update.js +34 -77
- package/dist/lodestar-version.js +14 -14
- package/dist/lodestar.js +267 -259
- package/docs/AGENTS.md +3 -3
- package/docs/claude-agent-backend.md +19 -5
- package/docs/configuration.md +31 -8
- package/docs/models.md +34 -15
- package/docs/release.md +5 -2
- package/docs/usage.md +7 -3
- package/package.json +10 -10
package/docs/AGENTS.md
CHANGED
|
@@ -6,13 +6,13 @@ README 保留项目哲学、项目介绍、最短快速开始、常用指令表
|
|
|
6
6
|
|
|
7
7
|
详细内容按主题维护,事实以源码和测试为准。文件大小限制、生图展示规则、更新机制、配置与开发步骤放在对应文档,不堆进首页。
|
|
8
8
|
|
|
9
|
-
- `configuration.md`:安装、CLI、运行目录、配置、Agent
|
|
9
|
+
- `configuration.md`:安装、CLI、运行目录、配置、Agent 更新与源码开发。
|
|
10
10
|
- `usage.md`:群内命令、会话、worktree、文件与生图、本机通知。
|
|
11
|
-
- `models.md`:账号、模型与 effort、OpenRouter
|
|
11
|
+
- `models.md`:账号、模型与 effort、额度、reclaude、OpenRouter 默认列表、通用中转站、DSH 与 GLM 接入。
|
|
12
12
|
- `claude-agent-backend.md`:后端实现、模型路由和会话行为。
|
|
13
13
|
- `release.md`:发版步骤、工作流入口、凭据位置和常见坑(本机不 publish)。
|
|
14
14
|
|
|
15
|
-
- 保留 Codex、Claude Code 订阅、GLM、DeepSeek、OpenRouter、通用中转站和 DeepSeek Harness 的支持说明。
|
|
15
|
+
- 保留 Codex、Claude Code 订阅、reclaude、GLM、DeepSeek、OpenRouter、通用中转站和 DeepSeek Harness 的支持说明。
|
|
16
16
|
- 只写已实现的行为。删除失效接口、历史方案、重复规则和无法复现的验证结论;不另建产品规范或计划。
|
|
17
17
|
- 不记录凭据、真实 session id、群成员或本机配置。临时测试报告、排障流水和某次测试通过数不作为长期文档;维护文档保留可复现的验证方法及适用边界。
|
|
18
18
|
- 文字变更检查引用的路径、方法和命令;伴随实现变化时按对应目录指引运行测试。
|
|
@@ -6,7 +6,7 @@ Lodestar 通过 `AgentProcess` 接口连接 Codex app-server、Claude Agent SDK
|
|
|
6
6
|
|
|
7
7
|
## 进程与会话
|
|
8
8
|
|
|
9
|
-
| 行为 | Codex | Claude Code(含 GLM、DeepSeek、OpenRouter
|
|
9
|
+
| 行为 | Codex | Claude Code(含 reclaude、GLM、DeepSeek、OpenRouter、中转站) | DeepSeek Harness |
|
|
10
10
|
| --- | --- | --- | --- |
|
|
11
11
|
| 进程 | `codex app-server --listen stdio://`,通过 JSON-RPC 通信 | SDK `query()`,通过 `AsyncIterable<SDKUserMessage>` 连续输入 | Node 子进程,通过 Cordis stdio 桥接 |
|
|
12
12
|
| 初始化 | 等待初始化和 thread 启动事务完成 | 首条输入才触发 `system/init`;启动时只检查早期错误 | `session/open` 完成原生会话创建或恢复并落盘 |
|
|
@@ -17,7 +17,7 @@ Lodestar 通过 `AgentProcess` 接口连接 Codex app-server、Claude Agent SDK
|
|
|
17
17
|
|
|
18
18
|
会话引用包含 provider、原生 session id 和 cwd。各后端分别保存恢复记录,切换后端不会共用同一段上下文。Claude fork 在首条输入前持久保存启动意图,获得新 session id 后才清除;历史会话通过原生 fork 接入新群,避免两个群写同一个会话。
|
|
19
19
|
|
|
20
|
-
主动压缩没有固定完成时限,以完成事件为准,进程退出或报错时失败。Claude
|
|
20
|
+
主动压缩没有固定完成时限,以完成事件为准,进程退出或报错时失败。Claude 只有原生 `compact_boundary` 算压缩成功,普通 `result` 事件不能代替完成通知;其他原生结果都会结束等待:`Not enough messages to compact` 或 `No messages to compact` 视为无需压缩,原生返回的取消、跳过或失败文本按失败显示,等待期间的错误 `result` 和进程退出立即失败。压缩期间收到的 `stop`、`kill`、`restart`、`clear` 会先中断压缩,用户可见行为见[群内命令](usage.md#群内命令)。
|
|
21
21
|
|
|
22
22
|
## 账号和模型
|
|
23
23
|
|
|
@@ -27,6 +27,7 @@ Token Source 管理账号凭据、模型目录、启动环境、默认模型、e
|
|
|
27
27
|
| --- | --- |
|
|
28
28
|
| Codex subscription | 使用 Codex 登录态,模型来自 app-server `model/list` |
|
|
29
29
|
| Claude Code 订阅 | `claude-sub` 复用本机原生订阅登录态;通过 SDK `accountInfo()` 确认账号,`supportedModels()` 读取模型和 effort,与第三方来源独立共存 |
|
|
30
|
+
| reclaude | 本机找到 `reclaude` 命令即启用,`[token_source.reclaude]` 可选;登录与组织由 reclaude 管理,每次目录刷新经 reclaude 启动 control-only 进程,同时读取原生模型目录和 `/usage` 额度 |
|
|
30
31
|
| GLM Coding Plan | `[token_source.glm]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
|
|
31
32
|
| DeepSeek | `[token_source.deepseek]` 或本机 Claude settings;模型来自兼容端点,可补录已验证模型 |
|
|
32
33
|
| OpenRouter | `[token_source.openrouter]` 或本机 Claude settings;默认精选六个家族最新版(含 Gemini Flash、MiMo Pro),账号目录验证能力,MD 面板维护显隐 |
|
|
@@ -44,9 +45,9 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
|
|
|
44
45
|
|
|
45
46
|
`session-activity.ts` 按实际存活的 Claude 订阅进程与账号绑定统计会话:执行中或最近 30 分钟收到用户消息即为活跃,启动、等待回答、排队和后台任务也计入;同群去重,当前待启动群排除后再加一。消息时间持久化,重启后可恢复近期活跃判断,不保存消息内容。
|
|
46
47
|
|
|
47
|
-
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口、OAuth 及模型专属周窗口为 10 份,Fable 专属周窗口为 5 份(总周的一半)。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 模型缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2
|
|
48
|
+
`claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口、OAuth 及模型专属周窗口为 10 份,Fable 专属周窗口为 5 份(总周的一半)。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 模型缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,总周剩余中相当于 Fable 尚未使用份额的部分只按四分之一计入余量和节奏(`own = max(0, 剩余 − 预留)`,`room = own + 0.25 × (剩余 − own)`),距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;仍在预留期但专属周重复或数值无效时同样按 `MISS` 排除,专属周已用完时不再预留。折价只会降低排名,随余量连续变化、不分档,预留也不会使账号耗尽。任一适用窗口已用满才是真实耗尽,不参与正常选号,同时给出 `recoversAt`:全部用光窗口中最晚的重置时间(缓存里已过期的时间照用),任一缺失则为 `null`。通过模型和档位校验的账号全部真实耗尽时,`claude-account-selection.ts` 沿用恢复会话的原账号(须在耗尽账号中),否则选 `recoversAt` 最早的耗尽账号,`null` 排最后,同值按账号列表顺序(默认账号在前)。
|
|
48
49
|
|
|
49
|
-
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent
|
|
50
|
+
令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份)。每个适用窗口的节奏为 `room / span`,`span` 取距重置小时数且至少 1 小时(请求是突发的,快重置的窗口仍须撑一小时):5h 窗口 `span = clamp(小时数, 1, 5)`,跟上节奏(已用比例不超过已过时间比例,也不超过 80%)的窗口都与满窗同分;尚未启动的窗口(`claudeFiveHourUnstarted` 识别读取时的估算)按 `span = 5`、到期时间为当前时间加 5 小时计,不因快照变旧而显得紧迫;有 5h 窗口的账号逐窗花周额度,周类窗口 `span = clamp(小时数, 1, 24)`,周额度须够按满窗节奏撑过一天或撑到重置,距重置一天以上时剩不到 4.8 份即降权,5h 窗口有余量、周额度够用时这类账号一般排在只有周额度的账号之前;没有 5h 窗口的账号周类窗口 `span = max(小时数, 1)`,离重置远或快用完的周额度节奏低。账号节奏 `pace` 取各窗口最小值,`score = min(pace, 0.2) / (N+1)`:每次启动最多按每 5 小时一个满窗计,因为会话在窗口或周重置后仍留在原账号继续消耗,快作废的额度最多与满窗并列,不能把新任务都吸走。`compareClaudeQuota` 依次比较:分数降序、活跃负载升序、`pace` 降序(额度更需要尽快花掉的优先)、到期时间升序(有 5h 窗口取其重置时间,否则取该模型实际生效的周额度重置时间)、余量降序,其余保持账号列表顺序;不按有无 5h 窗口、重置先后或是否动用 Fable 预留整组排队。这里不预测任务用量,也不设 `fits`/`pressure`(Fable 预留按距总周重置不超过 2 天释放);计算不改真实额度,显式指定账号不经过这套自动排序。
|
|
50
51
|
|
|
51
52
|
各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
|
|
52
53
|
|
|
@@ -72,6 +73,18 @@ GLM、DeepSeek、OpenRouter 等来源先清除冲突的 Anthropic 环境变量
|
|
|
72
73
|
|
|
73
74
|
`[claude].bin` 可指定包装器,路径无效时启动失败;Windows `.cmd`/`.bat` 通过 shell shim 启动。未指定时使用独立运行目录中的 Claude Agent SDK 默认入口及其自带程序。
|
|
74
75
|
|
|
76
|
+
### reclaude 启动器
|
|
77
|
+
|
|
78
|
+
reclaude 来源(用户说明见[账号与模型](models.md#reclaude))不直接启动 Claude Code,而是通过 SDK 的 `spawnClaudeCodeProcess` 改写启动命令(`src/claude-launcher.ts`),主会话、目录与额度查询共用同一启动器:
|
|
79
|
+
|
|
80
|
+
- 命令为 `reclaude --org <组织 ID> cli <Claude Code 参数>`。组织 ID 取自最近一次目录刷新选定的绑定,显式传入,避免两次刷新之间切换默认组织导致进程与记录的目录不一致。
|
|
81
|
+
- SDK 选定的 Claude Code 可执行文件所在目录被放在 `PATH` 最前,reclaude 因此启动的是 SDK 期望的那份受管运行时,而不是本机另一份安装。SDK 入口不是名为 `claude` 的可执行文件(例如 `[claude].bin` 指向脚本入口)时拒绝启动。
|
|
82
|
+
- 环境先清除其他来源的 `ANTHROPIC_*` 变量,`CLAUDE_CONFIG_DIR` 设为 reclaude 数据目录中该组织绑定的配置目录,transcript、`rs` 历史、恢复和上下文用量都读取进程实际写入的位置。组织绑定(设备号)计入进程环境版本,绑定变化后空闲进程在下一轮前替换。
|
|
83
|
+
- settings 来源与其他第三方来源相同,为 `project`、`local`,Lodestar 管理的 Skill 通过本地插件加载;目录与额度查询的 control-only 进程使用 `user`。
|
|
84
|
+
- 启动器的 stderr 只保留以 `reclaude:` 开头的诊断行(最多 4 行),其余原生 stderr 丢弃,因为交接后它可能包含提示词、路径和账号信息。reclaude 在交给 Claude Code 之前失败时,SDK 只报退出码,Lodestar 把这些诊断行附在显示给用户的错误后面。
|
|
85
|
+
- reclaude 与 `claude-sub` 一样按订阅使用处理,在 Agent 身份目录和委派新建/续跑入口中按来源类型排除(`src/agent-identities.ts`)。
|
|
86
|
+
- 测试环境(`NODE_ENV=test`)不探测本机真实的 reclaude。
|
|
87
|
+
|
|
75
88
|
Claude 使用 `permissionMode: default`:普通工具在 `canUseTool` 中放行,`AskUserQuestion` 等待用户回答。不能改成 `bypassPermissions`,否则 SDK 会绕开提问回调。
|
|
76
89
|
|
|
77
90
|
Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`,让新版 Claude 及第三方模型继续提供任务清单工具。安装或升级后无需手动修改配置,已有进程需重新启动后生效。任务创建和状态更新显示在会话卡片中,是否使用清单由 Agent 判断,项目 `tools` 限制仍生效。
|
|
@@ -95,10 +108,11 @@ Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TO
|
|
|
95
108
|
|
|
96
109
|
`DshProcess` 使用当前安装的运行目录启动 Node DSH 子进程,以 `sdk` profile 加载 `dsh-bridge` Cordis 插件,替换默认 SDK JSON-RPC server。启动补丁先读取所装 `@deepseek-ai/dsh-sdk-app/cordis.patch.yml`:profile 已自带 ask-user 工具时不再插入同插件(重复注册会让 DSH 启动失败),读取不到时保留插入以兼容旧版。0.2.2 起模型接入链需要的 credentials 服务保持启用,凭据仍只由 Lodestar 注入的环境变量提供,不写登录态。Lodestar 的 stdio 协议只承载控制和事件;Agent 循环、工具执行、持久化及子 Agent 由 DSH 管理。
|
|
97
110
|
|
|
98
|
-
Agent 运行依赖由 `src/agent-updates.ts`
|
|
111
|
+
Agent 运行依赖由 `src/agent-updates.ts` 独立安装,更新命令、自动更新开关、版本目录和失败处理见[安装与配置](configuration.md#agent-更新)。DSH 子包的 dist-tag 可能不同步,因此从主包最新版本递归读取 dependencies/peerDependencies/optionalDependencies,整族安装该次动态选中的版本。不存在兼容版本白名单;不兼容直接报告并后续适配。`dsh-bridge` 被放入选中运行目录,从同一依赖树加载,握手版本来自实际 package.json。开发依赖和 Bun 锁文件只是本地测试快照,不限制生产更新。普通安全 overrides 同时用于独立运行目录,tarball 验收真实执行更新器、包审计和原生查询。
|
|
99
112
|
|
|
100
113
|
- `session/open` 完成原生 create/resume/fork 并 flush 后才公布恢复点。`rs` 通过原生持久化服务列出同工作目录会话;`fk/bk` 使用 `turn/end` 的事件序号作为 checkpoint,原生日志验证并加载分叉历史。
|
|
101
114
|
- 实时文本来自 `agent/assistant-stream`,工具和计划来自会话事件。进入 idle 后等待持久化完成,再用真实 `turn/end` 原因结算;认证失败、token 耗尽及驱动异常均向调用方报告。
|
|
115
|
+
- 模型给出的工具参数不是合法 JSON 对象时不结束会话:工具输入按 `{ raw: <原文> }` 展示,由 DSH 返回自身的工具错误,本轮继续。启动失败时删除已创建的临时启动目录。
|
|
102
116
|
- 子工具返回的内容块数组先转换为委派面板内的步骤摘要;不能按字符串直接处理。致命桥接错误会把未结束的子任务标记失败,并将进程退出作为异常向用户报告。
|
|
103
117
|
- 提问通过 `user-questions/request` 停驻,复用飞书问答卡;回答按原始 question id 返回。主动和自动压缩使用 DSH compaction 服务与事件。
|
|
104
118
|
- 模型与 effort 更新在下一轮应用,同一轮的工具续跑保持当前路由。`off` 是 DSH 原生推理选项。
|
package/docs/configuration.md
CHANGED
|
@@ -26,24 +26,28 @@ lodestar-setup
|
|
|
26
26
|
| `lodestar-setup` | 配置向导 |
|
|
27
27
|
| `lodestar-daemon` | 启动 daemon |
|
|
28
28
|
| `lodestar-stop` | 停止 daemon |
|
|
29
|
-
| `lodestar-update` | 升级 Lodestar
|
|
29
|
+
| `lodestar-update` | 升级 Lodestar,再更新 Codex、Claude Code/SDK、DSH;`--agents-only` 只立即更新 Agent,详见 [Agent 更新](#agent-更新) |
|
|
30
30
|
| `lodestar-version` | 查看 Lodestar、实际 Agent 版本及运行目录 |
|
|
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
|
-
|
|
36
34
|
启动和停止命令会核对 PID 对应的实际入口,读取进程信息失败时明确报错。无法识别的运行时选项、macOS 无法区分边界的含空格入口、Windows 相对入口也会拒绝操作,请通过对应服务管理器处理。旧式单行 PID 文件缺少入口标识,`lodestar-stop` 会拒绝发送信号;请先核对该 PID 的完整命令行,再通过服务管理器或精确 PID 停止。停止命令以进程退出为准,删除 PID 文件不会被当作停止成功。
|
|
37
35
|
|
|
36
|
+
长期运行可交给 Linux `systemd --user`、macOS `launchd` 或 Windows 任务计划程序。daemon 重启后会恢复上次活跃的会话。
|
|
37
|
+
|
|
38
|
+
## Agent 更新
|
|
39
|
+
|
|
40
|
+
`lodestar-update` 先用 npm 全局安装最新的 Lodestar,再以子进程运行**新装版本**的 `lodestar-update --agents-only` 更新 Agent,因此新版本对安装逻辑的修改在这次更新中就会生效;`lodestar-update --agents-only` 直接在当前进程内更新。命令不会重启 daemon:检测到 daemon 仍在运行时会提示用对应服务管理器重启,旧进程重启前继续运行旧版 Lodestar。
|
|
41
|
+
|
|
38
42
|
daemon 启动时不检查 Agent 版本,也不安装或更新 Agent。自动更新默认关闭;首次安装缺少运行文件或需要更新时,运行 `lodestar-update --agents-only`。手动更新和显式开启的自动更新都选择上游 `latest`,独立于 Lodestar 发版,不设置兼容版本白名单。
|
|
39
43
|
|
|
40
|
-
Codex、Claude、DSH 在 `[runtime.agent_auto_update]` 下分别设置 `codex`、`claude`、`dsh` 开关,未设置的项均为 `false`。设为 `true` 的 Agent 在 daemon 运行满 6 小时后首次检查,之后每 6 小时独立检查,启动阶段仍不检查;一个 Agent 更新较慢或失败不阻塞其他 Agent
|
|
44
|
+
Codex、Claude、DSH 在 `[runtime.agent_auto_update]` 下分别设置 `codex`、`claude`、`dsh` 开关,未设置的项均为 `false`。设为 `true` 的 Agent 在 daemon 运行满 6 小时后首次检查,之后每 6 小时独立检查,启动阶段仍不检查;一个 Agent 更新较慢或失败不阻塞其他 Agent。daemon 停止时在停机时限内等待进行中的自动更新结束。旧版布尔总开关按原值兼容映射为三项并提示迁移,不可与新配置表混用。
|
|
41
45
|
|
|
42
|
-
运行文件放在 Lodestar 数据目录的 `agent-runtimes/` 下,每个版本使用独立目录;更新只切换新进程所用的目录,保留正在运行任务的程序和 SDK
|
|
46
|
+
运行文件放在 Lodestar 数据目录的 `agent-runtimes/` 下,每个版本使用独立目录;更新只切换新进程所用的目录,保留正在运行任务的程序和 SDK。更新成功后保留当前版本及最近 3 个版本目录,更旧的目录在没有运行中进程使用时删除。Windows 下也不覆盖、重命名或删除正在使用的旧版 EXE/DLL。取消安装时按安装器 PID 终止其进程树,并等待退出;若无法确认终止,保留可能被占用的临时目录并报告错误。
|
|
43
47
|
|
|
44
|
-
|
|
48
|
+
中断或取消的安装留下的临时目录(`.install-*`)和失效的更新锁,由该 Agent 下一次成功更新时一并清理,仍被运行中进程使用的目录保留;临时目录在安装进程确认退出后才删除,无法确认的满 24 小时后删除;无法读取进程列表的平台跳过清理。清理失败只在更新输出中提示,不影响更新结果。更新程序在创建锁后、写入 PID 前退出时,该锁 30 秒后可被回收,不会阻塞之后的更新。
|
|
45
49
|
|
|
46
|
-
|
|
50
|
+
后台更新失败只记日志,继续使用当前安装;已开启自动更新的 Agent 会在下一个 6 小时检查周期再试。启动和 `lodestar-version` 不提示历史更新错误,版本查询只显示当前安装。手动更新命令仍如实返回本次更新结果。尚未安装或本地安装损坏时无法启动。旧版若已因失败清除了安装选择记录,需要一次成功的 `lodestar-update --agents-only` 恢复记录,不会自动猜测目录中的版本。文件占用只做有限重试,最终失败仍显示。显式配置的 `[claude].bin` 按该路径执行。
|
|
47
51
|
|
|
48
52
|
## 飞书应用权限
|
|
49
53
|
|
|
@@ -63,7 +67,7 @@ Codex、Claude、DSH 在 `[runtime.agent_auto_update]` 下分别设置 `codex`
|
|
|
63
67
|
|
|
64
68
|
## 本机配置
|
|
65
69
|
|
|
66
|
-
默认配置文件是 `~/.config/lodestar/config.toml`,可通过 `LODESTAR_CONFIG` 指定文件。日志和会话状态位于 `~/.local/share/lodestar/`;Windows 使用相应的应用数据目录。完整路径定义见 [src/paths.ts](../src/paths.ts)
|
|
70
|
+
默认配置文件是 `~/.config/lodestar/config.toml`,可通过 `LODESTAR_CONFIG` 指定文件。日志和会话状态位于 `~/.local/share/lodestar/`;Windows 使用相应的应用数据目录。完整路径定义见 [src/paths.ts](../src/paths.ts)。数据目录和 PID 目录由 Lodestar 新建时权限为 `0700`,已存在的目录不修改权限。
|
|
67
71
|
|
|
68
72
|
运行日志按日保存,保留近 7 天。正常流程仅记录关键状态;不记录协议大包、工具输出、代码 diff、请求/响应正文或内部阶段流水。日志省略用户、群、项目和账号名称、路径、聊天/消息/会话/任务标识,以及人数和群数,不生成可关联的匿名编号。故障记录保留固定操作说明、错误类别、错误码和 HTTP 状态;相同摘要在 10 分钟内合并,不显示重复次数。用户收到的错误详情不因此省略。会话历史、任务结果和恢复绑定是功能状态,仍由相应模块保存。
|
|
69
73
|
|
|
@@ -101,6 +105,25 @@ Claude 后端启用项目 MCP 时,缺少 `.mcp.json` 表示未配置;文件
|
|
|
101
105
|
|
|
102
106
|
账号配置、OpenRouter 默认模型、通用中转站和 DSH 接入见[模型与账号](models.md)。手动修改配置后需重启 daemon;群内设置自行保存。
|
|
103
107
|
|
|
108
|
+
### reclaude 配置
|
|
109
|
+
|
|
110
|
+
[reclaude](models.md#reclaude) 无需配置:本机 `PATH` 或 `~/.local/bin` 中有 `reclaude` 命令即自动启用。需要调整时添加 `[token_source.reclaude]`,所有键均可省略,没有凭据字段:
|
|
111
|
+
|
|
112
|
+
```toml
|
|
113
|
+
[token_source.reclaude]
|
|
114
|
+
# enabled = false # 关闭该来源;省略或 true 时按是否找到命令自动启用
|
|
115
|
+
# bin = "/abs/path/to/reclaude" # 命令不在 PATH 或 ~/.local/bin 时指定,路径须存在
|
|
116
|
+
# org = "<组织 ID>" # 固定组织;省略时跟随 reclaude org use 选定的组织
|
|
117
|
+
# display = "reclaude" # md、hi 中的显示名
|
|
118
|
+
# model = "<模型 ID>" # 默认模型,须在目录中或已补录;省略时选目录中的 Claude Opus
|
|
119
|
+
# effort = "high" # 默认模型的默认档位,须为该模型支持的档位
|
|
120
|
+
# hidden_models = "" # 逗号分隔:从目录中隐藏的模型
|
|
121
|
+
# shown_models = "" # 逗号分隔:显式显示的目录模型
|
|
122
|
+
# custom_models = "" # 逗号分隔:补录的目录外模型
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
`hidden_models`、`shown_models`、`custom_models` 一般通过 `md` 面板的「隐 / 显」与补录维护,不必手写。
|
|
126
|
+
|
|
104
127
|
## HTTP 代理
|
|
105
128
|
|
|
106
129
|
OpenRouter 的模型目录与余额查询,以及 Lodestar 自己发出的其他 HTTP 请求,共用相同的代理选择。无需开启 TUN,也不需要给每个 Token Source 单独配置代理。
|
package/docs/models.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[返回首页](../README.md) · [安装与配置](configuration.md) · [群内用法](usage.md)
|
|
4
4
|
|
|
5
|
-
账号配置使用 `[token_source.glm]`、`[token_source.deepseek]`
|
|
5
|
+
账号配置使用 `[token_source.glm]`、`[token_source.deepseek]` 等节,通用中转站使用 `[relay.<site_id>]`。GLM、DeepSeek 和 OpenRouter 也可以从本机 Claude settings 中识别;识别后由对应 Token Source 注入凭据,避免不同账号的环境变量串用。项目的工具限制只作用于主会话,委派 Agent 使用完整工具集。
|
|
6
6
|
|
|
7
7
|
## 配置 API Key
|
|
8
8
|
|
|
@@ -27,7 +27,7 @@ GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下
|
|
|
27
27
|
|
|
28
28
|
发送 `model`(`md`),在 Claude Code、Codex、DeepSeek Harness 分组下选择账号,再选择模型。首页直接使用缓存;手动点开账号模型列表时立即发起目录查询,卡片显示刷新状态,完成后呈现目录。有多个推理档位(effort)时继续选择档位,只有一个档位时直接应用。
|
|
29
29
|
|
|
30
|
-
Codex 订阅的模型目录和额度主动轮询均为每 2
|
|
30
|
+
Codex 订阅的模型目录和额度主动轮询均为每 2 小时;[reclaude](#reclaude) 的额度随模型目录一起读取,均为每 5 分钟;其他来源为模型目录每 5 分钟、额度每 60 秒。daemon 启动时完成首次预热。`md` 首页、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存。手动进入账号模型列表会额外查询,但不会占住其他交互;翻页和显隐后的列表重绘复用快照。Codex 邮箱复用后台原生账号查询的结果。
|
|
31
31
|
|
|
32
32
|
这些周期和主动查询流量预算仅约束 Lodestar 的定时轮询。常驻 Codex 自身刷新、用户手动拉取模型列表属于允许额外消耗的被动刷新,不受主动周期限制。同账号有运行中的 Codex 进程时,额度复用已有连接,每分钟兜底刷新,并在额度通知和回合结束时及时回读。无运行进程、也没有用户按需操作时,其他地方的消费变化可能到下次主动查询才显示。
|
|
33
33
|
|
|
@@ -48,11 +48,11 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
|
|
|
48
48
|
|
|
49
49
|
## 额度
|
|
50
50
|
|
|
51
|
-
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude
|
|
51
|
+
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
52
52
|
|
|
53
|
-
所有群、Agent、`hi
|
|
53
|
+
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存,刷新周期见[选择与管理模型](#选择与管理模型)。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
54
54
|
|
|
55
|
-
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;Claude
|
|
55
|
+
回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;Claude 订阅或 reclaude 账号已取消 5 小时限额时省略 5h 段,只显示 `[6.9d·17%]`,不补 `MISS`。余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时,回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存,账号列表仍展示本次调度失败原因。
|
|
56
56
|
|
|
57
57
|
Codex 启动和换号优先使用最近一次成功的额度缓存;能选出账号就直接启动,不等待其他账号刷新;没有可用缓存时明确显示 MISS,后台继续刷新。其他账号未参与选号的诊断保留在日志和 `codex-accounts` 中,不主动发送“部分账号 MISS”警告。只有无法启动或继续任务时,才主动展示相应失败或等待状态。
|
|
58
58
|
|
|
@@ -73,15 +73,15 @@ lodestar-claude 工作号 auth login
|
|
|
73
73
|
|
|
74
74
|
在 Claude Code 会话发送 `hi 工作号`,Lodestar 只检查这个备注对应的目录。新增备注账号通过原生订阅身份验证后,卡片显示“已登录,正在完成首次同步”,保留认证进程等待 Skills 和插件云同步完成,再收录并启动;不会扫描其他目录或代办登录。首次同步最长等待 120 秒,期间不查询该账号的模型或额度、不参与自动选号,也不能启动任务或切换到该账号。失败保留账号和原因,按提示稍后再次发送 `hi 工作号` 重试;连续失败的重试间隔依次为 1、2、4、5 分钟,不由后台额度轮询自动重试。`hi default` 指定原生默认账号。指定账号只影响本次启动;同号正在运行时显示状态,忙碌时不能切换其他号,空闲时可用 `hi 另一备注` 切换并恢复原会话。
|
|
75
75
|
|
|
76
|
-
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS`
|
|
76
|
+
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已真实耗尽,自动启动仍从中选一个,不因自动选号失败阻断启动或 `rs` 恢复:恢复已有会话且该会话原来的账号也在耗尽账号中时,沿用原账号;否则选最早恢复的耗尽账号,即全部用光的窗口都已重置的时间最早。用光的窗口缺少重置时间时恢复时间未知,排在最后;时间相同按账号列表顺序,设备默认账号在前。Fable 预留只影响排名,不会使账号判为耗尽(见下文)。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
|
|
77
77
|
|
|
78
|
-
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2
|
|
78
|
+
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,总周剩余中相当于 Fable 尚未使用份额的部分只按四分之一计入余量和节奏:这只会降低账号排名,不排除账号、不分档,也不会因此判为耗尽;距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;Fable 模型缺少专属周按 `MISS` 排除,仍在预留期但专属周重复或数值无效时也按 `MISS` 排除,专属周已用完时不再预留。其他模型专属仅兼容接口实际返回的窗口。
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
选号按各账号可持续的消耗节奏分散任务,不预测单个任务的用量:每个适用窗口的节奏是剩余份数除以距其重置的小时数(不足 1 小时按 1 小时计),账号节奏取最慢的那个窗口,且每次启动最多按每 5 小时一个满窗(每小时 0.2 份)计。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把封顶后的账号节奏除以“活跃负载单位 + 1”,作为该账号的分数,分数高者优先。
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
封顶是因为会话在窗口或周额度重置后仍留在原账号继续消耗:快作废的额度最多与满窗并列,不会把新任务都吸走。不足 1 小时按 1 小时计是因为请求是突发的:5 小时窗口至少剩 0.2 份才算满窗节奏,已用比例不超过窗口已过时间比例(也不超过 80%)的窗口都与满窗同分,其余按实际节奏降低。有 5 小时窗口的账号逐窗花周额度,周窗口最多按 24 小时折算:周额度须够按满窗节奏撑过一天或撑到周重置,否则拉低分数(距重置一天以上时即剩不到 4.8 份);窗口有余量、周额度够用时,这类账号一般排在只有周额度的账号之前。没有 5 小时限额的账号按到周重置为止的节奏计算,离重置远或快用完的周额度节奏低。同分时依次取活跃负载少、封顶前节奏高(额度更需要尽快花掉)、到期早(有 5 小时窗口看其重置时间,否则看该模型实际生效的周额度重置时间)、余量大的账号。尚未启动的 5 小时窗口不会作废,被使用时才开始计时:无论额度缓存读取了多久,都按完整 5 小时、从现在起 5 小时到期计,不会因缓存变旧而排到真正在计时、额度会作废的窗口之前。
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
选择只看真实余量、各窗口的重置时间和当前负载:不按有无 5 小时窗口、重置先后或是否动用 Fable 预留整组排队,不预留未来用量,也不设“预计是否装得下”的门槛。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按前述规则回退。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
85
85
|
|
|
86
86
|
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
87
87
|
|
|
@@ -101,6 +101,25 @@ lodestar-claude 工作号 auth login
|
|
|
101
101
|
|
|
102
102
|
旧版“Claude”本机配置入口已移除;使用该入口的用户升级后请通过 `md` 选择“Claude Code 订阅”及模型。
|
|
103
103
|
|
|
104
|
+
## reclaude
|
|
105
|
+
|
|
106
|
+
reclaude 是第三方的 Claude Code 启动器:登录、组织绑定和网络路由都由 reclaude 自己管理,Lodestar 只经它启动 Claude Code,不读取、不保存 reclaude 的任何凭据,配置里也没有凭据字段。来源 id 为 `reclaude`,在 `md` → Claude Code 下显示为 **reclaude**(可用 `display` 改名),可与 Claude Code 订阅及其他第三方来源同时使用。
|
|
107
|
+
|
|
108
|
+
**启用**:无需群命令。Lodestar 在 `PATH` 和 `~/.local/bin` 中查找 `reclaude` 命令,找到即启用;装在别处时用 `[token_source.reclaude]` 的 `bin` 指定(路径不存在会报错),`enabled = false` 关闭该来源。配置项见[安装与配置](configuration.md#reclaude-配置)。每次目录刷新都会重新查找,Lodestar 运行后才安装或卸载 reclaude 无需重启,约 5 分钟内自动生效。随后在运行 Lodestar 的本机用 `reclaude login` 登录,并用 reclaude 绑定组织。
|
|
109
|
+
|
|
110
|
+
**组织**:默认跟随 `reclaude org use <组织 ID>` 选定的当前组织;在配置中写 `org = "<组织 ID>"` 则固定使用该组织,该组织须已用 `reclaude org bind <组织 ID>` 绑定。切换组织在下一次目录刷新时生效:模型和额度改读新组织,绑定旧组织的空闲进程在下一轮开始前停止,按新组织重新启动。
|
|
111
|
+
|
|
112
|
+
**会话记录**:reclaude 的会话记录保存在各组织自己的配置目录中,与其他 Claude 来源共用的会话目录相互独立。在 reclaude 与其他 Claude 来源之间切换,或切换组织后,原会话无法在新来源续接:续接时会说明原因,发送 `hi` 开始新会话,或用 `md` 切回原来源继续。`rs` 只列出当前来源目录下的历史会话。
|
|
113
|
+
|
|
114
|
+
**状态**:
|
|
115
|
+
|
|
116
|
+
- `md` 中显示“未配置”:本机找不到 reclaude 命令,或已被 `enabled = false` 关闭;点 **启** 会回复具体原因。
|
|
117
|
+
- 模型目录显示 `MISS`:命令已找到,但 reclaude 未登录或登录失效、没有当前组织、`org` 指定的组织未绑定、绑定目录尚未初始化,或 reclaude 暂时无法确认登录状态(本机网络或 reclaude 后台服务异常,恢复后自动重试,无需重新登录)。原因中会给出要执行的命令(`reclaude login`、`reclaude org bind <id>`、`reclaude org use <id>`,或先运行一次 reclaude 完成初始化)。处理后等待下一次目录刷新(约 5 分钟),也可手动打开该来源的模型列表立即刷新。
|
|
118
|
+
|
|
119
|
+
**模型与额度**:每次目录刷新(每 5 分钟,以及手动打开模型列表时)经 reclaude 启动一个 control-only Claude Code 进程,同时读取原生模型目录和原生 `/usage` 额度,因此 reclaude 的额度每 5 分钟更新一次,而不是每 60 秒。额度格式与 Claude Code 订阅相同:`hi` 显示 5 小时、周额度及模型专属周额度,回复底部显示本轮模型适用的窗口。额度读取失败只把额度显示为 `MISS`,模型目录照常可用。未配置 `model` 时默认选目录中的 Claude Opus;配置的 `model` 须在目录中或已补录,`effort` 须为该模型支持的档位,否则目录显示 `MISS` 和原因。
|
|
120
|
+
|
|
121
|
+
**限制**:reclaude 使用组织的 Claude 订阅登录,与 Claude Code 订阅同样属于订阅使用,因此 Lodestar Agent 不调用 reclaude(遵守 Claude 用户协议),它不出现在 `agents` 身份目录中,也不能用于新建或续跑委派任务。主会话和原生委派工具不受影响。reclaude 只能启动原生 Claude Code 可执行文件,`[claude].bin` 指向脚本入口时该来源拒绝启动。启动方式见[后端说明](claude-agent-backend.md#reclaude-启动器)。
|
|
122
|
+
|
|
104
123
|
## OpenRouter
|
|
105
124
|
|
|
106
125
|
OpenRouter 通过 Claude Agent SDK 运行。在群内发送 `openrouter-setup <api_key>`,再通过 `model` 面板选择模型和 effort;自建兼容端点用 `openrouter-setup <base_url> <api_key>`。也可在配置文件中添加:
|
|
@@ -140,13 +159,13 @@ effort 按上游声明提供。小米、MiniMax、字节等没有 effort 选择
|
|
|
140
159
|
|
|
141
160
|
OpenRouter 余额来自 `/api/v1/credits`,按 `total_credits - total_usage` 计算;接口权限和错误以实际响应为准。账号目录可见不代表所有工具和请求都能成功,上游拒绝或路由不可用会明确报错。兼容接口、模型与档位的处理见[后端说明](claude-agent-backend.md#openrouter)。
|
|
142
161
|
|
|
143
|
-
##
|
|
162
|
+
## 通用中转站
|
|
144
163
|
|
|
145
|
-
|
|
164
|
+
中转站不绑定具体厂商,每个站点一节 `[relay.<site_id>]`,只配置站点标识、API Key、地址和协议类型。PackyAPI 等中转服务都按这种方式接入;旧版 `[token_source.packy]`、`[token_source.packy-secondary]`、`[token_source.packy-codex]` 不再读取,升级后需按本节格式重新配置。
|
|
146
165
|
|
|
147
166
|
```toml
|
|
148
|
-
[relay.
|
|
149
|
-
display = "
|
|
167
|
+
[relay.my-relay]
|
|
168
|
+
display = "我的中转站"
|
|
150
169
|
api_key = "填写 API Key"
|
|
151
170
|
base_url = "https://gateway.example"
|
|
152
171
|
protocol = "anthropic" # Claude Code;OpenAI 类型同时提供 Codex 和 DSH
|
|
@@ -163,7 +182,7 @@ protocol = "anthropic" # Claude Code;OpenAI 类型同时提供 Codex
|
|
|
163
182
|
余额查询是可选的。发送 `relay-balance-setup <site_id> <script_path>` 绑定脚本。脚本通过 stdin 接收 JSON:
|
|
164
183
|
|
|
165
184
|
```json
|
|
166
|
-
{"site_id":"
|
|
185
|
+
{"site_id":"my-relay","base_url":"https://gateway.example","protocol":"anthropic","api_key":"..."}
|
|
167
186
|
```
|
|
168
187
|
|
|
169
188
|
stdout 返回统一额度快照,例如:
|
package/docs/release.md
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
4. 打并推送标签:`git tag v0.21.31 && git push github v0.21.31`。标签必须与 `version` 一致,且指向要发布的提交(工作流会校验)。
|
|
11
11
|
5. 触发工作流:`gh workflow run release.yml -f tag=v0.21.31`。
|
|
12
12
|
6. 等待结果:`gh run watch`,或 `gh run list --workflow=release.yml --limit 1`。
|
|
13
|
-
工作流依次做:校验标签/版本 → 探测两个仓库身份 → `bun run ci` → `npm pack` → tarball 验收(`test-codex-plugin-upgrade`、`npm audit --omit=dev`、`check-installed-package`)→ 上传制品 → 发布 npm → 发布 GitHub Packages。
|
|
13
|
+
工作流依次做:校验标签/版本 → 探测两个仓库身份 → 安装锁定依赖并检查安全依赖声明 → `bun run ci` → `npm pack` → tarball 验收(`test-codex-plugin-upgrade`、`npm audit --omit=dev`、`check-installed-package`)→ 上传制品 → 发布 npm → 发布 GitHub Packages。
|
|
14
14
|
7. 发布成功后建 GitHub Release(标题、功能说明和验证结果用中文):
|
|
15
15
|
|
|
16
16
|
```bash
|
|
@@ -21,8 +21,11 @@
|
|
|
21
21
|
|
|
22
22
|
## 常见坑
|
|
23
23
|
|
|
24
|
+
- 打标签前先推送 `main` 并等 `CI` 工作流通过。它在 Linux 上跑全量测试、在 Windows 上跑更新流程用例,本机(macOS)全绿不代表这两处通过:Linux 会立刻复用刚删除目录的 inode,Windows 的文件时间与改名语义也不同。标签指向的提交若在 CI 才暴露问题,就得再发一个版本。
|
|
25
|
+
- `Production dependency audit` 或发布工作流的 `npm audit` 报出新公告时,先升级 `overrides` 中对应的安全依赖,运行 `bun scripts/sync-security-deps.ts` 并用 Bun 同步 `bun.lock`,`bun audit --production` 无告警后再发布;新公告与本次改动无关也会拦住发布。
|
|
26
|
+
|
|
24
27
|
- 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
|
|
25
28
|
- 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
|
|
26
29
|
- 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
|
|
27
|
-
-
|
|
30
|
+
- `src/pid-guard.test.ts` 的 Linux 专用用例曾因进程刚 exec 时 `/proc/<pid>/cmdline` 短暂为空而偶发失败(报「命令行为空」)。守卫现在会重读空命令行,并把僵尸进程与内核线程视为不存在。若仍遇到这一条失败,确认日志只有它后 `gh run rerun <run-id> --failed` 重跑即可,不要为此改版本或移动已推送的 tag。
|
|
28
31
|
- `scripts/publish-verified-package.mjs` 只接受 `npm pack --json` 生成的清单(含 `name`、`version`、`filename`、`integrity`),并在 `NODE_AUTH_TOKEN` 缺失时直接拒绝发布。
|
package/docs/usage.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
| `kill` | `kl` | 关闭当前 Agent 进程,保存可恢复的会话记录 |
|
|
15
15
|
| `restart` | `rs` | 进程存活时打断并恢复当前会话;已停止时列出同目录的历史会话(显示时间、会话短标签、首句和最后一条用户输入),选择后创建独立分支 |
|
|
16
16
|
| `clear` | `cl` | 关闭当前进程并开始新会话;已停止时提示先启动 |
|
|
17
|
-
| `compact` | `cm` |
|
|
17
|
+
| `compact` | `cm` | 压缩当前会话的上下文,结果见下文 |
|
|
18
18
|
| `agents` | `agent` | 查看可调用的 Agent 身份及可用状态 |
|
|
19
19
|
| `claude-sub` | — | 查看 Claude Code 订阅在 Lodestar 中的开关和可用状态 |
|
|
20
20
|
| `claude-sub on` | — | 启用 Claude Code 订阅来源,所有群共用 |
|
|
@@ -31,6 +31,10 @@
|
|
|
31
31
|
|
|
32
32
|
模型列表来自各账号的模型目录,获取失败显示 `MISS`。同账号切换 Claude 或 DSH 模型从后续回复生效,Codex 的持久模型设置需重启会话生效;跨账号或后端切换只允许在空闲时进行。账号接入、模型补录与额度说明见[账号与模型](models.md)。
|
|
33
33
|
|
|
34
|
+
`restart` 和 `clear` 在状态卡上显示进度;重启过程出错时,状态卡以 `❌ 重启失败: <原因>` 或 `❌ 清空失败: <原因>` 结束。Claude 会话的历史列表按最后修改时间倒序,最多显示最新的 40 个会话。
|
|
35
|
+
|
|
36
|
+
`compact`(`cm`)在状态卡上显示结果:完成显示 `✅ 上下文已压缩`,能读取时附压缩后的上下文用量;无需压缩时显示 ⓘ 和原因;失败显示 `❌ 上下文压缩失败` 和原因,Claude 原生返回的取消、跳过或失败说明原样显示。压缩没有时间上限,期间本群的普通消息排队,压缩结束后依次处理。压缩期间发送 `stop`、`kill`、`restart`、`clear`(或其缩写)会立即中断压缩,状态卡显示 `🛑 上下文压缩已取消`,随后照常执行该命令;其中 `kill`、`restart`、`clear` 在后端 10 秒内未响应中断时强制结束进程,`stop` 只中断。
|
|
37
|
+
|
|
34
38
|
Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方向,无需等待整轮回复结束。消息会交给正在运行的任务,在后端下一次可接收输入时生效;Agent 实际收入补充消息后,按原生执行记录中的连续输入区段切换到新卡,顶部「📥 追加」列出整批补充内容。中间没有 Agent 思考、回复或工具执行的连续补充会合并在一张卡里。在此之前的输出仍留在旧卡,之后的输出进入新卡,运行中的工具随卡接续;新卡发送成功时一并撤销本批消息的等待表情,旧卡标记已续至下一张,任务继续执行。Claude 的兼容来源(GLM、DeepSeek、OpenRouter 等)沿用这一行为。消息恰好赶上回合结束时会接着处理;进程仍在启动或恢复时暂存,提交失败会明确提示。`stop` 同时取消尚未处理的追加消息。DeepSeek Harness 仍按下一轮批次处理执行中收到的消息。
|
|
35
39
|
|
|
36
40
|
## Codex 设备码登录与多账号
|
|
@@ -55,7 +59,7 @@ Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方
|
|
|
55
59
|
|
|
56
60
|
其余账号按分数从高到低选择,同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算(原生套餐标识为 `plus`、`prolite`、`pro`),周分数为 **周剩余份额 ÷(距周重置小时数 − 5)**,提前 5 小时安排消耗;临期账号直接按优先级处理,不做零或负分母计算。Plus 仅在接口返回 5h 窗口时按完整窗口 0.15 份计算,短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**,普通评分取周分数和短窗分数的较小值。未返回 5h 窗口的 Plus 和 Pro 使用周分数。两种窗口约束同一份消耗,不相加。
|
|
57
61
|
|
|
58
|
-
|
|
62
|
+
启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。额度刷新周期、按需回读和失败冷却见[账号与模型](models.md#额度);运行连接失败不另起控制进程。`hi`、`codex-accounts` 只读缓存,不额外发起查询,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
|
|
59
63
|
|
|
60
64
|
自动选号成功后,其他账号的缓存过期、模型档位不支持或查询失败不会单独发送警告卡或消息;具体原因保留在日志中,也可用 `codex-accounts` 主动查看。此规则同时适用于首次启动、恢复会话和自动换号。无法选出账号、任务必须等待额度恢复或当前账号实际执行失败时,仍会明确提示。
|
|
61
65
|
|
|
@@ -199,7 +203,7 @@ curl -sS -X POST http://127.0.0.1:9876/notify \
|
|
|
199
203
|
|
|
200
204
|
按钮点击结果可以 POST 到指定的本机 `callback`,或通过 `GET /notify/result/<notify_id>` 查询。需要文字回复时设置 `allow_reply: true`,卡片会提供“回复”按钮;文字回复模式与自定义按钮模式不能同时启用。字段和协议见 [feishu-notify Skill](../src/notify-skill.ts)。daemon 启动时会将该 Skill 同步到 Codex 和 Claude 的 Skill 目录。
|
|
201
205
|
|
|
202
|
-
通知 JSON 正文上限为 4 MiB,超出返回 `413
|
|
206
|
+
通知 JSON 正文上限为 4 MiB,超出返回 `413`;图片仍通过本地路径提供。该端口只面向本机脚本和 Agent:浏览器页面发来的跨站请求(带非本机 `Origin`)返回 `403`,本机回环地址上的页面不受影响。按钮回调或文字回复发送期间若 daemon 中断,重启后会在原卡显示“送达状态未知”并禁止再次发送,请先向接收方核实处理结果;该提示只展示一次,若展示失败则在下次启动时重试。通知状态文件无法读取或 JSON 损坏会明确阻止启动,避免丢失去重记录后重复执行。
|
|
203
207
|
|
|
204
208
|
## 文件与生图
|
|
205
209
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@leviyuan/lodestar",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.1",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -36,12 +36,12 @@
|
|
|
36
36
|
"ci": "bun run audit:production && bun run typecheck && bun run test && bun run test:randomized && bun run build",
|
|
37
37
|
"audit:production": "bun audit --production",
|
|
38
38
|
"build:daemon": "bun build cli.ts --target=node --packages=external --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar.js",
|
|
39
|
-
"build:setup": "bun build src/setup-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-setup.js",
|
|
39
|
+
"build:setup": "bun build src/setup-cli.ts --target=node --external undici --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-setup.js",
|
|
40
40
|
"build:stop": "bun build src/stop-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-stop.js",
|
|
41
|
-
"build:update": "bun build src/update-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-update.js",
|
|
42
|
-
"build:version": "bun build src/version-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-version.js",
|
|
43
|
-
"build:agent": "bun build src/agent-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-agent.js",
|
|
44
|
-
"build:claude": "bun build src/claude-cli.ts --target=node --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-claude.js",
|
|
41
|
+
"build:update": "bun build src/update-cli.ts --target=node --external undici --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-update.js",
|
|
42
|
+
"build:version": "bun build src/version-cli.ts --target=node --external undici --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-version.js",
|
|
43
|
+
"build:agent": "bun build src/agent-cli.ts --target=node --external undici --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-agent.js",
|
|
44
|
+
"build:claude": "bun build src/claude-cli.ts --target=node --external undici --minify --banner='#!/usr/bin/env node' --outfile=dist/lodestar-claude.js",
|
|
45
45
|
"build": "bun run build:daemon && bun run build:setup && bun run build:stop && bun run build:update && bun run build:version && bun run build:agent && bun run build:claude && bun run build:dsh",
|
|
46
46
|
"prepublishOnly": "bun run ci",
|
|
47
47
|
"postinstall": "node scripts/postinstall.cjs",
|
|
@@ -70,7 +70,7 @@
|
|
|
70
70
|
"node": ">=22.19"
|
|
71
71
|
},
|
|
72
72
|
"dependencies": {
|
|
73
|
-
"@hono/node-server": "2.1.
|
|
73
|
+
"@hono/node-server": "2.1.8",
|
|
74
74
|
"@larksuiteoapi/node-sdk": "^1.73.0",
|
|
75
75
|
"@modelcontextprotocol/sdk": "1.32.1",
|
|
76
76
|
"@resvg/resvg-js": "^2.6.2",
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
"fast-uri": "3.1.9",
|
|
82
82
|
"fflate": "0.8.3",
|
|
83
83
|
"follow-redirects": "1.16.2",
|
|
84
|
-
"hono": "4.13.
|
|
84
|
+
"hono": "4.13.18",
|
|
85
85
|
"http-proxy-agent": "^7.0.2",
|
|
86
86
|
"https-proxy-agent": "^7.0.6",
|
|
87
87
|
"ip-address": "10.7.4",
|
|
@@ -97,13 +97,13 @@
|
|
|
97
97
|
"mathjax-full"
|
|
98
98
|
],
|
|
99
99
|
"overrides": {
|
|
100
|
-
"@hono/node-server": "2.1.
|
|
100
|
+
"@hono/node-server": "2.1.8",
|
|
101
101
|
"@modelcontextprotocol/sdk": "1.32.1",
|
|
102
102
|
"@xmldom/xmldom": "0.9.12",
|
|
103
103
|
"axios": "1.20.0",
|
|
104
104
|
"fast-uri": "3.1.9",
|
|
105
105
|
"fflate": "0.8.3",
|
|
106
|
-
"hono": "4.13.
|
|
106
|
+
"hono": "4.13.18",
|
|
107
107
|
"ip-address": "10.7.4",
|
|
108
108
|
"protobufjs": "7.6.5",
|
|
109
109
|
"proxy-addr": "2.0.8",
|