Design ContextGo
npm 包名为 design-contextgo,主命令为 contextgo,同时提供 design-contextgo 命令。
6.1 原生提供只读的 contextgo preflight / contextgo govern 与严格 contextgo gate。配置项目主题真源和 governance.checks,即可检查 token、shadcn 组件约定、真实示例并依次执行测试和构建,见设计治理。工具仓库自身也已接入真实组件与规范文档;自身目录不作为预装组件分发。
Design ContextGo 是项目自己的组件工作台。沿用原来的界面和交互,直接读取真实组件与示例,自由拖拽整理目录,在画布中预览、调参、查看文档与源码,再进入实际项目验证。
在项目中安装开发依赖:
npm install -D --save-exact [email protected]
npx design-contextgo workbench --port 6006
在项目中添加 contextgo.config.ts:
import { defineWorkbench } from 'design-contextgo/config'
export default defineWorkbench({
id: 'my-project',
stories: ['src/**/*.stories.tsx', 'src/**/*.demo.tsx'],
preview: 'src/stories/preview.tsx',
appUrl: 'http://localhost:7789',
})
- 一个组件入口,以项目组件为主体,Antd 补充适用变体。组件文档、AI Spec、Token 映射统一归属;跨组件指南放在「文档」。
- 组件目录来自项目文件,没有预装组件,也不会向项目复制一套基础组件。
- 自建分组、拖拽移动和排序、菜单移动、搜索、导入导出,按项目自动保存。
- 画布提供视口、缩放、重载、全屏和可调整的参数面板。参数支持草稿、应用、撤销、重置;不会自动写源码。
- 文档保留全部示例和状态,源码读取实际示例文件,事件面板记录组件动作。
- 工具 UI 使用 Design ContextGo 原来的 Tailwind 组件和 token。预览使用消费项目自己的 Antd v6、Tailwind 或其他 React 组件及主题。
design-contextgo/preview/design-contextgo/testing兼容已有 CSF 示例。Storybook 仅作为预览与 Autodocs 执行适配器;不运行完整管理界面。
npx design-contextgo build --out-dir contextgo-static
生成可部署的静态工作台,支持放在站点子目录。运行命令不会自动打开浏览器或安装业务组件。Design Token 一级页面复用 Antd 官方编辑器,与参数面板同步;只有点击“保存到项目”才写回已配置的 token 源文件。