前言¶
在 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 为准。
