@leviyuan/lodestar 0.21.28 → 0.21.31

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
@@ -10,6 +10,7 @@ README 保留项目哲学、项目介绍、最短快速开始、常用指令表
10
10
  - `usage.md`:群内命令、会话、worktree、文件与生图、本机通知。
11
11
  - `models.md`:账号、模型与 effort、OpenRouter 默认列表、DSH 与 GLM 接入。
12
12
  - `claude-agent-backend.md`:后端实现、模型路由和会话行为。
13
+ - `release.md`:发版步骤、工作流入口、凭据位置和常见坑(本机不 publish)。
13
14
 
14
15
  - 保留 Codex、Claude Code 订阅、GLM、DeepSeek、OpenRouter、通用中转站和 DeepSeek Harness 的支持说明。
15
16
  - 只写已实现的行为。删除失效接口、历史方案、重复规则和无法复现的验证结论;不另建产品规范或计划。
@@ -44,9 +44,9 @@ Claude 订阅统一由 `claude-sub` 管理登录验证、模型目录和额度
44
44
 
45
45
  `session-activity.ts` 按实际存活的 Claude 订阅进程与账号绑定统计会话:执行中或最近 30 分钟收到用户消息即为活跃,启动、等待回答、排队和后台任务也计入;同群去重,当前待启动群排除后再加一。消息时间持久化,重启后可恢复近期活跃判断,不保存消息内容。
46
46
 
47
- `claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口为 10 份,Fable 总周为 5 份、专属周为 10 份。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数,真实耗尽账号不参与正常选号。
47
+ `claude-quota.ts` 以完整 5h 额度为一份,所有账号统一:普通完整周窗口为 10 份,Fable 总周为 5 份、专属周为 10 份。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已经取消 5 小时限额,按周额度单窗口处理,不补 0%、不补窗口时间,也不显示 `MISS`;`limits[]` 明确列出 `session` 时仍按缺值 `MISS`。5h、总周及实际返回的 OAuth、当前模型专属窗口均参与约束;缺值、重复、无效或过期重置时间均为 `MISS`,Fable 缺少唯一专属周也不参与选号。账号余量取这些窗口中最小的剩余份数,真实耗尽账号不参与正常选号。
48
48
 
49
- 令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份),账号余量为 `R` 份,则每会话份额为 `R / (N+1)`。份额最大的账号先接新任务,每接一个任务该账号的份额就下降,任务因此按各账号真实余额比例分散。这里不预测任务用量、不按重置时间分段、不设 `fits`/`pressure` 或临期优先;份额相同时依次按活跃会话数升序、余量降序、5h 余量降序及默认/收录顺序排序。计算不改真实额度,显式指定账号不经过这套自动排序。
49
+ 令已有活跃负载单位为 `N`(每个活跃会话算一份,会话里运行中的原生子 Agent 每个再算一份),账号余量为 `R` 份,则每会话份额为 `R / (N+1)`。能安排任务的 5h 账号整组优先:窗口额度不能结转,不在这里花掉,该账号的周额度就用不完。5h 组内仍按份额分摊,避免并发任务都压在同一个受限窗口上,其余同分时先接更早重置的 5h 窗口。没有 5h 限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、活跃会话数升序、余量降序、5h 余量降序破同分。这里不预测任务用量、不按重置时间分段,也不设 `fits`/`pressure`;计算不改真实额度,显式指定账号不经过这套自动排序。
50
50
 
51
51
  各账号共享默认目录下的 `projects`、`tasks`、`file-history`、`plans`,凭据与账号设置各自独立。`claude-session-lease.ts` 按共享历史真实路径和原生 session ID 管理 daemon 内的写入互斥:新会话和分叉先分配原生 UUID,恢复沿用原 ID,分叉在原生初始化完成前还保护源会话。只有确认原生进程退出才释放写入权;纯账号/模型/额度控制查询不取得写入权,不允许提交用户任务。历史路径按实际 cwd 归一化,兼容长路径编码及原生项目目录名覆盖。
52
52
 
@@ -60,7 +60,7 @@ OpenRouter 保持自己的精选模型规则。通用中转站只按站点协议
60
60
 
61
61
  `md` 等待模型目录刷新完成后生成账号卡。刷新开始会清空能力数据,不能先取此时的空数组生成“0 个模型”卡片;失败状态显示 `MISS`,用户明确清空的就绪列表才显示零项。面板记录实际 `message_id`,在模型列表、添加目录和分页间保持一致。
62
62
 
63
- 活跃、续卡和结束 footer 的模型标识共用 `footerModelLabel`,固定为 `agent · 模型名/effort`,Agent id 小写,模型名剥除 `claude:`、`[1m]`;模型或 effort 缺失时显示对应的 `MISS`。footer 的窗口额度保留原格式 `4.1h·7%·[6.9d·17%]`,即重置倒计时与已用百分比,周窗口放在方括号中;不添加“额度 5h 已用”等标签或月度工具明细。结构化余额通过 `unifiedUsageSummary` 显示 `余额 $…` / `余额 ¥…`,控制台仍可展示完整窗口明细。失败明确显示 MISS。
63
+ 活跃、续卡和结束 footer 的模型标识共用 `footerModelLabel`,固定为 `agent · 模型名/effort`,Agent id 小写,模型名剥除 `claude:`、`[1m]`;模型或 effort 缺失时显示对应的 `MISS`。footer 的窗口额度保留原格式 `4.1h·7%·[6.9d·17%]`,即重置倒计时与已用百分比,周窗口放在方括号中;Claude 订阅账号没有 5h 窗口时省略该段,只显示 `[6.9d·17%]`,不补 `MISS`。不添加“额度 5h 已用”等标签或月度工具明细。结构化余额通过 `unifiedUsageSummary` 显示 `余额 $…` / `余额 ¥…`,控制台仍可展示完整窗口明细。失败明确显示 MISS。
64
64
 
65
65
  `[claude.models.<name>].model` 保留旧 `claude:<name>` 路由的解析。账号、显示名和模型目录由 Token Source 管理;Claude 槽位映射使用账号的 `slots`。
66
66
 
@@ -111,7 +111,7 @@ Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TO
111
111
 
112
112
  ## DeepSeek Harness 原生后端
113
113
 
114
- `DshProcess` 使用当前安装的运行目录启动 Node DSH 子进程,以 `sdk` profile 加载 `dsh-bridge` Cordis 插件,替换默认 SDK JSON-RPC server。Lodestar 的 stdio 协议只承载控制和事件;Agent 循环、工具执行、持久化及子 Agent 由 DSH 管理。
114
+ `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 管理。
115
115
 
