@leviyuan/lodestar 0.18.6 → 0.18.8

package/docs/models.md

@@ -29,12 +29,38 @@
 
 在运行 Lodestar 的本机通过 `claude auth login` 登录 Claude 订阅后，发送 `md` → Claude Code → **Claude Code 订阅**。来源 id 为 `claude-sub`，可与 GLM、DeepSeek、OpenRouter 同时使用；无需复制登录凭据或填写 API key。
 
-账号和模型目录通过 Claude Code 原生 SDK 查询，模型与 effort 随目录更新；未登录会显示启用引导，查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`，支持 `display`、`model`、`effort`、`hidden_models` 和 `custom_models`。
+发送 `claude-sub` 查看开关和可用状态，`claude-sub on` 启用，`claude-sub off` 禁用。开关对这台 Lodestar 的所有群生效并持久保存，只控制「Claude Code 订阅」来源，保留本机登录态及其他来源。禁用后不查询订阅模型和额度、不接受新任务；尚未送入 Agent 的排队消息会提示重发，已经在执行的任务继续完成。再次启用后仍须有有效订阅登录；ReClaude 启用期间，订阅入口继续停用并显示原因。
+
+账号和模型目录通过 Claude Code 原生 SDK 查询，模型与 effort 随目录更新；未登录会显示启用引导，查询失败显示 `MISS`。可选配置节为 `[token_source.claude-sub]`，支持 `enabled`、`display`、`model`、`effort`、`hidden_models` 和 `custom_models`。`enabled = false` 禁用，`enabled = true` 或省略时沿用本机登录检测；群命令更新该字段。
 
 订阅额度通过原生 `/usage` 控制接口读取，无需发送模型对话。`hi` 展示 5 小时、总周额度和接口返回的模型专属周额度及重置倒计时。回复底部同时显示 5 小时额度与周额度：本轮所选模型有专属周额度时显示该模型的额度，否则显示总周额度，沿用紧凑格式。查询失败或缺失数据显示 `MISS`，不使用旧额度替代，也不将缺失的专属额度改成总额度。此 SDK 查询接口仍属实验接口，版本不支持或接口变化时明确报错。
 
 订阅进程保留本机和项目的 Claude 设置，并在进程内清除其他来源的 API key、模型映射和中转路由。发送任务前会再次核对实际账号是否为第一方订阅。Claude native 继续保留为使用本机完整配置的来源。
 
+## ReClaude 拼车
+
+在运行 Lodestar 的本机按 [ReClaude 官方说明](https://docs.reclaude.ai/cli/install)安装客户端，执行 `reclaude login` 完成浏览器设备授权并选择拼车组织，再运行 `reclaude daemon --detach` 启动官方后台。Linux 后台由用户 systemd 管理。
+
+**客户端会接管本机 Claude 登录**，并在账号变化时终止其管理的 Claude 进程。Lodestar 启用 ReClaude 后停用重复的「Claude Code 订阅」入口。退出 ReClaude 并恢复原生登录按官方客户端的 `reclaude logout` 流程操作。
+
+在群内发送 `reclaude-setup <拼车组织 ID> [个人只读 API key]`，然后通过 `md` → Claude Code → **ReClaude** 选择模型。也可以在配置文件中添加：
+
+```toml
+[token_source.reclaude]
+agent = "claude"
+auth = "reclaude-login"
+org_id = "填写拼车组织 ID"
+api_key = "填写 rck_ 个人只读 API key"
+# model = "opus"   # 可选；模型和 effort 来自 SDK 原生目录
+# effort = "max"
+```
+
+个人 `rck_` key 仅查询指定组织的拼车 5 小时额度，不用于模型认证。组织 ID 可从个人 API 的 `GET /api/v1/orgs` 查询。未填写只读 key 不影响已登录客户端的模型调用，额度显示 `MISS`。接口里的美元金额是该窗口的用量口径，不是账户余额；重置时间未返回时保留未知，不推算周额度。
+
+模型运行保持 Claude Agent SDK 默认入口，无需设置 `[claude].bin`。ReClaude 来源校验本机设备登录、对应 Claude 凭据、后台进程和 CA，然后只为此来源的 SDK 子进程设置官方本机代理。客户端未运行、登录不匹配、模型目录失败和网关错误均明确报错，不切换到其他账号。安装、登录和后台启动由用户管理，Lodestar 不自动安装或启动 ReClaude。
+
+恢复检测脚本为 `bun scripts/watch-reclaude.ts --project <群项目名> --model haiku --interval-seconds 300`。它用极短的真实对话确认恢复，可能消耗拼车额度；首次成功后停止模型请求，经本机通知接口确认群消息发送成功后退出。通知失败每分钟重试，仅重试通知。状态保存在数据目录的 `reclaude-watch/`，已成功或已通知的记录在再次运行时仍有效，不会重复消耗模型额度。`--once` 只执行一轮。常驻时用 `systemd-run --user --unit=cc-<项目>-reclaude-watch -- <Bun绝对路径> <脚本绝对路径> ...` 管理；这不会重启 Lodestar。
+
 ## OpenRouter
 
 OpenRouter 通过 Claude Agent SDK 运行。在群内发送 `openrouter-setup <api_key>`，再通过 `model` 面板选择模型和 effort；自建兼容端点用 `openrouter-setup <base_url> <api_key>`。也可在配置文件中添加：

package/docs/usage.md

@@ -16,6 +16,9 @@
 | `clear` | `cl` | 关闭当前进程并开始新会话；已停止时提示先启动 |
 | `compact` | `cm` | 压缩当前会话的上下文 |
 | `agents` | `agent` | 查看可调用的 Agent 身份及可用状态 |
+| `claude-sub` | — | 查看 Claude Code 订阅在 Lodestar 中的开关和可用状态 |
+| `claude-sub on` | — | 启用 Claude Code 订阅来源，所有群共用 |
+| `claude-sub off` | — | 禁用 Claude Code 订阅来源，保留本机登录态，所有群共用 |
 | `codex-login [备注]` | — | 用设备码登录 Codex；省略备注为设备默认账号，带备注为独立保存的额外账号 |
 | `codex-login-cancel [备注]` | — | 取消本人在本群发起的 Codex 登录；只有一个等待任务时可省略备注 |
 | `codex-accounts [页码]` | — | 卡片列出账号额度、调度分数、顺序与当前/优先账号标记 |
@@ -89,6 +92,13 @@ Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会
 
 被调用的 Agent 可以编辑文件、执行命令、使用 MCP 和 Skill；委派只允许一层，被调用的 Agent 不能继续派工。它们与主 Agent 共享工作区，修改会立即可见。需要用户输入时暂停，由主 Agent 回填答案后继续。委派产生的会话不会混入主群的 `rs` 历史列表。
 
+新任务默认使用主 Agent 的工作目录，不受调用命令时 Shell 当前目录影响。可用 `--workdir <路径>` 指定其中已存在的子目录：相对路径以主 Agent 的工作目录为基准，也支持范围内的绝对路径。路径会解析软链接，越界、目录不存在或指向普通文件都会报错。同一个 run 的多个 Agent 使用同一目录；需要不同目录时分别发起任务。
+
+```bash
+# desc: 在项目子目录中委派任务
+lodestar-agent run --identity '<identity-id>' --description '检查应用代码' --workdir 'packages/app' --prompt '检查当前应用的代码并报告结果' --json
+```
+
 每次 `run` 和 `follow-up` 必须填写 `--description`（不超过 60 字的单行说明）。委派任务、原生子 Agent 和后台任务统一收在委派卡里，每项只显示状态和一句说明，展开可看任务类型、正文、结果、错误和最近三步动作。子 Agent 启动即展示，普通前台命令不会额外生成任务项；任务结束后显示实际耗时。
 
 委派卡仍在群对话尾部时，新任务继续追加；容量满或群里出现新消息（包括主 Agent 新开的会话卡）后，下一项另开卡。旧任务继续原地更新，后台任务不再随新消息迁移。共享卡等全部任务结束后才停止更新；后续结果撑满卡片时，对应条目移到新卡。多模型委派的完整结果仍保存在任务记录中。
@@ -107,7 +117,7 @@ lodestar-agent run --session '<session-id>' --description '继续第二步' --pr
 
 第二轮及后续轮次恢复同一个后端原生会话，自动沿用原身份和上一轮的 effort，每轮产生新的 `run_id`。`--identity` 可省略，指定时必须与原身份一致；可用 `--effort` 显式选择本轮档位。多模型首轮会分别返回各 worker 的会话 ID，续跑时一次选择一个会话。也可继续使用 `lodestar-agent follow-up '<run-id>' --description '继续下一步' --prompt '下一步'`；原 run 包含多个 Agent 时需用 `--identity` 指定。
 
-续跑要求原任务已经结束，且属于同一个 Lodestar 群会话和工作目录。持久化的委派历史仍可用时，daemon 重启后也可凭原会话 ID 继续；会话不存在、身份不可用或原生恢复失败会报错。同一个原生会话不能同时执行两轮。`run`、`follow-up`、`status` 支持 `--json`；使用 `--stdin` 可输入多行任务，`--no-wait` 立即返回启动状态，随后通过 `status <run-id>` 查询结果。
+续跑要求原任务已经结束，且属于同一个 Lodestar 群会话和主 Agent 工作目录。`run --session` 和 `follow-up` 自动保留原任务目录；续跑时若填写 `--workdir`，必须仍指向原目录，更换目录需要新建任务。持久化的委派历史仍可用时，daemon 重启后也可凭原会话 ID 继续；会话不存在、身份不可用或原生恢复失败会报错。同一个原生会话不能同时执行两轮。`run`、`follow-up`、`status` 支持 `--json`，返回的 `work_dir` 表示实际工作目录；使用 `--stdin` 可输入多行任务，`--no-wait` 立即返回启动状态，随后通过 `status <run-id>` 查询结果。HTTP API 的 `POST /agents/runs` 和 `POST /agents/runs/<run-id>/follow-up` 同样接受可选的 `work_dir`。
 
 `lodestar-agent` 只能在 Lodestar 管理的 Agent 进程里调用。命令用法见 [Agent Skill](../src/agent-skill.ts)。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.18.6",
+  "version": "0.18.8",
   "publishConfig": {
     "access": "public"
   },