dsh-ui-ux-pro-max
chenyiming-aaa/dsh-ui-ux-pro-max
DeepSeek Harness 向けのオフラインファースト UI/UX デザイン知能ライブラリ。design_recommend、design_review、design_search ツールに加え、84 種のデザインスタイル、192 種のカラーパレット、74 のフォント組み合わせ、99 の UX ガイドライン、25 種のチャート、22 の技術スタックを内蔵し、中国語優先で実行時依存なし。
インストール
dsh plugin --profile web add github:chenyiming-aaa/dsh-ui-ux-pro-maxREADME
dsh-ui-ux-pro-max
DeepSeek Harness 的 UI/UX 设计智能库插件:内置 84 种风格、192 个调色板、74 组字体、99 条 UX 规范、25 种图表与 22 个技术栈,全部离线可用、中文优先。
已发布到 npm:dsh-ui-ux-pro-max,可通过 DSH Desktop 插件市场一键安装。
兼容性:已在 DSH 0.1.1-rc.2(
@deepseek-ai/dsh、dsh-tools、dsh-skill0.1.1-rc.2)上实际验证——三个工具的定义编译、执行、输出 schema、render、presentCall 与内置技能注册全部通过。
功能特性
- 三个模型工具 —
design_recommend生成完整设计系统、design_review按 99 条 UX 规范审查 UI、design_search检索领域/技术栈数据库 - 数据完全内置 — 4200 行数据库随插件打包,零网络、零 Python、零第三方运行时依赖
- 中文优先 — 全中文输出;内置 300+ 中文术语→英文词典与 CJK 分词,输入「金融 SaaS 数据看板」即可命中
- 设计旋钮(1-10)—
variance大胆度 /motion动效强度(附 GSAP 方案)/density密度 - 纯 JS 重写 — 上游 Python 实现整体重写为 BM25 检索引擎 + 设计系统生成器
快速开始
方式一:插件市场安装(推荐)
插件已发布到 npm(dsh-ui-ux-pro-max@1.0.3),可直接在 DSH Desktop 插件市场中搜索安装;或使用 CLI:
dsh plugin --profile desktop add --save-exact dsh-ui-ux-pro-max@1.0.3 # DSH Desktop
dsh plugin --profile web add --save-exact dsh-ui-ux-pro-max@1.0.3 # dsh web
💡 提示:DSH Desktop 不把
dsh命令加入 PATH——请新开一个终端(桌面版自带 host-commands);若仍提示找不到命令,先执行npm install -g @deepseek-ai/dsh。
方式二:一键安装
git clone https://github.com/ChenYiming-aaa/dsh-ui-ux-pro-max.git
cd dsh-ui-ux-pro-max
powershell -ExecutionPolicy Bypass -File .\install.ps1
脚本自动完成:将插件复制到 profile 的共享 node_modules(默认 C:\Users\<用户名>\.dsh\profiles\node_modules\dsh-ui-ux-pro-max\)、备份并追加 cordis.patch.yml,重复执行不会重复添加。
方式三:手动安装
-
克隆仓库,把整个
dsh-ui-ux-pro-max目录放入 profile 的共享 node_modules(DSH Desktop 与 Web 端共用此层):C:\Users\<用户名>\.dsh\profiles\node_modules\dsh-ui-ux-pro-max\ -
编辑 profile 下的
cordis.patch.yml,追加注册条目:- insert: - id: ui-ux-pro-max name: dsh-ui-ux-pro-max config: {} -
重启 DSH Desktop 或
npx @deepseek-ai/dsh web,模型即可在对话中直接调用三个工具(纯宿主端形态,无需客户端 UI)。
工具速查
| 工具 | 用户这样问 | 工具做什么 |
|---|---|---|
design_recommend | 「帮我的金融 SaaS 数据看板出一套设计方案」 | 返回完整设计系统:推荐风格(带理由)→ 配色 HEX 与 CSS 变量 → 字体搭配 → 落地页模式 → UX 规范要点 |
design_review | 「检查一下我的登录页有什么 UX 问题」 | 按 99 条 UX 规范 + 移动端 + React 性能规范审查,按严重度排序给出问题清单与修改建议 |
design_search | 「我想要毛玻璃 深色风格 / React 导航性能怎么做」 | 按领域或技术栈检索内置数据库,命中风格、配色、图表、动效等具体条目 |
三个工具均返回结构化、中文、带理由的结果,模型可直接在对话中调用。
内置数据库
全部数据随插件离线打包,零网络依赖:
| 类别 | 内容 |
|---|---|
| 🎨 设计素材 | 风格 84 · 调色板 192 · 字体搭配 74 · 图表 25 · 落地页模式 34 |
| 🧩 组件与动效 | 图标 105 · GSAP 动效 16 |
| 📋 审查规范 | UX 规范 99 · React 性能 44 · 移动端接口 30 · 推理规则 161 |
| 📚 检索支撑 | 产品类型 192 · 技术栈 22 · Google 字体 1923(懒加载) |
使用示例
场景 1 · 新项目设计方案
你:帮我的金融 SaaS 数据看板出一套设计方案
模型调用 design_recommend,返回:推荐风格(rank 1-3 + 理由)→ 配色 HEX 与 CSS 变量 → 字体搭配 → 落地页模式 → 反模式清单 → UX 规范要点 → 技术栈规范。
场景 2 · 审查现有 UI
你:检查一下我的移动端登录表单有什么 UX 问题
模型调用 design_review,按严重度返回问题清单与修改建议,附交付前通用检查清单。
场景 3 · 检索设计灵感
你:想要毛玻璃 深色风格;React Native 列表导航性能怎么做
模型调用 design_search,分别命中风格条目与 React 性能规范。
目录结构
dsh-ui-ux-pro-max/
├── index.js # 宿主插件:3 个工具 + 内置技能
├── lib/ # BM25 检索 / 离线数据 / 中文词典 / 设计系统 / 审查构建 / 输出格式化
├── data/ # 内置数据库(index.json / fonts.json / meta.json)
├── skills/ui-ux-pro-max/ # 模型使用指南(中文 SKILL.md)
├── references/ # 交付前检查清单
├── examples/ # 设计系统落地示例(单文件、零依赖、可离线打开)
├── tests/ # 离线自检 + 清单/示例校验(CI 执行)
├── install.ps1 # 一键安装
└── cordis.patch.yml # bundle 注册
示例:把设计系统做成可运行的页面
examples/fintech-dashboard.html 是 design_recommend("金融 SaaS 数据看板", stack: react) 输出的落地示例:单文件、零第三方依赖(图表为手写 SVG / CSS)、可离线直接打开。
它演示了设计系统如何被真正遵守,而不是只写在文档里:
- 风格:Data-Dense Dashboard + Heat Map —— 12 列栅格、KPI 卡、趋势面积图、环形配置图、行业热力图、可排序表格
- 令牌:全部颜色/间距走 CSS 变量,浅深两套主题(正文对比度均 ≥ 4.5:1),页面内附「设计令牌」面板可展开核对
- 字体:Fira Code(数字/等宽对齐)+ Fira Sans(正文),离线自动回退系统字体栈
- 状态完备:加载骨架屏、空状态、状态提示条、禁用态
- 无障碍:语义地标、图标按钮
aria-label、表格aria-sort/scope、图表无障碍名称、focus-visible焦点环、prefers-reduced-motion、≥44px 触摸目标、安全区内边距 - 规范禁止项:无 emoji 图标(全部内联 SVG)
测试与验证
无需网络、无需 DSH 运行时即可复现全部检查(CI 在 Node 22 / 24 上运行):
node tests/check-package.mjs # 清单与数据完整性
node tests/smoke.mjs # 离线自检(30 项断言)
node tests/check-example.mjs # 示例页面规范校验(22 项)
check-package.mjs 覆盖历史上真实踩过的坑:package.json 的 UTF-8 BOM(会导致 DSH CLI JSON.parse 崩溃)、dsh.bundle.patch 缺失、files[] 指向不存在的文件、生命周期脚本(市场会拒绝安装)、cordis.patch.yml 的 insert 形状、data/*.json 可解析性与计数一致性。
smoke.mjs 覆盖插件行为:数据库完整性、design_recommend(中文查询 → 完整设计系统)、design_review(严重度排序)、design_search(领域/技术栈/中文映射)、中文结构化输出。
check-example.mjs 覆盖示例页面:脚本可编译、无障碍要点、令牌化程度、状态完备性、无 emoji 图标。
运行时兼容性另有一层验证:在真实 DSH 上校验工具定义编译、输出 schema、
render/presentCall与apply()注册(依赖本机 DSH 安装路径,故不随仓库分发)。
致谢
数据与算法移植自 nextlevelbuilder/ui-ux-pro-max-skill(MIT),针对 DSH 插件形态重写为纯 JS、离线、中文优先。参考:zhaiyateng/dsh-design-skills、Viger1/dsh-design、superdesigndev/superdesign-skill。
许可证
MIT © ChenYiming-aaa。第三方数据与算法来源详见 THIRD_PARTY_NOTICES.md。