前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過添加插件來擴展功能。dsh-waaagh-ork 是由開發者 oopsylol 維護的一個插件，旨在通過視覺元素增強 DSH 的使用體驗。其核心邏輯是將 AI 編碼過程中的模型輸出遮罩，替換爲綠色的 “Waaaaaaagh!!!”，並在界面中注入一個線條畫風格的綠皮獸人吉祥物，以此模擬 “WAAAGH!” 的編碼氛圍。
核心功能¶
該插件主要包含以下功能：
- 界面視覺改造
輸入框被改造爲漫畫對話泡泡樣式，主發送按鈕變爲綠色的 “Waaagh!” 藥丸。模型思考或輸出時，內容會被綠色的 “Waaaaaaagh!!!” 遮罩替換，點擊可查看原文。 - 綠皮吉祥物
界面左側會顯示一個線條畫風格的綠皮獸人頭像。它具有三種狀態：- 等待：坐在地上撓肚子，眨眼頻率爲 5 秒一輪。
- 幹活：蹲在筆記本前敲鍵盤、甩汗、張嘴吼叫，共 8 幀。
- 失敗：兩手抱頭驚慌，持續 4.2 秒，同時氣泡邊框變紅。
獸人頭像的尺寸和位置通過 JS 計算決定，確保不遮擋輸入框或側邊欄。
- 氏族配色
支持六種氏族配色方案（Goffs / Bad Moons / Evil Sunz / Deathskulls / Snakebites / Blood Axes），通過色相旋轉實現，顏色選擇基於實測的色相值（0.299）。 - 標題與進程
模型運行時，任務欄或標籤頁標題會加上 “WAAAGH! · 前綴”。過程行（如讀取文件、寫入文件）的圖標替換爲綠皮頭像，文字替換爲隨機嚎叫。 - 交互細節
點擊獸人頭像會觸發 “喊叫” 動畫（純裝飾，不干擾輸入框）。插件不修改輸入框草稿，發送內容保持原文。
安裝與啓用¶
安裝方式取決於運行 DSH 的環境形態。
Web 環境¶
dsh plugin --profile web add dsh-waaagh-ork
安裝後需重啓 dsh web 並刷新頁面。
Desktop 環境¶
桌面版使用 ~/.dsh/profiles/desktop 配置檔。
- 通過界面安裝：在桌面版設置中找到插件選項，安裝
dsh-waaagh-ork。 - 手動配置：編輯
~/.dsh/profiles/desktop/package.json，添加依賴並指定 bundle：
{
"dependencies": { "dsh-waaagh-ork": "^0.2.0" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-waaagh-ork"] } }
}
然後使用桌面版自帶的 pnpm 安裝並重啓。
本地開發¶
dsh plugin --profile web add link:/path/to/dsh-waaagh-ork
桌面版和 CLI 同理。使用 link: 路徑時，插件加載的是工作副本的源碼。
兼容性與要求¶
該插件對運行環境和 DSH 版本有明確要求：
- DSH 版本：
- Web 環境：0.1.6-alpha.2 及以上
- Desktop 環境：0.2.0-rc.2
- 運行時依賴：
- Node.js >= 20
- 火山方舟憑據（用於生成吉祥物素材）
開發與構建¶
插件源碼位於 src/ 目錄。構建產物（如精靈圖）位於 lib/ 和 src/assets/，這些文件在安裝時直接讀取，無需構建步驟。
主要開發命令包括：
pnpm install # 安裝依賴
pnpm run typecheck # 類型檢查
pnpm run check-assets # 校驗精靈圖尺寸與幀數
pnpm run build # 構建
pnpm run verify # 驗證構建產物與源碼一致
pnpm run smoke # 迴歸測試（需運行中的實例）
吉祥物素材通過 scripts/mascot.py 腳本生成，調用火山方舟的 doubao-seedream-4-0 模型，生成純品紅背景的幀圖，隨後摳圖、縮放併合成雪碧圖。
結語¶
dsh-waaagh-ork 是一個專注於視覺體驗的 DSH 插件，通過將模型輸出遮罩和界面元素替換爲綠皮獸人主題，爲開發者提供了差異化的編碼環境。所有功能均基於事實實現，不干擾核心開發流程。如需瞭解更多細節或查看源碼，可訪問插件目錄或 GitHub 倉庫。
- 插件目錄：https://www.skillhub.cn/plugins/oopsylol/dsh-waaagh-ork
- 源碼地址：https://github.com/oopsylol/dsh-waaagh-ork
