# @ethisyscore/vite-plugin 中文文档

规范地址：https://npmcn.com/package/%40ethisyscore/vite-plugin/

版本：1\.167\.0
npm 元数据更新时间：2026-10-25T16:31:42.209Z
中文译文更新时间：2026-11-13T23:48:00.124Z
软件包许可：SEE LICENSE IN LICENSE

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

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

弃用说明：This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

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

- 包体积（解压后）：415 kB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- peer 依赖：vite ^8\.0\.0，typescript \>=5\.0\.0
- 首次发布：2026-03-20T16:31:08.076Z
- 最新版本发布：2026-10-24T20:25:26.268Z
- 近 30 天下载量：7900（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：314（近 12 个月 314 个）

## 中文简介

EThisysCore Contract A插件的Vite插件: 显示驱动的 HTML 切入点(legacy iframe mode) 外加构建时的 STUI/Reactive Rules schema 验证和声明资源排放.

## 安装

```sh
npm install @ethisyscore/vite-plugin
```

也可以使用：`pnpm add @ethisyscore/vite-plugin`、`yarn add @ethisyscore/vite-plugin`、`bun add @ethisyscore/vite-plugin`

## README

# @ethisyscore/vite-plugin (中文(简体) )

EthysCore 插件侧面的 Vite 插件收藏 。 它提供 为平台支持的每个 UI 渲染模式构建通道 – 显示驱动 HTML条目,合同A SDUI计划验证和排放,合同B 工人捆绑,平台反应多页捆绑管弦乐器,以及 Tier U iframe-sandbox pass —— 外加从插件中获取表单的代码 `routeMeta.json`。 。 。 .

> 交集模式/信任层面概览见 [顶级读取器](https://npmcn.com/package/README.md#render-modes--three-ui-contracts)。用于 每个合同作者的行走记录 [`docs/authoring/`](https://npmcn.com/package/docs/authoring/README.md)。 。 。 .

## 导出表面

每个 Vite 插件厂返回一个标准 Vite `Plugin`; 电线那一个(s) 匹配您的渲染模式为 `vite.config.ts`。 。 。 .

| 导出 | 目的 |
| --- | --- |
| `ethisysContractAPlugin` | **合同A** 通过 ——对照已关闭词汇验证 SDUI 树,并在构建时释放声明资源/反应规则 |
| `validateDeclarativeResource`, (中文(简体) ), `validateReactiveRule` | 独立的SDUI + 反应规则验证器(`ValidationResult` 编号 : `ValidationFailure`用于测试和工具 |
| `ethisysContractBPlugin` | **合同B** 通过——发送Web Worker捆绑及其导入地图(`CONTRACT_B_SEMANTIC_PRIMITIVES`, (中文(简体) ), `CONTRACT_B_RUNTIME_IMPORTS`, (中文(简体) ), `CONTRACT_B_IMPORT_MAP_ALLOWLIST`(中文(简体) ) |
| `ethisysPlatformReactPlugin` | **平台反应** 通过 – 每个申报页面构建一个无害环境管理捆绑 |
| `buildPlatformReactPages`, (中文(简体) ), `rewriteAliasedExternalImports`, (中文(简体) ), `virtualPageEntry` | 多块管弦乐器:每页一个孤立的Vite子架构,主机-外部调试(`PLATFORM_REACT_EXTERNALS`, (中文(简体) ), `PLATFORM_REACT_DEDUPE`)和主机装入器导入重写 |
| `generatePlatformReactManifest`, (中文(简体) ), `computePlatformReactPages` | 构建步码源( E) `feature.manifest.json` +该 `extension.manifest.json` 重叠从 `routeMeta.json` |
| `parseExportedNames` | 一个模块的源文本的运行时名导出——代码源如何解决其导出名称与其文件名不同的视图 |
| `parsePlatformReactPages` | 测试快照测试平台的辅助工具 |
| `ethisysIframeSandboxPlugin`, (中文(简体) ), `buildIframeSandboxPages` | **U级** iframe-sandbox通过——有SHA-256文摘排放的跨原生沙箱页面 |
| `ethisysManifestPlugin` | 后遗症表型驱动传出——自动传出 `index.html` 宣布为 `source` 字段 |

## 典型用途

```ts
// vite.config.ts for a PlatformReact plugin
import { defineConfig } from "vite";
import { ethisysPlatformReactPlugin } from "@ethisyscore/vite-plugin";

export default defineConfig({
  plugins: [ethisysPlatformReactPlugin({ /* manifest + page options */ })],
});
```

大多数插件从不直接调用这些.. `cc package` 驱动正确的通过 用于该插件所声明的渲染模式。 当你维持时,到达工厂 (a) 在测试中标出或需要验证器/编码.

### 怎么样 `generatePlatformReactManifest` 决定 a `useView` 名称

每页 `useView("<module>", "<Name>")` 呼叫成为该页面的一个条目 `views` 地图,以及 `build-pages` 用电线接它 **名称** 导入 (单位:千美元)`import { <Name> } from "<adapter module>"`) (中文(简体) ). `<Name>` 解决 适配器树, 按此顺序 :

1.  **按文件名** - 一个适配器文件,其基名是 `<Name>` (例如:. `CompanyCostsView` → `src/adapter/finance/CompanyCostsView.tsx`) (中文(简体) ). 这是 原创且仍为取胜规则, 因此遵循文件名的插件 公约一如既往地解决了问题.
    
2.  **按导出名称** - 否则,单一适配器文件: _出口_ `<Name>`。适配器文件可以合法地以名称导出其组件 其文件名以外的文件名 :
    
    ```tsx
    // src/adapter/chat/ChatChannelCreateFormView.tsx
    export function ChatChannelCreateFormView(/* … */) { /* … */ }
    export { ChatChannelCreateFormView as ChatChannelCreateForm };
    ```
    
    `useView("chat", "ChatChannelCreateForm")` 运行时正确, 现在 生成. `export function|const|let|var|class X`, (中文(简体) ), `export { X }`, (中文(简体) ), `export { X as Y }` 财务报告和审定财务报表 `export { X } from "…"` 全部数起.
    
    `export default …` 故意这样做 **没有** ——默认导出无法满足 命名的导入—— 也不适用于纯类型出口( q)`export type` 编号 : `export interface`),在运行时被去除. `export * from "…"` 离开 因此,只有这样才能到达的视图仍然报告为 取而代之的是无法解决的,而不是被错误地解决.
    
3.  **两个文件导出同名文件** − 生成器失败, 命名每个 候选人。 选择一个会编译,然后使组件出错 。 给 基准名(规则1总是胜出)或重命名视图的预定文件.
    
4.  **没有匹配** − 生成器失败(除非 `strict: false`) (中文(简体) ). 此错误 传递点 : `useView` 是一个表征,不是导入,所以 令人不满意的呼叫使得"View不可用"在绿色建筑后方的运行时间.
    

## 退休的 SDK 软件包

平台反应构建拒绝导入已退休的 SDK 软件包, 将文件和固定命名 (单位:千美元)`RETIRED_SDK_PACKAGES`, (中文(简体) ), `rejectRetiredSdkPackages`) (中文(简体) ). `@ethisyscore/core-utils` 是第一个:运行

