@ntdgy/dsh-remote-bridge-plugin 0.0.0-stage → 0.1.0

package/cordis.patch.yml

@@ -0,0 +1,28 @@
+# dsh-remote-bridge 的 bundle 补丁层。
+#
+# ⚠️ 本文件默认是**空数组**，有意为之，请勿往这里加 config。
+#
+# 语义（cordis-plugin-include: applyEntryPatches）：
+#   - 带 "insert" 的 patch 是**新增**条目；
+#   - 不带 "insert" 的 patch 只能**修改**已存在的同 id 条目。
+#
+# 为什么留空：patch 层是**按数组顺序追加**的，先到先得，同 id 里第一个
+# fiber 胜出，后来者抛「service "remoteBridge" has been registered」被静默丢弃。
+# 本包同时又是 profile 里的一个条目时，它一定会出现在 patch 层内部，位置由
+# 数组顺序决定——因此本文件再放同 id 条目，只会制造一个"可能赢、也可能输"的
+# 重复注册，把 config 的归属变成掷硬币。P1 实机验收就是被这个坑卡住的：
+# 插件带着占位 instanceKey 出站 → 网关 4401 → 无限重连，全链路没有任何日志。
+#
+# 正确接法（使用方在**自己的** profile 里做，本包不替它决定）：
+#   ~/.dsh/profiles/<name>/cordis.patch.yml:
+#     - insert:
+#         - id: remote-bridge
+#           name: '@ntdgy/dsh-remote-bridge-plugin'
+#           config:
+#             relayUrl: wss://gateway.example.com/agent
+#             instanceId: dsh-prod-01
+#             instanceKey: <从环境变量注入，不要写死>
+#
+# 插件的 Config schema 已把 relayUrl / instanceId / instanceKey 标成 required()，
+# 构造函数再兜一道显式校验：缺任何一项都会在 dsh 启动诊断里报错，不再静默空转。
+[]

package/lib/client.js