116
116
  Agent 运行依赖由 `src/agent-updates.ts` 独立安装,daemon 启动时不检查或更新。自动更新默认关闭;手动运行 `lodestar-update --agents-only`,或在 `[runtime.agent_auto_update]` 中分别开启 `codex`、`claude`、`dsh` 后,各自每 6 小时检查 upstream latest。安装成功直接启用,旧任务继续使用各自目录。更新失败不修改当前安装记录,只记更新日志并向更新调用方返回失败;已有安装照常供新任务使用,已开启自动更新的 Agent 下个 6 小时周期再试。启动和版本查询不显示历史更新错误;没有可用安装记录或安装损坏仍报错。DSH 子包的 dist-tag 可能不同步,因此从主包最新版本递归读取 dependencies/peerDependencies/optionalDependencies,整族安装该次动态选中的版本。不存在兼容版本白名单;不兼容直接报告并后续适配。`dsh-bridge` 被放入选中运行目录,从同一依赖树加载,握手版本来自实际 package.json。开发依赖和 Bun 锁文件只是本地测试快照,不限制生产更新。普通安全 overrides 同时用于独立运行目录,tarball 验收真实执行更新器、包审计和原生查询。
117
117
 
package/docs/models.md CHANGED
@@ -48,11 +48,11 @@ OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点
48
48
 
49
49
  ## 额度
50
50
 
51
- 发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅保留主窗口和模型专属周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
51
+ 发送 `hi` 查看全部已配置账号的额度,一账号一行。Codex 按备注展示主额度窗口及“重置”次数,不展示 Spark、gpt-reserve;Claude 订阅保留主窗口和模型专属周额度,已取消 5 小时限额的账号只显示周额度;GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一行。
52
52
 
