Back to directory

dsh-gufa-code

In a curated listMaintenance: Active

liujiangnanchenjbguo/dsh-gufa-code

Switches the DSH workspace into a three-pane IDE where you edit code locally while the native DSH agent session runs alongside.

View on GitHub
$ dsh plugin add dsh-gufa-code

47

stars

8

forks

JavaScript

Language

MIT

License

2026-11-05

Created

2026-11-19

Last push

MIT-licensed DSH plugin that turns the harness main panel into a VS Code-style three-pane IDE — Monaco editor, Git panel, SSH and a real PTY terminal — while the official DSH session stays docked on the right.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-15

License

MIT

01What can it help you accomplish?

  • Edit code inside DeepSeek Harness while watching exactly what the agent does

    The main panel becomes a three-column IDE: activity bar plus explorer / global search / source control / SSH / terminal on the left, Monaco editor in the middle, and the official DSH session docked on the right

    Engineers on the DSH desktop app or `dsh web` who want every agent edit, command and approval on one screen

  • Review what the agent changed and roll it back per file before accepting it

    Monaco git diff view (working side editable with auto-save), per-file revert, discard all, undo last commit, and open tabs refreshed from disk every 1.6s

    Developers who insist that AI edits stay diffable, reversible and auditable

  • Run commands and reach remote hosts without leaving the harness

    A real PTY + xterm terminal with tabs, auto-resize and light/dark themes, plus one-click `ssh <alias>` from `~/.ssh/config`

    Developers who do not want to jump to an external terminal for builds, tests or SSH

  • Keep the IDE floating on top of another app (the README calls it 摸鱼 mode)

    A borderless, semi-transparent, always-on-top window that snaps to the chosen running app, with 20%–100% opacity and the IDE state carried in and out

    macOS users who want the editor layered over another app; Windows and Linux builds are marked experimental

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness 0.2.1 or newer — the desktop app and the browser-based `dsh web` are both supported
  • Float overlay only: Windows 10/11 with the WebView2 Runtime, or an X11 desktop with GTK3 / WebKit2GTK runtime libraries on Linux
  • Float overlay only on macOS: the Accessibility (辅助功能) permission for DeepSeek Harness, followed by one DSH restart

Installation steps

  1. 01

    Run `dsh plugin add dsh-gufa-code`

    $ dsh plugin add dsh-gufa-code

  2. 02

    Or install from the marketplace: DSH desktop app / `dsh web` → 插件 → 插件市场 → search 「古法编程 / dsh-gufa-code」

    $ dsh web

  3. 03

    For the float overlay on macOS: System Settings → Privacy & Security → Accessibility → tick DeepSeek Harness, then restart DSH once

Verify the integration

  • The workspace row's 「…」 menu lists 古法编程 as its second item; clicking it switches the main panel into the three-pane IDE
  • The 摸鱼 selector's 自检 (self-check) button exports platform / helper / WebView2 / accessibility / X11 details for troubleshooting

03DSH integration and capability boundaries

DSH integrationNative runtime

Official DSH plugin: `dsh plugin add dsh-gufa-code` adds a 古法编程 entry to the workspace menu that replaces the main panel with a three-pane IDE and docks the official DSH session, unchanged, on the right.

  • Three-pane IDE panel

    the workspace whose row menu you entered from→activity bar + explorer / global search / source control / SSH / terminal, a Monaco editor, and the official DSH session on the right

    open tabs re-check disk mtime/size every 1.6spanel width and toggle state persist to localStorage
  • Source control (Git) panel

    the git repository of the current workspace→branch and ahead/behind, change list, stage/unstage, commit, git graph, undo last commit, discard all, per-file revert

    clicking ahead/behind pushes or pulls the real remotecommit / revert / discard act on the real working tree
  • Terminal and SSH

    any command, or a host alias from `~/.ssh/config`→a real PTY + xterm terminal with tabs, auto-resize and light/dark themes

    commands and SSH sessions run in a real PTY against the workspace
  • Float overlay (摸鱼 mode)

    an app picked from the list of running apps→a borderless, semi-transparent, always-on-top window snapped to that app, opacity adjustable from 20% to 100%

    brings the chosen app to the front, which covers the main windowreads window geometry through the macOS Accessibility permission
  • Selection → @ code reference

    a copied multi-line selection, or a file dragged into the chat input→an `@文件 Lx-Ly` reference chip in the message input

    successful copy / insert no longer shows a toast

