dsh-think-translate 1.2.5 → 1.2.7

package/README.de.md

@@ -69,6 +69,10 @@ Am Plugin ist nichts zu konfigurieren: Es deklariert keine Reihenfolge-Abhängig
 
 Für DSH **0.2.0-rc.2** verwenden Sie **dsh-think-translate 1.2.5 oder neuer**. Version 1.2.5 behebt den Registrierungskonflikt des Slots `todo_write` und deklariert den Peer-Versionsbereich 0.2. Führen Sie `dsh plugin --profile web add dsh-think-translate@latest` aus und starten Sie DSH neu; eine Versionsausnahme ist nicht nötig.
 
+**1.2.6** behebt doppelt angezeigte Gedanken und Antworten in DSH 0.2: Der Renderer und die Originaltext-Anzeige bei Fehlern beachten die Gruppen reasoning/response.
+
+**1.2.7 lokale Vorbereitung:** Aktiviertes Ollama an erster Stelle oder dessen Test findet vorhandene Installationen und startet/lädt das Modell. Fehlende Software und Modelle werden erst über die Vorbereitungsschaltfläche installiert/heruntergeladen, mit Fortschritt je Phase. Automatische Softwareinstallation unter Windows, sonst offizielle Anleitung. Der aktuelle Anbieter folgt der Priorität aktivierter, geprüfter Anbieter.
+
 ## 🚀 Verwendung
 
 1. **Einstellungen → Übersetzung der Gedankenkette** öffnen

package/README.es.md

@@ -69,6 +69,10 @@ No hay nada que configurar en el plugin: no declara dependencia de orden con los
 
 Para DSH **0.2.0-rc.2**, usa **dsh-think-translate 1.2.5 o posterior**. La versión 1.2.5 corrige el conflicto de registro del slot `todo_write` y declara el rango peer 0.2. Ejecuta `dsh plugin --profile web add dsh-think-translate@latest` y reinicia DSH; no hace falta una excepción de versión.
 
+**1.2.6** corrige la duplicación del razonamiento y las respuestas en DSH 0.2: el renderizador y su texto original de respaldo respetan los grupos reasoning/response.
+
+**1.2.7 preparación local:** Ollama habilitado en primera posición, o su botón de prueba, detecta la instalación existente y arranca/carga el modelo. La instalación y descarga requieren el botón de preparación y muestran progreso por etapas. La instalación automática del software admite Windows; otros sistemas enlazan la guía oficial. El proveedor en uso sigue la prioridad de los proveedores habilitados y verificados.
+
 ## 🚀 Uso
 
 1. Abre **Ajustes → Traducción de cadena de pensamiento**

package/README.fr.md

@@ -69,6 +69,10 @@ Rien à configurer côté plugin : il ne déclare aucune dépendance d'ordre vis
 
 Pour DSH **0.2.0-rc.2**, utilisez **dsh-think-translate 1.2.5 ou une version ultérieure**. La version 1.2.5 corrige le conflit du slot `todo_write` et déclare la plage de versions peer 0.2. Exécutez `dsh plugin --profile web add dsh-think-translate@latest`, puis redémarrez DSH ; aucune exception de version requise.
 
+**1.2.6** corrige les pensées et réponses affichées en double dans DSH 0.2 : le rendu et le texte original de secours respectent les groupes reasoning/response.
+
+**1.2.7 préparation locale :** Ollama activé en première position, ou son test, détecte une installation existante, démarre le service et charge le modèle. Le bouton de préparation autorise les installations et téléchargements manquants, avec progression par étapes. Installation automatique du logiciel sur Windows ; guide officiel ailleurs. Le fournisseur utilisé respecte la priorité des fournisseurs activés et vérifiés.
+
 ## 🚀 Utilisation
 
 1. Ouvrez **Réglages → Traduction de chaîne de réflexion**

package/README.ja.md

@@ -69,6 +69,10 @@ New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-think-tr
 
 DSH **0.2.0-rc.2** では **dsh-think-translate 1.2.5 以降**を使用してください。1.2.5 は `todo_write` の slot 登録競合を修正し、0.2 の peer バージョン範囲を宣言します。`dsh plugin --profile web add dsh-think-translate@latest` を実行して DSH を再起動してください。バージョンの例外設定は不要です。
 
+**1.2.6** は DSH 0.2 で思考と回答が重複表示される問題を修正します。助手の表示とエラー時の原文表示が reasoning/response の各グループに従います。
+
+**1.2.7 ローカル準備：**有効な Ollama を最優先にするかテストすると、既存のインストールを検出し起動・モデルロードします。不足するソフトやモデルは準備ボタンでインストールし、段階別の進捗を表示します。自動インストールは Windows 対応、他の OS は公式ガイドを表示します。使用中の表示は優先順位の高い検証済み提供元を維持します。
+
 ## 🚀 使い方
 
 1. **設定 → 思考チェーン翻訳** を開く

package/README.ko.md

@@ -69,6 +69,10 @@ New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-think-tr
 
 DSH **0.2.0-rc.2**에서는 **dsh-think-translate 1.2.5 이상**을 사용하세요. 1.2.5는 `todo_write` slot 등록 충돌을 수정하고 0.2 peer 버전 범위를 선언합니다. `dsh plugin --profile web add dsh-think-translate@latest`를 실행한 뒤 DSH를 다시 시작하세요. 버전 예외 설정은 필요 없습니다.
 
+**1.2.6**은 DSH 0.2에서 사고와 답변이 중복 표시되는 문제를 수정합니다. 어시스턴트 렌더링과 오류 시 원문 표시 모두 reasoning/response 그룹을 따릅니다.
+
+**1.2.7 로컬 준비:** 활성 Ollama를 첫 순위로 두거나 테스트하면 기존 설치를 찾아 시작하고 모델을 로드합니다. 누락된 소프트웨어와 모델은 준비 버튼을 눌러 설치/다운로드하며 단계별 진행 상황을 표시합니다. 자동 설치는 Windows에서 지원하며 다른 OS는 공식 안내를 제공합니다. 현재 사용 표시는 우선순위가 가장 높은 검증된 제공자를 유지합니다.
+
 ## 🚀 사용법
 
 1. **설정 → 사고 체인 번역** 열기

package/README.md

@@ -66,6 +66,10 @@ Nothing to configure on the plugin side: it declares no ordering dependency on D
 
 For DSH **0.2.0-rc.2**, use **dsh-think-translate 1.2.5 or later**. Version 1.2.5 fixes the `todo_write` slot collision and declares the 0.2 peer range. Run `dsh plugin --profile web add dsh-think-translate@latest`, then restart DSH; no version exemption is needed.
 
+Version **1.2.6** fixes duplicated thinking and answer text in DSH 0.2: the assistant renderer now respects the separate reasoning/response groups, including its original-text error fallback.
+
+**1.2.7 local setup:** enabled Ollama in first priority, or its Test button, finds an existing installation and starts/loads it automatically. Missing software/models require the labelled setup action, with staged download/install/load progress. Automatic software installation supports Windows; other systems link to the official guide. “In use” follows the first enabled, verified provider in priority order; testing a lower row does not override a verified higher row.
+
 ## 🚀 Usage
 
 1. Open **Settings → Think Translation**

