rvis-aiui-kit 1.1.1 → 1.2.2

package/README.md

@@ -1,6 +1,6 @@
 # rvis-aiui-kit
 
-面向 Rokid AIUI / JSUI 应用的组件库与 Glass3 扩展 SDK。包内包含 7 个 Ink UI 组件、9 组 Host RPC 能力，以及一个 Rokid OpenAPI HTTPS/SSE 客户端。
+面向 Rokid AIUI / JSUI 应用的组件库与 Glass3 扩展 SDK。包内包含 6 个 Ink UI 组件、10 组 Host RPC 能力，以及一个 Rokid OpenAPI HTTPS/SSE 客户端。
 
 ## 文档导航
 
@@ -9,6 +9,7 @@
 - [Glass3 SDK API](#glass3-sdk-api)
   - [API 总览](#api-总览)
   - [Device Context](#device-context)
+  - [Status Bar](#status-bar)
   - [Screen](#screen)
   - [Notification](#notification)
   - [TTS](#tts)
@@ -26,7 +27,6 @@
   - [Markdown](#markdown)
   - [Model List](#model-list)
   - [Paragraph](#paragraph)
-  - [Status Bar](#status-bar)
   - [Table](#table)
 
 ## 安装与运行环境
@@ -64,7 +64,6 @@ npm install rvis-aiui-kit
     }
   },
   "usingComponents": {
-    "rvis-status-bar": "rvis-aiui-kit/status-bar",
     "rvis-paragraph": "rvis-aiui-kit/paragraph",
     "rvis-table": "rvis-aiui-kit/table"
   }
@@ -83,6 +82,11 @@ export default {
     resultText: '准备就绪'
   },
 
+  async onLoad() {
+    await glass3.statusBar.setTitle({ title: '巡检' });
+    await glass3.statusBar.setVisible({ visible: true });
+  },
+
   onMessage(messageEvent) {
     // Host RPC 的 Promise 和流式 onEvent 都依赖这一步。
     glass3.handleMessage(messageEvent);
@@ -108,7 +112,6 @@ export default {
 
 <page>
   <view class="page">
-    <rvis-status-bar title="巡检"></rvis-status-bar>
     <view class="content">
       <rvis-paragraph text="{{ resultText }}" width="424px"></rvis-paragraph>
     </view>
@@ -127,7 +130,7 @@ export default {
 
 .content {
   position: absolute;
-  top: 40px;
+  top: 150px;
   left: 28px;
   width: 424px;
 }
@@ -169,6 +172,7 @@ import glass3, {
 | `deviceContext` | `get(options?)` | 获取设备上下文原子快照 |
 | `deviceContext` | `observe(options?, callOptions?)` | 订阅设备上下文快照和变化 |
 | `deviceContext` | `stopObserve({ requestId })` | 停止设备上下文订阅 |
+| `statusBar` | `setTitle({ title })` / `setVisible({ visible })` | 设置标题并显示 / 隐藏 Native 状态栏 |
 | `screen` | `turnOff()` / `turnOn()` | 息屏 / 亮屏 |
 | `notification` | `show(options)` / `hide({ requestId })` | 显示 / 隐藏原生通知 |
 | `tts` | `speak(options, callOptions?)` / `stop({ requestId })` | TTS 播报 / 停止 |
@@ -217,6 +221,18 @@ await glass3.deviceContext.stopObserve({ requestId: observer.requestId });
 
 `get()` 等待 `snapshot` 事件后完成，返回 `{ requestId, ok, eventType: 'snapshot', snapshot }`。`observe()` 在订阅启动后返回 `{ requestId, ok, state: 'started' }`；首个业务事件为 `snapshot`，后续为 `changed` 或 `invalidated`。SDK 不自动合并 patch。
 
+### Status Bar
+
+```js
+await glass3.statusBar.setTitle({ title: '设备巡检' });
+const result = await glass3.statusBar.setVisible({ visible: true });
+// { updated: true, visible: true }
+```
+
+`title` 必须是字符串，空字符串或全空白字符串用于清理标题；`visible` 必须是 Boolean。建议先设置标题，再显示状态栏。该能力直接解析 Host RPC HTTP response body，不依赖 `onMessage`。
+
+Native 状态栏可能占用屏幕 y=0 到 y=149。全屏页面根节点仍从 y=0 开始，只将页面内容放到 y=150 或更低位置。
+
 ### Screen
 
 ```js
@@ -658,20 +674,6 @@ data: {
 <rvis-paragraph text="{{ text }}" width="424px" segments="{{ segments }}"></rvis-paragraph>
 ```
 
-### Status Bar
-
-注册路径：`rvis-aiui-kit/status-bar`
-
-| 属性 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `title` | `String` | `''` | 左侧应用标题 |
-
-```html
-<rvis-status-bar title="应用名称"></rvis-status-bar>
-```
-
-组件尺寸固定为 `480px × 20px`，显示应用标题、本地日期时间和实时电量。页面应将其放在全屏绘制区域的 `(0, 0)`。组件自动管理时钟和 `power` 订阅，但 Page 必须把 `onMessage` 转发给共享的 `glass3` 实例。
-
 ### Table
 
 注册路径：`rvis-aiui-kit/table`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rvis-aiui-kit",
-  "version": "1.1.1",
+  "version": "1.2.2",
   "description": "RVIS AIUI components and Glass3 extension SDK.",
   "type": "module",
   "main": "./sdk/index.js",
@@ -18,7 +18,6 @@
       "./markdown": "./components/markdown/index",
       "./model-list": "./components/model-list/index",
       "./paragraph": "./components/paragraph/index",
-      "./status-bar": "./components/status-bar/index",
       "./table": "./components/table/index"
     }
   },

package/sdk/README.md

@@ -13,6 +13,7 @@
 - [API 总览](#api-总览)
 - [通用调用约定](#通用调用约定)
 - [Device Context 设备上下文](#device-context-设备上下文)
+- [Status Bar 原生状态栏](#status-bar-原生状态栏)
 - [Screen 屏幕控制](#screen-屏幕控制)
 - [Notification 原生通知](#notification-原生通知)
 - [TTS 语音播报](#tts-语音播报)
@@ -65,6 +66,8 @@ import glass3, {
 
 | 模块 | 方法 | 用途 |
 | --- | --- | --- |
+| `statusBar` | `setTitle({ title })` | 设置或清理当前 AIX 页面的状态栏标题。 |
+| `statusBar` | `setVisible({ visible })` | 显示或重新隐藏 Native 状态栏。 |
 | `deviceContext` | `get(options?)` | 一次性获取设备上下文原子快照。 |
 | `deviceContext` | `observe(options?, callOptions?)` | 订阅设备上下文快照和增量变化。 |
 | `deviceContext` | `stopObserve({ requestId })` | 停止指定的设备上下文订阅。 |
@@ -218,6 +221,28 @@ const result = await glass3.deviceContext.stopObserve({
 
 详见 [`modules/device-context/readme.md`](./modules/device-context/readme.md)。
 
+## Status Bar 原生状态栏
+
+状态栏是 Host 管理的系统 UI，可在屏幕顶部显示标题、时间、网络和电量。该能力只在
+通过 `OPEN_AIX_INK` 外部入口打开的 AIX 页面中注册，页面创建后默认隐藏。
+
+Native 状态栏可能占用屏幕 y=0 到 y=149。页面根节点仍从 y=0 开始，
+只将页面内容放到 y=150 或更低位置。
+
+建议先设置标题，再显示：
+
+```js
+await glass3.statusBar.setTitle({ title: '设备巡检' });
+const result = await glass3.statusBar.setVisible({ visible: true });
+// { updated: true, visible: true }
+```
+
+`title` 必须是字符串；空字符串或全空白字符串用于清理标题。`visible` 必须是
+Boolean。两个方法直接解析 Host RPC HTTP response body，不依赖 `onMessage`，并有
+5 秒本地等待上限。
+
+详见 [`modules/status-bar/readme.md`](./modules/status-bar/readme.md)。
+
 ## Screen 屏幕控制
 
 ### `glass3.screen.turnOff()`
@@ -986,8 +1011,8 @@ export default {
 
 ## Native 映射
 
-所有业务调用使用 RPC `version: "2.0.0"`、`namespace: "rokid.tools"`、
-`method: "invoke"`。
+除 `statusBar` 外的 Host RPC 业务调用使用 `version: "2.0.0"`、
+`namespace: "rokid.tools"`、`method: "invoke"`。
 
 | JavaScript API | `toolName` | `toolAction` |
 | --- | --- | --- |
@@ -1014,12 +1039,16 @@ export default {
 | `motion.startDetect` | `motionDetect` | `start` |
 | `motion.stopDetect` | `motionDetect` | `stop` |
 
+`statusBar.setTitle` 和 `statusBar.setVisible` 使用 `namespace: "rokid.statusBar"`，
+Native method 分别为 `setTitle` 和 `setVisible`，业务参数直接放在 `params` 中。
+
 业务代码应调用公开 JavaScript API，不要直接依赖这张 Native 映射表发 RPC。
 
 ## 详细文档与 Demo
 
 ### 模块文档
 
+- [Status Bar](./modules/status-bar/readme.md)
 - [Device Context](./modules/device-context/readme.md)
 - [Screen](./modules/screen/readme.md)
 - [Notification](./modules/notification/readme.md)
@@ -1032,6 +1061,7 @@ export default {
 
 ### 示例页面
 
+- [Status Bar Demo](../pages/sdk-demo/status-bar/index.ink)
 - [Device Context Demo](../pages/sdk-demo/device-context/index.ink)
 - [Screen Demo](../pages/sdk-demo/screen/index.ink)
 - [Notification Demo Suite](../pages/sdk-demo/notification/index.ink)

package/sdk/api-map.js

@@ -6,11 +6,13 @@ import motion from './modules/motion/index.js';
 import notification from './modules/notification/index.js';
 import offlineCommand from './modules/offline-command/index.js';
 import screen from './modules/screen/index.js';
+import statusBar from './modules/status-bar/index.js';
 import tts from './modules/tts/index.js';
 
 // This map is the only mapping between the public JavaScript API and Host RPC.
 // Public names are never inferred from the native namespace or method strings.
 export const API_MAP = [].concat(
+  statusBar,
   deviceContext,
   notification,
   screen,

package/sdk/core/client.js

@@ -43,12 +43,14 @@ export class Glass3Client {
       requestId,
       namespace: definition.namespace,
       method: definition.method,
-      params: {
-        toolName: definition.toolName,
-        toolAction: definition.toolAction,
-        args: nativeArgs,
-        extra: {}
-      }
+      params: typeof definition.buildRequestParams === 'function'
+        ? definition.buildRequestParams(nativeArgs)
+        : {
+            toolName: definition.toolName,
+            toolAction: definition.toolAction,
+            args: nativeArgs,
+            extra: {}
+          }
     };
 
     if (definition.completion === COMPLETION_EVENT) {
@@ -59,7 +61,12 @@ export class Glass3Client {
       return this.invokeUntilReadyEventStream(definition, request, callOptions);
     }
 
-    return this.invokeUntilAccepted(definition, request, callOptions);
+    return this.invokeUntilAccepted(
+      definition,
+      request,
+      callOptions,
+      timeoutMs
+    );
   }
 
   sendRequest(definition, request) {
@@ -104,7 +111,7 @@ export class Glass3Client {
     return true;
   }
 
-  invokeUntilAccepted(definition, request, callOptions) {
+  invokeUntilAccepted(definition, request, callOptions, timeoutMs) {
     if (typeof callOptions.onEvent === 'function') {
       this.activeInvocations.set(request.requestId, {
         requestId: request.requestId,
@@ -113,13 +120,37 @@ export class Glass3Client {
       });
     }
 
-    return this.sendRequest(definition, request).then(response => {
+    let timeoutId = null;
+    const responsePromise = this.sendRequest(definition, request);
+
+    if (timeoutMs !== undefined) {
+      timeoutId = setTimeout(() => {
+        this.rejectPendingResponse(request.requestId, new Glass3Error(
+          `Glass3 call timed out after ${timeoutMs}ms: ${definition.publicModule}.${definition.publicMethod}`,
+          {
+            code: 'CALL_TIMEOUT',
+            stage: 'timeout',
+            requestId: request.requestId,
+            namespace: definition.namespace,
+            method: definition.method,
+            details: { timeout: timeoutMs }
+          }
+        ));
+      }, timeoutMs);
+    }
+
+    return responsePromise.then(response => {
+      if (timeoutId !== null) clearTimeout(timeoutId);
       this.validateAcceptedResponse(definition, request.requestId, response);
+      if (typeof definition.selectAcceptedResult === 'function') {
+        return definition.selectAcceptedResult(response);
+      }
       return {
         requestId: response.requestId,
         ok: response.ok
       };
     }).catch(error => {
+      if (timeoutId !== null) clearTimeout(timeoutId);
       this.activeInvocations.delete(request.requestId);
       throw this.normalizeInvocationError(error, definition, request.requestId);
     });
@@ -235,22 +266,28 @@ export class Glass3Client {
           acceptedResult.toolName === definition.toolName &&
           acceptedResult.toolAction === definition.toolAction
         );
-    const validResponse = response &&
+    const validChannel = !definition.responseChannel || (
+      response && response.channel === definition.responseChannel
+    );
+    const validEnvelope = response &&
+      validChannel &&
       response.version === RPC_VERSION &&
       response.kind === 'response' &&
-      response.requestId === requestId &&
-      response.ok === true &&
-      validAcceptedResult;
+      response.requestId === requestId;
+    const validResponse = validEnvelope &&
+      response.ok === true && validAcceptedResult;
 
     if (validResponse) return;
 
-    const nativeError = response && response.error;
+    const nativeError = validEnvelope && response.ok === false
+      ? response.error
+      : null;
     throw new Glass3Error(
       nativeError && nativeError.message
         ? nativeError.message
         : `Native request was not accepted: ${definition.publicModule}.${definition.publicMethod}`,
       {
-        code: nativeError && nativeError.code
+        code: nativeError && nativeError.code !== undefined
           ? nativeError.code
           : 'NATIVE_REQUEST_NOT_ACCEPTED',
         stage: 'response',

package/sdk/core/constants.js

@@ -1,6 +1,7 @@
 export const RPC_URL = 'https://ink-host-rpc.invalid/rpc';
 export const RPC_ORIGIN = 'rokid://host-rpc';
 export const RPC_VERSION = '2.0.0';
+export const RPC_CHANNEL = 'rokid.host.rpc';
 
 export const RPC_SUCCESS_STATUS_MIN = 200;
 export const RPC_SUCCESS_STATUS_MAX = 299;

package/sdk/core/transport.js

@@ -22,10 +22,20 @@ export class HostRpcTransport {
       JSON.stringify(redactSensitiveDataForLog(request))
     );
 
-    return requestFetch(this.url, {
+    return Promise.resolve().then(() => requestFetch(this.url, {
       method: 'POST',
       headers: { 'content-type': 'application/json' },
       body: requestBody
+    })).catch(error => {
+      if (error instanceof Glass3Error) throw error;
+      throw new Glass3Error('Host RPC transport failed', {
+        code: 'TRANSPORT_ERROR',
+        stage: 'transport',
+        requestId: request.requestId,
+        namespace: request.namespace,
+        method: request.method,
+        cause: error
+      });
     }).then(response => {
       if (
         response.status < RPC_SUCCESS_STATUS_MIN ||
@@ -43,7 +53,16 @@ export class HostRpcTransport {
         );
       }
 
-      return response.json();
+      return Promise.resolve().then(() => response.json()).catch(error => {
+        throw new Glass3Error('Host RPC response is not valid JSON', {
+          code: 'TRANSPORT_INVALID_RESPONSE',
+          stage: 'transport',
+          requestId: request.requestId,
+          namespace: request.namespace,
+          method: request.method,
+          cause: error
+        });
+      });
     }).then(result => {
       console.log(
         '[glass3] Native fetch response:',

package/sdk/modules/status-bar/index.js

@@ -0,0 +1,78 @@
+import { RPC_CHANNEL } from '../../core/constants.js';
+import { Glass3Error } from '../../utils/errors.js';
+
+const STATUS_BAR_NAMESPACE = 'rokid.statusBar';
+const STATUS_BAR_TIMEOUT_MS = 5000;
+
+function createParameterError(message, method) {
+  return new Glass3Error(message, {
+    code: 'INVALID_PARAMS',
+    stage: 'params',
+    namespace: STATUS_BAR_NAMESPACE,
+    method
+  });
+}
+
+function buildSingleFieldArgs(field, type, method) {
+  return args => {
+    if (!args || typeof args !== 'object' || Array.isArray(args)) {
+      throw createParameterError(
+        `statusBar.${method} parameters must be an object`,
+        method
+      );
+    }
+
+    const fields = Object.keys(args);
+    if (fields.length !== 1 || fields[0] !== field) {
+      throw createParameterError(
+        `statusBar.${method} only supports ${field}`,
+        method
+      );
+    }
+
+    if (typeof args[field] !== type) {
+      throw createParameterError(
+        `statusBar.${method} ${field} must be a ${type}`,
+        method
+      );
+    }
+
+    return { [field]: args[field] };
+  };
+}
+
+function directParams(args) {
+  return args;
+}
+
+function selectResult(response) {
+  return response.result;
+}
+
+function createStatusBarDefinition(publicMethod, field, type) {
+  return {
+    publicModule: 'statusBar',
+    publicMethod,
+
+    namespace: STATUS_BAR_NAMESPACE,
+    method: publicMethod,
+    responseChannel: RPC_CHANNEL,
+
+    buildArgs: buildSingleFieldArgs(field, type, publicMethod),
+    buildRequestParams: directParams,
+    getTimeoutMs() {
+      return STATUS_BAR_TIMEOUT_MS;
+    },
+    isAcceptedResponseResult(result) {
+      if (!result || typeof result.updated !== 'boolean') return false;
+      return publicMethod !== 'setVisible' ||
+        typeof result.visible === 'boolean';
+    },
+    selectAcceptedResult: selectResult
+  };
+}
+
+export default [
+  createStatusBarDefinition('setTitle', 'title', 'string'),
+  createStatusBarDefinition('setVisible', 'visible', 'boolean')
+];

package/sdk/modules/status-bar/readme.md

@@ -0,0 +1,69 @@
+# Status Bar 原生状态栏
+
+`glass3.statusBar` 通过同步 HTTP response body 的 Host RPC 控制 AIX 页面顶部的
+系统状态栏。状态栏由 Native 绘制，可显示标题、时间、网络和电量；调用结果不依赖
+页面 `onMessage`。
+
+该能力只在通过外部 `OPEN_AIX_INK` 入口打开的 AIX 页面中注册。页面建立后默认隐藏
+状态栏，普通浏览器、普通 WebView 和普通 AI 卡片中调用会失败。
+
+Native 状态栏可能占用屏幕 y=0 到 y=149。保持全屏页面根节点从 y=0
+开始，只把页面内容放到 y=150 或更低位置。
+
+## API
+
+### `glass3.statusBar.setTitle({ title })`
+
+设置当前页面的状态栏标题：
+
+```js
+const result = await glass3.statusBar.setTitle({
+  title: '设备巡检'
+});
+// { updated: true }
+```
+
+- `title` 必须是字符串，SDK 不会隐式转换类型。
+- Native 会去除首尾空白，当前最多展示前 40 个字符。
+- 空字符串或全空白字符串表示清理标题。
+- 状态栏隐藏时会保存标题，并在下次显示时应用。
+
+### `glass3.statusBar.setVisible({ visible })`
+
+申请显示或重新隐藏状态栏：
+
+```js
+const result = await glass3.statusBar.setVisible({ visible: true });
+// { updated: true, visible: true }
+```
+
+`visible` 必须是 Boolean，字符串 `"true"` 和数字 `1` 均会被 SDK 拒绝。
+
+建议先设置标题，再显示状态栏：
+
+```js
+await glass3.statusBar.setTitle({ title: '设备巡检' });
+await glass3.statusBar.setVisible({ visible: true });
+```
+
+`visible: false` 会隐藏当前状态栏，但不会删除页面保存的标题。再次显示时，Native 会
+恢复此前的标题。
+
+## 返回、超时与错误
+
+两个方法都直接返回 Host RPC `result`，并严格校验响应的 `channel`、`version`、
+`kind` 和 `requestId`。每次调用的本地等待上限为 5 秒；`CALL_TIMEOUT` 只表示 SDK
+停止等待，不能据此判断 Native 一定没有执行。
+
+- 参数错误：`INVALID_PARAMS`，`stage: "params"`。
+- fetch 失败：`TRANSPORT_ERROR`，`stage: "transport"`。
+- HTTP 非 2xx：`TRANSPORT_REJECTED`，`stage: "transport"`。
+- body 不是合法 JSON：`TRANSPORT_INVALID_RESPONSE`，`stage: "transport"`。
+- Native RPC 错误：保留 Native `error.code`，`stage: "response"`。
+- 响应信封不合法：`NATIVE_REQUEST_NOT_ACCEPTED`，`stage: "response"`。
+
+## 生命周期
+
+Native 按 AIX 页面 owner 保存和回收状态栏资源。页面进入后台、释放或进程结束时，
+Native 会清理对其他页面可能产生的影响。页面可以主动调用
+`setVisible({ visible: false })`，但不需要用全局 JavaScript 状态恢复资源。

package/components/status-bar/index.ink

@@ -1,139 +0,0 @@
-<script def>
-{
-  "component": true
-}
-</script>
-
-<script setup>
-import glass3 from 'rvis-aiui-kit';
-
-function logError(error) {
-  if (error && error.code === 'CALL_DISPOSED') return;
-  console.error('[Status Bar]', error);
-}
-
-export default {
-  properties: {
-    title: {
-      type: String,
-      value: ''
-    }
-  },
-
-  data: {
-    dateText: '',
-    timeText: '',
-    batteryText: '--%',
-    active: false,
-    clockTimer: null,
-    powerObserveRequestId: ''
-  },
-
-  methods: {
-    updateTime() {
-      const now = new Date();
-      const hours = now.getHours();
-      const minutes = now.getMinutes();
-      this.setData({
-        dateText: `${now.getMonth() + 1}/${now.getDate()}`,
-        timeText: `${hours < 10 ? '0' : ''}${hours}:${minutes < 10 ? '0' : ''}${minutes}`
-      });
-    },
-
-    updateBattery(event) {
-      if (!this.data.active) return;
-      if (event.eventType === 'invalidated') {
-        this.data.powerObserveRequestId = '';
-        this.setData({ batteryText: '--%' });
-        return;
-      }
-
-      const power = event.eventType === 'snapshot'
-        ? event.snapshot && event.snapshot.power
-        : event.patch && event.patch.power;
-      if (!power) return;
-
-      this.setData({
-        batteryText: power.levelPercent === undefined
-          ? '--%'
-          : `${power.levelPercent}%`
-      });
-    },
-
-    observePower() {
-      glass3.deviceContext.observe(
-        { domains: ['power'] },
-        { onEvent: event => this.updateBattery(event) }
-      ).then(result => {
-        if (this.data.active) {
-          this.data.powerObserveRequestId = result.requestId;
-          return;
-        }
-
-        glass3.deviceContext.stopObserve({
-          requestId: result.requestId
-        }).catch(logError);
-      }).catch(logError);
-    }
-  },
-
-  lifetimes: {
-    attached() {
-      this.data.active = true;
-      this.updateTime();
-      this.data.clockTimer = setInterval(() => this.updateTime(), 1000);
-      this.observePower();
-    },
-
-    detached() {
-      this.data.active = false;
-
-      if (this.data.clockTimer !== null) {
-        clearInterval(this.data.clockTimer);
-        this.data.clockTimer = null;
-      }
-      if (this.data.powerObserveRequestId) {
-        glass3.deviceContext.stopObserve({
-          requestId: this.data.powerObserveRequestId
-        }).catch(logError);
-        this.data.powerObserveRequestId = '';
-      }
-    }
-  }
-};
-</script>
-
-<page>
-  <view class="status-bar">
-    <text class="status-text">{{ title }}</text>
-    <view class="status-right">
-      <text class="status-text">{{ dateText }}</text>
-      <text class="status-text">{{ timeText }}</text>
-      <text class="status-text">{{ batteryText }}</text>
-    </view>
-  </view>
-</page>
-
-<style>
-.status-bar {
-  display: flex;
-  flex-direction: row;
-  align-items: center;
-  justify-content: space-between;
-  width: 480px;
-  height: 20px;
-}
-
-.status-right {
-  display: flex;
-  flex-direction: row;
-  align-items: center;
-  gap: 10px;
-}
-
-.status-text {
-  color: #40ff5e;
-  font-size: 14px;
-  line-height: 20px;
-}
-</style>

package/components/status-bar/readme.md

@@ -1,45 +0,0 @@
-# Status Bar 组件
-
-标准 Glass3 HUD 状态栏，左侧显示应用标题，右侧显示本地月/日、时间和实时电量。
-
-组件会在 `attached` 时启动时钟和 `power` 订阅，在 `detached` 时清理计时器并停止订阅。
-
-## 注册与使用
-
-```json
-{
-  "usingComponents": {
-    "rvis-status-bar": "rvis-aiui-kit/status-bar"
-  }
-}
-```
-
-```html
-<rvis-status-bar title="应用名称"></rvis-status-bar>
-```
-
-属性：
-
-- `title: String`，默认 `''`，显示在状态栏左侧。
-
-组件固定为 `480px × 20px`，使用 `14px / 20px` 的绿色文本；页面负责将它放在全屏绘制区域的 `(0, 0)`。
-
-## Host 消息转发
-
-Ink 当前只把 Host 消息交给 Page，不会直接调用自定义组件的 `onMessage`。使用该组件的页面必须把消息转发到与组件共享的 `glass3` 单例：
-
-```js
-import glass3 from 'rvis-aiui-kit';
-
-export default {
-  onMessage(messageEvent) {
-    glass3.handleMessage(messageEvent);
-  },
-
-  onUnload() {
-    glass3.dispose();
-  }
-};
-```
-
-除这条 Page 级消息入口外，时间刷新、电量显示、订阅和清理逻辑均由组件管理。电量不可读时显示 `--%`。