在 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 哈希匹配。