# @ai-matrx/sharing 中文文档

规范地址：https://npmcn.com/package/%40ai-matrx/sharing/

版本：0\.1\.27
npm 元数据更新时间：2026-10-30T12:11:25.167Z
中文译文更新时间：2026-11-05T21:59:44.489Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-matrx/sharing
原文对照：https://npmcn.com/package/%40ai-matrx/sharing/?lang=original
项目主页：https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/sharing#readme
源码仓库：https://github.com/AI-Matrix-Engine/aidream

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

- 包体积（解压后）：3.8 MB，50 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：11 个
- peer 依赖：react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2026-10-22T15:23:06.061Z
- 最新版本发布：2026-10-30T12:11:24.952Z
- 近 30 天下载量：14430（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

共享每个 AI Matrx 实体: 权限门, 共享链接, 共享对话框 .

## 安装

```sh
npm install @ai-matrx/sharing
```

也可以使用：`pnpm add @ai-matrx/sharing`、`yarn add @ai-matrx/sharing`、`bun add @ai-matrx/sharing`

## README

# @ai- matrx/ 共享

共享每个 AI Matrx 实体: 权限门, 共享链接, 共享对话框 .

**状态 :** 被matrx前端收养. `/core` 是数据的一半(`configureSharing`:许可服务,共享链接,注册,"shown to"读取; `/react` 是共享工作表( E)`ShareModal`,链接面板、权限钩;主机UI通过 `configureShareSheetUi`(三); `/access/react` 是接入门屏幕(从 `@ai-matrx/data`) (中文(简体) ). 版本被每日npm的出版批量或明确的目标发布所剪切(`highest served + patch`) (中文(简体) ). 源推不启动 npm 发布 . `package.json`'版本不是发布状态; `npm view @ai-matrx/sharing version` 没错.

## 节

-   `@ai-matrx/sharing/core` - 数据的一半: `configureSharing`,权限服务,共享链接,注册
-   `@ai-matrx/sharing/react` - 共享工作表及其钩子;每个仅主机部分都有宣布的默认值
-   `@ai-matrx/sharing/access/react` —— 说 `"use client"`: 请求访问, 拒绝访问, 管理动作, 逐一隐藏

## `@ai-matrx/sharing/access/react` ——出入口屏

`"use client"` 输入。 入口的每个屏幕和钩子: `AccessGate`, (中文(简体) ), `AccessDenied` 编号 : `AccessDeniedView`, (中文(简体) ), `SlugAccessGate`, (中文(简体) ), `SettingAccessGate`, (中文(简体) ), `ForbiddenSurfaceView`, (中文(简体) ), `RequestAccess`, (中文(简体) ), `RequestAccessPanel`, (中文(简体) ), `BlindAccessAsk`, (中文(简体) ), `UnresolvedEntityRef`, (中文(简体) ), `ServerReadRecheck`, (中文(简体) ), `GovernedActionDialog`, (中文(简体) ), `HiddenByMeButton`, (中文(简体) ), `HiddenFilter`, (中文(简体) ), `ResourceActionRequestButtons`, (中文(简体) ), `SettingRequestActionButtons`, (中文(简体) ), `AccessRequestsSurface`; 钩子 `useAccessGate`, (中文(简体) ), `useAccessStates`, (中文(简体) ), `useHiddenByMe` (+ 数) `useHiddenItems`, (中文(简体) ), `useHideForMe`, (中文(简体) ), `useRemovalRights`, (中文(简体) ), `useRequestAccess`; 和 "无法去除"打开器(`ensureRemovable`, (中文(简体) ), `offerOwnerChoices`, (中文(简体) ), `cantRemoveOpener`, (中文(简体) ), `CantRemoveDialogHostBody`) (中文(简体) ). 建造在 `@ai-matrx/design-system` 财务报告和审定财务报表 `lucide-react`; 无 `next/*`,不导入应用程序.

`RequestAccessPanel` 使其视图/编辑选择带有设计系统按钮。 选中的选择 按下状态,每条选择标签都保留在一行上,而行则可能在选择之间包裹. 主机配置访问服务如下;面板拥有这些选择控制.

**`configureAccessUi(env)`** (单元级,合并; `<AccessUiProvider env>` 覆盖子树; `useAccessUi()` 读取 合并结果)。 纯一半的Supabase客户端 / `ensureOrgId` / CMS 符号来自 `configureAccess` 内 `@ai-matrx/data/access` - 双打一次;屏幕读取相同 `@ai-matrx/data/access` 模块化应用程序配置.

| 外地 | 仁爱 | 缺席时默认 |
| --- | --- | --- |
| `useLoginHref()`, (中文(简体) ), `useCurrentUser()` `{id, displayName, email}`, (中文(简体) ), `toast` `{success, error, warning, info?}` | 需求 | 读取一个出错 `configureAccessUi({ field })` |
| `Link`, (中文(简体) ), `router` `{push, back, refresh}`, (中文(简体) ), `searchParam(name)`, (中文(简体) ), `confirm(options)`, (中文(简体) ), `Textarea`, (中文(简体) ), `renderUserIdentity`, (中文(简体) ), `renderEntityRef`, (中文(简体) ), `renderErrorMenu`, (中文(简体) ), `navItemClasses`, (中文(简体) ), `manualRequestActionKey` | 可选的、工作默认 | 简单 `<a>`,浏览器历史/重载,工具包 `confirm()`,设计系统 `Textarea`, avatar + 名称,平名(不是一扇门), 没有出错菜单, app- shell nav CSS变量, `request_access.manual` |
| `entityRegistry.tryGetEntityInfo`, (中文(简体) ), `trash.restore`, (中文(简体) ), `recordUnavailableCapture.resolve`, (中文(简体) ), `settingRequestActions.get`, (中文(简体) ), `resourceActionRequests.get`, (中文(简体) ), `cms.createAccessRequest`, (中文(简体) ), `settingDoorHref`, (中文(简体) ), `reportFeedback`, (中文(简体) ), `presentOrganizationRefusal`, (中文(简体) ), `overlays` | 可选应用程序特性 | 拥有者/ 记录为普通名称; 恢复、 CMS 询问、 设置询问和平台团队询问 FAIL VISIBLY 指定缺失字段名称; 未知请求动作未显示主动作按钮; 其余为无操作 |

Hook-valued 字段称为内部组件:将其设置在后缀上一次. `ForbiddenSurface` (同步,读作 `headers()` 编辑 session judge)不能生活在客户端条目中,因此包船 `ForbiddenSurfaceView`; 应用程序保留了~10行服务器 包装 `forbidden.tsx` 阅读判决,请求路径 并让它.

## 常见问题

### @ai-matrx/sharing 是什么？

共享每个 AI Matrx 实体: 权限门, 共享链接, 共享对话框 \.

### 如何安装 @ai-matrx/sharing？

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

### @ai-matrx/sharing 支持 TypeScript 吗？

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

### @ai-matrx/sharing 支持 ESM 还是 CommonJS？

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

### @ai-matrx/sharing 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-matrx/sharing 可以商用吗？

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

### @ai-matrx/sharing 的下载量有多少？

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

### @ai-matrx/sharing 还在维护吗？

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