@ethisyscore/plugin-ui (英语)

EthysCore插件的平台反应前端基础. 它给出了插件 将单片反应特性提升到插件表面所需的一切: 页 并覆盖工厂,一个静态 useView 适配器,一种 MCP-over-hoks 服务 层, 反应- 平滑 / 反应- router shims, 范围化样式, 相邻图标集, 和共享的 MUI 组件表面外接到主机实例.

MUI 7或更新. 可选 @mui/material 端点是 >=7,匹配主机和沙盒主题工具包(它使用MUI 7-只使用API).

平台反应是高信任级(RFC0003),仅限于 第一当事方 PlatformPlugin 建设。 见上层 渲染模式概览 编辑 平台反应作者指南。 。 。 .

导出表面

典型用途

// A PlatformReact page module the host dynamic-imports at surface mount.
import { definePlatformReactPluginPage } from "@ethisyscore/plugin-ui/platform-react";
import { useView } from "@ethisyscore/plugin-ui/platform-react";

function MyFeaturePage() {
  const View = useView("my-feature/list");
  return <View />;
}

export default definePlatformReactPluginPage(MyFeaturePage);

帮手们做的 没有 直接调用 MCP 工具—— 将每个被调用者域包入一个已键入 服务扩展 BaseMcpService 并消耗它通过 useToolInvoker。见 最高层的 README §“服务于 MCP”和 FE 移民游戏本。 。 。 .

正在上传浏览器文件

浏览器上传 useUploadToStorage 输入应用程序自己的插件存储。 Never base 64 通过工具调用文件 .

import { useUploadToStorage, isPluginStorageUploadError } from "@ethisyscore/plugin-ui/platform-react";

const { upload, loading, error } = useUploadToStorage();

async function onFile(file: File) {
  try {
    const { path } = await upload(file, { pathPrefix: "cvs" });
    await recordCv({ path }); // the app's own command; the backend reads `path` via IPluginStorage
  } catch (err) {
    if (isPluginStorageUploadError(err) && err.reason === "quota_exceeded") { /* ... */ }
  }
}

前缀为一个或多个 /- 分开 [A-Za-z0-9_-] 片段,最多84个字符,没有前行或后行 /它被拒绝,从未修复。 文件上限为 30 MB, 只允许列出被动类型( M)PLUGIN_STORAGE_UPLOAD_CONTENT_TYPES页:1 见 能力.md 完全规则和错误的原因.

构建和测试

npm ci && npm run build && npm test

最后更新:2026-07-10