dsh-design-library
Verified@ztr66/dsh-design-library · v0.6.4 · MIT · Web UI
Design and video library for DeepSeek Harness: 716 indexed entries covering 256 design systems, 97 visual styles, 124 shot recipe cards and 204 craft documents, plus computed review, render-environment checks and overlap/overflow detection.
Install
dsh plugin add @ztr66/dsh-design-library Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-design-library
为 DeepSeek Harness 做的设计库插件:查规范、审 UI、做视频,三件事共用一套可检索的资料库。
622 条索引——269 份设计规范、44 种视觉风格、124 张镜头配方卡、70 份工艺文档、115 个设计技能。可搜索、可读全文、可插进对话,评审与视频工具能直接调用。
它做什么
一、浏览与插入
侧边栏多一个入口,打开全库。按类型筛选(设计规范 / 技能 / 视频风格 / 镜头卡 / 工艺文档)、全文搜索、读正文、把一份插进当前对话。
二、模型自己会挑的技能
有用的那些注册进技能目录,需要做设计任务时模型自己加载。默认「精选」,可在设置里改成全部或关闭。
三、会计算的评审
design_review 不是把规范复述一遍,而是真的去量:
- 系统自己声明的每一对
on-<x>的 WCAG 对比度,以及「没有任何已声明文字色能达到 AA」的表面 - 你文件里不在色板中的颜色字面量,带行号
- 声明的字体族之外的字体,以及不在圆角刻度上的值
每条结论都写明用了哪两个 token、算出的数字是多少,可以被复核而不是被相信。
四、量布局
layout_check 在真实浏览器里渲染后测量,而不是解析 CSS——「会不会重叠」是布局问题,不是声明问题。padding、负 margin、transform、网格叠放、fixed 定位都会改变结果,静态读 CSS 一定读错。
三类问题:
- 出界:超出页面右缘或底部,或被父容器
overflow: hidden裁掉 - 重叠:两个不该共享空间的盒子叠在一起
- 压字:文字压在文字上,这一律是缺陷
父子里包含不算重叠——那是包含关系,不是碰撞。先按这个规则剔除,剩下的才是真正误放的。
每处都给出两侧元素的路径、坐标、尺寸和文字,以及重叠面积占较小盒子的百分比。
五、做视频
这是 0.3.0 之后加的。插件不渲染视频——渲染交给 ffmpeg + 无头浏览器。插件负责的是另外四件更容易出错的事:
先看见整个库。 video_guide 是 0.6.1 加的。调任何搜索工具之前先调它:它把五步流程按顺序列出来(题材 → 风格 → 结构 → 镜头 → 动效),44 个风格按题材和家族各列一遍,124 张镜头卡按功能分组。搜索工具只能回答你已知怎么问的问题——没看过这个库的模型会去猜关键词,而猜出来的多词查询通常返回 0 条。实测有一条会话 9 次调用里 4 次是这么失败的。
选对视觉语言。 44 种风格,每种带精确 HEX、字体、动效时序、镜头语法,以及三张清单:放心改 / 一改就变味 / 不能改。比如 粉笔黑板:
配色:板 #1F4A42 · 白粉笔 #EEECE3 · 黄粉笔 #F5D76E · 粉粉笔 #F28B82
不能改:去掉粉笔颗粒滤镜
一改就变味:字一次性出现(失去板书感)
知道下一秒拍什么。 124 张镜头配方卡,每张给出用途、时长(精确到帧)、能量级别、导演意图、参数表,以及这张卡最容易踩的坑。不是「做个高级转场」,而是「飞行 36–64 / 96–128 / 158–190 帧,不对称 in-out bezier(0.62,0,0.16,1)」。
查得到具体数字。 0.6.1 起索引了 70 份工艺文档:动画原理(时长、缓动曲线、错峰偏移、弹簧参数)、叙事结构、声音设计、动效字体、数据动效、转场。0.6.1 之前索引只认 DESIGN.md、SKILL.md、STYLE.md,所以 structure-bible.md、animation-principles.md 这类平铺命名的方法文档全被漏掉了——风格和镜头卡还能用,但让动效有章法的那两层够不着。
环境自检。 video_env_check 报告这台机器能做什么、缺什么、用什么命令装。它按交付物分档判断,不是一个笼统的 ready:
silent: yes 静音成片
narrated: yes 有旁白
browserRendered: no 浏览器渲染(缺 playwright)
beatSync: no 踩拍点(缺 librosa)
还会指出 Python 环境分裂——edge-tts 在一个解释器、pillow 在另一个,一个脚本里既要配音又要渲染会 ImportError。
搜索行为像搜索了
两个搜索工具现在按相关度打分,不再做过滤。0.6.1 之前要求查询里每个词都出现在同一条目里,所以 高级 质感 界面 科技 是 0 命中——哪怕每个词都各自匹配了一个不同风格。现在命中的词加分,完全没命中的条目才被丢掉,多词查询得到的是一个排序结果而不是一片空白。
video_craft_read 也接受几种合理写法的 id。没看过库的模型会照着磁盘目录名编一个路径(video-styles/craft/structure-bible/SKILL),而真实 id 是 video-styles/craft/structure-bible;读取器现在会先归一化路径,再退回按末段路径、按文档标题匹配,都失败才报错。报错时也会给出同类文档的合法 id——旧提示只列了风格 id,等于什么都没教。
安装
桌面端:设置 → 插件,搜索 @ztr66/dsh-design-library。
或命令行安装后重启宿主:
dsh plugin --profile <你的 profile> add @ztr66/dsh-design-library
需要 DSH >=0.2.0-rc.1 与 Node 20+。
工具
设计
| 工具 | 用途 |
|---|---|
design_search |
按文字、来源或类型找文档,返回 id |
design_read |
读一份文档——全文、结构化变量、或只看章节 |
design_review |
拿文件或代码片段对照一份设计规范,返回可计算的结论 |
layout_check |
在真实浏览器里量出重叠、出界、被裁切的元素 |
视频
| 工具 | 用途 |
|---|---|
video_guide |
先调它。 整个库的导航图:五步流程、44 个风格按题材和家族分组、124 张镜头卡按类别分组。传 stage/topic/family/shotCategory 可收窄 |
video_style_search |
44 种视觉风格,按题材关键词或家族筛选 |
video_style_read |
读一套风格规范,或工艺文档 |
video_shot_search |
124 张镜头卡,按分类(开场/排版/转场/数据/收尾…)或功能搜 |
video_shot_read |
读一张卡的完整配方:帧号、曲线、参数表、坑 |
video_craft_read |
按 id 读任意工艺文档——叙事结构、动效原理、声音设计 |
video_env_check |
报告渲染环境,精确到缺哪个包、装什么命令 |
配置
在 cordis.patch.yml 里这个插件的行上配置:
- id: design-library
name: '@ztr66/dsh-design-library'
config:
skillMode: curated # curated | all | off
roots: [] # 额外扫描的本地目录
maxEntries: 5000
roots 放你自己的设计文档。内置内容始终可用。
做视频需要什么
插件只提供资料与自检,渲染链要自己装。跑一次 video_env_check 就知道缺什么:
| 组件 | 用途 | 装法 |
|---|---|---|
| ffmpeg | 编码、抽帧、混音 | ffmpeg.org |
| playwright | 无头浏览器逐帧截图 | npm i -D playwright && npx playwright install chromium |
| pillow | 直接画帧(不走浏览器) | pip install pillow |
| edge-tts | 中文旁白,8 个音色 | pip install edge-tts |
| librosa | BPM 与拍点,做音乐 MV 才需要 | pip install librosa |
不装 playwright 也能做:用 pillow 直接画帧、ffmpeg 编码,只是复杂效果受限。video_env_check 的 readyFor 会说明当前能做到哪一档。
插件不自带 BGM。 上游那首是作者授权给自家工具的,不能分发。配乐要么你给,要么本地合成。
内置内容的来源
data/ 下每一份都是第三方内容,按各自许可再分发。PROVENANCE.md 逐份写明来源仓库、许可与原路径,NOTICE 有完整署名。
许可分布:
| 许可 | 来源 | 义务 |
|---|---|---|
| MIT | 大部分 | 保留版权声明 |
| Apache-2.0 | video-shotcraft、modelstudioai | 保留声明,标注修改 |
| CC-BY-4.0 | smixs/visual-skills | 必须署名 Serge Shima |
| BaoCut Community 1.0 | jimliu/baocut | 仅非商业分享,附完整许可 |
| 未声明 | reactvideoeditor、ali-abassi | 只收文档,不收源码 |
从 varghq/skills 的 76 个 skill 里只收了 14 个——够用的那些。剩下的电商广告、AI 角色生成、调用付费 API 的没拿,在本地渲染环境里跑不了,收进来只是噪声。
npm prepack 会跑 scripts/guard-publish.mjs:任何一份内置文件哈希变过、或混进了许可不允许的内容,打包直接失败。
重新生成内置数据
npm run sync # 从本地 checkout 重建 data/ 与 PROVENANCE.md
node scripts/sync.mjs --dry-run # 只看报告,不写盘
视频资源走单独的抓取脚本(用 git 稀疏克隆,避开 GitHub API 限速):
pwsh -File scripts/fetch-video-styles.ps1 # 44 套基础风格 + 工艺文档
pwsh -File scripts/fetch-video-extras.ps1 # 镜头卡 + 艺术风格 + 模板
pwsh -File scripts/fetch-video-wave3.ps1 # 动画原理 + 分镜法 + Manim
pwsh -File scripts/fetch-video-wave4.ps1 # 声音 + 动效字体 + 着色器
已知限制
- 面板按等宽文本显示正文,不做 Markdown 渲染
- 不打包上游仓库的图片、视频、音频资源,只有文本
- 评审只管颜色、字体与圆角,不评估布局、动效与组件结构
- 视频工具提供资料与自检,不渲染视频——渲染脚本要自己写
- 插件不自带 BGM 与配音音色,受上游许可限制
许可
插件代码 MIT。内置文档保留各自原许可,见 PROVENANCE.md 与 NOTICE。