DeepSeek Harness (DSH) 采用插件化架构。在 Web GUI 模式下，开发者常需要在对话窗口旁查看文档或交接记录。dsh-doc-rail 插件在界面右侧添加了一个可调整宽度的文档面板，用于展示 Markdown 或纯文本文件。
插件定位¶
该插件为 DeepSeek Harness 的 dsh web 界面提供右侧文档栏。它由 ShineFree7 维护，采用 MIT 许可证。插件通过 shell.overlay 挂载，以追加模式存在，不替换 DSH 自带的 UI。
核心功能¶
- 文档查看：在右侧面板渲染 Markdown 或纯文本文件。
- 主题支持：内置浅色（暖纸色）和深蓝两种主题，可随时切换。
- 宽高调整：支持拖拽左侧边缘调整宽度；双击左侧边缘可重置为 400px。
- 文件管理：支持打开本地
.md或.txt文件；自动记录最近打开的文件历史。 - 自动同步：每 4 秒重新读取文件内容，当源文件在磁盘上更新时，面板内容会自动刷新。
安装与启用¶
在安装前，请确保当前 DSH 环境已启用 webServer 服务，并运行在 Web GUI 模式下。
安装命令如下：
dsh plugin --profile web add dsh-doc-rail
安装后，重启 dsh web，右侧将出现文档面板。点击面板上的 ✕ 可收起，点击下方的 📄 文档面板 按钮可重新打开。
使用方法¶
- 打开文件：在输入框中粘贴文件的完整路径（支持
.md或.txt），按 Enter 键；或直接点击“打开”按钮。 - 历史记录：点击“最近”可跳转至上次查看的文件；点击“清空输入”可重置路径框。
- 切换主题：点击“浅色”或“深色”按钮切换配色方案。
- 调整宽度：按住左侧边缘拖拽以改变宽度。
注意事项与要求¶
- 运行环境：仅支持 Web GUI (
dsh web) profile。在 CLI-only profile 下不会生效。 - 依赖版本：需要 Node.js >= 24。
- 隐私安全：所有文件读取和配置均在本地进程内存中完成，通过同源 JSON 接口通信，无网络服务，无遥测数据。
- 状态持久化：面板的外观样式、宽度和历史记录保存在进程内存中。刷新页面可保留，但重启 DSH 进程后需要重新设置。