53
53
  所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存。Codex 订阅模型目录和额度均每 2 小时主动刷新,其他来源仍为 5 分钟和 60 秒;普通交互只读已提交缓存,手动打开模型列表允许立即额外查询,同账号并发刷新合并。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。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%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;余额显示 `余额 $12.34` 或 `余额 ¥12.34`。Codex 刷新失败或进程已退出时,回复底部按原格式保留同账号上次成功的额度。没有成功缓存、登录认证失败或缓存已被重新登录、删除账号、额度重置操作清除时显示 `MISS`。Codex 的 `hi`、`codex-accounts` 额度区域在网络或限流导致刷新失败时也保留成功缓存,账号列表仍展示本次调度失败原因。
55
+ 回复底部显示 `agent · 模型名/effort`,其中 Agent 为 `claude`、`codex` 或 `dsh`。窗口额度如 `4.1h·7%·[6.9d·17%]`,分别表示重置倒计时与已用百分比,方括号内为周窗口;Claude 订阅账号已取消 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,13 +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%`),重置时间须有效且尚未到期。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已明确耗尽,自动启动回退到设备默认账号;恢复已有会话且该会话原来的账号也在耗尽账号中时,优先沿用原账号。默认账号尚未登录、又不是恢复原账号时,改用第一个通过同样校验的耗尽账号,不因自动选号失败阻断启动或 `rs` 恢复。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
76
+ 不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已明确耗尽,自动启动回退到设备默认账号;恢复已有会话且该会话原来的账号也在耗尽账号中时,优先沿用原账号。默认账号尚未登录、又不是恢复原账号时,改用第一个通过同样校验的耗尽账号,不因自动选号失败阻断启动或 `rs` 恢复。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
77
77
 
78
- 所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10 份。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数。缺少 Fable 专属窗口时按 `MISS` 排除,其他模型专属仅兼容接口实际返回的窗口。
78
+ 所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口算 10 份。Fable 的总周算 5 份、专属周算 10 份。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。缺少 Fable 专属窗口时按 `MISS` 排除,其他模型专属仅兼容接口实际返回的窗口。
79
79
 
80
- 选号把任务按各账号的真实余量分散,不预测单个任务的用量。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把账号余量除以“活跃负载单位 + 1”,份额最大的账号先接;同一账号每接一个任务份额就下降,任务因此按余额比例摊到多个账号,任务之间的实际用量差异不进入公式。
80
+ 选号先看能否在 5 小时窗口里安排任务,再按余量分散,不预测单个任务的用量。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把账号余量除以“活跃负载单位 + 1”,作为该账号的份额。
81
81
 
82
- 选择只看真实余额和当前会话数:不按重置时间分段、不预留未来用量,也不设“预计是否装得下”的门槛或临期优先。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按上一条规则回退。份额相同时依次优先活跃会话更少、余量更多、5h 余量更多,最后保持默认账号及收录顺序。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
82
+ 能安排任务的 5h 账号整组优先:5 小时窗口的额度不能结转,不在窗口里花掉,该账号的周额度就用不完。5h 组内按份额从高到低接任务,份额相同时先接更早重置的 5 小时窗口。没有 5 小时限额的账号只剩周额度,按该模型实际生效的周额度重置时间升序,先接最快到期作废的那一份;到期时间相同再按份额、余量、5h 余量排序。
83
+
84
+ 选择只看真实余额、到期时间和当前会话数:不按重置时间分段、不预留未来用量,也不设“预计是否装得下”的门槛。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按上一条规则回退。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
83
85
 
84
86
  首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
85
87
 
@@ -93,7 +95,7 @@ lodestar-claude 工作号 auth login
93
95
 
94
96
  账号和模型目录通过 Claude Code 原生 SDK 查询,模型与 effort 随目录更新;未登录会显示启用引导,查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`,支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用,`enabled = true` 或省略时沿用本机登录检测;群命令更新该字段。
95
97
 
