返回目錄

dsh-oil-ui

精選清單收錄維護狀態: 活躍

oil-oil/dsh-oil-ui

Oil UI 的 DeepSeek Harness 原生外掛,支援自動切換本地安裝的 Oil UI Pro

前往 GitHub
$ dsh --version

265

星數

8

Fork

JavaScript

語言

MIT

授權條款

2026-10-18

建立於

2026-11-20

最近推送

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`

安裝步驟

  1. 01

    在即將使用的終端機或應用中確認 `node --version` 與 `dsh --version`,並記住目標是 `web`、`headless` 還是 DSH 桌面版(各 profile 資料目錄不同)。

    $ dsh --version

  2. 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

  3. 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

  4. 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 整合程度與能力邊界

DSH 整合原生執行環境

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`。
2026-10-182026-11-11v0.4.13

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` 並快取結果。

08資料與來源

  • 作者聲明github.com679e7b0190ac…

    **`dsh-oil-ui` 是 [oil-ui](https://github.com/oil-oil/oil-ui) 的 DeepSeek Harness 原生插件。**

  • 作者聲明github.com679e7b0190ac…

    `dsh-oil-ui` 直接按 DeepSeek Harness 的原生插件机制设计:

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。