# @blazity-atlas/core 中文文档

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

版本：0\.5\.0
npm 元数据更新时间：2026-07-07T12:49:12.357Z
中文译文更新时间：2026-11-09T21:51:51.229Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：145 kB，29 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-06-08T17:28:25.102Z
- 最新版本发布：2026-07-07T12:49:12.208Z
- 近 30 天下载量：1713（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

一个指令脚手架是AGENTS.md,文件结构,以及回放每个编码代理股票(Claude Code, Cursor, Codex)——和地图集医生用被冻结的退出代码在CI中保存该结构被验证.

## 安装

```sh
npm install @blazity-atlas/core
```

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

## README

[![Atlas](https://npmcn.com/package/%40blazity-atlas/core/assets/atlas-logo-light.svg)](https://blazity.com/atlas)

# Atlas——重新拥有编码代理的AI上下文

一个命令给每个编码代理都提供相同的文件结构,repo内存,以及AGENTS.md——  
财务报告和审定财务报表 `atlas doctor` 在CI中用被冻结的出入境密码来核查这个结构.

[![npm version](https://img.shields.io/npm/v/%40blazity-atlas%2Fcore)](https://www.npmjs.com/package/@blazity-atlas/core) [![CI](https://github.com/Blazity/atlas/actions/workflows/ci.yml/badge.svg)](https://github.com/Blazity/atlas/actions/workflows/ci.yml) [![node >=20](https://img.shields.io/node/v/%40blazity-atlas%2Fcore)](https://npmcn.com/package/%40blazity-atlas/core/package.json) [![MIT license](https://img.shields.io/npm/l/%40blazity-atlas%2Fcore)](https://npmcn.com/package/%40blazity-atlas/core/LICENSE)

* * *

每个编码代理都会在会话间忘记你的回放,每个工具都想要自己的配置文件. 你重新阐释建筑,词汇,“不要碰那个”列表——每个代理,每个会话,永远.

图集(按 [空虚](https://blazity.com/)) 给寄存器一个所有文件的位置: Claude Code, Codex, Cursor 的统一文档结构和普通文件工作空间, 以及任何读取的文件 [一般事务人员(其他职等)](https://agents.md/) 参与——承诺在公关中加以审查,并通过确定性CLI来检查漂移情况.

-   ⚡ **一个命令** —— 说 `npx @blazity-atlas/core init` 脚手架 AGENTS.md, CLAUDE.md,和一个完整的 `.ai/` 工作空间
-   🗂️ **万事俱备** ——规划,研究,决定,发展成果评估,内存,词汇,以及可预见,自定义地点的审查判断
-   🤝 **每个特工,一个背景** – Claude Code, Cursor, Codex, Copilot, 和双子座 CLI 共享相同的 repo 拥有的文件
-   🧩 **善于发挥技能** 第三方和定制技能通过文件输出 `.ai/config.json` 而不是创建新文件夹
-   📦 **以你拥有的东西为基础** ——由配置驱动的路径别名采用您现有的docs文件夹而不是替换它们
-   🩺 **机器检查** —— 说 `atlas doctor` 以冻结的出站码验证CI结构; `--fix` 确定
-   🔒 **没有什么留下你的回扣** ——没有遥测,没有网络呼叫,只有一个依赖性,只有普通文件

## 特征展示

简短演示 `atlas init`,即时交接 `atlas doctor`。 。 。 .

## 快速启动

```bash
npx --yes @blazity-atlas/core@latest init
```

一个运行的脚手架将工作空间——配置,词汇,内存,文物目录,两个管理技能,AGENTS.md和CLAUDE.md的入门点,以及代理的同名链接——然后打印出一个即时相接的交接快取. 您自己的编码代理从那里接收: 它检查寄存器, 并用特定项目的事实填充工作空间 .

在终点站, `init` 交互运行: 它询问工作空间应住在哪里( 默认) `.ai`),在写入前预览每个文件,并且可以发射被检测到的代理CLI(`claude`, (中文(简体) ), `codex`, (中文(简体) ), `cursor-agent`与交接即时.

## 安全运行于已有的还原

这是你两分钟内可以核实的行为,而不是承诺:

-   **拒绝肮脏的工作树.** `init` 财务报告和审定财务报表 `doctor --fix` 当您有未承诺的更改(并命名违法文件)时停止; `--force` 是明确的覆盖.
-   **保留你的内容.** 现有 `AGENTS.md` 得到一个栅栏管理区块附加; 所有你写的都留下。 修理从不触及管理区块外的内容.
-   **同上,注:.** 一秒钟 `init` 指纹 `Already up to date — nothing to write.`
-   **可预览.** `init --dry-run` 显示每一个计划书写和触摸什么.
-   **仅限普通文件 .** 没有数据库, 没有守护进程; 唯一的网络呼叫是明确引用的更新检查( N)`atlas update` 编号 : `doctor --check-updates`) (中文(简体) ). Uninstall = 删除工作空间目录, 管理区块 `AGENTS.md`,还有三个韵母.

## 一个结构,里面的一切

脚手架是无聊的部分。 关键在于你工作时所收集的东西:计划、研究、发展成果评估、词汇、记忆和复审裁决——在可预见的地点,代理商通过 `.ai/config.json`,而不是溶入聊天历史.

这条路线并不只是阿特拉斯系统 管理组图集写入 `AGENTS.md` 告诉任何代理人——以及它所操作的任何技能,第三方或习惯——在写作前通过配置解决文物目的地. 一个规划技能的计划在计划目录中着陆,一个研究技能的研究报告,一个评论对结果的判断:一棵树,不管哪个工具写下来.

这个寄存器运行在Atlas上. 它自己的工作空间是演示:

-   [`.ai/LANGUAGE.md`](https://npmcn.com/package/%40blazity-atlas/core/.ai/LANGUAGE.md) - 词汇 _避免_ 栏中编码真实决定的 (“Template QQ Preset”,禁止的后继名称).
-   [`.ai/memory/lessons.md`](https://npmcn.com/package/%40blazity-atlas/core/.ai/memory/lessons.md) 获得的教训,例如: _“在共享代理名称空间中 `review` 与克勞德·克勞德(Claude Code)的内在PR-review技巧在实际操作中相撞"_
-   [`.ai/decisions/adrs/`](https://npmcn.com/package/%40blazity-atlas/core/.ai/decisions/adrs) ——创纪录的发展成果评估拒绝了选项,而不仅仅是赢家.
-   [`.ai/results/`](https://npmcn.com/package/%40blazity-atlas/core/.ai/results) - 复审法院的裁决 `atlas-review` 进程门.

如果您的回购已经保留了常规位置的文档( N)`docs/adrs`, (中文(简体) ), `docs/specs`,...),Atlas通过配置驱动将其映射入工作空间 `pathAliases` 而不是发明一个并行的文件系统—— `doctor --fix` 执行动作, 配置会保留未来的路由 .

## `doctor` 在 CI 语句中

```yaml
- name: Atlas structural gate
  run: npx --yes @blazity-atlas/core@0.5.0 doctor   # pin the version your workspace was scaffolded with
```

出口代码是冻结合同:

| 退出 | 含义 |
| --- | --- |
| `0` | 工作空间干净——建议绝不影响退出代码 |
| `1` | 可修复的漂移—— `atlas doctor --fix` 修理它 决定性的 |
| `2` | 需要人类的手动冲突 |

顾问(设置待决,空置内存,上下文过大)告知,永远不失败建设. `doctor --json` 将结果发布为用于脚本的结构化数据。 将版本绑起而不是 `@latest`: 管理的技能文件是字节对比的, 因此更新软件包并运行 `doctor --fix` 属于同一变化.

上下文大小的咨询监视文件代理实际加载—— `AGENTS.md`, (中文(简体) ), `CLAUDE.md`,词汇,内存,决定,管理技能——对照由有文献记载的代理上限提供的Heuristic字符预算(例如,Codex默认读取的项目docs最多32 KiB). 它们是紧凑的提示,而不是模式限制。 当一起火, `atlas doctor --handoff context-size` 打印任何代理的安全清理提示,并 `atlas-compact` 管理技能运行全循环:与 CLI 进行测量,提出每个文件的计划,应用经批准的编辑,重新运行 `doctor` 证明之前/之后.

## 更新

`atlas update` 检查 npm 的更新发布——唯一触及网络的Atlas命令,并且只有在运行时——并打印被绑定的升级命令. `doctor --check-updates` 运行与非屏蔽咨询相同的检查. `doctor` 自己从不上网,所以CI 保持决定性和离线.

工作空间记录了它是如何写的,和 `doctor` 使用两种记录 :

-   `config.json` 携带 `atlasVersion`,上次写工作空间的软件包版本。 最新的CLI报告a `atlas-version-behind` 咨询直到您运行 `doctor --fix`; 较老的CLI 点击 an `atlas-version-ahead` 手动冲突,而不是静悄悄地返回新管理的文件(`--force` 是明确的覆盖.
-   `atlas.lock.json` 记录每个管理技能文件的内容基线。 与软件包不同但符合其基线的文件从未在本地被触碰过,所以 `--fix` 更新它。 与两者不同的文件是故意定制: `doctor` 报告a `customized-skill` 咨询和 `--fix` 别管它 继续定制 `doctor --adopt-skills` (只有在后期发布会改变这种技能时,咨询才会返回),或用 `doctor --fix --reset-skills`。 。 。 .

锁文件存在前的工作空间脚手架将旧技能内容归类为定制的一次——运行 `doctor --fix --reset-skills` 升级后, 如果您从未定制管理技能 .

## 导致判决的复审

第二个管理技能, `atlas-review`,将人工智能协助的工作通过五个模式进行——摄取、计划、评论、门、尸检——并将其判决(通过/有条件的通行证/失败,有证据、风险和业主)写入 `.ai/results/`,下一个特工运行的地方 和下一个人类能找到它。 没有留下文物的检讨不算作检讨.

Claude 代码用户运行 `/atlas-review`。任何其他代理人从一个指令得到相同的行为: _"读 `.ai/skills/atlas-review/SKILL.md`" (中文(简体) )_。 。 。 .

## 和你的经纪人一起工作

阿特拉斯写道: [一般事务人员(其他职等)](https://agents.md/) 标准作为其切入点,所以大多数代理需要零配置:

| 探员 | 如何取出阿特拉斯系统 |
| --- | --- |
| 克劳德代码 | `CLAUDE.md` 进口 `AGENTS.md`; 技能通过 `.claude/skills` 符号链接或插件 |
| 代码 | 读取 `AGENTS.md` 本土 |
| 光标 | 读取 `AGENTS.md` 土生土长; `.cursor/skills` 提供同义链接 |
| GitHub 副驾驶 | 读取 `AGENTS.md` 在编码代理和 VS 代码中 |
| 双子座CLI | 一个设置: `contextFileName: "AGENTS.md"` |
| 还有什么 | 1个指令:"读取AGENTS.md,通过.ai/config.json解决路径" |

Claude代码用户也可以通过市场安装:

```text
/plugin marketplace add Blazity/atlas
/plugin install atlas@blazity
/atlas:atlas-setup
```

## 范围和非目标

阿特拉斯核心舰今日有两种出入口:

-   **结构门** —— 说 `doctor`上面有冻结的出厂密码.
-   **进程门** —— 说 `atlas-review`基于证据的判决 写在工作空间里.

没错 **没有** 运行您的测试, evals, 或政策检查( 执行门是标准点的下一个位置, 而不是Core今天所做的), 它不是一个代理运行时间, 它不生成代码 .

## 隐私

CLI在本地运行,运行时不进行网络通话,不发送遥测,而且完全有一个依赖性(CLI)[@ clack/ 瞬间](https://www.npmjs.com/package/@clack/prompts) 用于交互式终端 UI). 它所写的都是你仓库里的普通文件 脚手架文件规则还要求耐用文物保持去个人化——记忆是安全的,可以承诺,也可以安全地发表.

## 所需资源

20号节点和Git仓库 macOS 和 Linux 支持; Windows 未测试.

## 使用Atlas系统建造

Blazity根据Atlas标准制定:

-   [阿特拉斯夏娃启动器](https://github.com/Blazity/atlas-eve-starter) 用于生产型制剂的起动单雷波
-   [Next.js 迁移插件](https://github.com/Blazity/nextjs-migration-plugin) ——网站 下个.js 迁移,并有建筑大门和可视化验证
-   [AI 工作流程](https://github.com/Blazity/ai-workflow) ——问题 ——计划 ——执行 ——审查的公关代理工作流程

## 捐款

见 [捐款额](https://npmcn.com/package/%40blazity-atlas/core/CONTRIBUTING.md)错误报告 `atlas doctor` 由于括号内的查找代码,输出已可分解。 安全报告通过 [警卫](https://npmcn.com/package/%40blazity-atlas/core/SECURITY.md)。 。 。 .

## 许可证

[麻省理工学院](https://npmcn.com/package/%40blazity-atlas/core/LICENSE) © [空虚](https://blazity.com/)

* * *

[![Blazity](https://github.com/Blazity.png)](https://blazity.com/)

Atlas系统由 [空虚](https://blazity.com/) ——我们自己的AI工具背后的标准. 更多时间 [blazity.com/阿特拉斯语](https://blazity.com/atlas)。 。 。 .

## 常见问题

### @blazity-atlas/core 是什么？

一个指令脚手架是AGENTS\.md,文件结构,以及回放每个编码代理股票\(Claude Code, Cursor, Codex\)——和地图集医生用被冻结的退出代码在CI中保存该结构被验证\.

### 如何安装 @blazity-atlas/core？

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

### @blazity-atlas/core 支持 TypeScript 吗？

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

### @blazity-atlas/core 支持 ESM 还是 CommonJS？

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

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

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

### @blazity-atlas/core 可以商用吗？

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

### @blazity-atlas/core 的下载量有多少？

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

### @blazity-atlas/core 还在维护吗？

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