dsh-dock

DeepSeek Dock

English · [Simplified Chinese](README.zh-CN.md)

A persistent, customizable left Dock and a Codex-inspired UI for DeepSeek Harness.

Pin important chats across workspaces, draft on Home without creating a chat until you send, and preview videos in the right file panel beside the conversation. DeepSeek Dock installs independently without modifying the host application, preserving DeepSeek branding and native tools.

0.2.0 · Supported hosts: macOS / Harness 0.2.1-rc.5 or 0.2.2-rc.1 · Third-party community plugin

[Install](#install) · [Features](#features) · [Compatibility and limits](#compatibility-and-limits) · [Migration](docs/MIGRATION.md) · [Report an issue](https://github.com/captainyufei/dsh-dock/issues)

See it in action

[Watch the full 45-second demo with music](assets/readme/demo.en.mp4) · [Watch in Chinese](assets/readme/demo.mp4) · [Static preview](assets/readme/poster.en.png)

The 45-second loop follows the 0.2.0 application Dock, All Apps, pinning/reordering, global search, completion inbox, Back/Forward and existing file/video tools. Click it for the version with music. Both formats use illustrative UI based on the current code and fictional sample data; they are not live recordings or performance measurements.

Features

| Feature | What changes in everyday use |

|---|---|

| Application Dock and overview | Open registered plugin pages through monochrome icons, pin and reorder them, or find them in All Apps. Recent unpinned apps have their own section. |

| Global search | Find chat titles, workspaces and quick actions in one palette; chat-body search is available when the Host index is enabled. |

| Session inbox | Review completion excerpts and pending interactions. Home and the bell share an unread dot, and read completion records remain available. |

| Back and Forward | Revisit global pages and existing chats visited in the current window. |

| Codex-inspired UI | Home, chats, plugins, and scheduled tasks share one window frame and draggable top strip. Moving between pages keeps the same navigation and tool controls, with DeepSeek branding and the native chat hierarchy. |

| Cross-workspace pins | Find important chats from different workspaces in one pinned section. Each appears only once; unpinning returns it to its original group without changing workspace membership. |

| Draft-first Home | Compose and revise before committing to a chat. A chat is created only when you send, so unsent ideas do not fill the sidebar with empty entries. |

| Video in the file panel | Play and seek a generated video on the right while checking the conversation beside it. Reopening the tool drawer restores existing tabs so you can continue reviewing the same content. |

Install

Requires macOS / Harness 0.2.1-rc.5 or 0.2.2-rc.1. Disable the old @local/chatgpt-rail plugin first if installed ([migration](docs/MIGRATION.md)). This package is not published to npm; use the repository URL below. No manual build is needed. Install packages are also available from [GitHub Releases](https://github.com/captainyufei/dsh-dock/releases/latest); extract the ZIP and select the complete folder containing package.json.

This installs the latest code on main, not the latest stable release. Installed copies do not update automatically.

Install in DeepSeek Harness

Open Plugins → Add plugin, paste this into Package name or address, and click Install:

https://github.com/captainyufei/dsh-dock

When Installed appears, click Enable now. Closing the dialog instead leaves the plugin switched off.

Confirm DeepSeek Dock is on under Installed plugins. Collapse the chat list: Home, scheduled tasks, and plugins should remain in the left Dock. Right-click the Dock to customize its entries.

Install with the dsh CLI

For the web profile, run:

dsh plugin --profile web add https://github.com/captainyufei/dsh-dock

Start dsh web if it is not already running, then open Plugins and make sure DeepSeek Dock is enabled. The command targets the web profile; desktop users should use the installation dialog above.

Update or remove

Save your work first. If your plugin manager offers Update for DeepSeek Dock, use it, then follow any reload/restart notice. Otherwise uninstall the plugin and reinstall using the same repository URL or CLI command above, then enable it. Confirm version 0.2.0 or newer in the plugin details. Reopening Harness alone does not fetch new code.

To disable Dock temporarily, turn off its switch. Uninstall without reinstalling to remove it. Both actions preserve host-managed chats and workspaces.

Alternative: install from a local ZIP

1. [Download the current main branch](https://github.com/captainyufei/dsh-dock/archive/refs/heads/main.zip) and extract it into a directory you will keep. This is a snapshot of main at download time, not a fixed release.

2. Find the root containing package.json and cordis.patch.yml; keep the complete extracted directory and all its subfolders.

3. Select that folder in Finder and press Option–Command–C to copy its absolute path. Paste it into Plugins → Add plugin. For example, an account named alex might use:

   /Users/alex/Plugins/dsh-dock

Use your actual folder path, not the example or the ZIP file.

4. Click Install → Enable now, and check the Dock as described above. Keep the local directory after installation.

Troubleshooting installation

| Problem | Next step |

|---|---|

| Package not found | Use the complete repository URL above. This package is not published to npm; its package name or @latest is not an installation source. |

| GitHub download fails | Open Show install details, check GitHub connectivity, and retry. Changing the npm registry does not fix GitHub access. Use the ZIP option if you can download it separately. |

| Installed, but no Dock | Enable it u