[Feat] Early support for PLS & Use JSDoc (Partially)

src/aura/ui/pages/configSubPages/behaviourCtrl/behaviourCtrl.css

@@ -0,0 +1,8 @@
+.aura-config-subpage-behaviour-control {
+  opacity: 1;
+  transition: opacity 0.5s;
+}
+
+.aura-config-subpage-behaviour-control.acs-behaviour-control-hidden {
+  opacity: 0;
+}

src/aura/ui/pages/configSubPages/behaviourCtrl/behaviourCtrl.html

@@ -0,0 +1,69 @@
+<div
+  id="acs-behaviour-control-el"
+  class="aura-config-subpage-behaviour-control acs-behaviour-control-hidden"
+>
+  <ul class="nav nav-underline mb-3" role="tablist">
+    <li class="nav-item" role="presentation">
+      <button
+        class="nav-link active"
+        id="status-subpage-tab"
+        data-bs-toggle="pill"
+        data-bs-target="#status-subpage"
+        type="button"
+        role="tab"
+        aria-controls="status-subpage"
+        aria-selected="true"
+      >
+        状态
+      </button>
+    </li>
+    <li class="nav-item" role="presentation">
+      <button
+        class="nav-link"
+        id="basic-config-tab"
+        data-bs-toggle="pill"
+        data-bs-target="#basic-config-subpage"
+        type="button"
+        role="tab"
+        aria-controls="basic-config-subpage"
+        aria-selected="false"
+      >
+        基本设置
+      </button>
+    </li>
+    <li class="nav-item" role="presentation">
+      <button
+        class="nav-link"
+        id="security-config-tab"
+        data-bs-toggle="pill"
+        data-bs-target="#security-config-subpage"
+        type="button"
+        role="tab"
+        aria-controls="security-config-subpage"
+        aria-selected="false"
+      >
+        设备安全
+      </button>
+    </li>
+  </ul>
+  <div class="tab-content">
+    <div
+      class="tab-pane fade show active"
+      id="status-subpage"
+      role="tabpanel"
+      aria-labelledby="status-subpage-tab"
+    ></div>
+    <div
+      class="tab-pane fade"
+      id="basic-config-subpage"
+      role="tabpanel"
+      aria-labelledby="basic-config-tab"
+    ></div>
+    <div
+      class="tab-pane fade"
+      id="security-config-subpage"
+      role="tabpanel"
+      aria-labelledby="security-config-tab"
+    ></div>
+  </div>
+</div>

src/aura/ui/pages/configSubPages/behaviourCtrl/behaviourCtrl.js

@@ -0,0 +1,44 @@
+(() => {
+  const REQUIRE_BASE =
+    "../../aura/ui/pages/configSubPages/behaviourCtrl/settings";
+
+  const {
+    settingsRenderer,
+  } = require(`${REQUIRE_BASE}/../../../../composables/settingsRenderer`);
+
+  const { basicSettings } = require(`${REQUIRE_BASE}/basic`);
+
+  const {
+    updatePlsSettingsFromLocal,
+    updatePlsRulesFromLocal,
+  } = require(`${REQUIRE_BASE}/../../../../composables/plsConfigManager`);
+
+  const initStatusPage = () => {
+    global.__HUGO_AURA_LOADER__[
+      "Aura.UI.Assistant.Config.BehaviourCtrl.PlsStatus"
+    ].active = true;
+  };
+
+  const initBasicSettingsPage = () => {
+    const basicSubPageEl = document.getElementById("basic-config-subpage");
+    settingsRenderer(basicSubPageEl, basicSettings);
+  };
+
+  const renderSubPages = async () => {
+    await updatePlsSettingsFromLocal();
+    await updatePlsRulesFromLocal();
+
+    initBasicSettingsPage();
+  };
+
+  const onMounted = () => {
+    const rootEl = document.getElementById("acs-behaviour-control-el");
+    initStatusPage();
+    renderSubPages();
+    setTimeout(() => {
+      rootEl.classList.remove("acs-behaviour-control-hidden");
+    }, 500);
+  };
+
+  onMounted();
+})();

src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.css