04Who is it for? When not to use it?

Good for

  • Engineers on the DSH desktop app or `dsh web` who want every agent edit, command and approval on one screen
  • Developers who insist that AI edits stay diffable, reversible and auditable
  • Developers who do not want to jump to an external terminal for builds, tests or SSH
  • macOS users who want the editor layered over another app; Windows and Linux builds are marked experimental

Not for

  • The 摸鱼 float overlay works out of the box on macOS Apple Silicon / Intel, while Windows and Linux are marked experimental; under pure Wayland it cannot follow or hide other windows and only free floating works.

05Compatibility, maintenance and safety notes

  • The 摸鱼 float overlay works out of the box on macOS Apple Silicon / Intel, while Windows and Linux are marked experimental; under pure Wayland it cannot follow or hide other windows and only free floating works.
  • The overlay reads window geometry and hides the main window through the macOS Accessibility permission (not screen recording), and DSH has to be restarted once after granting it.
  • The Windows helper exe is not code-signed, so the first run may be stopped by SmartScreen; the macOS helper is ad-hoc signed and may need one manual approval under Privacy & Security.
  • AI Tab inline completion was deliberately removed because results were unstable and added input latency; only basic suggestions (Monaco suggestions / current-document words) remain.
  • On other platforms, or when the helper binary is missing, 摸鱼 mode only prints a version / build hint — the rest of the IDE keeps working.
2026-11-052026-11-13v1.3.133

MIT · latest release v1.3.133 (2026-11-12T02:50:34Z)

06Frequently asked questions

Does the plugin replace the DSH agent session?

No. What is docked on the right is the official DSH session itself — tool calls, automatic file edits, approval dialogs, slash commands, context references and session history all keep working; the plugin only rearranges the workspace around it.

How do I install it, and which DSH version do I need?

Run `dsh plugin add dsh-gufa-code`, or search 「古法编程 / dsh-gufa-code」 in 插件 → 插件市场 inside the DSH desktop app or `dsh web`. The README requires DeepSeek Harness 0.2.1 or newer, on the desktop app or in the browser.

Will the editor update itself when the agent edits files?

Yes — the README says open tabs check disk mtime/size every 1.6 seconds, so a file the agent rewrote in the session is reloaded in place with the cursor kept, and unsaved changes are never overwritten.

Does the 摸鱼 float overlay need another plugin or a local build?

No. The npm package ships the helper binaries: macOS Apple Silicon / Intel works out of the box with a universal helper. Windows needs the WebView2 Runtime, Linux needs X11 with GTK3 / WebKit2GTK, and both are still experimental.

Can I undo changes the agent made?

The source control panel offers a Monaco git diff view, per-file revert, discard all and undo last commit, so agent edits can be inspected and rolled back before you accept them.

08Data and sources

  • Author-claimedgithub.com86f6f2734ea1…

    一个 DSH 插件。点工作区行「…」菜单里的 **古法编程** 后,主面板切换成一个三栏 IDE:

  • Author-claimedgithub.com86f6f2734ea1…

    **右**:**官方 DSH 会话面板原样停靠** —— 工具调用、自动读写文件、审批弹窗、斜杠命令、上下文引用、会话历史都还在。

  • Author-claimedgithub.com86f6f2734ea1…

    dsh plugin add dsh-gufa-code

  • Author-claimedgithub.com86f6f2734ea1…

    要求:DeepSeek Harness **0.2.1** 及以上;支持桌面端与浏览器里的 `dsh web`。

  • Author-claimedgithub.com86f6f2734ea1…

    **Gufa Code** — a Cursor-style IDE mode for DeepSeek Harness.

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-15. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.