塔菲直播工房 lengzhanbao/dsh-taffy-theme

Taffy Astral Atelier / 塔菲星夜工房

awesome · DSH plugin

为官方 DSH Desktop 打造的塔菲主题 —— 星夜工房背景、可选的九套素材、粉金亚克力对话框、三档侧栏边框，以及可独立调节的聊天外观（自己的消息气泡 / 输入框）。

| Package | @dsh-external/dsh-taffy-theme |
| Version | 0.2.2 |
| 目标宿主 | DSH Desktop 0.2.x（desktop profile） |
| Requires | engines.dsh：>=0.2.1-rc.2 <0.3.0 |
| 只改外观 | 不接管 DSH 原生按钮、事件与几何布局 |

0.2.x 单一版本线：本版只支持 DSH 0.2.1-rc.2 起的 0.2.x。0.1.x 宿主请使用旧版 Release。

Taffy theme for DSH Desktop — a DeepSeek Harness (DSH) Desktop theme plugin: nine selectable art sets, adjustable sidebar watermark, three sidebar frame levels, and a custom chat bubble / composer look.

关键词：DSH · DSH Desktop · DeepSeek Harness · DSH 插件 · DSH 主题 · 塔菲 · Taffy
· Astral Atelier · 深色主题 · 粉金 · 亚克力 · 桌面主题 · dark theme · plugin

目录

- 装机 · 素材：九套
- 聊天外观 · 侧栏水印可见度 · 三档侧栏边框
- 与 DSH 的关系 · 验证边界 · 卸载 · English

为什么用它

- 九套素材随便挑：5 张 16:9 背景、2 张 9:16 侧栏水印、2 张 Q 版，全部单独选择，也能一键回默认。
- 不动 DSH 一根手指：原生按钮的尺寸、图标、点击区域、事件都不碰，仓库里有静态守卫测试盯着。
- 升级不惊吓：已有配置保持原样，新素材只在你主动选了才生效。
- 可调而非写死：气泡、输入框、水印可见度、侧栏三档，都能自己调。

装机

DSH Desktop 使用 desktop profile：

dsh plugin --profile desktop add https://github.com/lengzhanbao/dsh-taffy-theme/releases/download/v0.2.2/dsh-external-dsh-taffy-theme-0.2.2.tgz

或下载 Release 附件后本地安装：

dsh plugin --profile desktop add .\dsh-external-dsh-taffy-theme-0.2.2.tgz

装完 完全退出并重开 DSH Desktop —— 客户端 bundle 只在启动时加载，仅刷新窗口不够。

然后打开 设置 → 通用 → 塔菲工房。

素材：九套，全部可选

背景、侧栏水印、底部 Q 版各自独立设置，也可一键恢复默认。
升级不会替换你正在用的画面 —— 已有配置一律保持原样，新素材只在你主动选择后生效。

背景（5 张，16:9）

| 观星台 | 星空露台 | 星夜创作室 |
| 观星台 | 星空露台 | 星夜创作室 |
| 午夜工房 | 星夜钢琴室 | |
| 午夜工房 | 星夜钢琴室 | |

侧栏水印（2 张，9:16）

| 星空侧栏 | 梅色梦境 |
| 星空侧栏 | 梅色梦境 |

底部 Q 版（2 张，1:1）

| 抱猫猫 | 张开手 |
| 抱猫猫 | 张开手 |

经典壁纸

升级前的两张原版壁纸完整保留，并且是独立选项（经典花房 / 经典舞台）——浅色外观也能主动选深色舞台，反之亦然。

聊天外观（0.2.0 新增）

| 设置 | 可选项 |
| 我的消息气泡 | 原生 / 玻璃 / 华丽 |
| 气泡边框 | 无边框 / 细边 / 强调 |
| 气泡背景不透明度 · 圆角 · 最大宽度 | 滑块 |
| 输入框样式 | 原生 / 玻璃 / 华丽 |
| 输入框装饰强度 | 无装饰 / 简约 / 完整 |
| 输入框不透明度 · 圆角 | 滑块 |

