# @eaera-com/cms-sdk 中文文档

规范地址：https://npmcn.com/package/%40eaera-com/cms-sdk/

版本：0\.2\.1
npm 元数据更新时间：2026-11-13T02:46:38.130Z
中文译文更新时间：2026-11-14T11:41:33.145Z
软件包许可：SEE LICENSE IN LICENSE

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

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

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

- 包体积（解压后）：1.5 MB，349 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：2 个
- peer 依赖：vue ^3\.5\.0，pinia ^3\.0\.4
- 首次发布：2026-09-15T11:38:55.492Z
- 最新版本发布：2026-11-13T02:46:37.876Z
- 近 30 天下载量：2063（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：57（近 12 个月 57 个）

## 中文简介

EAERA CMS SDK – Nuxt 4应用软件的数据访问层(fetch + Pinia + 类型服务)

## 安装

```sh
npm install @eaera-com/cms-sdk
```

也可以使用：`pnpm add @eaera-com/cms-sdk`、`yarn add @eaera-com/cms-sdk`、`bun add @eaera-com/cms-sdk`

## README

# @eaera-com/cms-sdk (英语)

EAERA CMS 前端的数据访问层:输入服务结束 `ofetch`皮尼亚商店,还有Nuxt 为 Nuxt 4 应用程序处理 httpOnly Cookie 签名的模块。 Nuxt 4在CI中由Nuxt 4.5证明 fixture app (英语:`fixtures/nuxt4`); 模块还声明 Nuxt `^3.0.0`,它被宣布,而不是重新证明.

-   当前版本 : **0.2.0 (中文(简体) )** (单位:千美元)`package.json`; 用 `npm view @eaera-com/cms-sdk dist-tags`。 。 。 .
-   拥有者: **人员团队** (自2026-11-03起) (中文(简体) ). 代码所有者 : `@vietnq1806` (单位:千美元)`.github/CODEOWNERS`) (中文(简体) ).
-   变化 : [`CHANGELOG.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/CHANGELOG.md)。 。 。 .

## 安装

该软件包在 npmjs 上公开, 不需要任何符号 :

```bash
pnpm add @eaera-com/cms-sdk
```

`pinia` (^3)和 (中文(简体) ) `vue` (^3.5)是同级依赖关系. 狦 `.npmrc` 静态地图 `@eaera-com:registry` 到 GitHub 软件包,您不会看到新版本;见 [`docs/npm-publishing.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/docs/npm-publishing.md) 第4节.

## 入境点

| 导入 | 这是什么 |
| --- | --- |
| `@eaera-com/cms-sdk` | `createCmsSDK()`,域服务(包管理是 `sdk.packs` 自0.2.0起;v2 `people` 皮尼亚商店`useAuthStore`, (中文(简体) ), `useContentStore`,(......), `createPersistPlugin`,常数和类型。 在浏览器和服务器上运行: 它导入不 `h3`。 。 。 . |
| `@eaera-com/cms-sdk/nuxt` | Nuxt 模块( 配置密钥) `cmsSdk`: 建设 `$cms`连接商店和饼干 并登记 `/api/cms/*` 财务报告和审定财务报表 `/api/cms-sdk/*` 路由; 每一部分都可以被关闭(`stores`, (中文(简体) ), `persist`, (中文(简体) ), `serverRoutes`, (中文(简体) ), `wsAutoOpen`,参见 `USAGE.md` 第2.1.1节. |
| `@eaera-com/cms-sdk/server` | 只为应用程序的 Nitro 路由提供服务器帮助( 它们导入) `h3`: QuenPaw帮助者 `postConsoleChatError`, (中文(简体) ), `QwenpawConfigError`, (中文(简体) ), `QwenpawUpstreamError`, (中文(简体) ), `listQwenpawChats`, (中文(简体) ), `listQwenpawGroups`, (中文(简体) ), `getQwenpawChatMessages`, (中文(简体) ), `deleteQwenpawChat`, (中文(简体) ), `fetchChatHistory`. 在根条目上直到0.1.116. |
| `@eaera-com/cms-sdk/engine` | 自0.2.1起:一个应用程序的同源引擎客户端,其自己的服务器代理引擎并保持会话(页面上没有符号): `createEngineTransport`, (中文(简体) ), `createEngineClient`, (中文(简体) ), `createRegistry`,映射器(`fromWire` 编号 : `toWire`),道卫也`segment`和拒绝正常人(`normalise`, (中文(简体) ), `RefusalPolicy`) (中文(简体) ). 浏览器安全, 独立于 `$cms` 财务报告和审定财务报表 `CmsError`; 见 `USAGE.md` 第4.4.节. |

最小 Nuxt 设置 :

```ts
export default defineNuxtConfig({
  modules: ['@pinia/nuxt', '@eaera-com/cms-sdk/nuxt'],
  runtimeConfig: {
    public: { cmsUrl: 'https://cms.example.com', clientId: 'web' },
  },
});
```

## 文档

-   [`USAGE.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/USAGE.md) (越南名):全Nuxt流:配置,登录,SSR /再装入, 登录,401刷新,存储数据的地方,模拟模式,故障排除.
-   [`docs/npm-publishing.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/docs/npm-publishing.md) (越南名):出版管道 一次性npm设置,发布步骤和消费方.
-   斯佩克枢纽(建筑、SRS、ADRs、释放计划): `cbs/cms-sdk/` 输入 `eaera-docs` 仓库.

## 释放

出版只使用标记(ADR-004). 推动或合并到 `main` 发表什么。 A 类 `vX.Y.Z` 标签在一个 承诺,这是 `main` 5后向 npmjs 发布 `ci.yaml` 检查合格(类型检查、测试、, 构建 + publint + `scripts/check-package.mjs`,格式,以及 `fixture-nuxt4`: Nuxt 4.5固定应用程序 并且只有在 `package.json` 具有相同的版本,并且 `CHANGELOG.md` 有一个 `## X.Y.Z` 条目为 a `Consumer action:` 线条和 a `Checked against:` 线条。 标记 `vX.Y.Z-next.N` 发布到 `next` dis.

仅 `@vietnq1806` 推动 `v*` 标签。 存储器在GitHub Free计划(ADR-004修正案, 因此GitHub没有执行分支保护、代码所有人审查或标签限制。 这些 规则是团队纪律:每一次改变都要经过一个公关,其中五个检查是绿色的,并由 `@vietnq1806`逐步指示和接受的残余风险 [`docs/npm-publishing.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/docs/npm-publishing.md) 第3和5条.

## 许可证

见 [`LICENSE`](https://npmcn.com/package/%40eaera-com/cms-sdk/LICENSE) 财务报告和审定财务报表 [`THIRD-PARTY-NOTICES.md`](https://npmcn.com/package/%40eaera-com/cms-sdk/THIRD-PARTY-NOTICES.md)。 。 。 .

## 常见问题

### @eaera-com/cms-sdk 是什么？

EAERA CMS SDK – Nuxt 4应用软件的数据访问层\(fetch \+ Pinia \+ 类型服务\)

### 如何安装 @eaera-com/cms-sdk？

在项目目录运行 npm install @eaera-com/cms-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.0）、pinia（^3\.0\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @eaera-com/cms-sdk 支持 TypeScript 吗？

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

### @eaera-com/cms-sdk 支持 ESM 还是 CommonJS？

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

### @eaera-com/cms-sdk 需要什么版本的 Node\.js？

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

### @eaera-com/cms-sdk 可以商用吗？

@eaera-com/cms-sdk 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @eaera-com/cms-sdk 的下载量有多少？

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

### @eaera-com/cms-sdk 还在维护吗？

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