在 DeepSeek Harness (DSH) 中進行智能體開發時,默認的 Web 界面採用居中窄氣泡佈局,對話區兩側留白較多,且缺乏個人標識。dsh-conversation-flat 插件通過修改 CSS 和注入輕量 DOM,將對話區調整爲文檔流全寬佈局,並增加了個人資料顯示功能。
此插件由 Idreamxkl 維護,採用 MIT 許可證。它適用於 dsh 0.1.2-alpha.5 版本,核心依賴項爲 schemastery。安裝後,對話列鋪滿內容區,用戶消息變爲通欄淺色條,助手回覆帶有“DeepSeek”標籤,Markdown 表格自動撐滿列寬。
核心功能¶
- 文檔流佈局:對話內容不再居中限制寬度,而是全寬列布局。
- 用戶消息:從右對齊氣泡改爲通欄淺色圓角條,文字靠左。
- 助手標識:回覆上方顯示灰色“DeepSeek”標籤。
- 表格顯示:Markdown 表格撐滿列寬,與文字左對齊。
- 個人資料:設置面板新增“個人資料”分區,可配置名字和頭像。名字和頭像顯示在每條用戶消息上方(圓形頭像 + 名字)。未上傳頭像時,顯示名字首字符圓形徽標。
安裝與啓用¶
使用官方安裝命令添加插件:
dsh plugin --profile web add github:Idreamxkl/dsh-conversation-flat
安裝完成後重啓 dsh web 即可生效。設置保存在服務端 ~/.dsh/settings.yaml。
自定義調整¶
所有佈局規則在 bundle/client.js 中。常用的調整方式如下:
- 調整寬度:將
conversation column規則中的max-width從none改爲折中值(如1400px)。 - 移除頭像/名字:在設置面板清空名字和頭像;若想移除“DeepSeek”標籤,刪除
bundle/client.js中“assistant messages”部分的::before規則。 - 修改顏色:調整
color-mix()中的百分比以改變用戶消息條的深淺。
技術細節與注意事項¶
- 存儲機制:設置保存在服務端
~/.dsh/settings.yaml。局域網內其他設備(平板/手機)因設置通道僅限本機,會自動改用該設備的localStorage保存個人資料。 - 流式輸出:消息上的頭像行會隨消息流式輸出自動重建。
- 副作用管理:所有副作用通過
ctx.effect註冊,禁用插件即可完整移除頁面副作用。 - 依賴與兼容性:依賴
schemastery,適配 dsh 0.1.2-alpha.5。CSS 選擇器基於@deepseek-ai/dsh-client-ui-chat的 CSS-module 哈希匹配。