# @ancplua/qyl-semantic-conventions 中文文档

规范地址：https://npmcn.com/package/%40ancplua/qyl-semantic-conventions/

版本：15\.0\.5
npm 元数据更新时间：2026-10-22T07:41:00.871Z
中文译文更新时间：2026-11-06T16:18:08.158Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ancplua/qyl-semantic-conventions
原文对照：https://npmcn.com/package/%40ancplua/qyl-semantic-conventions/?lang=original
源码仓库：https://github.com/ANcpLua/Qyl.Telemetry.SemanticConventions

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

- 包体积（解压后）：4 MB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-11T22:29:05.255Z
- 最新版本发布：2026-10-22T07:41:00.681Z
- 近 30 天下载量：2755（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

由共享的 OpenTeleometry 登记处生成的qyl语义常数

## 安装

```sh
npm install @ancplua/qyl-semantic-conventions
```

也可以使用：`pnpm add @ancplua/qyl-semantic-conventions`、`yarn add @ancplua/qyl-semantic-conventions`、`bun add @ancplua/qyl-semantic-conventions`

## README

# @ancplua/qyl-semantic-conventions (英语)

ES模块和TypeScript字面声明由与qyl的C#包相同的解析Weaver注册生成. 没有运行时间依赖 。 个别的出品是可动摇的.

```ts
import { ATTR_SERVICE_NAME, SCHEMA_URL } from '@ancplua/qyl-semantic-conventions';
import {
  ATTR_MCP_METHOD_NAME,
  METRIC_MCP_SERVER_OPERATION_DURATION,
  METRIC_MCP_SERVER_OPERATION_DURATION_UNIT,
} from '@ancplua/qyl-semantic-conventions/incubating';
```

根出口含有稳定和贬值的移徙公约. `./incubating` 包含完整的词汇,包括稳定的出口和qyl所有的发展公约。 上游不稳定的常规可以改变少量排放。 已贬值的密钥仍然是迁移符号;导入这些符号并不能使遥测正常化.

导出遵循 OpenTelemotry JavaScript 名称 : `ATTR_*`语句 `*_VALUE_*`, (中文(简体) ), `METRIC_*` 财务报告和审定财务报表 `EVENT_*`。计量也导出 `METRIC_*_UNIT` 财务报告和审定财务报表 `METRIC_*_DEFINITION` (名称、仪器、单位和稳定性). `SCHEMA_URL` (一) 确定qyl计划; `REGISTRY_SNAPSHOT_SHA256` 识别共享的解析输入,不包括源位置元数据,如临时出账路径。 C# 歌声# `RegistrySnapshot.Sha256` 常数带有相同的指纹。 字义 `.d.ts` 声明和TypeScript源与JavaScript并列.

导入 `findAttribute` 财务报告和审定财务报表 `findMetric` 从 `@ancplua/qyl-semantic-conventions/catalog` 用于数值类型、模板扩展、单位、稳定性和折旧元数据。 查询 归还与C#相同、正常的Weaver事实的被冻结记录 `RegistryCatalog`。 。 。 . 未知的自定义名称返回未定义, 并且仍然有效 。 所需资源 属于选定的信号定义; 登记册成员资格不确立范围所有权. 单独的导出将完整的目录保存在恒定只进口的外.

导入 `getCapturedFieldPersistence` 从 `@ancplua/qyl-semantic-conventions/policy` 将捕获的 HTTP 信头和 RPC 元数据名称使用相同的注册政策进行分类 C# (韩语) `RegistryPolicy.TryGetCapturedFieldPersistence`返回时返回 `true` 有效名称, `false` 用于这些家庭中的裸根或无效姓名 `undefined` 用于不相关的密钥. 匹配对于ASCII来说是大小写不敏感. 呼叫者仍然拥有捕获选择和值形状检查.

代代相传 `scripts/generate.sh` 在寄存器根部,使用被绑定的官方语言独立的OpenTeleometry注册和qyl/vendor定义. 这些绑定可以独立地发布OpenTeleometter SDK版本. SDKs/出口商和正式的OTLP电线定义仍然是单独的依赖关系. 仅凭注册计划 URL 并不能改变属性 .

## 常见问题

### @ancplua/qyl-semantic-conventions 是什么？

由共享的 OpenTeleometry 登记处生成的qyl语义常数

### 如何安装 @ancplua/qyl-semantic-conventions？

在项目目录运行 npm install @ancplua/qyl-semantic-conventions，或使用 pnpm add / yarn add / bun add。

### @ancplua/qyl-semantic-conventions 支持 TypeScript 吗？

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

### @ancplua/qyl-semantic-conventions 支持 ESM 还是 CommonJS？

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

### @ancplua/qyl-semantic-conventions 可以商用吗？

@ancplua/qyl-semantic-conventions 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @ancplua/qyl-semantic-conventions 的下载量有多少？

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

### @ancplua/qyl-semantic-conventions 还在维护吗？

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