@leviyuan/lodestar 0.17.3 → 0.17.4
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 +11 -11
- package/dist/lodestar-stop.js +2 -2
- package/dist/lodestar-update.js +7 -7
- package/dist/lodestar-version.js +1 -1
- package/dist/lodestar.js +181 -176
- package/docs/usage.md +24 -0
- package/package.json +1 -1
package/docs/usage.md
CHANGED
|
@@ -16,10 +16,34 @@
|
|
|
16
16
|
| `clear` | `cl` | 关闭当前进程并开始新会话；已停止时提示先启动 |
|
|
17
17
|
| `compact` | `cm` | 压缩当前会话的上下文 |
|
|
18
18
|
| `agents` | `agent` | 查看可调用的 Agent 身份及可用状态 |
|
|
19
|
+
| `codex-login [备注]` | — | 用设备码登录 Codex；省略备注为设备默认账号，带备注为独立保存的额外账号 |
|
|
20
|
+
| `codex-login-cancel [备注]` | — | 取消本人在本群发起的 Codex 登录；只有一个等待任务时可省略备注 |
|
|
21
|
+
| `codex-accounts [页码]` | — | 卡片列出账号额度、调度分数、顺序与当前/优先账号标记 |
|
|
22
|
+
| `hi 备注` | — | 指定本次启动的 Codex 账号；`hi default` 使用设备默认账号，运行中换号会重启并恢复原 thread |
|
|
23
|
+
| `codex-account [备注]` | — | 查看本群选号策略；带备注指定后续启动的账号，`default` 表示设备默认账号 |
|
|
24
|
+
| `codex-auto` | — | 清除本群手动指定，恢复自动选择最高分账号 |
|
|
19
25
|
| `task` | — | 创建、查看或删除绑定的飞书任务清单 |
|
|
20
26
|
|
|
21
27
|
模型列表来自各账号的模型目录，获取失败显示 `MISS`。同账号切换 Claude 或 DSH 模型从后续回复生效，Codex 的持久模型设置需重启会话生效；跨账号或后端切换只允许在空闲时进行。账号接入、模型补录与额度说明见[账号与模型](models.md)。
|
|
22
28
|
|
|
29
|
+
## Codex 设备码登录与多账号
|
|
30
|
+
|
|
31
|
+
默认账号沿用设备上直接执行 `codex` 的登录态：使用 daemon 原始环境中的 `CODEX_HOME`，未设置时为 `~/.codex`。`codex-account` 只改变当前群后续 Codex 进程的认证选择，不覆盖默认账号，也不改变其他群。额外账号的备注名可包含中文和空格，不能包含换行或路径分隔符；`default`、`默认` 为保留名称。
|
|
32
|
+
|
|
33
|
+
发送 `codex-login 工作` 后，Lodestar 会显示登录卡片，并在同一张卡里更新连接、授权、校验和结果。验证码与授权入口突出显示，结束后移除验证码。在手机或电脑浏览器中登录要保存的账号，输入验证码；授权结果会自动发回原群。凭据由 Codex 保存并刷新，不需要把密码或 Token 发给机器人。设备码登录须已在 ChatGPT 个人安全设置或工作区权限中启用；登录等待上限为 15 分钟，失败后重新发送命令。
|
|
34
|
+
|
|
35
|
+
新会话和委派任务启动时默认自动选号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算（原生套餐标识为 `plus`、`prolite`、`pro`），周分数为 **周剩余份额 ÷ 距周重置小时数**。Plus 的满 5h 窗口按 0.15 份计算，短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**，最终取周分数和短窗分数的较小值；Pro 使用周分数。所有模式都选择最高分，同分优先当前可连续使用额度更多的账号。两种窗口约束同一份消耗，不相加。
|
|
36
|
+
|
|
37
|
+
成功读取 Plus 额度但未返回 5h 窗口时，按满额 0.15 份、完整 5 小时计算短窗分数；界面显示满额，但不编造具体重置时刻。整个请求失败、已返回窗口缺百分比或缺重置时间仍显示 MISS。自动 Ultra 只用 Pro，且启动或换号时周余量至少 0.5 份（Pro 5× 剩 10%，Pro 20× 剩 2.5%）；运行中跌破该门槛不立即切号。没有合格 Pro 时等待周额度恢复，不自动用 Plus。其他实际限额、登录状态、目标模型与 effort、账号身份和查询错误仍参与自动选择。
|
|
38
|
+
|
|
39
|
+
手动指定最高优先级：`hi 工作` 直接使用该账号启动，不读额度、不限制 Plus/Ultra、不检查 0.5 份门槛，也不因本地目录失败或未收录模型而阻挡，真实登录及请求错误由 Codex 返回。只覆盖本次启动，不改变原有群偏好；同一账号正在运行时展示状态，换号会重启并恢复原 thread。`hi default` 指定设备原生账号。需要持久指定时仍可用 `codex-account 工作` 后 `restart`，`codex-auto` 清除该设置。运行过程中确认耗尽后按自动规则换号续跑。临时会话继承持久策略，委派任务按自己的 effort 自动选号。重新登录仍与实际占用账号的原生进程互斥，添加其他备注账号可独立进行。
|
|
40
|
+
|
|
41
|
+
原生主 turn 确认额度耗尽后，Lodestar 自动确认会话落盘、停止旧 Codex 进程，用下一账号恢复同一 thread 并继续任务；已接受的原始输入不重放，明确拒绝的输入才重新提交。连续耗尽会继续换号，所有可用账号耗尽则等待接口确认恢复，`stop` 可取消。网络、认证、普通 HTTP 429 和模型满载不触发换号；模型满载保留原来的同模型重试。额度耗尽记录保存在私有 `codex-quota-blocks.json`，防止重启后使用尚未恢复的账号。退出或落盘确认失败会显示错误，并阻止新进程接管。
|
|
42
|
+
|
|
43
|
+
Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会话、Skills、插件文件和会话写锁，SQLite 状态使用共享目录；认证文件、模型缓存和临时运行文件保持独立。Windows 创建文件软链接需要系统允许；失败直接报告，不自动改用复制。账号备注与群选择位于 Lodestar 数据目录的 `codex-accounts.json`，额外认证位于 `codex-accounts/<内部 ID>/auth.json`。这些文件不应进入项目仓库。
|
|
44
|
+
|
|
45
|
+
账号命令统一回复简洁卡片：长错误和附加额度可展开查看；`codex-accounts` 每页显示 4 个记录，同时标出当前模式下的顺序和 `份/h` 分数，后续页用 `codex-accounts 2` 等命令查看。列表按账号身份去重，未知身份或查询失败显示 `MISS`。`hi` 与回复 footer 只显示实际使用账号的额度；footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式，自动换号后跟随新账号。重置卡次数只出现在账号明细和 `hi` 中。
|
|
46
|
+
|
|
23
47
|
## 独立工作区
|
|
24
48
|
|
|
25
49
|
需要独立修改文件时，在项目主群使用 worktree：
|