# @a-company/paradigm 中文文档

规范地址：https://npmcn.com/package/%40a-company/paradigm/

版本：8\.1\.1
npm 元数据更新时间：2026-11-05T04:01:21.095Z
中文译文更新时间：2026-11-08T05:35:25.644Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：19.9 MB，518 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：14 个
- 首次发布：2026-02-20T23:50:11.721Z
- 最新版本发布：2026-11-05T04:01:20.879Z
- 近 30 天下载量：1888（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 122 个）

## 中文简介

Paradigm 开发工具的统一 CLI

## 安装

```sh
npm install @a-company/paradigm
```

也可以使用：`pnpm add @a-company/paradigm`、`yarn add @a-company/paradigm`、`bun add @a-company/paradigm`

## README

# 范式

Paradigm)给予AI编码代理结构,确定性检查和为您编码库校正内存.

-   **结构.** 您代码的每个部分在代码旁边用平面YAML来描述: `.purpose` 用于组件、流量和信号的文件,以及 `portal.yaml` 授权门。 代理通过MCP工具从这张地图中获得答案,而不是读取整个寄存器.
-   **决取相取.** 壳钩在克洛德代码或克塞尔会话中以固定点运行. 当代码更改但代码更改时, 停止勾钩会阻断会话 `.purpose` 文件,门或Lore条目没有。 钩子是脚本,不是代理人可以忽略的指示.
-   **校对.** 特工们保存着笔记本 传说和决定 提出一个新的学习方式,根据各种情景进行测试,然后由你签收,然后才能拿到笔记本。 根据计量的使用情况重建了计算值估计数(`paradigm calibrate`) (中文(简体) ).

8.0加起来 **格诺蒙语Name**在苹果硅Macs上为您的 Claude 代码会话提供本地控制台.

## 为什么用它

-   **特工们不再重新发现你的密码库了.** 他们要求地图是正确文件而不是读出所有文件,所以会话开始得更快,使用符号较少.
-   **改变不会默默地跳过文件.** 如果代理更改了代码而未更新其描述,门或历史,则会话会一直被屏蔽到它被屏蔽.
-   **认证规则被写下来.** 受保护的路线及其大门 `portal.yaml`,所以代理检查他们 之前添加终点.
-   **你的项目记得原因.** 决策,神话和代理笔记本在会话之间存活,所以下一位代理知道是什么尝试了,为什么.
-   **一组专业特工.** 一个建筑师,建筑师,审查员,保安人员等等, 每人都有自己的笔记本, 这在批准它学到的东西时会有所改进.
-   **指导多会(Gnomon)的一个会场.** 你的克洛德密码的每一个许可 质询和计划 都会从一个决定堆中产生 你通过点击或键盘回答,用触摸ID或密码确认,或打开时通过声音确认.

Good Capit:一个已经超过一个人头的代码库,几个代理同时工作,对认证敏感的应用,以及长期运行的项目,在会话之间会失去上下文.

## 安装

```bash
npm install -g @a-company/paradigm
cd your-project
paradigm shift
```

你需要节点24或稍后. `paradigm shift` 创建 `.paradigm/`,一个根 `.purpose`, (中文(简体) ), `portal.yaml`,用于 Claude 代码、光标、副驾驶和Windsurf 的指令文件 `AGENTS.md`,和强制钩。 再次运行它是安全的:它永远不会覆盖已存在的内容.

如果使用克洛德代码,也安装插件. 它为每个项目添加了钩子、技能、代理和MCP服务器:

```
/plugin marketplace add ascend42/a-paradigm
/plugin install paradigm@a-paradigm
```

## 格诺蒙(8:0新增)

Gnomon在你的Mac上运行你的Claude代码会话 并在事发前问你.

```bash
gnomon
```

第一次运行安装了签名和公证 `Gnomon.app` 输入 `/Applications`输入 `~/Applications` 如果你不能写信给 `/Applications`。然后打开设置。 设置要两次触摸ID或密码,然后打开办公桌. 升级后退出并重新开放格诺蒙.

你得到的东西是:

-   **书桌.** 您的会话只有一个窗口 。 当一个会话需要决定(许可,问题,计划)时,它会在决定堆放上一张牌. 你在那里决定, 你的答案是用安全飞地键签名 之后触摸ID或密码。 解锁会一直到屏幕锁上.
-   **沙盒会议.** Claude Code在macOS沙盒内运行无头的外形.
-   **散列链木.** 每场会话活动都是被串起的,所以以后会编辑到日志显示.
-   **预算保险丝.** 用于所有会议的支出限额.
-   **摩诃衍.** 以单独的沙盒进程运行的面板。 初会集:
    -   **讲习班:** 是什么需要你和运行.
    -   **编剧:** 指数、缓存份额、成本和预算.
    -   **实例背景 :** 打开任务、决定和专注项目.
    -   **神经与星座 :** 可选的,如果你运行这些工具.
-   **声音.** 向会议发言并听取简短的答复。 演讲在Mac上进行处理,音频从不离开.

所需经费:

-   苹果硅Mac 有macOS 15 或后期和系统完整性保护开通. 英特尔Macs,Windows和Linux在8.0不支持.
-   节点24或后. 格诺蒙本身在应用内部运行着自己的被钉住的节点.
-   本地安装商的克洛德密码 和你的克洛德订户签约 格诺蒙拒绝API键计费.
-   触摸ID或您的登录密码.

已知限制:Mac助手还没有检查哪个程序叫它. 另一个程序运行在您可以启动它并要求它签名,但是它所做的每一个签名仍然需要您的触摸ID或密码.

