前言¶
在 DeepSeek Harness（DSH）里長時間對話時，消息往往是上下堆疊的單欄排版，和常見 IM 的「左右分列 + 頭像」不太一樣。若還想單獨調正文字號、代碼字體或行距，往往要另找字體類插件，或啓用功能很多的壁紙引擎只爲用其中的頭像擴展。下面介紹的 dsh-avatar-font（界面名稱「頭像和字體」）把「雙方頭像 + 聊天式分列」和「界面/正文字體與字號」收進一個包，且 頭像 與 字體 兩個模塊各自有開關，關掉其中一個不影響另一個。
這是什麼¶
- 插件包名：
dsh-avatar-font（npm / 倉庫名一致） - 維護者：lerwa2025-a11y
- 分類：趣味換裝（社區目錄）
- 當前版本（package.json）：2.0.0，MIT 協議
- 來源：頭像邏輯來自壁紙引擎插件（dsh-plugin-wallpaper-engine）的會話頭像擴展，字體能力來自 dsh-fonttune 的精簡移植；不含壁紙、液態玻璃、點擊特效等。原作者 elysia395（dsh-wallpaper-engine）MIT 協議，README 中另有致謝說明。
v2.0 起插件由舊名 dsh-conversation-avatar 更名爲 dsh-avatar-font，「AI 回覆氣泡框」整套功能已移除；舊包棄用、舊倉歸檔，設置與頭像數據會自動遷移。
社區目錄頁：https://www.skillhub.cn/plugins/lerwa2025-a11y/dsh-avatar-font
源碼與說明：https://github.com/lerwa2025-a11y/dsh-avatar-font
核心功能¶
頭像¶
- 每條消息行配頭像：
user/steering在右側，assistant-step在左側；展開「已完成，用時…」過程區時，區內各行同樣各配一張。 - 跟隨滾動（默認開）：長回覆向下滾動時，頭像貼在滾動區頂部跟隨；整條消息滾出視口後消失。關閉後頭像只固定在消息開頭，隨內容一起滾走。
- 吸頂下移：翻頁時頭像下移若干「身位」（默認 2），減輕被主題狀態欄遮擋；僅在「跟隨畫面」開啓時可調，關閉跟隨時該項置灰。
- 未上傳圖片時使用內置 SVG 默認頭像（我方人像、助手四角星），顏色跟隨主題文字色。
- 獨立開關：關閉「頭像」後，注入節點與行標記還原，消息恢復 DSH 原生排版；字體設置仍生效。
字體¶
- 界面字體：微軟雅黑 / Noto Sans SC / 宋體 / 黑體 / 楷體 / 仿宋（清單僅列 README 寫明在本機實測安裝過的字體）。
- 正文字體：覆蓋界面字體，只作用於正文；側邊欄標題仍走界面字體。
- 代碼字體：Consolas / JetBrains Mono / 系統等寬。
- 正文字號：相對主題 −4…+8 px（0 不變）；標題字號：−6…+12 px，與正文獨立。
- 行距：−20…+60 %；正文加粗：0 表示跟隨主題，只加粗段落。
- 正文字色 / 我的消息字色：留空跟隨主題；分別作用於 AI 回覆正文與用戶/steering 消息，代碼塊、思考區、工具調用卡片等有意排除（詳見 README）。
- 獨立開關：關閉「字體」後移除字體與字色覆蓋，界面回到主題默認；頭像照常顯示。
README 明確：不要同時啓用本插件與壁紙引擎的「自定義會話頭像」，否則會在同一批消息行插入雙重頭像。
去掉氣泡框後，寬表格、長代碼行等可能再次橫向溢出正文區，這是 v2.0 移除氣泡及其兜底規則的已知後果。
安裝與啓用¶
任選一種方式安裝，安裝後均需重啓 DSH。插件以當前 DSH 進程權限運行，安裝前請自行查看倉庫源碼與 MIT 許可證。
方式一：從本機文件夾加載（改代碼即時生效）
DSH 界面：插件 → 添加插件 → 選擇「從本地/文件夾安裝」，指向插件目錄。
或命令行（desktop 換成你的 profile 名）：
dsh plugin --profile desktop add "本地文件夾的絕對路徑"
方式二：從 npm 安裝
dsh plugin --profile desktop add dsh-avatar-font
方式三：從 GitHub 安裝
在 插件 → 添加插件 中填入：
https://github.com/lerwa2025-a11y/dsh-avatar-font
公開倉庫可由 DSH 自動拉取；私有倉庫需先在其它環境登錄 GitHub。
方式四：將文件夾打成 ZIP，在 DSH 中用「導入」選擇該壓縮包。
啓用步驟（README「安裝後」）：
- 重啓 DSH
- 打開 設置 → 插件 → 已安裝 → 點開「頭像和字體」
- 需要頭像則上傳圖片並調大小、圓角；需要改字體則在「字體」卡片中設置
- 兩個功能頂部開關默認均爲開啓，不需要的功能可單獨關閉
面板沒有單獨的「啓用插件」總開關；啓停以 DSH 插件管理 爲準。
頭像圖片與 settings.json 存放在 $DSH_HOME/dsh-avatar-font/（換機需重新上傳或拷貝該目錄）。卸載插件會去掉界面上的頭像與字體覆蓋，但已上傳圖片與設置文件會保留。
典型用法¶
只想要 IM 式頭像、不改字體
在插件詳情頁關閉「字體」開關，保留「頭像」；上傳「AI 頭像 / 我的頭像」，按需調整 16–128 px 大小與 0–100% 圓角；長回覆可保持默認「跟隨畫面」，若主題頂欄遮擋可微調「吸頂下移」。
只調閱讀體驗、不要頭像
關閉「頭像」，保留「字體」：例如界面字體選 Noto Sans SC、正文字號 +2 px、代碼字體 JetBrains Mono；「正文字色」「我的消息字色」可只填一邊或留空跟主題。
從舊版 dsh-conversation-avatar 升級
README 說明可將 $DSH_HOME/dsh-conversation-avatar/ 整目錄改名爲 $DSH_HOME/dsh-avatar-font/，氣泡相關鍵會被丟棄，頭像與字體項保留。
插件還提供 HTTP 路由（供界面讀寫）：GET/POST /dsh-avatar-font/settings，以及 /dsh-avatar-font/avatar/<side> 的 GET/POST/DELETE；日常使用以設置頁卡片爲主即可。
適用場景與注意¶
- 適合：希望會話區更接近好友聊天佈局、又不想裝整套壁紙引擎的用戶；需要在不 fork 主題的前提下微調字體、字號、行距或部分字色的 DSH 日常使用者。
- 注意：插件依賴 DSH 宿主 DOM 與 CSS 變量（如
data-chat-flow-kind）；大版本升級 DSH 後若佈局異常，可先看 Issues。 - 安全：第三方插件非 DeepSeek / 幻方官方發佈；SkillHub 等爲社區目錄，與官方無從屬關係。安裝前請閱讀源碼與許可證，並理解其運行在 DSH 同一進程內。
結尾¶
dsh-avatar-font 把會話頭像與字體 tuning 合併爲兩個可獨立關閉的模塊，安裝方式覆蓋本地文件夾、npm、GitHub 與 ZIP 導入。需要條目說明與分類標籤時，可打開社區目錄頁 lerwa2025-a11y/dsh-avatar-font；細節與更新日誌以 GitHub README 爲準。
