Skip to main content

How to use deepseek-harness-desktop

Install the "Liang Shen Mode" two-stage anchoring agent preset for DSH: the first round exposes the Minimal dual-tool guidance trajectory, and after anchoring, switch to PTC Mode to unlock all capabilities.

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-liangshen

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

Is Liangshen mode the same as the official Minimal preset?

No. Minimal only keeps two tools but has limited capabilities; Liangshen mode is a "two-stage" solution that precisely aligns with Minimal's byte-level surface-guided model trajectory in the first round, and after anchor establishment, automatically switches to PTC Mode (single run_code tool) to restore full tool capabilities (README.md:7-15).

When does the tool directory change?

Changes only once: After the session's first persistent tool/call passes the anchor gating (first block inference contains we without let me, four-step fallback), it switches to PTC Mode; if the first round response doesn't call any tools, it automatically promotes after the response. The switch occurs at step boundaries, and the current step's native tool calls won't be interrupted (README.md:21-25 / tool-bootstrap.mjs:269-280).

Is any configuration needed after installation?

No manual configuration needed. The plugin host automatically syncs presets/liangshen to ~/.dsh/.agent-presets when starting, and you can select "Liangshen Mode" in the preset selector when creating a new session; after upgrading the plugin, a complete restart of dsh web will automatically refresh the preset file (README.md:43).

How to verify the plugin is actually working?

Export session JSONL and check request/header: the first header should only have bash/str_replace_editor (persistent shell + sandboxed editor); the next header change after the first tool call should exactly be run_code. You can also run the repository's built-in node tools/analyze-session.mjs <session.jsonl> to measure trajectory markers (we / let me, etc.) (README.md:47-59).

How to uninstall?

Run dsh plugin --profile web remove @linxin666/dsh-liangshen then fully restart dsh web; if the same preset is also mounted via the dsh-web-ui-all aggregation package, you need to remove the other one first to avoid dual-source mount conflicts (README.md:38-43).

Can I switch to this preset mid-session with existing content?

Not recommended. The preset works by anchoring the session's first-round request trajectory to Minimal; a session with existing content doesn't have a "first round", so the switch may not work as expected (README.md:73).

Does the plugin make network requests or collect telemetry data?

No. The README explicitly states that the plugin does not make network requests or add telemetry (README.md:72).

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 0.1.0-rc.5+
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: macOS, Linux, Windows

— 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