# @deallony/shared 中文文档

规范地址：https://npmcn.com/package/%40deallony/shared/

版本：1\.2\.83
npm 元数据更新时间：2026-11-08T18:42:08.360Z
中文译文更新时间：2026-11-11T18:38:02.784Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40deallony/shared
原文对照：https://npmcn.com/package/%40deallony/shared/?lang=original

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

- 包体积（解压后）：689 kB，713 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-01-14T01:48:07.272Z
- 最新版本发布：2026-11-08T18:42:08.167Z
- 近 30 天下载量：4772（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：205（近 12 个月 205 个）

## 中文简介

共享类型Script类型,DTO,Zod schemas,以及Dealony项目的公用事业.

## 安装

```sh
npm install @deallony/shared
```

也可以使用：`pnpm add @deallony/shared`、`yarn add @deallony/shared`、`bun add @deallony/shared`

## README

# @ deallony/ 共享

共享类型Script类型,DTO,Zod schemas,以及Dealony项目的公用事业.

## 一个命令发布

从干净的同步运行 `main` 分支,可按下访问 `origin/main`。 。 。 .

| 命令 | 行动 |
| --- | --- |
| `npm run deploy` | 弹出补丁,构建,发布到npm,承诺/tag/push GitLab |
| `npm run deploy:minor` | npm + GitLab 微小释放 |
| `npm run deploy:major` | npm + GitLab 主要发布 |
| `npm run deploy:dry-run` | 预览版本并检查当前软件包, 无突变 |
| `npm run deploy:git` | 弹出补丁, 构建, 承诺/tag/ push GitLab 不发布 npm |
| `npm run deploy:git:minor` | 仅 GitLab 的小型释放 |
| `npm run deploy:git:major` | GitLab 仅主要发布 |
| `npm run deploy:git:dry-run` | 只预览 GitLab 发布 |

版本增量在语义化后进行; 2; `1.2.99` 变成 `1.2.100`。 。 。 .

### 自动 npm 登录

`npm run deploy` 第一次检查 `npm whoami`如果 npm 返回 E401 或 ENEEDAUTH, 脚本运行 `npm login --registry=https://registry.npmjs.org/ --auth-type=web` 财务报告和审定财务报表 打开浏览器的登录流程。 完成登录后,它会重新检查你的 身份和继续同样的释放。 网络失败并取消登录 在修改软件包版本之前停止发布. `deploy:git` 从不记录 输入 npm.

### npm 认证

运行 `npm login --registry=https://registry.npmjs.org/` 并确保您的账户 公共范围软件包的出版许可 `@deallony/shared`。 。 。 . 需要时完成任何 npm 2FA 提示 。 从不承诺 npm 符号 .

### 未经浏览器批准发布

一个普通的 `npm login` 继续 `npm publish` 打开 2FA 的浏览器 在每一个释放。 带有"通过2FA"的颗粒符号去除该步骤:

1.  在 npmjs.com 上打开您的相机 > **访问托肯斯** > 翻译: **生成新托肯** > 翻译: **Granular 访问托肯**。 。 。 .
2.  说吧 `deallony-shared-publish`,选择过期(npm盖会写出符号, 请注意续约日期),并勾选 **副通道双因子认证(2FA)**。 。 。 .
3.  下 **包和范围** 选择 **读写**, (中文(简体) ), **只选择 软件包和范围**选择 `@deallony/shared`组织 没有进入。 生成并相抄相.
4.  运行 `notepad $HOME\.npmrc` (PowerShell)并设置此行,替换任意 现有 `//registry.npmjs.org/:_authToken=` 线条: `//registry.npmjs.org/:_authToken=<paste token>`。 。 保存。 编辑文件 将符号保存在外壳历史中; 绝不将其粘贴为还本 `.npmrc`。 。 。 .
5.  检查 `npm whoami`,则 `npm run deploy:dry-run`。 。 。 .

当信物过期时, `npm whoami` 失败, 脚本会倒回浏览器 登录; 生成新符并重复步骤 4.

### 未追回

如果发布失败, 在重试前检查并恢复生成的本地更改 . 如果 npm 发布成功但 Git push/承诺失败, **不重印该版本**。 。 。 . 解决吉特问题,推动现有的释放承诺 `vX.Y.Z` 标签.

首先合并此功能分支; 合并不会自动触发发布 .

## 常见问题

### @deallony/shared 是什么？

共享类型Script类型,DTO,Zod schemas,以及Dealony项目的公用事业\.

### 如何安装 @deallony/shared？

在项目目录运行 npm install @deallony/shared，或使用 pnpm add / yarn add / bun add。

### @deallony/shared 支持 TypeScript 吗？

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

### @deallony/shared 支持 ESM 还是 CommonJS？

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

### @deallony/shared 可以商用吗？

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

### @deallony/shared 的下载量有多少？

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

### @deallony/shared 还在维护吗？

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