dsh-vim-nav

Vim-style keyboard navigation for the DeepSeek Harness Web UI.

j/k to scroll, h/l to move focus between the workspace and the conversation, i to write, and message-level jumps that stay inside the current session. The plugin also keeps the mode you were in when a conversation opens, so the host's composer autofocus never drops you into Insert unexpectedly.

Features

• Linear, hold-to-scroll j/k — no queued smooth scroll, no acceleration, no post-release glide. Releasing the key stops on the next frame.
• kk at the top loads earlier history — uses the host's own "load earlier" control and releases the host's paging position hold on the next scroll key.
• Panel focus — h focuses the workspace, l focuses the conversation.
• Composer — i enters Insert; jk (quick j then k) or Escape leaves it; dd clears the draft.
• Message jumps — Ctrl+J / Ctrl+K jump to the next / previous top-level user or assistant message in the current conversation, with a short linear glide.
• gg / G — jump to the top / bottom of the conversation.
• Session search — Ctrl+F opens the host's session search. The plugin moves the host's built-in binding from Ctrl+K to Ctrl+F once (visible and reversible in Settings → Shortcuts); if that binding cannot be applied, it falls back to clicking the sidebar search button.
• Mode preservation — opening or switching a conversation never changes Normal into Insert. If you were in Insert before switching (for example while typing, then Ctrl+J), the new composer keeps focus and stays in Insert.
• Space / Enter select a workspace row in Normal mode, with the same mode-preservation rule.
• Ctrl+W is neutralized so it does not close the window. A fixed shortcut reserves the gesture and, on desktop, removes the close accelerator from the Electron menu.
• No visual mode — Normal and Insert only.
• Never consumes Win / Super / Meta combinations — those remain for the compositor or OS.

Keymap

Key	Mode	Action
j / k	Normal	Hold to scroll down / up (constant speed, linear)
kk	Normal	At the conversation top: load one page of earlier history
h / l	Normal	Focus workspace / conversation
i	Normal	Enter the composer (Insert)
j k (quickly)	Insert	Exit Insert
Escape	Insert	Exit Insert
dd	Normal	Clear the composer draft
Ctrl+J	Any	Next top-level message in this conversation
Ctrl+K	Any	Previous top-level message in this conversation
gg	Normal	Conversation top
G	Normal	Conversation bottom
Ctrl+F	Any	Session search
Space / Enter	Normal (workspace)	Select the row under the workspace cursor
Ctrl+W	Any	Reserved; does not close the window

Ctrl+J/Ctrl+K target top-level user and assistant-step rows. Tool calls, process rows, and turn tails are skipped. At the first/last message the jump stops.

Install

Requirements: a working DSH profile and a DSH desktop/web runtime that supports local Cordis bundles.

git clone https://github.com/Endermy/dsh-vim-nav.git

Then register this directory as a bundle in your DSH profile with the Harness plugin manager ("install local bundle" / install_bundle targeting the absolute package directory). The profile records it as @local/dsh-vim-nav; the plugin appears as Vim Navigation in the plugin list.

Rebuild/reload the Web UI once after installing. On desktop, reload the page (or restart the app if your build only syncs shortcut definitions at launch).

The package is a local bundle, not an npm release. To publish it on npm, rename it to a scope you own and update cordis.patch.yml accordingly.

Package layout

File	Purpose
package.json	Bundle manifest (dsh.bundle, dsh.client) and exports
cordis.patch.yml	Inserts the vim-nav Loader row
index.js	Host half (display/row entry)
client.js	Browser half: overlay, keyboard controller, scroll driver
locale/*.json	English/Chinese plugin title and description
icon.svg	Plugin icon

There is no build step: client.js is loaded directly by the DSH client module loader. The DOM hooks are DSH-specific ([data-conversation-scroll], [data-composer-input], [data-chat-anchor-key], [data-row-key], and the client services slots/locale/layout/shortcuts), so a future DSH DOM change may require a matching update.

Development

node --check client.js
node --check index.js
python3 -m json.tool package.json >/dev/null

Edit client.js, then reinstall/reload the bundle in the profile. The UI is rendered by a shell.overlay slot; there is no separate dev server.

Compatibility notes

• Tested on DSH Desktop (Linux) in November 2026.
• Win/Super shortcuts are outside the page's control; the plugin only ignores them.
• On a plain browser the Ctrl+F rebinding may not be available; the plugin then clicks the sidebar search button instead.
• The Ctrl+F rebinding is a persistent shortcut-setting change. It only runs once when the setting is unmodified; you can change it back in Settings → Shortcuts.

中文说明

这是一个给 DSH Web UI 用的 Vim 风格导航插件：

• j/k 按住线性滚动，松开即停；对话顶部连按 kk 加载更早历史
• h/l 切换工作区/对话焦点，i 进入输入框，jk 退出编辑，dd 清空草稿
• Ctrl+J/Ctrl+K 跳当前会话的下一条/上一条消息，gg/G 到会话顶部/底部
• Ctrl+F 搜索会话（会把宿主原本的 Ctrl+K 搜索改绑到 Ctrl+F，可在设置里改回）
• Space/Enter 选中工作区行；进入会话时保持进入前的模式（Normal 不会因为自动聚焦变成 Insert）
• Ctrl+W 不再关闭窗口；不占用 Win/Super 系统快捷键

安装：克隆仓库后，用 DSH 的插件管理器把该目录作为本地 bundle 安装，刷新页面即可。

License

MIT © 2026 Endermy