feat: 大屏后端（FastAPI+MQTT+sim_engine）

- REST :10085 / MQTT 控制 / SSE 回退 / AI+语音 - 数据源规划：接核心服务端 + 算力引擎真实数据
2026-08-23 22:35:05 +08:00
parent 9700eb652b
commit b681eac2df
236 changed files with 54727 additions and 0 deletions
@@ -0,0 +1,37 @@
+// @ts-check
+/** Small shared helpers used across the UI modules: a strict query selector,
+ *  HTML escaping for text we drop into innerHTML, error-string trimming, and
+ *  the opt-in debug flag. */
+
+/** Opt-in tracing: `localStorage.setItem("s2s.debug", "1")` then reload. */
+export const DEBUG = (() => {
+  try {
+    return localStorage.getItem("s2s.debug") === "1";
+  } catch {
+    return false;
+  }
+})();
+
+/**
+ * Query a single element, throwing if it's missing (so a broken selector fails
+ * loudly at startup rather than as a later null-deref).
+ * @template {HTMLElement} T
+ * @param {string} selector
+ * @returns {T}
+ */
+export function $(selector) {
+  const el = document.querySelector(selector);
+  if (!el) throw new Error(`Missing element: ${selector}`);
+  return /** @type {T} */ (el);
+}
+
+/** @param {string} s @returns {string} */
+export function escHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+/** Trim a long error message to fit the orb caption. @param {string} text */
+export function truncateError(text) {
+  if (text.length <= 90) return text;
+  return text.slice(0, 87) + "…";
+}