@@ -0,0 +1,336 @@
+window.__ModuleLoader__.load({
+	id: "@ntdgy/dsh-remote-bridge-plugin",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/StatusPanel.tsx
+		function timeOf(ms) {
+			return ms === null ? "—" : new Date(ms).toLocaleString();
+		}
+		/**
+		* 把一次读取结果转成展示行。
+		*
+		* 读取失败时**只显示错误**，不显示上一次的快照 ——
+		* 否则「relay 已断但面板还显示旧的正常数据」会被误读成一切正常。
+		*/
+		function rowsOf(outcome) {
+			if (outcome.kind === "error") return [{
+				label: "读取状态失败",
+				value: outcome.message,
+				bad: true
+			}];
+			const s = outcome.status;
+			const disconnected = !s.connection.registered;
+			const closePrefix = disconnected ? "断线" : "上次断线";
+			return [
+				{
+					label: "连接状态",
+					value: s.connection.registered ? "已注册" : "未注册",
+					bad: !s.connection.registered
+				},
+				{
+					label: "instanceId",
+					value: s.identity.instanceId
+				},
+				{
+					label: "relayUrl",
+					value: s.identity.relayUrl
+				},
+				{
+					label: "心跳间隔",
+					value: s.heartbeat.intervalMs === null ? "—" : s.heartbeat.intervalMs + " ms"
+				},
+				{
+					label: "认证失败次数",
+					value: String(s.authFailures),
+					bad: s.authFailures > 0
+				},
+				{
+					label: "丢弃帧数",
+					value: String(s.droppedFrames),
+					bad: s.droppedFrames > 0
+				},
+				{
+					label: "已上报前缀",
+					value: s.httpPrefixes.reported.length === 0 ? "（无）" : s.httpPrefixes.reported.join("、")
+				},
+				{
+					label: closePrefix + "原因",
+					value: s.lastClose.reason ?? "—",
+					bad: disconnected && s.lastClose.reason !== null
+				},
+				{
+					label: closePrefix + "时刻",
+					value: timeOf(s.lastClose.at)
+				},
+				{
+					label: "重连次数",
+					value: String(s.connection.reconnects)
+				},
+				{
+					label: "sessionController",
+					value: s.sessionControllerReady ? "可用" : "不可用",
+					bad: !s.sessionControllerReady
+				},
+				{
+					label: "数据时刻",
+					value: timeOf(s.sampledAt)
+				}
+			];
+		}
+		/**
+		* 面板组件。
+		*
+		* 颜色全部走 token：
+		*   标题 / 值     → --dsw-alias-label-primary
+		*   标签列       → --dsw-alias-label-secondary
+		*   异常值       → --dsw-alias-state-error-primary
+		*   面板底色     → --dsw-specific-sidebar-fill（与侧边栏同底，避免突兀色块）
+		*   分隔线       → --dsw-alias-border-l3
+		*/
+		function StatusPanel(props) {
+			const rows = rowsOf(props.outcome);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					padding: "8px 8px 10px",
+					fontSize: 12,
+					lineHeight: 1.7,
+					color: "var(--dsw-alias-label-primary)",
+					background: "var(--dsw-specific-sidebar-fill)",
+					borderTop: "0.5px solid var(--dsw-alias-border-l3)",
+					marginTop: 4
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: {
+						fontWeight: 600,
+						marginBottom: 6
+					},
+					children: "Remote Bridge 状态（只读）"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("table", {
+					style: {
+						borderCollapse: "collapse",
+						width: "100%"
+					},
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("tbody", { children: rows.map((row) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("tr", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
+						style: {
+							color: "var(--dsw-alias-label-secondary)",
+							paddingRight: 12,
+							whiteSpace: "nowrap",
+							verticalAlign: "top"
+						},
+						children: row.label
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
+						style: {
+							color: row.bad ? "var(--dsw-alias-state-error-primary)" : "inherit",
+							wordBreak: "break-all"
+						},
+						children: row.value
+					})] }, row.label)) })
+				})]
+			});
+		}
+		//#endregion
+		//#region src/client/index.tsx
+		const ENTRY_ID = "bridge-plugin";
+		const STATUS_PATH = "/bridge-plugin/status";
+		/** 轮询间隔：入口与面板共用同一份数据，不会重复轮询。 */
+		const POLL_MS = 3e3;
+		const inject = ["slots"];
+		async function readStatus() {
+			try {
+				const response = await fetch(STATUS_PATH, { cache: "no-store" });
+				if (!response.ok) return {
+					kind: "error",
+					message: "HTTP " + response.status
+				};
+				return {
+					kind: "ok",
+					status: await response.json()
+				};
+			} catch (error) {
+				return {
+					kind: "error",
+					message: error instanceof Error ? error.message : String(error)
+				};
+			}
+		}
+		/**
+		* 桥接图标：与原生侧边栏图标同规格。
+		*
+		* size 16 / viewBox 24 / stroke-width 1.5 —— 前两项实测自 sidebar bundle
+		* （IconPanelLeftOutlineRegular 传 size:16），线宽沿用 DS 图标集的常规值。
+		* stroke=currentColor 跟随 label 色，自动适配深浅主题。
+		*/
+		function BridgeIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				width: "16",
+				height: "16",
+				viewBox: "0 0 24 24",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": "true",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M2 12h4" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 12h4" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M6 7v10" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 7v10" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M6 12h12" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+						cx: "6",
+						cy: "12",
+						r: "1.2",
+						fill: "currentColor",
+						stroke: "none"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+						cx: "18",
+						cy: "12",
+						r: "1.2",
+						fill: "currentColor",
+						stroke: "none"
+					})
+				]
+			});
+		}
+		/** 右侧副信息：状态点 + 文字，样式对齐原生列表项的次要文字。 */
+		function StatusBadge(props) {
+			const connected = props.outcome.kind === "ok" && props.outcome.status.connection.registered;
+			const color = connected ? "var(--dsw-alias-state-success-primary)" : "var(--dsw-alias-state-error-primary)";
+			const label = props.outcome.kind === "error" ? "不可用" : connected ? "已连接" : "已断开";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				style: {
+					marginLeft: "auto",
+					flex: "none",
+					display: "inline-flex",
+					alignItems: "center",
+					gap: 4,
+					color: "var(--dsw-alias-label-secondary)",
+					fontSize: 12,
+					lineHeight: "18px"
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					"aria-hidden": "true",
+					style: {
+						width: 6,
+						height: 6,
+						borderRadius: "50%",
+						background: color,
+						flex: "none"
+					}
+				}), label]
+			});
+		}
+		/** 侧边栏脚部入口：图标 + 文字 + 右侧状态，宽度随容器 stretch。 */
+		function BridgeEntry() {
+			const [open, setOpen] = (0, react.useState)(false);
+			const [outcome, setOutcome] = (0, react.useState)({
+				kind: "error",
+				message: "尚未读取"
+			});
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				const tick = async () => {
+					const next = await readStatus();
+					if (!cancelled) setOutcome(next);
+				};
+				tick();
+				const timer = setInterval(() => void tick(), POLL_MS);
+				return () => {
+					cancelled = true;
+					clearInterval(timer);
+				};
+			}, []);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					display: "flex",
+					flexDirection: "column",
+					alignItems: "stretch",
+					width: "100%"
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					onClick: () => setOpen((v) => !v),
+					title: "Remote Bridge 状态（只读）",
+					"aria-expanded": open,
+					style: {
+						boxSizing: "border-box",
+						borderRadius: "var(--dsw-radius-md)",
+						minHeight: 36,
+						color: "var(--dsw-alias-label-primary)",
+						font: "inherit",
+						textAlign: "left",
+						cursor: "pointer",
+						background: "transparent",
+						border: "none",
+						display: "flex",
+						alignItems: "center",
+						gap: 8,
+						margin: "0 2px",
+						padding: "7px 8px",
+						lineHeight: "22px",
+						width: "100%"
+					},
+					onMouseEnter: (e) => {
+						e.currentTarget.style.background = "var(--dsw-alias-interactive-bg-hover)";
+					},
+					onMouseLeave: (e) => {
+						e.currentTarget.style.background = "transparent";
+					},
+					onFocus: (e) => {
+						e.currentTarget.style.outline = "var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))";
+						e.currentTarget.style.outlineOffset = "-2px";
+					},
+					onBlur: (e) => {
+						e.currentTarget.style.outline = "none";
+					},
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							style: {
+								flex: "none",
+								display: "inline-flex",
+								justifyContent: "center",
+								alignItems: "center"
+							},
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BridgeIcon, {})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							style: {
+								textOverflow: "ellipsis",
+								whiteSpace: "nowrap",
+								minWidth: 0,
+								overflow: "hidden"
+							},
+							children: "桥接状态"
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusBadge, { outcome })
+					]
+				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusPanel, { outcome }) : null]
+			});
+		}
+		function apply(ctx) {
+			ctx.slots.inject("sidebar.footer.action", () => {
+				try {
+					return ctx.slots.register({
+						name: "sidebar.footer.action",
+						id: ENTRY_ID
+					}, BridgeEntry);
+				} catch {
+					return () => {};
+				}
+			});
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.readStatus = readStatus;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useState"],"sources":["../src/client/StatusPanel.tsx","../src/client/index.tsx"],"sourcesContent":["/**\n * bridge-plugin 只读状态面板的视图。\n *\n * 全部颜色取自 DSH 的 design token（--dsw-*），**没有任何硬编码十六进制** ——\n * DSH 支持深浅主题切换，写死的颜色在另一套主题下会不可读。\n *\n * 纯只读：没有任何按钮会写状态。\n */\nimport type { StatusOutcome } from './types.ts'\n\n/** 一行展示项。 */\nexport interface StatusRow {\n  label: string\n  value: string\n  /** 异常项用警示色，便于一眼看出问题。 */\n  bad?: boolean\n}\n\nfunction timeOf(ms: number | null): string {\n  return ms === null ? '—' : new Date(ms).toLocaleString()\n}\n\n/**\n * 把一次读取结果转成展示行。\n *\n * 读取失败时**只显示错误**，不显示上一次的快照 ——\n * 否则「relay 已断但面板还显示旧的正常数据」会被误读成一切正常。\n */\nexport function rowsOf(outcome: StatusOutcome): StatusRow[] {\n  if (outcome.kind === 'error') {\n    return [{ label: '读取状态失败', value: outcome.message, bad: true }]\n  }\n  const s = outcome.status\n  // 断线记录是**历史**，不是当前状态：已连接时它只说明\"上次为什么断过\"，\n  // 标红会让运维误以为现在不正常。只有当前确实断开时，断线原因才解释现状，\n  // 那时才该醒目。\n  const disconnected = !s.connection.registered\n  const closePrefix = disconnected ? '断线' : '上次断线'\n  return [\n    { label: '连接状态', value: s.connection.registered ? '已注册' : '未注册', bad: !s.connection.registered },\n    { label: 'instanceId', value: s.identity.instanceId },\n    { label: 'relayUrl', value: s.identity.relayUrl },\n    { label: '心跳间隔', value: s.heartbeat.intervalMs === null ? '—' : s.heartbeat.intervalMs + ' ms' },\n    { label: '认证失败次数', value: String(s.authFailures), bad: s.authFailures > 0 },\n    { label: '丢弃帧数', value: String(s.droppedFrames), bad: s.droppedFrames > 0 },\n    { label: '已上报前缀', value: s.httpPrefixes.reported.length === 0 ? '（无）' : s.httpPrefixes.reported.join('、') },\n    { label: closePrefix + '原因', value: s.lastClose.reason ?? '—', bad: disconnected && s.lastClose.reason !== null },\n    { label: closePrefix + '时刻', value: timeOf(s.lastClose.at) },\n    { label: '重连次数', value: String(s.connection.reconnects) },\n    { label: 'sessionController', value: s.sessionControllerReady ? '可用' : '不可用', bad: !s.sessionControllerReady },\n    { label: '数据时刻', value: timeOf(s.sampledAt) },\n  ]\n}\n\n/**\n * 面板组件。\n *\n * 颜色全部走 token：\n *   标题 / 值     → --dsw-alias-label-primary\n *   标签列       → --dsw-alias-label-secondary\n *   异常值       → --dsw-alias-state-error-primary\n *   面板底色     → --dsw-specific-sidebar-fill（与侧边栏同底，避免突兀色块）\n *   分隔线       → --dsw-alias-border-l3\n */\nexport function StatusPanel(props: { outcome: StatusOutcome }): React.ReactElement {\n  const rows = rowsOf(props.outcome)\n  return (\n    <div\n      style={{\n        padding: '8px 8px 10px',\n        fontSize: 12,\n        lineHeight: 1.7,\n        color: 'var(--dsw-alias-label-primary)',\n        background: 'var(--dsw-specific-sidebar-fill)',\n        borderTop: '0.5px solid var(--dsw-alias-border-l3)',\n        marginTop: 4,\n      }}\n    >\n      <div style={{ fontWeight: 600, marginBottom: 6 }}>Remote Bridge 状态（只读）</div>\n      <table style={{ borderCollapse: 'collapse', width: '100%' }}>\n        <tbody>\n          {rows.map((row) => (\n            <tr key={row.label}>\n              <td\n                style={{\n                  color: 'var(--dsw-alias-label-secondary)',\n                  paddingRight: 12,\n                  whiteSpace: 'nowrap',\n                  verticalAlign: 'top',\n                }}\n              >\n                {row.label}\n              </td>\n              <td\n                style={{\n                  color: row.bad ? 'var(--dsw-alias-state-error-primary)' : 'inherit',\n                  wordBreak: 'break-all',\n                }}\n              >\n                {row.value}\n              </td>\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </div>\n  )\n}\n","/**\n * bridge-plugin 只读状态面板（浏览器侧）。\n *\n * 样式全部取自 DSH 的 design token 与原生 CSS（--dsw-*），不硬编码颜色 ——\n * DSH 支持深浅主题切换，写死的十六进制在另一套主题下会不可读。\n *\n * 入口对齐原生 sidebar 的 .panelRow（插件 / 自动化任务 那一列），逐项照抄数值：\n *   box-sizing:border-box; border-radius:var(--dsw-radius-md); min-height:36px;\n *   gap:8px; margin:0 2px; padding:7px 8px; line-height:22px; font:inherit; border:none;\n *   悬停 background:var(--dsw-alias-interactive-bg-hover)。\n *\n * 宽度：原生 .panelRow **没有** width 声明 —— 它是 .panelList（column flex）的子项，\n * 默认 stretch 所以撑满。这里用同样的办法：外层 column flex + align-items:stretch，\n * 不写死 100%（写死会在将来加内边距时错位）。\n *\n * 图标：原生用 size:16（IconPanelLeftOutlineRegular 等，实测其 size 参数为 16），\n * viewBox 24、stroke-width 1.5 —— 与 DS 图标集一致。\n *\n * 纯只读：不调用任何写接口。数据来自本插件注册的 GET /bridge-plugin/status。\n */\nimport type { Context as ClientContext } from '@deepseek-ai/cordis'\nimport type {} from '@deepseek-ai/dsh-client-ui-renderer/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-sidebar/client'\nimport { useEffect, useState } from 'react'\nimport { StatusPanel, type StatusRow } from './StatusPanel.tsx'\nimport type { StatusOutcome } from './types.ts'\n\nconst ENTRY_ID = 'bridge-plugin'\nconst STATUS_PATH = '/bridge-plugin/status'\n/** 轮询间隔：入口与面板共用同一份数据，不会重复轮询。 */\nconst POLL_MS = 3_000\n\nexport const inject = ['slots']\n\nexport async function readStatus(): Promise<StatusOutcome> {\n  try {\n    const response = await fetch(STATUS_PATH, { cache: 'no-store' })\n    if (!response.ok) return { kind: 'error', message: 'HTTP ' + response.status }\n    return { kind: 'ok', status: (await response.json()) as never }\n  } catch (error) {\n    return { kind: 'error', message: error instanceof Error ? error.message : String(error) }\n  }\n}\n\n/**\n * 桥接图标：与原生侧边栏图标同规格。\n *\n * size 16 / viewBox 24 / stroke-width 1.5 —— 前两项实测自 sidebar bundle\n * （IconPanelLeftOutlineRegular 传 size:16），线宽沿用 DS 图标集的常规值。\n * stroke=currentColor 跟随 label 色，自动适配深浅主题。\n */\nfunction BridgeIcon(): React.ReactElement {\n  return (\n    <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\"\n         strokeWidth=\"1.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\">\n      <path d=\"M2 12h4\" />\n      <path d=\"M18 12h4\" />\n      <path d=\"M6 7v10\" />\n      <path d=\"M18 7v10\" />\n      <path d=\"M6 12h12\" />\n      <circle cx=\"6\" cy=\"12\" r=\"1.2\" fill=\"currentColor\" stroke=\"none\" />\n      <circle cx=\"18\" cy=\"12\" r=\"1.2\" fill=\"currentColor\" stroke=\"none\" />\n    </svg>\n  )\n}\n\n/** 右侧副信息：状态点 + 文字，样式对齐原生列表项的次要文字。 */\nfunction StatusBadge(props: { outcome: StatusOutcome }): React.ReactElement {\n  const connected = props.outcome.kind === 'ok' && props.outcome.status.connection.registered\n  const color = connected\n    ? 'var(--dsw-alias-state-success-primary)'\n    : 'var(--dsw-alias-state-error-primary)'\n  const label = props.outcome.kind === 'error' ? '不可用' : connected ? '已连接' : '已断开'\n  return (\n    <span\n      style={{\n        marginLeft: 'auto',\n        flex: 'none',\n        display: 'inline-flex',\n        alignItems: 'center',\n        gap: 4,\n        color: 'var(--dsw-alias-label-secondary)',\n        fontSize: 12,\n        lineHeight: '18px',\n      }}\n    >\n      <span\n        aria-hidden=\"true\"\n        style={{ width: 6, height: 6, borderRadius: '50%', background: color, flex: 'none' }}\n      />\n      {label}\n    </span>\n  )\n}\n\n/** 侧边栏脚部入口：图标 + 文字 + 右侧状态，宽度随容器 stretch。 */\nfunction BridgeEntry(): React.ReactElement {\n  const [open, setOpen] = useState(false)\n  const [outcome, setOutcome] = useState<StatusOutcome>({ kind: 'error', message: '尚未读取' })\n\n  useEffect(() => {\n    // 常驻轮询：入口右侧的状态需要它，面板打开时复用同一份，不重复轮询。\n    let cancelled = false\n    const tick = async (): Promise<void> => {\n      const next = await readStatus()\n      if (!cancelled) setOutcome(next)\n    }\n    void tick()\n    const timer = setInterval(() => void tick(), POLL_MS)\n    return () => {\n      cancelled = true\n      clearInterval(timer)\n    }\n  }, [])\n\n  const entryStyle: React.CSSProperties = {\n    boxSizing: 'border-box',\n    borderRadius: 'var(--dsw-radius-md)',\n    minHeight: 36,\n    color: 'var(--dsw-alias-label-primary)',\n    font: 'inherit',\n    textAlign: 'left',\n    cursor: 'pointer',\n    background: 'transparent',\n    border: 'none',\n    display: 'flex',\n    alignItems: 'center',\n    gap: 8,\n    margin: '0 2px',\n    padding: '7px 8px',\n    lineHeight: '22px',\n    // 与原生一致：不写死 width，靠父容器的 stretch 撑满。\n    width: '100%',\n  }\n\n  return (\n    <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'stretch', width: '100%' }}>\n      <button\n        type=\"button\"\n        onClick={() => setOpen((v) => !v)}\n        title=\"Remote Bridge 状态（只读）\"\n        aria-expanded={open}\n        style={entryStyle}\n        onMouseEnter={(e) => { e.currentTarget.style.background = 'var(--dsw-alias-interactive-bg-hover)' }}\n        onMouseLeave={(e) => { e.currentTarget.style.background = 'transparent' }}\n        onFocus={(e) => { e.currentTarget.style.outline = 'var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))'; e.currentTarget.style.outlineOffset = '-2px' }}\n        onBlur={(e) => { e.currentTarget.style.outline = 'none' }}\n      >\n        <span style={{ flex: 'none', display: 'inline-flex', justifyContent: 'center', alignItems: 'center' }}>\n          <BridgeIcon />\n        </span>\n        <span style={{ textOverflow: 'ellipsis', whiteSpace: 'nowrap', minWidth: 0, overflow: 'hidden' }}>\n          桥接状态\n        </span>\n        <StatusBadge outcome={outcome} />\n      </button>\n      {open ? <StatusPanel outcome={outcome} /> : null}\n    </div>\n  )\n}\n\nexport function apply(ctx: ClientContext): void {\n  ctx.slots.inject('sidebar.footer.action', () => {\n    try {\n      return ctx.slots.register({ name: 'sidebar.footer.action', id: ENTRY_ID }, BridgeEntry)\n    } catch {\n      return () => {}\n    }\n  })\n}\n\nexport type { StatusRow }\n"],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * dsh-remote-bridge —— DSH host 侧插件。
+ *
+ * 职责：
+ *   1. 主动出站连接到公网网关（DSH → VPS，VPS 永不主动连入）
+ *   2. 自证身份（同进程内直接使用 sessionController，不走 HTTP、不碰 token）
+ *   3. 只响应白名单 RPC，绝不透传任意请求
+ *
+ * 硬性纪律见 docs/decisions/ADR-002-no-http-fallback.md。
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { Dispatcher } from './relay/dispatcher.ts';
+import { FollowRegistry } from './relay/follow.ts';
+export declare const name = "remote-bridge";
+/**
+ * 只注入我们真正需要的服务。connection 用于兜底自证，sessionController 是主路径。
+ *
+ * cordis 语义（@deepseek-ai/cordis 4.0.5，fiber.ts:611-623 `_refresh`）：
+ * 任一 inject 服务缺失，fiber 停在 PENDING —— 不报错、不加载、不打日志。
+ * 也就是说"服务名写错"的表现是**插件静默不工作**，而不是启动失败。
+ * 因此服务名必须与实装一致（0.2.1-rc.2：`super(ctx, "sessionController")` lib/index.js:2952，
+ * `connection` lib/index.js:710），任何服务名调整都要同时改这里。
+ *
+ * ── 为什么 webServer **不在这里**（I-3）────────────────────────────────
+ *
+ * 它是**可选能力**，不是主能力。JS 侧三条使用点全部是防御式读取：
+ *   - resolveUpstreamOrigin / collectHttpPrefixes：ctx.get('webServer')，取不到即降级；
+ *   - 状态路由：走 ctx.inject(['webServer'], …)，本来就是可选注入。
+ * 既然没有任何一条路径依赖它"必须就绪"，把它写进 inject 只会带来一个后果：
+ * 在**没有 web 服务的 profile** 里整插件停在 PENDING（cordis 语义：任一 inject 缺失
+ * 即不加载、不报错、不打日志）。那等于用一个可选能力换掉主能力——
+ * 窄 RPC 会一起消失，而且**没有任何日志**说明为什么。
+ *
+ * 这正是本文件历史上踩过的坑：同一段代码上方曾有过一条"webServer 不在 inject 里，
+ * 这是刻意的"的注释，而 inject 里却真的写着 webServer —— 注释与代码互相矛盾，
+ * 直到有部署在没有 webServer 的环境里静默不工作才可能暴露。
+ * 现在两者一致：**inject 里每一项都必须被主路径无条件需要**，可选能力一律走 ctx.inject。
+ *
+ * 代价（明确接受）：在非 web profile 里 ctx.get('webServer') 返回 undefined，
+ * 转发与状态路由不可用。这是可接受的：没有 web 服务时本来也没有 GUI 可转发。
+ * 调用方会回明确的 upstream_unreachable / 打印 "webServer unavailable"，前端能看到原因。
+ */
+export declare const inject: string[];
+export interface Config {
+    relayUrl: string;
+    instanceId: string;
+    instanceKey: string;
+    reconnectBaseMs?: number;
+    reconnectMaxMs?: number;
+    /** 首次心跳间隔；网关 hello 回执会回传权威值并覆盖它。 */
+    heartbeatIntervalMs?: number;
+}
+export default class RemoteBridge extends Service {
+    static Config: z<Config>;
+    private client?;
+    /**
+     * 面板用的运行时快照（只读）。
+     *
+     * 全部取自既有状态，不新增采集：连接态、断线原因、各类计数都在这里汇合，
+     * 供 /bridge-plugin/status 路由读取。
+     */
+    private panelState;
+    /**
+     * 以下三个引用只用于**观测**（诊断/测试），不参与业务逻辑。
+     *
+     * T14 的教训：dispatcher / follows 曾完全是 ctx.effect 闭包里的局部量，
+     * 插件实例上完全不可达，导致 "Cannot read properties of undefined (reading 'follow')"
+     * 这类问题无法从实例外部观察，只能靠复刻缩小范围。暴露成只读字段是为了让同类
+     * 问题下次能一眼看到。
+     */
+    private dispatcherRef?;
+    private followsRegistry?;
+    private readonly config;
+    constructor(ctx: Context, config: Config);
+    /** 供调试/测试读取当前连接状态（已收到 hello 回执才算就绪）。 */
+    get connected(): boolean;
+    /**
+     * 组装面板所需的只读状态。
+     *
+     * 七项全部取自既有运行态，**不新增采集、不猜值**：
+     *   连接状态 / instanceId + relayUrl / 心跳间隔 / authFailures /
+     *   droppedFrames + 已上报前缀 / 断线原因 / sessionControllerReady
+     *
+     * 安全：绝不包含 instanceKey 或任何凭据。
+     */
+    private buildStatusPayload;
+    /** 只读诊断：当前 dispatcher（插件未激活时为 undefined）。 */
+    get dispatcher(): Dispatcher | undefined;
+    /** 只读诊断：当前帧流注册表（插件未激活时为 undefined）。 */
+    get follows(): FollowRegistry | undefined;
+    /**
+     * 只读诊断：sessionController 当下是否可解析且具备 follow()。
+     *
+     * 不抛错——诊断接口不该在健康检查时炸掉调用方。
+     */
+    /**
+     * 即刻探测 sessionController 是否可用。
+     *
+     * 每次调用都真实取一次服务并检查形状，不复用历史结果 ——
+     * 面板要回答的是「现在能不能用」。
+     */
+    private probeSessionController;
+    /** 供调试/测试读取当前 sessionController 可用性（实时探测）。 */
+    get sessionControllerReady(): boolean;
+}