sailoumili/dsh-sidebar-plus

Name: sailoumili/dsh-sidebar-plus
Author: sailoumili

Plugin插件 Native原生 ⭐ 2 MIT Search & Web Access搜索与联网 Docs & Writing文档与写作 UI & Themes界面与主题

基于 DSH 官方侧边栏的文件视图增强插件，提供源码视图、原位编辑、行号显示、搜索和字体缩放功能。 A file-view enhancement plugin that extends the official DSH sidebar, providing source view, in-place editing, line number display, search, and font zoom.

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is an enhancement plugin for DSH (DeepSeek Harness) sidebar file preview. It adds Markdown source editing view, text edit & save, content search, font size adjustment, and line number toggle for plain text views. Use it when editing and previewing text files in DSH sidebar. It does not support image, PDF and HTML files.

这是DeepSeek Harness（DSH）侧边栏文件预览的增强插件。新增Markdown源编辑视图、文本编辑保存、搜索、字号调节、纯文本视图行号开关等功能。需要在DSH侧边栏编辑预览文本文件时使用。不支持图片、PDF、HTML格式文件。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-sidebar-plus】【https://github.com/sailoumili/dsh-sidebar-plus】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-sidebar-plus

把 sailoumili/dsh-sidebar-plus 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.6 KB · 缓存于 2026-09-15 19:38:28 · 3.6 KB

dsh-sidebar-plus

English | 中文

给 DSH 侧边栏的文件预览新增四项功能：

.md / .markdown 格式新增「源编辑」视图，支持 Markdown 源码着色与行号显示。
新增编辑与保存功能：Markdown 格式文件可通过「编辑」跳转至「源编辑」视图进行编辑，其余格式在当前视图中直接编辑。
所有视图新增「搜索」与「字号调节」功能。
官方「纯文本」视图新增行号显示功能，可随时开启或关闭。

图片、PDF、HTML 格式不予接管。

功能

① 源编辑视图（仅适用于 .md / .markdown）在右上角「打开方式」中选择「源编辑」。该视图左侧显示行号，Markdown 语法按源码着色。

② 编辑保存（适用于所有文字格式）

.md / .markdown 格式：点击「编辑」，跳转至「源编辑」视图进行编辑。
其余格式（json / yaml / txt / log 等）：点击「编辑」，在当前视图中直接编辑。
保存：按 Ctrl+S 或点击「保存」；退出：按 Esc 或点击「退出编辑」。
若该文件已在别处被修改，将提示选择「强制保存」或「重载最新」。
覆盖前自动备份旧版本，误改后可恢复。

③ 行号开关（官方「纯文本」视图）在工具栏中点击「行号」，可显示或隐藏行号，默认为关闭状态。

④ 搜索与字号调节（适用于所有视图）

搜索：按 Ctrl+F；↓ 或 Enter 定位下一处，↑ 定位上一处，Aa 区分大小写，Esc 关闭。
字号：点击 A− / A+，或按住 Ctrl 滚动滚轮调节字号；点击中间的数字可复位。

安装

插件已发布到 npm（包名 dsh-sidebar-plus），在 DSH 终端里执行：

dsh plugin --profile web add dsh-sidebar-plus

装完重启 DSH 一次加载。之后日常的功能改动（改 hot-*.cjs）自动热生效，无需再重启；只有改加载器本身才需要重启。

架构（热插拔）

lib/index.js     宿主加载器：注册 /dsh-sp 路由 + 守卫，监视 hot-host.cjs 热装载
lib/client.js    浏览器加载器：向官方预览注册渲染器与文档插槽空壳，拉 hot-client.cjs 源码热替换
hot-host.cjs     宿主业务：stat / save / 备份 / 冲突 —— 改这个，约 2 秒生效，不重启
hot-client.cjs   浏览器业务：组件 / 文案 / 样式 / 接管扩展名名单 —— 改这个，约 2 秒生效，不刷新页面
scripts/test.mjs       离线自测：加载器 + 宿主读写 + 业务纯函数
scripts/test-dom.mjs   jsdom + React18 真渲染：行号/搜索/字号/编辑保存/冲突/热装载/回收

坏代码自动兜底：热件编译或校验失败时保留现版、只 warn，页面不崩。诊断口 GET /dsh-sp/health 返回加载器与两端业务当前版本。

业务加自定义端点：往 hot-host.cjs 的 handlers 里加同名 key 即可，路由是转发式的，加载器不用动。

隐私与边界

只在本地 DSH 进程内读写你主动打开的文件；无任何外部网络。
端点访问控制：带 Origin 的请求必须同源，POST 必须 application/json（跨源网页盲发被 CORS 预检挡死）。
保存前备份目录为 $DSH_HOME/sidebar-plus-backups/（默认即 ~/.dsh/sidebar-plus-backups/，本机运行数据；每个文件名留最近 20 份，总量上限 500 份）。
三项设置存浏览器 localStorage：源编辑字号 dsh-sidebar-plus.fontPx、官方视图缩放 dsh-sidebar-plus.officialZoom、纯文本行号开关 dsh-sidebar-plus.plainLineNo。

License

MIT

渲染基于仓库 sailoumili/dsh-sidebar-plus 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令