MIT 原生 DSH 外掛,內建免費 oil-ui,提供對照打包、截圖走查、素材搜尋、生圖與 Skill 狀態五類工具,以及 status/explore/review 斜線指令。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-18
授權條款
MIT
01它能幫你完成什麼?
在 DSH 中先並排三個介面方向再鎖定視覺風格
目前目錄下 `explore/` 的三組首屏候選與單檔 `style-explorer.html` 對照頁
在 DeepSeek Harness 做介面設計、又不想多一層巢狀沙箱目錄的開發者與設計者
在 DSH 內用真實瀏覽器截圖迭代完整頁面
`index.html` 或多螢版面,以及 `oil_ui_shoot` 產生的截圖、互動檢查與版面診斷
要交付落地頁或產品介面、並需在同一 cwd 對照視埠反覆修改的團隊
使用內建 Lite oil-ui,同時在本機發現 Oil UI Pro
內建免費 `oil-ui` Skill,並在 Harness 可見目錄診斷獨立安裝的 `oil-ui-pro`
可能另裝 Oil UI Pro、又希望外掛只發佈內建 Lite 的 DSH 使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- DeepSeek Harness 須在插件聲明的 `>=0.2.1-rc.2 <0.3.0-0` 範圍內(不保證未來所有預發行版)
- Node 版本須符合你所用 DSH 組建(README 載明 DSH `0.2.2-rc.1` 需要 Node `>=24.9.0`;桌面版自帶執行環境)
- 本機需有 Chrome / Chromium 供 `oil_ui_shoot` 使用;若用 `record` 或 `motion` 錄影抽格則需 `ffmpeg`
安裝步驟
- 01
在即將使用的終端機或應用中確認 `node --version` 與 `dsh --version`,並記住目標是 `web`、`headless` 還是 DSH 桌面版(各 profile 資料目錄不同)。
$ dsh --version
- 02
Web 介面(`web` profile)執行 `npm exec --yes --package=pnpm@10.16.1 -- dsh plugin --profile web add github:oil-oil/dsh-oil-ui`;桌面版在「設定 → 外掛 → 新增外掛」填入 `github:oil-oil/dsh-oil-ui`,不要在終端機使用 `--profile desktop`。
$ npm exec --yes --package=pnpm@10.16.1 -- dsh plugin --profile web add github:oil-oil/dsh-oil-ui
- 03
若提示已安裝卻仍載入舊版,先執行 `npm exec --yes --package=pnpm@10.16.1 -- dsh plugin --profile web remove dsh-oil-ui`,再以目標 Release commit 或正式 `.tgz` 重新 add。
$ npm exec --yes --package=pnpm@10.16.1 -- dsh plugin --profile web remove dsh-oil-ui
- 04
重啟安裝時所用的同一 profile,讓 Agent 呼叫 `oil_ui_skill_status`,並以原生 `skill` 工具載入回傳的 `activeSkillName`。
驗證整合成功
- 重啟後呼叫 `oil_ui_skill_status`,應得到 `skillReady=true`,再以原生 `skill` 載入 `activeSkillName`;五個工具都在但 Skill 載入錯誤仍算失敗。
復原
- 在桌面版或 Web 介面的「設定 → 外掛」移除 `dsh-oil-ui`,或在所用 CLI profile 執行 `npm exec --yes --package=pnpm@10.16.1 -- dsh plugin --profile web remove dsh-oil-ui` 後再重裝。
03DSH 整合程度與能力邊界
DeepSeek Harness 原生外掛:以 `dsh plugin` 安裝後註冊 5 個 oil-ui 工具與斜線指令,並在目前工作目錄發佈內建的公開 oil-ui Skill。
Skill 狀態與更新
可在 `oil_ui_skill_status` 或 `/oil-ui-status` 選擇傳入 `{"update": true}`→目前生效 Skill 名稱、生圖來源、餘額與版本更新提示
可能約每 10 分鐘請求 `https://ui.oiloil.org/api/store/versions` 並快取到 `~/.local/state/oil/`在明確要求時可透過 oil-cli 更新檔案系統安裝的 Lite/Pro風格對照打包
`explore/manifest.json` 與 `explore/` 下的候選 HTML→可互動的 `style-explorer.html` 對照頁
讀寫目前工作目錄下的檔案瀏覽器截圖與走查
本機頁面路徑或 URL,以及視埠、`states`、`steps` 等參數→截圖、互動軌跡、主控台與版面檢查結果
啟動本機 Chrome / Chromium 或 Playwright Chromium錄製動效時可能呼叫 `ffmpeg`公有領域素材搜尋
圖片、影片或地圖素材的搜尋詞→博物館與開放圖庫的預覽與下載路徑
依 README 所列介面存取公網素材目錄AI 生圖與修圖
`oil_ui_image` 的提示詞與解析度選項→寫入磁碟的圖片檔與回傳路徑
優先呼叫本機 `python3` 下的 `image-gen`不可用時可能憑 `OIL_TOKEN` 或 `~/.config/oil/config.json` 呼叫 oiloil API
04適合誰?何時不該用?
適合
- 在 DeepSeek Harness 做介面設計、又不想多一層巢狀沙箱目錄的開發者與設計者
- 要交付落地頁或產品介面、並需在同一 cwd 對照視埠反覆修改的團隊
- 可能另裝 Oil UI Pro、又希望外掛只發佈內建 Lite 的 DSH 使用者
不適合
- 外掛宣告 DSH 相容 `>=0.2.1-rc.2 <0.3.0-0`;README 提醒僅重複對 Git 位址 add 不會替換舊鎖檔,應先 remove 或安裝正式 `.tgz`。
- DSH 桌面版與終端機 `dsh web` 使用不同的 `DSH_HOME` 與 `profiles/web` 路徑;安裝與重啟須對準實際執行的 profile,README 不建議在終端機使用 `--profile desktop`。
- `oil_ui_skill_status` 可能請求 `https://ui.oiloil.org/api/store/versions`(有快取、最長等待 8 秒);本機無 `image-gen` 時 `oil_ui_image` 可能連線 oiloil(預設 `https://api.oiloil.org`)。
- 五個工具皆以目前工作目錄為基準讀寫頁面與截圖;瀏覽器相關能力需要本機 Chrome/Chromium,部分模式需要 `ffmpeg`。
05相容性、維護與安全提醒
- 外掛宣告 DSH 相容 `>=0.2.1-rc.2 <0.3.0-0`;README 提醒僅重複對 Git 位址 add 不會替換舊鎖檔,應先 remove 或安裝正式 `.tgz`。
- DSH 桌面版與終端機 `dsh web` 使用不同的 `DSH_HOME` 與 `profiles/web` 路徑;安裝與重啟須對準實際執行的 profile,README 不建議在終端機使用 `--profile desktop`。
- `oil_ui_skill_status` 可能請求 `https://ui.oiloil.org/api/store/versions`(有快取、最長等待 8 秒);本機無 `image-gen` 時 `oil_ui_image` 可能連線 oiloil(預設 `https://api.oiloil.org`)。
- 五個工具皆以目前工作目錄為基準讀寫頁面與截圖;瀏覽器相關能力需要本機 Chrome/Chromium,部分模式需要 `ffmpeg`。
MIT · 最近推送 2026-11-11 · 發行版 v0.4.13
06常見問題
README 要求哪些 DeepSeek Harness 版本?
外掛宣告 `>=0.2.1-rc.2 <0.3.0-0`,並把 Node 要求綁到特定 DSH 組建,例如 DSH `0.2.2-rc.1` 需要 Node `>=24.9.0`。桌面版自帶執行環境;不要只靠 `allow-version --accept-risk` 繞過檢查。
終端機 Web 安裝和桌面版是否共用同一外掛目錄?
不共用。桌面版裝在獨立 `DSH_HOME` 的 `profiles/web` 下,終端機 `dsh web` 使用 `~/.dsh/profiles/web`。須對實際執行的 profile 安裝並重啟;README 說不要在 shell 裡使用 `--profile desktop`。
如何確認外掛已載入,而不只是安裝命令結束碼為 0?
重啟後讓 Agent 呼叫 `oil_ui_skill_status`,應得到 `skillReady=true`,再以原生 `skill` 載入 `activeSkillName`。README 載明僅有五個工具但 Skill 載入錯誤仍算失敗。
內建 Lite oil-ui 與 Oil UI Pro 有何不同?
外掛內建免費 `oil-ui`,涵蓋方向探索與 `style-explorer.html`。另裝 Oil UI Pro 可做更深視覺走查、更豐富 shoot 狀態、完整素材/生圖分冊與情境 Skill;外掛只發現本機 Pro,不會自行發佈 Pro。
會存取哪些本機資源或網路?
`oil_ui_shoot` 需要 Chrome/Chromium(部分模式要 `ffmpeg`)並在 cwd 寫檔。`oil_ui_image` 在無本機 `image-gen` 時可能用 `OIL_TOKEN` 或 oil 設定存取 oiloil;版本檢查可能連線 `https://ui.oiloil.org/api/store/versions` 並快取結果。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛,高效能低佔用,可愛畫素鯨魚,流暢滑鼠互動,npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座,支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒體工作臺外掛:一句話記靈感,一鍵生成指令碼、封面、配圖和分鏡
dsh-drawai
作者 fourzkw
DSH 右側欄裡的可編輯畫布 —— 加上讓模型直接改圖的兩個工具
08資料與來源
**`dsh-oil-ui` 是 [oil-ui](https://github.com/oil-oil/oil-ui) 的 DeepSeek Harness 原生插件。**
`dsh-oil-ui` 直接按 DeepSeek Harness 的原生插件机制设计:
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
