diff --git a/web/src/i18n/i18n.test.mjs b/web/src/i18n/i18n.test.mjs
index d9b16b36..486e4849 100644
--- a/web/src/i18n/i18n.test.mjs
+++ b/web/src/i18n/i18n.test.mjs
@@ -94,8 +94,8 @@ function checkCatalog(source, translated, locale) {
}
test("every shipped catalog is complete and preserves placeholders and rich tags", () => {
- // 3266 shipped keys + 2 OpenCode Go provider template keys + 3 scope/asset-rule guidance keys.
- assert.equal(Object.keys(catalogs.en).length, 3271);
+ // 3271 existing six-language keys + 12 OpenCode SDK bridge labels and guidance.
+ assert.equal(Object.keys(catalogs.en).length, 3283);
assert.deepEqual(catalogLocales.sort(), [...LOCALES].sort());
assert.deepEqual(Object.keys(catalogs).sort(), [...LOCALES].sort());
for (const locale of LOCALES) checkCatalog(catalogs.en, catalogs[locale], locale);
@@ -126,6 +126,17 @@ test("every shipped scope label and planning example preserves the exact /24 CID
}
});
+test("SDK bridge guidance preserves runtime, credential and model boundaries in every shipped language", () => {
+ for (const locale of LOCALES) {
+ const catalog = catalogs[locale];
+ for (const version of ["2.1.4", "1.19.4", "Windows"]) {
+ assert.ok(catalog["providers.sdkHelp"].includes(version), `${locale}: runtime boundary ${version}`);
+ }
+ assert.ok(catalog["providers.sdkTokenHelp"].includes("SCOPEWEAVER_OPENCODE_TOKEN"), `${locale}: separate bridge credential`);
+ assert.ok(catalog["providers.sdkModelHelp"].includes("providerID/modelID"), `${locale}: explicit native model ID`);
+ }
+});
+
test("output-limit help states what 0 actually sends on each call path", () => {
// 0 is not omitted: agent turns send 32768, direct Anthropic calls 8192, native Ollama its own default.
const qualifiers = {
diff --git a/web/src/i18n/messages/es.ts b/web/src/i18n/messages/es.ts
index 7364e7f0..811f597c 100644
--- a/web/src/i18n/messages/es.ts
+++ b/web/src/i18n/messages/es.ts
@@ -5,7 +5,7 @@ export const providers: Record = {
"chooseTemplate": "Elige una plantilla…",
"general": "Z.ai GLM-5.3 · API general (recomendada)",
"coding": "Z.ai GLM-5.3 · Coding Plan (referencia)",
- "introduction": "Opcional: rellena los campos de conexión. Se conservan el nombre del perfil, el proxy, la cabecera de sesión y otras preferencias. Las plantillas de nube también conservan la clave API introducida; las de Ollama borran cualquier clave sin guardar para evitar enviar credenciales de nube a un endpoint local. Al elegir Ollama se consultan los modelos instalados; las plantillas de nube no realizan solicitudes. Elegir una plantilla no guarda ni activa un perfil. Guarda cuando esté listo y actívalo después. Todos los campos siguen siendo editables.",
+ introduction: "Las plantillas rellenan un perfil nuevo sin guardarlo ni activarlo. Las de nube conservan la clave introducida; las de Ollama y SDK la borran. Ollama consulta automáticamente los modelos instalados; SDK solo los consulta al pulsar Cargar modelos. SDK también borra el proxy y la cabecera de sesión. Las demás preferencias siguen siendo editables.",
"generalHelp": "Usa el endpoint de la API general y su facturación, separados de la cuota de suscripción de Coding Plan. Confirma el acceso al modelo y la facturación de tu cuenta de Z.ai.",
"codingHelp": "Solo como referencia: Coding Plan usa un endpoint y una cuota de suscripción independientes. Z.ai lo restringe a herramientas oficialmente compatibles; ScopeWeaver no figura entre ellas. Obtén autorización de Z.ai antes de usar este endpoint con ScopeWeaver.",
"modelHelp": "GLM-5.3 solo admite texto y tiene un contexto de 1M de tokens. El razonamiento debe permanecer activado; admite los niveles low, high y max. Esta plantilla selecciona esfuerzo low, un límite de salida de 16,384 tokens y una ventana de contexto de 0 (200K por defecto). En la medición de ScopeWeaver de una tarea pequeña, low usó menos de la mitad de los tokens de max con el mismo hallazgo. Aumenta el esfuerzo para tareas más difíciles y revisa estos ajustes si cambias de modelo.",
@@ -23,6 +23,18 @@ export const providers: Record = {
"kimiHelp": "Valores económicos opcionales: esfuerzo de razonamiento low, límite de salida de 16,384 tokens enviado como max_completion_tokens y ventana de contexto de 0 (200K por defecto). El ahorro no se ha medido; aumenta el esfuerzo si los resultados son demasiado superficiales.",
"openrouterHelp": "DeepSeek V4.1 Flash a través de OpenRouter. Esfuerzo low, límite de salida de 16,384 tokens enviado como max_tokens y ventana de contexto de 0 (200K por defecto). OpenRouter almacena automáticamente en caché los prefijos repetidos. El ahorro no se ha medido.",
"opencodeGoHelp": "La pasarela de suscripción OpenCode Go (https://opencode.ai/zen/go/v1, compatible con OpenAI). Esfuerzo de razonamiento max, límite de salida de 16,384 tokens enviado como max_tokens y ventana de contexto de 0 (200K por defecto). La pasarela rechaza las solicitudes sin la cabecera x-opencode-session, por lo que esta plantilla rellena el campo Cabecera de sesión. Usa tu clave de suscripción de OpenCode (OPENCODE_API_KEY en opencode); está sujeta a las condiciones de suscripción de opencode: confirma que se permite usarla desde ScopeWeaver antes de guardar.",
+ opencodeSdk: "OpenCode SDK · puente",
+ sdkGroup: "Puente SDK",
+ sdkHelp: "Entornos del puente: CLI/cliente native 2.1.4 (predeterminado; conserva los argumentos originales de las herramientas) o SDK legacy 1.19.4 (JSON con estructura segura; no conserva los bytes originales). Ninguno es compatible con Windows. ScopeWeaver mantiene el control de la ejecución y aprobación de las herramientas del sistema anfitrión.",
+ sdkSecurity: "Un puente de bucle local también puede llamar a proveedores en la nube. Este formato no se puede usar en el modo LLM solo local. Los ID de modelos gratuitos indican su disponibilidad actual, no derechos de suscripción ni uso ilimitado.",
+ sdkToken: "Token del puente",
+ sdkTokenPlaceholder: "Token del puente obligatorio",
+ sdkTokenHelp: "Introduce el SCOPEWEAVER_OPENCODE_TOKEN independiente configurado en el puente, no una clave API de nube. Dejar el campo vacío conserva el token guardado solo para el mismo endpoint SDK. Editar la URL borra el token introducido; cambiar el endpoint o el formato tampoco conserva el token guardado. No se importan credenciales guardadas de proveedores.",
+ sdkModelHelp: "Usa el formato providerID/modelID. Cargar modelos consulta explícitamente el catálogo del puente sin realizar inferencia; elegir esta plantilla no carga modelos ni guarda o activa el perfil.",
+ sdkOptionsHelp: "La salida se limita al máximo declarado por el modelo nativo. Usa opciones de razonamiento compatibles con el modelo elegido; los ajustes no compatibles pueden fallar en el proveedor. Este selector del campo de salida no se aplica.",
+ sdkSessionHelp: "Este puente no admite cabeceras de sesión personalizadas. ScopeWeaver proporciona el historial de conversación en cada solicitud.",
+ sdkEndpoint: "URL del puente",
+ sdkProxyHelp: "No se admiten proxies del puente. Usa una URL de bucle local y configura en el puente la conexión con el proveedor de destino.",
"officialModel": "Guía del modelo GLM-5.3",
"officialPolicy": "Política de uso de Coding Plan",
"groupCloud": "Proveedores de nube",
diff --git a/web/src/i18n/messages/ja.ts b/web/src/i18n/messages/ja.ts
index 0585026f..70a06af5 100644
--- a/web/src/i18n/messages/ja.ts
+++ b/web/src/i18n/messages/ja.ts
@@ -3375,8 +3375,7 @@ export const providers: Record = {
chooseTemplate: "テンプレートを選択…",
general: "Z.ai GLM-5.3 · General API（推奨）",
coding: "Z.ai GLM-5.3 · Coding Plan（参考）",
- introduction:
- "任意で接続欄に初期値を設定できます。プロファイル名、プロキシ、セッションヘッダー、その他の設定は保持されます。クラウドのテンプレートでは入力済みの API キーも保持します。Ollama のテンプレートでは、クラウドの認証情報がローカルのエンドポイントに送信されないよう、未保存のキーを消去します。Ollama の選択時はインストール済みモデルを読み取ります。クラウドのテンプレートはリクエストを送信しません。選択してもプロファイルは保存・有効化されません。設定ができたら保存し、別途有効化してください。すべての欄は引き続き編集できます。",
+ introduction: "テンプレートは新規プロファイルの欄を入力するだけで、保存や有効化は行いません。クラウドのテンプレートは入力済みのキーを保持し、Ollama と SDK のテンプレートは消去します。Ollama はインストール済みモデルを自動取得しますが、SDK は「モデルを読み込む」を押したときに取得します。SDK はプロキシとセッションヘッダーの設定も消去します。他の設定は引き続き編集できます。",
generalHelp:
"General API のエンドポイントと API 課金を使用します。Coding Plan のサブスクリプション枠とは別です。Z.ai アカウントのモデル利用権限と課金を確認してください。",
codingHelp:
@@ -3404,6 +3403,18 @@ export const providers: Record = {
"OpenRouter 経由の DeepSeek V4.1 Flash です。推論強度 low、max_tokens として送信する出力上限 16,384 トークン、コンテキストウィンドウ 0（既定 200K）を使用します。OpenRouter は繰り返されるプレフィックスを自動でキャッシュします。削減効果は未測定です。",
opencodeGoHelp:
"OpenCode Go のサブスクリプションゲートウェイ（https://opencode.ai/zen/go/v1、OpenAI 互換）です。推論強度 max、max_tokens として送信する出力上限 16,384 トークン、コンテキストウィンドウ 0（既定 200K）を使用します。ゲートウェイは x-opencode-session ヘッダーのないリクエストを拒否するため、このテンプレートが「セッションヘッダー」欄を設定します。OpenCode のサブスクリプションキー（opencode の OPENCODE_API_KEY）を使用します。このキーは opencode 独自のサブスクリプション規約に従うため、保存前に ScopeWeaver からの利用が認められることを確認してください。",
+ opencodeSdk: "OpenCode SDK · ブリッジ",
+ sdkGroup: "SDK ブリッジ",
+ sdkHelp: "ブリッジの実行環境は native CLI／クライアント 2.1.4（既定、ツール引数の原文を保持）または legacy SDK 1.19.4（安全な構造の JSON。元のバイト列は保持しません）です。どちらも Windows には対応していません。ホスト側のツール実行と承認は引き続き ScopeWeaver が管理します。",
+ sdkSecurity: "ループバックのブリッジもクラウドプロバイダーを呼び出せるため、ローカル専用 LLM モードでは使用できません。無料モデルの ID は現在の利用可能性を示すもので、サブスクリプションの利用権や無制限の利用枠を保証しません。",
+ sdkToken: "ブリッジトークン",
+ sdkTokenPlaceholder: "ブリッジトークンは必須です",
+ sdkTokenHelp: "クラウド API キーではなく、ブリッジに設定した専用の SCOPEWEAVER_OPENCODE_TOKEN を入力してください。空欄では同じ SDK エンドポイントの保存済みトークンだけを保持します。URL の編集で入力済みトークンを消去し、エンドポイントや形式の変更では保存済みトークンも保持しません。保存済みのプロバイダー認証情報は取り込みません。",
+ sdkModelHelp: "providerID/modelID 形式を使用してください。「モデルを読み込む」を押すと、推論を行わずにブリッジの一覧を取得します。テンプレートの選択だけではモデルの取得、プロファイルの保存や有効化は行いません。",
+ sdkOptionsHelp: "出力はネイティブモデルが宣言する上限までに制限します。選択したモデルが対応する推論オプションを使用してください。未対応の設定はプロバイダー側で失敗する場合があります。この出力フィールドの選択は適用されません。",
+ sdkSessionHelp: "このブリッジはカスタムセッションヘッダーに対応していません。ScopeWeaver がリクエストごとに会話履歴を渡します。",
+ sdkEndpoint: "ブリッジ URL",
+ sdkProxyHelp: "ブリッジ用のプロキシには対応していません。ループバック URL を使い、接続先プロバイダーへの接続はブリッジ側で設定してください。",
officialModel: "GLM-5.3 モデルガイド",
officialPolicy: "Coding Plan 利用ポリシー",
groupCloud: "クラウドプロバイダー",
diff --git a/web/src/i18n/messages/providers.ts b/web/src/i18n/messages/providers.ts
index 0c982c92..8b5d6af4 100644
--- a/web/src/i18n/messages/providers.ts
+++ b/web/src/i18n/messages/providers.ts
@@ -3,7 +3,7 @@ export const en = {
chooseTemplate: "Choose a template…",
general: "Z.ai GLM-5.3 · General API (recommended)",
coding: "Z.ai GLM-5.3 · Coding Plan (reference)",
- introduction: "Optional: prefill connection fields. Your profile name, proxy, session header and other preferences are kept. Cloud templates also keep an entered API key; Ollama templates clear any unsaved key so a cloud credential is never sent to a local endpoint. Ollama selection reads installed models; cloud templates make no requests. Selection does not save or activate a profile. Save when ready, then activate separately. Every field remains editable.",
+ introduction: "Templates fill a new profile without saving or activating it. Cloud templates keep an entered key; Ollama and SDK templates clear it. Ollama reads installed models automatically; SDK model discovery requires Load models. SDK also clears proxy and session header settings. Other preferences remain editable.",
generalHelp: "Uses the General API endpoint and API billing, separate from Coding Plan subscription quota. Confirm model access and billing for your Z.ai account.",
codingHelp: "Reference only: Coding Plan uses a separate endpoint and subscription quota. Z.ai restricts it to officially supported tools; ScopeWeaver is not listed. Obtain Z.ai authorization before using this endpoint with ScopeWeaver.",
modelHelp: "GLM-5.3 is text-only with a 1M-token context. Reasoning must stay enabled; supported effort levels are low, high, and max. This template selects low effort, an output limit of 16,384 tokens and context window 0 (200K default). In ScopeWeaver's measurement of one small task, low used under half the tokens of max with the same finding. Raise effort for harder tasks, and review these settings if you change the model.",
@@ -21,6 +21,18 @@ export const en = {
kimiHelp: "Opt-in economy defaults: reasoning effort low, output limit 16,384 tokens sent as max_completion_tokens, context window 0 (200K default). Savings are not measured; raise effort if results are too shallow.",
openrouterHelp: "DeepSeek V4.1 Flash through OpenRouter. Low effort, output limit 16,384 tokens sent as max_tokens, context window 0 (200K default). OpenRouter caches repeated prefixes automatically. Savings are not measured.",
opencodeGoHelp: "The OpenCode Go subscription gateway (https://opencode.ai/zen/go/v1, OpenAI-compatible). Reasoning effort max, output limit 16,384 tokens sent as max_tokens, context window 0 (200K default). The gateway rejects requests without the x-opencode-session header, so this template fills the Session header field for you. Uses your OpenCode subscription key (OPENCODE_API_KEY in opencode); the key is tied to opencode's own subscription terms — confirm that using it from ScopeWeaver is permitted before saving.",
+ opencodeSdk: "OpenCode SDK · bridge",
+ sdkGroup: "SDK bridge",
+ sdkHelp: "Bridge runtimes: native CLI/client 2.1.4 (default; preserves raw tool arguments) or legacy SDK 1.19.4 (safe structural JSON; original bytes are not preserved). Both are unsupported on Windows. ScopeWeaver retains host tool execution and approvals.",
+ sdkSecurity: "A loopback bridge can still call cloud providers. This format cannot be used with local-only LLM mode. Free model IDs reflect current availability, not subscription entitlement or unlimited use.",
+ sdkToken: "Bridge token",
+ sdkTokenPlaceholder: "Required bridge token",
+ sdkTokenHelp: "Enter the separate SCOPEWEAVER_OPENCODE_TOKEN configured on the bridge, not a cloud API key. A blank field keeps a saved token only for the same SDK endpoint. Changing its URL clears an entered token; changing its endpoint or format does not retain the saved token. Saved provider credentials are never imported.",
+ sdkModelHelp: "Use providerID/modelID. Load models explicitly reads the bridge catalog without inference; choosing this template does not load models, save or activate the profile.",
+ sdkOptionsHelp: "Output is capped at the native model's declared limit. Use reasoning options supported by the selected model; unsupported settings can fail at the provider. This output-field selector does not apply.",
+ sdkSessionHelp: "Custom session headers are not supported by this bridge. ScopeWeaver supplies the conversation history for each request.",
+ sdkEndpoint: "Bridge URL",
+ sdkProxyHelp: "Bridge proxies are not supported. Use a loopback URL and configure any downstream provider connection on the bridge.",
officialModel: "GLM-5.3 model guide",
officialPolicy: "Coding Plan usage policy",
groupCloud: "Cloud providers",
@@ -73,7 +85,7 @@ export const ko: Record = {
chooseTemplate: "템플릿 선택…",
general: "Z.ai GLM-5.3 · 일반 API(권장)",
coding: "Z.ai GLM-5.3 · Coding Plan(참고용)",
- introduction: "선택하면 연결 설정을 미리 입력합니다. 프로필 이름, 프록시, 세션 헤더와 그 밖의 설정은 유지합니다. 클라우드 템플릿은 입력한 API 키도 유지하지만, Ollama 템플릿은 저장하지 않은 키를 지워 클라우드 자격 증명이 로컬 엔드포인트로 전송되지 않게 합니다. Ollama를 선택하면 서버에 설치된 모델을 조회하며, 클라우드 템플릿은 요청을 보내지 않습니다. 선택만으로 저장하거나 활성화하지 않습니다. 준비되면 저장하고 별도로 활성화하세요. 모든 필드는 수정할 수 있습니다.",
+ introduction: "템플릿은 새 프로필의 입력란을 채우며 저장하거나 활성화하지 않습니다. 클라우드 템플릿은 입력한 키를 유지하고, Ollama와 SDK 템플릿은 지웁니다. Ollama는 설치된 모델을 자동 조회하지만 SDK는 모델 불러오기를 눌러야 조회합니다. SDK는 프록시와 세션 헤더 설정도 지웁니다. 그 밖의 설정은 계속 수정할 수 있습니다.",
generalHelp: "일반 API 엔드포인트와 API 요금을 사용하며 Coding Plan 구독 할당량과 별개입니다. Z.ai 계정의 모델 접근 권한과 과금 조건을 확인하세요.",
codingHelp: "참고용: Coding Plan은 별도 엔드포인트와 구독 할당량을 사용합니다. Z.ai가 공식 지원 도구로 사용을 제한하며 ScopeWeaver는 목록에 없습니다. ScopeWeaver에서 이 엔드포인트를 사용하려면 먼저 Z.ai의 허가를 받으세요.",
modelHelp: "GLM-5.3은 텍스트 전용이며 문맥 한도는 100만 토큰입니다. 추론은 항상 켜야 하며 지원 강도는 low, high, max입니다. 템플릿은 강도 low, 출력 한도 16,384 토큰, 문맥 창 0(기본 200K)을 선택합니다. ScopeWeaver가 작은 작업 하나로 측정했을 때 low는 같은 결과를 내면서 max의 절반 미만 토큰을 썼습니다. 어려운 작업에는 강도를 올리고, 모델을 바꾸면 이 설정도 확인하세요.",
@@ -91,6 +103,18 @@ export const ko: Record = {
kimiHelp: "선택형 절약 기본값: 추론 강도 low, 출력 한도 16,384 토큰(max_completion_tokens로 전송), 문맥 창 0(기본 200K). 절감 효과는 측정하지 않았습니다. 결과가 얕으면 강도를 올리세요.",
openrouterHelp: "OpenRouter를 통한 DeepSeek V4.1 Flash입니다. 강도 low, 출력 한도 16,384 토큰(max_tokens로 전송), 문맥 창 0(기본 200K). OpenRouter는 반복되는 앞부분을 자동으로 캐시합니다. 절감 효과는 측정하지 않았습니다.",
opencodeGoHelp: "OpenCode Go 구독 게이트웨이(https://opencode.ai/zen/go/v1, OpenAI 호환)입니다. 추론 강도 max, 출력 한도 16,384 토큰(max_tokens로 전송), 문맥 창 0(기본 200K). 게이트웨이는 x-opencode-session 헤더가 없는 요청을 거부하므로 이 템플릿이 세션 헤더 필드를 채워 줍니다. opencode의 구독 키(OPENCODE_API_KEY)를 사용합니다. 키는 opencode 구독 약관에 묶여 있으므로 ScopeWeaver에서 사용해도 되는지 먼저 확인하세요.",
+ opencodeSdk: "OpenCode SDK · 브리지",
+ sdkGroup: "SDK 브리지",
+ sdkHelp: "브리지 런타임은 native CLI·클라이언트 2.1.4(기본값, 도구 인자 원본 보존) 또는 legacy SDK 1.19.4(안전한 구조의 JSON, 원본 바이트는 보존하지 않음)입니다. 둘 다 Windows는 지원하지 않습니다. 호스트 도구 실행과 승인은 ScopeWeaver가 관리합니다.",
+ sdkSecurity: "루프백 브리지도 클라우드 제공자를 호출할 수 있어 로컬 전용 LLM 모드에서는 사용할 수 없습니다. 무료 모델 ID는 현재 이용 가능 여부를 나타낼 뿐 구독 사용 권한이나 무제한 이용을 보장하지 않습니다.",
+ sdkToken: "브리지 토큰",
+ sdkTokenPlaceholder: "필수 브리지 토큰",
+ sdkTokenHelp: "클라우드 API 키 대신 브리지에 설정한 별도의 SCOPEWEAVER_OPENCODE_TOKEN을 입력하세요. 빈칸은 같은 SDK 엔드포인트의 저장된 토큰만 유지합니다. URL을 수정하면 입력한 토큰을 지우며, 엔드포인트나 형식이 바뀌면 저장된 토큰도 유지하지 않습니다. 저장된 제공자 자격 증명은 가져오지 않습니다.",
+ sdkModelHelp: "providerID/modelID 형식을 사용하세요. 모델 불러오기를 눌러야 추론 없이 브리지 목록을 조회합니다. 템플릿 선택만으로 모델을 조회하거나 프로필을 저장·활성화하지 않습니다.",
+ sdkOptionsHelp: "출력은 네이티브 모델에 선언된 한도 이내로 제한합니다. 선택한 모델이 지원하는 추론 옵션을 사용하세요. 지원하지 않는 설정은 제공자에서 실패할 수 있습니다. 출력 필드 선택은 적용되지 않습니다.",
+ sdkSessionHelp: "이 브리지는 사용자 지정 세션 헤더를 지원하지 않습니다. ScopeWeaver가 요청마다 대화 이력을 전달합니다.",
+ sdkEndpoint: "브리지 URL",
+ sdkProxyHelp: "브리지 프록시는 지원하지 않습니다. 루프백 URL을 사용하고, 하위 제공자의 연결 설정은 브리지에서 구성하세요.",
officialModel: "GLM-5.3 모델 안내",
officialPolicy: "Coding Plan 이용 정책",
groupCloud: "클라우드 제공자",
diff --git a/web/src/i18n/messages/zh-hans.ts b/web/src/i18n/messages/zh-hans.ts
index ed6bf556..9841c42a 100644
--- a/web/src/i18n/messages/zh-hans.ts
+++ b/web/src/i18n/messages/zh-hans.ts
@@ -3278,8 +3278,7 @@ export const providers: Record = {
chooseTemplate: "选择模板…",
general: "Z.ai GLM-5.3 · 通用 API（推荐）",
coding: "Z.ai GLM-5.3 · Coding Plan（参考）",
- introduction:
- "可选：预填连接字段。配置名称、代理、会话标头和其他偏好会保留。云端模板还会保留已输入的 API 密钥；Ollama 模板会清除未保存的密钥，避免云端凭据被发送到本地端点。选择 Ollama 会读取服务器上已安装的模型；云端模板不会发送请求。选择模板不会保存或启用配置。准备好后请保存，再单独启用。所有字段仍可编辑。",
+ introduction: "模板只填充新配置，不会保存或激活。云端模板保留已输入的密钥；Ollama 和 SDK 模板会清除密钥。Ollama 自动查询已安装模型；SDK 需要点击“加载模型”才查询。SDK 还会清除代理和会话请求头设置。其他设置仍可编辑。",
generalHelp:
"使用通用 API 端点并按 API 计费，与 Coding Plan 订阅额度相互独立。请确认 Z.ai 账号的模型权限和计费方式。",
codingHelp:
@@ -3307,6 +3306,18 @@ export const providers: Record = {
"通过 OpenRouter 使用 DeepSeek V4.1 Flash。强度 low，输出上限 16,384 token（以 max_tokens 发送），上下文窗口 0（默认 200K）。OpenRouter 会自动缓存重复的前缀。节省效果未经测量。",
opencodeGoHelp:
"OpenCode Go 订阅网关（https://opencode.ai/zen/go/v1，OpenAI 兼容）。推理强度 max，输出上限 16,384 token（以 max_tokens 发送），上下文窗口 0（默认 200K）。网关会拒绝缺少 x-opencode-session 标头的请求，因此该模板会自动填写“会话标头”字段。使用你的 OpenCode 订阅密钥（opencode 中的 OPENCODE_API_KEY）。该密钥受 opencode 订阅条款约束，保存前请确认允许在 ScopeWeaver 中使用。",
+ opencodeSdk: "OpenCode SDK · 桥接服务",
+ sdkGroup: "SDK 桥接服务",
+ sdkHelp: "桥接运行时：native CLI/客户端 2.1.4（默认，保留原始工具参数）或 legacy SDK 1.19.4（安全的结构化 JSON，不保留原始字节）。两者均不支持 Windows。主机工具执行和审批仍由 ScopeWeaver 管理。",
+ sdkSecurity: "回环桥接服务仍可能调用云端提供商，因此不能用于仅限本地 LLM 模式。免费模型 ID 只表示当前可用性，不代表订阅使用权或无限使用额度。",
+ sdkToken: "桥接令牌",
+ sdkTokenPlaceholder: "必填桥接令牌",
+ sdkTokenHelp: "请输入桥接服务配置的独立 SCOPEWEAVER_OPENCODE_TOKEN，而非云端 API 密钥。留空仅保留同一 SDK 端点已保存的令牌。修改 URL 会清除已输入的令牌；更换端点或格式不会保留已保存的令牌。不会导入已保存的提供商凭据。",
+ sdkModelHelp: "使用 providerID/modelID 格式。点击“加载模型”才会读取桥接目录，不执行推理。选择模板不会加载模型、保存或激活配置。",
+ sdkOptionsHelp: "输出受原生模型声明的上限约束。请使用所选模型支持的推理选项；不支持的设置可能在提供商端失败。此输出字段选择器不适用。",
+ sdkSessionHelp: "此桥接服务不支持自定义会话请求头。ScopeWeaver 会为每次请求提供对话历史。",
+ sdkEndpoint: "桥接 URL",
+ sdkProxyHelp: "不支持桥接代理。请使用回环 URL，并在桥接服务上配置下游提供商连接。",
officialModel: "GLM-5.3 模型指南",
officialPolicy: "Coding Plan 使用政策",
groupCloud: "云端服务商",
diff --git a/web/src/i18n/messages/zh-hant.ts b/web/src/i18n/messages/zh-hant.ts
index 70c1598b..90689691 100644
--- a/web/src/i18n/messages/zh-hant.ts
+++ b/web/src/i18n/messages/zh-hant.ts
@@ -3278,8 +3278,7 @@ export const providers: Record = {
chooseTemplate: "選擇模板…",
general: "Z.ai GLM-5.3 · 通用 API（推薦）",
coding: "Z.ai GLM-5.3 · Coding Plan（參考）",
- introduction:
- "可選：預填連線欄位。設定名稱、代理、工作階段標頭和其他偏好會保留。雲端模板還會保留已輸入的 API 金鑰；Ollama 模板會清除未儲存的金鑰，避免雲端憑據被髮送到本地端點。選擇 Ollama 會讀取伺服器上已安裝的模型；雲端模板不會傳送請求。選擇模板不會儲存或啟用設定。準備好後請儲存，再單獨啟用。所有欄位仍可編輯。",
+ introduction: "模板僅填入新設定，不會儲存或啟用。雲端模板保留已輸入的金鑰；Ollama 和 SDK 模板會清除金鑰。Ollama 自動查詢已安裝的模型；SDK 需按下「載入模型」才會查詢。SDK 也會清除代理與工作階段標頭設定。其他設定仍可編輯。",
generalHelp:
"使用通用 API 端點並按 API 計費，與 Coding Plan 訂閱額度相互獨立。請確認 Z.ai 帳號的模型權限和計費方式。",
codingHelp:
@@ -3307,6 +3306,18 @@ export const providers: Record = {
"透過 OpenRouter 使用 DeepSeek V4.1 Flash。強度 low，輸出上限 16,384 token（以 max_tokens 傳送），上下文視窗 0（預設 200K）。OpenRouter 會自動快取重複的字首。節省效果未經測量。",
opencodeGoHelp:
"OpenCode Go 訂閱閘道器（https://opencode.ai/zen/go/v1，OpenAI 相容）。推理強度 max，輸出上限 16,384 token（以 max_tokens 傳送），上下文視窗 0（預設 200K）。閘道器會拒絕缺少 x-opencode-session 標頭的請求，因此該模板會自動填寫“工作階段標頭”欄位。使用你的 OpenCode 訂閱金鑰（opencode 中的 OPENCODE_API_KEY）。該金鑰受 opencode 訂閱條款約束，儲存前請確認允許在 ScopeWeaver 中使用。",
+ opencodeSdk: "OpenCode SDK · 橋接服務",
+ sdkGroup: "SDK 橋接服務",
+ sdkHelp: "橋接執行階段：native CLI／用戶端 2.1.4（預設，保留原始工具引數）或 legacy SDK 1.19.4（安全的結構化 JSON，不保留原始位元組）。兩者均不支援 Windows。主機工具執行與核准仍由 ScopeWeaver 管理。",
+ sdkSecurity: "回環橋接服務仍可能呼叫雲端提供者，因此無法用於僅限本機 LLM 模式。免費模型 ID 僅表示目前可用，不代表訂閱使用權或無限使用額度。",
+ sdkToken: "橋接權杖",
+ sdkTokenPlaceholder: "必填橋接權杖",
+ sdkTokenHelp: "請輸入橋接服務設定的獨立 SCOPEWEAVER_OPENCODE_TOKEN，而非雲端 API 金鑰。留白僅保留同一 SDK 端點已儲存的權杖。修改 URL 會清除已輸入的權杖；變更端點或格式不會保留已儲存的權杖。不會匯入已儲存的提供者憑證。",
+ sdkModelHelp: "使用 providerID/modelID 格式。按下「載入模型」才會讀取橋接目錄，不執行推論。選擇模板不會載入模型、儲存或啟用設定。",
+ sdkOptionsHelp: "輸出受原生模型宣告的上限約束。請使用所選模型支援的推理選項；不支援的設定可能在提供者端失敗。此輸出欄位選擇器不適用。",
+ sdkSessionHelp: "此橋接服務不支援自訂工作階段標頭。ScopeWeaver 會為每次請求提供對話歷程。",
+ sdkEndpoint: "橋接 URL",
+ sdkProxyHelp: "不支援橋接代理。請使用回環 URL，並在橋接服務上設定下游提供者連線。",
officialModel: "GLM-5.3 模型指南",
officialPolicy: "Coding Plan 使用政策",
groupCloud: "雲端服務商",
diff --git a/web/src/lib/llm-profile-presets.test.mjs b/web/src/lib/llm-profile-presets.test.mjs
index b749bd0f..0fc9eed0 100644
--- a/web/src/lib/llm-profile-presets.test.mjs
+++ b/web/src/lib/llm-profile-presets.test.mjs
@@ -1,6 +1,37 @@
import assert from "node:assert/strict";
import test from "node:test";
-import { applyLLMProfilePreset, getLLMProfilePreset, isOllamaPreset, selectInstalledOllamaModel, LLM_PROFILE_PRESET_IDS } from "./llm-profile-presets.ts";
+import { applyLLMProfilePreset, canReuseSDKBridgeToken, getLLMProfilePreset, isOllamaPreset, selectInstalledOllamaModel, LLM_PROFILE_PRESET_IDS } from "./llm-profile-presets.ts";
+
+test("OpenCode SDK template isolates bridge credentials and waits for explicit model discovery", () => {
+ const draft = Object.freeze({ name: "SDK", api_key: "unsaved-cloud-key", proxy: "http://proxy:8080", session_header_key: "x-opencode-session", streaming: false, rate_per_minute: 7 });
+ const next = applyLLMProfilePreset(draft, "opencode-sdk");
+ assert.deepEqual(getLLMProfilePreset("opencode-sdk"), {
+ format: "opencode-sdk", base_url: "http://127.0.0.1:4097", model: "", api_key: "", proxy: "", session_header_key: "", streaming: true,
+ thinking_type: "", reasoning_effort: "", context_window_k: 0, max_tokens: 0, max_tokens_field: "",
+ });
+ assert.equal(next.name, draft.name);
+ assert.equal(next.rate_per_minute, draft.rate_per_minute);
+ for (const field of ["api_key", "proxy", "session_header_key", "model"]) assert.equal(next[field], "", field);
+ assert.equal(next.streaming, true);
+ assert.equal(draft.api_key, "unsaved-cloud-key");
+ assert.equal(isOllamaPreset("opencode-sdk"), false, "SDK discovery must not use automatic Ollama discovery");
+ assert.equal(applyLLMProfilePreset(next, "openai").api_key, "", "leaving SDK must not invent a cloud key");
+ assert.equal(applyLLMProfilePreset({ ...next, api_key: "bridge-token" }, "openai").api_key, "", "switching templates must not send a bridge token to a cloud provider");
+});
+
+test("saved bridge-token hints require the same SDK endpoint and never cross host aliases or formats", () => {
+ const profile = { format: "opencode-sdk", base_url: "http://127.0.0.1:4097/bridge/" };
+ assert.equal(canReuseSDKBridgeToken(profile, "opencode-sdk", " http://127.0.0.1:4097/bridge "), true);
+ for (const url of ["http://localhost:4097/bridge", "http://[::1]:4097/bridge", "http://2130706433:4097/bridge", "http://127.0.0.1:4098/bridge", "https://127.0.0.1:4097/bridge", "http://127.0.0.1:4097/other", "http://127.0.0.1:4097/bridge/a/../", "http://127.0.0.1:4097/bridge?token=x", "http://127.0.0.1:4097/bridge#x", "http://user@127.0.0.1:4097/bridge", "invalid", ""]) {
+ assert.equal(canReuseSDKBridgeToken(profile, "opencode-sdk", url), false, url);
+ }
+ for (const format of ["openai", "anthropic", "openai-responses", "ollama"]) {
+ assert.equal(canReuseSDKBridgeToken(profile, format, profile.base_url), false, format);
+ assert.equal(canReuseSDKBridgeToken({ ...profile, format }, "opencode-sdk", profile.base_url), false, format);
+ }
+ assert.equal(canReuseSDKBridgeToken(null, "opencode-sdk", profile.base_url), false);
+ assert.equal(canReuseSDKBridgeToken({ format: "opencode-sdk", base_url: "" }, "opencode-sdk", "http://127.0.0.1:4097/"), true, "blank SDK URLs use the default bridge root");
+});
test("GLM templates distinguish billing endpoints and use the measured economy settings", () => {
const general = getLLMProfilePreset("zai-general");
diff --git a/web/src/lib/llm-profile-presets.ts b/web/src/lib/llm-profile-presets.ts
index 0ab7140e..1cf2647c 100644
--- a/web/src/lib/llm-profile-presets.ts
+++ b/web/src/lib/llm-profile-presets.ts
@@ -14,6 +14,7 @@ export const LLM_PROFILE_PRESET_IDS = [
"kimi",
"openrouter",
"opencode-go",
+ "opencode-sdk",
"ollama-host",
"ollama-docker-host",
"ollama-compose",
@@ -70,7 +71,21 @@ export interface OllamaPresetFields {
session_header_key?: string;
}
-export type LLMProfilePresetFields = ZaiPresetFields | CloudPresetFields | OllamaPresetFields;
+export interface OpenCodeSDKPresetFields {
+ format: "opencode-sdk";
+ model: "";
+ base_url: string;
+ api_key: "";
+ proxy: "";
+ session_header_key: "";
+ streaming: true;
+ thinking_type: "";
+ reasoning_effort: "";
+ context_window_k: number;
+ max_tokens: number;
+ max_tokens_field: "";
+}
+export type LLMProfilePresetFields = ZaiPresetFields | CloudPresetFields | OllamaPresetFields | OpenCodeSDKPresetFields;
const OLLAMA_TARGETS: Record = {
"ollama-host": { base_url: "http://127.0.0.1:11434" },
@@ -110,6 +125,12 @@ export function getLLMProfilePreset(id: string): Readonly(draft: T, id: string): T & LLMProfilePresetFields {
- return { ...draft, ...getLLMProfilePreset(id) };
+ const preset = getLLMProfilePreset(id);
+ if ("format" in draft && draft.format === "opencode-sdk" && preset.format !== "opencode-sdk") {
+ return { ...draft, ...preset, api_key: "" };
+ }
+ return { ...draft, ...preset };
+}
+
+// A saved bridge token belongs only to that SDK endpoint, never to another format or host alias.
+export function canReuseSDKBridgeToken(
+ profile: { format: string; base_url?: string } | null | undefined,
+ format: string,
+ baseUrl: string,
+): boolean {
+ if (profile?.format !== "opencode-sdk" || format !== "opencode-sdk") return false;
+ const endpoint = (value: string) => {
+ const raw = value.trim() || "http://127.0.0.1:4097";
+ const parts = /^https?:\/\/(\[[^\]]+\]|[^/:?#]+)(?::\d+)?(\/[^?#]*)?$/.exec(raw);
+ if (!parts || raw.includes("\\")) return "";
+ const url = new URL(raw);
+ if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) return "";
+ const host = parts[1].toLowerCase();
+ if (!host.startsWith("[") && host !== url.hostname) return "";
+ if (url.hostname !== "localhost" && url.hostname !== "[::1]" && !/^127\./.test(url.hostname)) return "";
+ // Preserve path identity: the Go endpoint normalizer does not resolve dot segments.
+ return url.origin + (parts[2] ?? "").replace(/\/+$/, "");
+ };
+ try {
+ const previous = endpoint(profile.base_url ?? "");
+ return previous !== "" && previous === endpoint(baseUrl);
+ } catch {
+ return false;
+ }
}
// Choose only from the installed list, preferring confirmed native tool support.
diff --git a/web/src/lib/types.ts b/web/src/lib/types.ts
index 92fd96bd..8dc65008 100644
--- a/web/src/lib/types.ts
+++ b/web/src/lib/types.ts
@@ -1044,7 +1044,7 @@ export interface NotificationDelivery {
export interface LLMProfile {
id: string;
name: string;
- format: "openai" | "anthropic" | "openai-responses" | "ollama";
+ format: "openai" | "anthropic" | "openai-responses" | "ollama" | "opencode-sdk";
base_url?: string;
proxy?: string;
model: string;