```bash
npx ethisyscore-migrate-core-utils            # in the plugin's UI folder; --dry-run to preview
npm install
```

它重写每个核心用途导入( 组织格式化为 `@ethisyscore/plugin-ui/org-format`, (中文(简体) ), 其他的都给 `@ethisyscore/foundation-utils` 在同一个子路径),并互换依赖性 `package.json`。见 [向核心用途迁移](https://npmcn.com/package/docs/authoring/migrating-off-core-utils.md)。 。 。 .

## 构建和测试

```bash
npm ci && npm run build && npm test
```

> 最后更新:2026-07-10

## 常见问题

### @ethisyscore/vite-plugin 是什么？

EThisysCore Contract A插件的Vite插件: 显示驱动的 HTML 切入点\(legacy iframe mode\) 外加构建时的 STUI/Reactive Rules schema 验证和声明资源排放\.注意：该包已被作者标记为弃用——This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

### 如何安装 @ethisyscore/vite-plugin？

在项目目录运行 npm install @ethisyscore/vite-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vite（^8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 ethisyscore-migrate-core-utils，可以用 npx ethisyscore-migrate-core-utils 直接运行。

### @ethisyscore/vite-plugin 支持 TypeScript 吗？

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

### @ethisyscore/vite-plugin 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ethisyscore/vite-plugin 需要什么版本的 Node\.js？

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

### @ethisyscore/vite-plugin 可以商用吗？

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

### @ethisyscore/vite-plugin 的下载量有多少？

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

### @ethisyscore/vite-plugin 还在维护吗？

最新版本 1\.167\.0 发布于 2026/10/25（20 天前）；至今共发布 314 个版本，其中过去 12 个月发布了 314 个；首次发布于 2026/03/21。作者已将其标记为弃用，新项目建议寻找替代方案。