@@ -0,0 +1,78 @@
+.acs-behaviour-control-pls-status-page {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+}
+
+.acs-behaviour-control-pls-status-page p {
+  font-family: sans-serif;
+}
+
+.acs-bc-pls-status-page-pls-description {
+  margin-top: 0.5rem;
+  max-width: 80%;
+  opacity: 0.35;
+  font-size: small;
+  text-align: center;
+}
+
+.acs-bc-pls-status-page-main-logo {
+  max-width: 13.5%;
+  opacity: 0.45;
+  margin-top: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+
+.acs-bc-pls-status-page-status-el {
+  display: flex;
+  align-items: center;
+  width: 40%;
+  padding: 0.625rem 0.25rem;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.25);
+}
+
+.acs-bc-pls-status-page-status-el div {
+  display: flex;
+  align-items: center;
+}
+
+.acs-bc-pls-status-page-status-area {
+  flex-grow: 1;
+  justify-content: flex-end;
+}
+
+.acs-bc-pls-status-page-status-area-circle {
+  height: 10px;
+  width: 10px;
+  border-radius: 100%;
+  margin-right: 8px;
+  margin-top: 2px;
+}
+
+.acs-bc-pls-status-page-status-area.pending
+  .acs-bc-pls-status-page-status-area-circle {
+  background-color: rgba(0, 0, 0, 0.375);
+}
+
+.acs-bc-pls-status-page-status-area.pending p {
+  opacity: 0.5;
+}
+
+.acs-bc-pls-status-page-status-area.success
+  .acs-bc-pls-status-page-status-area-circle {
+  background-color: rgb(0, 175, 38);
+}
+
+.acs-bc-pls-status-page-status-area.success p {
+  color: rgb(0, 150, 33);
+}
+
+.acs-bc-pls-status-page-status-area.failed
+  .acs-bc-pls-status-page-status-area-circle {
+  background-color: rgb(175, 0, 0);
+}
+
+.acs-bc-pls-status-page-status-area.failed p {
+  color: rgb(175, 0, 0);
+}

src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.html

@@ -0,0 +1,51 @@
+<div class="acs-behaviour-control-pls-status-page">
+  <p class="acs-bc-pls-status-page-pls-description">
+    HugoAura ProxyLayerServices (Aura-PLS) 是基于 Python + MITMProxy 实现的代理服务,
+    用于解密并修改希沃基础服务 (SeewoCore) 的 MQTT 数据包,
+    实现行为监控、伪造上报等功能
+  </p>
+  <img
+    src="../../aura/ui/static/aura_pls.png"
+    class="acs-bc-pls-status-page-main-logo"
+  />
+
+  <div class="acs-bc-pls-status-page-status-el">
+    <p>安装状态</p>
+    <div
+      class="acs-bc-pls-status-page-status-area pending"
+      id="acs-bc-psp-installStatus-container"
+    >
+      <span class="acs-bc-pls-status-page-status-area-circle"></span>
+      <p id="acs-bc-psp-installStatus-text">未安装</p>
+    </div>
+  </div>
+
+  <div class="acs-bc-pls-status-page-status-el">
+    <p>启动状态</p>
+    <div
+      class="acs-bc-pls-status-page-status-area pending"
+      id="acs-bc-psp-launchStatus-container"
+    >
+      <span class="acs-bc-pls-status-page-status-area-circle"></span>
+      <p id="acs-bc-psp-launchStatus-text">未启动</p>
+    </div>
+  </div>
+
+  <div class="acs-bc-pls-status-page-status-el">
+    <p>连接状态</p>
+    <div
+      class="acs-bc-pls-status-page-status-area pending"
+      id="acs-bc-psp-connStatus-container"
+    >
+      <span class="acs-bc-pls-status-page-status-area-circle"></span>
+      <p id="acs-bc-psp-connStatus-text">已断开</p>
+    </div>
+  </div>
+
+  <div class="acs-bc-pls-status-page-status-el" style="border-bottom: none">
+    <p>版本</p>
+    <div class="acs-bc-pls-status-page-status-area">
+      <p id="acs-bc-psp-version-text">不可用</p>
+    </div>
+  </div>
+</div>

src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.js

