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 个值得优先安装的插件,覆盖各个分类。
