前言¶

DeepSeek Harness（DSH）的默認 Web UI 以功能優先，但在長時間使用時，屏幕長時間暴露在默認的冷色背景和無襯線字體下，容易產生視覺疲勞。尤其是需要長時間閱讀、寫作或調試的智能體開發者，更希望界面能提供一種柔和、專注的視覺體驗。

暖紙 Warm Paper 是爲 DSH Web UI 設計的一套手記風主題，通過米杏紙色、宋體字族與磚紅色系的組合，將界面還原爲一種類似紙質手記的質感。它不修改宿主源碼，而是通過疊加主題 token 實現樣式覆蓋。

這是什麼¶

這是一個爲 DeepSeek Harness（DSH）設計的 Web UI 主題插件，由維護者 WitchKlee 發佈。

它解決的問題是：爲 DSH Web UI 提供一套自定義的視覺方案，讓界面呈現米杏紙色背景、宋體書卷氣字體、磚紅色強調色，並附帶紙紋質感、左側書脊線與日期戳等細節。

設計要點¶

暖紙通過以下方式實現手記風格：

• 色彩：米杏紙 #F5EEE0、深棕墨 #3B2F25、磚紅 #A24B3B、灰綠 #586D52。這些顏色通過 ctx.theme.overrideTokens() 覆蓋 --dsw-alias-* token（淺色與深色兩套）。
• 字體：正文與標題使用舊式襯線字體棧，優先級爲 Sitka / Palatino → 宋體 / 思源宋體 → SimSun。通過覆蓋 --dsw-font-family 實現，用戶在「正文字體」設置中填寫的字體排在最前，暖紙襯線棧始終墊後，無效字體名會回落到宋體。
• 材質：180px 極淡顆粒紙紋、左側 2px 磚紅書脊線、磚紅選區。通過門控樣式表 html[data-warm-paper="on"] 實現。
• 氣泡：用戶消息氣泡使用磚紅 #A24B3B 底色、米色 #FBF6EB 文字，鏈接始終下劃線。由於宿主未提供氣泡文字單獨 token，使用作用域選擇器 [class*="_bubble"] 補充樣式。
• 懸停卡：側欄會話/工作區的 HoverCard 改爲紙色卡片、墨色文字。通過定位覆蓋宿主原語中寫死的底色 #2C2C2E 和白色文字。
• 日期戳：輸入框下方顯示「● 2026 · 10 · 21」格式，通過 conversation.composer.dock 裝飾槽實現。

深色模式不是簡單反相，而是「夜讀紙」——暖褐紙面、米色墨字，磚紅提亮爲陶土色，灰綠提亮爲燈下的苔色。對比度按 WCAG 校準：正文約 11:1，三級文字約 5:1，磚紅按鈕與氣泡上的米色字約 5.4:1。

文件結構¶

index.js           Host half（空 apply，只爲讓 Client half 隨 profile 加載）
client.js          調色板 + 排版/紙紋/氣泡/日期戳 + 插件設置頁
cordis.patch.yml   bundle patch：插入 warm-paper-theme 條目
locale/en.json     插件管理器的元數據（英文）
locale/zh.json     插件管理器的元數據（中文）
icon.svg           手記紙頁 + 磚紅印章圖標
LICENSE            MIT 許可證

設置界面¶

暖紙自帶獨立的設置 tab，兩個入口共享同一份狀態：

• 設置 → 暖紙（設置面板左側一級 tab，排在「通用設置」和「模型」之間）
• 設置 → 插件 → 已安裝 → 暖紙 的 bundle 詳情頁（描述下方的配置區，即 plugins.bundle.config 槽，按包名 dsh-theme-warm-paper 掛載）

設置項包括：