package/README.ru.md

@@ -69,6 +69,10 @@ New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-think-tr
 
 Для DSH **0.2.0-rc.2** используйте **dsh-think-translate 1.2.5 или новее**. Версия 1.2.5 исправляет конфликт регистрации slot `todo_write` и объявляет диапазон peer-версий 0.2. Выполните `dsh plugin --profile web add dsh-think-translate@latest`, затем перезапустите DSH; исключение версии не требуется.
 
+**1.2.6** исправляет двойное отображение рассуждений и ответов в DSH 0.2: основной вывод и исходный текст при ошибке учитывают группы reasoning/response.
+
+**1.2.7 локальная подготовка:** включённый Ollama на первом месте или его тест находит существующую установку, запускает сервис и загружает модель. Отсутствующие компоненты устанавливаются после нажатия кнопки подготовки с отображением этапов и прогресса. Автоустановка программы поддерживает Windows; для других ОС доступна официальная инструкция. Текущий провайдер выбирается по приоритету включённых и проверенных провайдеров.
+
 ## 🚀 Использование
 
 1. Откройте **Настройки → Перевод цепочки размышлений**

package/README.zh-CN.md

@@ -69,6 +69,10 @@ New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-think-tr
 
 DSH **0.2.0-rc.2** 请使用 **dsh-think-translate 1.2.5 或更新版本**。1.2.5 修复了 `todo_write` 的 slot 注册冲突，并声明支持 0.2 版本范围。执行 `dsh plugin --profile web add dsh-think-translate@latest` 后重启 DSH，无需添加版本豁免。
 
+**1.2.6** 修复 DSH 0.2 中思考与回答重复显示的问题：助手渲染器现在遵守 reasoning/response 分组，出错时的原文回退也按组显示。
+
+**1.2.7 本地准备：**已启用的 Ollama 排到第一位，或点击其测试按钮时，会自动查找已有安装并启动、加载模型。缺少软件或模型时，点击首次准备入口后才安装/下载，并显示分阶段进度。自动安装软件支持 Windows，其他系统提供官方指南。“当前使用”按优先级选择第一个已启用且验证成功的提供方，测试后面的行不会覆盖已成功的前面一行。
+
 ## 🚀 使用
 
 1. 打开 **设置 → 思考链翻译**

package/lib/client.js

