# @atscript/typescript 中文文档

规范地址：https://npmcn.com/package/%40atscript/typescript/

版本：0\.2\.11
npm 元数据更新时间：2026-11-07T16:54:40.660Z
中文译文更新时间：2026-11-07T03:58:36.604Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.6 MB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@atscript/db ^0\.1\.159，@atscript/core ^0\.2\.11
- 首次发布：2025-02-08T20:27:11.360Z
- 最新版本发布：2026-11-07T16:54:40.489Z
- 近 30 天下载量：4901（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：142（近 12 个月 124 个）

## 中文简介

标注:打字-源支持.

## 安装

```sh
npm install @atscript/typescript
```

也可以使用：`pnpm add @atscript/typescript`、`yarn add @atscript/typescript`、`bun add @atscript/typescript`

## README

![Atscript](https://atscript.dev/logo.svg)

# @ atscript/ 类型标记

**一次定义模型** ——从单个获取 TypeScript 类型、运行时间验证和 DB 元数据 `.as` 型号.

[文档](https://atscript.dev/) • 妇女 [类型脚本指南](https://atscript.dev/packages/typescript/)

* * *

Ascript 语言扩展名 。 编译 `.as` 文件为 `.d.ts` 类型声明和 `.js` 具有验证,序列化,JSON Schema支持的运行时间模块. 包括 `asc` CLI(英语:CLI).

## 安装

```bash
pnpm add @atscript/typescript @atscript/core
```

## 快速启动

```bash
# Compile .as files to .d.ts + .js
npx asc -f js

# Diagnostics only
npx asc --noEmit
```

```ts
// Runtime validation
import { buildJsonSchema } from '@atscript/typescript/utils'
import { User } from './schema/user.as'

User.validator().validate(inputData) // throws on failure
const schema = buildJsonSchema(User.annotatedType)
```

## 特征

-   生成 `.d.ts` 类型声明和 `.js` 运行时间模块从 `.as` 文件
-   CLI (中文(简体) )`asc`用于批量汇编并附有诊断
-   `Validator` 用于运行时间数据校验的类 `@expect.*` 约束
-   JSON 斯克马一代(`buildJsonSchema`)和解析(`fromJsonSchema`(中文(简体) )
-   JSON安全类型定义的序列化
-   类型安全公用类型 : `FlatOf<T>`, (中文(简体) ), `PrimaryKeyOf<T>`, (中文(简体) ), `OwnPropsOf<T>`, (中文(简体) ), `NavPropsOf<T>`
-   全球 `atscript.d.ts` 生成输入元数据访问

## AI 特工技能

AI编码代理的统一技能(Claude Code, Cursor, Windsurf, Codex等),涵盖所有 `@atscript/*` 软件包 :

```bash
npx skills add moostjs/atscript
```

学习更多 [技术。sh](https://skills.sh/)。 。 。 .

## 文档

-   [类型脚本指南](https://atscript.dev/packages/typescript/)
-   [完整文档](https://atscript.dev/)

## 许可证

麻省理工学院

## 常见问题

### @atscript/typescript 是什么？

标注:打字-源支持\.

### 如何安装 @atscript/typescript？

在项目目录运行 npm install @atscript/typescript，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@atscript/core（^0\.2\.11）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 asc，可以用 npx asc 直接运行。

### @atscript/typescript 支持 TypeScript 吗？

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

### @atscript/typescript 支持 ESM 还是 CommonJS？

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

### @atscript/typescript 可以商用吗？

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

### @atscript/typescript 的下载量有多少？

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

### @atscript/typescript 还在维护吗？

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