# @akropolys/kiku 中文文档

规范地址：https://npmcn.com/package/%40akropolys/kiku/

版本：2\.2\.44
npm 元数据更新时间：2026-11-02T11:28:06.418Z
中文译文更新时间：2026-11-06T04:32:50.987Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40akropolys/kiku
原文对照：https://npmcn.com/package/%40akropolys/kiku/?lang=original
项目主页：https://akropolys.io/
源码仓库：https://github.com/akropolys/sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.1 MB，17 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=17，react-dom \>=17，@akropolys/sdk ^2\.0\.8
- 首次发布：2026-06-04T13:23:27.008Z
- 最新版本发布：2026-11-02T11:28:06.235Z
- 近 30 天下载量：5138（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：101（近 12 个月 101 个）

## 中文简介

活人网实时对话层.

## 安装

```sh
npm install @akropolys/kiku
```

也可以使用：`pnpm add @akropolys/kiku`、`yarn add @akropolys/kiku`、`bun add @akropolys/kiku`

## README

# @akropolys/kiku (英语)

聊天、搜索、语音和图片输入 Kiku 将访问者连接到您在 Akropolys 中配置的内容和 API 动作 。 对于React和Next.js,使用下面的React包. 对于其他网站,使用CDN嵌入;在喜欢脚本集成时,它也在React中工作.

[![npm](https://img.shields.io/npm/v/@akropolys/kiku?color=orange)](https://www.npmjs.com/package/@akropolys/kiku) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/types-included-blue)](https://www.typescriptlang.org/)

## Java 脚本嵌入

将 Kiku 添加到任何已发布的 CDN 脚本网站上 :

```html
<script
  src="https://cdn.akropolys.cloud/kiku/2.2.44/kiku.js"
  data-site-id="YOUR_SITE_ID"
  data-api-token="YOUR_PUBLIC_BROWSER_TOKEN"
  data-label="Ask Kiku"
  data-vision="true"
  defer
></script>
```

嵌入式包括自己的回放运行时间,样式,和起放. 您的网站不需要 React 安装或提供者, 包括当它使用 React 或 Next.js 时. 见 [嵌入式导线](https://github.com/akropolys/sdk/blob/HEAD/packages/kiku/EMBED.md) 用于配置、摄入和自宿.

## 安装

推荐 React 和 Next.js 应用程序 :

```bash
npm install @akropolys/kiku@2.2.44 @akropolys/sdk@2.0.8
```

这个包集成需要回放和回放DOM 17或更后.

## 反应和下一个.js

```tsx
'use client';

import { AkropolysProvider } from '@akropolys/sdk';
import { KikuButton } from '@akropolys/kiku';
import '@akropolys/kiku/styles.css';

export default function WebsiteAssistant() {
  return (
    <AkropolysProvider
      siteId={process.env.NEXT_PUBLIC_AKROPOLYS_SITE_ID!}
      apiUrl={process.env.NEXT_PUBLIC_AKROPOLYS_API_URL!}
      apiToken={process.env.NEXT_PUBLIC_AKROPOLYS_API_TOKEN!}
    >
      <KikuButton label="Ask us" enableVoice enableVision />
    </AkropolysProvider>
  );
}
```

在您的应用程序或布局中挂载组件一次 。 在 Next.js App 路由器中,导入您根版式中的样式表, 如果这是您的项目保存全局 CSS 的地方 .

使用您的网站的公共浏览器符号 。 在您的服务器上保留私钥和服务器证书 。 为您在 Shell 的网站启用相应的语音和视觉特性 .

## 来宾能做的

-   询问您的内容并比较表格中的记录 .
-   使用现场声音说话,或在谈话中包括相片.
-   开源记录并保存后期的项目 .
-   长压或右键点击消息访问其动作.
-   使用翻译控件,从右到左的布局,以及聊天主题.

## 构成部分

| 构成部分 | 目的 |
| --- | --- |
| `KikuButton` | 一个打开聊天窗口的发射装置. |
| `SearchBar` | 有流出结果的内置搜索. |

两个部件都使用 `AkropolysProvider` 从 `@akropolys/sdk`。 。 。 .

## 自定义发射器

```tsx
<KikuButton
  label="Ask about this property"
  title="Your assistant"
  placeholder="What would you like to know?"
  chips={['Show available properties', 'Compare my options']}
  theme="dark"
  enableVoice
  enableVision
/>
```

`theme` 接受 `light`, (中文(简体) ), `dark`,或一个 `AkropolysTheme` 对象从 `@akropolys/sdk`启用 `onSelectSource` 处理选择源记录的访客.

## 内容和行动

给每个目录记录一个稳定的顶层 `id`中的网页链接 `fields.url` 是可选的; Kiku 可以在没有记录的情况下显示和保存记录。 见 [SDK 摄取指南](https://github.com/akropolys/sdk/blob/HEAD/packages/sdk/README.md#batch-ingestion-client)。 。 。 .

在 Shell 中配置动作端点、 方法和请求字段 。 部件在聊天和语音中从访客浏览器中调用您的 API 。 Cookie认证自动工作. 对于办事员、 Auth0 或 Supabase 无记名 API, 添加一个选项, 例如 `actionAuth: { provider: "supabase", client: supabase }` 改为 `Kiku.mount(...)`,或使用 `actionAuth` 在您现有的反应提供者上安装道具 。 已存在的 Auth 客户端处理符号更新; Kiku 在内部添加信头 。 CDN嵌入版不需要应用程序包装. 您的 API 验证权限并进行操作 。 见 [站点动作指南](https://akropolys.cloud/docs/actions/)。 。 。 .

## 链接

-   [阿克罗波利斯](https://akropolys.cloud/)
-   [源代码](https://github.com/akropolys/sdk)
-   [JavaScript 嵌入向导](https://github.com/akropolys/sdk/blob/HEAD/packages/kiku/EMBED.md)
-   [无头 SDK](https://www.npmjs.com/package/@akropolys/sdk)

## 许可证

麻省理工学院 [阿克罗波利斯](https://akropolys.cloud/)

## 常见问题

### @akropolys/kiku 是什么？

活人网实时对话层\.

### 如何安装 @akropolys/kiku？

在项目目录运行 npm install @akropolys/kiku，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=17）、react-dom（\>=17）、@akropolys/sdk（^2\.0\.8）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @akropolys/kiku 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @akropolys/kiku 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @akropolys/kiku 可以商用吗？

@akropolys/kiku 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @akropolys/kiku 的下载量有多少？

根据 npm 官方下载统计，@akropolys/kiku 在 2026/10/06 – 2026/11/04 这 30 天内被下载 5,138 次，日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @akropolys/kiku 还在维护吗？

最新版本 2\.2\.44 发布于 2026/11/02（3 天前）；至今共发布 101 个版本，其中过去 12 个月发布了 101 个；首次发布于 2026/06/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。