# @ankhorage/zora 中文文档

规范地址：https://npmcn.com/package/%40ankhorage/zora/

版本：25\.10\.9
npm 元数据更新时间：2026-11-04T23:59:29.424Z
中文译文更新时间：2026-11-06T05:09:29.644Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：18.2 MB，3795 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：13 个
- peer 依赖：react 19\.2\.3，react-native 0\.86\.x，react-native-svg 15\.15\.4，react-native-web ~0\.21\.3，react-native-worklets 0\.10\.1，react-native-reanimated 4\.5\.1，react-native-gesture-handler ~2\.32\.0，react-native-safe-area-context ~5\.7\.0，@react-native-vector-icons/ionicons ^13\.1\.3 \|\| ^14\.0\.0，@react-native-vector-icons/fontawesome ^13\.1\.3 \|\| ^14\.0\.0，@react-native-vector-icons/fontawesome5 ^13\.1\.3 \|\| ^14\.0\.0，@react-native-vector-icons/fontawesome6 ^13\.1\.4 \|\| ^14\.0\.0，@react-native-vector-icons/material-design-icons ^13\.1\.3 \|\| ^14\.0\.0
- 首次发布：2026-04-18T16:01:41.237Z
- 最新版本发布：2026-11-04T23:59:29.077Z
- 近 30 天下载量：22459（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：371（近 12 个月 371 个）

## 中文简介

在@ankhorage/地表上搭建了“反动土著”和“反动土著网络UI”工具包.

## 安装

```sh
npm install @ankhorage/zora
```

也可以使用：`pnpm add @ankhorage/zora`、`yarn add @ankhorage/zora`、`bun add @ankhorage/zora`

## README

# @ankhorage/zora (英语)

![license: MIT](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/license.svg) ![npm: v25.10.9](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/npm.svg) ![runtime: bun](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/runtime.svg) ![typescript: strict](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/typescript.svg) ![eslint: checked](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/eslint.svg) ![prettier: checked](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/prettier.svg) ![build: checked](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/build.svg) ![tests: checked](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/tests.svg) ![paradox: warnings](https://npmcn.com/package/%40ankhorage/zora/paradox/badges/docs.svg)

在@ankhorage/地表上搭建了“反动土著”和“反动土著网络UI”工具包.

## 使用量

### 国 际

Ankhorage 包通过命令行界面曝光 `ankh`启用 `ankh --help` 来发现可用的软件包命令,或用 `--help` 用于特定软件包.

```zsh
# Install the Ankhorage CLI
bun add --global @ankhorage/ankh

# Show usage information for zora
ankh zora --help
```

### 基本应用

具有可选运行时能力和适应性UI的ZORA应用根.

只启用应用程序使用的运行时间能力 . `toast` 安装所消耗的主机 `useToast()`。 。 。 . `bottomSheet` 安装本地的 BottomSheet 主机; 日期选择器和时间选择器的使用 该主机在本地并自动在网络上使用 Popover .

```tsx
export default function BasicApp() {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <ZoraProvider
        bottomSheet
        initialMode="light"
        theme={basicTheme}
        toast={{ defaultDuration: 4000 }}
      >
        <AppShell header={<AppBar title="Dashboard" subtitle="Welcome to ZORA" />}>
          <Screen>
            <ScreenSection>
              <UsageContent />
            </ScreenSection>
          </Screen>
        </AppShell>
      </ZoraProvider>
    </GestureHandlerRootView>
  );
}
```

此套件包含另外6个实例. 见生成的整套文档 .

## 生成的文件

-   [交互式文件应用](https://npmcn.com/package/%40ankhorage/zora/paradox/index.html)
-   [公共 API 参考](https://npmcn.com/package/%40ankhorage/zora/paradox/exports.md)
-   [构成部分登记册](https://npmcn.com/package/%40ankhorage/zora/paradox/components.md)
-   [结构概览](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/architecture-overview.mmd)
-   [模块关系](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/module-relationships.mmd)
-   [导出图](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/export-graph.mmd)
-   [创建Poker 训练 表格状态序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/create-poker-training-table-state.mmd)
-   [创建ZoraTheme 组合序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/create-zora-theme-config.mmd)
-   [获取法律目标序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/get-legal-targets.mmd)
-   [网格接口序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/grid-interactions.mmd)
-   [网格视频序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/grid-view.mmd)
-   [读取 ChessPieces 序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/read-chess-pieces.mmd)
-   [解析自动启动序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-avatar-initials.mmd)
-   [解析爆炸器选择序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-explorer-selection.mmd)
-   [解析 Grid RuderMarks 序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-grid-ruler-marks.mmd)
-   [解析 Outh 提供Icon 序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-oauth-provider-icon.mmd)
-   [解析 Outh 提供标签序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-oauth-provider-label.mmd)
-   [解析 TimeGridVisible Intervals 序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/resolve-time-grid-visible-intervals.mmd)
-   [选择序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/selection-provider.mmd)
-   [尝试移动序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/try-move.mmd)
-   [使用 Zora 序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/use-zora-theme.mmd)
-   [校验字段序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/validate-field.mmd)
-   [校验字段序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/validate-fields.mmd)
-   [验证 Upload 设置序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/validate-upload-asset.mmd)
-   [验证数值序列](https://npmcn.com/package/%40ankhorage/zora/paradox/diagrams/sequences/validate-value.mmd)

## 常见问题

### @ankhorage/zora 是什么？

在@ankhorage/地表上搭建了“反动土著”和“反动土著网络UI”工具包\.

### 如何安装 @ankhorage/zora？

在项目目录运行 npm install @ankhorage/zora，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（19\.2\.3）、react-native（0\.86\.x）、react-native-svg（15\.15\.4）、react-native-web（~0\.21\.3）、react-native-worklets（0\.10\.1）、react-native-reanimated（4\.5\.1）、react-native-gesture-handler（~2\.32\.0）、react-native-safe-area-context（~5\.7\.0）、@react-native-vector-icons/ionicons（^13\.1\.3 \|\| ^14\.0\.0）、@react-native-vector-icons/fontawesome（^13\.1\.3 \|\| ^14\.0\.0）、@react-native-vector-icons/fontawesome5（^13\.1\.3 \|\| ^14\.0\.0）、@react-native-vector-icons/fontawesome6（^13\.1\.4 \|\| ^14\.0\.0）、@react-native-vector-icons/material-design-icons（^13\.1\.3 \|\| ^14\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ankhorage/zora 支持 TypeScript 吗？

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

### @ankhorage/zora 支持 ESM 还是 CommonJS？

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

### @ankhorage/zora 可以商用吗？

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

### @ankhorage/zora 的下载量有多少？

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

### @ankhorage/zora 还在维护吗？

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