# @12-apps/impersonation 中文文档

规范地址：https://npmcn.com/package/%4012-apps/impersonation/

版本：1\.6\.0
npm 元数据更新时间：2026-10-12T17:56:15.784Z
中文译文更新时间：2026-11-05T19:56:26.723Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%4012-apps/impersonation
原文对照：https://npmcn.com/package/%4012-apps/impersonation/?lang=original
项目主页：https://github.com/12-apps/shared-packages#readme
源码仓库：https://github.com/12-apps/shared-packages

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

- 包体积（解压后）：291 kB，64 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：2 个
- peer 依赖：hono \>=4\.0\.0，react \>=19\.0\.0，react-dom \>=19\.0\.0，playwright-bdd \>=8\.0\.0，@12-apps/wiring \>=1\.9\.0，@playwright/test \>=1\.40\.0
- 首次发布：2026-08-14T23:03:57.713Z
- 最新版本发布：2026-10-12T17:56:15.096Z
- 近 30 天下载量：32660（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

一般的,可移植的假冒/预览会话. 作为租户用户的操作员预览:阅读被设定范围,写作被拒绝,除非选择进入,金钱路径总是被拒绝,取消权利结束会话直播. 无框架核心( Cooki)

## 安装

```sh
npm install @12-apps/impersonation
```

也可以使用：`pnpm add @12-apps/impersonation`、`yarn add @12-apps/impersonation`、`bun add @12-apps/impersonation`

## README

# `@12-apps/impersonation`

操作员预览为租户用户 。 阅读被限制,写作被拒绝 除非选择加入,否则金钱途径总是被拒绝,并取消应享权利 拒绝根据届会提出的每一项请求,包括原文,同时离开 因此,操作员被告知离开而不是锁定.

两只船都一半在这里, 每一个在单个工厂后面 一个配置对象:

```ts
const { routes, guard } = createApiImpersonation({ … }); // @12-apps/impersonation/server
const { banner, dialog } = createWebImpersonation({ … }); // @12-apps/impersonation/react
```

## 这两类会议

| 类型 | 是谁决定的 | 上限(**主持人的**(中文(简体) ) | 写入 |
| --- | --- | --- | --- |
| `operator` | tARGET 用户 | 没有,就是他们 | 仅使用 `allowWrites`,启动时要求 |
| `preview`成员 | 预览成员 | 演员自己的剧集 | 永远 |
| `preview`,角色 | 演员本身 | 预览的 ROLE 设定 | 允许 |

**天花板栏是宿主的义务,而不是这个包的义务.** 执行 需要主机的许可引擎,其角色存储及其范围词汇, 这里没有哪个船——所以包裹规定了规则(b`previewCeilingKind`, (中文(简体) ), `outsideBoundedTenant`)和取用使其步入第8. 一个跳过它的主机得到一个 成员预览, 授予预览器 OWN 的全部权限, 而横幅 表示 否则,这里不会发现.

角色行不是个洞. 角色预览 无人替代: 主题保留 演员和预览角色 只会让InterSECTS他们自己的权利,所以每个 写下他们本可以以自己的名义做的许可 A 类 成员预览以其他人的身份解决,因此,无论何种情况,都会被拒绝 饼干说: 规则是从会话形状中重新衍生出来的,从不从旗帜中衍生出来 打电话的人可以设置.

## 包里的东西

-   **饼干.** 薄荷 阅读 结束 没有滑动更新,和 结构而非未执行:解码会话不是 可被分配到薄荷的输入中,因此没有表达式可以重挂活窗口.
-   **租户捆绑.** `outsideBoundedTenant` 每个主机必须有三行 写门检查路径和种类, 永远不要瞄准镜.
-   **写出之门.** 分支顺序是特征——先出(a) 无法停止的会话比它可能写的任何字都更糟糕),然后 活的撤销,然后是钱,然后是账户,然后是读取的快捷键,然后是 万物规则.
-   **路线.** 平台挂载( 启动, 停止,描述),租户上架上两个(开始预览,停止).
-   **浏览器的一半.** 无法卷走的酒吧 被开除或被开除 覆盖; 倒计时从时钟中重新计算; 铬抵消 醒悟处理; 出口命令; 开始握手; 开始 对话.
-   **诸行相去.** `@12-apps/impersonation/e2e` 盖尔金号的船, 和它的台阶 端口为运行它们的主机工具.

## {\\fn华文楷体\\fs16\\1cHE0E0E0}什么是宿主的

下面的一切都是REQUIRED配置,没有默认. 这里的默认未打开 : 它悄悄地将另一个产品的 URL,词汇或语言 交给另一个主机.

-   **谁打电话** ——有决心的行为者:用户代号,电子邮件,平台权威, 以及请求是否来自机器 符号 .
-   **密码** - 一个认证的编码器,它的标记是完整性检查.
-   **时间框** 每种,以毫秒计.
-   **路径表** 金钱移动的地方, 哪些被证明是纯洁的, 哪个前缀是个人的账户, 哪个包是个人的 线路已经挂起.
-   **目录** ——谁可以被冒充,哪个租户,以及是否 目标拥有平台权威本身.
-   **线索** - 开始,结束,和所有被拒绝的尝试.
-   **应享权利** ——租户的计划及其本人同意的交换,当 主人有他们.
-   **每句话** ——两半都取出所有副本作为配置.

## 在编辑表格前值得阅读的倒置

在金钱之路上,方法部决定不了什么。 支付表面正常结算 状态调查,确认已支付的命令,核查 启动提供商的着陆器 存储证书的OAuth调用器 因为提供商而不是应用程序选择了浏览器返回时. 这么说 读取仅当它出现在 `paths.moneyReads`,列出 锁定到 WALE 路径名的允许列表 。 钱树下的新路线是 直到人类读到并补充: 需要一份错误报告 其他订单费用为费用.

账户路径是相反的,并因此获得一个单独的表格: 他们下面没有什么是目标, 所以没有得到那里被迫定居 ,并允许阅读,而每篇书写都被拒绝.

## 子路径

| 子路径 | 这是什么 | 同行 |
| --- | --- | --- |
| `.` | 无框架核心:代码、路径规则、写规则、权限、线条形状 | —— 说 |
| `./server` | `createApiImpersonation` ——路由描述器,写出闸门,端口 | —— 说 |
| `./hono` | 两座山作为路由器 | `hono` |
| `./react` | `createWebImpersonation` - 横幅和启动对话框 | `react` |
| `./e2e` | 包裹的旅程,他们的脚步,和世界港口 | `@playwright/test`, (中文(简体) ), `playwright-bdd` |

收养合同,逐步: [采用.md](https://npmcn.com/package/%4012-apps/impersonation/ADOPTING.md)。 。 。 .

## 常见问题

### @12-apps/impersonation 是什么？

一般的,可移植的假冒/预览会话\. 作为租户用户的操作员预览:阅读被设定范围,写作被拒绝,除非选择进入,金钱路径总是被拒绝,取消权利结束会话直播\. 无框架核心\( Cooki\)

### 如何安装 @12-apps/impersonation？

在项目目录运行 npm install @12-apps/impersonation，或使用 pnpm add / yarn add / bun add。

### @12-apps/impersonation 支持 TypeScript 吗？

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

### @12-apps/impersonation 支持 ESM 还是 CommonJS？

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

### @12-apps/impersonation 需要什么版本的 Node\.js？

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

### @12-apps/impersonation 可以商用吗？

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

### @12-apps/impersonation 的下载量有多少？

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

### @12-apps/impersonation 还在维护吗？

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