@@ -23,7 +23,7 @@ window.__ModuleLoader__.load({
 		// there yet (an older process still serving the port), and the contract test
 		// pins PLUGIN_VERSION to package.json so the two can never drift.
 		var PLUGIN_NAME = "dsh-think-translate";
-		var PLUGIN_VERSION = "1.2.5";
+		var PLUGIN_VERSION = "1.2.7";
 		var PLUGIN_REPO = "https://github.com/UncleK/dsh-think-translate";
 		// The official MarkdownText contract changed in 0.1.2-alpha: it now takes a
 		// nested `labels` object and dereferences it without defaults inside its code
@@ -713,7 +713,18 @@ window.__ModuleLoader__.load({
 			} catch (e) {}
 		}
 		var pend = new Map();
-		var stats = { ok: 0, fail: 0, lastError: null, lastProvider: null, lastModel: null };
+		var stats = { ok: 0, fail: 0, lastError: null, lastProvider: null, lastModel: null };
+		var providerChecks = {};
+		var providerTestSequence = {};
+		var statusListeners = new Set();
+		function providerFingerprint(p) {
+			return fnv(JSON.stringify({ type: p.type, baseURL: p.baseURL, model: p.model, apiKeyEnv: p.apiKeyEnv,
+				apiKey: p.source === "dsh" || p.apiKeyEnv ? undefined : p.apiKey }));
+		}
+		function recordCheck(id, ok, model, signature) {
+			providerChecks[id] = { ok: ok, model: model || null, signature: signature };
+			statusListeners.forEach(function (notify) { notify(); });
+		}
 		// Diagnostic ledger surfaced in the settings panel (2026-08-24): bundle
 		// version, apply execution, per-slot registration outcome, current lang.
 		var diag = { version: "v5-mode", applied: false, lang: "?", slots: {}, lastLangChange: 0 };
@@ -844,7 +855,8 @@ window.__ModuleLoader__.load({
 				body: JSON.stringify({ text: text, target: target })
 			}, 30000);
 			if (!res.ok) throw new Error("route HTTP " + res.status);
-			var j = await res.json();
+			var j = await res.json();
+			if (j && Array.isArray(j.attempts)) j.attempts.forEach(function (attempt) { recordCheck(attempt.provider, attempt.ok, attempt.model, attempt.signature); });
 			if (!(j && j.ok)) throw new Error("route ok=false");
 			return j;
 		}
@@ -880,7 +892,8 @@ window.__ModuleLoader__.load({
 							r = { ok: true, text: outs.join(""), provider: "google-direct" };
 						} catch (e2) { r = null; if (e2 && e2.message) lastErr = e2; }
 					}
-					if (r && r.ok) {
+					if (r && r.ok) {
+						if (r.providerSignature) recordCheck(r.provider, true, r.model, r.providerSignature);
 						stats.ok++; stats.lastError = null; stats.lastProvider = r.provider; stats.lastModel = r.model || null;
 						memSet(key, r);
 						return r;
@@ -1225,8 +1238,9 @@ window.__ModuleLoader__.load({
 		}
 
 		function AssistantView(props) {
-			var node = props.node;
-			var data = node.data;
+			var node = props.node;
+			var data = node.data;
+			var groupPart = props.groupPart;
 			var useTurnData = props.useTurnData;
 			var tt = UI_TEXT[useStore().lang] || UI_TEXT.en;
 			var tail = useTurnData("turn-tail");
@@ -1245,8 +1259,12 @@ window.__ModuleLoader__.load({
 			var rendered = [];
 			var last = blocks.length - 1;
 			for (var i = 0; i < blocks.length; i++) {
-				var block = blocks[i];
-				if (!block) continue;
+				var block = blocks[i];
+				if (!block) continue;
+				// DSH may mount this step separately for reasoning and response.
+				// Keep original block indexes so streaming-tail detection is unchanged.
+				if (groupPart === "reasoning" && block.kind !== "reasoning") continue;
+				if (groupPart === "response" && block.kind === "reasoning") continue;
 				if (block.kind === "text") {
 					rendered.push(createElement(TextBlockSafe, { key: "t" + i, text: block.text, streaming: streaming }));
 				} else if (block.kind === "reasoning") {
@@ -1262,16 +1280,20 @@ window.__ModuleLoader__.load({
 				} else {
 					rendered.push(createElement("pre", { key: "u" + i, className: "xl-pre" }, JSON.stringify(block, null, 2)));
 				}
-			}
-			return createElement("div", null, rendered,
-				interrupted ? createElement("span", { className: "xl-warn" }, (props.t && props.t("message.stopped")) || tt.stopped) : null);
+			}
+			var showStopped = interrupted && (groupPart === undefined || groupPart === "response" ||
+				!blocks.some(function (b) { return b && b.kind !== "reasoning" && b.kind !== "tool-call"; }));
+			return createElement("div", null, rendered,
+				showStopped ? createElement("span", { className: "xl-warn" }, (props.t && props.t("message.stopped")) || tt.stopped) : null);
 		}
 
-		function originalBlocksText(blocks) {
+		function originalBlocksText(blocks, groupPart) {
 			var parts = [];
 			for (var i = 0; i < blocks.length; i++) {
-				var b = blocks[i];
-				if (!b) continue;
+				var b = blocks[i];
+				if (!b) continue;
+				if (groupPart === "reasoning" && b.kind !== "reasoning") continue;
+				if (groupPart === "response" && b.kind === "reasoning") continue;
 				if ((b.kind === "text" || b.kind === "reasoning") && typeof b.text === "string" && b.text.trim()) parts.push(b.text);
 			}
 			return parts;
@@ -1294,7 +1316,7 @@ window.__ModuleLoader__.load({
 			try {
 				var node = props && props.node;
 				var blocks = node && node.data && Array.isArray(node.data.blocks) ? node.data.blocks : [];
-				var parts = originalBlocksText(blocks);
+				var parts = originalBlocksText(blocks, props.groupPart);
 				if (parts.length) fb = createElement("div", null, createElement(Markdownish, { text: parts.join("\n\n") }));
 			} catch (e) { fb = null; }
 			return createElement(XBoundary, { fallback: fb }, createElement(AssistantView, props));
@@ -1478,12 +1500,17 @@ window.__ModuleLoader__.load({
 			// `mem` is a plain Map, so clearing it changes nothing React can see: the
 			// 缓存条目 counter kept the old number until some other state moved.
 			var tickPair = useState(0);
-			var bumpTick = tickPair[1];
-			// "当前使用" answers the question the block exists for: which provider and
-			// model the last successful translation actually went through.
-			var inUse = stats.lastProvider
-				? ((t.labels[stats.lastProvider] || stats.lastProvider) + (stats.lastModel ? " · " + stats.lastModel : ""))
-				: t.providerDesc;
+			var bumpTick = tickPair[1];
+			useEffect(function () { var notify = function () { bumpTick(function (n) { return n + 1; }); }; statusListeners.add(notify); return function () { statusListeners.delete(notify); }; }, []);
+			// A lower-ranked provider test cannot displace a verified higher-ranked one.
+			var currentCfg = draft.cfg || {};
+			var ids = (currentCfg.chain || []).concat(currentCfg.fallback && currentCfg.fallback.enabled ? currentCfg.fallback.chain || [] : []);
+			var current = null;
+			for (var i = 0; i < ids.length; i++) {
+				var p = currentCfg.providers && currentCfg.providers[ids[i]], check = providerChecks[ids[i]];
+				if (p && (p.enabled || p.source === "dsh") && check && check.ok && check.signature === providerFingerprint(p)) { current = { id: ids[i], model: check.model }; break; }
+			}
+			var inUse = current ? ((t.labels[current.id] || current.id) + (current.model ? " · " + current.model : "")) : (LOCAL_EMPTY[s.lang] || LOCAL_EMPTY.en);
 			return createElement("div", null,
 				// The clear button rides the "当前使用" row, pushed to that row's end:
 				// one row per idea (what is in use, then the counters), no stray rows.
@@ -1590,7 +1617,25 @@ window.__ModuleLoader__.load({
 		// lives here instead, outside React. Refs (cfgRef/seqRef) deliberately do NOT:
 		// they belong to the instance that owns the in-flight requests.
 		// ------------------------------------------------------------------
-		var draft = {};
+		var draft = {};
+		var LOCAL_EMPTY = { "zh-CN": "尚未验证可用提供方", en: "No provider verified yet", ja: "提供元は未確認です", ko: "검증된 제공자가 없습니다", es: "Sin proveedor verificado", fr: "Aucun fournisseur vérifié", de: "Noch kein Anbieter geprüft", ru: "Провайдер пока не проверен" };
+		var LOCAL_PHASES = ["checking", "needs_install", "downloading_ollama", "verifying", "installing", "starting", "needs_model", "downloading_model", "loading_model", "ready", "error", "setup", "retry", "manual"];
+		var LOCAL_LABELS = {
+			"zh-CN": ["检查已有 Ollama", "未找到 Ollama", "下载 Ollama", "验证安装包", "安装 Ollama", "启动 Ollama", "所选模型尚未下载", "下载模型", "加载模型", "本地模型已就绪", "准备失败", "一键安装并准备（含模型下载）", "重试准备", "打开官方安装指南"],
+			en: ["Checking existing Ollama", "Ollama not found", "Downloading Ollama", "Verifying installer", "Installing Ollama", "Starting Ollama", "Selected model is not downloaded", "Downloading model", "Loading model", "Local model is ready", "Preparation failed", "Install and prepare (includes model download)", "Retry preparation", "Official installation guide"],
+			ja: ["既存の Ollama を確認", "Ollama が見つかりません", "Ollama をダウンロード", "インストーラーを検証", "Ollama をインストール", "Ollama を起動", "モデルは未ダウンロード", "モデルをダウンロード", "モデルをロード", "ローカルモデル準備完了", "準備に失敗", "インストールして準備（モデルを含む）", "準備を再試行", "公式インストールガイド"],
+			ko: ["기존 Ollama 확인", "Ollama를 찾을 수 없음", "Ollama 다운로드", "설치 파일 검증", "Ollama 설치", "Ollama 시작", "모델이 다운로드되지 않음", "모델 다운로드", "모델 로드", "로컬 모델 준비 완료", "준비 실패", "설치 및 준비 (모델 다운로드 포함)", "준비 다시 시도", "공식 설치 안내"],
+			es: ["Comprobando Ollama", "Ollama no encontrado", "Descargando Ollama", "Verificando instalador", "Instalando Ollama", "Iniciando Ollama", "Modelo sin descargar", "Descargando modelo", "Cargando modelo", "Modelo local listo", "Preparación fallida", "Instalar y preparar (incluye el modelo)", "Reintentar preparación", "Guía oficial de instalación"],
+			fr: ["Vérification de Ollama", "Ollama introuvable", "Téléchargement de Ollama", "Vérification du programme", "Installation de Ollama", "Démarrage de Ollama", "Modèle non téléchargé", "Téléchargement du modèle", "Chargement du modèle", "Modèle local prêt", "Échec de préparation", "Installer et préparer (modèle inclus)", "Réessayer", "Guide officiel"],
+			de: ["Ollama prüfen", "Ollama nicht gefunden", "Ollama herunterladen", "Installationsdatei prüfen", "Ollama installieren", "Ollama starten", "Modell nicht heruntergeladen", "Modell herunterladen", "Modell laden", "Lokales Modell bereit", "Vorbereitung fehlgeschlagen", "Installieren und vorbereiten (mit Modell)", "Erneut vorbereiten", "Offizielle Installationsanleitung"],
+			ru: ["Проверка Ollama", "Ollama не найден", "Загрузка Ollama", "Проверка установщика", "Установка Ollama", "Запуск Ollama", "Модель не скачана", "Скачивание модели", "Загрузка модели", "Локальная модель готова", "Ошибка подготовки", "Установить и подготовить (с моделью)", "Повторить подготовку", "Официальная инструкция"],
+		};
+		function localLabel(phase, lang) { var index = LOCAL_PHASES.indexOf(phase); return (LOCAL_LABELS[lang] || LOCAL_LABELS.en)[index < 0 ? 0 : index]; }
+		function localOrigin(p) {
+			try { var u = new URL(p && p.baseURL); return p.type === "openai" && u.protocol === "http:" &&
+				["localhost", "127.0.0.1", "[::1]"].indexOf(u.hostname) >= 0 && u.port === "11434" && /^\/v1\/?$/.test(u.pathname) && !u.username && !u.password && !u.search && !u.hash ? u.origin : null; }
+			catch (e) { return null; }
+		}
 		function useDraft(key, initial) {
 			var pair = useState(key in draft ? draft[key] : initial);
 			if (!(key in draft)) draft[key] = pair[0];
@@ -1613,7 +1658,11 @@ window.__ModuleLoader__.load({
 			var pair = useDraft("cfg", null);
 			var cfg = pair[0], setCfg = pair[1];
 			var msgPair = useDraft("msg", "");
-			var msg = msgPair[0], setMsg = msgPair[1];
+			var msg = msgPair[0], setMsg = msgPair[1];
+			var localPair = useDraft("localJob", null);
+			var localJob = localPair[0];
+			var localJobRef = useState(function () { return { current: localJob && localJob.id }; })[0];
+			function setLocalJob(job) { localJobRef.current = job && job.id; localPair[1](job); }
 			var modelsPair = useDraft("models", null);
 			var models = modelsPair[0], setModels = modelsPair[1];
 			var modelMenuPair = useDraft("modelMenu", null); var modelMenu = modelMenuPair[0], setModelMenu = modelMenuPair[1];
@@ -1661,7 +1710,53 @@ window.__ModuleLoader__.load({
 			// Monotonic save sequence: a stale /_xlate/config POST response must
 			// not overwrite a newer optimistic state (Important-3/4).
 			var seqRefPair = useState(function () { return { current: 0 }; });
-			var seqRef = seqRefPair[0];
+			var seqRef = seqRefPair[0];
+			var localSeq = useState(function () { return { current: 0 }; })[0];
+			function testProvider(id, sequence) {
+				var testSequence = (providerTestSequence[id] || 0) + 1;
+				providerTestSequence[id] = testSequence;
+				var testedProvider = cfgRef.current.providers[id] || {};
+				var testedModel = testedProvider.model;
+				var testedSignature = providerFingerprint(testedProvider);
+				setMsg(t.testing);
+				return fetch("/_xlate/translate", { method: "POST", headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({ text: "Hello world, connection test. [" + Date.now().toString(36) + "]", target: s.lang, provider: id }) })
+					.then(function (r) { if (!r.ok) throw new Error("HTTP " + r.status); return r.json(); })
+					.then(function (j) { if (sequence !== undefined && sequence !== localSeq.current) return;
+						if (providerTestSequence[id] !== testSequence) return;
+						var currentProvider = cfgRef.current.providers[id] || {};
+						if (providerFingerprint(currentProvider) !== testedSignature || (j.model && testedModel && j.model !== testedModel)) return;
+						recordCheck(id, !!(j && j.ok), j.model || testedModel, j.providerSignature || testedSignature);
+						if (j && j.ok) stats.lastError = null;
+						setMsg(j && j.ok ? t.connOk + " ✓ (" + providerLabel(id, (cfgRef.current.providers || {})[id] || {}, t) + (j.model ? " · " + j.model : "") + ")" : (t.connFail + ": " + (j.error || "unknown"))); })
+					.catch(function (e) { if (sequence !== undefined && sequence !== localSeq.current) return;
+						if (providerTestSequence[id] !== testSequence || providerFingerprint(cfgRef.current.providers[id] || {}) !== testedSignature) return;
+						recordCheck(id, false, testedModel, testedSignature);
+						setMsg(t.connFail + ": " + (e && e.message ? e.message : e)); });
+			}
+			function prepareLocal(allowSetup, testAfter, downloadOnly) {
+				var sequence = ++localSeq.current;
+				return fetch("/_xlate/local/prepare", { method: "POST", headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({ allowInstall: allowSetup === true, allowDownload: allowSetup === true || downloadOnly === true }) })
+					.then(function (r) { return r.json().then(function (j) { if (!r.ok || !j.ok) throw new Error(j.error || "HTTP " + r.status); return j; }); })
+					.then(function (j) { if (sequence !== localSeq.current) return; setLocalJob(j.job); if (testAfter) return testProvider("openai", sequence); })
+					.catch(function (e) { if (sequence === localSeq.current) setMsg(localLabel("error", s.lang) + ": " + (e.message || e)); });
+			}
+			var localProvider = cfg && cfg.providers && cfg.providers.openai;
+			var firstEnabled = cfg && (cfg.chain || []).filter(function (id) { var p = cfg.providers[id]; return p && (p.enabled || p.source === "dsh"); })[0];
+			var localKey = firstEnabled === "openai" && localOrigin(localProvider) && localProvider.model ? localProvider.baseURL + "|" + localProvider.model : "";
+			useEffect(function () { if (localKey) prepareLocal(false, false); }, [localKey]);
+			useEffect(function () {
+				if (!localJob || !localJob.running) return;
+				var alive = true;
+				var timer = setInterval(function () {
+					fetch("/_xlate/local/status?id=" + encodeURIComponent(localJob.id)).then(function (r) { return r.json(); }).then(function (j) {
+						if (alive && j.job && localJobRef.current === localJob.id) setLocalJob(j.job);
+					}).catch(function () {});
+				}, 750);
+				return function () { alive = false; clearInterval(timer); };
+			}, [localJob ? localJob.id + "|" + localJob.running : ""]);
+			useEffect(function () { return function () { localSeq.current++; }; }, []);
 			// Add/edit inline form state. Lives here (not in a nested component,
 			// and before the cfg guard) so re-renders — including the cfg=null →
 			// cfg=value transition — never reset or reorder what the user types;
@@ -1776,23 +1871,12 @@ window.__ModuleLoader__.load({
 							.catch(function () {});
 					});
 			};
-			var startPull = function (m) {
-				if (!m || !m.trim()) return;
-				var name = m.trim();
-				setPull({ model: name, status: "starting", percent: 0, done: false, error: null });
-				// The POST only starts the job (the 1 s poll reports progress), so a
-				// rejected start must surface here — otherwise the panel sits in
-				// "downloading" forever and the user is never told why.
-				fetch("/_xlate/model/pull", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ model: name }) })
-					.then(function (r) {
-						return r.json().catch(function () { return {}; }).then(function (j) {
-							if (!r.ok || (j && j.ok === false)) throw new Error((j && j.error) || ("HTTP " + r.status));
-							return j;
-						});
-					})
-					.catch(function (e) {
-						setPull({ model: name, status: "error", percent: 0, done: false, error: e && e.message ? e.message : "network" });
-					});
+			var startPull = function (m) {
+				if (!m || !m.trim()) return;
+				var name = m.trim();
+				// Download intent prepares an existing service first. Software install
+				// still needs the separately labelled setup button if Ollama is absent.
+				pickModel(name).then(function (saved) { if (saved) prepareLocal(false, false, true); });
 			};
 			var pickModel = function (m) {
 				if (!m) return;
@@ -1800,9 +1884,9 @@ window.__ModuleLoader__.load({
 				var openai = (cur.providers && cur.providers.openai) || {};
 				applyLocal({ providers: { openai: { model: m } } });
 				setModelMenu(null);
-				fetch("/_xlate/config", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ providers: { openai: { model: m } } }) })
+				return fetch("/_xlate/config", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ providers: { openai: { model: m } } }) })
 					.then(function (r) { if (!r.ok) throw new Error("HTTP " + r.status); return r.json(); })
-					.then(function (c) { cfgRef.current = c; setCfg(c); })
+					.then(function (c) { cfgRef.current = c; setCfg(c); return c; })
 					.catch(function (e) {
 						// Do not leave the chip showing a model the host never stored.
 						setMsg((t.providerSaveError || t.connFail) + ": " + (e && e.message ? e.message : e));
@@ -1869,13 +1953,9 @@ window.__ModuleLoader__.load({
 					applyLocal({ chain: chain });
 					saveCfg({ chain: chain });
 				},
-				test: function (id) {
-					setMsg(t.testing);
-					fetch("/_xlate/translate", { method: "POST", headers: { "Content-Type": "application/json" },
-						body: JSON.stringify({ text: "Hello world, connection test. [" + Date.now().toString(36) + "]", target: s.lang, provider: id }) })
-						.then(function (r) { return r.json(); })
-						.then(function (j) { setMsg(j && j.ok ? t.connOk + " ✓ (" + providerLabel(id, (cfgRef.current.providers || {})[id] || {}, t) + (j.model ? " · " + j.model : "") + ")" : (t.connFail + ": " + (j.error || "unknown"))); })
-						.catch(function (e) { setMsg(t.connFail + ": " + (e && e.message ? e.message : e)); });
+				test: function (id) {
+					if (id === "openai" && localOrigin(cfgRef.current.providers.openai)) prepareLocal(false, true);
+					else testProvider(id);
 				},
 				edit: function (id) {
 					var p = cfgRef.current.providers && cfgRef.current.providers[id];
@@ -2228,7 +2308,18 @@ window.__ModuleLoader__.load({
 				adding || editingId ? null
 					: createElement("button", { className: "xl-btn", type: "button", onClick: rescanDsh, style: { marginTop: "4px", marginLeft: "6px" } },
 						"↻ " + t.dshImport),
-				unusedArea,
+				unusedArea,
+				localJob && localProvider && localJob.model === localProvider.model && localJob.origin === localOrigin(localProvider)
+					? createElement("div", { className: "xl-local-status", role: "status", style: { marginTop: "8px" } },
+						createElement("div", { className: "xl-note" }, localLabel(localJob.phase, s.lang) + " · " + localJob.model +
+							(localJob.percent !== null && localJob.phase.indexOf("downloading") === 0 ? " · " + localJob.percent + "%" : "") +
+							(localJob.completed ? " · " + (localJob.completed / 1048576).toFixed(1) + " MB" + (localJob.total ? " / " + (localJob.total / 1048576).toFixed(1) + " MB" : "") : "")),
+						localJob.running ? createElement("div", { className: "xl-progress" }, createElement("div", { className: "xl-progress-bar", style: { width: (localJob.percent === null ? 15 : localJob.percent) + "%" } })) : null,
+						localJob.error ? createElement("div", { className: "xl-warn" }, localJob.error) : null,
+						!localJob.running && (localJob.phase === "needs_model" || localJob.phase === "error" || (localJob.phase === "needs_install" && localJob.canInstall))
+							? createElement("button", { className: "xl-btn", onClick: function () { prepareLocal(true, true); } }, localLabel(localJob.phase === "error" ? "retry" : "setup", s.lang)) : null,
+						localJob.phase === "needs_install" && !localJob.canInstall ? createElement("a", { href: "https://ollama.com/download", target: "_blank", rel: "noreferrer" }, localLabel("manual", s.lang)) : null)
+					: null,
 				msg ? createElement("div", { className: "xl-note", style: { marginTop: "6px" } }, msg) : null);
 		}
 

package/lib/index.js

@@ -6,8 +6,11 @@
 // Providers: google (gtx via Node CONNECT tunnel / curl), bing (ttranslatev3
 // via curl), openai-compatible (any /chat/completions endpoint — usually the
 // local Ollama).
-import { readFile, writeFile, mkdir, copyFile } from 'node:fs/promises'
-import { dirname } from 'node:path'
+import { readFile, writeFile, mkdir, copyFile, access, unlink, stat } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { tmpdir } from 'node:os'
+import { randomUUID } from 'node:crypto'
+import { createLocalPreparation, ollamaOrigin, localFirst, validOllamaSignature } from './ollama.js'
 import { fileURLToPath } from 'node:url'
 import http from 'node:http'
 import https from 'node:https'
@@ -83,7 +86,134 @@ const VALID_TYPES = ['google', 'bing', 'openai', 'anthropic']
 // ---------------------------------------------------------------- transport
 
 let subprocessRef = null
-let timerRef = null
+let timerRef = null
+
+async function localJson(url, options = {}, timeoutMs = 10000) {
+  const response = await fetch(url, { ...options, redirect: 'error', signal: AbortSignal.timeout(timeoutMs) })
+  const body = await response.json()
+  if (!response.ok || body.error) throw new Error(body.error || 'Ollama HTTP ' + response.status)
+  return body
+}
+
+async function findOllamaExecutable() {
+  if (!subprocessRef) throw new Error('subprocess unavailable')
+  try { return await subprocessRef.resolveExecutable('ollama') } catch { /* Try installed-app locations when PATH is stale. */ }
+  const candidates = process.platform === 'win32'
+    ? [join(process.env.LOCALAPPDATA || '', 'Programs', 'Ollama', 'ollama.exe')]
+    : ['/usr/local/bin/ollama', '/usr/bin/ollama', '/Applications/Ollama.app/Contents/Resources/ollama']
+  if (process.platform === 'win32') for (const hive of ['HKCU', 'HKLM']) {
+    try {
+      const key = hive + ':\\Software\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{44E83376-CE68-45EB-8FC1-393500EB558C}_is1'
+      const result = await runProgram('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+        '[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false);$p=Get-ItemProperty -LiteralPath ' + "'" + key + "'" + ' -ErrorAction Stop;[Console]::Write($p.InstallLocation)'], 8000)
+      if (result.trim()) candidates.push(join(result.trim(), 'ollama.exe'))
+    } catch { /* This hive may not contain an Ollama installation. */ }
+  }
+  for (const candidate of candidates) {
+    try { await access(candidate); return candidate } catch { /* Probe the next known installation location. */ }
+  }
+  return null
+}
+
+async function startOllamaServer(executable, origin) {
+  const child = subprocessRef.spawn({
+    argv: [executable, 'serve'], cwd: await workdir(), graceMs: 2000,
+    stdio: { stdin: 'ignore', stdout: 'ignore', stderr: 'pipe' },
+    env: { OLLAMA_HOST: new URL(origin).host },
+  })
+  // Drain the long-lived pipe; the subprocess provider owns shutdown and joins.
+  if (child.stderr) (async () => { for await (const chunk of child.stderr) { void chunk } })().catch(() => {})
+  child.done.catch(() => {})
+}
+
+async function streamModelPull(origin, model, progress) {
+  const response = await fetch(origin + '/api/pull', {
+    method: 'POST', headers: { 'Content-Type': 'application/json' }, redirect: 'error',
+    body: JSON.stringify({ model, stream: true }), signal: AbortSignal.timeout(60 * 60 * 1000),
+  })
+  if (!response.ok) throw new Error('Ollama download HTTP ' + response.status)
+  const decoder = new TextDecoder()
+  const layers = new Map()
+  let buffer = '', success = false
+  const consume = line => {
+    if (!line.trim()) return
+    const event = JSON.parse(line)
+    if (event.error) throw new Error(event.error)
+    if (event.digest && typeof event.total === 'number') layers.set(event.digest, {
+      total: event.total, completed: typeof event.completed === 'number' ? event.completed : 0,
+    })
+    let total = 0, completed = 0
+    for (const layer of layers.values()) { total += layer.total; completed += layer.completed }
+    progress({ total, completed, percent: total ? Math.min(100, Math.round(completed / total * 100)) : null })
+    if (event.status === 'success') success = true
+  }
+  for await (const bytes of response.body) {
+    buffer += decoder.decode(bytes, { stream: true })
+    let index
+    while ((index = buffer.indexOf('\n')) >= 0) { consume(buffer.slice(0, index)); buffer = buffer.slice(index + 1) }
+  }
+  consume(buffer + decoder.decode())
+  if (!success) throw new Error('Model download ended before Ollama reported success')
+}
+
+async function installOllama(progress) {
+  const file = join(tmpdir(), 'dsh-ollama-' + randomUUID() + '.exe')
+  try {
+    progress({ phase: 'downloading_ollama', percent: null, completed: 0, total: 0 })
+    let totalBytes = 0
+    try {
+      const headers = await runProgram('curl', await curlArgs(['--fail', '--head', '--location', 'https://ollama.com/download/OllamaSetup.exe']), 30000)
+      const lengths = [...headers.matchAll(/content-length:\s*(\d+)/gi)]
+      if (lengths.length) totalBytes = Number(lengths[lengths.length - 1][1])
+    } catch { /* A missing HEAD size does not prevent a signed download. */ }
+    const args = await curlArgs(['--fail', '--location', '--proto', '=https', '--proto-redir', '=https',
+      '--progress-bar', '--retry', '2', '--max-time', '1800', '--output', file, 'https://ollama.com/download/OllamaSetup.exe'])
+    // Replace curlArgs' silent/25-second prefix with the download's own limit.
+    const filtered = args.slice(3)
+    const executable = await subprocessRef.resolveExecutable('curl')
+    const child = subprocessRef.spawn({ argv: [executable, ...filtered], cwd: await workdir(), graceMs: 2000,
+      signal: AbortSignal.timeout(30 * 60 * 1000), stdio: { stdin: 'ignore', stdout: 'ignore', stderr: 'pipe' } })
+    let tail = ''
+    if (child.stderr) for await (const bytes of child.stderr) {
+      tail = (tail + new TextDecoder().decode(bytes)).slice(-2000)
+      const matches = [...tail.matchAll(/(\d+(?:\.\d+)?)%/g)]
+      const downloaded = await stat(file).catch(() => null)
+      progress({ completed: downloaded ? downloaded.size : 0, total: totalBytes,
+        percent: matches.length ? Math.min(100, Number(matches[matches.length - 1][1])) : null })
+    }
+    const outcome = await child.done
+    if (outcome.exitCode !== 0) throw new Error('Ollama installer download failed: ' + tail.trim().slice(-300))
+    progress({ phase: 'verifying', percent: null })
+    const quoted = "'" + file.replace(/'/g, "''") + "'"
+    const signature = await runProgram('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+      '$s=Get-AuthenticodeSignature -LiteralPath ' + quoted + '; @{status=[string]$s.Status;subject=$s.SignerCertificate.Subject}|ConvertTo-Json -Compress'], 30000)
+    if (!validOllamaSignature(JSON.parse(signature))) throw new Error('Ollama installer signature verification failed')
+    progress({ phase: 'installing', percent: null })
+    const appState = join(process.env.LOCALAPPDATA, 'Ollama')
+    await mkdir(appState, { recursive: true })
+    await writeFile(join(appState, 'upgraded'), '', 'utf8') // Official installer convention: launch the app hidden.
+    // The official per-user installer supports these unattended flags.
+    const controller = new AbortController()
+    const deadline = setTimeout(() => controller.abort(), 10 * 60 * 1000)
+    try {
+      // Ignore inherited pipes: a background app launched by the installer can
+      // retain them even after the installer itself exits successfully.
+      const child = subprocessRef.spawn({ argv: [file, '/VERYSILENT', '/NORESTART', '/SUPPRESSMSGBOXES'],
+        cwd: await workdir(), graceMs: 2000, signal: controller.signal,
+        stdio: { stdin: 'ignore', stdout: 'ignore', stderr: 'ignore' } })
+      const outcome = await child.done
+      if (outcome.exitCode !== 0) throw new Error('Ollama installation failed with exit code ' + outcome.exitCode)
+    } finally { clearTimeout(deadline) }
+  } finally {
+    await unlink(file).catch(() => {}) // Only this operation's unique installer download.
+  }
+}
+
+const localPreparation = createLocalPreparation({
+  platform: process.platform, json: localJson, findExecutable: findOllamaExecutable,
+  startServer: startOllamaServer, install: installOllama, pull: streamModelPull,
+  wait: milliseconds => new Promise(resolve => setTimeout(resolve, milliseconds)),
+})
 
 async function workdir() {
   return process.cwd() || '.'
@@ -1027,8 +1157,9 @@ function chunkText(text) {
 }
 
 // Run one ordered provider-id list; returns { ok } or { ok: false, error }.
-async function runChainFor(ids, text, target, cfg) {
-  let lastErr = null
+async function runChainFor(ids, text, target, cfg) {
+  let lastErr = null
+  const attempts = []
   for (const id of ids) {
     const p = cfg.providers && cfg.providers[id]
     // DSH-sourced providers are activated by chain membership (they cannot be
@@ -1038,22 +1169,30 @@ async function runChainFor(ids, text, target, cfg) {
     if (!p.enabled && p.source !== 'dsh') continue
     const adapter = ADAPTERS[p.type || id]
     if (!adapter) continue
-    try {
-      const chunks = chunkText(text)
+    try {
+      if (ollamaOrigin(id, p)) await localPreparation.ensure(p)
+      const chunks = chunkText(text)
       const outs = []
       for (const c of chunks) outs.push(await adapter(c, target, p))
       state.ok++
       state.lastProvider = id
       state.lastError = null
       // Carry the concrete model name so the UI can show e.g. "openai: qwen2.5:14b".
-      return { ok: true, text: outs.join('\n\n'), provider: id, ...(p.model ? { model: p.model } : {}) }
+      attempts.push({ provider: id, signature: providerFingerprint(p), ok: true, model: p.model || null })
+      return { ok: true, text: outs.join('\n\n'), provider: id, providerSignature: providerFingerprint(p), attempts, ...(p.model ? { model: p.model } : {}) }
     } catch (e) {
-      lastErr = e
+      lastErr = e
+      attempts.push({ provider: id, signature: providerFingerprint(p), ok: false, model: p.model || null })
       if (id === 'bing') bingCache = null
     }
   }
-  return { ok: false, error: lastErr instanceof Error ? lastErr.message : (lastErr || 'no enabled provider in chain') }
-}
+  return { ok: false, attempts, error: lastErr instanceof Error ? lastErr.message : (lastErr || 'no enabled provider in chain') }
+}
+
+function providerFingerprint(p) {
+  return fnv(JSON.stringify({ type: p.type, baseURL: p.baseURL, model: p.model, apiKeyEnv: p.apiKeyEnv,
+    apiKey: p.source === 'dsh' || p.apiKeyEnv ? undefined : p.apiKey }))
+}
 
 async function translateViaChain(text, target, cfg) {
   const primary = await runChainFor(cfg.chain || [], text, target, cfg)
@@ -1061,11 +1200,11 @@ async function translateViaChain(text, target, cfg) {
   let fb = null
   if (cfg.fallback && cfg.fallback.enabled && Array.isArray(cfg.fallback.chain)) {
     fb = await runChainFor(cfg.fallback.chain, text, target, cfg)
-    if (fb.ok) return fb
+    if (fb.ok) return { ...fb, attempts: [...primary.attempts, ...fb.attempts] }
   }
   state.fail++
   state.lastError = primary.error || (fb && fb.error) || 'translate unavailable'
-  return { ok: false, text: text, error: state.lastError }
+  return { ok: false, text: text, attempts: [...primary.attempts, ...(fb ? fb.attempts : [])], error: state.lastError }
 }
 
 async function handleTranslate(body) {
@@ -1086,12 +1225,13 @@ async function handleTranslate(body) {
       const p = cfg.providers && cfg.providers[forced]
       if (!p) return { ok: false, text, error: 'unknown provider: ' + forced }
       // DSH providers are activated by chain membership, not the enabled flag.
-      if (!p.enabled && p.source !== 'dsh') return { ok: false, text, error: 'provider disabled: ' + forced }
+      if (!p.enabled && p.source !== 'dsh' && !ollamaOrigin(forced, p)) return { ok: false, text, error: 'provider disabled: ' + forced }
       const adapter = ADAPTERS[p.type || forced]
       if (!adapter) return { ok: false, text, error: 'unsupported type: ' + p.type }
-      try {
-        const out = await adapter(text, target, p)
-        return { ok: true, text: out, provider: forced, ...(p.model ? { model: p.model } : {}) }
+      try {
+        if (ollamaOrigin(forced, p)) await localPreparation.ensure(p)
+        const out = await adapter(text, target, p)
+        return { ok: true, text: out, provider: forced, providerSignature: providerFingerprint(p), ...(p.model ? { model: p.model } : {}) }
       } catch (e) {
         return { ok: false, text, error: e instanceof Error ? e.message : String(e) }
       }
@@ -1361,8 +1501,9 @@ export function apply(ctx) {
             // reordering the chain or switching models keeps serving the old
             // provider's output (and its name in the status row) until restart.
             cache.clear()
-            inflight.clear()
-            sendJson(res, 200, stripResolvedKeys(merged))
+            inflight.clear()
+            if (localFirst(merged)) localPreparation.start(merged.providers.openai)
+            sendJson(res, 200, stripResolvedKeys(merged))
             return
           }
           sendJson(res, 405, { error: 'GET/POST only' })
@@ -1372,7 +1513,31 @@ export function apply(ctx) {
       },
     })
     return dispose
-  }, 'dsh-think-translate: config route')
+  }, 'dsh-think-translate: config route')
+
+  ctx.effect(function () {
+    return webServer.register({ kind: 'exact', path: '/_xlate/local/prepare', handler: async function (req, res) {
+      try {
+        if (req.method !== 'POST') { sendJson(res, 405, { ok: false, error: 'POST only' }); return }
+        const origin = req.headers.origin
+        if (origin && new URL(origin).host !== req.headers.host) { sendJson(res, 403, { ok: false, error: 'same-origin only' }); return }
+        const body = await readBody(req)
+        const cfg = await loadConfig()
+        sendJson(res, 202, { ok: true, job: localPreparation.start(cfg.providers.openai, {
+          allowInstall: body.allowInstall === true, allowDownload: body.allowDownload === true,
+        }) })
+      } catch (error) { sendJson(res, 400, { ok: false, error: error instanceof Error ? error.message : String(error) }) }
+    } })
+  }, 'dsh-think-translate: local preparation route')
+  ctx.effect(function () {
+    return webServer.register({ kind: 'exact', path: '/_xlate/local/status', handler: function (req, res) {
+      if (req.method !== 'GET') { sendJson(res, 405, { ok: false, error: 'GET only' }); return }
+      const id = new URL(req.url, 'http://localhost').searchParams.get('id')
+      sendJson(res, 200, { ok: true, job: localPreparation.snapshot(id) })
+    } })
+  }, 'dsh-think-translate: local preparation status')
+  // Restoring a profile with Ollama already first must prepare it too.
+  loadConfig().then(cfg => { if (localFirst(cfg)) localPreparation.start(cfg.providers.openai) }).catch(() => {})
 
   ctx.effect(function () {
     const dispose = webServer.register({
@@ -1474,5 +1639,6 @@ export {
   needsTranslate, hasProse, chunkText, fnv, deepMerge,
   structuredCloneSafe, ADAPTERS,
   resolveApiKey, stripResolvedKeys, missingApiKey, clearNullFields, handleVersion,
-  harnessHomeCandidates, pickHarnessHome,
-}
+  harnessHomeCandidates, pickHarnessHome,
+  streamModelPull,
+}

package/lib/ollama.js

@@ -0,0 +1,132 @@
+// Local Ollama preparation: asynchronous, observable, and reusable by config
+// changes and explicit provider tests. Dependencies are injected for offline tests.
+export function ollamaOrigin(id, provider) {
+  if (id !== 'openai' || !provider || provider.type !== 'openai') return null
+  try {
+    const url = new URL(provider.baseURL)
+    if (url.protocol !== 'http:' || !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname) ||
+        url.port !== '11434' || !/^\/v1\/?$/.test(url.pathname) || url.username || url.password || url.search || url.hash) return null
+    return url.origin
+  } catch { return null }
+}
+
+export function localFirst(cfg) {
+  const id = (cfg.chain || []).find(id => {
+    const p = cfg.providers && cfg.providers[id]
+    return p && (p.enabled || p.source === 'dsh')
+  })
+  const provider = cfg.providers && cfg.providers[id]
+  return ollamaOrigin(id, provider) !== null && typeof provider.model === 'string' && !!provider.model.trim()
+}
+
+export function validOllamaSignature(report) {
+  return report && report.status === 'Valid' && typeof report.subject === 'string' &&
+    /(^|, )O=Ollama Inc\.(,|$)/.test(report.subject)
+}
+
+function modelKey(model) { return model.includes(':') ? model : model + ':latest' }
+
+export function createLocalPreparation(runtime) {
+  const jobs = new Map()
+  const servers = new Map()
+  let sequence = 0
+  let latest = null
+  const snapshot = id => {
+    const job = id ? jobs.get(id) : latest
+    if (!job) return null
+    const { promise, options, ...out } = job
+    return { ...out, platform: runtime.platform, canInstall: runtime.platform === 'win32' }
+  }
+  async function online(origin) {
+    try { const version = await runtime.json(origin + '/api/version', {}, 2000); return typeof version.version === 'string' }
+    catch { return false }
+  }
+  async function server(job, options, progress) {
+    if (await online(job.origin)) return
+    if (servers.has(job.origin)) return servers.get(job.origin)
+    const pending = (async () => {
+      let executable = await runtime.findExecutable()
+      if (!executable) {
+        if (!options.allowInstall || runtime.platform !== 'win32') {
+          progress({ phase: 'needs_install', running: false })
+          return false
+        }
+        await runtime.install(progress)
+        executable = await runtime.findExecutable()
+        if (!executable) throw new Error('Ollama installation finished but the executable was not found')
+      }
+      progress({ phase: 'starting', percent: null })
+      await runtime.startServer(executable, job.origin)
+      for (let n = 0; n < 30; n++) {
+        if (await online(job.origin)) return true
+        await runtime.wait(500)
+      }
+      throw new Error('Ollama did not become reachable after startup')
+    })()
+    servers.set(job.origin, pending)
+    try { return await pending } finally { servers.delete(job.origin) }
+  }
+  async function run(job, options) {
+    const progress = patch => Object.assign(job, patch, { updatedAt: Date.now() })
+    try {
+      if (await server(job, options, progress) === false) {
+        progress({ phase: 'needs_install', running: false })
+        return
+      }
+      const tags = await runtime.json(job.origin + '/api/tags', {}, 10000)
+      const installed = (tags.models || []).some(m => typeof m.name === 'string' && modelKey(m.name) === modelKey(job.model))
+      if (!installed) {
+        if (!options.allowDownload) { progress({ phase: 'needs_model', running: false }); return }
+        progress({ phase: 'downloading_model', completed: 0, total: 0, percent: null })
+        await runtime.pull(job.origin, job.model, progress)
+      }
+      const loaded = await runtime.json(job.origin + '/api/ps', {}, 10000)
+      if (!(loaded.models || []).some(m => modelKey(m.name || m.model || '') === modelKey(job.model))) {
+        progress({ phase: 'loading_model', percent: null, completed: 0, total: 0 })
+        await runtime.json(job.origin + '/api/generate', {
+          method: 'POST', headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ model: job.model, prompt: '', stream: false, keep_alive: '10m' }),
+        }, 120000)
+        const verify = await runtime.json(job.origin + '/api/ps', {}, 10000)
+        if (!(verify.models || []).some(m => modelKey(m.name || m.model || '') === modelKey(job.model))) {
+          throw new Error('Ollama did not report the selected model as loaded')
+        }
+      }
+      progress({ phase: 'ready', running: false, percent: 100, error: null })
+    } catch (error) {
+      progress({ phase: 'error', running: false, error: error instanceof Error ? error.message : String(error) })
+    }
+  }
+  function start(provider, options = {}) {
+    const origin = ollamaOrigin('openai', provider)
+    const model = typeof provider?.model === 'string' ? provider.model.trim() : ''
+    if (!origin || !model) throw new Error('A local Ollama endpoint and model are required')
+    // No automatic installation or model download: the setup button grants both.
+    const allowed = { allowInstall: options.allowInstall === true, allowDownload: options.allowDownload === true }
+    const busy = [...jobs.values()].find(j => j.running && j.origin === origin && j.model === model)
+    if (busy) {
+      busy.options.allowInstall ||= allowed.allowInstall
+      busy.options.allowDownload ||= allowed.allowDownload
+      return snapshot(busy.id)
+    }
+    const job = { id: String(++sequence), origin, model, phase: 'checking', running: true,
+      percent: null, completed: 0, total: 0, error: null, updatedAt: Date.now() }
+    job.options = allowed
+    latest = job
+    jobs.set(job.id, job)
+    job.promise = Promise.resolve().then(() => run(job, allowed))
+    if (jobs.size > 30) for (const [id, old] of jobs) {
+      if (!old.running && old !== latest) { jobs.delete(id); break }
+    }
+    return snapshot(job.id)
+  }
+  async function ensure(provider) {
+    const result = start(provider)
+    const job = jobs.get(result.id)
+    await job.promise
+    if (job.phase !== 'ready') throw new Error(job.error || (job.phase === 'needs_install'
+      ? 'Ollama is not installed; use the local setup button' : 'Selected model is not downloaded; use the local setup button'))
+    return snapshot(job.id)
+  }
+  return { start, snapshot, ensure }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-think-translate",
   "description": "Display-layer translation for the DSH web app: thinking chain, task cards, and optional answer text, in 8 target languages (local Ollama / any OpenAI-compatible or Anthropic endpoint / Google / Bing, fail-open)",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -11,7 +11,8 @@
   },
   "files": [
     "lib/index.js",
-    "lib/client.js",
+    "lib/client.js",
+    "lib/ollama.js",
     "cordis.patch.yml",
     "demo/demo.gif",
     "demo/demo2.gif"