在使用 DeepSeek Harness 進行開發或小說創作時，通常需要在文件管理、代碼編輯和文檔閱讀之間切換。這種切換會打斷心流，也容易造成上下文丟失。DSH 的插件生態提供了擴展空間，其中 dsh-readwrite-hub 插件整合了文件管理、碼字模式和小說閱讀功能，試圖在一個工作區內解決這些問題。
這是一個面向 DeepSeek Harness 的讀寫字間插件，修改自 dsh-workspace-explorer（MIT 許可證），由 Nth-5620 維護。它將同一個文件在“碼字”和“閱讀”兩種形態間切換，共享排版偏好，並提供自動保存和進度記憶功能。
核心功能¶
閱讀模式¶
閱讀模式針對長文本閱讀進行了優化，採用 CJK 字寬校準與字符切片技術實現按字分頁。頁面底部僅保留一行安全餘量，頁面始終填滿，新章節會自動另起一頁。
- 進度管理：翻頁即自動保存進度（寫入 ~/.dsh/readwrite-hub/state.json），關閉應用或切換文件後重新打開可自動續讀。支持自動進度書籤（置頂顯示）與用戶書籤。
- 交互：支持鍵盤翻頁（PageUp/Down 等）、點擊進度條跳轉、底部跳頁輸入框。閱讀模式與碼字模式共享字號、行距、背景等排版偏好。
- 章節導航：自動解析多種章節格式（如“第一章”、“序章”、“Chapter N”等），點擊目錄可直達對應章節。
- 滾動優化：在滾動模式下，段落啓用 content-visibility: auto，長文檔拖動流暢。
碼字模式¶
碼字模式爲小說創作提供專門的寫作環境。
- 橫線格與自動保存：提供橫線格背景（CSS 漸變繪製，原生滾動無卡頓），停止輸入 3 秒後自動保存。
- 排版控制：支持切換字體（襯線/楷體/無襯線/等寬）、字號（A-/A+）、行距、左右邊距及紙張背景（默認/米色/淺綠/藍色）。
- 格式化：支持一鍵去除行首縮進及段落間自動空行。
書架系統¶
閱讀過的文本文件會自動登架。書架界面與文件樹視圖通過頂欄圖標切換。
- 管理：支持按最近閱讀時間排序，可置頂、搜索、移除。
- 續讀：點擊書架中的書籍會自動以閱讀模式打開並續讀。
- 失效檢測：如果源文件被移動或刪除，書架會標記“無法打開”，可一鍵移除。
EPUB 只讀閱讀¶
在文件樹中打開 .epub 文件會自動進入只讀閱讀模式。
- 渲染：集成 foliate-js 在瀏覽器內直接解壓渲染。
- 進度記憶：使用 CFI（章內精確位置）記錄進度，與文本閱讀共用同一進度字段。
- 安全邊界：通過 CSP 阻斷非本域腳本，僅放行 EPUB 自身排版所需的 data: / blob: 資源。請只讀取來源可信的 EPUB。
文件管理¶
- 固定側邊欄：提供固定右側側邊欄，支持拖拽調整寬度，替代彈窗雙欄面板。
- 單工作區樹：只顯示當前會話所屬工作區的文件樹。
- 引用與跳轉：支持通過原生機制插入 @ 文件引用，點擊對話內的文件鏈接可在插件內打開。
安裝¶
dsh plugin --profile web add github:Nth-5620/dsh-readwrite-hub
安裝後請重啓 dsh web 並硬刷新瀏覽器（Ctrl+Shift+R）。側邊欄底部出現「工作區文件」按鈕即表示加載成功。
典型用法¶
- 在側邊欄文件面板打開文本文件（.txt 或 .md）。
- 點擊工具欄的「碼字」按鈕進入寫作模式，或點擊「閱讀」進入書籍模式。
- 在閱讀模式下，點擊頂欄「書架」圖標切換視圖，或點擊目錄直接跳轉至對應章節。
- 點擊頂欄「書架」圖標關閉書架，可切換回文件樹視圖。
注意事項¶
- 運行環境：插件完全在本地運行，不發起出站網絡連接，不上傳文件內容。文件讀寫通過本地 HTTP API 完成。
- 版本依賴：依賴 DeepSeek Harness 0.1.1-rc.2+ 或 0.1.2-alpha.1+。
- EPUB 安全：EPUB 模式爲只讀，請只讀取來源可信的 EPUB。
- 權限範圍：若自行將
dsh web綁定到非迴環地址，插件 API 將暴露在非本地網絡，請勿將帶本插件的 DSH 直接暴露到公網。
