# @glyphlang/glyph 中文文档

规范地址：https://npmcn.com/package/%40glyphlang/glyph/

版本：0\.1\.134
npm 元数据更新时间：2026-11-11T20:01:20.757Z
中文译文更新时间：2026-11-16T16:53:24.602Z
软件包许可：MIT OR Apache-2\.0

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

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

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

- 包体积（解压后）：29.2 kB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-06-15T09:34:32.593Z
- 最新版本发布：2026-11-11T20:01:20.387Z
- 近 30 天下载量：3095（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：133（近 12 个月 133 个）

## 中文简介

TypeScript 您的AI代理无法悄悄地破解:一种静态打入语言,可以转录到TypeScript,没有任何,详尽的匹配,以及运行时间检查的类型.

## 安装

```sh
npm install @glyphlang/glyph
```

也可以使用：`pnpm add @glyphlang/glyph`、`yarn add @glyphlang/glyph`、`bun add @glyphlang/glyph`

## README

# 格莱弗

**TypeScript 您的人工智能代理无法悄悄地中断.**

[![npm](https://img.shields.io/npm/v/@glyphlang/glyph.svg)](https://www.npmjs.com/package/@glyphlang/glyph) [![downloads](https://img.shields.io/npm/dm/@glyphlang/glyph.svg)](https://www.npmjs.com/package/@glyphlang/glyph) [![CI](https://github.com/chadetov/glyph/actions/workflows/ci.yml/badge.svg)](https://github.com/chadetov/glyph/actions/workflows/ci.yml) [![install size](https://packagephobia.com/badge?p=@glyphlang/glyph)](https://packagephobia.com/result?p=@glyphlang/glyph) [![license](https://img.shields.io/npm/l/@glyphlang/glyph.svg)](https://github.com/chadetov/glyph) [![Socket Badge](https://badge.socket.dev/npm/package/@glyphlang/glyph/0.1.134)](https://badge.socket.dev/npm/package/@glyphlang/glyph/0.1.134) [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/chadetov/glyph/badge)](https://scorecard.dev/viewer/?uri=github.com/chadetov/glyph)

Glyph是一种静态的打字语言 **转到类型脚本**,构建后AI代理可以安全地读取,写出并修改代码. 它看起来几乎像 TypeScript, 所以你在第一天阅读它 没有教程。 凡有不同之处,每差一分 关闭一个洞 一个特工掉入和 `tsc --strict` 浪过.

## 不用装任何东西就试试

```sh
npx @glyphlang/glyph init my-app
cd my-app
npm install
npx glyph run
# hello from glyph
```

那个脚手架有六个文件 把编译器塞入 `devDependencies`,并运行程序。 任何复制项目的人都会用它建造 `npm install` 和没有全球。 六人中有两个是编码代理 而不是你: `AGENTS.md` 指向离线语言参考,以及 `.mcp.json` 注册下面的分析服务器.

更喜欢在你的路径:

```sh
npm install -g @glyphlang/glyph
glyph init my-app && cd my-app && glyph run
```

> **网站:** [glyphlang.io (英语)](https://glyphlang.io/)  • 妇女  **在浏览器中尝试:** [游乐场](https://glyphlang.io/playground/)  • 妇女  **指着经纪人吗?** [glyphlang.io/llms.txt (英语)](https://glyphlang.io/llms.txt)

* * *

## 问题解决

一个AI代理将乐于写出TypeScript,在运行时编译干净并中断. 它到达 `any` 在边界上投出 `unknown`,忘记一个 `switch` 大小写 `Promise` 在地上,和 `tsc --strict` 永远保持绿色。 在一个大代码库里甚至无法可靠 _寻找_ 因为超载 装饰器 命名空间的合并 以及枪管的再出口.

Glyph在语言层面消除了这些危害. 代理船不会在这里编译错误 .

## 看见了

Glyph 读取类似 TypeScript, 但是没有 `any`, (中文(简体) ), `match` 必须覆盖每个案件,而您声明的类型是 _运行时实际选中_数字 :

```glyph
type User = {
  id: number,
  name: string,
}

// A boundary value is `unknown` until you prove its shape.
// `User.parse` exists because every type carries a runtime descriptor.
fn handle(body: unknown) -> string {
  return match User.parse(body) {
    Ok(user) => string.upper(user.name),
    Err(_) => "invalid",
  }
}
```

这个编译器可以清理,可读的TypeScript,你可以承诺,在TS运行的任何地方运行,并与任何npm包相混合.

## 有什么不一样的

-   **没有 `any`没有消除.** 当代码运行时,这些类型所说的话是真实的. 每个记录类型都会生成运行时间验证器( E)`User.parse(x)`)),所以不可信输入只有在检查过后才被打出,而一个失败则命名了字段及其路径.
-   **以无相相而为所竭.** `match` 一个工会,或者 `number`编号 :`string`,必须处理每个案件,否则不汇编。 添加一个变体和每个未处理的站点灯光.
-   **错误是值 .** `Result` 编辑 `?` 操作员而不是丢弃的例外。 放下一个 `Result` 你得到一个警告, 因为一个丢弃的错误是吞噬失败.
-   **贪取.** 一个名字 一个申报表. `grep "fn parseUser"` 每次都找到定义 没有超载,装饰,或桶文件.
-   **稳活地出.** 一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克一克 一行更改为一行diff,因此代理编辑仍可复核.
-   **产生,不要手写.** `glyph gen openapi spec.yaml --client` 发送一个输入的 HTTP 客户端和服务器根 . `glyph gen zod` 财务报告和审定财务报表 `gen dts` 将已有的计划转换为选中的 Glyph 类型 .
-   **和真正的数据库交谈.** 按名称导入任何 npm 客户端 。 基于阶级的客户(`new Pool`, (中文(简体) ), `new MongoClient`与 `new`,通过 `std/sqlite`一行不可信地回来,所以你 `Row.parse` 它被打入打字记录, 计划与代码不匹配 将隐藏在边界。 见 [数据库指南](https://github.com/chadetov/glyph/blob/main/docs/guide/databases.md)。 。 。 .

## 命令

```sh
glyph init my-app          # scaffold a project
glyph run                  # build + type-check + execute
glyph build --check        # emit TypeScript, verified with tsc --strict
glyph fmt                  # one canonical layout
glyph --explain E0200      # long-form help for any diagnostic
```

Glyph船作为每个平台(macOS,Linux和Windows,在Intel和ARM上)的单个预建二进制. 没有邮购下载和工具链设置 。 运行或类型检查使用本地 `tsx`编号 :`tsc`。 。 。 .

## 为代理人所建

指定您的编码代理 **[glyphlang.io/llms.txt (英语)](https://glyphlang.io/llms.txt)**,一个从零到正的,可运行的Glyph的单文件: Cononical 程序形状, 完整 stdlib 表面, 常见的取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 写Glyph的代理人得到编译时间反馈的精确度足以自纠正.

**示范背景协议.** `glyph init` 写入 `.mcp.json` 自动注册,以及 `glyph agents` 把它添加到您已有的项目中 . `glyph mcp` 在stdio上运行一个服务器,该服务器将回答五个问题:对一个文件进行类型检查,以便进行编码诊断,在光标上推断出的类型,定义一个名称(在导入之后),整个项目中每个符号的引用,以及符号搜索。 其运行的分析与编辑器使用的分析相同,因此代理的答案与编译器相匹配. 指向任何 MCP 客户端 `glyph mcp <project>`; 细节 [glyphlang.io/ mcp (英语)](https://glyphlang.io/mcp/)。 。 。 .

**编.** `glyph lsp` 是一个完整的语言服务器(诊断,徘徊,去定义,完成,符号,全工作空间的查找参考和重命名,格式化),任何LSP客户端都可以在stdio上驱动.

## 下一个去哪里

|  |  |
| --- | --- |
| 十分钟后的第一个节目 | [从这里开始](https://glyphlang.io/start/) |
| 5分钟后全语言 | [参观](https://github.com/chadetov/glyph/blob/main/docs/guide/tour.md) |
| 不安装就试试 | [游乐场](https://glyphlang.io/playground/) |
| 直接回答工程师的问题 | [glyphlang.io/ 答题](https://glyphlang.io/answers/) |
| 四根支柱 深度 | [glyphlang.io/支柱/可核查性](https://glyphlang.io/pillars/verifiability/) |
| 资料来源、问题、路线图 | [github.com/chadetov/glyph (英语)](https://github.com/chadetov/glyph) |

## 状态

格莱弗是个 **早期预览** 动作要快 编译器工具链( T)`build`, (中文(简体) ), `run`, (中文(简体) ), `fmt`, (中文(简体) ), `gen`, (中文(简体) ), `regen`, (中文(简体) ), `--explain`) 工程结束至结束,每一次发布都会对照 `tsc --strict`它还没有准备好生产。 你可以告诉我们它在哪里破裂。 每个版本的更改都在 [glyphlang.io/ 版本数](https://glyphlang.io/versions/)。 。 。 .

**稳定值为1.0:** 语言在0.1.x发布之间仍然可以改变。 两行相持. 您的代码仍然可以运行,因为它总是编译为您拥有的平版TypeScript,这是一个永久的逃生舱. 当语法改变时,我们的目标是 `glyph fmt` 为汝移去. 完全政策: [文件/稳定性](https://github.com/chadetov/glyph/blob/main/docs/stability.md)。 。 。 .

## 正在验证您的下载

GitHub Actions中建有发布内容 而非被篡改的拷贝:

```sh
# npm packages: published with npm provenance (OIDC-signed)
npm audit signatures

# GitHub Release archives: SLSA build-provenance attestation
gh attestation verify glyph-<version>-<platform>.tar.gz --repo chadetov/glyph

# ...or against the provenance bundle attached to the release, with no network
gh attestation verify glyph-<version>-<platform>.tar.gz \
  --bundle v<version>.intoto.jsonl --repo chadetov/glyph

# ...and a SHA-256 for each archive
sha256sum -c SHA256SUMS
```

## 许可证

双重许可证 [阿帕奇 - 2.0](https://github.com/chadetov/glyph/blob/main/LICENSE-APACHE) 或者说 [麻省理工学院](https://github.com/chadetov/glyph/blob/main/LICENSE-MIT)随便你.

## 常见问题

### @glyphlang/glyph 是什么？

TypeScript 您的AI代理无法悄悄地破解:一种静态打入语言,可以转录到TypeScript,没有任何,详尽的匹配,以及运行时间检查的类型\.

### 如何安装 @glyphlang/glyph？

在项目目录运行 npm install @glyphlang/glyph，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 glyph，可以用 npx glyph 直接运行。

### @glyphlang/glyph 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/glyphlang\_\_glyph 是否存在。

### @glyphlang/glyph 需要什么版本的 Node\.js？

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

### @glyphlang/glyph 可以商用吗？

@glyphlang/glyph 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @glyphlang/glyph 的下载量有多少？

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

### @glyphlang/glyph 还在维护吗？

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

