前言¶
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
