dsh-markdown-docs
IdentifiedMarkdown workbench for the DeepSeek Harness right sidebar: browse, preview, edit, drop files and folders in, and follow the documents a file references.
Markdown documents
A DeepSeek Harness plugin that puts a Markdown workbench in the right sidebar: drop a file or a folder on it, read and edit documents, and jump to the documents a skill file references.
Where to find it
Open the right sidebar, then the guide page: the Markdown documents capsule opens this page. The capsule carries a page-and-pencil glyph.
Drop something on it
- A file opens it for reading and editing, and the list behind it moves to that file's folder, so ← leads to its siblings.
- A folder lists the Markdown documents inside it. Dropping a skill directory is the fastest way in: the list shows
SKILL.mdand everything underreferences/. - A file the platform cannot locate on disk (a plain browser tab without the Desktop path bridge) still opens, read-only, from the bytes the browser received; the status bar says so.
In the Desktop app the preload exposes __DSH_HOST_PATHS__.pathFor, which maps a dropped File to its absolute path; without it the panel can read a dropped file but not write it back.
What it does
- Lists every
.md,.markdown, and.mdxfile under the chosen folder, sorted by path. Dependency and build directories (node_modules,dist,build,.git, …) are skipped, the walk stops at 400 files, 800 directories, and 6 levels, and dot-prefixed entries are ignored. - Previews Markdown with headings, emphasis, inline code, fenced code, lists, quotes, tables, rules, and links. Images appear as a labelled placeholder.
- Edits in a plain-text editor with
⌘/Ctrl + Sto save. A non-Markdown file opened from a reference (a.py,.yaml,.sh, …) opens in source mode and is shown verbatim, never rendered as Markdown. - Saves with a version guard: if the file changed on disk after you opened it, the save is refused with
conflictinstead of overwriting someone else's work. - Creates new documents with
+, refusing to overwrite an existing file. - Links references in place: a Markdown link, an inline code span, or a bare path in prose that names a real document becomes clickable inside the rendered text and opens that document in the same panel. A path that does not exist is struck through and marked 缺失, so a broken skill reference is visible instead of silent.
- Keeps the reference list folded: the 引用的文档 N row under the header stays collapsed by default; opening it lists every referenced document — the missing ones included — as its own quick-jump list.
Limitations
- Reads may leave the workspace; writes are decided by the session's sandbox policy (
read-only,workspace-writeplus any additional writable roots, ordanger-full-access) and enforced by the filesystem backend. A skill folder under~/.dsh/skillsis read-only in aworkspace-writesession, and the panel shows 只读 instead of failing the save. - Files larger than 2 MiB are not opened here.
- The open document is not watched for external edits: if the agent rewrites the file while you have it open, saving reports
conflict. Use ← to go back and reopen it. - Closing the tab discards an unsaved draft; the tab type keeps its body mounted across collapsing and docking, but not across closing. The status bar shows 有未保存的修改 while a draft differs from disk.
- The reference list is a scan of the file's text, not a resolved document graph: it reads the paths a document names, in reading order, and stops at 40 entries.
- The plugin is a UI over files on disk. It adds no agent tool; the agent already reads and edits files with its own tools.
How it is built
index.jsis the Host half. It registers sixPOSTroutes under/api/dsh-markdown-docson the Connection carrier —list,stat,open,save,create,references— overctx.fs,ctx.sessions, andctx.sandboxPolicy. The browser never picks a root: the Session header supplies the workspace, and the policy supplies the write boundary.client.jsis the browser bundle. It registers a right-sidebar tab type throughctx.sidebarRightTabsplus its body in thesidebar.right.pane.tabseat, and calls the routes withfetch. Styling uses only--dsw-alias-*theme tokens.
Comments
Loading…
Similar plugins
by wei238982377
An add-only Markdown library for DeepSeek Harness with a workspace file picker, fixed non-overlapping icon grid, marquee selection, virtual folders, full-screen tabs, GFM tables, and local Mermaid/cha
★ 2
MIT
JavaScript
Nov 6, 2026
dsh plugin --profile web add dsh-docdeskby ld-1101
DSH (DeepSeek Harness) plugin: workspace file preview column with Markdown/PDF/image/CSV preview, session-produced files, drag files/folders into the conversation as plain paths.
★ 0
MIT
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-file-previewby Velestia-star
An add-only Markdown library for DeepSeek Harness with a workspace file picker, a fixed icon grid with pointer-first hysteresis drag targeting, marquee selection and bulk folder moves, drag-to-folder
★ 2
MIT
JavaScript
Nov 12, 2026
dsh plugin --profile web add dsh-docdeskFull workspace file manager for the DeepSeek Harness web Sidebar: browse, preview, edit, rename, copy, move, delete, compress, extract, upload, download.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-file-managerby caihua8669
Document review workbench: select text in a Markdown file, leave comments saved as MRSF sidecar files next to it, and let the agent read them with doc_review_* tools and propose edits you accept or re
★ 1
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add @caihua/dsh-doc-reviewby xusuyang030218
DSH (DeepSeek Harness) file preview & editor plugin: in-browser workspace file tree, multi-format preview, online editing, version history, search. DSH 文件预览插件。
★ 0
MIT
JavaScript
Aug 24, 2026
dsh plugin --profile web add dsh-preview-ui