# @cognitap/galactica 中文文档

规范地址：https://npmcn.com/package/%40cognitap/galactica/

版本：0\.2\.3
npm 元数据更新时间：2026-11-06T18:58:35.097Z
中文译文更新时间：2026-11-10T13:14:29.665Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：384 kB，60 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.1\.0
- 运行依赖：1 个
- 首次发布：2026-11-05T14:57:58.467Z
- 最新版本发布：2026-11-06T18:58:34.742Z
- 近 30 天下载量：2487（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

追踪 JavaScript 和 TypeScript 导入, 找到可以影响变化的测试, 并探索离线的依赖图 .

## 安装

```sh
npm install @cognitap/galactica
```

也可以使用：`pnpm add @cognitap/galactica`、`yarn add @cognitap/galactica`、`bun add @cognitap/galactica`

## README

# 银河系

卡拉狄加地图在JavaScript和TypeScript寄存器中导入. 浏览离线的 HTML 文件中的依赖性图表,或者使用 CLI 来查找一个变化对它的影响以及哪些测试覆盖它.

![Three layers of Immich’s web app. The selected side-bar area depends on modals, and layouts depends on side-bar.](https://raw.githubusercontent.com/cognitap/galactica/main/docs/images/immich-map.png)

## 快开始

需要24.1.0节点或更新。 从您信任的工程中打开一个带有一个命令的依赖地图 .

```sh
npx @cognitap/galactica html --open
```

卡拉狄加写道: `galactica.html` 在当前目录中,并在浏览器中打开。 选择要查看其模块的文件夹, 或选择一个文件来跟踪其导入的内容和依赖它的内容 。 该地图是一个单独的HTML文件,您可以共享或关闭.

为了正常使用,在全球安装CLI,并运行与 `galactica`。 。 。 .

```sh
npm install -g @cognitap/galactica
galactica html --open
```

要检查一个不熟悉的退出, 运行卡拉狄加 从一个信任的目录并通过 `--root /path/to/checkout`。 。 。 . [银河系如何安全读取寄存器](https://github.com/cognitap/galactica/blob/main/docs/security.md)

## 用编码代理

运行 `npx @cognitap/galactica init` 在您自己的仓库( 或 `galactica init` 在全局安装后)为 Codex, Claude Code 和 Cursor 安装技能. 询问您的代理商, 哪些文件和测试会影响更改 。 该技能使用与 HTML 映射相同的导入图, 并指示代理对运行时加载的测试进行特征名称搜索 .

## 国 际

| 命令 | 显示什么 |
| --- | --: |
| `overview` | 包、区域和依赖层 |
| `where <name>` | 命名符号的定义 |
| `outline <file>` | 文件的导出和签名 |
| `uses <file>` | 到达文件的导入者和测试 |
| `deps <file>` | 文件的依赖性 |
| `cycles` | 进口周期和在哪里打破周期 |
| `health` | 周期、超大面积和交叉包装的私人进口 |

添加 `--json` 用于结构化输出。 测试范围跟随导入,因此测试运行时的负载代码可能需要单独搜索. [命令参考](https://github.com/cognitap/galactica/blob/main/docs/commands.md) • 妇女 [配置](https://github.com/cognitap/galactica/blob/main/docs/configuration.md)

## 代理基准

我们和Sonnet和Opus在Hono、Vite和NestJS上 执行六项任务。 最明显的好处是,特工必须点出在Hono或Vite中进行编辑文件的测试.

| 这两项任务所需测试的比例 | 没有卡拉狄加 | 指示使用技能 |
| --- | --: | --: |
| 声纳 | 47% | 78% |
| 奥普斯 Opus | 82% | 100% |

霍诺任务表明跟踪进口为何重要。 四个适配器测试通过包导入到达已编辑的函数. 奥普斯在每次基线运行中都错过了所有四个. 以技能指导,它命名了所有12个在每次跑步时所需的测试.

所有三项条件在其他四项任务上都取得了100%的得分. 在所有6个中, 指示模型使用卡拉狄加 平均成本增加 7%的Sonnet, 17%的Opus。 这项研究涉及144起运行、4起任务、模式和条件。 分级检查会静态编辑, 并给命名所需的测试以信用 。 额外的测试没有处罚,目标测试套房从未被执行. [全面结果、方法和限制](https://github.com/cognitap/galactica/blob/main/docs/benchmark.md)

地图的灵感来自 [代码映射](https://github.com/peterretief/codemap)麻省理工学院有执照.

## 常见问题

### @cognitap/galactica 是什么？

追踪 JavaScript 和 TypeScript 导入, 找到可以影响变化的测试, 并探索离线的依赖图 \.

### 如何安装 @cognitap/galactica？

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

### @cognitap/galactica 支持 TypeScript 吗？

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

### @cognitap/galactica 支持 ESM 还是 CommonJS？

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

### @cognitap/galactica 需要什么版本的 Node\.js？

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

### @cognitap/galactica 可以商用吗？

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

### @cognitap/galactica 的下载量有多少？

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

### @cognitap/galactica 还在维护吗？

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