# @hadoku/watchparty-ui 中文文档

规范地址：https://npmcn.com/package/%40hadoku/watchparty-ui/

版本：0\.45\.102
npm 元数据更新时间：2026-11-17T05:36:32.501Z
中文译文更新时间：2026-11-17T05:54:17.547Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40hadoku/watchparty-ui
原文对照：https://npmcn.com/package/%40hadoku/watchparty-ui/?lang=original
项目主页：https://github.com/WolffM/hadoku-watchparty#readme
源码仓库：https://github.com/WolffM/hadoku-watchparty

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

- 包体积（解压后）：4.9 MB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：react ^19\.2\.0，react-dom ^19\.2\.0，@wolffm/task-ui-components \>=4\.23\.27
- 首次发布：2026-10-28T06:28:38.279Z
- 最新版本发布：2026-11-17T05:36:32.335Z
- 近 30 天下载量：23137（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：127（近 12 个月 127 个）

## 中文简介

为Hadoku Watch Party应用程序反应UI组件.

## 安装

```sh
npm install @hadoku/watchparty-ui
```

也可以使用：`pnpm add @hadoku/watchparty-ui`、`yarn add @hadoku/watchparty-ui`、`bun add @hadoku/watchparty-ui`

## README

# @wolffm/ watchparty-ii (英语)

为Hadoku Watch Party应用程序反应UI组件.

## 安装

这个软件包被发布到 GitHub 软件包中. 要安装 :

1.  **配置 npm 以使用 GitHub 软件包** 通过创建/更新 `.npmrc`数字 :

```
@wolffm:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
```

2.  **安装软件包**数字 :

```bash
npm install @wolffm/watchparty-ui
# or
pnpm add @wolffm/watchparty-ui
```

## 使用量

### 基本设置

```tsx
import { WatchPartyProvider, WatchPartyRoom } from '@wolffm/watchparty-ui';
import '@wolffm/watchparty-ui/dist/style.css';

function App() {
  return (
    <WatchPartyProvider serverOrigin="https://your-server.com">
      <WatchPartyRoom defaultRoomKey="your-room-key" />
    </WatchPartyProvider>
  );
}
```

### 配置

UI组件可以通过道具配置 :

-   `serverOrigin`: WebSocket 服务器 URL( 默认 ): `/`(中文(简体) )
-   `defaultRoomKey`: 在挂载上加入的房间( 可选)

## 发展

要在本地进行这套软件包的工作:

```bash
# Install dependencies
pnpm install

# Run dev server
pnpm dev

# Build for production
pnpm build
```

## 出版

此软件包在每次按下时自动发布到 GitHub 软件包 `main` 这影响了UI代码.

这个版本是CI的,从来没有承诺的: `publish-packages.yml` 将其设置为登记簿最新上方的一个补丁(`WolffM/hadoku-actions/next-version`),仅在CI工作空间中,与 `@wolffm/rooms-protocol` 财务报告和审定财务报表 `@wolffm/rooms-server`。从不手工编辑.

* * *

## 发展说明

0阶段脚手架(反应19 + Vite)已就位.

密钥配置 :

-   基础路径 : `/watchparty/`
-   路由器基名 : `/watchparty`
-   尾风 + Zustand + socket.io-客户端

## 运行时服务器集成( 第2阶段)

UI现在自动加入一个占位键 `demo` 当用户按下身份抽屉里的"Join Room"时. 它会发出一个苏克特。 内线 `join` 载荷 `{ room_key:'demo', leader_key?, name, sprite }`。 。 。 .

通过环境配置不同的后端来源( 如果 UI 服务于不同的主机) :

```
VITE_SERVER_ORIGIN=https://api.example.com
```

如果省略,客户端会相对当前来源进行连接( I)`/watchparty/ws`) (中文(简体) ).

复制加盟被压制( 如果 `me.clientId` ) (已经有人居住. 一旦一个房间选择 / 创建 UX 存在, 此临时流量将被替换 .

## CSS 重置/飞行前

Tailwind v4 预飞被禁用,以消除对遗留的供应商选择器的操纵台警告. 在 `src/styles.css`。该主题使用 CSS 变量 `@wolffm/themes` 绘图于 `@theme` 块.

## 黑暗主题锁定/ 扩展干扰

该应用程序执行一个永久的黑暗主题来避免由"黑暗阅读"等扩展来进行颜色倒置:

-   已添加 `<meta name="color-scheme" content="dark">` 打开 `data-theme="dark"` 打开 `<html>`。 。 。 .
-   设定 `data-darkreader-skip` 打开 `<html>` 财务报告和审定财务报表 `<body>` 提示黑暗读者不要变形.
-   已宣布为稳定颜色的 CSS 变量 (`--wp-*`和 `color-scheme: dark` 以减热.
-   明确的黑色背景确保扩展切换时不会闪出 .

如果需要未来的光线模式,请引入一个可控主题开关并删除 `data-darkreader-skip` 有选择地而不是允许无控制的扩展突变.

## 常见问题

### @hadoku/watchparty-ui 是什么？

为Hadoku Watch Party应用程序反应UI组件\.

### 如何安装 @hadoku/watchparty-ui？

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

### @hadoku/watchparty-ui 支持 TypeScript 吗？

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

### @hadoku/watchparty-ui 支持 ESM 还是 CommonJS？

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

### @hadoku/watchparty-ui 可以商用吗？

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

### @hadoku/watchparty-ui 的下载量有多少？

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

### @hadoku/watchparty-ui 还在维护吗？

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

