# @colibri-social/lexicons 中文文档

规范地址：https://npmcn.com/package/%40colibri-social/lexicons/

版本：2\.37\.0
npm 元数据更新时间：2026-11-07T11:13:22.228Z
中文译文更新时间：2026-11-10T10:59:27.386Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40colibri-social/lexicons
原文对照：https://npmcn.com/package/%40colibri-social/lexicons/?lang=original
项目主页：https://github.com/colibri-social/api#readme
源码仓库：https://github.com/colibri-social/api

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

- 包体积（解压后）：2.7 MB，2026 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-08-23T10:10:12.322Z
- 最新版本发布：2026-11-07T11:13:21.861Z
- 近 30 天下载量：3037（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

Colibri 词汇计划及其产生的类型

## 安装

```sh
npm install @colibri-social/lexicons
```

也可以使用：`pnpm add @colibri-social/lexicons`、`yarn add @colibri-social/lexicons`、`bun add @colibri-social/lexicons`

## README

# @colibri-social/语法

每个 Colibri 社交计划, 空间类型声明, 以及生成的 TypeScript 从他们.

## 版式

-   `lexicons/social/colibri/**`: Colibri自己的计划
-   `lexicons/com/atproto/{space,memberspace,managedspace,personalspace}/**`销售商: `bluesky-social/atproto`, (中文(简体) ), 被困在监狱里 `lexicons/com/atproto/PINNED_COMMIT`不要编辑它们!
-   `src/generated/**`(单位:千美元) `pnpm codegen`,经CI核实

## 原子空间词典

`lexicons/com/atproto/PINNED_COMMIT` 和CI. 和C 获取每个供应商的文件 `bluesky-social/atproto` 承诺和 如果单个字节不同,则失败.

要移动针:

```sh
ref=<new commit sha>
for f in packages/lexicons/lexicons/com/atproto/{space,memberspace,managedspace,personalspace}/*.json; do
  rel="lexicons/com/atproto/${f#packages/lexicons/lexicons/com/atproto/}"
  curl -sfL "https://raw.githubusercontent.com/bluesky-social/atproto/$ref/$rel" -o "$f"
done
printf '%s\n' "$ref" > packages/lexicons/lexicons/com/atproto/PINNED_COMMIT
pnpm codegen
```

后诵地法. 复仇是协议的改变,需要更改的et.

## 空间类型

七,每个词典 `main` 实值 `"type": "space"`编辑 `name` 字段为 oAuth 同意屏幕显示一个用户,所以它是为人们写的,而不是 开发者。 哪个空间能保持什么 [文档](https://colibri.social/docs/architecture/communities#six-spaces)。 。 。 .

一个频道是一个空间。 空间密钥是频道的身份及其 配置是关键位置的记录 `self` 里面,这就是为什么频道 记录没有社区或类别字段.

## 测试执行的公约

`src/conformance.test.ts` 无法在其中任何一项的基础上建立 :

-   一个文件,其 `id` 不匹配其路径
-   无法解决的参考文献,使用遗产 `lex:` 前缀,或拼写 其自己的文档而不是使用 `#name`
-   没有声明错误的方法, 错误不是PascalCase, 或者错误 没有描述
-   (单位:千美元) `limit` 参数不是最小和默认的整数,或者 显示输出 `cursor` 所需经费
-   无说明的定义或财产
-   任何描述中的 em 破折号或分号
-   列出非定义记录的收藏的空格类型,或者没有 同意屏幕名称
-   指定不存在的方法或空间类型的权限集
-   一个没有被任何许可集覆盖的方法,这就是阻止新的 无法给予客户端的端点运输

## 图标

```sh
pnpm --filter @colibri-social/lexicons codegen
```

## 常见问题

### @colibri-social/lexicons 是什么？

Colibri 词汇计划及其产生的类型

### 如何安装 @colibri-social/lexicons？

在项目目录运行 npm install @colibri-social/lexicons，或使用 pnpm add / yarn add / bun add。

### @colibri-social/lexicons 支持 TypeScript 吗？

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

### @colibri-social/lexicons 支持 ESM 还是 CommonJS？

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

### @colibri-social/lexicons 可以商用吗？

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

### @colibri-social/lexicons 的下载量有多少？

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

### @colibri-social/lexicons 还在维护吗？

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