@@ -0,0 +1,86 @@
+(() => {
+  const REQUIRE_BASE = "../../aura/ui/pages/configSubPages/behaviourCtrl";
+  const IPC_METHOD_BASE = "$aura.pls";
+
+  const {
+    updatePlsStatusFromLocal,
+  } = require(`${REQUIRE_BASE}/../../../composables/plsConfigManager`);
+
+  const updateStatusEl = (
+    areaContainerId,
+    areaTextId,
+    target,
+    text = false
+  ) => {
+    const areaContainerEl = document.getElementById(areaContainerId);
+    const areaContainerText = document.getElementById(areaTextId);
+    switch (target) {
+      case "PENDING":
+        areaContainerEl.className =
+          "acs-bc-pls-status-page-status-area pending";
+        break;
+      case "SUCCESS":
+        areaContainerEl.className =
+          "acs-bc-pls-status-page-status-area success";
+        break;
+      case "FAILED":
+        areaContainerEl.className = "acs-bc-pls-status-page-status-area failed";
+        break;
+      case "WARNING":
+        areaContainerEl.className =
+          "acs-bc-pls-status-page-status-area warning";
+        break;
+      default:
+        return false;
+    }
+    areaContainerText.textContent = text ? text : "";
+    return true;
+  };
+
+  const updateStatus = async () => {
+    const curPlsStats = await updatePlsStatusFromLocal();
+
+    const acIdInst = "acs-bc-psp-installStatus-container";
+    const atIdInst = "acs-bc-psp-installStatus-text";
+    switch (curPlsStats.installed) {
+      case true:
+        updateStatusEl(acIdInst, atIdInst, "SUCCESS", "已安装");
+        break;
+      case false:
+        updateStatusEl(acIdInst, atIdInst, "PENDING", "未安装");
+    }
+
+    const acIdLaunch = "acs-bc-psp-launchStatus-container";
+    const atIdLaunch = "acs-bc-psp-launchStatus-text";
+    switch (curPlsStats.launched) {
+      case true:
+        updateStatusEl(acIdLaunch, atIdLaunch, "SUCCESS", "已启动");
+        break;
+      case false:
+        updateStatusEl(acIdLaunch, atIdLaunch, "PENDING", "未启动");
+        break;
+    }
+
+    const acIdConn = "acs-bc-psp-connStatus-container";
+    const atIdConn = "acs-bc-psp-connStatus-text";
+    switch (curPlsStats.connected) {
+      case true:
+        updateStatusEl(acIdConn, atIdConn, "SUCCESS", "已连接");
+        break;
+      case false:
+        updateStatusEl(acIdConn, atIdConn, "FAILED", "连接失败");
+        break;
+    }
+
+    if (curPlsStats.version && curPlsStats.version !== "未知") {
+      const versionTextEl = document.getElementById("acs-bc-psp-version-text");
+      versionTextEl.textContent = "v" + curPlsStats.version;
+    }
+  };
+
+  const onMounted = () => {
+    updateStatus();
+  };
+
+  onMounted();
+})();

src/aura/ui/pages/configSubPages/behaviourCtrl/settings/basic.js

@@ -0,0 +1,45 @@
+const REQUIRE_BASE = ".";
+
+const {
+  updatePlsConfigToRemote,
+} = require(`${REQUIRE_BASE}/../../../../composables/plsConfigManager`);
+
+const basicSettings = [
+  {
+    id: 0,
+    categoryName: "可访问性",
+    child: [
+      {
+        index: 0,
+        id: "authToken",
+        type: "input",
+        subType: "text",
+        name: "WebSocket 认证密钥",
+        description: "选择一个安全的密钥, 用于 PLS 侧验证 Aura 前端身份",
+        restart: true,
+        reload: false,
+        restartPLS: false,
+        associateVal: null,
+        auraIf: () => true,
+        defaultValue: "",
+        placeHolder: "输入一个密钥",
+        valueGetter: () => {
+          return global.__HUGO_AURA_CONFIG__.plsToken;
+        },
+        callbackFn: (newVal) => {
+          if (newVal === "" || !newVal)
+            return { valid: false, hint: "请输入认证密钥" };
+
+          if (newVal.length < 8) {
+            return { valid: false, hint: "至少输入 8 位字符" };
+          }
+
+          global.__HUGO_AURA_CONFIG__.plsToken = newVal;
+          return { valid: true };
+        },
+      },
+    ],
+  },
+];
+
+module.exports = { basicSettings };