- 气泡透明度只作用于背景色，不会让文字和按钮一起变淡。
- 输入框「完整」才绘制金色角饰；「简约」是细粉边；「无装饰」完全干净。
- 助手回复、工具卡片、代码块、Markdown 容器不受影响。

侧栏水印可见度

水印与侧栏底板、文字、按钮完全解耦：0 = 隐藏，100 = 最高可见度，滑杆只调水印这一层。
默认值对应旧版 62% 纱幕下的观感，升级不需要重新调。

三档侧栏边框

| 档位 | 效果 |
| 关闭 | 不绘制任何边线 |
| 简约·柔光 | 一条粉紫细侧线 + 底部短柔光 |
| 完整·细框 | 左右香槟金细线 + 上下短线 |

三档都不改动 DSH 原生按钮的尺寸、图标、点击区域与事件；边框、水印、可见度三者互相独立。

「完整·细框」的金线与角饰取自输入框那套粉金纹样（卷草、上下对称金纹），按面积缩放：气泡只保留一处小角饰，选中卡片用顶部短纹，侧栏把纹样集中在品牌与 Q 版两端。

与 DSH 的关系

- 不接管原生交互：不为原生按钮换图标、改尺寸或加伪元素；仓库内有静态守卫测试（tests/native-controls-untouched.test.ts）防止回退。
- 锚点只用宿主稳定属性：[data-chat-flow-kind='user']、--dsw-specific-bubble、 --dsw-radius-xl、--dsh-chat-content-width，不使用会随构建变化的哈希类名。
- --dsw-* token 限定在 DSH 列容器内，亚克力效果 opt-in，降低误伤第三方插件风险。
- 架构思路参考 maid-atelier， 未复制其代码与资产。

验证边界

| 项目 | 状态 |
| 工程门禁 | npm run ci —— 192 项测试 + 打包/静态/依赖/预设门禁，全绿 |
| 桌面运行时装载 | 用桌面自带运行时安装、素材路由实测通过 |
| 渲染进程内视觉 | 需在真机确认 —— 设置页与聊天区需登录后才渲染 |
| Electron 内自动化取证 | 未做（单实例锁限制，见 docs/DESKTOP-RUNTIME-EVIDENCE.md） |

文档

| 文档 | 说明 |
| 安装指南 · Install (EN) | 环境要求、自检、升级/卸载 |
| 使用说明 · Usage (EN) | 各项设置的含义 |
| 兼容审计 | 0.2.x 适配依据 |
| 桌面运行时证据 | 装载层与素材路由的实测记录 |
| Astral Atelier 实现说明 | 配色、装饰预算、素材接入与已知限制 |
| CHANGELOG | 版本变更 |

卸载

dsh plugin --profile desktop remove @dsh-external/dsh-taffy-theme

完全退出并重开应用后，界面恢复 DSH 原生外观；残留样式节点会在卸载时清理。

开发者

npm run build:ci # 生成 theme-css.ts 并构建
npm run typecheck
npm run ci # 全量门禁（含 192 项测试）
npm pack # 出发布包

改了 CSS 后必须先 build:ci 再 ci —— 静态门禁会比对 lib/client.js 与源 CSS。

重装同版本号时 plugin add 可能复用旧解析结果，务必先 remove 再 add，并用哈希核对实际安装的 lib/client.js。

素材与授权

- 源代码：MIT
- 角色图像：非官方同人 fan skin，详见 NOTICE.md

关键词

方便检索：DSH DSH Desktop DeepSeek Harness dsh-plugin dsh-theme theme dark-theme taffy 塔菲 astral-atelier 亚克力 acrylic 粉金 pink gold 桌面主题 cordis cordis-plugin customization chat-bubble composer

A Taffy character theme built for the official DSH Desktop 0.2.x: nine selectable art packages
(five night-interior backdrops, two sidebar watermarks, two chibi mascots), a glass/ornate chat look
for your own messages and the composer, and three sidebar frame levels. It repaints the theme's own
layers only — native DSH controls keep their geometry, icons and click behaviour. Install with the 先执行上面的命令，然后完全重启应用；见 docs/install.en.md。