@aperant/framework

中文文档
0.35.0发布于 2026/11/01AGPL-3.0-onlyTypeScriptES Module近 30 天下载 1万

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

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 可用命令
  4. 自动隔离计划
  5. 许可证

推进框架

npm License: AGPL v3

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

安装

npx @aperant/framework init .

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

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:roundtable10名代理人结构化辩论,以超级多数表决
规划/apt:spar与第二个CLI供应商进行双向对战
规划/apt:stress-test执行前填补业务空白的设想模拟
规划/apt:prototype由问题驱动的抛出原型(LOGIC + UI分支)
构建/apt:quick快速一发任务——跳出规划,直接去执行
构建/apt:execute构建带有原子承诺和进展跟踪的计划中的代码
构建/apt:run整个管道:计划 执行 核查 在一个指挥部进行审查
校验/apt:verify4分QA分数(正确性/完整性/质量/覆盖率)
校验/apt:verify-proof视觉验证——截图,视频,HTML报告
校验/apt:review6个带整齐管线的内接码审查
校验/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-docsPROJECT.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数字 :

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

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

许可证

AGPL-3.0 -仅限. 见 自由主义。 。 。 .

版本与发布记录

@aperant/framework 共发布 46 个版本,首次发布于 2026/05/13;过去 12 个月发布了 46 个版本。

版本发布日期距今
0.35.0latest2026/11/016 天前
0.34.12026/10/2612 天前
0.34.02026/10/2216 天前
0.33.02026/10/1523 天前
0.30.02026/09/261 个月前
0.29.32026/09/042 个月前

其他发布通道:next → 0.13.0-next.0。

关于 @aperant/framework 的常见问题

@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 和提交记录判断。