西西弗组件库预览地址

快速上手

西西弗4 基于 antd@6 版本开发

React 版本支持

本组件库支持 React 18.0+ 和 React 19.x：

• ✅ React 18.0.0 - 18.x.x（最低支持版本）
• ✅ React 19.0.0+（最新版本）

推荐版本：

• 生产环境：React 18.3.1 或 React 19.x
• 开发环境：React 19.x（本地验证最新特性）

peerDependencies：

{
  "react": "^18.0.0 || ^19.0.0",
  "react-dom": "^18.0.0 || ^19.0.0",
  "ahooks": ">=3.9.5"
}

注意（v4.2.0+）：ahooks 已从 dependencies 移至 peerDependencies，需要在消费者项目中单独安装：

npm install ahooks
# 或
yarn add ahooks

安装

npm 或 yarn 安装

# npm
$ npm install @zat-design/sisyphus-react --save

# yarn
$ yarn add @zat-design/sisyphus-react

按需加载

自动 Tree-Shaking

本组件库已配置 sideEffects，现代打包器（Webpack 5+、Vite、Rollup）会自动进行 tree-shaking，无需额外配置：

// 只会打包 ProForm 相关代码，其他组件会被自动剔除
import { ProForm } from '@zat-design/sisyphus-react';

使用示例

import React from 'react';
import { createRoot } from 'react-dom/client';
import { ProForm } from '@zat-design/sisyphus-react';

const App = () => {
  return (
    <ProForm
      columns={[
        {
          type: 'Input',
          label: '姓名',
          name: 'name',
          rules: [{ required: true, message: '请输入姓名！' }],
        },
      ]}
    />
  );
};

createRoot(document.getElementById('root')!).render(<App />);

开发指南

本地开发

本项目当前依赖链包含旧版 Umi/Dumi 与 React 19 的 peer dependency 冲突，使用 npm 安装时会自动启用 legacy peer 解析：

npm install --legacy-peer-deps

yarn install
yarn start

运行测试

yarn test
yarn test:coverage  # 带覆盖率

四包统一发布

# 日常 beta：要求根版本含预发布标识，如 4.5.7-beta.2
yarn release:beta

# 周五正式版：要求根版本不含预发布标识，如 4.5.7
yarn release

# 校验、构建、跑完组件/MCP/Scene/CLI 测试并预览 pack，不发布
yarn release:check

发布前只需手工修改根 package.json 的 version。命令会同步 MCP、Scene、CLI、文档和契约版本，再按组件库 → MCP → Scene → CLI 发布。发布模式会先查询四包的精确版本：已存在的包直接跳过该包的生成、测试、pack 和 publish，仅对缺失包执行所需的构建与校验；release:check 则仍执行完整预检且不发布。release:beta 中 CLI 同样使用 beta 标签，release 中使用 latest。安装可继续使用 npmmirror，发布固定走 https://registry.npmjs.org/。npm 的浏览器登录/2FA 提示保持原样；中途失败后重跑同一命令，会快速跳过已经存在的同版本包并继续。

技术栈

• React 18.3+ / React 19
• Ant Design 6.x
• TypeScript
• Less