@leviyuan/lodestar 0.22.1 → 0.22.3
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/lodestar-setup.js +24 -24
- package/dist/lodestar.js +267 -263
- package/docs/feishu-permissions.json +1 -0
- package/docs/models.md +3 -1
- package/docs/usage.md +14 -4
- package/package.json +1 -1
package/docs/models.md
CHANGED
|
@@ -48,7 +48,7 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
|
|
|
48
48
|
|
|
49
49
|
## 额度
|
|
50
50
|
|
|
51
|
-
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
51
|
+
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;Claude 订阅账号行末另显示登录凭据剩余天数,如 `凭据 24–27d`(见 [Claude Code 订阅](#claude-code-订阅));GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
|
|
52
52
|
|
|
53
53
|
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存,刷新周期见[选择与管理模型](#选择与管理模型)。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
54
54
|
|
|
@@ -97,6 +97,8 @@ lodestar-claude 工作号 auth login
|
|
|
97
97
|
|
|
98
98
|
订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时;已取消 5 小时限额的账号只显示周额度,不显示 5h 的 `MISS`。回复底部同样只显示实际存在的窗口:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,没有 5 小时窗口时省略该段,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
|
|
99
99
|
|
|
100
|
+
`hi` 的每个 Claude 订阅账号行末显示登录凭据剩余时间。数据来自原生 `claude auth status --json` 的 `loginExpiresAt`(需 Claude Code 2.1.325 及以上),以该账号与会话相同的配置目录、进程环境和进程级设置读取,只在本机运行、不联网,也不读取钥匙串、凭据文件或令牌。这个时刻是登录的最晚到期时间,续期不会延后;原生 Claude Code 按实际最多提前 3 天结束来提示,因此按整天显示区间,如 `凭据 24–27d`;显示的上限不超过 10 天(原生开始提醒)时为橙色。最早到期已不足 1 天时登录随时可能结束,只显示上限并标红,如 `凭据 ≤2.4d`;已过该时刻显示红色的 `凭据 可能已到期`,此时原生多半已结束登录,需要在本机重新登录。读取随该账号每 60 秒的后台额度刷新进行:距到期超过 10 天时最多每 5 分钟重读一次,更近、已过期或未知时每次都重读,重新登录后很快更新。超时、账号正在收录等临时失败沿用上次结果;原生输出无法识别(如版本不兼容)、没有结果或原生未提供日期时显示 `凭据 MISS`。账号未登录或额度查询失败时该行只显示 `MISS` 原因;回复底部不显示凭据时间。
|
|
101
|
+
|
|
100
102
|
订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi` 和回复底部共用该来源的账号与额度。
|
|
101
103
|
|
|
102
104
|
旧版“Claude”本机配置入口已移除;使用该入口的用户升级后请通过 `md` 选择“Claude Code 订阅”及模型。
|
package/docs/usage.md
CHANGED
|
@@ -37,6 +37,10 @@
|
|
|
37
37
|
|
|
38
38
|
Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方向,无需等待整轮回复结束。消息会交给正在运行的任务,在后端下一次可接收输入时生效;Agent 实际收入补充消息后,按原生执行记录中的连续输入区段切换到新卡,顶部「📥 追加」列出整批补充内容。中间没有 Agent 思考、回复或工具执行的连续补充会合并在一张卡里。在此之前的输出仍留在旧卡,之后的输出进入新卡,运行中的工具随卡接续;新卡发送成功时一并撤销本批消息的等待表情,旧卡标记已续至下一张,任务继续执行。Claude 的兼容来源(GLM、DeepSeek、OpenRouter 等)沿用这一行为。消息恰好赶上回合结束时会接着处理;进程仍在启动或恢复时暂存,提交失败会明确提示。`stop` 同时取消尚未处理的追加消息。DeepSeek Harness 仍按下一轮批次处理执行中收到的消息。
|
|
39
39
|
|
|
40
|
+
## 单聊
|
|
41
|
+
|
|
42
|
+
单聊不对应任何项目:给机器人发任何单聊消息,都只回一张只读的 Lodestar 面板,不建会话、不保存状态、不启动 Agent,也没有按钮,所有操作仍在项目群里进行(发 `hi`、`btw` 等)。面板只列你看得到的运行中项目:你所在群的会话,以及你当群主的项目群和它的关联群(`<群名>*…` 临时群、`<群名>[…]` WT 群及其临时群)。群主身份只认项目已保存绑定的那个群:另建一个同名的群、群名换算成项目名后撞名(如 `foo bar` 与 `foo.bar`),或项目群改名后再用旧名建群,都不会看到别人的项目。群主和成员关系在每次发消息时实时查询,不保存;查询失败或 20 秒内没读完时隐藏受影响的项目,并在面板上提示「部分项目读取失败,已隐藏」;群已解散或机器人已不在群里时直接不显示,不提示。本企业成员还能看到账号名、主机信息和全部账号额度;外部联系人(其他飞书企业的用户),以及无法确认所属企业的发送者,只看到项目名、状态、运行时长和子 Agent/后台进程数。接收单聊消息需要应用开通「获取用户发给机器人的单聊消息」(`im:message.p2p_msg:readonly`)并发布版本;外部联系人还需要应用在「对外共享」中开启「允许外部用户与机器人单聊」。
|
|
43
|
+
|
|
40
44
|
## Codex 设备码登录与多账号
|
|
41
45
|
|
|
42
46
|
默认账号沿用设备上直接执行 `codex` 的登录态:使用 daemon 原始环境中的 `CODEX_HOME`,未设置时为 `~/.codex`。`codex-account` 只改变当前群后续 Codex 进程的认证选择,不覆盖默认账号,也不改变其他群。额外账号的备注名可包含中文和空格,不能包含换行或路径分隔符;`default`、`默认` 为保留名称。
|
|
@@ -75,7 +79,9 @@ Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会
|
|
|
75
79
|
|
|
76
80
|
账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文先显示“邮箱:…”,再按接口实际返回显示周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
|
|
77
81
|
|
|
78
|
-
`hi` 的额度区紧凑展示全部账号,一账号一行;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,GLM
|
|
82
|
+
`hi` 的额度区紧凑展示全部账号,一账号一行;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,GLM 月工具只显示百分比,不显示次数与重置时间。Claude 订阅账号行末显示登录凭据剩余天数,如 `凭据 24–27d`,上限 10 天内橙色,随时可能到期(`凭据 ≤2.4d`)或已过期红色,规则见[账号与模型](models.md#claude-code-订阅)。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注,账号尚未确定时省略该备注,自动换号后再次查看会显示新账号;待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口,不展示 Spark、gpt-reserve 等附加额度;footer 只显示当前实际使用账号,footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式并在其后追加消费积分,自动换号后跟随新账号;已结束回复始终显示该回复所属账号的积分。重置卡次数出现在 `hi` 和 `codex-reset` 回执中。
|
|
83
|
+
|
|
84
|
+
活跃项目的每个会话在状态后面紧接着显示仍在运行的子 Agent 和后台进程数,写法与运行任务卡的群列表预览相同,例如 `闲 · 子Agent2·后台1`:「闲」只表示主对话空着,可以接新消息,后台的命令和子 Agent 仍在工作。没有后台工作的会话不追加任何内容。子 Agent 包括前台和后台运行的原生子 Agent;后台进程是 Claude Code 的后台命令、Monitor、工作流等后台任务(不含 Claude Code 自身的内务任务)或 Codex 仍在运行的后台终端。数量只在发送 `hi` 时读取一次;无法读取后台进程时显示 `后台MISS`,不当作没有。
|
|
79
85
|
|
|
80
86
|
## 独立工作区
|
|
81
87
|
|
|
@@ -90,6 +96,8 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
|
|
|
90
96
|
|
|
91
97
|
已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群和该分支下的临时群都没有运行中的会话、工作区没有未提交变更,先解散这些临时群,再解散群并删除 worktree;Git 分支保留。
|
|
92
98
|
|
|
99
|
+
外部联系人(其他飞书企业的用户)暂不能用 `wt <名称>` 创建或加入分支群:WT 群由机器人当群主,而飞书要求外部群由本企业成员当群主。命令会在创建 worktree 和分支之前直接提示请本企业成员操作;不带参数的 `wt` 列表不受影响。
|
|
100
|
+
|
|
93
101
|
## 临时会话与对话分支
|
|
94
102
|
|
|
95
103
|
临时会话共享当前工作目录,适合在同一项目里另开一段对话:
|
|
@@ -97,12 +105,14 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
|
|
|
97
105
|
| 完整指令 | 缩写 / 别名 | 行为 |
|
|
98
106
|
| --- | --- | --- |
|
|
99
107
|
| `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀,同一个备注对应同一个群。基名跟随当前群:主群是 `<项目>`,WT 群是 `<项目>[分支]`。继承账号、模型并共享该目录配置,启动新会话 |
|
|
100
|
-
| `btwlist` | `bl` |
|
|
108
|
+
| `btwlist` | `bl` | 列出本机登记的全部临时会话:群名、所属项目、创建时间、模型和当前运行状态(运行中的会话附带子 Agent 与后台进程数,如 `🟢 空闲 · 子Agent2·后台1`);当前群会标「本群」 |
|
|
101
109
|
| `fork` | `fk` | 选择一条用户输入,在临时群里从这条输入之前分叉 |
|
|
102
110
|
| `back` | `bk` | 选择一条用户输入,让本群接到这条输入之前的新分支 |
|
|
103
|
-
| `bye` | — |
|
|
111
|
+
| `bye` | — | 自己退出临时群;最后一个人退出时停止会话并解散整个群。外部群改为停止会话、机器人退群,由群主手动解散 |
|
|
112
|
+
|
|
113
|
+
`btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态,一次操作只有一张卡、在卡内原地更新。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。发送 `btwlist`(别名 `bl`)可按创建时间倒序查看本机登记的全部临时会话;它只读本地租约、已加载会话和运行中会话的本机进程状态,不会联网刷新群列表。子 Agent 与后台进程数的含义与 `hi` 活跃项目相同。
|
|
104
114
|
|
|
105
|
-
`btw`
|
|
115
|
+
外部联系人(其他飞书企业的用户)也能在外部群里发 `btw` 或用 `fk` 分叉。前提是应用在「对外共享」中开启「允许外部用户与机器人单聊」,每位外部联系人先点开机器人发起一次单聊并确认。机器人不能当外部群的群主,所以新临时群由当前群的群主当群主,成员是发起人和群主:当前群的群主必须是本企业成员(不能是机器人或发起人本人)且在应用的「可用范围」内,外部联系人还须是群主的飞书联系人;群主不符合时直接报错,不建群。建群被飞书以「看不到成员」拒绝时,提示卡按被拒的成员说明处理办法:发起人须先单聊确认,群主须加入应用的可用范围。带备注的 `btw` 遇到已存在的同名群时直接加入,不需要群主;外部联系人不能加入内部群,同名群是内部群时会提示换一个备注新建。本企业成员发起的临时群照旧由机器人当群主。机器人不能解散外部群,也不能移出其中的成员:在外部临时群里,任何成员发 `bye` 都会停止会话并让机器人退群,群本身保留,提示卡会请群主在群设置里手动解散;机器人退群后若本地清理出错,报错发到发起临时群的来源群。新群启动失败的清理和 `wt` 删除分支时也只让机器人退出外部临时群。临时群的报错保留飞书错误码和 log_id,不显示成员 ID。
|
|
106
116
|
|
|
107
117
|
`fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
|
|
108
118
|
|