前言¶
dsh-custom-workspace 是面向 DeepSeek Harness(DSH)Web 的插件。它讓每個工作區單獨配置背景、聊天字號、Markdown 行高、Markdown 塊間距和 Retina 字體渲染,並把設置按工作區保存到本地配置中。下面介紹它的功能、安裝方式和典型用法。
這是什麼¶
dsh-custom-workspace 的倉庫 owner 爲 JeremyGuo,許可證爲 MIT。它解決的問題是:在 DSH Web 中,不同工作區可能需要不同的閱讀密度和外觀,而插件可以把這些外觀設置按工作區保留。
核心功能¶
- 主工作區背景顏色或圖片 URL。
- 獨立 Markdown 正文字號和行高。
- 段落、列表、標題、引用、代碼塊的 Markdown 塊間距。
- Retina 顯示器灰度抗鋸齒開關。
- 按工作區持久化到
$DSH_HOME/settings.yaml。
安裝與啓用¶
安裝前建議先檢查源碼與 MIT 許可;插件以當前 dsh 進程權限運行。
環境要求:
- DeepSeek Harness
0.1.0-rc.6。 - Node.js
^22.19.0或>=24.0.0。 - loopback DSH Web 會話;settings RPC 會拒絕非 loopback 瀏覽器。
安裝命令:
dsh plugin --profile web add dsh-custom-workspace
安裝後打開 Settings → General Settings → Workspace Appearance,配置所選工作區。修改會立即保存。
典型用法¶
下面兩種配置可以按閱讀習慣選擇:
- 緊湊閱讀:
13px字號、20px行高、4px塊間距、#eef4ff背景。 - 寬鬆閱讀:
20px字號、38px行高、28px塊間距、#fff3e8背景。
背景可以配置顏色,也可以配置圖片 URL。圖片 URL 會直接使用,加載結果依賴瀏覽器網絡和瀏覽器內容安全策略。
本地開發流程:
pnpm install
pnpm run verify
dsh plugin --profile web add link:$PWD
pnpm run watch
先安裝依賴並執行校驗,再用本地路徑加載插件,最後啓動 watch 流程。
持久化與安全¶
設置保存在 $DSH_HOME/settings.yaml。Host 端擁有 custom-workspace 設置命名空間,並註冊專用 /custom-workspace Connection RPC 通道。該通道只接受 loopback 請求,也不暴露其他設置命名空間。
瀏覽器端會驗證響應;寫入失敗時重新加載 Host 值;斷開或非 loopback 瀏覽器會把範圍標記爲不可用。通過 LAN 主機名訪問的瀏覽器不可用設置,即使 DSH Web 服務器信任該主機名。
適用場景與注意¶
適合需要在 loopback DSH Web 會話中調整閱讀密度、背景、字號、行高、塊間距和 Retina 字體渲染的用戶。工作區外觀隻影響瀏覽器呈現,不進入模型請求或會話日誌。
使用注意:
- 僅支持 loopback DSH Web 會話。
- 背景圖片直接使用配置 URL,依賴瀏覽器網絡和內容安全策略。
- 本版本面向 DSH
0.1.0-rc.6;預發佈 DSH API 可能變化且不提供兼容墊片。 - 安裝前應檢查源碼與許可證。
鏈接¶
dsh-custom-workspace 的價值是提供按工作區保留的 DSH Web 外觀設置,不改變模型體驗。
- GitHub:https://github.com/JeremyGuo/dsh-custom-workspace
- 目錄頁:未提供 URL