@leviyuan/lodestar 0.22.3 → 0.23.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/dist/dsh-bridge.js +2 -468
- package/dist/lodestar-agent.js +3 -42
- package/dist/lodestar-claude.js +3 -23
- package/dist/lodestar-setup.js +3 -49
- package/dist/lodestar-stop.js +2 -3
- package/dist/lodestar-update.js +3 -41
- package/dist/lodestar-version.js +3 -17
- package/dist/lodestar.js +3 -666
- package/docs/models.md +2 -2
- package/docs/release.md +1 -0
- package/docs/usage.md +6 -4
- package/package.json +5 -3
package/docs/models.md
CHANGED
|
@@ -48,7 +48,7 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
|
|
|
48
48
|
|
|
49
49
|
## 额度
|
|
50
50
|
|
|
51
|
-
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex
|
|
51
|
+
发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数(为 0 时省略),不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,模型专属周额度只写模型名,已用已知且距重置显示与总周相同时不重复(如 `周 100%/2.2d · Fable 47%`),已取消 5 小时限额的账号只显示周额度;Claude 订阅账号行末另显示到登录最早可能结束的倒计时,如 `凭据 23.2d`(见 [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,7 +97,7 @@ 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
|
|
100
|
+
`hi` 的每个 Claude 订阅账号行末显示登录凭据剩余时间。数据来自原生 `claude auth status --json` 的 `loginExpiresAt`(需 Claude Code 2.1.325 及以上),以该账号与会话相同的配置目录、进程环境和进程级设置读取,只在本机运行、不联网,也不读取钥匙串、凭据文件或令牌。这个时刻是登录的最晚到期时间,续期不会延后;原生 Claude Code 按实际最多提前 3 天结束来提示,因此只显示到最早可能结束(最晚到期前 3 天)的倒计时,格式与距重置相同,如 `凭据 23.2d`;显示不超过 7.0d(即距最晚到期 10 天以内,原生开始提醒)时为橙色。倒计时显示为小时或分钟时(剩余约不到 1 天)登录随时可能结束,标红,如 `凭据 21.6h`;已过最早结束时刻显示红色的 `凭据 可能已到期`,此时原生可能已结束登录,需要在本机重新登录。读取随该账号每 60 秒的后台额度刷新进行:距到期超过 10 天时最多每 5 分钟重读一次,更近、已过期或未知时每次都重读,重新登录后很快更新。超时、账号正在收录等临时失败沿用上次结果;原生输出无法识别(如版本不兼容)、没有结果或原生未提供日期时显示 `凭据 MISS`。账号未登录或额度查询失败时该行只显示 `MISS` 原因;回复底部不显示凭据时间。
|
|
101
101
|
|
|
102
102
|
订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi` 和回复底部共用该来源的账号与额度。
|
|
103
103
|
|
package/docs/release.md
CHANGED
|
@@ -23,6 +23,7 @@
|
|
|
23
23
|
|
|
24
24
|
- 打标签前先推送 `main` 并等 `CI` 工作流通过。它在 Linux 上跑全量测试、在 Windows 上跑更新流程用例,本机(macOS)全绿不代表这两处通过:Linux 会立刻复用刚删除目录的 inode,Windows 的文件时间与改名语义也不同。标签指向的提交若在 CI 才暴露问题,就得再发一个版本。
|
|
25
25
|
- `Production dependency audit` 或发布工作流的 `npm audit` 报出新公告时,先升级 `overrides` 中对应的安全依赖,运行 `bun scripts/sync-security-deps.ts` 并用 Bun 同步 `bun.lock`,`bun audit --production` 无告警后再发布;新公告与本次改动无关也会拦住发布。
|
|
26
|
+
- 自动安装的 Agent 运行目录由 `scripts/check-installed-package.ts` 按 `scripts/agent-audit.ts` 审计。公告的包在上游还没有修复版本、无法用 `overrides` / `agentRuntimeOverrides` 修掉时,只有经用户同意,才能在 `AGENT_AUDIT_EXCEPTIONS` 按 Agent、公告编号和包名临时豁免并写明原因与到期日。该包 npm latest 不再落在公告的受影响范围(上游出了修复;npm 把同一公告拆成多个受影响区间时逐段判定,任一段已有修复即拦截)或过了到期日,豁免自动失效、重新拦截,届时用 `agentRuntimeOverrides` 覆盖到修复版本并删除豁免。豁免期间验收日志打印 `⚠️ … 暂时豁免`,发版说明须写明;Lodestar 自身依赖的审计没有豁免。
|
|
26
27
|
|
|
27
28
|
- 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
|
|
28
29
|
- 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
|
package/docs/usage.md
CHANGED
|
@@ -31,6 +31,8 @@
|
|
|
31
31
|
|
|
32
32
|
模型列表来自各账号的模型目录,获取失败显示 `MISS`。同账号切换 Claude 或 DSH 模型从后续回复生效,Codex 的持久模型设置需重启会话生效;跨账号或后端切换只允许在空闲时进行。账号接入、模型补录与额度说明见[账号与模型](models.md)。
|
|
33
33
|
|
|
34
|
+
Claude Code 的模型被原生安全分类器拦下回复时(例如 Opus 5.5 把普通开发任务误判为网络安全类),Lodestar 会在群里另发一张「⚠️ 安全拦截」提醒卡,不混在回复卡里。原生改由降级模型接着回答时,卡片写明原模型、降级模型和拦截类别,本轮回复底部随即显示实际在答的模型;这种降级对整个会话持续有效,之后每一轮都用降级模型,发 `md` 重新选择原模型即可切回(下一轮生效),`restart` 也会按已保存的模型重新启动,再被拦截时会再次提醒;同一轮里降级模型又被拦截、再换一个模型时,更新原来那张提醒卡,不另发。只有子 Agent 或旁支提问的一次回复被降级时发黄色提醒,会话模型不变,同一轮同一对模型只提醒一次;没有降级模型、本轮被直接终止时同样提醒。卡片发不出去时改发同样内容的文字。
|
|
35
|
+
|
|
34
36
|
`restart` 和 `clear` 在状态卡上显示进度;重启过程出错时,状态卡以 `❌ 重启失败: <原因>` 或 `❌ 清空失败: <原因>` 结束。Claude 会话的历史列表按最后修改时间倒序,最多显示最新的 40 个会话。
|
|
35
37
|
|
|
36
38
|
`compact`(`cm`)在状态卡上显示结果:完成显示 `✅ 上下文已压缩`,能读取时附压缩后的上下文用量;无需压缩时显示 ⓘ 和原因;失败显示 `❌ 上下文压缩失败` 和原因,Claude 原生返回的取消、跳过或失败说明原样显示。压缩没有时间上限,期间本群的普通消息排队,压缩结束后依次处理。压缩期间发送 `stop`、`kill`、`restart`、`clear`(或其缩写)会立即中断压缩,状态卡显示 `🛑 上下文压缩已取消`,随后照常执行该命令;其中 `kill`、`restart`、`clear` 在后端 10 秒内未响应中断时强制结束进程,`stop` 只中断。
|
|
@@ -79,9 +81,9 @@ Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会
|
|
|
79
81
|
|
|
80
82
|
账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文先显示“邮箱:…”,再按接口实际返回显示周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
|
|
81
83
|
|
|
82
|
-
`hi`
|
|
84
|
+
`hi` 的额度区紧凑展示全部账号,一账号一行,各来源同一套写法:`账号 项 · 项`,如 `Claude·默认 周 100%/2.2d · Fable 47% · 凭据 23.2d`。额度窗口写作“名称 已用%/距重置”,距重置统一为分钟(`45m`)或一位小数的小时、天(`4.1h`、`2.2d`);整个窗口都未知时只写一次 `MISS`(如 `5h MISS`)。模型专属周额度只写模型名(`Fable`、`Opus`、`Sonnet`、`OAuth`),已用已知且距重置显示与总周相同时不再重复距重置,不同或未知时照写。百分比与凭据的颜色只看显示值,同一文案颜色不变(如显示 `80%` 即橙色、`100%` 即红色)。单账号来源只写短名(`GLM`、`DeepSeek`),多账号来源写“来源·备注”;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,同样为 0 时省略、未知显示 MISS;GLM 月工具只显示百分比,不显示次数与重置时间;余额与额度的金额符号紧贴数字(`余额 ¥12.34`),令牌额度写明剩余与上限(`剩余 $3.00 / $10.00`),与回复 footer 一致。Claude 订阅账号行末显示到登录最早可能结束的倒计时,如 `凭据 23.2d`,格式同距重置;不超过 7.0d(原生开始提醒)橙色,倒计时显示为小时或分钟时标红,已过最早结束时刻显示红色的 `凭据 可能已到期`,规则见[账号与模型](models.md#claude-code-订阅)。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注,账号尚未确定时省略该备注,自动换号后再次查看会显示新账号;待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口,不展示 Spark、gpt-reserve 等附加额度;footer 只显示当前实际使用账号,footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式并在其后追加消费积分,自动换号后跟随新账号;已结束回复始终显示该回复所属账号的积分。重置卡次数出现在 `hi` 和 `codex-reset` 回执中。
|
|
83
85
|
|
|
84
|
-
活跃项目的每个会话在状态后面紧接着显示仍在运行的子 Agent 和后台进程数,写法与运行任务卡的群列表预览相同,例如 `闲 · 子Agent2·后台1`:「闲」只表示主对话空着,可以接新消息,后台的命令和子 Agent 仍在工作。没有后台工作的会话不追加任何内容。子 Agent 包括前台和后台运行的原生子 Agent;后台进程是 Claude Code 的后台命令、Monitor、工作流等后台任务(不含 Claude Code 自身的内务任务)或 Codex 仍在运行的后台终端。数量只在发送 `hi` 时读取一次;无法读取后台进程时显示 `后台MISS
|
|
86
|
+
活跃项目的每个会话在状态后面紧接着显示仍在运行的子 Agent 和后台进程数,写法与运行任务卡的群列表预览相同,例如 `闲 · 子Agent2·后台1`:「闲」只表示主对话空着,可以接新消息,后台的命令和子 Agent 仍在工作。没有后台工作的会话不追加任何内容。子 Agent 包括前台和后台运行的原生子 Agent;后台进程是 Claude Code 的后台命令、Monitor、工作流等后台任务(不含 Claude Code 自身的内务任务)或 Codex 仍在运行的后台终端。数量只在发送 `hi` 时读取一次;无法读取后台进程时显示 `后台MISS`,不当作没有。每行依次是项目名(当前群的项目紧跟「当前」)、状态、后台计数、运行时长和实际使用的账号,例如 ``⚙️ `feishu` · 当前 · 工作中 · 子Agent2·后台1 · 2.1h · Claude·默认``;运行时长与额度倒计时同一写法(`8s`、`40m`、`2.1h`、`3.0d`),账号写法与额度区的行名相同。活跃项目与主机面板默认折叠,标题上直接显示要处理的情况:活跃项目附等审批、工作中的数量(如 `🗂 活跃项目 (5) · 等审批 1 · 工作中 2`),主机附挂掉的服务数(如 `🖥 主机 · L2.46 · M63% · S3 · ❌1`)。
|
|
85
87
|
|
|
86
88
|
## 独立工作区
|
|
87
89
|
|
|
@@ -96,7 +98,7 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
|
|
|
96
98
|
|
|
97
99
|
已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群和该分支下的临时群都没有运行中的会话、工作区没有未提交变更,先解散这些临时群,再解散群并删除 worktree;Git 分支保留。
|
|
98
100
|
|
|
99
|
-
|
|
101
|
+
WT 群与临时群按同一规则决定是内部群还是外部群:在内部群里由本企业成员建的 WT 群仍由机器人当群主;在外部群里建的 WT 群是外部群,由发起人自己当群主,之后外部联系人也能用 `wt <名称>` 加入。外部联系人也能用 `wt <名称>` 新建或加入分支群:新建时由当前群的群主当群主(要求同下文的临时群),群主不合格或群类型读取失败时在创建 worktree 和分支之前就报错,不留下半成品;加入已存在的同名 WT 群不需要群主,但内部 WT 群外部联系人进不去(群类型建好后不能再改)。外部 WT 群机器人不能解散:在 `wt` 列表里删除时,机器人退出该群并照常删除目录,群留给群主手动解散。
|
|
100
102
|
|
|
101
103
|
## 临时会话与对话分支
|
|
102
104
|
|
|
@@ -112,7 +114,7 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
|
|
|
112
114
|
|
|
113
115
|
`btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态,一次操作只有一张卡、在卡内原地更新。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。发送 `btwlist`(别名 `bl`)可按创建时间倒序查看本机登记的全部临时会话;它只读本地租约、已加载会话和运行中会话的本机进程状态,不会联网刷新群列表。子 Agent 与后台进程数的含义与 `hi` 活跃项目相同。
|
|
114
116
|
|
|
115
|
-
外部联系人(其他飞书企业的用户)也能在外部群里发 `btw` 或用 `fk` 分叉。前提是应用在「对外共享」中开启「允许外部用户与机器人单聊」,每位外部联系人先点开机器人发起一次单聊并确认。机器人不能当外部群的群主,所以新临时群由当前群的群主当群主,成员是发起人和群主:当前群的群主必须是本企业成员(不能是机器人或发起人本人)且在应用的「可用范围」内,外部联系人还须是群主的飞书联系人;群主不符合时直接报错,不建群。建群被飞书以「看不到成员」拒绝时,提示卡按被拒的成员说明处理办法:发起人须先单聊确认,群主须加入应用的可用范围。带备注的 `btw`
|
|
117
|
+
外部联系人(其他飞书企业的用户)也能在外部群里发 `btw` 或用 `fk` 分叉。前提是应用在「对外共享」中开启「允许外部用户与机器人单聊」,每位外部联系人先点开机器人发起一次单聊并确认。机器人不能当外部群的群主,所以新临时群由当前群的群主当群主,成员是发起人和群主:当前群的群主必须是本企业成员(不能是机器人或发起人本人)且在应用的「可用范围」内,外部联系人还须是群主的飞书联系人;群主不符合时直接报错,不建群。建群被飞书以「看不到成员」拒绝时,提示卡按被拒的成员说明处理办法:发起人须先单聊确认,群主须加入应用的可用范围。带备注的 `btw` 遇到已存在的同名群时直接加入,不需要群主;外部联系人不能加入内部群,同名群是内部群时会提示换一个备注新建。本企业成员在外部群里发 `btw`、用 `fk` 分叉时,新临时群同样建成外部群,由发起人自己当群主,之后外部联系人也能加入(`bye` 同样只让机器人退群,由群主手动解散);在内部群里发起的仍由机器人当群主。群的内外类型建好后就不能再改:之前在外部群里由本企业成员建出的内部临时群,外部联系人仍然进不去。机器人不能解散外部群,也不能移出其中的成员:在外部临时群里,任何成员发 `bye` 都会停止会话并让机器人退群,群本身保留,提示卡会请群主在群设置里手动解散;机器人退群后若本地清理出错,报错发到发起临时群的来源群。新群启动失败的清理和 `wt` 删除分支时也只让机器人退出外部临时群。临时群的报错保留飞书错误码和 log_id,不显示成员 ID。
|
|
116
118
|
|
|
117
119
|
`fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
|
|
118
120
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@leviyuan/lodestar",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.23.1",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -42,10 +42,11 @@
|
|
|
42
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
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
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
|
-
"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",
|
|
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 && bun run build:obfuscate",
|
|
46
46
|
"prepublishOnly": "bun run ci",
|
|
47
47
|
"postinstall": "node scripts/postinstall.cjs",
|
|
48
|
-
"build:dsh": "bun build src/dsh-bridge.ts --target=node --packages=external --outfile=dist/dsh-bridge.js"
|
|
48
|
+
"build:dsh": "bun build src/dsh-bridge.ts --target=node --packages=external --minify --outfile=dist/dsh-bridge.js",
|
|
49
|
+
"build:obfuscate": "node scripts/obfuscate-dist.mjs"
|
|
49
50
|
},
|
|
50
51
|
"bin": {
|
|
51
52
|
"lodestar-daemon": "./dist/lodestar.js",
|
|
@@ -353,6 +354,7 @@
|
|
|
353
354
|
"@types/bun": "1.3.14",
|
|
354
355
|
"@types/cross-spawn": "6.0.6",
|
|
355
356
|
"@types/node": "18",
|
|
357
|
+
"javascript-obfuscator": "5.10.1",
|
|
356
358
|
"typescript": "5.9.3"
|
|
357
359
|
},
|
|
358
360
|
"trustedDependencies": [
|