前言¶
DeepSeek Harness (DSH) 采用插件化架构。在调试或临时对话场景下，开发者通常需要一个轻量级的交互入口，既能快速调用大模型，又不干扰主会话的历史记录。dsh-temp-chat 正是为了解决这个问题而设计，它在 DSH 页面中放置了一个漂浮的“精灵”（鲸鱼图标）和一个可拖拽的临时聊天窗口。
核心功能¶
- 漂流的精灵：精灵在锚点附近缓慢漂流（包含正弦漂移和上下浮动动画），支持拖拽，位置在重启后持久保存。
- 即时聊天：点击精灵打开窗口，可拖拽标题栏移动，按
—键可最小化回精灵状态。 - 零配置：默认情况下，插件自动跟随会话的默认模型，无需手动输入 API Key。
- 自定义端点：支持开启独立配置，接入 DeepSeek、OpenAI、Moonshot、GLM、Qwen 或任意 OpenAI 兼容的自定义 Base URL。
- 真实流式输出：主机路由模式下支持约 55ms 的轮询流式输出；自定义端点模式下使用原生 SSE。
- 辅助功能：支持单条消息复制、一键清空、模型徽章显示、深色/浅色主题切换、空状态提示以及防止精灵被拖出屏幕的拖拽限制。
- 语言跟随：界面语言会根据 DSH 的语言设置自动在中文和英文之间切换。
安装与启用¶
使用 npm 包安装：
dsh plugin --profile desktop add dsh-temp-chat
安装后重启 DSH，页面右下角会出现鲸鱼精灵。从源码安装需要 Node.js 环境。
典型用法¶
- 移动精灵：直接拖拽鲸鱼图标将其停靠在页面任意位置，位置会被保存。
- 打开/最小化：点击（未拖拽时）打开聊天窗口；在窗口中按
—键可最小化回精灵。 - 发送消息：在输入框按
Enter发送，按Shift+Enter换行。 - 复制内容：将鼠标悬停在消息上，点击消息右侧的
📋图标复制。 - 配置模型：点击聊天窗口顶部的
⚙图标，可切换是否跟随会话默认模型，或配置自定义端点的 Provider、API 地址和 Key。
适用场景与注意¶
- 环境要求：需要运行在 DSH 的
web或desktop配置文件下，且构建环境需安装 Node.js ^22.19.0 或 >=24.0.0。 - 安全性：默认路由复用 Harness 的提供方，不发送额外凭证；自定义模式的 API Key 仅存储在浏览器
localStorage中，不上传至服务器。 - 数据存储：聊天记录仅保存在内存中，不会写入 DSH 会话历史，插件停止运行或清空后数据即丢失。
- 卸载方式：需从 profile 的
dependencies和dsh.profile.bundles中移除，并清理已安装的链接。
总结¶
dsh-temp-chat 提供了一个轻量级、零配置的临时对话入口。它通过漂浮精灵和临时窗口的形式，既保持了界面的整洁，又提供了灵活的模型切换能力，适合需要在 DSH 页面中快速进行临时交互或测试的场景。
- 插件目录：dsh-temp-chat (winditer)
- 项目源码：winditer/dsh-elf
