@jayyuen66/dsh-ocr-review 0.1.4 → 0.1.5-rc

package/client.js

@@ -36,6 +36,7 @@ const UI_MESSAGES = {
 		noProvider: "当前未配置 provider",
 		noReason: "宿主未给出原因（重启 dsh 或重试可恢复）",
 		readProvidersFailed: "未能从 dsh 配置服务读取 provider 列表：{reason}",
+		endpointVerifyFailed: "装载期端点自检失败（配置仍可修改）：{reason}",
 		applied: "已应用：{provider} / {model}\n{test}",
 		notVerified: "（未自动验证，可点「测试连接」手动验证）",
 		llmTestPassed: "✓ ocr llm test 通过",
@@ -66,7 +67,23 @@ const UI_MESSAGES = {
 		configPathHint: "外部 open-code-review CLI 自己的配置位置；留空 = ~/.opencodereview/config.json。自定义时必须是 <X>/.opencodereview/config.json 布局（OCR 只认该形状，插件经 HOME 重定向让它生效）",
 		settingsLoading: "设置加载中，稍候可改",
 		keyDynamicHint: "key 走 get-cred.mjs 动态读取，OCR 配置不留明文",
-		keyScriptMissing: "⚠ get-cred 脚本缺失，api_key_cmd 无法工作"
+		keyScriptMissing: "⚠ get-cred 脚本缺失，api_key_cmd 无法工作",
+		binaryTitle: "外部 CLI（ocr）",
+		binaryUnknown: "状态未取到：刷新本页，或确认 dsh 的 web 服务已起来",
+		binaryBundled: "随本插件分发已就位，无需再全局安装",
+		binaryPath: "用 PATH 上的全局安装：{path}",
+		binaryNone: "未找到 ocr：`brew install open-code-review` 或 `npm i -g @alibaba-group/open-code-review`",
+		detectCli: "检测版本",
+		detecting: "检测中…",
+		probeVersion: "ocr 版本：{version}",
+		probeReason: "未取到版本号：{reason}",
+		badgeBundled: "ocr 随包就位",
+		badgePath: "ocr 来自 PATH",
+		badgeNone: "未找到 ocr",
+		badgeUnknown: "ocr 状态未取到",
+		binaryProbeHint: "版本号要在「配置」页点「检测版本」取——那要起一次 ocr 进程，不在本页顺手跑。",
+		binaryGuideDetails: "打开插件详情",
+		binaryGuideDismiss: "知道了"
 	},
 	en: {
 		cardTitle: "open-code-review code review",
@@ -95,6 +112,7 @@ const UI_MESSAGES = {
 		noProvider: "No provider configured yet",
 		noReason: "the host gave no reason (restart dsh or retry to recover)",
 		readProvidersFailed: "Could not read the provider list from the dsh settings service: {reason}",
+		endpointVerifyFailed: "Startup endpoint check failed (the config is still editable): {reason}",
 		applied: "Applied: {provider} / {model}\n{test}",
 		notVerified: "(not verified automatically — use “Test connection” to check manually)",
 		llmTestPassed: "✓ ocr llm test passed",
@@ -125,11 +143,27 @@ const UI_MESSAGES = {
 		configPathHint: "Where the external open-code-review CLI keeps its own config; empty = ~/.opencodereview/config.json. A custom value must follow the <X>/.opencodereview/config.json layout (OCR only reads that shape; the plugin makes it effective via a HOME redirect)",
 		settingsLoading: "settings still loading — editable in a moment",
 		keyDynamicHint: "Keys are read dynamically via get-cred.mjs; OCR config keeps no plain text",
-		keyScriptMissing: "⚠ get-cred script missing, api_key_cmd cannot work"
+		keyScriptMissing: "⚠ get-cred script missing, api_key_cmd cannot work",
+		binaryTitle: "External CLI (ocr)",
+		binaryUnknown: "status not reported: reload this page, or check that the dsh web server is up",
+		binaryBundled: "bundled with this plugin, no global install needed",
+		binaryPath: "using the global install on PATH: {path}",
+		binaryNone: "ocr not found: `brew install open-code-review` or `npm i -g @alibaba-group/open-code-review`",
+		detectCli: "Detect version",
+		detecting: "Detecting...",
+		probeVersion: "ocr version: {version}",
+		probeReason: "no version read: {reason}",
+		badgeBundled: "ocr bundled",
+		badgePath: "ocr from PATH",
+		badgeNone: "ocr not found",
+		badgeUnknown: "ocr status unavailable",
+		binaryProbeHint: "the version comes from the Detect action on the configuration page — that spawns an ocr process, so it is not run here",
+		binaryGuideDetails: "Open plugin details",
+		binaryGuideDismiss: "Got it"
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/@jayyuen66+dsh-plugin-shared@0.1.4_@deepseek-ai+cordis@4.0.5-alpha.1_@deepseek-ai+dsh-c_472a88c28a1052d4f20b6206ef930fa9/node_modules/@jayyuen66/dsh-plugin-shared/dist/record.js
+//#region node_modules/.pnpm/@jayyuen66+dsh-plugin-shared@0.1.5-rc_@deepseek-ai+cordis@4.0.5-alpha.1_@deepseek-ai+ds_e716d822a8a24fbc7ac6d086dd04b807/node_modules/@jayyuen66/dsh-plugin-shared/dist/record.js
 function e(e) {
 	return typeof e == `object` && !!e && !Array.isArray(e);
 }
@@ -161,6 +195,7 @@ const PROVIDERS_URL = "/_dsh/ocr-review/providers";
 const SELECT_URL = "/_dsh/ocr-review/select";
 const MIGRATE_URL = "/_dsh/ocr-review/migrate";
 const TEST_URL = "/_dsh/ocr-review/test";
+const PROBE_URL = "/_dsh/ocr-review/probe";
 /** 写端点 CSRF 头名（与 host.ts OCR_CSRF_HEADER 同源，改名要两端一起改）。 */
 const CSRF_HEADER = "x-ocr-csrf";
 /** 未知值 → 安全字符串（非字符串给 ''）。 */
@@ -194,6 +229,36 @@ function providerOf(raw) {
 		hasKey: t(raw, "hasKey") === true
 	};
 }
+/** 可得性来源的合法域（与 host 侧 `OcrBinarySource` 同一份取值）。形状不合即「没报」。 */
+const BINARY_SOURCES = /* @__PURE__ */ new Set([
+	"bundled",
+	"path",
+	"none"
+]);
+/** 解析宿主送的可得性对象。导出是为了让「wire 键名」这条契约能被钉住：卡片与 host
+*  两处各写一份键名时，写错了的症状是状态行永远显示「未取到」，而不是任何报错。 */
+function binaryOf(raw) {
+	if (!e(raw)) return null;
+	const source = strOf(raw["source"]);
+	if (!BINARY_SOURCES.has(source)) return null;
+	const path = strOf(raw["path"]);
+	return path === "" ? { source } : {
+		source,
+		path
+	};
+}
+/**
+* 详情页徽标/区块/启用指引共用的取数口：读同一条 GET providers 的 `ocrBinary` 那半。
+* 判据只在 host 的 `resolveOcrAvailability` 一处，本包三个显示面都只翻译它的结论。
+*/
+async function loadCliStatus() {
+	try {
+		const res = await fetch(PROVIDERS_URL, { headers: { accept: "application/json" } });
+		return res.ok ? binaryOf(t(await res.json(), "ocrBinary")) : null;
+	} catch {
+		return null;
+	}
+}
 function providersPayloadOf(json) {
 	const providersArr = t(json, "providers");
 	const providers = Array.isArray(providersArr) ? providersArr.map((item) => providerOf(item)) : [];
@@ -205,6 +270,11 @@ function providersPayloadOf(json) {
 		url: strOf(t(currentRaw, "url"))
 	};
 	const sourceRaw = t(json, "source");
+	const verifyRaw = t(json, "endpointVerify");
+	const endpointVerify = verifyRaw === null || verifyRaw === void 0 ? null : {
+		ok: t(verifyRaw, "ok") === true,
+		message: strOf(t(verifyRaw, "message"))
+	};
 	return {
 		providers,
 		current,
@@ -213,13 +283,17 @@ function providersPayloadOf(json) {
 			status: strOf(t(sourceRaw, "status")),
 			message: strOf(t(sourceRaw, "message"))
 		},
-		csrf: strOf(t(json, "csrf"))
+		csrf: strOf(t(json, "csrf")),
+		endpointVerify,
+		ocrBinary: binaryOf(t(json, "ocrBinary"))
 	};
 }
 /** 三行表单控件（数字/文本/下拉）共用的类名 = CARD_CSS 里 `.ocr-select{…}` 那条规则。
 *  抽出来是因为两处 input 与一处 select 必须同宽同边框：写三遍字面量时改一处漏两处，
 *  症状是设置卡里某一行的控件比其它行窄。 */
 const FORM_CONTROL_CLASS = "ocr-select";
+/** 小节标题的类名（卡片头、CLI 状态行、详情页区块共用；sonarjs 的重复字面量门禁）。 */
+const CARD_NAME_CLASS = "ocr-card-name";
 const CARD_CSS = [
 	".ocr-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}",
 	".ocr-card:hover{border-color:var(--dsw-alias-label-dimmed)}",
@@ -338,7 +412,7 @@ function OcrPluginCard(props) {
 	const { title, description, children } = props;
 	const [open, setOpen] = (0, react.useState)(false);
 	const pathKey = "d";
-	const headRow = (0, react.createElement)("span", { className: "ocr-card-head" }, (0, react.createElement)("span", { className: "ocr-card-name" }, title), (0, react.createElement)("span", { className: "ocr-card-desc" }, description));
+	const headRow = (0, react.createElement)("span", { className: "ocr-card-head" }, (0, react.createElement)("span", { className: CARD_NAME_CLASS }, title), (0, react.createElement)("span", { className: "ocr-card-desc" }, description));
 	const chevron = (0, react.createElement)("svg", {
 		width: 14,
 		height: 14,
@@ -469,6 +543,172 @@ function currentConfigText(t, current) {
 		keyPart: t(current.keyIsDynamic ? "dynamicKey" : "plainKeyWarning")
 	});
 }
+/**
+* 外部 CLI 可得性那一行的文本。三档来源与「宿主没报」四种说法，判据全在 host 侧
+* （`lib/cli.ts` 的 resolveOcrAvailability），卡片只翻译结论——两处各算各的就会漂。
+*/
+function binaryStatusText(t, binary) {
+	if (binary === null) return t("binaryUnknown");
+	if (binary.source === "bundled") return t("binaryBundled");
+	if (binary.source === "path") return t("binaryPath", { path: binary.path ?? "" });
+	return t("binaryNone");
+}
+/** 一条错误提示行的类名（多处在用；sonarjs 的重复字面量门禁要求收成常量）。 */
+const STATUS_ERROR_CLASS = "ocr-status ocr-err";
+/** 一条成功/失败回执行的类名（动作条、探测回执共用）。 */
+function statusClass(ok) {
+	return `ocr-status ${ok ? "ocr-ok" : "ocr-err"}`;
+}
+/**
+* 外部 CLI 状态行：可得性 + 「检测」按钮 + 最近一次探测回执。
+*
+* 刻意画在 provider 表单**之外**（provider 源不可用时也要看得见）——「这台机器有没有
+* ocr」与「宿主能不能列出 provider」是两件事，混在一支里会让缺 CLI 的机器连原因都看不到。
+* 回执用 `.ocr-status`（`white-space:pre-wrap`）而不是输入框：那段文本里就有上游给的
+* `npm i -g …` 命令，要能选中复制，而本包不提供剪贴板 API（非安全上下文会静默失败）。
+*/
+function buildCliStatusRow(deps) {
+	const { t } = deps;
+	const label = (0, react.createElement)("div", { className: CARD_NAME_CLASS }, t("binaryTitle"));
+	const button = (0, react.createElement)("button", {
+		className: "ocr-btn",
+		type: "button",
+		disabled: deps.busy !== null,
+		onClick: deps.onProbe,
+		"data-field": "probe"
+	}, deps.busy === "probe" ? t("detecting") : t("detectCli"));
+	const row = (0, react.createElement)("div", {
+		className: "ocr-row",
+		style: {
+			justifyContent: "flex-start",
+			gap: 8
+		}
+	}, label, button);
+	const statusText = binaryStatusText(t, deps.binary);
+	const status = (0, react.createElement)("div", { className: "ocr-hint" }, statusText);
+	const probe = deps.probeMsg ? (0, react.createElement)("div", {
+		className: statusClass(deps.probeMsg.ok),
+		"data-field": "probe-result"
+	}, deps.probeMsg.text) : null;
+	return (0, react.createElement)("div", {
+		style: { padding: "2px 0" },
+		"data-field": "cli-status"
+	}, row, status, probe);
+}
+/**
+* 徽标用的短文案（标题旁那只标签放不下整句装法）。与 `binaryStatusText` 同一判据、
+* 不同长度：两处各算一份「哪一档」就会漂，所以入参仍是 host 送的那份 `OcrBinaryView`。
+*/
+function cliBadgeText(t, binary) {
+	if (binary === null) return t("badgeUnknown");
+	if (binary.source === "bundled") return t("badgeBundled");
+	if (binary.source === "path") return t("badgePath");
+	return t("badgeNone");
+}
+/** 这页说的是不是本包（bundle 页与它的行页都算；官方插件页 `item` 没有包名可比）。
+*  导出是因为「在别人插件的页上白拉一次自己的端点」这条判据只能在这里钉。 */
+function isOwnSubject(subject) {
+	return subject.kind !== "item" && subject.pkg.name === BUNDLE_PKG;
+}
+/** 徽标那枚元素（状态已到才画；取状态与 subject 过滤留给组件，用例才不必起渲染器）。 */
+function buildCliBadge(t, status) {
+	return (0, react.createElement)("span", {
+		className: "ocr-hint",
+		"data-field": "cli-badge"
+	}, cliBadgeText(t, status));
+}
+/**
+* 订阅一次外部 CLI 可得性（GET providers 的 `ocrBinary` 那半，纯 fs 判据、不起进程）。
+*
+* `active` 为假（这页说的不是本包）时既不发请求也不画东西：官方契约是「对无话可说的
+* subject 渲染 null」，在别人插件的页面上拉一次自己的端点属于白干的活。
+* @returns undefined = 还没回来（渲染 null，不闪「状态未知」）；null = 宿主没报。
+*/
+function useCliStatus(active, load) {
+	const [status, setStatus] = (0, react.useState)(void 0);
+	(0, react.useEffect)(() => {
+		let alive = true;
+		const settle = (value) => {
+			if (alive) setStatus(value);
+		};
+		const run = async () => {
+			try {
+				settle(await load());
+			} catch {
+				settle(null);
+			}
+		};
+		if (active) run();
+		return () => {
+			alive = false;
+		};
+	}, [active, load]);
+	return status;
+}
+/** 详情页标题旁的徽标：一句话说明外部 ocr 从哪条路来（或压根没有）。 */
+function OcrCliBadge(props) {
+	const mine = isOwnSubject(props.subject);
+	const status = useCliStatus(mine, props.loadCliStatus);
+	if (!mine || status === void 0) return null;
+	return buildCliBadge(props.t, status);
+}
+/** 区块体：标题 + 完整状态那一行 + 指路那一句。 */
+function buildCliSection(t, status) {
+	const title = (0, react.createElement)("div", { className: CARD_NAME_CLASS }, t("binaryTitle"));
+	const body = (0, react.createElement)("div", { className: "ocr-hint" }, binaryStatusText(t, status));
+	const hint = (0, react.createElement)("div", { className: "ocr-hint" }, t("binaryProbeHint"));
+	return (0, react.createElement)("div", {
+		style: { padding: "8px 0" },
+		"data-field": "cli-section"
+	}, title, body, hint);
+}
+/** 详情页下方的区块：完整状态 + 「版本号要在配置卡片里点检测」的指路。 */
+function OcrCliSection(props) {
+	const mine = isOwnSubject(props.subject);
+	const status = useCliStatus(mine, props.loadCliStatus);
+	if (!mine || status === void 0) return null;
+	return buildCliSection(props.t, status);
+}
+/**
+* 启用指引的内容：一句「两条路都没找到」+ 去详情页 / 收起这两个动作。
+* 动作回调由宿主给（`onOpenDetails` 顺带把用户送到本包配置页，那里才有「检测」按钮）。
+*/
+function buildCliActivation(t, props) {
+	const text = (0, react.createElement)("div", { className: STATUS_ERROR_CLASS }, t("binaryNone"));
+	const details = (0, react.createElement)("button", {
+		className: "ocr-btn",
+		type: "button",
+		onClick: props.onOpenDetails,
+		"data-field": "guide-details"
+	}, t("binaryGuideDetails"));
+	const dismiss = (0, react.createElement)("button", {
+		className: "ocr-btn",
+		type: "button",
+		onClick: props.onDismiss,
+		"data-field": "guide-dismiss"
+	}, t("binaryGuideDismiss"));
+	return (0, react.createElement)("div", {
+		style: {
+			padding: "8px 0",
+			display: "flex",
+			gap: 8
+		},
+		"data-field": "cli-activation"
+	}, text, details, dismiss);
+}
+/**
+* 启用后的一次性指引：只在「两条路都没找到 ocr」那一刻说话。
+*
+* 这是官方给第三方 bundle 的最外侧位置（`plugins.bundle.activation`，用户从列表启用本包
+* 后由页面渲染）。列表卡片上那排标签全部来自宿主对条目自身的判定，插件注入不进去，所以
+* 「装没装外部 CLI」能被显示的最外一处就是这里，外加详情页那只徽标。
+*/
+function OcrCliActivation(props) {
+	const mine = props.packageName === BUNDLE_PKG;
+	const status = useCliStatus(mine, props.loadCliStatus);
+	if (!mine || status?.source !== "none") return null;
+	return buildCliActivation(props.t, props);
+}
 /** 数据齐（source.status === "ready"）那一支：provider/model 两行 + 三个动作按钮 +
 *  当前配置与 key 两行提示。拆出来是因为这一支画的是整块表单，与上面三条「一行提示」
 *  的降级支本就不是同一件事。 */
@@ -512,21 +752,21 @@ function buildReadyProviderSection(deps, data) {
 	const applyBtn = (0, react.createElement)("button", {
 		className: "ocr-btn ocr-btn-primary",
 		type: "button",
-		disabled: deps.busy,
+		disabled: deps.busy !== null,
 		onClick: deps.onApply,
 		"data-field": "apply"
-	}, deps.busy ? t("applying") : t("applyToOcr"));
+	}, deps.busy === "apply" ? t("applying") : t("applyToOcr"));
 	const testBtn = (0, react.createElement)("button", {
 		className: "ocr-btn",
 		type: "button",
-		disabled: deps.busy,
+		disabled: deps.busy !== null,
 		onClick: deps.onTest,
 		"data-field": "test"
 	}, t("testConnection"));
 	const migrateBtn = (0, react.createElement)("button", {
 		className: "ocr-btn",
 		type: "button",
-		disabled: deps.busy,
+		disabled: deps.busy !== null,
 		onClick: deps.onMigrate,
 		"data-field": "migrate"
 	}, t("migrateKeys"));
@@ -541,7 +781,12 @@ function buildReadyProviderSection(deps, data) {
 	const currentHint = cur.provider === "" ? t("noProvider") : currentConfigText(t, cur);
 	const currentInfo = (0, react.createElement)("div", { className: "ocr-hint" }, currentHint);
 	const keyInfo = (0, react.createElement)("div", { className: "ocr-hint" }, deps.keyHint);
-	return (0, react.createElement)("div", {}, providerRow, modelRow, actionRow, currentInfo, keyInfo);
+	const verify = data.endpointVerify ?? null;
+	const verifyWarning = verify !== null && !verify.ok ? (0, react.createElement)("div", {
+		className: STATUS_ERROR_CLASS,
+		"data-field": "endpoint-verify"
+	}, t("endpointVerifyFailed", { reason: verify.message })) : null;
+	return (0, react.createElement)("div", {}, verifyWarning, providerRow, modelRow, actionRow, currentInfo, keyInfo);
 }
 /** Provider / Model 选择与应用区：三条降级各出一行提示（数据未就绪/读取失败/
 *  数据源不可用），只有 source.status === "ready" 才交给 buildReadyProviderSection 画表单。 */
@@ -549,13 +794,13 @@ function buildProviderSection(deps) {
 	const { t } = deps;
 	if (deps.fetchError !== null) {
 		const reason = t("loadProvidersFailed", { error: deps.fetchError });
-		return (0, react.createElement)("div", { className: "ocr-status ocr-err" }, reason);
+		return (0, react.createElement)("div", { className: STATUS_ERROR_CLASS }, reason);
 	}
 	if (deps.data === null) return (0, react.createElement)("div", { className: "ocr-status ocr-muted" }, t("loadingProviders"));
 	if (deps.data.source.status !== "ready") {
 		const sourceMessage = deps.data.source.message;
 		const line = t("readProvidersFailed", { reason: sourceMessage === "" ? t("noReason") : sourceMessage });
-		return (0, react.createElement)("div", { className: "ocr-status ocr-err" }, line);
+		return (0, react.createElement)("div", { className: STATUS_ERROR_CLASS }, line);
 	}
 	return buildReadyProviderSection(deps, deps.data);
 }
@@ -738,7 +983,7 @@ async function runApplySelection(deps) {
 		});
 		return;
 	}
-	deps.setBusy(true);
+	deps.setBusy("apply");
 	deps.setActionMsg(null);
 	try {
 		const selJson = await (await deps.post(SELECT_URL, JSON.stringify({
@@ -776,13 +1021,13 @@ async function runApplySelection(deps) {
 			text: failedText
 		});
 	} finally {
-		deps.setBusy(false);
+		deps.setBusy(null);
 	}
 }
 /** POST migrate：明文 api_key 一键迁到 api_key_cmd，回执把迁移/跳过两个名单拼成一行。 */
 async function runMigrateKeys(deps) {
 	const { t: t$2 } = deps;
-	deps.setBusy(true);
+	deps.setBusy("migrate");
 	deps.setActionMsg(null);
 	try {
 		const json = await (await deps.post(MIGRATE_URL)).json();
@@ -804,13 +1049,13 @@ async function runMigrateKeys(deps) {
 			text: failedText
 		});
 	} finally {
-		deps.setBusy(false);
+		deps.setBusy(null);
 	}
 }
 /** POST test：手动触发 ocr llm test，输出原样回显在动作条上。 */
 async function runTestConnection(deps) {
 	const { t: t$3 } = deps;
-	deps.setBusy(true);
+	deps.setBusy("test");
 	deps.setActionMsg(null);
 	try {
 		const json = await (await deps.post(TEST_URL)).json();
@@ -827,7 +1072,36 @@ async function runTestConnection(deps) {
 			text: failedText
 		});
 	} finally {
-		deps.setBusy(false);
+		deps.setBusy(null);
+	}
+}
+/**
+* POST probe：跑一次 `ocr version`。
+*
+* 回执里的 `output` 原样附上，不从中抽「有新版本」那句——那是上游的措辞，抽一次就多
+* 一处会跟着漂的判据；那段文本本来就带在页面上供人选中复制（含上游给的 `npm i -g …`）。
+*/
+async function runProbe(deps) {
+	const { t: t$4 } = deps;
+	deps.setBusy("probe");
+	deps.setProbeMsg(null);
+	try {
+		const json = await (await deps.post(PROBE_URL)).json();
+		const ok = t(json, "ok") === true;
+		const head = ok ? t$4("probeVersion", { version: strOf(t(json, "version")) }) : t$4("probeReason", { reason: strOf(t(json, "reason")) });
+		const output = strOf(t(json, "output"));
+		deps.setProbeMsg({
+			ok,
+			text: output === "" ? head : `${head}\n${output}`
+		});
+		deps.refresh();
+	} catch (error) {
+		deps.setProbeMsg({
+			ok: false,
+			text: `${t$4("requestFailed")}${errorSummary(error)}`
+		});
+	} finally {
+		deps.setBusy(null);
 	}
 }
 /** 只写差异字段：touched 值为 undefined → 写 null（= 清回 schema 默认）。
@@ -885,7 +1159,7 @@ function cardHints(t, ready, status, data) {
 function buildProviderPanel(deps) {
 	const { actionMsg } = deps;
 	const providerSection = buildProviderSection(deps);
-	const actionMsgNode = actionMsg ? (0, react.createElement)("div", { className: `ocr-status ${actionMsg.ok ? "ocr-ok" : "ocr-err"}` }, actionMsg.text) : null;
+	const actionMsgNode = actionMsg ? (0, react.createElement)("div", { className: statusClass(actionMsg.ok) }, actionMsg.text) : null;
 	return (0, react.createElement)("div", { style: { padding: "2px 0" } }, providerSection, actionMsgNode);
 }
 function OcrCard(props) {
@@ -896,8 +1170,9 @@ function OcrCard(props) {
 	const writable = snap.writable && ready;
 	const [data, setData] = (0, react.useState)(null);
 	const [fetchError, setFetchError] = (0, react.useState)(null);
-	const [busy, setBusy] = (0, react.useState)(false);
+	const [busy, setBusy] = (0, react.useState)(null);
 	const [actionMsg, setActionMsg] = (0, react.useState)(null);
+	const [probeMsg, setProbeMsg] = (0, react.useState)(null);
 	const refresh = async () => refreshProviders({
 		setData,
 		setFetchError
@@ -954,6 +1229,8 @@ function OcrCard(props) {
 		chosenProvider,
 		modelOptions,
 		...cardHints(t, ready, snap.status, data),
+		binary: data?.ocrBinary ?? null,
+		probeMsg,
 		...draftFieldsOf(touched, value),
 		dirty,
 		settingsBusy,
@@ -969,6 +1246,15 @@ function OcrCard(props) {
 		onMigrate: () => {
 			runMigrateKeys(actions);
 		},
+		onProbe: () => {
+			runProbe({
+				t,
+				post,
+				refresh,
+				setBusy,
+				setProbeMsg
+			});
+		},
 		onField: setField,
 		onSave: () => {
 			saveSettingsDraft({
@@ -984,13 +1270,14 @@ function OcrCard(props) {
 		onDiscard: discard
 	};
 	const providerPanel = buildProviderPanel(deps);
+	const cliStatus = buildCliStatusRow(deps);
 	const settingsSection = buildSettingsSection(deps, writable, setField);
 	const headTitle = t("cardTitle");
 	const headDesc = t("cardDescription");
 	return (0, react.createElement)(OcrPluginCard, {
 		title: headTitle,
 		description: headDesc
-	}, providerPanel, settingsSection);
+	}, cliStatus, providerPanel, settingsSection);
 }
 const inject = [
 	"slots",
@@ -1027,18 +1314,54 @@ function apply(ctx) {
 			})
 		}, OcrCard);
 	});
+	const cliShare = {
+		t,
+		loadCliStatus
+	};
+	ctx.slots.inject("plugins.detail.badge", () => ctx.slots.register({
+		name: "plugins.detail.badge",
+		id: `${NS}-cli-badge`,
+		order: 100,
+		label: "ocr-review CLI badge",
+		inject: () => cliShare
+	}, OcrCliBadge));
+	ctx.slots.inject("plugins.detail.section", () => ctx.slots.register({
+		name: "plugins.detail.section",
+		id: `${NS}-cli-section`,
+		order: 100,
+		label: "ocr-review CLI section",
+		inject: () => cliShare
+	}, OcrCliSection));
+	ctx.slots.inject("plugins.bundle.activation", () => ctx.slots.register({
+		name: "plugins.bundle.activation",
+		key: BUNDLE_PKG,
+		inject: () => cliShare
+	}, OcrCliActivation));
 }
 //#endregion
 exports.OcrCard = OcrCard;
+exports.OcrCliActivation = OcrCliActivation;
+exports.OcrCliBadge = OcrCliBadge;
+exports.OcrCliSection = OcrCliSection;
 exports.SaveBar = SaveBar;
 exports.apply = apply;
+exports.binaryOf = binaryOf;
+exports.binaryStatusText = binaryStatusText;
+exports.buildCliActivation = buildCliActivation;
+exports.buildCliBadge = buildCliBadge;
+exports.buildCliSection = buildCliSection;
+exports.buildCliStatusRow = buildCliStatusRow;
 exports.buildProviderSection = buildProviderSection;
 exports.buildSettingsSection = buildSettingsSection;
 exports.cardStore = cardStore;
+exports.cliBadgeText = cliBadgeText;
 exports.currentConfigText = currentConfigText;
 exports.diffTouched = diffTouched;
 exports.inject = inject;
+exports.isOwnSubject = isOwnSubject;
+exports.loadCliStatus = loadCliStatus;
 exports.providerOptionLabel = providerOptionLabel;
+exports.runProbe = runProbe;
     return module.exports;
   },
 });

package/cordis.patch.yml

@@ -1,10 +1,11 @@
 # ocr-review：open-code-review 工作区审查插件（bundle）。
 # 双面包机制：本包含 Host 半（host.ts：5 个工具 ocr_review/ocr_scan/
-# ocr_delegate_preview/ocr_delegate_rule/ocr_session + settings namespace「ocr-review」+
-# webServer 配置端点）与 Client 半（src/client-entry.ts → client.js：设置卡片，
-# 从 settings.yaml 的 llm-pi-ai.providers 选 provider/model 应用到
-# ~/.opencodereview/config.json，key 走 api_key_cmd 动态读取 .credentials.yaml
-# 的 refs，OCR 配置永不落明文 key）。
+# ocr_delegate_preview/ocr_delegate_rule/ocr_session + 由 `Config` 上 `.volatile()`
+# 隐式投影的设置面（命名空间就是下面这条的 id）+ webServer 配置端点）与
+# Client 半（src/client-entry.ts → client.js：设置卡片，从宿主设置服务的
+# llm-pi-ai.providers 选 provider/model 应用到
+# ~/.opencodereview/config.json，key 走 api_key_cmd 动态读取宿主凭据 ref，
+# OCR 配置永不落明文 key）。
 #
 # 组合包层：本文件由 package.json 的 dsh.bundle.patch 指向，随
 # `dsh plugin --profile web add/remove ./plugins/ocr-review` 维护。行按裸包名