dsh-docs-panel

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-docs-panel

> DSH WebUI 里的「随身手册」：全局 Markdown 笔记，任何工作区随时可读。

[![npm](https://img.shields.io/npm/v/dsh-docs-panel)](https://www.npmjs.com/package/dsh-docs-panel)
[![npm-downloads](https://img.shields.io/npm/dm/dsh-docs-panel)](https://www.npmjs.com/package/dsh-docs-panel)
[![license](https://img.shields.io/npm/l/dsh-docs-panel)](https://github.com/mlosun/dsh-docs-panel/blob/main/LICENSE)

把你自己整理的 Markdown 笔记，直接搬进 DeepSeek Harness 的网页里读。

你攒在 `~/.dsh/docs` 的笔记、排查手册、使用说明，不必再切到别的编辑器——装在 dsh 里就能点开即读：右侧滑出面板、排版干净的正文、随时跳转的大纲，读完一键就能转到 Chrome 或 VS Code 继续编辑。

![dsh-docs-panel 演示](assets/demo-panel.png)

## 功能一览

- 📚 **列表点选阅读**：自动列出文档目录下所有 `.md` 文件（含子目录），点一下就读；
- 🎨 **良好排版**：标题、列表、表格、代码块、引用、链接都渲染得规整，自动适配亮色/暗色主题；
- 📏 **拖拽调宽**：面板左边缘有手柄，自由拉宽拉窄；
- 🧭 **悬浮大纲**：一键展开文档目录，点标题平滑跳转（默认收起，不打扰阅读）；
- 🌐 **外部打开**：每篇文档提供「Chrome 打开」「VS Code 打开」按钮，随时转到编辑器继续编辑（目前仅支持 macOS）；
- 📋 **代码复制**：代码块右上角一键复制；
- 📁 **目录可配置**：默认读 `~/.dsh/docs`，可在面板里改成任何目录，保存后永久生效。

## 安装

在终端执行一条命令：

```bash
dsh plugin --profile web add dsh-docs-panel
```

这条命令会自动完成全部工作：从 npm 拉取插件包、登记到 dsh 的启动清单。**重启 dsh 后生效**（重启方式取决于你自己的启动方式，例如重新运行 `dsh web`）。

重启后打开 dsh 网页，右上角就有「我的文档」按钮了。**以后每次 dsh 启动都会自动加载，无需重新安装。**

## 卸载

在终端执行一条命令：

```bash
dsh plugin --profile web remove dsh-docs-panel
```

然后重启 dsh 生效。卸载会保留你的文档目录配置，重新安装后依然生效。

## 使用

1. 点右上角「我的文档」打开面板；
2. 左侧列表点选一篇文档，右侧阅读；
3. 右上角 ⚙️ 修改文档目录（默认 `~/.dsh/docs`，保存到 `~/.dsh/storages/dsh-docs-panel/config.json`）；
4. 「☰ 大纲」展开目录，「Chrome / VS Code 打开」转到编辑器；
5. 点 ✕ 或面板外区域关闭。

## 常见问题

**文档列表是空的？** 往 `~/.dsh/docs` 里放几个 `.md` 文件即可（也可以点 ⚙️ 指向你自己的目录）。

## 目录结构

```
.
├── lib/
│   ├── index.js          # 宿主端：配置、文档读取、外部打开、剪贴板、HTTP 接口
│   └── client.js         # 浏览器端：按钮、面板、大纲、Markdown 渲染器
├── assets/
│   └── demo-panel.png    # README 演示图（「我的文档」阅读面板）
├── cordis.patch.yml      # dsh 启动清单补丁
├── markdown-test.cjs     # 渲染器自测（node markdown-test.cjs）
├── LICENSE
└── package.json
```

## 开发

自测 Markdown 渲染器：`node markdown-test.cjs`

## 许可证

MIT