>;
};
```
#### 使用示例
```tsx
const send = async () => {
try {
// 需要先获取 AIStreamSession 对象
const streamSession = agent.session.get('AIStream.streamSession');
const result = sendBlocksToAIStream({
blocks: [{ type: 'text', text: 'hello' }],
session: streamSession,
signal: new AbortController().signal,
});
// 获取发送后的元数据
const meta = await result.metaPromise;
// 获取流式消息
const parts = result.response.parts();
for await (const part of parts) {
console.log('part', part);
}
} catch (error) {
console.error('Send message failed:', error);
// 错误处理逻辑
}
};
```
### 媒体文件相关函数
`uploadMedia`、`uploadVideo`、`uploadImage` 用于上传媒体文件，带缓存
`isFullLink` 用于判断是否是 http(s) 协议开头的链接
`parseCloudKey` 用于解析 URL 中云存储的 key
`isLinkExpired` 用于判断链接是否过期
`getUrlByCloudKey` 从缓存中获取云存储的下载签名 URL，如果没有则返回 `undefined`
`setUrlByCloudKey` 设置云存储的下载签名 URL 到缓存中
`resetUrlByCloudKey` 重置云存储的下载签名 URL 缓存
`chooseImage`、`chooseVideo` 选择媒体文件
```tsx
import { useEffect } from 'react';
async function getPictureList() {
// 从云端拉取用户私有的图片列表
const list = await pictureListRequest();
// 这样设置到缓存里，下次就不用再请求了
for (const item of list) {
setUrlByCloudKey(item.path, item.displayUrl);
}
}
```
# t-agent-ui-ray
t-agent-ui-ray 是一个基于 ray 的 UI 组件库，包含了一些常用的对话界面组件，例如消息列表、消息输入框等。
## 安装
```shell
yarn add @ray-js/t-agent-ui-ray
```
## 使用
```tsx
import React from 'react';
import { View } from '@ray-js/components';
import {
ChatContainer,
defaultRenderOptions,
MessageActionBar,
MessageInput,
MessageList,
} from '@ray-js/t-agent-ui-ray';
// createAgent 实现参见 t-agent 的使用示例
import { createAgent } from './createAgent';
const renderOptions = {
...defaultRenderOptions,
};
export default function ChatPage() {
// createAgent 必须返回一个 ChatAgent 应用过 withUI、withAIStream 插件的实例
return (
);
}
```
## 组件
### ChatContainer
对话容器，用于包裹消息列表和消息输入框，提供了 `ChatAgent` 的上下文
props:
- `className` 容器的类名
- `createAgent` 创建 `ChatAgent` 的函数，在 `ChatContainer` 挂载后会调用这个函数创建 `ChatAgent` 实例
- `agentRef` 用于获取 `ChatAgent` 实例的 ref
- `renderOptions` 渲染选项，用于决定 `MessageList` 中各个元素的渲染方式，具体参照下面的 renderOptions 自定义渲染 部分
- `renderTileAs` 该函数决定如何在消息中渲染 tile
- `customBlockTypes` 自定义 block 类型，只有在这里注册的 block 类型才会被 `renderCustomBlockAs` 渲染
- `renderCustomBlockAs` 该函数决定如何在 markdown 气泡消息中渲染自定义 block，默认支持 `echarts`
- `renderCardAs` 该函数决定如何在消息中渲染卡片，一般不需要自定义此项
- `renderLongPressAs` **(0.2.x 新增)** 该函数决定如何渲染长按菜单，可以自定义长按菜单的样式和行为
- `formatErrorMessageAs` **(0.2.x 新增)** 该函数决定如何格式化错误消息，可以根据错误代码返回用户友好的错误信息
- `customCardMap` 自定义卡片映射，无需修改 `renderCardAs` 函数，只需要在这里注册卡片类型和对应的组件
- `getStaticResourceBizType` 获取静态资源 `bizType`，用于获取静态资源
### MessageList
消息列表，用于展示消息。在 0.2.x 版本中集成了 LazyScrollView 组件，提供了更好的性能优化。
**Props**：
- `className` 列表的类名
- `roleSide` 消息角色的对齐方式，默认 `{ user: 'end', assistant: 'start' }`
**LazyScrollView 集成（0.2.x 新增）**：
MessageList 内部使用了 LazyScrollView 组件来优化大量消息的渲染性能：
- **懒加载渲染**：只渲染可见区域内的消息，大幅提升性能
- **高度自适应**：自动计算消息高度，支持动态内容
- **notifyHeightChanged()**：当消息内容发生变化时，自动通知高度更新
组件会自动处理以下场景：
- 保证最下面 10 条消息始终渲染，避免滚动到底部时出现白屏
- 消息高度变化时自动更新滚动位置
- 支持滚动到底部的动画效果
### MessageInput
消息输入框，用于输入消息、上传附件、ASR 语音识别
props:
- `className` 输入框的类名
- `placeholder` 输入框的占位符
- `placeholderStyle` 输入框 placeholder 的样式
- `renderTop` 用于渲染输入框上方的内容
- `style` 输入框容器样式
- `attachment` 是否启用附件上传，或传入 `{ image, video, imageCount, videoCount }` 精细控制
- `maxTextLength` 文本最大长度，默认 200
- `maxAudioMs` 录音最大时长
- `onStateChange` 输入框状态变化回调，状态值见 `MessageInputState`
- `amplitudeCount` 语音波形振幅采样数量
`MessageInput` 当前默认导出的是 `MessageInputAIStream`，适用于已接入 `withAIStream` 的场景。
### MessageActionBar（0.2.x 新增）
消息操作栏组件，用于多选消息时显示操作按钮，支持删除选中消息和清空历史记录。
**Props**：
无需传入任何 props，组件会自动根据多选状态显示和隐藏
**功能**：
- **返回按钮**：退出多选模式
- **清空历史按钮**：清空所有历史消息，会调用 `onClearHistory` Hook
- **删除选中按钮**：删除当前选中的消息，当没有选中消息时按钮会被禁用
**工作原理**：
MessageActionBar 组件会监听会话数据中的 `UIRay.multiSelect.show` 状态来决定是否显示。当用户长按消息选择"多选"时，该组件会自动显示。
**使用示例**：
```tsx
export default function ChatPage() {
return (
);
}
```
### PrivateImage
私有图片组件，用于展示私有图片，props 同 Image，增加 bizType 参数
### LazyScrollView
懒加载滚动视图组件，用于优化长列表性能，自动管理可见区域的渲染
主要特性：
- 虚拟滚动：只渲染可见区域的元素
- 高度缓存：自动缓存元素高度，提升滚动性能
- 动态加载：根据滚动位置动态显示/隐藏元素
- `notifyHeightChanged()` 功能：当元素高度发生变化时，可以调用此方法通知滚动视图更新
使用说明：
LazyScrollView 主要在 MessageList 内部使用，开发者一般不需要直接使用。如果需要在消息中动态改变高度，可以通过 `notifyHeightChanged` 参数来通知高度变化：
```tsx
// 在 tile 组件中使用
const MyTile = ({ notifyHeightChanged }) => {
const [expanded, setExpanded] = useState(false);
const handleToggle = () => {
setExpanded(!expanded);
// 通知高度变化
notifyHeightChanged();
};
return (
{expanded && 详细内容...}
);
};
```
### 内置 tile 组件
- bubble 气泡
- buttons 按钮组
- card 卡片
- divider 分隔线
- documents 关联文档
- executeCard 执行结果卡片
- file 文件
- image 图片
- operateCard 操作结果卡片
- recommendations 推荐行动
- text 文本，包含 markdown 支持
- time 时间标识
- tip 提示
- video 视频
- workflow 工作选项
## React Hooks
### useChatAgent
在 `ChatContainer` 上下文里取得 `ChatAgent` 实例
### useAgentMessage
在 `ChatContainer` 上下文里取得 `messages: ChatMessageObject[]` 列表
### useRenderOptions
在 `ChatContainer` 上下文里取得 `renderOptions` 对象
### useOnEvent
在 `ChatContainer` 上下文里注册 ui 事件，在组件卸载时自动取消注册
```tsx
import { useOnEvent } from '@ray-js/t-agent-ui-ray';
const MyComponent = () => {
useOnEvent('scrollToBottom', payload => {
console.log('scroll to bottom', payload.animation);
});
return My Component
;
};
```
### useEmitEvent
在 `ChatContainer` 上下文里触发 ui 事件
```tsx
import { useEmitEvent } from '@ray-js/t-agent-ui-ray';
const MyComponent = () => {
const emitEvent = useEmitEvent();
const scroll = () => {
emitEvent('scrollToBottom', { animation: false });
};
return ;
};
```
### useTileProps
在 tile 组件里取得 `TileProps` 对象，如果是 tile，可以直接从 props 中获取
```tsx
import { useTileProps } from '@ray-js/t-agent-ui-ray';
const MyTilePart = () => {
const { message, agent, tile, emitTileEvent } = useTileProps();
return My Tile
;
};
```
### useSendAction
发送一个 TTTAction。
如果当前组件位于 tile 或 card 内部，会优先走 `emitTileEvent`。
如果当前组件只是 `ChatContainer` 下的普通子组件，则会退化为触发 UI 事件 `runTTTAction`。
```tsx
import { useSendAction } from '@ray-js/t-agent-ui-ray';
const ActionPanel = () => {
const sendAction = useSendAction();
const handleClick = () => {
sendAction({
type: 'sendMessage',
blocks: [{ type: 'text', text: 'hello' }],
sendImmediately: true,
});
};
return ;
};
```
### useTranslate
获取国际化翻译函数，用于翻译界面文本，提供了完整的多语言支持。
```tsx
import { useTranslate } from '@ray-js/t-agent-ui-ray';
const MyComponent = () => {
const t = useTranslate();
return (
{t('t-agent.message.action.copy')} {/* 输出: "复制消息" */}
{t('t-agent.message.delete.title')} {/* 输出: "删除消息" */}
{t('t-agent.message.clear-history.title')} {/* 输出: "清空历史" */}
);
};
```
**支持的语言**：
内置的多语言支持包括：
- **中文简体** (`zh-Hans`)：简体中文
- **中文繁体** (`zh-Hant`)：繁体中文
- **英文** (`en`)：英语
- **日文** (`ja`)：日语
- **德文** (`de`)：德语
- **法文** (`fr`)：法语
- **西班牙文** (`es`)：西班牙语
- **意大利文** (`it`)：意大利语
系统会根据用户的系统语言自动选择对应的翻译，如果不支持当前语言则回退到英文。
## renderOptions 自定义渲染
### 替换或新增 tile
如果你需要将某个 tile 替换成自己的实现，或者新增一个 tile，可以覆写 `renderTileAs`，例如：
```tsx
import { ImageTileData } from '@ray-js/t-agent';
import { Image } from '@ray-js/ray';
import { defaultRenderOptions, TileProps } from '@ray-js/t-agent-ui-ray';
function MyImageTile(props: TileProps) {
// 实现自己的 ImageTile
return ;
}
const renderOptions = {
...defaultRenderOptions,
renderTileAs: (props: TileProps) => {
if (props.tile.type === 'image') {
return ;
}
// 保持默认行为
return defaultRenderOptions.renderTileAs(props);
},
};
```
### 自定义长按菜单（0.2.x 新增）
如果你需要自定义长按菜单的样式或行为，可以覆写 `renderLongPressAs` 函数，例如：
```tsx
import { defaultRenderOptions, LongPressResult } from '@ray-js/t-agent-ui-ray';
import { View, Button } from '@ray-js/ray';
const renderOptions = {
...defaultRenderOptions,
renderLongPressAs: (res: LongPressResult) => {
if (!res.menuProps.showActionMenu) {
return null;
}
return (
{res.menuProps.menuItems.map(item => (
))}
);
},
};
```
长按菜单功能包括：
- **复制消息**：复制文本内容到剪贴板
- **删除消息**：删除单条消息
- **多选**：进入多选模式，配合 MessageActionBar 使用
- **喜欢/不喜欢**：对助手消息进行反馈（仅对 assistant 角色消息可用）
### 自定义错误消息格式化（0.2.x 新增）
如果你需要自定义错误消息的显示格式，可以覆写 `formatErrorMessageAs` 函数，例如：
```tsx
import { defaultRenderOptions } from '@ray-js/t-agent-ui-ray';
const renderOptions = {
...defaultRenderOptions,
formatErrorMessageAs: (message: string, code: string | undefined) => {
// 根据错误代码返回自定义的错误消息
if (code === 'network-offline') {
return '网络连接异常，请检查您的网络设置';
}
if (code === 'timeout') {
return '请求超时，请稍后重试';
}
// 使用默认的错误消息
return message;
},
};
```
内置支持的错误代码包括：
- `network-offline`：网络已断开
- `timeout`：发送超时
- `invalid-params`：无效参数
- `session-create-failed`：连接失败
- `connection-closed`：连接已关闭
- 等等
### 自定义卡片
卡片分为三类：内置卡片（buildIn）、自定义卡片（custom）、低代码卡片（lowCode），目前低代码卡片还在开发中，自定义卡片可以通过 `customCardMap` 注册自己的卡片组件。
卡片的数据结构如下：
```tsx
enum ChatCardType {
CUSTOM = 'custom', // 可供业务方使用的自定义卡片
BUILD_IN = 'buildIn', // 平台内置的卡片
LOW_CODE = 'lowCode', // 低代码卡片
}
interface ChatCardObject {
cardCode: string; // 唯一标识卡片的 code
cardType: ChatCardType; // 卡片类型
cardData: T; // 卡片携带的数据
}
```
注册一个自定义卡片：
```tsx
import {
ChatCardObject,
ChatCardType,
defaultRenderOptions,
useTileProps,
useSendAction,
} from '@ray-js/t-agent-ui-ray';
import { View, Text, Button } from '@ray-js/ray';
const MyCard: ChatCardComponent<{ title: string }, { clicked: boolean }> = props => {
// 如果你需要拿到 agent、message、tile、emitTileEvent 等属性，可以使用 useTileProps
const { message, agent, tile, emitTileEvent } = useTileProps();
const { card, setCardState } = props;
const { cardData, cardState, cardCode } = card as ChatCardObject<{ title: string }>;
// 如果你需要发送一个 TTTAction，可以使用 useSendAction
const sendAction = useSendAction();
return (
My Card
);
};
const renderOptions = {
...defaultRenderOptions,
customCardMap: {
myCard: MyCard,
},
};
```
### 自定义 block
在 `TextTile` 里的 markdown 渲染器是支持自定义 block 的，你可以通过 `customBlockTypes` 和 `renderCustomBlockAs` 来注册和渲染自定义 block。
block 的数据结构如下：
```tsx
export interface MarkdownBlock {
id: string;
type: string;
children: string; // block 里的内容
}
```
注册一个自定义 block：
```tsx
import { defaultRenderOptions, MarkdownBlock } from '@ray-js/t-agent-ui-ray';
import { View, Text } from '@ray-js/ray';
const renderOptions = {
...defaultRenderOptions,
customBlockTypes: ['my-block'],
renderCustomBlockAs: (block: MarkdownBlock) => {
if (block.type === 'my-block') {
return (
This is My Block
{block.children}
);
}
return defaultRenderOptions.renderCustomBlockAs(props);
},
};
```
假设 AI 给你发了 markdown 文本，里面有一个类型是 `my-block` 的 `fence`，在上面我们注册了 `my-block`，那这个 `fence` 可以当做自定义 block。
````markdown
这是我的自定义 block！
```my-block
Hello, world!
```
````
以下 fence 没有注册过，不会被渲染成自定义 block，仅当做普通的代码块渲染。
```javascript
console.log('Hello, world!');
```
渲染结果如下：
这是我的自定义 block！
This is My Block
Hello, world!
以下 fence 没有注册过，不会被渲染成自定义 block，仅当做普通的代码块渲染。
console.log('Hello, world!');
### getStaticResourceBizType
如果你的静态资源需要带上 `bizType`，可以通过 `getStaticResourceBizType` 来获取 `bizType`。
```tsx
import { defaultRenderOptions } from '@ray-js/t-agent-ui-ray';
const renderOptions = {
...defaultRenderOptions,
getStaticResourceBizType: (src: string, scene: string) => 'bizType',
};
```
针对不同的场景，你可能需要不同的 `bizType`，你可以根据 `src` 和 `scene` 来返回不同的 `bizType`。
内置的 `scene` 有以下几种：
- `image:view` 图片查看
- `image:upload` 图片上传
- `video:view` 视频查看
- `video:upload` 视频上传
- `videoThumb:view` 视频缩略图查看
- `videoThumb:upload` 视频缩略图上传
### 自定义多语言
如果你需要自定义 t-agent 里的多语言，可以覆写 `i18nTranslate` 函数，例如：
```tsx
import { defaultRenderOptions } from '@ray-js/t-agent-ui-ray';
const renderOptions = {
...defaultRenderOptions,
i18nTranslate: (key: string) => {
if (key === 'hello') {
return '你好';
}
// 使用默认的多语言
return I18n.t(key);
},
};
```
以下是内置的多语言 key：
| key | 使用场景 | 含义 |
| ---------------------------------------------------------- | --------------------------- | ---------------------------------------- |
| t-agent.build-in.button.create_scene_manually | ButtonTile 内置按钮 | 手动创建场景 |
| t-agent.build-in.button.enter_home_manage | ButtonTile 内置按钮 | 进入"家庭管理" |
| t-agent.build-in.button.enter_room_manage | ButtonTile 内置按钮 | 进入"房间管理" |
| t-agent.build-in.button.enter_alarm_message | ButtonTile 内置按钮 | 进入"告警消息列表" |
| t-agent.build-in.button.enter_home_message | ButtonTile 内置按钮 | 进入"家庭消息列表" |
| t-agent.build-in.button.enter_bulletin | ButtonTile 内置按钮 | 进入"通知消息列表" |
| t-agent.build-in.button.enter_notification_setting | ButtonTile 内置按钮 | 进入"消息推送设置" |
| t-agent.build-in.button.enter_personal_information | ButtonTile 内置按钮 | 进入"个人资料" |
| t-agent.build-in.button.enter_account_security | ButtonTile 内置按钮 | 进入"账号与安全" |
| t-agent.build-in.button.enter_setting | ButtonTile 内置按钮 | 进入"通用设置" |
| t-agent.build-in.button.enter_paring | ButtonTile 内置按钮 | 进入"设备配网" |
| t-agent.build-in.button.enter_share_device | ButtonTile 内置按钮 | 进入"设备分享" |
| t-agent.build-in.button.enter_faq_feedback | ButtonTile 内置按钮 | 进入"常见问题与反馈" |
| t-agent.build-in.button.questionnaire_take | ButtonTile 内置按钮 | 填写问卷 |
| t-agent.build-in.button.set_home_location | ButtonTile 内置按钮 | 设置家庭位置 |
| t-agent.input.voice.require-permission | MessageInput 切换语音输入 | 需要授权录音权限 |
| t-agent.input.upload.failed | MessageInput 上传文件 | 文件上传失败 |
| t-agent.input.asr.oninput.text.top | MessageInput ASR 语音输入 | 我在听，请说话 |
| t-agent.input.asr.oninput.text.center | MessageInput ASR 语音输入 | 松开发送，上划取消 |
| t-agent.input.asr.ptt | MessageInput ASR 语音输入 | 按住说话 |
| t-agent.input.asr.error.too-short | MessageInput ASR 错误 | 说话时间太短 |
| t-agent.input.asr.error.empty | MessageInput ASR 错误 | 未能从语音中识别到文字 |
| t-agent.input.asr.error.unknown | MessageInput ASR 错误 | 语音识别失败 |
| t-agent.input.asr.error.timeout | MessageInput ASR 错误 | 语音识别已达时长限制，将直接发送 |
| t-agent.input.upload.source-type.camera | MessageInput 上传文件 | 拍照 |
| t-agent.input.upload.source-type.camera.require-permission | MessageInput 上传文件 | 拍照需要摄像头权限，请在设置中开启 |
| t-agent.input.upload.source-type.album | MessageInput 上传文件 | 从相册中选择 |
| t-agent.input.upload.source-type.album.require-permission | MessageInput 上传文件 | 从相册中选择需要相册权限，请在设置中开启 |
| t-agent.input.upload.image.max-reached | MessageInput 上传文件 | 已达到图片上传上限 |
| t-agent.input.upload.video.max-reached | MessageInput 上传文件 | 已达到视频上传上限 |
| t-agent.file-tile.unknown-filename | FileTile 文件显示 | 文件 |
| t-agent.message.feedback.success | BubbleTile 消息评价 | 反馈成功 |
| t-agent.message.bubble.aborted | BubbleTile 消息 | 用户中断 |
| t-agent.message.action.copy | BubbleTile 长按菜单 | 复制消息 |
| t-agent.message.action.delete | BubbleTile 长按菜单 | 删除消息 |
| t-agent.message.action.multi-select | BubbleTile 长按菜单 | 多选 |
| t-agent.message.action.like | BubbleTile 长按菜单 | 喜欢消息 |
| t-agent.message.action.unlike | BubbleTile 长按菜单 | 不喜欢消息 |
| t-agent.message.copy.success | BubbleTile 复制成功 | 复制成功 |
| t-agent.message.delete.success | BubbleTile 删除成功 | 删除成功 |
| t-agent.message.like.success | BubbleTile 反馈 | 点赞成功 |
| t-agent.message.unlike.success | BubbleTile 反馈 | 取消点赞成功 |
| t-agent.message.delete.title | BubbleTile 删除消息弹窗标题 | 删除消息 |
| t-agent.message.delete.content | BubbleTile 删除消息弹窗内容 | 确定要删除这条消息吗？ |
| t-agent.message.delete.confirm | BubbleTile 删除消息弹窗确认 | 确认 |
| t-agent.message.delete.cancel | BubbleTile 删除消息弹窗取消 | 取消 |
| t-agent.message.clear-history.title | MessageActionBar 清空历史 | 清空历史 |
| t-agent.message.clear-history.content | MessageActionBar 清空历史 | 确定要清空历史吗？ |
| t-agent.message.clear-history.button | MessageActionBar 清空历史 | 清空历史 |
| t-agent.message.multi-select-delete.title | MessageActionBar 多选删除 | 删除选中消息 |
| t-agent.message.multi-select-delete.content | MessageActionBar 多选删除 | 确定要删除这些选中的消息吗？ |
| t-agent.execute-card-tile.execution.success | ExecuteCardTile 执行结果 | 执行成功 |
| t-agent.execute-card-tile.execution.failed | ExecuteCardTile 执行结果 | 执行失败 |
| t-agent.execute-card-tile.scene.invalid | ExecuteCardTile 场景状态 | 场景失效 |
| t-agent.execute-card-tile.delete | ExecuteCardTile 按钮 | 删除 |
| t-agent.execute-card-tile.execute | ExecuteCardTile 按钮 | 执行 |
| t-agent.execute-card-tile.switch.scene.state | ExecuteCardTile 操作 | 切换场景状态 |
| t-agent.operate-card-tile.open.device.failed | OperateCardTile 操作结果 | 打开设备失败 |
| t-agent.operate-card-tile.open.scene.failed | OperateCardTile 操作结果 | 打开场景失败 |
| t-agent.operate-card-tile.operation.impact | OperateCardTile 标题 | 本次操作影响： |
| t-agent.operate-card-tile.hide.details | OperateCardTile 按钮 | 收起详情 |
| t-agent.operate-card-tile.view.details | OperateCardTile 按钮 | 查看详情 |
| t-agent.operate-card-tile.device.move.desc | OperateCardTile 设备移动 | 设备"{device}"移动到"{room}" |
| t-agent.operate-card-tile.device.rename.desc | OperateCardTile 设备重命名 | 设备"{oldName}"改名"{newName}" |
| t-agent.operate-card-tile.device.count | OperateCardTile 设备计数 | {count}个设备 |
| t-agent.operate-card-tile.scene.count | OperateCardTile 场景计数 | {count}个场景 |
| t-agent.operate-card-tile.home.count | OperateCardTile 家庭计数 | {count}个家庭 |
| t-agent.operate-card-tile.room.count | OperateCardTile 房间计数 | {count}个房间 |
| t-agent.operate-card-tile.group.count | OperateCardTile 群组计数 | {count}个群组 |
| t-agent.operate-card-tile.description.format | OperateCardTile 描述格式 | {items}。 |
| t-agent.operate-card-tile.description.separator | OperateCardTile 描述分隔符 | ， |
| t-agent.expand.tab.device | ExpandTile 标签页 | 设备 |
| t-agent.expand.tab.scene | ExpandTile 标签页 | 场景 |
| t-agent.expand.tab.more | ExpandTile 标签页 | 其他 |
| t-agent.expand.execution.success | ExpandTile 执行结果 | 执行成功 |
| t-agent.expand.execution.failed | ExpandTile 执行结果 | 执行失败 |
| t-agent.expand.device.rename | ExpandTile 设备重命名 | {oldName}改名成{newName} |
| t-agent.expand.scene.rename | ExpandTile 场景重命名 | {oldName}改名成{newName} |
| t-agent.expand.scene.one-click | ExpandTile 场景类型 | 一键执行 |
| t-agent.expand.scene.auto | ExpandTile 场景类型 | 自动执行 |
| t-agent.expand.no.details | ExpandTile 详情显示 | 没有可显示的详情内容 |
| t-agent.error.unknown-error | 错误提示 | 未知错误 |
| t-agent.error.network-offline | 错误提示 | 网络已断开，请检查网络连接 |
| t-agent.error.invalid-params | 错误提示 | 无效参数，请重试 |
| t-agent.error.session-create-failed | 错误提示 | 连接失败，请重试 |
| t-agent.error.connection-closed | 错误提示 | 连接已关闭，请重试 |
| t-agent.error.event-exists | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.event-disposed | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.event-closed | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.event-aborted | 错误提示 | 消息已中断 |
| t-agent.error.event-write-failed | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.event-no-data-code | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.stream-exists | 错误提示 | 消息发送异常，请稍后再试 |
| t-agent.error.timeout | 错误提示 | 发送超时 |
| t-agent.error.asr-empty | 错误提示 | 语音识别结果为空 |