# @byline/search-analysis 中文文档

规范地址：https://npmcn.com/package/%40byline/search-analysis/

版本：6\.13\.1
npm 元数据更新时间：2026-11-09T03:55:26.001Z
中文译文更新时间：2026-11-09T00:31:45.281Z
软件包许可：MPL-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40byline/search-analysis
原文对照：https://npmcn.com/package/%40byline/search-analysis/?lang=original
项目主页：https://github.com/Byline-CMS/bylinecms.dev
源码仓库：https://github.com/Byline-CMS/bylinecms.dev

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

- 包体积（解压后）：79.5 kB，25 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.2
- 运行依赖：1 个
- 首次发布：2026-07-26T16:15:23.701Z
- 最新版本发布：2026-11-09T03:55:25.783Z
- 近 30 天下载量：1939（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）

## 中文简介

Byline CMS 搜索提供者的可移植多语言术语分析、查询规划和突出显示

## 安装

```sh
npm install @byline/search-analysis
```

也可以使用：`pnpm add @byline/search-analysis`、`yarn add @byline/search-analysis`、`bun add @byline/search-analysis`

## README

# @ byline/ search- analysis( 按行/ 搜索- 分析)

便携式多语种术语分析和后端中性查询规划 Byline CMS搜索供应商.

软件包拥有逻辑搜索行为 :

-   仅搜索 NFKC 正常化,并用正本文本抵消;
-   已声明的本地验证和基于脚本的倒置;
-   字分之前的标识符提取;
-   伊斯兰法院联盟支持 `Intl.Segmenter` 单词边界;
-   精确保留语言扩展钩;
-   相互重叠的汉字;
-   分组查询概念和短语意图
-   解析器安全 SQL 令牌编码器;以及
-   后端中性突出片段.

它没有搜索索引或查询数据库。 PostgreSQL, MySQL, 索尔, 未来提供商将逻辑分析转换成自己的物理分析 说明.

```ts
import {
  createPortableSearchAnalyzer,
  encodeSqlToken,
  highlightPortableText,
} from '@byline/search-analysis'

const analyzer = createPortableSearchAnalyzer({
  defaultLocale: 'en',
  hanLocale: 'zh',
})

const text = analyzer.analyzeText({
  text: 'ฐานข้อมูล Node.js 数据库',
  locale: 'th',
})

const query = analyzer.analyzeQuery({
  query: '"forest restoration" database',
  locale: 'en',
  matching: { operator: 'all', phrase: 'auto' },
})

const physical = text.tokens.map((token) => encodeSqlToken(token))
const snippet = highlightPortableText({
  text: 'A forest restoration field report.',
  plan: query,
  analyzer,
})
```

原始内容仍然具有权威性。 分析器输出是一次性的, 版本投影; `analyzer.fingerprint` 当行为可以改变时 影响索引术语变化.

`highlightPortableText()` 保留原始源文本并插入 `<mark>…</mark>` 精确、规范、扩大、识别符号和 汉字匹配. 制作人必须解析这些划界人,并制作 环绕内容为文本;它们不得将完整片段注入为 信任的 HTML .

## 常见问题

### @byline/search-analysis 是什么？

Byline CMS 搜索提供者的可移植多语言术语分析、查询规划和突出显示

### 如何安装 @byline/search-analysis？

在项目目录运行 npm install @byline/search-analysis，或使用 pnpm add / yarn add / bun add。

### @byline/search-analysis 支持 TypeScript 吗？

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

### @byline/search-analysis 支持 ESM 还是 CommonJS？

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

### @byline/search-analysis 需要什么版本的 Node\.js？

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

### @byline/search-analysis 可以商用吗？

@byline/search-analysis 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @byline/search-analysis 的下载量有多少？

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

### @byline/search-analysis 还在维护吗？

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