唐三美化 bauerelizabeth07139/tangsan

tangsan

DeepSeek Harness Web GUI 的唐三吉祥物外观层 —— 一张生成的唐三（TangSan）肖像，随插件一同发布，被 harness 用作其背景、品牌标识和设置界面。

唐三肖像唐三壁纸

功能

- 聊天背景 —— 随附的 16:9 插画作为固定、可穿透点击的图层挂载在整个 GUI 之后。外壳的表面令牌（--dsw-alias-bg-base、--dsw-specific-sidebar-fill、--dsw-alias-bg-layer-1/2）会淡化到配置的不透明度，让壁纸真正透出来，而不是被不透明的外壳遮住，同时根背景会被清空以露出壁纸。
- 控件 —— 外壳表面的不透明度、壁纸模糊、用于提升可读性的暗色遮罩，以及 background-position，全部实时生效。
- 品牌标识 —— 方形唐三头像通过内置的 sidebar.brand.mark 和 conversation.hero.brand.mark 插槽，替换侧边栏和对话主视觉中的 logo。
- 设置区块 —— 设置中的「唐三美化 TangSan」页面可编辑所有内容，并预览两张插画，保存时应用。
- 标签页图标 —— 品牌标识开启时，浏览器标签页的 favicon 会跟随同一唐三头像；关闭时恢复原有图标。
- 宿主端 —— 由本地 DSH Web 服务器（/api/tangsan/...）提供插画和配置，因此浏览器无需访问外部，并将配置写入 HTML，使 GUI 启动时即已装扮完毕。

安装

dsh plugin --profile web add bauerelizabeth07139/tangsan

插件管理器接受的任何格式都可以 —— GitHub 简写、完整 git URL 或本地检出：

dsh plugin --profile web add https://github.com/bauerelizabeth07139/tangsan.git
dsh plugin --profile web add C:\path\to\tangsan

然后打开 设置 → 唐三美化 TangSan。使用 dsh plugin --profile web remove tangsan 卸载。

配置

配置位于 $DSH_HOME/tangsan.json（默认 ~/.dsh/tangsan.json），由设置区块编辑；也可通过 HTTP 访问。

| 字段 | 默认值 | 含义 |
| wallpaper | true | 将唐三插画用作 GUI 背景 |
| brand | true | 用唐三头像替换侧边栏和主视觉 logo |
| surfaceOpacity | 60 | 外壳表面不透明度（%）—— 越低显示越多壁纸，越高外壳越不透明（25–100） |
| blur | 0 | 应用于壁纸的高斯模糊，单位为 px（0–24） |
| scrim | 35 | 覆盖在壁纸上的调色板匹配色罩 —— 深色主题为黑色，浅色主题为白色 —— 用于提升对话可读性，单位为 %（0–90） |
| position | center | 壁纸 background-position：center、left、right、top、bottom |

| 路由 | 方法 | 用途 |
| /api/tangsan/config | GET / PUT | 读取 / 写入配置（写入仅限同源） |
| /api/tangsan/wallpaper | GET | 16:9 背景图 |
| /api/tangsan/mark | GET | 方形头像图 |
| /api/tangsan/diag | GET / POST | 最近一次浏览器端诊断报告（挂载状态、表面覆盖、错误） |

所有值均在服务端进行钳制；未知键会被丢弃。

素材来源

两张图均使用 SenseAudio 同步图片生成 API（模型 senseaudio-image-2.0-260319）生成：竖版画像以用户提供的参考图为底，横版壁纸再以该画像为参考图生成。衍生图——512×512 头像标识与随插件分发的 JPEG 文件——均由这两次生成裁切而来。

开发

无构建步骤，无运行时依赖（React 与 @deepseek-ai/cordis 是由宿主提供的 peer 依赖）。

npm test # node >= 22：宿主路由/配置/标记测试 + 客户端 DOM-stub 测试

- lib/index.js —— 宿主半部分：配置文件、三个路由、HTML 启动标记。
- lib/client.js —— 浏览器半部分：壁纸层、表面淡出、品牌标识插槽、设置区。
- cordis.patch.yml —— 使两半部分均被加载的加载器行。

DeepSeek Harness 网页端的唐三美化形象插件 —— 一张生成的唐三插画随插件一起分发，由 Harness 当作背景、品牌标识与设置项穿在身上。

功能

- 聊天背景：内置 16:9 横版插画作为不可点击的全屏背景层；同时把界面的表面色令牌（--dsw-alias-bg-base、--dsw-specific-sidebar-fill、--dsw-alias-bg-layer-1/2）按设定透明度调淡，背景才能真正透出来，而不是被不透明的界面挡住。
- 可调参数：界面不透明度、背景模糊、暗色遮罩、壁纸位置，改动即时生效。
- 品牌标识：通过官方的 sidebar.brand.mark 与 conversation.hero.brand.mark 插槽，把侧栏与会话标题处的 logo 换成唐三方形头像。
- 设置页：Settings 里的「唐三美化 TangSan」页面提供两 artwork 预览与全部开关，保存即生效。
- 标签页图标：品牌标识开启时，浏览器标签页小图标也换成同一张唐三头像；关闭后恢复官方图标。
- 宿主半：由本地 DSH Web 服务直接提供 artwork 与配置接口（/api/tangsan/...），浏览器无需访问外部网络；配置同时被盖进 HTML，页面一打开就是美化后的样子。

安装

dsh plugin --profile web add bauerelizabeth07139/tangsan

随后打开 Settings → 唐三美化 TangSan。卸载：dsh plugin --profile web remove tangsan。

配置

配置文件为 $DSH_HOME/tangsan.json（默认 ~/.dsh/tangsan.json），字段与取值范围见上方英文表格；服务端会做钳制并丢弃未知字段。

素材来源

两张插画均由 SenseAudio 同步图片生成接口（模型 senseaudio-image-2.0-260319）生成：竖版画像以用户提供的参考图为底，横版壁纸再以该画像为参考图生成；512×512 头像等衍生图由这两次生成裁切而来。

开发

npm test # 需要 node >= 22，无任何运行时依赖

License

MIT