# @aperant/framework 中文文档

规范地址：https://npmcn.com/package/%40aperant/framework/

版本：0\.35\.0
npm 元数据更新时间：2026-10-31T22:30:05.808Z
中文译文更新时间：2026-11-06T09:02:40.226Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40aperant/framework
原文对照：https://npmcn.com/package/%40aperant/framework/?lang=original
项目主页：https://github.com/Mikalsen-AI/aperant-cloud-desktop/tree/main/packages/framework#readme
源码仓库：https://github.com/Mikalsen-AI/aperant-cloud-desktop

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

- 包体积（解压后）：40.6 MB，6855 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：4 个
- 首次发布：2026-05-12T18:57:33.503Z
- 最新版本发布：2026-10-31T22:30:05.612Z
- 近 30 天下载量：10273（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 46 个）

## 中文简介

AI编码框架——与任何LLM提供者进行规划、执行、核查和审查代码的可调合技能。 工作如克洛德代码命令, Codex 任务,或程序化.

## 安装

```sh
npm install @aperant/framework
```

也可以使用：`pnpm add @aperant/framework`、`yarn add @aperant/framework`、`bun add @aperant/framework`

## README

# 推进框架

[![npm](https://img.shields.io/npm/v/@aperant/framework)](https://www.npmjs.com/package/@aperant/framework) [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://npmcn.com/package/%40aperant/framework/LICENSE)

> **工作正在进行中.** 这是运行Aperant生态系统的基础——一个覆盖整个软件生命周期的代理IDE. 加入等待列表时间 [aperant.com (英语)](https://aperant.com/)。 。 。 .

## 安装

```bash
npx @aperant/framework init .
```

对于跨常见运行时间的非交互安装或再点缀:

```bash
npx @aperant/framework init . --claude --codex --pi --yes
```

## 使用量

只要输入 `/apt` 并用自然语言描述你想要的东西。 路由器将您的输入和发送分类到合适的技能.

```
/apt add OAuth login with Google
/apt the chat scroll is jittery — debug it
/apt help me think through the new pricing model
/apt typo in the footer — wrong year
/apt review my PR
```

也可以直接调用任何技能(如:. `/apt:plan ...`, (中文(简体) ), `/apt:debug ...`) (中文(简体) ).

运行时命令表面略有不同:

-   克劳德: `/apt:plan`
-   代码 : `/apt-plan`
-   皮: `/apt`, (中文(简体) ), `/apt:plan` 通过 `.pi/prompts/`

## 可用命令

| 阶段 | 命令 | 目的 |
| --- | --- | --- |
| **路线** | `/apt` | 智能路由器——自然语言发送到任何技能 |
| **发现** | `/apt:scan` | 新建/更新 `.aperant/features/` 登记 |
| **发现** | `/apt:zoom-out` | 陌生地区的一页建筑取向 |
| **发现** | `/apt:improve` | 重构机会扫描(DEEEPENING/INTERFACE-DESIGN/LANGUAGE) |
| **发现** | `/apt:debug` | 系统调试持续状态跨上下文重排 |
| **规划** | `/apt:discuss` | 在规划前先将构想或模棱两可的决定锁定在脑后 |
| **规划** | `/apt:design` | 编码前线框 批评 交接 `/apt:plan` |
| **规划** | `/apt:mockup` | 视觉 HTML+ 带有平行变体的 Tailwind 模拟循环 |
| **规划** | `/apt:plan` | 调查密码库,制作 `spec.md` + 键 `implementation_plan.json` |
| **规划** | `/apt:roundtable` | 10名代理人结构化辩论,以超级多数表决 |
| **规划** | `/apt:spar` | 与第二个CLI供应商进行双向对战 |
| **规划** | `/apt:stress-test` | 执行前填补业务空白的设想模拟 |
| **规划** | `/apt:prototype` | 由问题驱动的抛出原型(LOGIC + UI分支) |
| **构建** | `/apt:quick` | 快速一发任务——跳出规划,直接去执行 |
| **构建** | `/apt:execute` | 构建带有原子承诺和进展跟踪的计划中的代码 |
| **构建** | `/apt:run` | 整个管道:计划 执行 核查 在一个指挥部进行审查 |
| **校验** | `/apt:verify` | 4分QA分数(正确性/完整性/质量/覆盖率) |
| **校验** | `/apt:verify-proof` | 视觉验证——截图,视频,HTML报告 |
| **校验** | `/apt:review` | 6个带整齐管线的内接码审查 |
| **校验** | `/apt:pr-review` | 多代理PR审查——6-8个平行专家(i18n+跨平台有条件参与)+验证员+固定员+自审员 |
| **船舶** | `/apt:ship` | 创建带有 QA 分数的 PR , 决定可追溯性, 承诺到任务映射 |
| **船舶** | `/apt:watch-ci` | 后轮CI观察员——民调公关检查,自动固定红色,推倒,重新安排时间 |
| **船舶** | `/apt:close-task` | 后出现更近——确认合并,翻转里程碑,GC状态 |
| **会议** | `/apt:pause` | 人类发动的交接——在需要停止的时候保存继续的文物 |
| **会议** | `/apt:resume` | 从已暂停的会话和路径恢复上下文到下一个动作 |
| **文档** | `/apt:docs` | 生成/更新文件,对照实际代码库进行核查 |
| **文档** | `/apt:create-docs` | PROJECT.md + personas.json + 特性登记册的第一产品文件 |
| **文档** | `/apt:diagram` | 将图表映射到 `.excalidraw` 文件或活的 Excalidraw MCP 画布 |
| **项目** | `/apt:bootstrap` | 生成/更新Project.md(产品-文本真相来源) |
| **项目** | `/apt:personas` | 发现3至5个产品人,基于代码+Project.md |
| **项目** | `/apt:roadmap` | 管理透视卡,里程碑,所有者,ROADMAP.md渲染 |
| **项目** | `/apt:triage` | 通过五态机器移动任务 |
| **框架** | `/apt:setup` | 更改偏好(核查样式、多模式、平行、分枝) |
| **框架** | `/apt:update` | 每次运行时刷新已安装的技能/ 代理/ 钩 |

## 自动隔离计划

有过 `/apt:run` 在你批准之前 用第二个LM来挑战所有计划 单位 `.aperant/config.local.json`数字 :

```json
{ "spar": { "enabled": true, "partner": "codex" } }
```

`partner` =: `codex` | `claude` | `gemini` (不是你现在的CLI). 在计划阶段(STANDARD)或计划+执行(DEEP)后起火;QUICK是豁免. 或运行 `/apt:setup` →通通通通通通通通通通通通通通通通通通通通通通通通通通通通通通通通通通.

## 许可证

AGPL-3.0 -仅限. 见 [自由主义](https://npmcn.com/package/%40aperant/framework/LICENSE)。 。 。 .

## 常见问题

### @aperant/framework 是什么？

AI编码框架——与任何LLM提供者进行规划、执行、核查和审查代码的可调合技能。 工作如克洛德代码命令, Codex 任务,或程序化\.

### 如何安装 @aperant/framework？

在项目目录运行 npm install @aperant/framework，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 apt-tsc、apt-tools、framework、apt-proof-video，可以用 npx apt-tsc 直接运行。

### @aperant/framework 支持 TypeScript 吗？

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

### @aperant/framework 支持 ESM 还是 CommonJS？

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

### @aperant/framework 需要什么版本的 Node\.js？

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

### @aperant/framework 可以商用吗？

@aperant/framework 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @aperant/framework 的下载量有多少？

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

### @aperant/framework 还在维护吗？

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