# @gitkraken/core-gitlens 中文文档

规范地址：https://npmcn.com/package/%40gitkraken/core-gitlens/

版本：0\.39\.0
npm 元数据更新时间：2026-11-16T07:35:28.289Z
中文译文更新时间：2026-11-16T11:06:38.820Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40gitkraken/core-gitlens
原文对照：https://npmcn.com/package/%40gitkraken/core-gitlens/?lang=original
项目主页：https://github.com/gitkraken/vscode-gitlens/tree/main/packages/core
源码仓库：https://github.com/gitkraken/vscode-gitlens

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

- 包体积（解压后）：15 MB，1224 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>= 24
- 运行依赖：9 个
- 首次发布：2026-04-21T06:09:58.100Z
- 最新版本发布：2026-11-16T07:35:28.057Z
- 近 30 天下载量：14110（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：97（近 12 个月 97 个）

## 中文简介

GitLens核心——用于GitKraken内部消费的共享Git / AI / GitHub原始人

## 安装

```sh
npm install @gitkraken/core-gitlens
```

也可以使用：`pnpm add @gitkraken/core-gitlens`、`yarn add @gitkraken/core-gitlens`、`bun add @gitkraken/core-gitlens`

## README

# @gitkraken/core-gitlens (英语)

共享 Git, AI, 和 GitHub 原始人来自 [吉特林斯语Name](https://github.com/gitkraken/vscode-gitlens)由GitKraken内部产品捆绑消费.

这个包将9个内部工作空间包平整成一个柏油球:

| 子路径 | 源码包 | 许可证 |
| --- | --- | --- |
| `utils/*` | `@gitlens/utils` | 见 `LICENSE` |
| `ipc/*` | `@gitlens/ipc` | 见 `LICENSE` |
| `git/*` | `@gitlens/git` | 见 `LICENSE` |
| `git-cli/*` | `@gitlens/git-cli` | 见 `LICENSE` |
| `plus/ai/*` | `@gitlens/ai` | `LICENSE.plus` |
| `plus/git-github/*` | `@gitlens/git-github` | `LICENSE.plus` |
| `plus/agents/*` | `@gitlens/agents` | `LICENSE.plus` |
| `plus/integrations/*` | `@gitlens/integrations` | `LICENSE.plus` |
| `plus/notifications/*` | `@gitlens/notifications` | `LICENSE.plus` |

## 使用量

```ts
import { Logger } from '@gitkraken/core-gitlens/utils/logger.js';
import { GitService } from '@gitkraken/core-gitlens/git/service.js';
import { Repository } from '@gitkraken/core-gitlens/git/models/repository.js';
import { CliGitProvider } from '@gitkraken/core-gitlens/git-cli/cliGitProvider.js';

// Plus subpaths (proprietary)
import type { GitHubGitProviderInternal } from '@gitkraken/core-gitlens/plus/git-github/providers/githubProvider.js';
import { OpenAIProvider } from '@gitkraken/core-gitlens/plus/ai/providers/openaiProvider.js';
```

所有导出都完全打入并按出处映射,地图中嵌入了原始的TypeScript源.

### 供应商一体化

读取提供者数据(收集请求、问题、urgs、项目、重置、存储器身份) 提供者中性外观 `plus/integrations/index.js`它有自己的指南——运行时接线、呼唤和 预告合同、过滤能力表和每个提供者的能力矩阵: [`docs/integrations.md`](https://npmcn.com/package/%40gitkraken/core-gitlens/docs/integrations.md)。 。 。 .

### 通知

显示 GitKraken 通知 `notifications-service-v2` 在另一个主机中 `plus/notifications/notificationsService.js` 及其主机上下文。 其指南涵盖背景、背景和背景 新鲜和土司合同,以及东道主必须拥有的东西(抽奖、坚持、土司去重复、安全联系) 处理: [`docs/notifications.md`](https://npmcn.com/package/%40gitkraken/core-gitlens/docs/notifications.md)。 。 。 .

### 节点对浏览器

`utils/` 使用内部 `#env/*` 根据目标不同解决的进口:

-   节点 : `dist/utils/env/node/*.js`
-   浏览器/网络工人捆绑器(webpack, Vite, esbuilt, Rspack): `dist/utils/env/browser/*.js`

不需要消费者配置 – 运行时间/ 捆绑者通过包自动选择正确的变体 `"imports"` 字段.

### 树摇

软件包是标记的 `"sideEffects": false` 并使用每个文件的子路径导出。 如果您只从 `git/*` 或者说 `utils/*`,则 `plus/*` 代码(包括octokit依赖)永远不会被Node装入,也不会被包含在webpack/Rollup/esbuild 捆绑中.

## 许可证发放

-   `LICENSE` ——规范 `utils/`, (中文(简体) ), `git/`,以及 `git-cli/`。 。 。 .
-   `LICENSE.plus` - 管理下的一切 `plus/` (目前为 `plus/ai/`, (中文(简体) ), `plus/git-github/`, (中文(简体) ), `plus/agents/`, (中文(简体) ), `plus/integrations/`,以及 `plus/notifications/`所有权;不用于再分配.

## 版本

独立 [GitLens VS 代码扩展](https://github.com/gitkraken/vscode-gitlens)。如果包是 `0.x`。 。 。 .

## 来源

建造于 `packages/` 工作空间 [vscode-gitlens (英语)](https://github.com/gitkraken/vscode-gitlens),通过 `pnpm --filter @gitkraken/core-gitlens run build` 分两个步骤:

1.  **`tsdown.config.ts`** 将九个软件包的 TypeScript 源直接编译为 `dist/`,每个源模块一个被排放的模块,每个模块扎根于上表中的子路径. 它读他们的 `src/` 直接——包本身的表态决心源,所以这里没有什么等待他们的 `dist/` ——以相对路径输出出跨包装进口商品 `#env/*` 保持外部状态 `"imports"` 字段可解析.
2.  **`scripts/bundle.mjs`** 收集周围的一切: 它复制LICENSE 并生成清单 `exports`, (中文(简体) ), `imports`,以及 `dependencies` 从9个子包 自己的清单.

子路径布局和生成的运算表都不是手写,所以添加或去掉捆绑的包是单行更改为 `scripts/packages.mjs`,这两个步骤读取.

声明文件由 TypeScript 编译器针对 `tsconfig.core-dts.json` 在雷波根。 该配置坐落在根上而不是这个软件包的旁边,因为发送器使用它的目录作为编译器 `rootDir`,它必须包含每个捆绑的源.

## 常见问题

### @gitkraken/core-gitlens 是什么？

GitLens核心——用于GitKraken内部消费的共享Git / AI / GitHub原始人

### 如何安装 @gitkraken/core-gitlens？

在项目目录运行 npm install @gitkraken/core-gitlens，或使用 pnpm add / yarn add / bun add。

### @gitkraken/core-gitlens 支持 TypeScript 吗？

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

### @gitkraken/core-gitlens 支持 ESM 还是 CommonJS？

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

### @gitkraken/core-gitlens 需要什么版本的 Node\.js？

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

### @gitkraken/core-gitlens 可以商用吗？

@gitkraken/core-gitlens 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @gitkraken/core-gitlens 的下载量有多少？

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

### @gitkraken/core-gitlens 还在维护吗？

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

