前言¶
DeepSeek Harness(DSH)已經可以通過 skill 工具和 /技能名 手勢加載技能。實際做界面相關需求時,模型往往直接寫代碼,不會主動去查設計規範;你要麼反覆提醒,要麼手動輸入 /ui-ux-pro-max。ui-ux-pro-max 技能裏包含大量風格、配色與字體配對等資料,沒加載進上下文就等於用不上。
下面介紹維護者 bsfcxz 發佈的工作流類插件 dsh-ui-ux-pro-max:當本輪用戶輸入裏出現 UI/UX 相關表述時,自動把 ui-ux-pro-max 技能正文注入當前輪對話,走與官方手勢相同的注入路徑,無需每輪手動觸發。
這是什麼¶
- 名稱:dsh-ui-ux-pro-max(展示名:UI/UX Pro Max 自動技能)
- 類型:DeepSeek Harness 插件,分類爲工作流
- 維護者:bsfcxz
- 許可證:MIT(見倉庫 LICENSE)
- 版本(package.json):1.0.0
- 倉庫:https://github.com/bsfcxz/dsh-ui-ux-pro-max
- 目錄頁:https://www.skillhub.cn/plugins/bsfcxz/dsh-ui-ux-pro-max
插件本身只負責「何時自動加載」;設計知識來自 ui-ux-pro-max 技能。本倉庫在 skills/ 下內置 7 個技能包(約 172 個文件),裝插件時仍需把技能複製到 DSH 用戶級技能目錄,插件纔會真正生效。
核心功能¶
自動觸發¶
插件監聽 DSH 的 agent/pre-step 事件,只掃描用戶直接輸入的文本:
- 命中觸發詞 → 通過
ctx.skills.get()讀取技能正文; - 以
skill-invocation消息拼進當輪,模型在本輪即可看到完整規範; - 未命中 → 不修改對話,原樣放行。
與手動 /ui-ux-pro-max 共用同一條注入路徑:內容會寫入會話日誌、由 DSH 官方渲染,並遵循技能自身的 user-invocable 策略。
觸發詞與誤觸防護¶
README 中列出的命中示例包括:
- 獨立詞
ui/ux(邊界感知,不是子串); - 組合形式如
UI/UX、ui-ux; - 英文設計術語:
design system、color palette、typography、accessibility audit等; - 中文:
界面、設計系統、配色方案、用戶體驗等。
下列輸入不會觸發:build the project(build 內嵌的 ui)、read the guide、fluid simulation 等。匹配使用否定環視,避免普通英文單詞誤傷。
其它行爲¶
| 能力 | 說明 |
|---|---|
| 來源隔離 | 僅用戶輸入可觸發;模型輸出、工具結果、子代理文本不能僞造觸發 |
| 每輪一次 | 同一輪多次 step 不會重複注入 |
| 失敗安全 | 技能缺失或註冊表異常時靜默放行並告警,不阻斷對話 |
| 可開關 | 「設置 → 插件 → UI/UX Pro Max 自動技能」可關閉自動注入;/ui-ux-pro-max 與手動 skill 仍可用 |
關閉自動觸發後,~/.dsh/skills/ 下的技能文件不受影響。
安裝與啓用¶
前置條件¶
- 已安裝 DeepSeek Harness;
- ui-ux-pro-max 相關技能已在
~/.dsh/skills/(可用本倉庫skills/複製,或按 README 用上游 CLI 安裝); - 當前 Profile 的
skill-filesystem提供者處於啓用狀態。
確認技能路徑示例:
ls ~/.dsh/skills/ui-ux-pro-max/SKILL.md
將倉庫內置技能複製到用戶目錄(README 推薦做法):
mkdir -p ~/.dsh/skills
cp -r ~/.dsh/plugins/dsh-ui-ux-pro-max/skills/* ~/.dsh/skills/
安裝插件 bundle¶
官方 README 未提供 dsh plugin add github:... 一類命令,而是通過 plugin_manager 的 install_bundle 安裝。常見兩種方式:
方式一(推薦給 DSH 的自然語言指令):讓 DSH 將倉庫放到 ~/.dsh/plugins/dsh-ui-ux-pro-max,複製 skills/ 到 ~/.dsh/skills/,再執行 install_bundle 安裝該目錄。
方式二(手動):README 給出的克隆與後續步驟如下。
git clone https://github.com/bsfcxz/dsh-ui-ux-pro-max.git \
~/.dsh/plugins/dsh-ui-ux-pro-max
mkdir -p ~/.dsh/skills && cp -r ~/.dsh/plugins/dsh-ui-ux-pro-max/skills/* ~/.dsh/skills/
然後對 DSH 說明:用 plugin_manager 的 install_bundle 安裝 ~/.dsh/plugins/dsh-ui-ux-pro-max。成功時應看到 application: "applied"。
可選:用上游 CLI 安裝最新技能快照(需 Node 與 ui-ux-pro-max-cli),再把生成目錄移到 ~/.dsh/skills/;README 建議優先使用 ~/.dsh/skills/ 而非 ~/.agents/skills/,尤其在 Windows 上路徑更穩妥。
修改插件源碼後需重啓 DSH,否則 JavaScript 模塊緩存可能導致舊代碼仍在運行。
典型用法¶
安裝完成後無需額外命令,用自然語言描述 UI/UX 需求即可,例如:
幫我做一個 SaaS 後臺的 UI
這個頁面的 UX 有點亂,幫我看一下
給這個項目定一套設計系統
技能自帶的 search.py 仍可單獨調用(與插件無關)。示例:
python ~/.dsh/skills/ui-ux-pro-max/scripts/search.py \
"beauty spa wellness service" --design-system -p "Serenity Spa"
python ~/.dsh/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
Windows 上 README 建議使用 python,而非可能指向應用商店佔位符的 python3。
需要擴展自動觸發範圍時,可編輯倉庫根目錄 trigger.js 中的 TRIGGER_PATTERNS 數組,保存後重啓 DSH。
適用場景與注意¶
適合誰:經常在 DSH 裏做界面、設計系統、配色與 UX 評審,希望每輪對話自動帶上 ui-ux-pro-max 規範,又不想依賴模型「記得」調技能的開發者。
Token:僅在命中觸發詞的那一輪注入一次;README 說明注入正文約 35–40k 字符,與普通編碼對話無 UI/UX 關鍵詞時無關。
排查「裝了沒反應」(README 順序):
- 確認
~/.dsh/skills/ui-ux-pro-max/SKILL.md存在; - 確認
skill-filesystem插件開啓; - 確認本插件爲 active(如
fiberPhase: "active"); - 若剛改過代碼,重啓 DSH。
安全與信任:插件在 當前 DSH 進程權限 下運行,安裝前請自行審閱 倉庫源碼 與 MIT 許可證。社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態理念是「一切皆插件」,本文介紹的是社區維護的工作流插件,而非官方應用商店條目。
項目自帶 66 條 Node 測試(tests/test-trigger.mjs、tests/test-plugin.mjs),可在插件目錄用 npm test 或分別運行兩個測試文件驗證觸發邏輯與接線。
結尾¶
dsh-ui-ux-pro-max 把「提到 UI/UX 就加載設計技能」做成工作流:監聽 agent/pre-step、邊界感知觸發詞、與官方技能注入路徑一致,並內置 7 個技能包便於一次性部署。若你已在用 DSH 做界面類任務,可按 README 複製技能並 install_bundle 啓用。