DeepSeek Harness (DSH) 的 Web 界面通过插件机制支持功能扩展。针对界面视觉定制，社区提供了 TangSan 插件。它不改变底层逻辑，仅通过覆盖样式和注入资源，将生成的唐三形象作为背景、品牌标识和设置入口。
这是什么¶
TangSan 是一个为 DSH Web GUI 提供的唐三形象美化层。由用户 bauerelizabeth07139 维护，采用 MIT 许可证。它将一张 16:9 的唐三插画作为界面背景，并将方形头像注入为侧边栏和会话标题的品牌标识，同时提供一套可视化的设置面板来调整外观参数。
核心功能¶
-
聊天背景
插件内置的 16:9 艺术品被挂载为全屏背景层。该层固定且不可点击。同时，插件会降低界面表面（Shell）的透明度，使背景图透出来，而不是被不透明的界面遮挡。 -
外观控制
通过设置面板实时调整以下参数：- 不透明度：控制界面表面（如侧边栏、对话框）的透明度，数值越低背景越明显。
- 模糊：对背景图应用高斯模糊效果。
- 暗色遮罩：在背景上覆盖一层与主题色匹配的遮罩（暗色模式下为黑色，亮色模式为白色），用于提升文字可读性。
- 位置：调整背景图的
background-position。
-
品牌标识替换
通过官方插槽sidebar.brand.mark和conversation.hero.brand.mark，将默认的 Logo 替换为插件自带的唐三方形头像。 -
独立设置页
在 DSH 的设置菜单中新增「唐三美化 TangSan」页面。该页面提供参数预览、开关和保存功能，是管理插件外观的唯一入口。 -
标签页图标
当品牌标识开启时，浏览器标签页的 favicon 会跟随唐三头像；关闭后恢复默认图标。 -
本地服务
插件通过 DSH Web 服务器提供资源（/api/tangsan/...），浏览器无需访问外部网络即可加载图片和配置。
安装与启用¶
CLI 安装（Web Profile）¶
在终端执行以下命令安装到当前启动的 Web 配置文件：
dsh plugin --profile web add bauerelizabeth07139/tangsan
桌面应用安装¶
桌面版应用通过内置插件管理器安装：
- 打开 Plugins（插件）面板。
- 选择 Add plugin（添加插件）。
- 输入插件地址：
https://github.com/bauerelizabeth07139/tangsan
- 在新出现的 tangsan 条目中点击启用。
注意：DeepSeek Harness Desktop 启动时使用的是 desktop 配置文件，而上述 CLI 命令默认安装到 web 配置文件。因此，直接在桌面应用中通过 CLI 安装不会生效，必须使用应用内的插件管理器。
无 Git 环境¶
如果系统未安装 Git，owner/repo 形式的安装命令会报错（git is not recognized）。此时应使用 HTTPS 方式安装：
dsh plugin --profile web add https://codeload.github.com/bauerelizabeth07139/tangsan/tar.gz/main
典型用法¶
安装并启用插件后：
- 打开 Settings（设置）。
- 找到 唐三美化 TangSan 页面。
- 根据喜好调整壁纸不透明度、模糊程度和遮罩。
- 保存设置，界面会立即应用新样式。
卸载时使用 CLI：
dsh plugin --profile web remove tangsan
注意事项¶
-
配置文件路径
插件的配置文件默认位于$DSH_HOME/tangsan.json（即~/.dsh/tangsan.json）。该文件也可通过 HTTP 接口访问。 -
Manifest 语法错误
插件加载器在启动时会解析配置文件，如果 manifest JSON 开头出现多余逗号（, {），会导致 Harness 崩溃。桌面版的“禁用第三方插件”功能无法修复此问题，需要手动编辑文件删除该逗号。 -
Git 依赖
使用dsh plugin安装时，底层依赖pnpm，它会调用git ls-remote。确保 PATH 中包含 Git 可执行文件，否则无法通过简写地址安装。
短结尾¶
TangSan 插件为 DSH Web 界面提供了一套完整的视觉主题方案，涵盖了背景、图标和交互控件。它通过本地服务提供资源，保持了界面的纯净与稳定。更多细节和源码，可参考其 GitHub 仓库。
