DeepSeek Harness (DSH) 提供了本地化的智能体开发环境，但原生界面风格较为统一。为了在不修改核心逻辑的前提下提升视觉体验，社区出现了各类主题皮肤。6HOLLIS 的 DSH Hiyuki Frost Sakura 是一款面向 DSH Web 的同人主题皮肤，通过引入“常态与战斗态”双背景机制，为日常对话与 Agent 工具调用提供不同的视觉反馈。
插件定位¶
这是一个非官方同人项目，旨在为 DSH Web 提供一套“常态与战斗态”双背景的视觉方案。它不改变 DSH 原有布局，不代理会话操作，不读取正文或发送遥测。素材版权独立于代码。
核心功能¶
该插件主要包含以下能力：
-
双背景与形态切换
- 常态：普通对话、思考、欢迎页保持第一背景（白樱常态刀）。
- 战斗态：Agent 首次调用工具时自动切换为第二背景（长太刀冰讯状态），播放约 0.9 秒的“冰雾掠境”动画。
- 恢复常态：任务结束、停止或失败后恢复常态，播放约 1.15 秒的“斜风疏樱”动画。
- 支持自动切换、永久常态、永久战斗态三种模式。
-
视觉强度调节
提供轻柔、标准、沉浸三档预设。预设不会降低代码块、菜单和弹窗的可读性。 -
输入框透明度
底部输入框透明度可独立调节，范围 0%-90%。默认为 0%（完全不透明），即使拉满 90% 仍保留背景模糊、边框和阴影以保证文字可读性。 -
主题与对比度适配
- 适配 DSH 明暗主题，代码块、菜单、弹窗和输入区域保持高可读表面。
- 战斗态单独提高 Agent 正文、Think 与工具调用记录的对比度。
-
性能与兼容性
- 背景图本地加载，失败时退回 CSS 渐变，不影响 DSH 启动。
- 支持系统“降低动态效果”偏好，也可在插件设置中关闭动态。
- 仅改变视觉，不包裹或替换
dsh-session-manage的会话管理功能。
安装与启用¶
环境要求¶
- DeepSeek Harness Web：0.1.0-rc.6 至 0.1.1-rc.2
- Node.js：22
- 包管理器：pnpm 11
安装步骤¶
在仓库根目录打开 PowerShell，执行安装脚本：
pwsh -File .\scripts\install-local.ps1
安装脚本会运行类型检查、构建和素材校验，将皮肤 bundle 插在 @deepseek-ai/dsh-web-app 后面，并刷新 pnpm 依赖。
配置入口¶
安装完成后，进入 DSH → 设置 → 通用设置 → 绯雪主题。所有设置即时生效并自动保存。
使用说明¶
视觉强度与透明度¶
在“绯雪主题”设置面板中：
* 视觉强度：根据使用场景选择轻柔（适合阅读）、标准（默认）或沉浸（氛围感强）。
* 底部输入框透明度：拖动滑杆调节。默认为 0%，向右拖动增加透明度。该数值独立保存，不受形态切换影响。
形态切换策略¶
- 自动模式（默认）：欢迎页、设置、归档及普通对话保持常态。只有当前可见会话中的 Agent 首次调用工具时才切换为战斗态。
- 动态效果：可单独关闭动态效果（形态仍可切换，仅保留淡入淡出）。
- 手动模式：关闭“自动形态切换”后，可选择永久锁定常态或战斗态。
注意事项¶
- 版本兼容性：仅支持 DSH 0.1.0-rc.6 至 0.1.1-rc.2。更高版本可能调整客户端模块加载器或设置插槽。
- 素材授权：代码采用 MIT License，但同人素材非 MIT 授权，不得用于商业用途。
- 隐私安全：插件不读取会话正文，不发送遥测，不代理会话操作，仅做视觉渲染。
结语¶
DSH Hiyuki Frost Sakura 为 DSH Web 提供了一套不干扰核心逻辑的视觉方案，适合希望在 Agent 开发过程中获得沉浸式视觉反馈的用户。更多细节与源码，请查阅 GitHub 仓库。
