dsh-ui-design
Verified@philomelcc/dsh-ui-design · v0.3.2 · MIT · Web UI
UI design knowledge base for DeepSeek Harness: filterable design cards with live demos, per-design implementation prompts, usage/caution notes, and an agent tool that finds and applies them.
Install
dsh plugin add @philomelcc/dsh-ui-design Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
DSH UI 设计知识库
给 DeepSeek Harness(dsh)用的前端设计知识库:99 项可复用设计,每项带 tag、可交互 demo、适用/不适用场景、一套实现提示词。
- 给 AI 用:agent 做前端任务时先按场景搜,匹配到就取提示词和 demo 当实现依据;没有合适的就自己设计,不硬套。
- 给人用:页面里按 tag 筛选、点卡片看 demo(可交互)、复制提示词给任何 AI,或复制 JSON。
- 不需要 dsh 也能看:仓库里带一个纯静态展示版。
安装
dsh plugin --profile web add @philomelcc/dsh-ui-design
装好后重启一次 dsh web。入口有两种形态:
- 装了
@philomelcc/dsh-workbench:出现在工作台第二行的 tab「UI设计」; - 没装工作台:出现在第一行系统栏(
sidebar.panellist),点图标打开页面。
首次启动会把包内 data/ 的 99 项设计写入 ~/.dsh/storages/ui-design/,之后只读你的数据,不再覆盖。
agent 侧
插件注册一个 ui_design 工具:
| action | 作用 |
|---|---|
search |
按场景/关键词搜候选(返回名称/tag/场景,不带 demo) |
get |
取某项的完整提示词 + 适用场景(includeDemo=true 连 demo 代码一起) |
create / update / delete |
新建 / 修改 / 删除设计(自然语言即可) |
guide |
读《设计规范》(写 demo 前必读) |
tags / list |
标签概览 / 分页浏览 |
系统提示会告诉 agent:做前端 UI 任务前先搜索;匹配后以 prompt 和 demo 为实现依据、逐条对照,不要凭印象简化。
展示版(不需要 dsh)
npm run site # 把 data/ 同步到 site/data/ 并起本地服务
# 或
node site/serve.mjs # 直接起,默认 http://127.0.0.1:3090
展示版功能:卡片网格(分页)、tag 筛选、标签输入搜索、弹窗 demo、复制提示词/JSON、配色方案 直接作为主题切换。
检索
默认零依赖:关键词 + 同义词表(data/synonyms.json)+ 中文 2 字滑窗拆词 + 字面兜底(bigram)。
装完就能搜,不需要任何外部服务。「对话框」能召回「弹窗」,「列表转圈」能召回加载类。
可选:语义重排。如果你有 OpenAI 兼容的 embedding 端点(本地 LM Studio / ollama / 自建都行),
在 ~/.dsh/storages/ui-design/config.json 里配一下,search 会对关键词候选做一次向量重排:
{
"embedding": {
"enabled": true,
"endpoint": "http://127.0.0.1:1234/v1",
"model": "text-embedding-nomic-embed-text-v1.5"
}
}
- 没配就完全跳过,行为和默认一致;
- 向量缓存写在
~/.dsh/storages/ui-design/vectors.json,设计内容变了自动重算那一条; - 只对候选做重排(不是全库召回),一次查询只多一次 embedding 请求;
- 以后接本地 WASM embedding 时复用同一份
embedTexts/ 缓存格式,配置项不变。
数据
- 包内
data/:初始设计库(index.json元数据 +designs/<id>.json单条完整内容)。 - 运行时
~/.dsh/storages/ui-design/:同结构,你的增删改都在这里。 - 2000+ 项时索引约 1.6MB,可一次加载;单条 demo 按需读取。
贡献
欢迎加设计、修 demo、提问题。提交前请读 设计规范.md——每项设计必须能通过「写 demo 前自检」那节。
- 加一项设计:在页面里「+ 新建设计」,或在任意 dsh 会话里说「新建一个设计:……」;
- 导出到仓库:
node scripts/export-data.mjs(把~/.dsh/storages/ui-design/同步回data/); - 跑
node scripts/validate.mjs(待补)确认数据格式; - 提 PR。
License
MIT