设计 : [文件/规格/gnomon.md](https://github.com/ascend42/a-paradigm/blob/main/docs/specs/gnomon.md)。 。 。 .

## CLI 和 MCP 服务器

| 命令 | 它会做什么 |
| --- | --- |
| `paradigm shift` | 设置或更新项目 |
| `paradigm doctor` | 健康检查,包括钩子计时 |
| `paradigm status` | 项目概况和符号计数 |
| `paradigm ripple <symbol>` | 改变符号会影响什么 |
| `paradigm integrity` | 断绝的参考文献、重复、孤儿 |
| `paradigm sync <ide>` | 重新生成指令文件( R)`claude`, (中文(简体) ), `cursor`, (中文(简体) ), `copilot`, (中文(简体) ), `windsurf`, (中文(简体) ), `agents`(中文(简体) ) |
| `paradigm scan auto` | 草案 `.purpose` 来自已存在的代码的文件 |
| `paradigm lint` | 校验 `.purpose` 文件 |
| `paradigm hooks install` | 重新安装执行钩 |
| `paradigm serve` | 开放平台,本地网络UI(洛尔,图,学院,大脑) |
| `paradigm mcp setup` | 将 MCP 服务器添加到光标、 Claude 桌面、 继续或线上 |

`paradigm --help` 列出每个命令。 仅读命令, 如 `status`, (中文(简体) ), `doctor` 财务报告和审定财务报表 `ripple` 没有写作和网络通话.

软件包包括 MCP 服务器作为 `paradigm-mcp`列表 **32个工具** 默认情况下(11个核心工具和21个分组家庭,如: `paradigm_lore` 财务报告和审定财务报表 `paradigm_task`),另外13个(森蒂内尔,交响乐,大学等)开机 `paradigm_tool_activate` 或进入 `.paradigm/config.yaml`。 。 。 .

5个符号命名了整个代码、文件和承诺: `#` 构成部分, `$` 流动, `^` 门, `!` 信号, `~` 选项.

## 代理人和技能

范式捆绑了68个代理简介:建筑师,建造者,审查者,测试者,安全,设计者等. `paradigm shift` 在您的项目上设置默认的列表 。 用它来管理 `paradigm agent roster`, (中文(简体) ), `bench` 财务报告和审定财务报表 `activate`。 。 。 .

-   **笔记本** 掌握每个代理人学到的知识(`paradigm notebook`) (中文(简体) ).
-   **技能** 携带每个代理的可重复程序,它们是代理在运行时读取的(`paradigm skill list`) (中文(简体) ). 剖面图中的代理行为不会在运行时被读取.
-   例如,设计师代理将它的UI审查和设计-选项协议作为技能载运,因此他们在任何项目中都工作.

## 与“范式”一起维护

-   **哨兵队**: 事件跟踪与您的符号绑定 (`paradigm sentinel`, (中文(简体) ), `sentinel-mcp`) (中文(简体) ).
-   **大学**: 内容包、试题和PLSAT,在平台学院展示(`paradigm university`) (中文(简体) ).
-   **交响乐**: Claude 代码会话之间的消息(`paradigm symphony`) (中文(简体) ).
-   **曲线** (实验):从符号图中合并预测([@ a- company/ warpline (中文(简体) )](https://www.npmjs.com/package/@a-company/warpline)) (中文(简体) ).
-   **工作空间**: 跨相关重置的共享符号( )`paradigm workspace`) (中文(简体) ).
-   **大脑**: 个人笔记文件夹的结构, 默认为私有 (`paradigm brain`) (中文(简体) ).
-   **饮食机**一个单独的产品, 与Paradigm的设计师代理.

## 已停放

这些在寄存器中仍然存在,但没有得到积极的工作:

-   指挥员,SwiftUI会话覆盖. 它只是从一个仓库克隆体中建立起来的.
-   VS代码扩展.
-   `sentinel-rs`, (中文(简体) ), `sentinel-web`, (中文(简体) ), `paradigm-runtime` 和 Warpline GitHub 动作.
-   独立 `portal-*`, (中文(简体) ), `purpose-core`, (中文(简体) ), `premise-core` 财务报告和审定财务报表 `probe-core` npm软件包. Paradigm将自己的拷贝捆绑起来,npm版本已经过时.

## 链接

-   仓库 : [github.com/ascend42/a-paradigm (中文(简体) )](https://github.com/ascend42/a-paradigm)
-   文档 : [文档/README.md](https://github.com/ascend42/a-paradigm/blob/main/docs/README.md) • 妇女 [快开始](https://github.com/ascend42/a-paradigm/blob/main/docs/guides/quick-start.md) • 妇女 [MCP 设置](https://github.com/ascend42/a-paradigm/blob/main/docs/guides/mcp-setup.md) • 妇女 [探员](https://github.com/ascend42/a-paradigm/blob/main/docs/guides/agents.md)
-   [更改日志](https://github.com/ascend42/a-paradigm/blob/main/CHANGELOG.md)
-   许可证:麻省理工学院

## 常见问题

### @a-company/paradigm 是什么？

Paradigm 开发工具的统一 CLI

### 如何安装 @a-company/paradigm？

在项目目录运行 npm install @a-company/paradigm，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gnomon、paradigm、sentinel、paradigm-mcp、sentinel-mcp，可以用 npx gnomon 直接运行。

### @a-company/paradigm 支持 TypeScript 吗？

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

### @a-company/paradigm 支持 ESM 还是 CommonJS？

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

### @a-company/paradigm 需要什么版本的 Node\.js？

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

### @a-company/paradigm 可以商用吗？

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

### @a-company/paradigm 的下载量有多少？

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

### @a-company/paradigm 还在维护吗？

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