96
- 订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时。回复底部同时显示 5 小时额度与周额度:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
98
+ 订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时;已取消 5 小时限额的账号只显示周额度,不显示 5h 的 `MISS`。回复底部同样只显示实际存在的窗口:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,没有 5 小时窗口时省略该段,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
97
99
 
98
100
  订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi` 和回复底部共用该来源的账号与额度。
99
101
 
@@ -0,0 +1,27 @@
1
+ # 发布
2
+
3
+ 发布包由 GitHub Actions 的 `发布版本` 工作流(`.github/workflows/release.yml`)发布。本机没有仓库令牌,`secrets.NPM_TOKEN` 与 `secrets.GH_PACKAGES_TOKEN` 只存在于仓库 Secrets,因此**不要在本机执行 `npm publish`**,也不要为此改发布脚本。
4
+
5
+ ## 步骤
6
+
7
+ 1. 升版本:只改 `package.json` 的 `version`(未指定 minor/major 时只升 patch),例如 `0.21.31`。
8
+ 2. 本地检查:`bun run typecheck`、`bun test`、`bun run build`、`bun scripts/sync-security-deps.ts --check`。
9
+ 3. 提交并推送 `main`(远端名为 `github`):`git push github main`。
10
+ 4. 打并推送标签:`git tag v0.21.31 && git push github v0.21.31`。标签必须与 `version` 一致,且指向要发布的提交(工作流会校验)。
11
+ 5. 触发工作流:`gh workflow run release.yml -f tag=v0.21.31`。
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。
14
+ 7. 发布成功后建 GitHub Release(标题、功能说明和验证结果用中文):
15
+
16
+ ```bash
17
+ gh release create v0.21.31 --title "v0.21.31 <中文摘要>" --notes-file /tmp/notes.md
18
+ ```
19
+
20
+ 同一版本必须同时发布 npm 与 GitHub Packages,并推送 `main` 与 tag。
21
+
22
+ ## 常见坑
23
+
24
+ - 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
25
+ - 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
26
+ - 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
27
+ - `scripts/publish-verified-package.mjs` 只接受 `npm pack --json` 生成的清单(含 `name`、`version`、`filename`、`integrity`),并在 `NODE_AUTH_TOKEN` 缺失时直接拒绝发布。
package/docs/usage.md CHANGED
@@ -84,7 +84,7 @@ Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会
84
84
 
85
85
  WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW/FK 始终共享来源目录的这些配置,包括从 WT 创建的临时群。文件交付统一按大小自动选择,云空间目录各群独立。任务清单属于项目级,主群、所有 WT 及其临时群共用。临时群的模型、账号在创建时继承,之后各自切换、互不影响。
86
86
 
87
- 已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群没有运行中的会话、工作区没有未提交变更,再解散群并删除 worktree;Git 分支保留。
87
+ 已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群和该分支下的临时群都没有运行中的会话、工作区没有未提交变更,先解散这些临时群,再解散群并删除 worktree;Git 分支保留。
88
88
 
89
89
  ## 临时会话与对话分支
90
90
 
@@ -92,12 +92,12 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
92
92
 
93
93
  | 完整指令 | 缩写 / 别名 | 行为 |
94
94
  | --- | --- | --- |
95
- | `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀。继承账号、模型并共享原工作目录配置,启动新会话 |
95
+ | `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀,同一个备注对应同一个群。基名跟随当前群:主群是 `<项目>`,WT 群是 `<项目>[分支]`。继承账号、模型并共享该目录配置,启动新会话 |
96
96
  | `fork` | `fk` | 选择一条用户输入,在临时群里从这条输入之前分叉 |
97
97
  | `back` | `bk` | 选择一条用户输入,让本群接到这条输入之前的新分支 |
98
- | `bye` | — | 停止并解散当前临时群,仅适用于 Lodestar 创建的临时群 |
98
+ | `bye` | — | 自己退出临时群;最后一个人退出时停止会话并解散整个群 |
99
99
 
100
- `btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。备注重名时自动追加 `-2`、`-3`。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。
100
+ `btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。
101
101
 
102
102
  `fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
103
103
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.21.28",
3
+ "version": "0.21.31",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },