返回目录

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 插件,绝不滥发。