@leviyuan/lodestar 0.19.12 → 0.19.14
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 -6
- package/dist/lodestar-agent.js +1 -1
- package/dist/lodestar.js +215 -215
- package/docs/claude-agent-backend.md +2 -2
- package/docs/usage.md +7 -5
- package/package.json +1 -1
|
@@ -92,7 +92,7 @@ Agent 运行依赖由 `src/agent-updates.ts` 独立安装，daemon 启动时不
|
|
|
92
92
|
- 每个进程默认读取项目 `.mcp.json` 的 stdio/HTTP MCP，并加载 `.agents/skills`、`.dsh/skills` 和 Lodestar 管理的 Skill。项目 `tools` 和 `load_project_mcp` 对 DSH 生效。
|
|
93
93
|
- 图片 MIME 由文件字节识别。飞书下载的 JPEG 可能使用 `.png` 文件名，不能据扩展名声明编码；无法识别的图片明确报错。
|
|
94
94
|
- 运行状态保存在 `src/paths.ts` 的 `DSH_HOME_DIR`。不读取用户 DSH settings 或凭据文件；`DEEPSEEK_API_KEY`、`DEEPSEEK_BASE_URL` 由选定账号显式注入。默认 telemetry 插件不加载。
|
|
95
|
-
- 委派 worker 与原生子 Agent
|
|
95
|
+
- 委派 worker 与原生子 Agent 均保留继续派工能力。Lodestar 调用上下文通过原生 ShellEnv 传给当前 Agent 及其后代，Agent CLI 使用它保留项目、群和任务归属。
|
|
96
96
|
- 中断使用不可变原因对象，避免 Node fetch 附加 `stack` 属性后破坏 DSH 的无损 JSON 日志校验。关闭先回收 Agent，再通过协议、stdin EOF 与精确子进程终止确认退出。
|
|
97
97
|
|
|
98
98
|
需要 Node 22.19+（22.x）或 Node 24+；`[token_source.deepseek-harness].bin` 指定 Node 路径。DSH 是开发者预览版，升级依赖时须同步检查桥接协议并运行原生集成测试。`src/dsh-process.test.ts` 使用真实运行时和本地模拟模型/MCP，不连接飞书或付费 API。
|
|
@@ -103,7 +103,7 @@ Agent 运行依赖由 `src/agent-updates.ts` 独立安装，daemon 启动时不
|
|
|
103
103
|
|
|
104
104
|
各进程类将原生文本、工具、结果、用量、压缩和后台任务转换成 `AgentProcess` 事件。共享事件由 Session 和卡片消费，保留各后端在初始化、上下文和后台任务上的差异。
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
主 Agent、委派 Agent 和原生子 Agent 均可继续派工，不设置 Lodestar 委派层数上限，也不禁用各后端原生委派工具。Skill、worker 提示词和运行时入口保持一致；项目调用的非交互要求及调用方负责交付的规则沿委派链继承。Lodestar 后续任务记录当前调用方作为父任务，续跑来源单独记录，取消沿父子关系传播。运行状态原子落盘，大段输入输出单独存放；委派会话登记后从主群的历史列表中排除。
|
|
107
107
|
|
|
108
108
|
委派、原生子 Agent 和后台任务由同一个 `AgentCards` 实例展示。每项仅显示状态和一句说明，类型、进度、任务正文、结果、待回答问题及失败原因放在折叠体内，动作只展示最近三步。原生子 Agent 启动即展示，普通前台命令仍在观察池中；启动工具和 SDK task id 关联后只保留一项。
|
|
109
109
|
|
package/docs/usage.md
CHANGED
|
@@ -102,9 +102,9 @@ WT 使用独立工作目录，其文件交付、项目工具/MCP 配置与主目
|
|
|
102
102
|
|
|
103
103
|
主 Agent 按任务和可用能力自行选择原生 subagent 或 `lodestar-agent`，调用自身模型或 Agent 时也适用。使用 `lodestar-agent` 时先查询实时身份，再把任务交给一个或多个模型。同一个任务选择多个身份时并发执行；后续追问可继续使用各模型的原生会话。
|
|
104
104
|
|
|
105
|
-
被调用的 Agent 可以编辑文件、执行命令、使用 MCP 和 Skill
|
|
105
|
+
被调用的 Agent 可以编辑文件、执行命令、使用 MCP 和 Skill，也可以通过 Lodestar 或原生子 Agent 继续派工，Lodestar 不设置委派层数上限。它们与主 Agent 共享工作区，修改会立即可见。会话委派需要输入时暂停，由调用方回填答案后继续；项目调用及其后续委派保持非交互执行。委派产生的会话不会混入主群的 `rs` 历史列表。
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
首层任务默认使用主 Agent 的工作目录，后续委派默认使用调用方的执行目录，不受调用命令时 Shell 当前目录影响。可用 `--workdir <路径>` 指定其中已存在的子目录：相对路径以主 Agent 的工作目录为基准，也支持范围内的绝对路径。路径会解析软链接，越界、目录不存在或指向普通文件都会报错。同一个 run 的多个 Agent 使用同一目录；需要不同目录时分别发起任务。
|
|
108
108
|
|
|
109
109
|
```bash
|
|
110
110
|
# desc: 在项目子目录中委派任务
|
|
@@ -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 也没有单独的本地限制。任务正文和 Agent API 请求体也不设置本地长度或大小上限。任务开卡后直接启动，上游限流和进程启动失败会明确返回错误。
|
|
142
144
|
|
|
143
145
|
Agent 在执行任务中调用其他 Agent 或模型时，必须绑定当前会话，使用不带 `--project` 的命令；通过 Shell、Python 或脚本调用也适用。禁止清除会话环境或借用项目凭据转成项目调用。没有有效会话上下文必须报错。独立服务、定时任务及其他软件调用必须使用项目绑定。两种模式不能作为失败后的替代路径，详见 [Agent Skill](../src/agent-skill.ts)。
|
|
144
146
|
|
|
@@ -152,9 +154,9 @@ 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>`。两类任务仍共享实际工作目录。
|
|
156
158
|
|
|
157
|
-
项目入口面向传统软件，执行约定是不给调用方提问、不等待回答。调用方给出目标后，Agent 自行查明上下文、作出任务范围内的实现决策、持续执行并验证，直至完整完成目标；不能以计划、部分工作、索取输入或要求调用方安排更多 Agent 作为完成结果。真实阻断或底层故障仍须如实报告，不能伪造完成。`answer`
|
|
159
|
+
项目入口面向传统软件，执行约定是不给调用方提问、不等待回答。调用方给出目标后，Agent 自行查明上下文、作出任务范围内的实现决策、持续执行并验证，直至完整完成目标；不能以计划、部分工作、索取输入或要求调用方安排更多 Agent 作为完成结果。真实阻断或底层故障仍须如实报告，不能伪造完成。`answer` 用于会话归属的各层委派，不支持 `--project`。
|
|
158
160
|
|
|
159
161
|
外部调用中的 Codex 同步、异步提问工具均会禁用，GPT-6 代码模式仍可执行任务。工具约束按本次调用生成；主 Agent 委派保留提问能力。
|
|
160
162
|
|