# @dori-ai/dori-pdp-widget 中文文档

规范地址：https://npmcn.com/package/%40dori-ai/dori-pdp-widget/

版本：0\.6\.102
npm 元数据更新时间：2026-11-13T18:42:18.470Z
中文译文更新时间：2026-11-13T18:46:05.791Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40dori-ai/dori-pdp-widget
原文对照：https://npmcn.com/package/%40dori-ai/dori-pdp-widget/?lang=original
项目主页：https://github.com/DoriService/dori-pdp-widget#readme
源码仓库：https://github.com/DoriService/dori-pdp-widget

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

- 包体积（解压后）：2.3 MB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-03-28T07:32:18.102Z
- 最新版本发布：2026-11-13T18:42:18.076Z
- 近 30 天下载量：10016（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：276（近 12 个月 276 个）

## 中文简介

由React和Chakra UI所建的现代化,反应快的聊天部件,旨在无缝地融入任何网站. 该部件提供一种具有电子商务能力的AI动力聊天体验,适合客户支持和销售援助.

## 安装

```sh
npm install @dori-ai/dori-pdp-widget
```

也可以使用：`pnpm add @dori-ai/dori-pdp-widget`、`yarn add @dori-ai/dori-pdp-widget`、`bun add @dori-ai/dori-pdp-widget`

## README

# MoriChat 部件

由React和Chakra UI所建的现代化,反应快的聊天部件,旨在无缝地融入任何网站. 该部件提供一种具有电子商务能力的AI动力聊天体验,适合客户支持和销售援助.

## \* 特性

-   **AI 权力聊天**:具有自然语言处理的智能对话能力
-   **电子商务一体化**:产品建议、购物车和离职流动
-   **响应设计**: 对所有设备起作用的移动第一方法
-   **波斯语/法西语支助**: 有波斯语UI元素的完全RTL支持
-   **可自定义**: 易于自定义颜色、品牌和行为
-   **阴影DOM**: 与网站不相冲突的孤立风格
-   **类型脚本**: 以类型脚本构建,以获得更好的发展经验

## \* 安装

### 快速启动

将此 HTML 结构添加到您的页面 :

```html
<div id="dori-react-widget-host"></div>
<script
  id="dori-react-widget"
  data-sharing-id="your-sharing-id"
  src="https://cdn.jsdelivr.net/npm/mori-chat-widget@latest/dist/widget.js"
></script>
```

## 🎨自定义

### 样式

部件在保持自己的身份的同时会自动适应您网站的设计. 您可以自定义 :

-   **颜色**: 主色和口音颜色
-   **标记**: 日志和公司信息
-   **信件**: 欢迎文本和默认回复
-   **行为**: 聊天流和互动模式

## 发展

### 地方发展

1.  清除仓库 :

```bash
git clone <repository-url>
cd my-app
```

2.  安装依赖性 :

```bash
npm install
```

3.  启动开发服务器 :

```bash
npm run dev
```

4.  打开浏览器 `http://localhost:3000`

### 生产大楼

```bash
npm run build
```

这将创建一个 `dist` 带有已制作的部件文件的文件夹.

### 出版(`@dori-ai/dori-pdp-widget`(中文(简体) )

```bash
npm run publish:dev:scoped    # any branch -> <version>-dev.<timestamp> under @dev
npm run publish:prod:scoped   # main only  -> bumps the patch, publishes @latest
npm run publish:prod:dry      # shows the version a prod publish would take
```

相同的脚本在CI中运行通过 `.github/workflows/publish.yml`,认证 与 npm 信任的发布( 每运行 OIDC 令牌, 任何地方没有 npm 令牌 ) :

```bash
gh workflow run publish.yml -f channel=dev  --ref dev  -R DoriService/dori-pdp-widget
gh workflow run publish.yml -f channel=prod --ref main -R DoriService/dori-pdp-widget
```

