@leviyuan/lodestar 0.23.2 → 0.23.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/README.md +10 -10
- package/dist/dsh-bridge.js +1 -1
- package/dist/lodestar-agent.js +2 -2
- package/dist/lodestar-claude.js +2 -2
- package/dist/lodestar-setup.js +2 -2
- package/dist/lodestar-stop.js +1 -1
- package/dist/lodestar-update.js +2 -2
- package/dist/lodestar-version.js +2 -2
- package/dist/lodestar.js +2 -2
- package/package.json +1 -2
- package/docs/AGENTS.md +0 -18
- package/docs/claude-agent-backend.md +0 -156
- package/docs/configuration.md +0 -150
- package/docs/feishu-permissions.json +0 -25
- package/docs/models.md +0 -222
- package/docs/release.md +0 -32
- package/docs/usage.md +0 -246
package/docs/models.md
DELETED
|
@@ -1,222 +0,0 @@
|
|
|
1
|
-
# 账号、模型与 effort
|
|
2
|
-
|
|
3
|
-
[返回首页](../README.md) · [安装与配置](configuration.md) · [群内用法](usage.md)
|
|
4
|
-
|
|
5
|
-
账号配置使用 `[token_source.glm]`、`[token_source.deepseek]` 等节,通用中转站使用 `[relay.<site_id>]`。GLM、DeepSeek 和 OpenRouter 也可以从本机 Claude settings 中识别;识别后由对应 Token Source 注入凭据,避免不同账号的环境变量串用。项目的工具限制只作用于主会话,委派 Agent 使用完整工具集。
|
|
6
|
-
|
|
7
|
-
## 配置 API Key
|
|
8
|
-
|
|
9
|
-
GLM Key 可在首次安装时跳过,之后用群命令添加或更换。以下命令先返回回执,后台向对应平台校验凭据,通过后才保存;认证、网络或响应错误均保留原配置并给出原因。校验无需调用付费模型,也不要求先安装对应 Agent。
|
|
10
|
-
|
|
11
|
-
| 账号 | 群命令 |
|
|
12
|
-
| --- | --- |
|
|
13
|
-
| 智谱 GLM(两个 Agent 共用) | `glm-setup <api_key>` |
|
|
14
|
-
| Z.ai GLM(两个 Agent 共用) | `glm-setup https://api.z.ai/api/anthropic <api_key>` |
|
|
15
|
-
| DeepSeek(两个 Agent 共用) | `deepseek-setup [base_url] <api_key>` |
|
|
16
|
-
| OpenRouter | `openrouter-setup [base_url] <api_key>` |
|
|
17
|
-
| 通用中转站 | `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` |
|
|
18
|
-
| 中转站余额脚本 | `relay-balance-setup <site_id> <script_path>` |
|
|
19
|
-
| DeepSeek 旧命令,同样更新共享账号 | `deepseek-harness-setup [base_url] <api_key>` |
|
|
20
|
-
| GLM 旧命令,同样更新共享账号 | `dsh-glm-setup [base_url] <api_key>` |
|
|
21
|
-
|
|
22
|
-
`[base_url]` 表示可选参数,命令中不输入方括号;API Key 只填原值,不加 `Bearer`。`glm-setup <base_url> <api_key>` 的原有格式仍可使用,GLM 的 Key 与平台地址必须对应。保存后发送 `md` 选择模型。账号配置由本机所有群共用,更新 Key 保留已有模型、档位和可见性设置。
|
|
23
|
-
|
|
24
|
-
凭据校验通过后会明确返回“配置已保存”,模型目录和额度随后在后台加载;若 Agent 未安装或目录刷新失败,`md` 显示具体错误。处理后等待后台刷新即可。认证失败会提示核对 Key,网络失败会提示检查连接和代理,不会将错误正文误报为“缺少 data 数组”。
|
|
25
|
-
|
|
26
|
-
## 选择与管理模型
|
|
27
|
-
|
|
28
|
-
发送 `model`(`md`),在 Claude Code、Codex、DeepSeek Harness 分组下选择账号,再选择模型。首页直接使用缓存;手动点开账号模型列表时立即发起目录查询,卡片显示刷新状态,完成后呈现目录。有多个推理档位(effort)时继续选择档位,只有一个档位时直接应用。
|
|
29
|
-
|
|
30
|
-
Codex 订阅的模型目录和额度主动轮询均为每 2 小时;[reclaude](#reclaude) 的额度随模型目录一起读取,均为每 5 分钟;其他来源为模型目录每 5 分钟、额度每 60 秒。daemon 启动时完成首次预热。`md` 首页、`hi`、账号列表、Agent 身份目录、自动选号和回复页脚都直接读取已提交缓存。手动进入账号模型列表会额外查询,但不会占住其他交互;翻页和显隐后的列表重绘复用快照。Codex 邮箱复用后台原生账号查询的结果。
|
|
31
|
-
|
|
32
|
-
这些周期和主动查询流量预算仅约束 Lodestar 的定时轮询。常驻 Codex 自身刷新、用户手动拉取模型列表属于允许额外消耗的被动刷新,不受主动周期限制。同账号有运行中的 Codex 进程时,额度复用已有连接,每分钟兜底刷新,并在额度通知和回合结束时及时回读。无运行进程、也没有用户按需操作时,其他地方的消费变化可能到下次主动查询才显示。
|
|
33
|
-
|
|
34
|
-
同一来源和账号的并发刷新会合并,刷新完成后一次更新缓存。网络或限流失败保留成功快照,错误写入日志,目录刷新错误也会显示在模型面板;Codex 订阅失败后至少等待对应正常刷新间隔;其他来源按 1、2、4、5 分钟退避,均遵守平台更长的限流冷却。没有缓存或认证已失效时立即显示加载中或 `MISS`。修改凭据会隔离并清除受影响账号的缓存,旧请求结果不能覆盖新配置;其他账号继续可用。
|
|
35
|
-
|
|
36
|
-
| 操作 | 作用 |
|
|
37
|
-
| --- | --- |
|
|
38
|
-
| 选 | 使用该模型,按需继续选择推理档位 |
|
|
39
|
-
| 隐 / 显 | 隐藏或显示接口目录中的模型,不改变当前运行模型 |
|
|
40
|
-
| 补录模型 | 添加接口目录外的模型,可选择推理档位并使用 |
|
|
41
|
-
| 删 | 删除补录记录;仍有会话选用时需先切换模型 |
|
|
42
|
-
|
|
43
|
-
OpenRouter 保持自己的精选和模型管理规则。通用中转站按站点协议读取 `/v1/models`,不绑定具体厂商;`anthropic` 站点提供 Claude Code,`openai` 站点同时提供 Codex 和 DeepSeek Harness。模型选择为“中转站 → 站点 → 模型 → effort”。
|
|
44
|
-
|
|
45
|
-
同账号切换 Claude 或 DSH 模型从后续回复生效;Codex 的持久设置需重启会话生效。跨账号或后端切换只允许在空闲时进行。来源禁用或目录获取失败显示 `MISS`。
|
|
46
|
-
|
|
47
|
-
模型设置超过 20 秒仍未收到后端确认时,面板显示“确认中”,最终结果回到原卡;等待期间仍可回答 Agent 提问或用 `stop` 打断任务,取消切换需发 `kill` 或 `restart`。模型和思考档位全部确认后才保存选择。若只有模型切换成功,或后端已应用但保存失败,会分别显示实际结果和错误,未确认的值显示 `MISS`;后续输入暂停,重新发送 `md` 完成选择后再继续。已有排队消息保留,设置确认后再提交。
|
|
48
|
-
|
|
49
|
-
## 额度
|
|
50
|
-
|
|
51
|
-
给机器人发单聊消息,面板的账号额度列出全部已配置账号,每个账号一块:首行是账号名,其后每个额度窗口一行,如 `5h ▰▰▱▱▱▱ 34% 4.1h 后重置`;在项目群里发 `hi` 只显示本项目进程实际使用的那个账号的额度。Codex 按备注展示主额度窗口及重置卡次数(`重置卡 2`,为 0 时省略),不展示 Spark、gpt-reserve;Claude 订阅和 reclaude 保留主窗口和模型专属周额度,模型专属周额度写作 `Fable 周`、`Opus 周` 等,与总周各占一行、各带自己的重置时间(如 `周 ▰▰▰▰▰▰ 100% 2.2d 后重置` 下一行是 `Fable 周 ▰▰▰▱▱▱ 47% 2.2d 后重置`),已取消 5 小时限额的账号只显示周额度;Claude 订阅账号另显示到登录最早可能结束的剩余时间,如 `凭据剩余 23.2d`(见 [Claude Code 订阅](#claude-code-订阅));GLM 月工具仅显示已用百分比,DeepSeek、OpenRouter 显示余额。DeepSeek、GLM 的两个 Agent 入口各合并为一个账号。
|
|
52
|
-
|
|
53
|
-
所有群、Agent、`hi`、账号列表、页脚和自动选号共用账号级缓存,刷新周期见[选择与管理模型](#选择与管理模型)。启动首次预热及显式首次收录账号可以等待查询完成。用户任务启动或真实耗尽换号若没有可选缓存,可立即按需回读一次;已知真实重置时间到达时可再确认一次,普通等待循环不额外冷查询。Codex 订阅主动查询失败后至少等待 2 小时;运行连接的被动额度刷新使用共享的 1、2、4、5 分钟失败冷却;其他来源失败后冷却 1 分钟,连续失败依次延长为 2、4、5 分钟。上游提供更长的 `Retry-After` 时遵守其等待时间。Codex 额度查询遇到瞬态连接错误时,在同一次共享查询内最多尝试 3 次,间隔 1 秒、4 秒;真实限频、认证失败及无效响应不立即重试,最终失败后进入冷却,冷却期间返回已有错误。重新登录、删除 Codex 账号或显式使用重置卡会使对应缓存失效;使用重置卡后重新查询实际额度。
|
|
54
|
-
|
|
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
|
-
|
|
57
|
-
Codex 启动和换号优先使用最近一次成功的额度缓存;能选出账号就直接启动,不等待其他账号刷新;没有可用缓存时明确显示 MISS,后台继续刷新。其他账号未参与选号的诊断保留在日志和 `codex-accounts` 中,不主动发送“部分账号 MISS”警告。只有无法启动或继续任务时,才主动展示相应失败或等待状态。
|
|
58
|
-
|
|
59
|
-
## Claude Code 订阅
|
|
60
|
-
|
|
61
|
-
在运行 Lodestar 的本机通过 `claude auth login` 登录 Claude 订阅后,发送 `md` → Claude Code → **Claude Code 订阅**。来源 id 为 `claude-sub`,可与 GLM、DeepSeek、OpenRouter 同时使用;无需复制登录凭据或填写 API key。
|
|
62
|
-
|
|
63
|
-
额外账号由用户自行登录,目录固定为 `~/.claude-accounts/备注名`。例如:
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
# desc: 手动登录备注为工作号的 Claude 订阅
|
|
67
|
-
lodestar-claude 工作号 auth login
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
`lodestar-claude <备注> [原生参数...]` 选择对应账号目录并将其余参数传给原生 Claude Code。上例的账号目录与 `CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/工作号" claude auth login` 一致。命令本身不收录账号;首次登录前会准备共享配置,已有目录的非登录内容会替换为全局共享配置。登录后仍需在群内发送 `hi 工作号`。
|
|
71
|
-
|
|
72
|
-
该入口仅供用户本机终端使用,受管 Agent 上下文中拒绝启动;使用 Lodestar 当前选中的已安装 Claude 运行时,缺失时报错,不自动安装或回退。它保留终端的 `HOME` 和工作目录;`default` 保留终端 `CLAUDE_CONFIG_DIR` 的未设置状态或原始路径,不读取 `[claude.env]`。
|
|
73
|
-
|
|
74
|
-
在 Claude Code 会话发送 `hi 工作号`,Lodestar 只检查这个备注对应的目录。新增备注账号通过原生订阅身份验证后,卡片显示“已登录,正在完成首次同步”,保留认证进程等待 Skills 和插件云同步完成,再收录并启动;不会扫描其他目录或代办登录。首次同步最长等待 120 秒,期间不查询该账号的模型或额度、不参与自动选号,也不能启动任务或切换到该账号。失败保留账号和原因,按提示稍后再次发送 `hi 工作号` 重试;连续失败的重试间隔依次为 1、2、4、5 分钟,不由后台额度轮询自动重试。`hi default` 指定原生默认账号。指定账号只影响本次启动;同号正在运行时显示状态,忙碌时不能切换其他号,空闲时可用 `hi 另一备注` 切换并恢复原会话。
|
|
75
|
-
|
|
76
|
-
不指定账号时,启动从默认及已收录账号的模型和额度缓存中选择。总周以及接口实际返回的 5 小时、OAuth 应用周窗口、当前模型专属窗口都必须可用:已用百分比须在 `0%` 到 `100%` 之间(不含 `100%`),重置时间须有效且尚未到期。接口返回 `five_hour: null`(或没有该字段,且聚合 `limits[]` 没有 `session` 桶)表示这个账号已取消 5 小时限额,只按周额度校验,不补 0%、不补窗口和重置时间,也不显示 `MISS`。缺值、无效或已过期的重置时间,以及同模型匹配多个专属周窗口,都按 `MISS` 排除;任一适用窗口耗尽的账号不参与正常选号。若所有通过模型和档位校验的账号都已真实耗尽,自动启动仍从中选一个,不因自动选号失败阻断启动或 `rs` 恢复:恢复已有会话且该会话原来的账号也在耗尽账号中时,沿用原账号;否则选最早恢复的耗尽账号,即全部用光的窗口都已重置的时间最早。用光的窗口缺少重置时间时恢复时间未知,排在最后;时间相同按账号列表顺序,设备默认账号在前。Fable 预留只影响排名,不会使账号判为耗尽(见下文)。未登录的默认账号不算选号失败,目录、认证或额度快照的其他失败仍按原样报错。
|
|
77
|
-
|
|
78
|
-
所有账号使用同一套调度模型,不区分账号类型:一个完整 5 小时额度算一份,普通完整周窗口、OAuth 及模型专属周窗口算 10 份,Fable 专属周窗口算 5 份(总周的一半)。账号余量取 5h、总周及接口实际返回的 OAuth、当前模型专属窗口中最小的剩余份数;没有 5h 窗口的账号只按周窗口计算。Fable 与其他模型分开分配:Fable 模型同时受总周和专属周约束;其他模型在距总周重置超过 2 天时,总周剩余中相当于 Fable 尚未使用份额的部分只按四分之一计入余量和节奏:这只会降低账号排名,不排除账号、不分档,也不会因此判为耗尽;距重置不超过 2 天释放预留。预留只依据接口实际返回的唯一 Fable 专属周窗口,缺失时不猜测;Fable 模型缺少专属周按 `MISS` 排除,仍在预留期但专属周重复或数值无效时也按 `MISS` 排除,专属周已用完时不再预留。其他模型专属仅兼容接口实际返回的窗口。
|
|
79
|
-
|
|
80
|
-
选号按各账号可持续的消耗节奏分散任务,不预测单个任务的用量:每个适用窗口的节奏是剩余份数除以距其重置的小时数(不足 1 小时按 1 小时计),账号节奏取最慢的那个窗口,且每次启动最多按每 5 小时一个满窗(每小时 0.2 份)计。存活的 Claude 订阅会话只要仍在执行任务,或最近 30 分钟收到过用户消息,就计为一份负载;等待回答、排队和后台任务也计入,同群不重复计算。会话里仍在运行的原生子 Agent 每个再计一份,结束后不再计入。每次启动前把封顶后的账号节奏除以“活跃负载单位 + 1”,作为该账号的分数,分数高者优先。
|
|
81
|
-
|
|
82
|
-
封顶是因为会话在窗口或周额度重置后仍留在原账号继续消耗:快作废的额度最多与满窗并列,不会把新任务都吸走。不足 1 小时按 1 小时计是因为请求是突发的:5 小时窗口至少剩 0.2 份才算满窗节奏,已用比例不超过窗口已过时间比例(也不超过 80%)的窗口都与满窗同分,其余按实际节奏降低。有 5 小时窗口的账号逐窗花周额度,周窗口最多按 24 小时折算:周额度须够按满窗节奏撑过一天或撑到周重置,否则拉低分数(距重置一天以上时即剩不到 4.8 份);窗口有余量、周额度够用时,这类账号一般排在只有周额度的账号之前。没有 5 小时限额的账号按到周重置为止的节奏计算,离重置远或快用完的周额度节奏低。同分时依次取活跃负载少、封顶前节奏高(额度更需要尽快花掉)、到期早(有 5 小时窗口看其重置时间,否则看该模型实际生效的周额度重置时间)、余量大的账号。尚未启动的 5 小时窗口不会作废,被使用时才开始计时:无论额度缓存读取了多久,都按完整 5 小时、从现在起 5 小时到期计,不会因缓存变旧而排到真正在计时、额度会作废的窗口之前。
|
|
83
|
-
|
|
84
|
-
选择只看真实余量、各窗口的重置时间和当前负载:不按有无 5 小时窗口、重置先后或是否动用 Fable 预留整组排队,不预留未来用量,也不设“预计是否装得下”的门槛。认证失败或 `MISS` 的账号仍不会入选,真实耗尽账号不参与正常选号,全部耗尽时按前述规则回退。选择不改真实额度,只发生在启动时,运行中不会因额度耗尽自动轮换。
|
|
85
|
-
|
|
86
|
-
首次收录会清理额外账号自己的旧 `projects`、`tasks`、`file-history`、`plans`,并将这四个目录接到默认账号的共享存储;默认历史和配置、各账号登录凭据保留。重复收录只检查历史共享链接,不再次清理历史。账号初始化中断后可在下次 `hi 备注` 重试;未完成的账号不参与自动选择。同项目各账号共用原生历史、任务、文件回退和计划,切换账号后可以恢复或分叉;Lodestar 内同一原生会话禁止同时续写。自行在终端打开同一会话时,也应先结束原进程。
|
|
87
|
-
|
|
88
|
-
备注账号除登录状态外,统一使用默认配置目录(通常为 `~/.claude`)中的内容。`CLAUDE.md`、规则、Skill、自定义命令、子 Agent、工作流、插件、hooks、记忆、`settings.json`、快捷键及普通缓存都链接到全局;全局现有的其他文件和目录也自动接入。全局内容优先,备注账号原来的非登录内容会被替换,不保留同名覆盖或另做备份。首次收录、后续启动和 `lodestar-claude` 首次登录及打开已有账号目录时都会处理;升级前已收录的账号无需重新登录。全局文件修改通过链接直接生效,新增顶层项目在下次启动时补齐。
|
|
89
|
-
|
|
90
|
-
登录凭据、认证锁、账号/组织策略缓存和含账号身份的备份保持独立。原生 `~/.claude.json`(显式配置目录下为 `.claude.json`)及旧 `.config.json` 同时存登录身份和普通配置,不能整文件共享:启动时保留备注账号自己的认证字段,用全局 MCP、项目设置及其他普通字段覆盖备注配置。这些混合文件仍是各账号的独立文件,其余共享项使用链接。
|
|
91
|
-
|
|
92
|
-
默认账号保留原生配置目录的“未设置”状态或原始路径;不要把默认登录改成显式 `CLAUDE_CONFIG_DIR=~/.claude` 来代替,macOS 上这可能对应不同的钥匙串登录项。登录和续期由原生 Claude Code 管理,Lodestar 不读取或复制凭据文件。单聊面板按备注显示每个账号的额度,群里 `hi` 显示本项目进程实际使用的账号,回复页脚使用实际执行该轮任务的账号。
|
|
93
|
-
|
|
94
|
-
发送 `claude-sub` 查看开关和可用状态,`claude-sub on` 启用,`claude-sub off` 禁用。开关对这台 Lodestar 的所有群生效并持久保存,只控制「Claude Code 订阅」来源,保留本机登录态及其他来源。禁用后不查询订阅模型和额度、不接受新任务;尚未送入 Agent 的排队消息会提示重发,已经在执行的任务继续完成。再次启用后仍须有有效订阅登录。
|
|
95
|
-
|
|
96
|
-
账号和模型目录通过 Claude Code 原生 SDK 查询,模型与 effort 随目录更新;未登录会显示启用引导,查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`,支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用,`enabled = true` 或省略时沿用本机登录检测;群命令更新该字段。
|
|
97
|
-
|
|
98
|
-
订阅额度通过原生 `/usage` 控制接口读取,无需发送模型对话;每次实际查询仍会启动一个独立的 control-only Claude Code 进程,并执行原生启动初始化,查询后关闭。首次同步完成前不会为新增备注账号启动这些短命查询进程。单聊面板和群里 `hi` 的额度明细展示 5 小时、总周额度和接口返回的模型专属周额度,每个窗口一行、各带重置倒计时;已取消 5 小时限额的账号只显示周额度,不显示 5h 的 `MISS`。回复底部同样只显示实际存在的窗口:本轮所选模型有专属周额度时显示该模型的额度,否则显示总周额度,没有 5 小时窗口时省略该段,沿用紧凑格式。后台瞬态查询失败保留成功缓存;没有缓存、认证失效或专属窗口缺数值时显示 `MISS`,不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口,版本不支持或接口变化时明确报错。
|
|
99
|
-
|
|
100
|
-
每个 Claude 订阅账号的额度明细显示登录凭据剩余时间:单聊面板写在账号名后,群里 `hi` 写在额度面板第一行。数据来自原生 `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
|
-
|
|
102
|
-
订阅进程保留本机和项目的 Claude 设置,并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude 订阅统一使用“Claude Code 订阅”来源,`md`、`hi`、单聊面板和回复底部共用该来源的账号与额度。
|
|
103
|
-
|
|
104
|
-
旧版“Claude”本机配置入口已移除;使用该入口的用户升级后请通过 `md` 选择“Claude Code 订阅”及模型。
|
|
105
|
-
|
|
106
|
-
## reclaude
|
|
107
|
-
|
|
108
|
-
reclaude 是第三方的 Claude Code 启动器:登录、组织绑定和网络路由都由 reclaude 自己管理,Lodestar 只经它启动 Claude Code,不读取、不保存 reclaude 的任何凭据,配置里也没有凭据字段。来源 id 为 `reclaude`,在 `md` → Claude Code 下显示为 **reclaude**(可用 `display` 改名),可与 Claude Code 订阅及其他第三方来源同时使用。
|
|
109
|
-
|
|
110
|
-
**启用**:无需群命令。Lodestar 在 `PATH` 和 `~/.local/bin` 中查找 `reclaude` 命令,找到即启用;装在别处时用 `[token_source.reclaude]` 的 `bin` 指定(路径不存在会报错),`enabled = false` 关闭该来源。配置项见[安装与配置](configuration.md#reclaude-配置)。每次目录刷新都会重新查找,Lodestar 运行后才安装或卸载 reclaude 无需重启,约 5 分钟内自动生效。随后在运行 Lodestar 的本机用 `reclaude login` 登录,并用 reclaude 绑定组织。
|
|
111
|
-
|
|
112
|
-
**组织**:默认跟随 `reclaude org use <组织 ID>` 选定的当前组织;在配置中写 `org = "<组织 ID>"` 则固定使用该组织,该组织须已用 `reclaude org bind <组织 ID>` 绑定。切换组织在下一次目录刷新时生效:模型和额度改读新组织,绑定旧组织的空闲进程在下一轮开始前停止,按新组织重新启动。
|
|
113
|
-
|
|
114
|
-
**会话记录**:reclaude 的会话记录保存在各组织自己的配置目录中,与其他 Claude 来源共用的会话目录相互独立。在 reclaude 与其他 Claude 来源之间切换,或切换组织后,原会话无法在新来源续接:续接时会说明原因,发送 `hi` 开始新会话,或用 `md` 切回原来源继续。`rs` 只列出当前来源目录下的历史会话。
|
|
115
|
-
|
|
116
|
-
**状态**:
|
|
117
|
-
|
|
118
|
-
- `md` 中显示“未配置”:本机找不到 reclaude 命令,或已被 `enabled = false` 关闭;点 **启** 会回复具体原因。
|
|
119
|
-
- 模型目录显示 `MISS`:命令已找到,但 reclaude 未登录或登录失效、没有当前组织、`org` 指定的组织未绑定、绑定目录尚未初始化,或 reclaude 暂时无法确认登录状态(本机网络或 reclaude 后台服务异常,恢复后自动重试,无需重新登录)。原因中会给出要执行的命令(`reclaude login`、`reclaude org bind <id>`、`reclaude org use <id>`,或先运行一次 reclaude 完成初始化)。处理后等待下一次目录刷新(约 5 分钟),也可手动打开该来源的模型列表立即刷新。
|
|
120
|
-
|
|
121
|
-
**模型与额度**:每次目录刷新(每 5 分钟,以及手动打开模型列表时)经 reclaude 启动一个 control-only Claude Code 进程,同时读取原生模型目录和原生 `/usage` 额度,因此 reclaude 的额度每 5 分钟更新一次,而不是每 60 秒。额度格式与 Claude Code 订阅相同:单聊面板和群里 `hi`(本项目正在使用 reclaude 时)显示 5 小时、周额度及模型专属周额度,每个窗口一行,回复底部显示本轮模型适用的窗口。额度读取失败只把额度显示为 `MISS`,模型目录照常可用。未配置 `model` 时默认选目录中的 Claude Opus;配置的 `model` 须在目录中或已补录,`effort` 须为该模型支持的档位,否则目录显示 `MISS` 和原因。
|
|
122
|
-
|
|
123
|
-
**限制**:reclaude 使用组织的 Claude 订阅登录,与 Claude Code 订阅同样属于订阅使用,因此 Lodestar Agent 不调用 reclaude(遵守 Claude 用户协议),它不出现在 `agents` 身份目录中,也不能用于新建或续跑委派任务。主会话和原生委派工具不受影响。reclaude 只能启动原生 Claude Code 可执行文件,`[claude].bin` 指向脚本入口时该来源拒绝启动。启动方式见[后端说明](claude-agent-backend.md#reclaude-启动器)。
|
|
124
|
-
|
|
125
|
-
## OpenRouter
|
|
126
|
-
|
|
127
|
-
OpenRouter 通过 Claude Agent SDK 运行。在群内发送 `openrouter-setup <api_key>`,再通过 `model` 面板选择模型和 effort;自建兼容端点用 `openrouter-setup <base_url> <api_key>`。也可在配置文件中添加:
|
|
128
|
-
|
|
129
|
-
```toml
|
|
130
|
-
[token_source.openrouter]
|
|
131
|
-
agent = "claude"
|
|
132
|
-
api_key = "填写自己的 OpenRouter API key"
|
|
133
|
-
# base_url = "https://openrouter.ai/api" # SDK 自动追加 /v1/messages
|
|
134
|
-
# model = "moonshotai/kimi-k3" # 可选:默认运行模型,须获账号目录确认
|
|
135
|
-
# effort = "max" # 可选:仅覆盖默认运行模型的档位
|
|
136
|
-
# models = "moonshotai/kimi-k3,google/gemini-3.8-flash" # 可选:固定列表,停止自动追新
|
|
137
|
-
# shown_models = "moonshotai/kimi-k3" # 可选:在自动精选之外显示指定接口模型
|
|
138
|
-
# slots = "haiku=moonshotai/kimi-k3" # 可选:辅助任务模型,须获账号目录确认且使用相同的 effort 参数模式
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
默认从账号目录为以下 **6 个家族**各选最新数字版本,定义见[默认模型配置](../src/openrouter-defaults.ts)。精选随每 5 分钟目录刷新更新,保留接口原始 ID;其他兼容模型仍可从账号目录显示或补录。
|
|
142
|
-
|
|
143
|
-
| 厂商 | 自动精选家族 | 默认档位 |
|
|
144
|
-
| --- | --- | --- |
|
|
145
|
-
| Tencent | Hy | high |
|
|
146
|
-
| Google | Gemini Flash | high |
|
|
147
|
-
| Meta | Muse Spark | xhigh |
|
|
148
|
-
| Xiaomi | MiMo Pro | 模型默认 |
|
|
149
|
-
| 字节跳动 | Seed Turbo | 模型默认 |
|
|
150
|
-
| 美团 | LongCat | 模型默认 |
|
|
151
|
-
|
|
152
|
-
版本逐段按数字比较,同版本再比较发布日期。腾讯 Hy 沿用 preview 候选,同版本优先正式版;其他家族不自动纳入 preview。Flash Lite、Pro(Gemini)、Flash(MiMo)、ultraspeed、thinking、free 等独立变体不会混入对应精选家族,仍可手动显示。家族默认档位必须在上游声明中受支持,否则保留缺失状态,要求明确选择。
|
|
153
|
-
|
|
154
|
-
在 `md` → Claude Code → OpenRouter 中,点「显示模型」进入账号目录,再点「显」加入列表,点「隐」移出面板列表。自动精选项隐藏后,同家族后续版本保持隐藏;手动显示的旧版本按 ID 独立显隐。显隐增量保存为 `shown_models` 和 `hidden_models`(自动精选项同时记录 `family:` 家族键与当前 ID),不会冻结整个精选列表。当前运行模型、已配置的 `model` 和 `custom_models` 保持不变;全部隐藏后也能继续显示或补录。
|
|
155
|
-
|
|
156
|
-
未配置 `models` 时使用自动精选;已有 `models` 仍是固定列表,`models = ""` 表示没有已显示的接口模型,刷新或重启不会补回默认项。已有固定列表要启用自动追新,需删除该来源的 `models` 字段;额外显示或隐藏的选择使用上述增量字段保存。
|
|
157
|
-
|
|
158
|
-
候选目录来自 `/api/v1/models/user`,按账号供应商和隐私设置筛选,仅纳入支持文本和工具调用的交互模型;OpenAI、GLM、DeepSeek 及无法保证厂商范围的自动路由不会出现在添加候选中。目录刷新失败显示 `MISS`。显式配置但已下线的模型保留为可删除的 `MISS` 项。
|
|
159
|
-
|
|
160
|
-
effort 按上游声明提供。小米、MiniMax、字节等没有 effort 选择器的模型直接选用原生默认行为,跳过 effort 卡,实际请求不携带 effort 参数。两种参数模式之间切换时,空闲进程会保存原生会话并在下一轮用新环境恢复;相同模式下继续使用 SDK 热切换。未配置 `model` 时需要通过面板明确选择运行模型。
|
|
161
|
-
|
|
162
|
-
OpenRouter 余额来自 `/api/v1/credits`,按 `total_credits - total_usage` 计算;接口权限和错误以实际响应为准。账号目录可见不代表所有工具和请求都能成功,上游拒绝或路由不可用会明确报错。兼容接口、模型与档位的处理见[后端说明](claude-agent-backend.md#openrouter)。
|
|
163
|
-
|
|
164
|
-
## 通用中转站
|
|
165
|
-
|
|
166
|
-
中转站不绑定具体厂商,每个站点一节 `[relay.<site_id>]`,只配置站点标识、API Key、地址和协议类型。PackyAPI 等中转服务都按这种方式接入;旧版 `[token_source.packy]`、`[token_source.packy-secondary]`、`[token_source.packy-codex]` 不再读取,升级后需按本节格式重新配置。
|
|
167
|
-
|
|
168
|
-
```toml
|
|
169
|
-
[relay.my-relay]
|
|
170
|
-
display = "我的中转站"
|
|
171
|
-
api_key = "填写 API Key"
|
|
172
|
-
base_url = "https://gateway.example"
|
|
173
|
-
protocol = "anthropic" # Claude Code;OpenAI 类型同时提供 Codex 和 DSH
|
|
174
|
-
# balance_script = "/abs/path/relay-balance"
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
协议类型为 `anthropic` 或 `openai`:
|
|
178
|
-
|
|
179
|
-
- `anthropic`:在 Claude Code → 中转站下显示,使用 Anthropic Messages。
|
|
180
|
-
- `openai`:同时在 Codex → 中转站和 DeepSeek Harness → 中转站下显示;Codex 使用 Responses,DSH 使用 OpenAI Completions。
|
|
181
|
-
|
|
182
|
-
发送 `relay-setup <site_id> <anthropic|openai> <base_url> <api_key>` 可校验模型目录并保存站点。模型面板路径为“中转站 → 站点 → 模型 → effort”。模型目录读取站点的 `/v1/models`,模型 ID 和显示名称按上游返回保留;未声明 effort 时按当前 Agent 提供可用档位。
|
|
183
|
-
|
|
184
|
-
余额查询是可选的。发送 `relay-balance-setup <site_id> <script_path>` 绑定脚本。脚本通过 stdin 接收 JSON:
|
|
185
|
-
|
|
186
|
-
```json
|
|
187
|
-
{"site_id":"my-relay","base_url":"https://gateway.example","protocol":"anthropic","api_key":"..."}
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
stdout 返回统一额度快照,例如:
|
|
191
|
-
|
|
192
|
-
```json
|
|
193
|
-
{"state":"ok","kind":"balance","balance":{"remaining":12.34,"currency":"USD"},"windows":[]}
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
没有余额脚本时回复底部显示“余额 —”,单聊面板和群里 `hi` 的额度显示灰色的 `无额度查询`;脚本超时、退出失败或返回无效 JSON 时显示 `MISS`。脚本通过直接可执行文件启动,Key 不放在命令行参数中。
|
|
197
|
-
|
|
198
|
-
受管 Agent 不需要重启 Lodestar:使用继承的 `LODESTAR_AGENT_URL` 与 `LODESTAR_AGENT_CAPABILITY` 调用 `POST /agents/relays/test`(只读验证)、`POST /agents/relays/configure`(保存并刷新单个站点)或 `POST /agents/relays/reload`(重新读取并刷新站点)。项目绑定的 Agent 不允许修改全局 relay 配置。
|
|
199
|
-
|
|
200
|
-
OpenRouter 保持独立来源,不纳入通用中转站。
|
|
201
|
-
|
|
202
|
-
## DeepSeek Harness
|
|
203
|
-
|
|
204
|
-
DeepSeek Harness 与 Claude Code 共用 `[token_source.deepseek]` 中的 DeepSeek Key 和平台地址。发送 `deepseek-setup <api_key>` 后,两边都可在 `model` 面板中选择;旧命令 `deepseek-harness-setup` 也更新同一共享账号。两个 Agent 保留各自的原生会话、默认模型、effort 和模型可见性。
|
|
205
|
-
|
|
206
|
-
```toml
|
|
207
|
-
[token_source.deepseek]
|
|
208
|
-
api_key = "填写自己的 API key"
|
|
209
|
-
[token_source.deepseek-harness]
|
|
210
|
-
agent = "dsh"
|
|
211
|
-
# bin = "/abs/path/to/node" # 可选:运行 DSH 的 Node 可执行文件
|
|
212
|
-
# model = "deepseek-v4-pro" # 可选:默认模型
|
|
213
|
-
# effort = "high" # 可选:默认请求档位
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
### GLM Coding Plan
|
|
217
|
-
|
|
218
|
-
DSH 与 Claude Code 共用 `[token_source.glm]` 中的 GLM Coding Plan Key 和平台地址,在 `md` → DeepSeek Harness → GLM Coding Plan 中选择模型。`glm-setup` 与旧命令 `dsh-glm-setup` 都会更新两边,`[token_source.dsh-glm]` 只保留 DSH 的模型、effort、可见性等设置。两边分别使用 Anthropic 与 Coding Plan OpenAI 端点,并共享同一额度缓存。账号接口模型和补录模型一起交给原生适配器,均可选择请求档位;接口项用「隐 / 显」,补录项用「删」。
|
|
219
|
-
|
|
220
|
-
只有旧 Harness 配置时,会读取它的账号供两边共用;下次保存该来源配置时,凭据归并到上述共享配置节。两边旧配置的 Key 或平台不一致时明确报配置冲突,不自动挑选账号;重新执行对应 `setup` 命令可统一为指定的新配置。
|
|
221
|
-
|
|
222
|
-
手动修改配置后需重启 daemon;群内账号启用和模型补录会自行重载相关配置。模型路由、配置优先级和后端差异见 [后端说明](claude-agent-backend.md)。
|
package/docs/release.md
DELETED
|
@@ -1,32 +0,0 @@
|
|
|
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
|
-
- 打标签前先推送 `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
|
-
- 自动安装的 Agent 运行目录由 `scripts/check-installed-package.ts` 按 `scripts/agent-audit.ts` 审计。公告的包在上游还没有修复版本、无法用 `overrides` / `agentRuntimeOverrides` 修掉时,只有经用户同意,才能在 `AGENT_AUDIT_EXCEPTIONS` 按 Agent、公告编号和包名临时豁免并写明原因与到期日。该包 npm latest 不再落在公告的受影响范围(上游出了修复;npm 把同一公告拆成多个受影响区间时逐段判定,任一段已有修复即拦截)或过了到期日,豁免自动失效、重新拦截,届时用 `agentRuntimeOverrides` 覆盖到修复版本并删除豁免。豁免期间验收日志打印 `⚠️ … 暂时豁免`,发版说明须写明;Lodestar 自身依赖的审计没有豁免。
|
|
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` 去绕开。
|
|
29
|
-
- 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
|
|
30
|
-
- 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
|
|
31
|
-
- `src/pid-guard.test.ts` 的 Linux 专用用例曾因进程刚 exec 时 `/proc/<pid>/cmdline` 短暂为空而偶发失败(报「命令行为空」)。守卫现在会重读空命令行,并把僵尸进程与内核线程视为不存在。若仍遇到这一条失败,确认日志只有它后 `gh run rerun <run-id> --failed` 重跑即可,不要为此改版本或移动已推送的 tag。
|
|
32
|
-
- `scripts/publish-verified-package.mjs` 只接受 `npm pack --json` 生成的清单(含 `name`、`version`、`filename`、`integrity`),并在 `NODE_AUTH_TOKEN` 缺失时直接拒绝发布。
|
package/docs/usage.md
DELETED
|
@@ -1,246 +0,0 @@
|
|
|
1
|
-
# 群内使用指南
|
|
2
|
-
|
|
3
|
-
[返回首页](../README.md) · [模型与账号](models.md)
|
|
4
|
-
|
|
5
|
-
## 群内命令
|
|
6
|
-
|
|
7
|
-
直接发送下列词语,不加斜杠,大小写不敏感。这些命令控制当前群的 Agent 会话。
|
|
8
|
-
|
|
9
|
-
| 完整指令 | 缩写 / 别名 | 行为 |
|
|
10
|
-
| --- | --- | --- |
|
|
11
|
-
| `hi` | — | 查看本项目的状态、模型、实际使用的账号及其额度;会话未运行时先启动 |
|
|
12
|
-
| `model` | `md` | 按 Agent 分组选择账号,再选择模型与推理档位(effort)并保存 |
|
|
13
|
-
| `stop` | `st` | 打断当前回复并取消排队消息,保留进程 |
|
|
14
|
-
| `kill` | `kl` | 关闭当前 Agent 进程,保存可恢复的会话记录 |
|
|
15
|
-
| `restart` | `rs` | 进程存活时打断并恢复当前会话;已停止时列出同目录的历史会话(显示时间、会话短标签、首句和最后一条用户输入),选择后创建独立分支 |
|
|
16
|
-
| `clear` | `cl` | 关闭当前进程并开始新会话;已停止时提示先启动 |
|
|
17
|
-
| `compact` | `cm` | 压缩当前会话的上下文,结果见下文 |
|
|
18
|
-
| `agents` | `agent` | 查看可调用的 Agent 身份及可用状态 |
|
|
19
|
-
| `claude-sub` | — | 查看 Claude Code 订阅在 Lodestar 中的开关和可用状态 |
|
|
20
|
-
| `claude-sub on` | — | 启用 Claude Code 订阅来源,所有群共用 |
|
|
21
|
-
| `claude-sub off` | — | 禁用 Claude Code 订阅来源,保留本机登录态,所有群共用 |
|
|
22
|
-
| `codex-login [备注]` | — | 用设备码登录 Codex;先不带备注登录默认账号,再带备注添加额外账号 |
|
|
23
|
-
| `codex-login-cancel [备注]` | — | 取消本人在本群发起的 Codex 登录;只有一个等待任务时可省略备注 |
|
|
24
|
-
| `codex-accounts [页码]` | — | 卡片列出账号额度、调度分数、顺序与当前/优先账号标记 |
|
|
25
|
-
| `codex-reset [备注]` | — | 直接使用一次 Codex 重置卡;省略备注为当前运行账号,`default` 指定设备默认账号 |
|
|
26
|
-
| `hi 备注` | — | 按当前 Agent 指定本次启动的订阅账号;Claude 账号首次使用时按备注发现并收录,`hi default` 使用设备默认账号;Claude 忙碌时拒绝换号,空闲时恢复同一历史 |
|
|
27
|
-
| `codex-account [备注]` | — | 查看本群选号策略;带备注指定后续启动的账号,`default` 表示设备默认账号 |
|
|
28
|
-
| `codex-account-delete 备注` | — | 删除额外账号的本地记录与独立凭据,清除各群对它的指定 |
|
|
29
|
-
| `codex-auto` | — | 清除本群手动指定,恢复按优先级与额度评分自动选号 |
|
|
30
|
-
| `task` | — | 创建、查看或删除绑定的飞书任务清单 |
|
|
31
|
-
|
|
32
|
-
模型列表来自各账号的模型目录,获取失败显示 `MISS`。同账号切换 Claude 或 DSH 模型从后续回复生效,Codex 的持久模型设置需重启会话生效;跨账号或后端切换只允许在空闲时进行。账号接入、模型补录与额度说明见[账号与模型](models.md)。
|
|
33
|
-
|
|
34
|
-
Claude Code 的模型被原生安全分类器拦下回复时(例如 Opus 5.5 把普通开发任务误判为网络安全类),Lodestar 会在群里另发一张「⚠️ 安全拦截」提醒卡,不混在回复卡里。原生改由降级模型接着回答时,卡片写明原模型、降级模型和拦截类别,本轮回复底部随即显示实际在答的模型;这种降级对整个会话持续有效,之后每一轮都用降级模型,发 `md` 重新选择原模型即可切回(下一轮生效),`restart` 也会按已保存的模型重新启动,再被拦截时会再次提醒;同一轮里降级模型又被拦截、再换一个模型时,更新原来那张提醒卡,不另发。只有子 Agent 或旁支提问的一次回复被降级时发黄色提醒,会话模型不变,同一轮同一对模型只提醒一次;没有降级模型、本轮被直接终止时同样提醒。卡片发不出去时改发同样内容的文字。
|
|
35
|
-
|
|
36
|
-
`restart` 和 `clear` 在状态卡上显示进度;重启过程出错时,状态卡以 `❌ 重启失败: <原因>` 或 `❌ 清空失败: <原因>` 结束。Claude 会话的历史列表按最后修改时间倒序,最多显示最新的 40 个会话。
|
|
37
|
-
|
|
38
|
-
`compact`(`cm`)在状态卡上显示结果:完成显示 `✅ 上下文已压缩`,能读取时附压缩后的上下文用量;无需压缩时显示 ⓘ 和原因;失败显示 `❌ 上下文压缩失败` 和原因,Claude 原生返回的取消、跳过或失败说明原样显示。压缩没有时间上限,期间本群的普通消息排队,压缩结束后依次处理。压缩期间发送 `stop`、`kill`、`restart`、`clear`(或其缩写)会立即中断压缩,状态卡显示 `🛑 上下文压缩已取消`,随后照常执行该命令;其中 `kill`、`restart`、`clear` 在后端 10 秒内未响应中断时强制结束进程,`stop` 只中断。
|
|
39
|
-
|
|
40
|
-
Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方向,无需等待整轮回复结束。消息会交给正在运行的任务,在后端下一次可接收输入时生效;Agent 实际收入补充消息后,按原生执行记录中的连续输入区段切换到新卡,顶部「📥 追加」列出整批补充内容。中间没有 Agent 思考、回复或工具执行的连续补充会合并在一张卡里。在此之前的输出仍留在旧卡,之后的输出进入新卡,运行中的工具随卡接续;新卡发送成功时一并撤销本批消息的等待表情,旧卡标记已续至下一张,任务继续执行。Claude 的兼容来源(GLM、DeepSeek、OpenRouter 等)沿用这一行为。消息恰好赶上回合结束时会接着处理;进程仍在启动或恢复时暂存,提交失败会明确提示。`stop` 同时取消尚未处理的追加消息。DeepSeek Harness 仍按下一轮批次处理执行中收到的消息。
|
|
41
|
-
|
|
42
|
-
## 单聊
|
|
43
|
-
|
|
44
|
-
单聊不对应任何项目:给机器人发任何单聊消息,都只回一张只读的 Lodestar 面板,不建会话、不保存状态、不启动 Agent,也没有按钮,所有操作仍在项目群里进行(发 `hi`、`btw` 等)。这张面板是全局总览:全部运行中项目、全部账号额度和主机信息都在这里查看,项目群里的 `hi` 只显示本项目。面板只列你看得到的运行中项目:你所在群的会话,以及你当群主的项目群和它的关联群(`<群名>*…` 临时群、`<群名>[…]` WT 群及其临时群)。群主身份只认项目已保存绑定的那个群:另建一个同名的群、群名换算成项目名后撞名(如 `foo bar` 与 `foo.bar`),或项目群改名后再用旧名建群,都不会看到别人的项目。群主和成员关系在每次发消息时实时查询,不保存;查询失败或 20 秒内没读完时隐藏受影响的项目,并在面板上提示「部分项目读取失败,已隐藏」;群已解散或机器人已不在群里时直接不显示,不提示。本企业成员还能看到账号名、主机信息和全部账号额度;外部联系人(其他飞书企业的用户),以及无法确认所属企业的发送者,只看到项目名、状态、运行时长和子 Agent/后台进程数。接收单聊消息需要应用开通「获取用户发给机器人的单聊消息」(`im:message.p2p_msg:readonly`)并发布版本;外部联系人还需要应用在「对外共享」中开启「允许外部用户与机器人单聊」。
|
|
45
|
-
|
|
46
|
-
面板标题下写有几个项目在运行(如 `3 个项目运行中`),标题旁的标签只提示要留意的情况:等审批的项目数(橙色,如 `等审批 1`)、工作中的项目数(蓝色)和挂掉的服务数(红色,如 `服务失败 1`);有项目等审批时标题为橙色,否则有项目在工作时为蓝色,其余为绿色,群列表预览同样写出这些数字。正文依次是展开的 `🗂 活跃项目`、展开的 `📊 账号额度`、默认折叠的 `🖥 主机`,最后一行小字提示单聊只能查看。活跃项目按所属项目、再按群名排序,项目的 `<群名>*…` 临时群和 `<群名>[…]` WT 群总排在它后面,不会被同前缀的其他项目(如 `feishu-web`)隔开;每个项目两行,第一行以状态圆点开头,写项目名、状态(`等审批` 为橙色)和后台计数,如 ``⚙️ `feishu` 工作中 · 子Agent2·后台1``,第二行灰字写进程实际使用的账号和运行时长,如 `Claude·默认 · 已运行 2.1h`,账号尚未确定时只写运行时长;没有运行中的项目时显示 `暂无运行中的项目`。账号额度列出全部已配置账号,每个账号一块:首行是账号名,后面跟余额、积分、重置卡或凭据剩余等账号级信息,其后每个额度窗口一行,如 `5h ▰▰▱▱▱▱ 34% 4.1h 后重置`(完整写法见下文额度明细的说明)。主机标题直接写出负载、内存、服务数和挂掉的服务数,如 `🖥 主机 · 负载 2.46 · 内存 63% · 服务 3 · ❌ 失败 1`,展开查看服务列表。外部联系人看不到账号名、账号额度和主机,标签也不提示服务失败。
|
|
47
|
-
|
|
48
|
-
## Codex 设备码登录与多账号
|
|
49
|
-
|
|
50
|
-
默认账号沿用设备上直接执行 `codex` 的登录态:使用 daemon 原始环境中的 `CODEX_HOME`,未设置时为 `~/.codex`。`codex-account` 只改变当前群后续 Codex 进程的认证选择,不覆盖默认账号,也不改变其他群。额外账号的备注名可包含中文和空格,不能包含换行或路径分隔符;`default`、`默认` 为保留名称。
|
|
51
|
-
|
|
52
|
-
每个 Codex 账号的 `plugins` 目录及插件缓存独立,避免不同安装清单在同步时互相删包;会话历史、Skill 和公共配置仍按原规则共享。安装或更新 Lodestar 时会自动把旧的共享插件链接迁为独立副本,保留默认缓存、各账号登录状态和安装清单,无需重新登录。跳过 npm 安装脚本或直接使用源码时,额外账号下次启动前也会自动迁移。安装命令须使用与 daemon 相同的 `LODESTAR_DATA_DIR` / `XDG_DATA_HOME` 和自定义 `CODEX_HOME`;迁移失败会明确报错。安装不会重启 daemon;仍在运行的旧版会把独立插件目录视为共享路径异常,升级后须按正常流程重启 daemon,再新建或切换额外账号会话。
|
|
53
|
-
|
|
54
|
-
发送 `codex-reset` 直接为当前运行的 Codex 账号使用一次重置卡;`codex-reset 工作` 为指定账号使用,`codex-reset default` 为设备默认账号使用。当前没有运行的 Codex 账号或正在等待选号时,必须带备注。命令不会切换账号或重启会话,额度不足时也不会自动使用重置卡。回执区分已重置、本次请求此前已完成、没有可重置窗口、没有可用卡,并重新读取剩余卡数和额度;查询失败显示 `MISS`,已确认的扣卡结果仍保留。同一消息的网络重试复用幂等标识,重新发送命令则是新的一次使用请求。接口失败或结果未知时,先在单聊面板的账号额度(或群里的 `hi`,只显示本项目当前使用的账号)核对卡数、`codex-accounts` 核对额度。
|
|
55
|
-
|
|
56
|
-
额外账号不再使用时,发送 `codex-account-delete 工作`。删除会移除该账号的本地记录、独立认证目录和额度缓存,并清除所有群对它的指定,这些群下次启动恢复自动选号;共享会话历史、配置和其他账号保留。正在被会话、委派任务、额度或模型查询使用的账号不能删除;登录中的账号先用 `codex-login-cancel 工作` 取消。备注必填,设备默认账号不能通过此命令删除。需要重新添加时使用 `codex-login 工作`;本地删除不会注销 OpenAI 账号或取消订阅。
|
|
57
|
-
|
|
58
|
-
添加额外账号前,先发送不带备注的 `codex-login` 完成默认账号登录。默认账号未登录 ChatGPT 或仍在授权时,`codex-login 工作` 会直接提示先完成默认账号登录,不创建额外账号记录或生成设备码;默认账号状态查询失败会显示具体错误。已在设备原生 Codex 中登录的默认账号也可使用,包括系统钥匙串保存的登录态。
|
|
59
|
-
|
|
60
|
-
默认账号检查通过后,`codex-login 工作` 会显示登录卡片,并在同一张卡里更新连接、授权、校验和结果。验证码与授权入口突出显示,结束后移除验证码。在手机或电脑浏览器中登录要保存的账号,输入验证码;授权结果会自动发回原群。凭据由 Codex 保存并刷新,不需要把密码或 Token 发给机器人。设备码登录须已在 ChatGPT 个人安全设置或工作区权限中启用;登录等待上限为 15 分钟,失败后重新发送命令。
|
|
61
|
-
|
|
62
|
-
新会话和委派任务启动时默认自动选号。优先距离周重置不超过 5 小时的账号,越早重置越优先;其余账号按评分选择。周额度刚恢复的账号不再抢先承接一次前台任务。所有账号仍须通过模型、套餐和实际额度检查。任一订阅窗口用完后,有可用消费积分的账号仍参与调度;仅剩积分的账号排在有订阅额度的账号之后,积分更多的优先,同额保持稳定顺序,周临期优先不适用于这类账号。
|
|
63
|
-
|
|
64
|
-
后台发现主额度是完整未使用的周窗口后,每个真实账号独立随机等待 30–60 分钟,到点直接向上游重新查询,绕过一分钟缓存;只有原始已用严格为 0、周窗口 10080 分钟、读取时重置时间仍恰好相差 7 天,且已返回的短窗口同样未使用,才发送一句简短问候。其他设备已使用、身份改变或查询失败时不发送;显示取整后的 `0%` / `7.0d` 不构成依据。账号别名在本机合并去重;不同设备之间没有原子锁,查询与发送间仍存在极短的竞态。
|
|
65
|
-
|
|
66
|
-
激活使用当前成本最低的 `gpt-6-luna`、原生目录提供的最低推理档位和标准速度,发送前校验属于主额度;模型缺失或被分配到独立计量桶时不换用其他模型。请求只包含问候,不创建 Codex thread,不加载会话历史、项目指令、Skill 或工具,不在群聊输出问候。只有成功终态及真实 token 用量才记为成功,随后重新读取上游重置时间,不在本地推算。失败诊断写入日志和 `codex-accounts`,下一次检查重新随机等待 30–60 分钟;已确认用量后的刷新失败不会重发。当前零上下文通道需要 Codex 原生文件登录态,令牌刷新仍由原生接口完成;钥匙串等无法通过原生接口导出令牌的存储会显示后台激活 MISS,不改变认证存储,普通会话仍可使用。
|
|
67
|
-
|
|
68
|
-
其余账号按分数从高到低选择,同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算(原生套餐标识为 `plus`、`prolite`、`pro`),周分数为 **周剩余份额 ÷(距周重置小时数 − 5)**,提前 5 小时安排消耗;临期账号直接按优先级处理,不做零或负分母计算。Plus 仅在接口返回 5h 窗口时按完整窗口 0.15 份计算,短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**,普通评分取周分数和短窗分数的较小值。未返回 5h 窗口的 Plus 和 Pro 使用周分数。两种窗口约束同一份消耗,不相加。
|
|
69
|
-
|
|
70
|
-
启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。额度刷新周期、按需回读和失败冷却见[账号与模型](models.md#额度);运行连接失败不另起控制进程。`hi`、`codex-accounts` 只读缓存,不额外发起查询,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
|
|
71
|
-
|
|
72
|
-
自动选号成功后,其他账号的缓存过期、模型档位不支持或查询失败不会单独发送警告卡或消息;具体原因保留在日志中,也可用 `codex-accounts` 主动查看。此规则同时适用于首次启动、恢复会话和自动换号。无法选出账号、任务必须等待额度恢复或当前账号实际执行失败时,仍会明确提示。
|
|
73
|
-
|
|
74
|
-
额度以接口实际返回为准。成功响应未返回 5h 窗口时,不显示该窗口,不补出满额、5 小时时长或重置时间。查询失败仍保留错误,已返回窗口缺百分比或缺重置时间仍显示 MISS,不能当作窗口不存在。
|
|
75
|
-
|
|
76
|
-
没有 5h 窗口且实际订阅额度可用的 Plus 可参与 Ultra 自动选择,无需消费积分,也不受 Pro 的 0.5 份周余量门槛限制;仍有 5h 窗口的 Plus 须有当前模型计量桶可用积分,无积分时排除,积分未知时显示 MISS。Pro 启动或换号时,有可用积分即可通过周余量门槛,没有积分则仍要求周余量至少 0.5 份(Pro 5× 剩 10%,Pro 20× 剩 2.5%);周余量不足且积分未知时显示 MISS。运行中跌破该门槛不立即切号。订阅额度仍可用时沿用订阅评分,仅剩积分时按积分余额排序。没有合格账号时等待额度恢复或积分补充。模型与 effort 权限、登录状态、消费及工作区限制、真实请求耗尽记录仍参与选择;是否消耗订阅额度或积分由上游决定,Lodestar 不强制切换计费来源。
|
|
77
|
-
|
|
78
|
-
手动指定最高优先级:`hi 工作` 直接使用该账号启动,不读额度、不限制 Plus/Ultra、不检查 0.5 份门槛,也不因本地目录失败或未收录模型而阻挡,真实登录及请求错误由 Codex 返回。只覆盖本次启动,不改变原有群偏好;同一账号正在运行时展示状态,换号会重启并恢复原 thread。`hi default` 指定设备原生账号。需要持久指定时仍可用 `codex-account 工作` 后 `restart`,`codex-auto` 清除该设置。运行过程中确认耗尽后按自动规则换号续跑。临时会话继承持久策略,委派任务按自己的 effort 自动选号。重新登录仍与实际占用账号的原生进程互斥,添加其他备注账号可独立进行。
|
|
79
|
-
|
|
80
|
-
订阅窗口达到 100% 且消费积分也确认耗尽,才判为额度用光;积分未知显示 MISS,上游明确禁止使用或达到消费限制仍会阻止调度。运行中的账号可在订阅额度用完后继续消费积分,不因百分比达到 100% 主动切号。原生主 turn 确认额度耗尽后,Lodestar 自动确认会话落盘、停止旧 Codex 进程,用下一账号恢复同一 thread 并继续任务;已接受的原始输入不重放,明确拒绝的输入才重新提交。连续耗尽会继续换号,所有可用账号耗尽则等待接口确认恢复,`stop` 可取消。网络、认证、普通 HTTP 429 和模型满载不触发换号;模型满载保留原来的同模型重试。额度耗尽记录保存在私有 `codex-quota-blocks.json`,防止重启后使用尚未恢复的账号。新的后台查询须确认订阅窗口恢复可用或积分增加才解除实际失败记录;若新查询确认旧短窗已不再返回、剩余实际窗口可用且无需积分,同样可以解除;旧正余额不能反复解封,确认积分耗尽后的补充可以恢复调度。退出或落盘确认失败会显示错误,并阻止新进程接管。
|
|
81
|
-
|
|
82
|
-
Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会话、Skills、插件文件和会话写锁,SQLite 状态使用共享目录;认证文件、模型缓存和临时运行文件保持独立。Windows 创建文件软链接需要系统允许;失败直接报告,不自动改用复制。账号备注与群选择位于 Lodestar 数据目录的 `codex-accounts.json`,额外认证位于 `codex-accounts/<内部 ID>/auth.json`。这些文件不应进入项目仓库。
|
|
83
|
-
|
|
84
|
-
账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文先显示“邮箱:…”,再按接口实际返回显示周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
|
|
85
|
-
|
|
86
|
-
额度明细在两处显示,写法相同:单聊面板的 `📊 账号额度` 列出全部已配置账号,每个账号一块,首行是账号名;群里 `hi` 的 `📊 账号额度` 只显示本项目进程实际使用的那个账号,账号名已写在上方的「账号」一行,不再重复。单账号来源只写短名(`GLM`、`DeepSeek`),多账号来源写“来源·备注”(`Claude·默认`、`Codex·工作`);DeepSeek、GLM 的跨 Agent 入口不重复展示,同一中转站只列一次。
|
|
87
|
-
|
|
88
|
-
账号名后面(群里 `hi` 则是额度面板的第一行)先写摘要。只有一个值的账号只写这个值:余额与额度的金额符号紧贴数字(`余额 ¥12.34`),令牌额度写明剩余与上限(`剩余 $3.00 / $10.00`),与回复 footer 一致;查询失败显示红色的 `MISS · 原因`,没有额度查询的来源显示灰色的 `无额度查询`。按窗口计算额度的账号,摘要是账号级信息:Codex 有消费积分时显示 `积分 62.5k`,所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零,积分未知显示 MISS、确认没有则省略;重置卡显示为 `重置卡 N`,为 0 时省略、未知显示 MISS;Claude 订阅账号显示到登录最早可能结束的剩余时间,如 `凭据剩余 23.2d`,格式同重置时间,不超过 7.0d(原生开始提醒)橙色,显示为小时或分钟时标红,已过最早结束时刻显示红色的 `凭据可能已到期`,规则见[账号与模型](models.md#claude-code-订阅);一个窗口都没读到时先写 `额度 MISS`,没有账号级信息时不写摘要。随后每个额度窗口一行,如 `5h ▰▰▱▱▱▱ 34% 4.1h 后重置`:六格进度条和百分比都按显示值着色,进度条低于 80% 为绿色,进度条和百分比 80% 起橙色、100% 红色,同一文案颜色不变;灰色的重置时间写作分钟(`45m`)或一位小数的小时、天(`4.1h`、`2.2d`)加“后重置”,时间已过显示 `已重置`,百分比已知而重置时间未知显示 `重置时间 MISS`,百分比未知而重置时间已知时百分比处写 `MISS`(如 `5h MISS 4.1h 后重置`),整个窗口都未知时只写一次 `MISS`(如 `5h MISS`)。窗口名为 `5h`、`周`、`月工具`;Claude 订阅和 reclaude 的模型专属周额度写作 `Fable 周`、`Opus 周`、`Sonnet 周`、`OAuth 应用周`,与总周一样各占一行、各带自己的重置时间;GLM 月工具只显示百分比,不显示次数与重置时间;中转站余额脚本返回的其他窗口照写脚本给的名称(如 `日额度`)。各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口,不展示 Spark、gpt-reserve 等附加额度;footer 只显示当前实际使用账号,保留 `4.1h·7%·[6.9d·17%]` 紧凑格式并在其后追加消费积分,不显示重置卡和凭据,自动换号后跟随新账号;已结束回复始终显示该回复所属账号的积分。重置卡次数出现在单聊面板、群里 `hi`(本项目当前使用的账号)和 `codex-reset` 回执中。
|
|
89
|
-
|
|
90
|
-
群里 `hi` 只显示本项目:标题为 `🌟 Lodestar · <项目名>`,颜色随会话状态变化;正文先是本项目信息,一项一行——状态,如 `🟢 空闲 · 子Agent1·后台2 · 已运行 2.1h`(`等审批` 为橙色);模型,先写 Agent(Claude、Codex 或 DeepSeek Harness)再写模型和推理档位,如 `` Claude · `claude-opus-5-5/high` ``;账号,即进程实际使用的账号,写法与额度的账号名相同,如 `Claude·默认`、`Codex·工作`、`GLM`——其后是这个账号的额度面板。会话未运行时账号显示 `未启动`;进程尚未确定账号时(Codex 仍在选号或等待额度恢复、Claude 账号未知)显示 `未确定`,额度面板相应显示灰色的 `未启动` 或 `账号未确定`;读取账号出错时显示 `MISS`,卡片照常发出。自动换号后再次发送 `hi` 会显示新账号;待下次启动生效的指定不会提前改变该账号。`hi` 只读取本项目所用账号的额度缓存,不再列出其他项目、主机和其他账号,这些在[单聊](#单聊)面板查看。
|
|
91
|
-
|
|
92
|
-
状态后面紧接着显示仍在运行的子 Agent 和后台进程数,写法与运行任务卡的群列表预览相同,例如 `空闲 · 子Agent2·后台1`:「空闲」只表示主对话空着,可以接新消息,后台的命令和子 Agent 仍在工作。群里 `hi` 的状态、单聊面板的活跃项目和 `bl` 都这样写;没有后台工作的会话不追加任何内容。子 Agent 包括前台和后台运行的原生子 Agent;后台进程是 Claude Code 的后台命令、Monitor、工作流等后台任务(不含 Claude Code 自身的内务任务)或 Codex 仍在运行的后台终端。数量只在发送 `hi`、`bl` 或单聊消息时读取一次;无法读取后台进程时显示 `后台MISS`,不当作没有。运行时长与额度倒计时同一写法(`8s`、`40m`、`2.1h`、`3.0d`),写作 `已运行 2.1h`。
|
|
93
|
-
|
|
94
|
-
## 独立工作区
|
|
95
|
-
|
|
96
|
-
需要独立修改文件时,在项目主群使用 worktree:
|
|
97
|
-
|
|
98
|
-
| 完整指令 | 缩写 / 别名 | 行为 |
|
|
99
|
-
| --- | --- | --- |
|
|
100
|
-
| `worktree` | `wt` | 列出项目的 `work/*` 分支和工作区状态 |
|
|
101
|
-
| `worktree feature-x` | `wt feature-x` | 创建或加入 `<project>[feature-x]` 群和同级 worktree 目录,使用 `work/feature-x` 分支 |
|
|
102
|
-
|
|
103
|
-
WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW/FK 始终共享来源目录的这些配置,包括从 WT 创建的临时群。文件交付统一按大小自动选择,云空间目录各群独立。任务清单属于项目级,主群、所有 WT 及其临时群共用。临时群的模型、账号在创建时继承,之后各自切换、互不影响。
|
|
104
|
-
|
|
105
|
-
已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群和该分支下的临时群都没有运行中的会话、工作区没有未提交变更,先解散这些临时群,再解散群并删除 worktree;Git 分支保留。
|
|
106
|
-
|
|
107
|
-
WT 群与临时群按同一规则决定是内部群还是外部群:在内部群里由本企业成员建的 WT 群仍由机器人当群主;在外部群里建的 WT 群是外部群,由发起人自己当群主,之后外部联系人也能用 `wt <名称>` 加入。外部联系人也能用 `wt <名称>` 新建或加入分支群:新建时由当前群的群主当群主(要求同下文的临时群),群主不合格或群类型读取失败时在创建 worktree 和分支之前就报错,不留下半成品;加入已存在的同名 WT 群不需要群主,但内部 WT 群外部联系人进不去(群类型建好后不能再改)。外部 WT 群机器人不能解散:在 `wt` 列表里删除时,机器人退出该群并照常删除目录,群留给群主手动解散。
|
|
108
|
-
|
|
109
|
-
## 临时会话与对话分支
|
|
110
|
-
|
|
111
|
-
临时会话共享当前工作目录,适合在同一项目里另开一段对话:
|
|
112
|
-
|
|
113
|
-
| 完整指令 | 缩写 / 别名 | 行为 |
|
|
114
|
-
| --- | --- | --- |
|
|
115
|
-
| `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀,同一个备注对应同一个群。基名跟随当前群:主群是 `<项目>`,WT 群是 `<项目>[分支]`。继承账号、模型并共享该目录配置,启动新会话 |
|
|
116
|
-
| `btwlist` | `bl` | 列出本机登记的全部临时会话:群名、所属项目、创建时间、模型和当前运行状态(运行中的会话附带子 Agent 与后台进程数,如 `🟢 空闲 · 子Agent2·后台1`);当前群会标「本群」 |
|
|
117
|
-
| `fork` | `fk` | 选择一条用户输入,在临时群里从这条输入之前分叉 |
|
|
118
|
-
| `back` | `bk` | 选择一条用户输入,让本群接到这条输入之前的新分支 |
|
|
119
|
-
| `bye` | — | 自己退出临时群;最后一个人退出时停止会话并解散整个群。外部群改为停止会话、机器人退群,由群主手动解散 |
|
|
120
|
-
|
|
121
|
-
`btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态,一次操作只有一张卡、在卡内原地更新。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。发送 `btwlist`(别名 `bl`)可按创建时间倒序查看本机登记的全部临时会话;它只读本地租约、已加载会话和运行中会话的本机进程状态,不会联网刷新群列表。子 Agent 与后台进程数的含义与单聊面板的活跃项目、群里 `hi` 的状态行相同。
|
|
122
|
-
|
|
123
|
-
外部联系人(其他飞书企业的用户)也能在外部群里发 `btw` 或用 `fk` 分叉。前提是应用在「对外共享」中开启「允许外部用户与机器人单聊」,每位外部联系人先点开机器人发起一次单聊并确认。机器人不能当外部群的群主,所以新临时群由当前群的群主当群主,成员是发起人和群主:当前群的群主必须是本企业成员(不能是机器人或发起人本人)且在应用的「可用范围」内,外部联系人还须是群主的飞书联系人;群主不符合时直接报错,不建群。建群被飞书以「看不到成员」拒绝时,提示卡按被拒的成员说明处理办法:发起人须先单聊确认,群主须加入应用的可用范围。带备注的 `btw` 遇到已存在的同名群时直接加入,不需要群主;外部联系人不能加入内部群,同名群是内部群时会提示换一个备注新建。本企业成员在外部群里发 `btw`、用 `fk` 分叉时,新临时群同样建成外部群,由发起人自己当群主,之后外部联系人也能加入(`bye` 同样只让机器人退群,由群主手动解散);在内部群里发起的仍由机器人当群主。群的内外类型建好后就不能再改:之前在外部群里由本企业成员建出的内部临时群,外部联系人仍然进不去。机器人不能解散外部群,也不能移出其中的成员:在外部临时群里,任何成员发 `bye` 都会停止会话并让机器人退群,群本身保留,提示卡会请群主在群设置里手动解散;机器人退群后若本地清理出错,报错发到发起临时群的来源群。新群启动失败的清理和 `wt` 删除分支时也只让机器人退出外部临时群。临时群的报错保留飞书错误码和 log_id,不显示成员 ID。
|
|
124
|
-
|
|
125
|
-
`fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
|
|
126
|
-
|
|
127
|
-
**分叉和回退只改变对话历史,不回滚文件或撤销 Shell、MCP 等外部操作。** `bk` 会附上已观察到的文件变更记录;需要目录隔离时使用 `wt`。
|
|
128
|
-
|
|
129
|
-
## 多模型任务
|
|
130
|
-
|
|
131
|
-
主 Agent 按任务和可用能力自行选择原生 subagent 或 `lodestar-agent`,也可通过 `lodestar-agent` 调用自身的模型或 Agent,但不能使用 Claude 订阅来源。使用 `lodestar-agent` 时先查询实时身份,再把任务交给一个或多个模型。同一个任务选择多个身份时并发执行;后续追问可继续使用各模型的原生会话。
|
|
132
|
-
|
|
133
|
-
Lodestar Agent 不支持调用 Claude 订阅,遵守 Claude 用户协议;中转站等第三方来源的 Claude 模型仍可调用。限制只按来源判断,不按模型名称判断;主会话的 Claude 订阅能力和原生委派工具保持可用。
|
|
134
|
-
|
|
135
|
-
被调用的 Agent 可以编辑文件、执行命令、使用 MCP 和 Skill,也可以通过 Lodestar 或原生子 Agent 继续派工,Lodestar 不设置委派层数上限。它们与主 Agent 共享工作区,修改会立即可见。会话委派需要输入时暂停,由调用方回填答案后继续;项目调用及其后续委派保持非交互执行。委派产生的会话不会混入主会话的 `rs` 历史列表。
|
|
136
|
-
|
|
137
|
-
首层任务默认使用主 Agent 的工作目录,后续委派默认使用调用方的执行目录,不受调用命令时 Shell 当前目录影响。可用 `--workdir <路径>` 指定其中已存在的子目录:相对路径以主 Agent 的工作目录为基准,也支持范围内的绝对路径。路径会解析软链接,越界、目录不存在或指向普通文件都会报错。同一个 run 的多个 Agent 使用同一目录;需要不同目录时分别发起任务。
|
|
138
|
-
|
|
139
|
-
```bash
|
|
140
|
-
# desc: 在项目子目录中委派任务
|
|
141
|
-
lodestar-agent run --identity '<identity-id>' --description '检查应用代码' --workdir 'packages/app' --prompt '检查当前应用的代码并报告结果' --json
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
每次 `run` 和 `follow-up` 必须填写 `--description`(不超过 60 字的单行说明)。委派任务、原生子 Agent 和后台任务统一收在委派卡里,每项只显示状态和一句说明,展开可看任务类型、正文、结果、错误和最近三步动作。子 Agent 启动即展示,普通前台命令不会额外生成任务项;任务结束后显示实际耗时。
|
|
145
|
-
|
|
146
|
-
委派卡始终停在绑定对话 ID 的消息尾部,新任务继续追加。该对话 ID 下出现新消息(包括主 Agent 新开的会话卡和中途换卡)时,旧卡上的未完成项会被清掉,并在最新消息之后重建一张委派卡,进度只写这张卡;已完成项留在原卡作为历史。容量满时新任务另开一张卡,原卡上剩下的未完成项等下一次出现新主卡时再迁移。共享卡等全部任务结束后才停止更新;后续结果撑满卡片时,对应条目移到新卡。多模型委派的完整结果仍保存在任务记录中。
|
|
147
|
-
|
|
148
|
-
每个任务行的标题写任务本身的说明(子 Agent 的任务描述 / 后台命令的说明),不会变成最近一步操作。群列表预览只显示约 15 个字,所以委派卡摘要按任务构成显示:运行中为「⏳ 子Agent1·后台1」,全部结束为「✅ …」,有失败为「❌ 1失败·2完成」,等待回答为「❓ 待回答1」;同时出现三类任务时显示「⏳ 3项进行中」。手机加急通知也按真正的结束发送:回合结束时如果还有后台进程或子 Agent 在跑就等待,最后一个任务结束后如果没有触发新的回合就补发一次;提问和权限审批的加急通知不受影响。
|
|
149
|
-
|
|
150
|
-
首轮完成后,返回内容包含原生会话 ID(文本中的 `Session:`;JSON 中的 `workers[].session_id`)和本轮结果(`workers[].output`)。后续只需传入这个 ID 和新的一句输入:
|
|
151
|
-
|
|
152
|
-
```bash
|
|
153
|
-
# desc: 首轮调用并返回 JSON 结果
|
|
154
|
-
lodestar-agent run --identity '<identity-id>' --description '完成第一步' --prompt '完成第一步' --json
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
```bash
|
|
158
|
-
# desc: 沿用历史会话继续第二轮
|
|
159
|
-
lodestar-agent run --session '<session-id>' --description '继续第二步' --prompt '根据上面的结果继续第二步' --json
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
第二轮及后续轮次恢复同一个后端原生会话,每轮产生新的 `run_id`。已有 Lodestar 历史时,省略 `--identity` 会沿用最新记录的身份和 effort;也可显式选择原后端下的其他身份、模型来源及 `--effort`。切换身份且不指定 effort 时,使用新身份的默认档位。多模型首轮分别返回各 worker 的会话 ID,续跑时一次选择一个会话。也可使用 `lodestar-agent follow-up '<run-id>' --description '继续下一步' --prompt '下一步'`;原 run 包含多个 Agent 时需用 `--identity` 选择原 worker,若还需换模型,使用该 worker 的原生会话 ID 加新身份恢复。
|
|
163
|
-
|
|
164
|
-
`session_id` 是原生会话唯一且不变的 ID;`run_id` 只是一次调用记录,不是另一套会话 ID。对话 ID(`chat_id`)标识调用的绑定对象,与原生会话 ID 不同;同一对话 ID 可以拥有多个原生会话。原生会话归属项目和对话 ID,`run --session` 与 `follow-up` 只允许恢复同一项目、同一对话 ID 下的已登记会话,不要求与原调用使用相同的会话绑定或项目绑定。禁止跨项目、跨对话 ID;未知或归属不明的原生会话 ID 即使指定 `--identity` 也会报错。
|
|
165
|
-
|
|
166
|
-
```bash
|
|
167
|
-
# desc: 在当前会话中恢复同项目同对话 ID 的原生会话
|
|
168
|
-
lodestar-agent run --session '<原生会话 ID>' --identity '<identity-id>' --workdir 'packages/app' --description '继续已有工作' --prompt '继续上一轮任务' --json
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
恢复时 `--workdir` 可选择本项目内的其他现有目录,省略则沿用历史执行目录;相对路径以当前项目目录解析。项目以规范工作目录识别,对话 ID 对应 `chat_id`;子目录不改变所属项目。新调用依照调用场景绑定当前会话或项目,旧记录不迁移。同项目同对话 ID 下切换绑定方式时,旧调用的取消不会连带停止新调用。原生会话 ID 和所属后端保持不变,模型、来源与 effort 可以在原后端支持且不使用 Claude 订阅来源的范围内调整。
|
|
172
|
-
|
|
173
|
-
同一个后端原生会话在开卡和执行期间不能重叠恢复。多 Agent 任务中某个 worker 已结束并退出后,可以单独续跑它,无需等待其他 worker。`run`、`follow-up`、`status` 支持 `--json`;返回的 `work_dir` 是实际执行目录,`resumed_from_run_id` 仅记录可用的恢复来源,不建立跨绑定方式的取消关系。使用 `--stdin` 可输入多行任务,`--no-wait` 立即返回启动状态。HTTP API 的 `session_id`、`identity_ids` / `identity_id` 和 `work_dir` 遵循同一规则。
|
|
174
|
-
|
|
175
|
-
会话委派与项目调用均不设置本地并发或任务数量上限,OpenRouter 也没有单独的本地限制。任务正文和 Agent API 请求体也不设置本地长度或大小上限。任务开卡后直接启动,上游限流和进程启动失败会明确返回错误。
|
|
176
|
-
|
|
177
|
-
Agent 在执行任务中调用其他 Agent 或模型时,必须绑定当前会话,使用不带 `--project` 的命令;通过 Shell、Python 或脚本调用也适用。禁止清除会话环境或借用项目凭据转成项目调用。没有有效会话上下文必须报错。独立服务、定时任务及其他软件调用必须使用项目绑定。两种模式不能作为失败后的替代路径,详见 [Agent Skill](../src/agent-skill.ts)。
|
|
178
|
-
|
|
179
|
-
### 从终端或脚本调用项目 Agent
|
|
180
|
-
|
|
181
|
-
独立服务、定时任务或其他软件通过 `--project <项目名>` 直接调用本机 daemon,无需在对应对话 ID 下启动主 Agent;Agent 执行用户任务时不能使用此入口。项目必须已有明确的对话 ID 绑定和现有目录;worktree 使用完整的 `项目名[分支名]`,BTW/FK 临时会话名不作为项目入口。
|
|
182
|
-
|
|
183
|
-
```bash
|
|
184
|
-
# desc: 查询项目可用身份并发起独立任务
|
|
185
|
-
lodestar-agent --project '<项目名>' identities --json
|
|
186
|
-
lodestar-agent --project '<项目名>' run --identity '<identity-id>' --description '检查项目' --prompt '检查代码并报告结果' --request-id '<本次业务调用唯一编号>' --no-wait
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
每次项目调用在绑定对话 ID 下新建独立的“项目任务”卡,后续进度和结果更新原卡。它不复用会话委派卡,不读取或修改主会话的模型、账号和上下文;停止、重启、切换主会话不影响项目任务。可点击任务卡的“停止本次任务”,或使用同一 `--project` 下的 `cancel <run-id>`。两类任务仍共享实际工作目录。
|
|
190
|
-
|
|
191
|
-
项目入口面向传统软件,执行约定是不给调用方提问、不等待回答。调用方给出目标后,Agent 自行查明上下文、作出任务范围内的实现决策、持续执行并验证,直至完整完成目标;不能以计划、部分工作、索取输入或要求调用方安排更多 Agent 作为完成结果。真实阻断或底层故障仍须如实报告,不能伪造完成。`answer` 用于会话归属的各层委派,不支持 `--project`。
|
|
192
|
-
|
|
193
|
-
外部调用中的 Codex 同步、异步提问工具均会禁用,GPT-6 代码模式仍可执行任务。工具约束按本次调用生成;主 Agent 委派保留提问能力。
|
|
194
|
-
|
|
195
|
-
`status`、`follow-up` 和 `run --session` 均支持 `--project`;最后一个仍表示继续任务自身的原生 Agent 会话。只能恢复当前项目、当前对话 ID 下已登记的原生会话;本轮按项目绑定创建,旧记录不迁移。新建和续跑都按本轮绑定决定是否允许提问,项目调用不会继承旧会话的交互规则。没有 `--no-wait` 时客户端等到任务终态;等待期间 Ctrl+C 会取消任务,普通 HTTP 断开不会取消已接受的任务。
|
|
196
|
-
|
|
197
|
-
```bash
|
|
198
|
-
# desc: 查询项目任务状态和执行结果
|
|
199
|
-
lodestar-agent --project '<项目名>' status '<run-id>' --json
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
对话 ID 下的普通消息仍交给主会话。会话委派和项目任务均只向调用方返回结果与本地文件路径,由主 Agent 或调用程序处理交付。`--project` 不注入主会话的文件交付规则,也不上传附件、设置权限或执行输出中的交付标记;新建任务和续跑旧会话都遵循此规则。
|
|
203
|
-
|
|
204
|
-
项目任务的 `run` / `follow-up` 可用 `--request-id` 防止超时重试重复执行:同一归属、同一编号及相同输入返回原任务,输入不同则拒绝,daemon 重启后仍有效。重启不会自动重跑未完成任务;遗留非终态任务标为失败,已有原生会话可显式续跑。
|
|
205
|
-
|
|
206
|
-
HTTP 使用原 `/agents/…` 路径并增加 `?project=<项目名>`,Bearer 凭据来自 daemon 启动时生成的私有 `agent-project-client.json`(状态目录内,本机同用户读取,重启后轮换)。CLI 自动读取,无需配置或输出凭据。项目凭据只用于显式项目路由,会话和 worker 凭据不能用来调用项目路由。请求体可增加 `request_id`;`requester_open_id`(CLI `--requester`)保留为调用方记录,不触发文件交付或授权。响应中的 `binding: "project"`、`project` 标明归属。旧会话接口保持原调用方式。
|
|
207
|
-
|
|
208
|
-
## 飞书任务清单
|
|
209
|
-
|
|
210
|
-
发 `task`,点“启用”可为当前项目创建并绑定 `<project>[lodestar]` 任务清单。主群、同一项目的所有 WT 及其 BTW/FK 临时群共用清单。在其中任一群删除清单,都作用于整个项目;删除需要在卡片上再次确认,会删除整个清单及其中任务。该面板管理清单绑定,任务执行由用户和 Agent 安排。
|
|
211
|
-
|
|
212
|
-
## 本机通知
|
|
213
|
-
|
|
214
|
-
脚本可通过 HTTP 向项目绑定的对话发送通知,支持 `info`、`warn`、`error`,以及本地图片、交互按钮或文字回复:
|
|
215
|
-
|
|
216
|
-
```bash
|
|
217
|
-
curl -sS -X POST http://127.0.0.1:9876/notify \
|
|
218
|
-
-H 'Content-Type: application/json' \
|
|
219
|
-
-d '{"project":"ops","level":"error","text":"构建失败,截图如下","images":["/abs/shot.png"]}'
|
|
220
|
-
```
|
|
221
|
-
|
|
222
|
-
按钮点击结果可以 POST 到指定的本机 `callback`,或通过 `GET /notify/result/<notify_id>` 查询。需要文字回复时设置 `allow_reply: true`,卡片会提供“回复”按钮;文字回复模式与自定义按钮模式不能同时启用。字段和协议见 [feishu-notify Skill](../src/notify-skill.ts)。daemon 启动时会将该 Skill 同步到 Codex 和 Claude 的 Skill 目录。
|
|
223
|
-
|
|
224
|
-
通知 JSON 正文上限为 4 MiB,超出返回 `413`;图片仍通过本地路径提供。该端口只面向本机脚本和 Agent:浏览器页面发来的跨站请求(带非本机 `Origin`)返回 `403`,本机回环地址上的页面不受影响。按钮回调或文字回复发送期间若 daemon 中断,重启后会在原卡显示“送达状态未知”并禁止再次发送,请先向接收方核实处理结果;该提示只展示一次,若展示失败则在下次启动时重试。通知状态文件无法读取或 JSON 损坏会明确阻止启动,避免丢失去重记录后重复执行。
|
|
225
|
-
|
|
226
|
-
## 文件与生图
|
|
227
|
-
|
|
228
|
-
Agent 用 `[[send: /abs/path]]` 交付本地文件。**单文件不超过 30 MB(30 × 1024 × 1024 字节)自动发聊天附件,超过 30 MB 自动传云空间**。按每个文件的实际大小分别选择,同一轮可同时交付聊天附件和云空间文件,无需切换命令。原来的文件、图片消息通道保留。
|
|
229
|
-
|
|
230
|
-
Codex、Claude Code 和 DSH 使用统一的飞书通道插件约定:按需读取附件、检查文件后输出交付标记,以及为 shell 命令提供中文摘要。交付方式由通道插件管理,不需要 Agent 查询配置或调用上传接口,也无需额外安装 Skill。交付标记是提交请求,实际结果以附件、交付卡及错误提示为准。
|
|
231
|
-
|
|
232
|
-
安装或更新时会自动删除旧 `lodestar-files` Skill 在 Codex、Claude 和共享插件目录中的受管副本;新版 daemon 启动时也会清理。清理沿用本机数据目录设置,失败会明确报错;显式设置 `LODESTAR_DISABLE_SKILL_SYNC=1` 时保留手工管理的 Skill。
|
|
233
|
-
|
|
234
|
-
每个项目主群首次交付超过 30 MB 的文件时,会自动在云空间创建目录,并按主群 `chat_id` 保存固定绑定,之后各轮的大文件都直接放进这个目录。WT 群和 BTW/FK 临时群不单独建目录,一律进对应主群目录,临时群只额外获得查看权限;目录名跟随主群实时群名,`*备注`、`[分支]` 后缀不会写进目录名。重启后继续复用原目录,不同主群之间不共用目录。主群改名后,下次云空间交付会同步文件夹名称;解析不到主群、目录丢失或不可访问时明确报错,不自动新建空目录掩盖问题。云空间网关偶发丢弃创建请求的请求体并返回 `Missing required parameter` 时,会重发同一请求一次;该拒绝发生在建目录之前,不会重复创建。
|
|
235
|
-
|
|
236
|
-
有云空间文件的轮次结束后,会发送独立“交付文件”卡片,**只列本轮新交付的云空间文件**的名称、大小和访问链接。点击文件名打开文件;点击“管理群文件”打开飞书原生文件夹,查看该群所有历史云空间交付文件,并使用重命名、移动和删除等功能。交付发起人会获得群文件夹管理权限(`full_access`),群成员可查看(`view`)。文件不自动清理;历史卡片是交付时的记录,文件夹展示当前状态,已删除文件的旧链接会失效。
|
|
237
|
-
|
|
238
|
-
群文件夹绑定保存在私有 `file-delivery-groups.json`。升级后忽略旧版的工作目录和群开关,已有文件夹绑定、管理者和云空间文件继续保留;之前发送到聊天的附件不删除,也不自动迁移至云空间。
|
|
239
|
-
|
|
240
|
-
**云空间需要同时开通应用身份权限 `drive:drive`、`drive:file:upload`**;后者是文件夹自动改名接口单独要求的权限,前者不能替代。安装向导的[完整权限清单](feishu-permissions.json)已包含这两项,升级用户可补齐后发布飞书应用版本。整个过程不依赖飞书 CLI,也不需要用户授权登录。云空间交付须有可识别的发起人,缺少身份或权限时明确报错。超过 30 MB 的文件按飞书策略分片上传;实际大小上限与容量由账号决定,不能把企业基础版的认证限额直接套用于飞书个人版。交付失败不会自动切换通道。自动生图仍沿用下面的图片展示规则。
|
|
241
|
-
|
|
242
|
-
新上传文件会单独关闭“组织内或互联网获得链接即可访问”的分享入口,并读回确认后才发布交付链接;文件夹关闭链接分享不会自动覆盖新文件的默认设置。群成员通过群文件夹的协作者权限访问。已有协作者仍可按飞书权限设置进行人工分享,本功能不阻止人工转授权。
|
|
243
|
-
|
|
244
|
-
聊天消息、卡片写入和聊天附件/图片上传遇到短暂故障时,会在一分钟恢复窗口内自动重试;窗口内恢复成功不在群里告警,仍失败才提示,并保留具体诊断。卡片的重试、写入确认与流式重开共用同一个窗口,服务端要求更长等待时不会提前重发。每次实际操作有自己的恢复窗口,排队与上传后发送等多个步骤的耗时可能累加。本地文件问题和主动取消立即处理。云空间创建目录、上传完成等操作仍保持有限重试,避免扩大重复创建风险;分片重试复用相同内容,上传期间本地大文件发生修改会中止完成上传。停止或重启会话会取消未完成的云空间上传,已上传文件保留;链接查询、权限或交付卡发送失败也会明确显示。
|
|
245
|
-
|
|
246
|
-
Codex 生图完成后,不超过 30 MB 的图片与提示词放在同一个折叠面板中,点击展开查看图片并放大预览。无法嵌入时,图片仍会单独发送;超过 30 MB 的图片自动转云空间交付。
|