@leviyuan/lodestar 0.17.4 → 0.17.6

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

@@ -34,6 +34,8 @@
 
 新会话和委派任务启动时默认自动选号。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 自动选号。重新登录仍与实际占用账号的原生进程互斥，添加其他备注账号可独立进行。
@@ -76,6 +78,22 @@ Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会
 
 被调用的 Agent 可以编辑文件、执行命令、使用 MCP 和 Skill；委派只允许一层，被调用的 Agent 不能继续派工。它们与主 Agent 共享工作区，修改会立即可见。运行状态和结果通过卡片展示；需要用户输入时暂停，由主 Agent 回填答案后继续。委派产生的会话不会混入主群的 `rs` 历史列表。
 
+首轮完成后，返回内容包含原生会话 ID（文本中的 `Session:`；JSON 中的 `workers[].session_id`）和本轮结果（`workers[].output`）。后续只需传入这个 ID 和新的一句输入：
+
+```bash
+# desc: 首轮调用并返回 JSON 结果
+lodestar-agent run --identity '<identity-id>' --prompt '完成第一步' --json
+```
+
+```bash
+# desc: 沿用历史会话继续第二轮
+lodestar-agent run --session '<session-id>' --prompt '根据上面的结果继续第二步' --json
+```
+
+第二轮及后续轮次恢复同一个后端原生会话，自动沿用原身份和上一轮的 effort，每轮产生新的 `run_id`。`--identity` 可省略，指定时必须与原身份一致；可用 `--effort` 显式选择本轮档位。多模型首轮会分别返回各 worker 的会话 ID，续跑时一次选择一个会话。也可继续使用 `lodestar-agent follow-up '<run-id>' --prompt '下一步'`；原 run 包含多个 Agent 时需用 `--identity` 指定。
+
+续跑要求原任务已经结束，且属于同一个 Lodestar 群会话和工作目录。持久化的委派历史仍可用时，daemon 重启后也可凭原会话 ID 继续；会话不存在、身份不可用或原生恢复失败会报错。同一个原生会话不能同时执行两轮。`run`、`follow-up`、`status` 支持 `--json`；使用 `--stdin` 可输入多行任务，`--no-wait` 立即返回启动状态，随后通过 `status <run-id>` 查询结果。
+
 `lodestar-agent` 只能在 Lodestar 管理的 Agent 进程里调用。命令用法见 [Agent Skill](../src/agent-skill.ts)。
 
 ## 飞书任务清单

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.17.4",
+  "version": "0.17.6",
   "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"
+  }
 }