Prod 运行对齐 `package.json` 和登记册上最高的版本, 凸起补丁,发布 `@latest` 并将撞回 `main`。拉动 之后在当地的prod发布 或下一次碰撞。 这个 npmjs.com上可信-publisher条目在工作流程文件名上键入; 重命名 `publish.yml` 中断 CI 发布直至更新.

CI 释放没有 npm 出处: npm 只接受来源捆绑 一个公共源存储器, 而这个repo是私人的.

### 开发与生产

-   **发展**数字 : `npm run dev` - 使用直接DOM渲染来方便调试
-   **生产**数字 : `npm run build` - 以阴影 DOM 隔离创建优化捆绑

## 组件

### 核心特征

-   **欢迎屏幕**: 以动画标志进行初步问候
-   **聊天接口**: 与消息历史的全功能聊天
-   **产品建议**: AI驱动的产品建议
-   **购物卡**:综合电子商务功能
-   **响应设计**: 在所有设备上无缝工作

### 技术架构

-   **反应 19**: 有现代钩子和特征的最新反应
-   **查克拉乌伊**: 一致、无障碍组件库
-   **类型脚本**: 全面类型的安全和更好的发展经验
-   **阴影DOM**: 孤立型和DOM结构
-   **维特**: 快速构建工具与开发服务器

## QQ 浏览器支持

-   Chrome 88+ (英语)
-   Firefox 85+ (英语)
-   萨法里14+
-   边缘88+

## 分析跟踪

部件自动跟踪 :

-   对话会
-   用户互动
-   产品建议
-   换算指标

所有数据都与您的 `data-sharing-id` 为了方便的分析.

## 安全隐私

-   **孤立的环境**: 部件在阴影 DOM 为安全运行
-   **无相交脚本**: 安全通信协议
-   **数据隐私**:用户数据按照隐私标准处理
-   **GDPR 比较器**: 铭记隐私条例

## 绩效

-   **轻巧**: 快速装入的优化捆绑大小
-   **懒惰装入**: 仅在需要时才装入组件
-   **高效渲染**: 反应19个优化平稳性能
-   **CDN 交付**: 通过jsDelivr快速全球发行

## ++ 辅助

关于技术支持或问题:

-   在仓库中打开一个问题
-   联系支持 [支持@mori.com](mailto:support@mori.com)
-   检查文档以获取共同解决方案

## 许可证

这个项目根据麻省理工学院的许可证获得许可.

## 捐款

我们欢迎捐款! 请随意:

-   提交错误报告
-   请求新功能
-   提供代码改进
-   改进文件编制

## ++ 更新

部件在使用时自动更新 `@latest` 标签。 对于特定版本的部署,使用:

```html
<div id="dori-react-widget-host"></div>
<script
  id="dori-react-widget"
  data-sharing-id="your-id"
  src="https://cdn.jsdelivr.net/npm/mori-chat-widget@1.0.0/dist/widget.js"
></script>
```

* * *

**MoriChat 部件** - 使客户支持更聪明 更参与.

## 常见问题

### @dori-ai/dori-pdp-widget 是什么？

由React和Chakra UI所建的现代化,反应快的聊天部件,旨在无缝地融入任何网站\. 该部件提供一种具有电子商务能力的AI动力聊天体验,适合客户支持和销售援助\.

### 如何安装 @dori-ai/dori-pdp-widget？

在项目目录运行 npm install @dori-ai/dori-pdp-widget，或使用 pnpm add / yarn add / bun add。

### @dori-ai/dori-pdp-widget 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dori-ai\_\_dori-pdp-widget 是否存在。

### @dori-ai/dori-pdp-widget 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dori-ai/dori-pdp-widget 可以商用吗？

@dori-ai/dori-pdp-widget 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @dori-ai/dori-pdp-widget 的下载量有多少？

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

### @dori-ai/dori-pdp-widget 还在维护吗？

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