# @agenticprimitives/create-app 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/create-app/

版本：0\.0\.0-alpha\.34
npm 元数据更新时间：2026-10-26T11:48:40.677Z
中文译文更新时间：2026-11-06T09:40:30.741Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/create-app
原文对照：https://npmcn.com/package/%40agenticprimitives/create-app/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

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

- 包体积（解压后）：82.2 kB，44 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-11T20:48:16.200Z
- 最新版本发布：2026-10-26T11:48:38.382Z
- 近 30 天下载量：3557（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

开发者 Kit 生成器( 第 398 第10.3段, 第399 第3.6段): `create-app <dir> --template product-repo` 写出一个产品存储器 — pnpm 工作空间, 准确的@ agenticprimitives/ \* pins, agentic.lock.json, `ap doctor` + 键 `ap test` CI,一个夜活门工作

## 安装

```sh
npm install @agenticprimitives/create-app
```

也可以使用：`pnpm add @agenticprimitives/create-app`、`yarn add @agenticprimitives/create-app`、`bun add @agenticprimitives/create-app`

## README

# @ agenticprimitives/ 创建- app

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

```
npx @agenticprimitives/create-app my-agent-app --template home-client        # the first app: a client of the person's agent
cd my-agent-app && pnpm install && npx ap doctor && pnpm dev                 # Connect with your Home → ask → an act parks for HER signature

npx @agenticprimitives/create-app my-product --template product-repo --pin 1.0.0-alpha.24
cd my-product && pnpm install && npx ap doctor
```

## `--template home-client` ——开发者Kit的第一个应用(Spec 398§10.1)

下一个客户端 **自己的经纪人通过她的家** (Spec 397):应用程序在她的家庭MCP注册 (RFC 7591——不采取操作步骤;接受本地主机转接),将她送到她家连接(OAuth 2.1 + PKCE), 持有不透明无记名者 `/mcp` 被封入了"httply"饼干 问她的经纪人是她 一个读取的答案 她站着 行为又回来了 `authority_required` 打开页面 **** 何地为家 **** 标志——应用程序永远不会 收集签名. `pnpm verify` 经营这两起事件 对抗一个开发地的演示人; `scripts/verify-devkit-starter.mts` 在 Ring 0 中是 G2 退出: 生成 / 从注册簿安装 / 医生 / 类型检查 -测试 -建立 -这两个行为, 从一个干净的目录。 文件 : `src/lib/home-agent.ts` (整个协议,没有) 扶养, `src/lib/server.ts`, (中文(简体) ), `app/api/{connect,callback,ask,me,disconnect}`, (中文(简体) ), `app/page.tsx`, (中文(简体) ), `scripts/verify-two-acts.ts`, (中文(简体) ), `README.md`,预计 `AGENTS.md`编号 :`CLAUDE.md`编号 :`.cursor/rules`, (中文(简体) ), `.mcp.json` (单位:千美元) 开发者 MCP , `agentic.lock.json` 旋转 `@agenticprimitives/devkit` 一个人 如果发电机比被钉住的更新 德维基特, `npx ap doctor --rules --write` 重新设定标本的规则(医生称漂移).

以 Spec 399 §3.6 描述的方式写出一个产品存储器——形状 `ap-discovery`, (中文(简体) ), `ap-home` 财务报告和审定财务报表 `ap-naming` 创建自, 绝不是 monrepo 根的副本 :

| 写入 | 目的 |
| --- | --- |
| `package.json`, (中文(简体) ), `pnpm-workspace.yaml`, (中文(简体) ), `.npmrc`, (中文(简体) ), `tsconfig.base.json` | pnpm 工作空间结束 `apps/*` + 键 `examples/*`; 严格的对等者; 准确 `@agenticprimitives/*` 针头 |
| `agentic.lock.json` | 连贯的指针集、规则源摘要、医生配置、模板修订 |
| `AGENTS.md`, (中文(简体) ), `CLAUDE.md`, (中文(简体) ), `.cursor/rules/*.mdc` | 从被绑定的规则源预测(编辑源,运行) `ap doctor --rules --write`(中文(简体) ) |
| `.github/workflows/ci.yml` | 类型检查 · 测试 · `ap doctor` • 妇女 `ap doctor --rules` |
| `.github/workflows/live-gates-nightly.yml` | `ap test --live-gates live-gates.json` + 键 `ap conform a2a|mcp` 反阴影部署 |
| `live-gates.json` | 门分类账(spec 392形状),空到第一个验证脚本移动进去 |
| `wrangler.example.toml` | 嵌入式布局 : `env-a` 编号 : `env-b` 现场直播(Ring 0部署到切口), `env-a-split` 阴影( 此重播) |
| `scripts/set-cloudflare-secrets.sh` | 隐藏的每秒机密 `.secrets.<env>` 文件, 从未响应 |
| `DEPLOYER.md`, (中文(简体) ), `docs/MOVED.md` | 每个app + env 的记录的部署者; 文本剪接的 PR 叶以 Ring 0 表示 |

选项 : `--name <kebab>` (默认目录名称), `--pin <exact version>` (生成的默认值) devkit的版本; 解决之后的对立 `ap upgrade --pin <tag>`, (中文(简体) ), `--json`。 。 。 .

退出代码 : `0` \* 书写 `2` 使用( 非空的 dir, 坏名, 坏名, 坏名针, 未知模板) `3` 错误.

模板没有主机名,没有垂直词汇,也没有密钥(ADR-0021):每个部署特定值 是一个 `<placeholder>` 产品填写.

## 常见问题

### @agenticprimitives/create-app 是什么？

开发者 Kit 生成器\( 第 398 第10\.3段, 第399 第3\.6段\): create-app \<dir\> --template product-repo 写出一个产品存储器 — pnpm 工作空间, 准确的@ agenticprimitives/ \* pins, agentic\.lock\.json, ap doctor \+ 键 ap test CI,一个夜活门工作

### 如何安装 @agenticprimitives/create-app？

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

### @agenticprimitives/create-app 支持 TypeScript 吗？

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

### @agenticprimitives/create-app 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/create-app 可以商用吗？

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

### @agenticprimitives/create-app 的下载量有多少？

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

### @agenticprimitives/create-app 还在维护吗？

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