Skip to main content

How to use deepseek-harness-desktop

Embed a skin center card in DSH Web GUI settings, listing all installed skins with support for instant try-on and one-click application within the GUI, eliminating the need to copy commands or restart.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

deepseek-harness-desktop

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Where do I open the Skin Center after installation?

After installation, you need to refresh the DSH Web GUI page, then go to Settings → Plugin Configuration → Web UI Plugins group, where you will find an additional 'Skin Center' card (src/client/index.ts:101-107, registered to web-ui.plugin.item slot).

Do I need to restart DSH web to switch skins?

No need. After the host writes cordis.patch.yml to the profile, the DSH configuration watcher will hot-reload within a few seconds, and the page will automatically refresh to the new skin (src/client/SkinCenter.tsx:174-222).

What's the difference between 'Try On' and 'Apply'?

Try On only temporarily loads the skin to the current page in the browser (src/client/try-on.ts), which becomes invalid after refresh or restart; Apply goes through host's /api/skin-center/apply, writes the selection to the profile patch and migrates the old global managed section, making the change persistent (src/routes.ts:282-300).

What if I can't see certain skins?

Skin Center only lists installed skin packages. Each skin is a separate npm package (e.g., @linxin666/dsh-client-ui-skin-qq98), which needs to be installed separately or together in the family aggregate package @linxin666/dsh-skins (README.md:32).

What to do when Apply fails?

When the apply interface returns an error, the UI will display a prompt with manually executable commands dsh-skin use or dsh-skin use official (src/client/SkinCenter.tsx:202-220).

How to completely uninstall?

Execute dsh plugin --profile web remove @linxin666/dsh-client-ui-skin-center in the terminal. The DSH plugin manager will handle removing the relevant entries from the profile.

Will there be compatibility issues on Windows?

Generally not. When profile node_modules symlink has insufficient permissions, it automatically falls back to directory junction without requiring developer mode or admin privileges (src/skin-switch.ts:765-799).

— source: plugin_wiki.faq_json

Compatibility

  • DSH: ^0.1.0-rc.7（devDependencies 中所有 @deepseek-ai/dsh-* 包声明此版本，package.json 未声明 dsh_version 字段）
  • Node: ^22.19 || >=24（packages/AGENTS.md 强制要求，package.json 未声明 engines）

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule