@leviyuan/lodestar 0.19.11 → 0.19.13
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/dsh-bridge.js +2 -0
- package/dist/lodestar-agent.js +41 -41
- package/dist/lodestar.js +222 -221
- package/docs/usage.md +11 -6
- package/package.json +1 -1
package/docs/usage.md
CHANGED
|
@@ -138,7 +138,9 @@ lodestar-agent run --session '<原生会话 ID>' --identity '<identity-id>' --wo
|
|
|
138
138
|
|
|
139
139
|
恢复时 `--workdir` 可选择本项目内的其他现有目录,省略则沿用历史执行目录;相对路径以当前项目目录解析。项目以规范工作目录识别,群以 `chat_id` 识别;子目录不改变所属项目。新调用依照调用场景绑定当前会话或项目,旧记录不迁移。同项目同群内切换绑定方式时,旧调用的取消不会连带停止新调用。原生会话 ID 和所属后端保持不变,模型、来源与 effort 可以在原后端支持范围内调整。
|
|
140
140
|
|
|
141
|
-
|
|
141
|
+
同一个后端原生会话在开卡和执行期间不能重叠恢复。多 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` 遵循同一规则。
|
|
142
|
+
|
|
143
|
+
会话委派与项目调用均不设置本地并发或任务数量上限,OpenRouter 也没有单独的本地限制。任务开卡后直接启动,上游限流和进程启动失败会明确返回错误。
|
|
142
144
|
|
|
143
145
|
Agent 在执行任务中调用其他 Agent 或模型时,必须绑定当前会话,使用不带 `--project` 的命令;通过 Shell、Python 或脚本调用也适用。禁止清除会话环境或借用项目凭据转成项目调用。没有有效会话上下文必须报错。独立服务、定时任务及其他软件调用必须使用项目绑定。两种模式不能作为失败后的替代路径,详见 [Agent Skill](../src/agent-skill.ts)。
|
|
144
146
|
|
|
@@ -152,17 +154,20 @@ lodestar-agent --project '<项目名>' identities --json
|
|
|
152
154
|
lodestar-agent --project '<项目名>' run --identity '<identity-id>' --description '检查项目' --prompt '检查代码并报告结果' --request-id '<本次业务调用唯一编号>' --no-wait
|
|
153
155
|
```
|
|
154
156
|
|
|
155
|
-
每次项目调用在绑定群新建独立的“项目任务”卡,后续进度和结果更新原卡。它不复用会话委派卡,不读取或修改主会话的模型、账号和上下文;停止、重启、切换主会话不影响项目任务。可点击任务卡的“停止本次任务”,或使用同一 `--project` 下的 `cancel <run-id
|
|
157
|
+
每次项目调用在绑定群新建独立的“项目任务”卡,后续进度和结果更新原卡。它不复用会话委派卡,不读取或修改主会话的模型、账号和上下文;停止、重启、切换主会话不影响项目任务。可点击任务卡的“停止本次任务”,或使用同一 `--project` 下的 `cancel <run-id>`。两类任务仍共享实际工作目录。
|
|
158
|
+
|
|
159
|
+
项目入口面向传统软件,执行约定是不给调用方提问、不等待回答。调用方给出目标后,Agent 自行查明上下文、作出任务范围内的实现决策、持续执行并验证,直至完整完成目标;不能以计划、部分工作、索取输入或要求调用方安排更多 Agent 作为完成结果。真实阻断或底层故障仍须如实报告,不能伪造完成。`answer` 仅用于主 Agent 的会话委派,不支持 `--project`。
|
|
160
|
+
|
|
161
|
+
外部调用中的 Codex 同步、异步提问工具均会禁用,GPT-6 代码模式仍可执行任务。工具约束按本次调用生成;主 Agent 委派保留提问能力。
|
|
156
162
|
|
|
157
|
-
|
|
163
|
+
`status`、`follow-up` 和 `run --session` 均支持 `--project`;最后一个仍表示继续任务自身的原生 Agent 会话。只能恢复当前项目、当前群中已登记的原生会话;本轮按项目绑定创建,旧记录不迁移。新建和续跑都按本轮绑定决定是否允许提问,项目调用不会继承旧会话的交互规则。没有 `--no-wait` 时客户端等到任务终态;等待期间 Ctrl+C 会取消任务,普通 HTTP 断开不会取消已接受的任务。
|
|
158
164
|
|
|
159
165
|
```bash
|
|
160
|
-
# desc:
|
|
166
|
+
# desc: 查询项目任务状态和执行结果
|
|
161
167
|
lodestar-agent --project '<项目名>' status '<run-id>' --json
|
|
162
|
-
lodestar-agent --project '<项目名>' answer '<run-id>' --identity '<identity-id>' --request '<request-id>' --answer 'question-id=回答内容'
|
|
163
168
|
```
|
|
164
169
|
|
|
165
|
-
|
|
170
|
+
普通群消息仍交给主会话。会话委派和项目任务均只向调用方返回结果与本地文件路径,由主 Agent 或调用程序处理交付。`--project` 不注入主会话的文件交付规则,也不上传附件、设置权限或执行输出中的交付标记;新建任务和续跑旧会话都遵循此规则。
|
|
166
171
|
|
|
167
172
|
项目任务的 `run` / `follow-up` 可用 `--request-id` 防止超时重试重复执行:同一归属、同一编号及相同输入返回原任务,输入不同则拒绝,daemon 重启后仍有效。重启不会自动重跑未完成任务;遗留非终态任务标为失败,已有原生会话可显式续跑。
|
|
168
173
|
|