• 啓用暖紙主題：總開關；關掉立即回到宿主原樣，其他選擇保留
• 紙色：米杏 / 宣白 / 茶褐 三種紙底；只換背景類 token，不動文字與強調色
• 紙紋：無 / 輕 / 重 三檔紙面顆粒
• 書脊線：左側那條 2px 磚紅訂口線，可單獨關掉
• 消息氣泡：磚紅 / 陶土 / 紙色 三種底色，磚紅與陶土自動反白文字
• 正文宋體：關掉後正文回到宿主的無襯線字體
• 襯線字體：宋體 / 思源宋體 / 仿宋（中文家族偏好；宿主「正文字體」仍優先）
• 正文字號：10–22px 步進器，與「通用設置 → 字號大小」是同一個宿主設置，兩邊同步
• 代碼字號：10–16px 步進器，與「通用設置 → 代碼字號」同步
• 終端字號：10–20px 步進器，作用於右側邊欄終端面板（需打開終端標籤）；與「通用設置 → 終端字號」同步
• 側欄字號：小 / 標準 / 大；覆蓋左側會話列表與導航的字號（宿主無此設置，由主題 CSS 覆蓋）
• 日期戳：完整 / 簡 / 關；「簡」只留月和日
• 恢復默認：回到出廠設置

頁面頂部有實況預覽：紙底、宋體樣字、用戶氣泡、日期戳都直接使用當前 token，改任何選項即時反映。

設置存儲在本地 localStorage（dsh-theme-warm-paper.settings），刷新後保留，換瀏覽器不跟隨。

安裝¶

在 DSH 裏由 plugin_manager 以本地目錄安裝：

plugin_manager({ action: "install_bundle", target: "<本目錄絕對路徑>" })

安裝後 Client 半邊隨 HMR 生效；若宿主提示需重啓，重啓 DSH 後再看。

關閉 / 卸載¶

• 關閉：設置 → 插件 → 已安裝 → 暖紙 → 詳情頁裏的「啓用暖紙主題」開關；或在同一列表裏禁用該 bundle（卸載客戶端模塊，主題與日期戳一起撤走）。
• 卸載：plugin_manager({ action: "remove_bundle", target: "dsh-theme-warm-paper" })。

兼容性¶

• 需要支持 ctx.theme.overrideTokens() 的 DSH（0.2.x Client 契約）。
• 已驗證：DSH Desktop 0.2.1-rc.2（2026-10-21），淺色 / 深色 / 跟隨系統、設置頁、日期戳均正常；完全退出後冷啓動複驗通過。
• 不 patch 宿主源碼、不改宿主 CSS 文件；調色板全部走 --dsw-alias-* token。
• 唯一依賴的宿主類名是用戶氣泡的 CSS Modules 局部名（<hash>_bubble）與左側欄的字號類（<hash>_title / _meta / _time 等），因爲宿主沒有給這兩類文字單獨的 token。宿主若改名，這兩處會退回宿主原樣式（氣泡底色 + 墨字 / 側欄原字號），其餘部分不受影響。
• 若同時啓用了其他主題插件，後註冊的 token 層按 token 覆蓋，建議只留一個主題。

版本與許可證¶

• 版本：1.0.0（2026-10-21）：首個定稿版本。暖紙淺 / 深雙主題、紙紋 / 書脊、宋體棧、三色氣泡、日期戳與獨立設置頁；在 DSH Desktop 0.2.1-rc.2 上驗證通過。
• 許可證：MIT。

適用場景與注意¶

適合需要長時間閱讀、寫作或調試智能體開發場景的用戶，希望界面能提供一種柔和、專注的視覺體驗。

使用前應檢查源碼與許可證。插件以當前 DSH 進程權限運行，安裝前建議審查代碼。

總結¶

暖紙 Warm Paper 是一個爲 DeepSeek Harness 設計的手記風 Web UI 主題，通過米杏紙色、宋體字族與磚紅色系，將界面還原爲類似紙質手記的質感。它支持淺色與深色兩種模式，提供紙紋、書脊線、日期戳等細節，並通過獨立設置頁允許用戶自定義紙色、紙紋、氣泡、字號等選項。

• 目錄頁：https://www.skillhub.cn/plugins/WitchKlee/dsh-theme-warm-paper
• GitHub：https://github.com/WitchKlee/dsh-theme-warm-paper