Skip to content

Commit 00438d7

Browse files
committed
修复 DSH 评审问题:补强并行工具与锁语义
1 parent 56ddf25 commit 00438d7

13 files changed

Lines changed: 157 additions & 37 deletions

File tree

‎docs-site/src/content/docs/ja/reference/cli/agents.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ opencode は `{env:OPENCODEX_OPENCODE_API_KEY}` を補間します。opencodex
164164
`ocx export` は実際のクライアント設定を書き込むことはありません。宛先は手動でマージできるように出力されます。`--out` は、`--force` なしで既存のファイルを上書きすることを拒否します。これは、設定を置き換えると、その中にすでに含まれている他のプロバイダー、エージェント、および MCP エントリが破壊されるためです。
165165
:::
166166

167-
キーはシリアル化されません。opencode、Hermes、OpenClaw の設定には環境参照のみが含まれるためシークレットは環境内に残り、Pi、OMP、Kimi、Gajae、DSH の設定には認証情報ではなくループバック用プレースホルダーが入ります。ループバック プロキシ (`127.0.0.1`、デフォルト) にはアドミッション キーはまったく必要ありません。プロキシがループバックを超えてバインドする場合は、対応する `OPENCODEX_OPENCODE_API_KEY`、`OPENCODEX_HERMES_API_KEY`、または `OPENCODEX_OPENCLAW_API_KEY` を設定します。生成される Pi、OMP、Kimi、Gajae、DSH 統合はループバック専用です。アドミッションキーの発行方法については、[リモートアクセス](/reference/configuration/#remote-access) を参照してください。上流プロバイダー自体のキーは完全に別のものであり、[プロバイダー](/guides/providers/) ごとに構成されます。
167+
キーはシリアル化されません。opencode、Hermes、OpenClaw、Gajae の設定には環境参照のみが含まれるためシークレットは環境内に残り、Pi、OMP、Kimi、DSH の設定には認証情報ではなくループバック用プレースホルダーが入ります。ループバック プロキシ (`127.0.0.1`、デフォルト) にはアドミッション キーはまったく必要ありません。プロキシがループバックを超えてバインドする場合は、対応する `OPENCODEX_OPENCODE_API_KEY`、`OPENCODEX_HERMES_API_KEY`、または `OPENCODEX_OPENCLAW_API_KEY` を設定します。`OPENCODEX_GAJAE_API_KEY` は Gajae の provider 認証値を環境から渡しますが、remote admission header は送れないため、生成される Gajae 統合は Pi、OMP、Kimi、DSH と同様にループバック専用です。アドミッションキーの発行方法については、[リモートアクセス](/reference/configuration/#remote-access) を参照してください。上流プロバイダー自体のキーは完全に別のものであり、[プロバイダー](/guides/providers/) ごとに構成されます。
168168

169169
同じペイロードが `GET /api/client-config` によって提供され、ダッシュボードの [API] タブにレンダリングされるため、CLI、API、および GUI は同じバイトを使用します。
170170

‎docs-site/src/content/docs/ko/reference/cli/agents.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ opencode는 `{env:OPENCODEX_OPENCODE_API_KEY}`를 보간합니다. opencodex가
170170
`ocx export`는 실제 client config를 절대 쓰지 않습니다. 대상 경로는 손으로 병합하라고 출력되며, `--out`은 `--force` 없이 기존 파일을 덮어쓰지 않습니다. config를 바꾸어 덮어쓰면 이미 들어 있던 다른 provider, agent, MCP entry가 사라지기 때문입니다.
171171
:::
172172

173-
어떤 key도 직렬화되지 않습니다. opencode, Hermes, OpenClaw config에는 env reference만 들어가므로 secret은 환경 변수에 남고, Pi, OMP, Kimi, Gajae, DSH config에는 인증 정보가 아니라 loopback placeholder가 들어갑니다. loopback proxy(`127.0.0.1`, 기본값)는 admission key가 전혀 필요하지 않습니다. proxy가 loopback을 넘어 바인딩할 때는 해당하는 `OPENCODEX_OPENCODE_API_KEY`, `OPENCODEX_HERMES_API_KEY`, `OPENCODEX_OPENCLAW_API_KEY`를 설정하십시오. 생성되는 Pi, OMP, Kimi, Gajae, DSH 통합은 loopback 전용입니다. admission key가 어떻게 발급되는지는 [Remote access](/reference/configuration/#remote-access)를 보십시오. upstream provider 자체의 key는 완전히 별개의 것으로, 각 [Providers](/guides/providers/)에 맞게 설정합니다.
173+
어떤 key도 직렬화되지 않습니다. opencode, Hermes, OpenClaw, Gajae config에는 env reference만 들어가므로 secret은 환경 변수에 남고, Pi, OMP, Kimi, DSH config에는 인증 정보가 아니라 loopback placeholder가 들어갑니다. loopback proxy(`127.0.0.1`, 기본값)는 admission key가 전혀 필요하지 않습니다. proxy가 loopback을 넘어 바인딩할 때는 해당하는 `OPENCODEX_OPENCODE_API_KEY`, `OPENCODEX_HERMES_API_KEY`, `OPENCODEX_OPENCLAW_API_KEY`를 설정하십시오. `OPENCODEX_GAJAE_API_KEY`는 Gajae provider 인증 값을 환경에서 전달하지만 remote admission header를 보낼 수는 없으므로, 생성되는 Gajae 통합은 Pi, OMP, Kimi, DSH와 마찬가지로 loopback 전용입니다. admission key가 어떻게 발급되는지는 [Remote access](/reference/configuration/#remote-access)를 보십시오. upstream provider 자체의 key는 완전히 별개의 것으로, 각 [Providers](/guides/providers/)에 맞게 설정합니다.
174174

175175
같은 payload는 `GET /api/client-config`로 제공되고 dashboard의 API 탭에도 렌더링되므로, CLI, API, GUI가 모두 같은 바이트를 사용합니다.
176176

‎docs-site/src/content/docs/reference/cli/agents.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,9 @@ the proxy binds beyond loopback; see
230230
[Remote access](/reference/configuration/#remote-access) for how admission keys are issued. Keys for
231231
the upstream providers themselves are a separate thing entirely, configured per
232232
[Providers](/guides/providers/).
233+
Gajae is the exception: `OPENCODEX_GAJAE_API_KEY` fills its provider credential from the
234+
environment, but its schema cannot send the remote admission header, so the generated Gajae
235+
integration remains loopback-only.
233236

234237
The same payload is served by `GET /api/client-config` and rendered on the dashboard's API tab, so
235238
the CLI, the API, and the GUI use the same bytes.

‎docs-site/src/content/docs/ru/reference/cli/agents.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -204,14 +204,16 @@ Pi не требует переменной окружения и несёт л
204204
MCP-записи.
205205
:::
206206

207-
Никакой ключ никогда не сериализуется. Конфиги opencode, Hermes и OpenClaw несут только
208-
env-reference, так что секрет остаётся в вашем окружении, а конфиги Pi, OMP, Kimi, Gajae и DSH несут
207+
Никакой ключ никогда не сериализуется. Конфиги opencode, Hermes, OpenClaw и Gajae несут только
208+
env-reference, так что секрет остаётся в вашем окружении, а конфиги Pi, OMP, Kimi и DSH несут
209209
loopback-заглушку вместо учётных данных. Loopback-прокси (`127.0.0.1`, по умолчанию) вообще не
210210
требует admission key. Если прокси слушает не на loopback, задайте соответствующую переменную
211211
`OPENCODEX_OPENCODE_API_KEY`, `OPENCODEX_HERMES_API_KEY` или `OPENCODEX_OPENCLAW_API_KEY`.
212-
Сгенерированные интеграции Pi, OMP, Kimi, Gajae и DSH работают только через loopback. Как выдаются
213-
admission key, описано в [Удалённом доступе](/reference/configuration/#remote-access). Ключи
214-
upstream-провайдеров — это совсем отдельная история и настраиваются в [Провайдерах](/guides/providers/).
212+
`OPENCODEX_GAJAE_API_KEY` передаёт provider credential Gajae через окружение, но не позволяет
213+
отправить remote admission header, поэтому сгенерированная интеграция Gajae, как и Pi, OMP, Kimi и
214+
DSH, работает только через loopback. Как выдаются admission key, описано в
215+
[Удалённом доступе](/reference/configuration/#remote-access). Ключи upstream-провайдеров — это совсем
216+
отдельная история и настраиваются в [Провайдерах](/guides/providers/).
215217

216218
Тот же payload отдаётся через `GET /api/client-config` и показывается на вкладке API в дашборде,
217219
поэтому CLI, API и GUI используют в точности одни и те же байты.

‎docs-site/src/content/docs/tr/reference/cli/agents.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -255,6 +255,9 @@ döngünün ötesine bağlandığında ayarlayın; kabul anahtarlarının nasıl
255255
görmek için [Uzaktan erişim](/tr/reference/configuration/#remote-access)
256256
bölümüne bakın. Yukarı akış sağlayıcılarının kendi anahtarları tamamen ayrı bir
257257
şeydir ve [Sağlayıcılar](/tr/guides/providers/) bölümüne göre yapılandırılır.
258+
Gajae istisnadır: `OPENCODEX_GAJAE_API_KEY` provider kimlik bilgisini ortamdan
259+
sağlar, ancak şeması uzaktan kabul başlığını gönderemediği için üretilen Gajae
260+
entegrasyonu yalnızca geri döngüde çalışır.
258261

259262
Aynı yük `GET /api/client-config` tarafından sunulur ve kontrol panelinin API
260263
sekmesinde işlenir; böylece CLI, API ve GUI aynı baytları kullanır.
@@ -275,4 +278,3 @@ ocx system settings --stream-mode eager-relay
275278
Doğrulanmış OpenCodex yapılandırmasını inceleyin ve güvenle değiştirin. `show`
276279
ve `get` sırları maskeler. İçe aktarma yazmadan önce doğrular ve `--yes`
277280
gerektirir.
278-

‎docs-site/src/content/docs/zh-cn/reference/cli/agents.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ opencode 会插值 `{env:OPENCODEX_OPENCODE_API_KEY}`。opencodex 生成的 Pi
171171
`ocx export` 从不写入你的真实客户端配置。该命令只会打印目标路径供你手动合并,而 `--out` 在没有 `--force` 的情况下拒绝覆盖已有文件,因为替换配置会破坏其中已有的其他 providers、agents 和 MCP 条目。
172172
:::
173173

174-
任何密钥都不会被序列化。opencode、Hermes 和 OpenClaw 配置里只包含环境引用,因此密钥仍保留在你的环境中;Pi、OMP、Kimi、Gajae 和 DSH 配置里携带的是环回占位值而不是任何凭据。环回代理(`127.0.0.1`,默认值)根本不需要准入密钥。当代理绑定到环回地址之外时,请设置对应的 `OPENCODEX_OPENCODE_API_KEY`、`OPENCODEX_HERMES_API_KEY` 或 `OPENCODEX_OPENCLAW_API_KEY`。生成的 Pi、OMP、Kimi、Gajae 和 DSH 集成仅支持环回。关于准入密钥如何签发,请参见 [远程访问](/reference/configuration/#remote-access)。上游 providers 自身的密钥则完全是另一回事,需要按 [Providers](/guides/providers/) 单独配置。
174+
任何密钥都不会被序列化。opencode、Hermes、OpenClaw 和 Gajae 配置里只包含环境引用,因此密钥仍保留在你的环境中;Pi、OMP、Kimi 和 DSH 配置里携带的是环回占位值而不是任何凭据。环回代理(`127.0.0.1`,默认值)根本不需要准入密钥。当代理绑定到环回地址之外时,请设置对应的 `OPENCODEX_OPENCODE_API_KEY`、`OPENCODEX_HERMES_API_KEY` 或 `OPENCODEX_OPENCLAW_API_KEY`。`OPENCODEX_GAJAE_API_KEY` 只会从环境中提供 Gajae provider 凭据,不能发送远程准入 header,因此生成的 Gajae 集成仍与 Pi、OMP、Kimi 和 DSH 一样仅支持环回。关于准入密钥如何签发,请参见 [远程访问](/reference/configuration/#remote-access)。上游 providers 自身的密钥则完全是另一回事,需要按 [Providers](/guides/providers/) 单独配置。
175175

176176
同一份负载会通过 `GET /api/client-config` 提供,并在仪表盘的 API 选项卡中渲染,因此 CLI、API 和 GUI 使用的是同一字节内容。
177177

‎docs-site/src/content/docs/zh-tw/reference/cli/agents.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,6 +174,8 @@ opencode 會插值 `{env:OPENCODEX_OPENCODE_API_KEY}`。Pi 與 OMP 的匯出不
174174

175175
金鑰永不被序列化。設定只帶有文件化的環境變數參考,或非秘密的 loopback 佔位符。loopback 代理(`127.0.0.1`,預設值)完全不需要准入金鑰。只有客戶端 schema 支援、且代理綁定超出 loopback 時,才設定被引用的變數;關於准入金鑰的簽發方式,請見[遠端存取](/zh-tw/reference/configuration/#remote-access)。上游 provider 本身的金鑰是完全不同的事,依[供應商](/zh-tw/guides/providers/)個別設定。
176176

177+
Gajae 是例外:`OPENCODEX_GAJAE_API_KEY` 只會從環境提供 provider 憑證,但其 schema 無法傳送遠端准入 header,因此產生的 Gajae 整合仍僅支援 loopback。
178+
177179
相同的 payload 亦由 `GET /api/client-config` 提供,並在儀表板的 API 分頁渲染,因此 CLI、API 與 GUI 使用相同的位元組。
178180

179181
## 執行階段與設定

‎scripts/dsh-rc6-compat-e2e.ts‎

Lines changed: 63 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ const RUN_TIMEOUT_MS = 60_000;
1313
const TEMPLATE_PLACEHOLDER = "__OCX_BASE_URL__";
1414
const E2E_MODEL = "dsh-e2e-reasoner";
1515
const MISSING_MODEL = "dsh-e2e-missing";
16+
export const DSH_E2E_TOOL_CALLS = [
17+
{ id: "fc_dsh_e2e_alpha", callId: "call_dsh_e2e_alpha", filePath: "probe-alpha.txt", marker: "TOOL_ALPHA" },
18+
{ id: "fc_dsh_e2e_beta", callId: "call_dsh_e2e_beta", filePath: "probe-beta.txt", marker: "TOOL_BETA" },
19+
] as const;
1620
const CREDENTIAL_ENV_PATTERN = /(?:_API_KEY|_API_TOKEN|_AUTH_TOKEN|_ACCESS_TOKEN|_SECRET_ACCESS_KEY)$/i;
1721

1822
type StringEnv = Record<string, string | undefined>;
@@ -155,25 +159,51 @@ function usage() {
155159
}
156160

157161
function toolResponse(): Response {
158-
const item = {
162+
const items = DSH_E2E_TOOL_CALLS.map(call => ({
159163
type: "function_call",
160-
id: "fc_dsh_e2e",
161-
call_id: "call_dsh_e2e",
164+
id: call.id,
165+
call_id: call.callId,
162166
name: "read",
163-
arguments: JSON.stringify({ file_path: "probe.txt" }),
167+
arguments: JSON.stringify({ file_path: call.filePath }),
164168
status: "completed",
165-
};
166-
return sse([
169+
}));
170+
const events: Array<Record<string, unknown>> = [
167171
{ type: "response.created", response: { id: "resp_dsh_e2e_tool", status: "in_progress", output: [] } },
168-
{ type: "response.output_item.added", output_index: 0, item: { ...item, arguments: "", status: "in_progress" } },
169-
{ type: "response.function_call_arguments.delta", output_index: 0, item_id: item.id, delta: item.arguments },
170-
{ type: "response.function_call_arguments.done", output_index: 0, item_id: item.id, arguments: item.arguments },
171-
{ type: "response.output_item.done", output_index: 0, item },
172+
];
173+
// Interleave both calls so rc.6 must keep their indices and call ids distinct.
174+
items.forEach((item, outputIndex) => {
175+
events.push({
176+
type: "response.output_item.added",
177+
output_index: outputIndex,
178+
item: { ...item, arguments: "", status: "in_progress" },
179+
});
180+
});
181+
items.forEach((item, outputIndex) => {
182+
events.push({
183+
type: "response.function_call_arguments.delta",
184+
output_index: outputIndex,
185+
item_id: item.id,
186+
delta: item.arguments,
187+
});
188+
});
189+
items.forEach((item, outputIndex) => {
190+
events.push({
191+
type: "response.function_call_arguments.done",
192+
output_index: outputIndex,
193+
item_id: item.id,
194+
arguments: item.arguments,
195+
});
196+
});
197+
items.forEach((item, outputIndex) => {
198+
events.push({ type: "response.output_item.done", output_index: outputIndex, item });
199+
});
200+
events.push(
172201
{
173202
type: "response.completed",
174-
response: { id: "resp_dsh_e2e_tool", status: "completed", output: [item], usage: usage() },
203+
response: { id: "resp_dsh_e2e_tool", status: "completed", output: items, usage: usage() },
175204
},
176-
]);
205+
);
206+
return sse(events);
177207
}
178208

179209
function textResponse(text: string, suffix: string): Response {
@@ -204,6 +234,19 @@ function hasReadTool(request: UpstreamRequest): boolean {
204234
return (request.tools ?? []).some(tool => tool.name === "read" || tool.function?.name === "read");
205235
}
206236

237+
/** Both results must correlate to the exact call id that requested their file. */
238+
export function hasExpectedDshToolOutputs(input: unknown): boolean {
239+
if (!Array.isArray(input)) return false;
240+
const outputs = new Map<string, string>();
241+
for (const item of input) {
242+
if (typeof item !== "object" || item === null || Array.isArray(item)) continue;
243+
const record = item as { type?: unknown; call_id?: unknown; output?: unknown };
244+
if (record.type !== "function_call_output" || typeof record.call_id !== "string") continue;
245+
outputs.set(record.call_id, typeof record.output === "string" ? record.output : (JSON.stringify(record.output) ?? ""));
246+
}
247+
return DSH_E2E_TOOL_CALLS.every(call => outputs.get(call.callId)?.includes(call.marker) === true);
248+
}
249+
207250
function opencodexConfig(baseUrl: string): OcxConfig {
208251
return {
209252
port: 0,
@@ -241,7 +284,9 @@ async function runCompatibilityE2E(): Promise<void> {
241284
const dshHome = join(root, "dsh-home");
242285
const workspace = join(root, "workspace");
243286
for (const dir of [ocxHome, childHome, dshHome, workspace]) mkdirSync(dir, { recursive: true, mode: 0o700 });
244-
writeFileSync(join(workspace, "probe.txt"), "TOOL_OK\n", { mode: 0o600 });
287+
for (const call of DSH_E2E_TOOL_CALLS) {
288+
writeFileSync(join(workspace, call.filePath), `${call.marker}\n`, { mode: 0o600 });
289+
}
245290

246291
const previousOpenCodexHome = process.env.OPENCODEX_HOME;
247292
const requests: UpstreamRequest[] = [];
@@ -262,18 +307,18 @@ async function runCompatibilityE2E(): Promise<void> {
262307
}
263308
const request = await req.json() as UpstreamRequest;
264309
requests.push(request);
265-
const hasToolOutput = JSON.stringify(request.input).includes("TOOL_OK");
310+
const hasToolOutputs = hasExpectedDshToolOutputs(request.input);
266311
if (requests.length === 1) {
267312
if (request.model !== E2E_MODEL) return new Response("unexpected model", { status: 400 });
268313
if (request.reasoning?.effort !== "high") return new Response("unexpected reasoning effort", { status: 400 });
269314
if (!hasReadTool(request)) return new Response("read tool missing", { status: 400 });
270315
return toolResponse();
271316
}
272-
if (hasToolOutput && hasReadTool(request)) {
317+
if (hasToolOutputs && hasReadTool(request)) {
273318
return finalResponse();
274319
}
275320
// rc.6 performs one no-tools title request alongside the two Agent data steps.
276-
if (!hasToolOutput && !hasReadTool(request)) return textResponse("DSH E2E", "title");
321+
if (!hasToolOutputs && !hasReadTool(request)) return textResponse("DSH E2E", "title");
277322
return new Response("unexpected DSH request shape", { status: 400 });
278323
},
279324
});
@@ -286,7 +331,7 @@ async function runCompatibilityE2E(): Promise<void> {
286331

287332
const success = await runCommand(
288333
dshBin,
289-
["--profile", "headless", "Read probe.txt with the read tool, then report the result."],
334+
["--profile", "headless", "Read probe-alpha.txt and probe-beta.txt with the read tool, then report both results."],
290335
{ cwd: workspace, env: childEnv, timeoutMs: RUN_TIMEOUT_MS },
291336
);
292337
if (success.exitCode !== 0) throw new Error("DSH success scenario exited non-zero");
@@ -310,7 +355,7 @@ async function runCompatibilityE2E(): Promise<void> {
310355
}
311356
if (requests.length !== beforeUnknown) throw new Error("DSH unknown-model scenario reached the upstream server");
312357

313-
console.log(`DSH ${DSH_RC6_VERSION} compatibility E2E passed: tool continuation and unknown-model refusal`);
358+
console.log(`DSH ${DSH_RC6_VERSION} compatibility E2E passed: parallel tool continuation and unknown-model refusal`);
314359
} finally {
315360
if (proxy) await proxy.stop(true);
316361
upstream?.stop(true);

0 commit comments

Comments
 (0)