# @a2ui/lit 中文文档
规范地址：https://npmcn.com/package/%40a2ui/lit/
版本：0\.15\.0
npm 元数据更新时间：2026-11-02T02:43:38.101Z
中文译文更新时间：2026-11-05T17:11:30.328Z
软件包许可：Apache-2\.0
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40a2ui/lit
原文对照：https://npmcn.com/package/%40a2ui/lit/?lang=original
项目主页：https://a2ui.org/
源码仓库：https://github.com/a2ui-project/a2ui
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1 MB，245 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：@a2ui/markdown-it ^0\.2\.2
- 首次发布：2025-12-16T00:21:07.390Z
- 最新版本发布：2026-11-02T02:43:37.922Z
- 近 30 天下载量：933571（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）
## 中文简介
A2UI 图书馆
## 安装
```sh
npm install @a2ui/lit
```
也可以使用：`pnpm add @a2ui/lit`、`yarn add @a2ui/lit`、`bun add @a2ui/lit`
## README
# @ a2ui/ lit (英语)
升成像器,用于 [A2UI (英语)](https://a2ui.org/) (代理用户界面) - 启用 AI代理通过声明JSON生成丰富而互动的用户界面.
包含一个基本的目录执行,以帮助您立即启动.
附加自定义组件可以被推断为类型安全属性 从 [佐德语Name](https://zod.dev/) 计划, 可以添加到您的定制目录中 用于对生成代码的总控制.
## 安装
```bash
yarn add @a2ui/lit @a2ui/web_core
```
## 协议版本
A2UI支持多个协议版本. 关于新项目,建议 使用该 **页:1** 协议.
要使用 v0. 9 执行, 从版本路径导入 :
```typescript
import {A2uiSurface, basicCatalog} from '@a2ui/lit/v0_9';
```
## 快速启动
立特制造器与 `MessageProcessor` 从 `@a2ui/web_core`。 。 。 .
```typescript
import {LitElement, html} from 'lit';
import {customElement, state} from 'lit/decorators.js';
import {MessageProcessor} from '@a2ui/web_core/v0_9';
import {A2uiSurface, basicCatalog} from '@a2ui/lit/v0_9';
@customElement('my-app')
export class MyApp extends LitElement {
private processor = new MessageProcessor([basicCatalog]);
@state()
private surface: any;
connectedCallback() {
super.connectedCallback();
// Listen for surface creation
this.processor.onSurfaceCreated(s => {
if (s.id === 'main-chat') {
this.surface = s;
}
});
// The message objects should come from your agent
this.processor.processMessages([
{
version: 'v0.9',
createSurface: {
surfaceId: 'main-chat',
catalogId: basicCatalog.id,
},
},
]);
}
render() {
return html`
${this.surface
? html`
`
: html`
Initializing Agent UI...
`}