前言¶
DSH 的插件体系里，设计相关的活儿通常被拆散在多个代理流程里：先出页面，再人工看效果，再改参数，最后自己拼 PPT。每一步的结果散落在对话和临时文件里，沟通成本高，结论也没有可复查的依据。yifeng123589/dsh-design-kit 做的事情是把这四件事收敛成一个技能入口加十个工具，并且把「选哪个方向」「调多少参数」这类主观判断换成有结构、可复核的流程。
先说明定位：这个包是 DeepSeek Harness（DSH）插件，不是通用 Skill 包。换成其他宿主不会自动获得工具，必须先注册相应的工具，或者按 skills/design-kit/SKILL.md 的脚本兜底执行。下面的介绍都基于这个前提展开。
这是什么¶
一句话定位：DSH 的统一设计交付插件，覆盖造页面、选方向、调参数、出 PPT 四个环节。
- 维护者：Yifeng123589
- 当前版本：0.1.5
- DSH 兼容版本：0.2.1-rc.5
- 依赖条件：Node >= 22
- 许可证：MIT
- 技能入口：一个
design-kit - 工具数量：十个，分为
design_*、probe_*、deck_*三组
它解决的问题是：设计交付没有统一的中间产物。页面、设计 tokens、选择记录、排版导出各自为政，异常时也无处可查。这个插件把记录、报告和导出打通，每一步的产物都落在确定路径上。
核心功能¶
十个工具如下，按用途分成三组。
设计相关：
design_lint：界面审查，输出 lint 报告，用来发现「AI 味」的页面问题。design_tokens：设计 tokens，管理颜色、字号等设计变量。design_capture：记录当前页面的设计快照。
探测相关：
probe_shortlist：多方向粗选，一轮给三个候选清单。probe_shortlist_preview：候选方案的效果预览。probe_shortlist_ui_action：在 Web 客户端里对候选做选择等交互，选择后回传结构化动作，使用一次性令牌。probe_measure：参数级精调，单轴盲测并给出 JND 区间。
PPT 相关：
deck_check：deck 质检。deck_export：导出 PPTX。deck_render：渲染 PDF/PNG。
Web 客户端提供粗选时用的三栏 iframe 预览，方便直接比较三个候选方向。
四类常见需求的对应关系：
| 你说的话 | 走哪条 | 产物 |
|---|---|---|
| 做个落地页 / 改界面 / 审 AI 味 | UI 交付 | 方向 + tokens + 页面 + lint 报告 + DESIGN.md |
| 三个方向选一个 / 都差点意思 | 粗选 | 每轮 3 候选、删除/待定/三选一、12 个封顶后归因 |
| 红色收一点 / 字号 16 还是 18 | 精调 | 单轴盲测 + 台账 + JND 区间 + calibration |
| 做成 PPT / 汇报 | PPT 交付 | deck_check → PPTX → PDF/PNG |
四条核心约束，属于设计方法上的硬性约定：
- 声明不是证据，代理不是证明，chip 只是弱先验，不是量化测量。
- 粗选固定 4×3=12，每轮最多 1 个待定，final 前自动做完整性校验。
- 精调一次只动一轴，结论写成等效区间，不写精确值。
- deck 链路依赖 ppt-master 加 Python 再加 LibreOffice Kit，缺依赖时返回结构化
missing[]，不假装成功。
安装与启用¶
官方推荐下载 GitHub Release 里的 runtime 包，不要用 git clone，也不要把 fixtures / docs 目录装进 DSH。
第一步，下载并解压 runtime 包：
dsh-design-kit-runtime-v0.1.5.zip
第二步，把这个目录作为本地依赖装进当前 DSH profile：
cd <DSH profile 目录>
pnpm add "<解压后的 dsh-design-kit 目录>"
第三步，在 profile 的 package.json 里把 "dsh-design-kit" 加入 dsh.profile.bundles，然后完全重启 DSH。这一步不做，插件不会注册。
完整步骤、Git 仓库安装方式、配置项和排障说明在仓库的 docs/INSTALL.md。需要回读设计方法和完整实现说明的，看 docs/README-FULL.md。
典型用法¶
面向四类需求，流程分别是：
- UI 交付：声明要做一个落地页或改一个界面，插件先生成多个方向，再产出 tokens 和页面，最后跑
design_lint输出 lint 报告和 DESIGN.md。 - 粗选：对几个方向拿不定主意时，用
probe_shortlist拿每轮三个候选，逐个标记删除、待定或选定。满 12 个候选后归因，选不出最终方案时再回到生成环节。 - 精调：想调某个具体参数时，用
probe_measure做单轴盲测，把结论记进台账，输出 JND 区间和 calibration，而不是直接采用精确数值。 - PPT 交付：把 deck 上下文交给
deck_check做质检，通过后走deck_export出 PPTX，再用deck_render出 PDF 与 PNG 预览。
粗选过程中的参数约束：固定 4 轮、每轮 3 个候选、总计 12 个封顶，每轮最多 1 个待定。
如果想验证插件本身是否正常工作，可以跑仓库自带的测试。以下是几个关键命令：
npm test
node test/shortlist-ui-contract.test.mjs
node test/docs-consistency.mjs
node skills/design-kit/probe-kit/test/smoke.mjs
node skills/design-kit/probe-kit/test/regression.test.mjs
node skills/design-kit/probe-kit/test/axis-lock.test.mjs
发布物发布用这几个命令：
node scripts/release.mjs
node test/release-check.mjs
npm pack --pack-destination dist
scripts/release.mjs 负责产出 runtime、fixtures、docs 三件发布物，三者用途不同，装进 DSH 的只有 runtime。
仓库结构与边界¶
仓库主要目录分工如下：
lib/ 插件注册、工具、客户端、异步/路径/状态
skills/design-kit/ 技能、行内实现（ui-craft / probe-kit）、deck shim
test/ mock、契约、发布物与验收/QA
scripts/release.mjs runtime / fixtures / docs 三件发布物
cordis.patch.yml DSH bundle patch
cordis.patch.yml 是插件对 DSH bundle 的补丁声明，lib/ 下同时有插件注册逻辑、工具实现和 Web 客户端入口。
已知边界，照实说：
- 真实浏览器视觉目检、PowerPoint/WPS 的逐页排版、真人 JND 标定仍然要人工做。插件提供的是流程与记录，不替代这些判断。
- 路径牢笼与一次性令牌不是完整的安全沙箱，插件以当前 DSH 进程权限运行，只从可信来源安装。安装前应检查源码与许可证。
- 旧插件
dsh-ui-craft和dsh-probe-kit不要与本插件同时安装，功能重叠。
结尾¶
这个插件的价值在于把设计交付拆成可复查的中间产物：页面有 tokens 和 lint 报告，方向选择有候选清单和归因，参数调整有台账和区间，PPT 有质检与导出链路。对已经在 DSH 里做界面交付的团队，可以省去自建脚本和散落记录的成本；对只是偶尔出个汇报的场景，直接走 deck 链路也够用。
目录页：https://www.skillhub.cn/plugins/Yifeng123589/dsh-design-kit
源码：https://github.com/Yifeng123589/dsh-design-kit
