@leviyuan/lodestar 0.17.3 → 0.17.5

package/docs/configuration.md

@@ -65,6 +65,18 @@ bin = "/abs/path/to/claude-wrapper"  # 可选的 Claude 可执行文件
 
 账号配置、OpenRouter 默认模型和 DSH 接入见[模型与账号](models.md)。手动修改配置后需重启 daemon；群内设置自行保存。
 
+## HTTP 代理
+
+OpenRouter 的模型目录与余额查询，以及 Lodestar 自己发出的其他 HTTP 请求，共用相同的代理选择。无需开启 TUN，也不需要给每个 Token Source 单独配置代理。
+
+对每个目标地址，优先使用对应的 `HTTP_PROXY` / `HTTPS_PROXY`，未设置时使用 `ALL_PROXY`，都未设置时读取当前运行用户的系统代理。小写变量优先于大写，空值视为未设置。支持 HTTP 和 HTTPS 代理及 URL 中的用户名、密码；不要把凭据写入仓库。
+
+系统设置支持 Windows 当前用户的手动代理、macOS 网络代理，以及 Linux 的 GNOME/KDE 手动代理；最多缓存 30 秒。Linux 没有对应桌面设置时使用环境变量。PAC、自动发现、SOCKS 和 KDE 反向例外列表尚不支持，遇到这些配置会明确报错；系统设置读取失败或代理连接失败也不会自动直连。可用明确的 HTTP(S) 代理环境变量覆盖系统设置。
+
+`NO_PROXY` 支持逗号、空白或分号分隔的域名、子域名、端口、IPv4/IPv6 CIDR 和 `*`。回环地址始终直连，内部通知与 Agent capability 请求还会拒绝跳转到外网。外部请求重定向后重新判断代理，并在跨 origin 时清除认证信息。
+
+服务进程读取它自己的环境及运行用户的设置。在终端里 `export HTTPS_PROXY=...` 不会修改已经运行的 systemd/launchd/Windows 服务；应在对应服务的环境中设置。代理设置只作用于 Lodestar 自有 HTTP：Codex、Claude、DSH 与 npm 的网络继续遵循各自应用配置，飞书 SDK 的 HTTP/WebSocket 也保留其原生配置方式。`[claude.env]`、`[codex.env]` 不是 daemon 的全局代理设置。
+
 ## 源码开发
 
 安装 Bun，在仓库根目录运行：

package/docs/usage.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.17.3",
+  "version": "0.17.5",
   "publishConfig": {
     "access": "public"
   },
@@ -73,8 +73,11 @@
     "cross-spawn": "^7.0.6",
     "fast-uri": "3.1.6",
     "hono": "4.13.5",
+    "http-proxy-agent": "^7.0.2",
+    "https-proxy-agent": "^7.0.6",
     "ip-address": "10.5.0",
     "mathjax-full": "^3.2.2",
+    "node-fetch": "^3.3.2",
     "protobufjs": "7.6.5",
     "qs": "6.16.0",
     "ws": "8.21.3",
@@ -338,5 +341,8 @@
   "trustedDependencies": [
     "@deepseek-ai/dsh-subprocess-local",
     "koffi"
-  ]
+  ],
+  "optionalDependencies": {
+    "undici": "^6.28.1"
+  }
 }