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 進程後需要重新設置。
