@Shmilyoldsh-hiyori-web-ui
为 DeepSeek Harness 提供桃濑日和的动态插件
- Stars
- 2
- Language
- JavaScript
- Created
- Aug 14, 2026
- Updated
- Aug 20, 2026
Introduction
不只是换一张背景
dsh-hiyori-web-ui 是一个 DSH Web 常驻插件。它把暖色半透明面板、细腻柔和的视觉细节与低干扰樱花带进工作区，并让 Live2D 原创角色桃濑日和常驻右下角：看向鼠标、回应任务状态，也在漫长等待中陪你说句话。
默认台词完全在本地运行，不配置 API Key 也能获得完整的角色互动；需要更丰富的表达时，再按需启用 DeepSeek 生成台词。
产品体验
她会看向你的鼠标
桃濑日和的眼睛和头部会平滑跟随鼠标移动，鼠标离开后再自然恢复正视，让她真正成为界面里有回应的伙伴。
点击，她会回应
点击头部或身体会触发气泡、动作与表情；每 12～24 秒，她也会自然播放一次符合当前性格的待机动作。悬停即可隐藏，想见她时随时唤回。
一处配置，控制全部体验
在完整设置页中，可以分别控制背景与角色，切换温柔、傲娇、乖巧、元气、慵懒五种性格，也可以按需配置 DeepSeek API Key 和台词模型。
五种性格拥有各自的台词、基础表情和动作池，切换后立即生效并自动保存。AI 台词始终是可选项：不填写 API Key 时，角色继续使用内置台词，本地互动能力不受影响。
功能亮点
- 沉浸外观：暖色半透明面板、柔和字体、金色角饰与低干扰樱花覆盖亮色 / 暗色主题，背景和樱花均可独立关闭。
- Live2D 互动：角色跟随鼠标，点击头部或身体触发气泡、动作和表情，并自然播放性格专属待机动作。
- 状态感知：根据本地时间、会话切换和任务加载 / 完成 / 错误（loading / complete / error）状态回应；长任务会在 20 秒、1 分钟、2 分钟、4 分钟及之后每 2 分钟反馈进度。
- 连击反馈：连续完成 3 / 5 / 10 次以及 15 / 20 / 25 次时，会触发逐层升级的专属台词。
- 性格联动：五种性格分别拥有台词、常驻表情和动作池；8 种事件表情会与任务结果同步，播放后回到当前性格的常态。
- 隐私克制：不读取对话内容，不发送遥测；背景、角色、性格与 AI 台词分别控制。
快速开始
环境要求
- Node.js 20+
- npm
- pnpm（DSH 插件命令会调用它）
- 可正常运行的 DeepSeek Harness（DSH）
本插件是 DSH 常驻插件（Cordis bundle）。安装一次后会随 dsh web 自动加载，重启后依然保留。
如果还没有 pnpm，可用 npm 安装并确认命令可用：
npm install -g pnpm
pnpm --version
1. 获取项目并生成插件包
git clone https://github.com/Shmilyol/dsh-hiyori-web-ui.git
cd dsh-hiyori-web-ui
npm install
npm run setup:live2d
仓库已包含预构建的 Hiyori Pro / Cubism 运行资源。setup:live2d 只校验资源并生成插件包，不会下载 Live2D SDK：
lib/index.js 插件主机端：托管角色资源并提供状态接口
lib/client.js 插件浏览器端：暖色皮肤、设置和角色界面
2. 安装到 DSH Web
npx @deepseek-ai/dsh plugin --profile web add /你的存放路径/dsh-hiyori-web-ui
把路径替换为仓库的实际绝对路径。如果终端当前就在仓库目录，也可以简写为 add .。
3. 启动 DSH
npx @deepseek-ai/dsh web
打开命令输出的地址，皮肤与桃濑日和会直接出现，无需让助手运行命令或批准操作。之后重启 DSH，插件仍会自动加载。
[!NOTE] DSH 与本仓库必须位于同一台机器。插件按绝对路径读取
assets/live2d中的资源；仓库可以放在任意目录，但移动后需要重新执行npm run setup:live2d和第 2 步。
设置
点击左下角 设置 → 桃濑日和配置：
| 配置项 | 作用 |
|---|---|
| 背景颜色 | 开启暖色背景；关闭后还原 DSH 默认背景色 |
| 虚拟角色 | 显示或隐藏右下角的桃濑日和 |
| 性格 | 在温柔 / 傲娇 / 乖巧 / 元气 / 慵懒之间切换 |
| DeepSeek API Key | 可选；启用模型生成台词，Key 只保存到服务端 $DSH_HOME/.credentials.yaml |
| 模型 | 选择台词生成模型，默认 deepseek-v4-flash |
会话标题栏旁的樱花开关可单独控制飘落花瓣。
[!IMPORTANT] 插件不读取对话内容、提示词、回复文本、错误详情或文件内容，也不发送遥测。启用 AI 台词后，只会把事件类型、性格、连胜数或耗时档位等最小元数据发送给 DeepSeek；API Key 只保存在服务端
$DSH_HOME/.credentials.yaml。
升级
拉取新版本或修改插件代码后，重新生成 bundle，必要时重启 DSH：
npm install
npm run setup:live2d
卸载
如果配置过 DeepSeek API Key，请先在 设置 → 桃濑日和配置 中清空并保存。插件卸载不会自动删除 $DSH_HOME/.credentials.yaml 中独立保存的凭据。
npx @deepseek-ai/dsh plugin --profile web remove dsh-hiyori-web-ui
重启 dsh web 后，皮肤、角色及 web profile 中的插件配置会一起移除。
常见问题
setup:live2d 失败或命令不可用
确认正在使用 Node.js 20+，并在仓库目录先运行 npm install，再执行 npm run setup:live2d。
dsh plugin add 失败
确认 DSH 与 pnpm 可用。如果通过 npx @deepseek-ai/dsh 启动 DSH，安装插件时也使用同一条命令：
npx @deepseek-ai/dsh plugin --profile web add .
安装完成后重启 dsh web，新 bundle 才会加载。
只有皮肤，没有看到角色
按顺序检查：
- 设置 → 桃濑日和配置 中“虚拟角色”是否开启；
- 插件是否已加入 web profile；
- 仓库是否被移动过，若移动过请重新执行安装步骤；
- 修改代码后是否重新运行了
npm run setup:live2d。
许可与来源
本作品的角色使用 Live2D 原创角色桃濑日和（Hiyori Pro）：插画 Kani Biimu，模型 Live2D。相关条款与来源：Hiyori Pro 素材、示例模型条款、无偿提供素材协议、Core proprietary license。
本作品的角色在运用株式会社Live2D的著作物素材样本时依据了株式会社Live2D规定的协议。本作品完全根据制作者的自我裁量制作而成。
assets/live2d 中的 Cubism Core、Hiyori 模型和 Framework / Samples 构建资源适用各自的官方条款，不适用仓库其他代码的许可。不得脱离本插件单独再分发这些角色资源；再使用时必须保留角色设计细节与随附许可信息。详见 Live2D 资源与发布边界。