幻海 Dee / DeeMate

_{示意图，非运行截图（画面由脚本逐帧绘制）}

一只梦幻粉色的小鱼桌宠，作为 DeepSeek Harness Web UI 的虚拟形象入口：同时显示并管理多个正在进行的对话，把「谁在忙、谁在等你」变成一眼能看懂的状态，把该你拍板的事递到眼前。

English version: README.en.md

功能

通知与提示

• 多会话同屏：同时显示并管理多个正在进行的对话——谁在跑、谁在等你、各自最近发生了什么，一个面板里就能分清。
• 状态一眼看懂：思考时游得快、等待时放慢摆动、完成时小跳、出错时下沉变灰。
• 任务变泡泡：跨会话的动态带会话名，点一下直接跳过去，不打断当前对话。
• 需要你时响一声：只有「等你拍板」才响，可单独静音；先有一次点击/按键后浏览器才允许出声。

拍板与操作

• 就地拍板：审批 / 提问直接在面板里点「允许一次 / 拒绝」，不用切回会话；跨会话的审批也能拍。
• 气泡直接报批：面板没开时，审批会变成鱼旁边一颗能点的气泡，就地解决；不想要可以关掉。
• 本轮全允许：临时按需提权——忙时一键切到完全访问，这一轮不再逐条问；本轮完成后自动恢复原先权限（刷新也不丢）。
• 面板递话：不离开界面就能给当前会话发一句话，或停下正在跑的任务。

形象与调整

• 浮在右下角：可拖动、位置持久化；键盘聚焦后也能用方向键微调。
• 随时隐藏：收成角落里一颗 24px 的小泡泡，点一下或按 H 回来；隐藏期间不订阅事件流，真正安静。
• 大小可调：50%–135%，默认 100%，滑杆 + − / + 微调，选择会记住。
• 配色可切：默认「梦幻粉」原画，可换「深海蓝」；造型和动画完全不变。
• 一键反馈：设置里点「反馈问题」直达 GitHub Issues，系统、宿主与插件版本自动填好，你只写问题本身。
• 主题跟随：中英文文案与深浅色配色都跟随 DSH，图标为原创 SVG。

安装

发布形态是独立的 Cordis bundle 包 dsh-dee-mate，用 DSH 自带的命令行安装。

前置：dsh 命令

桌面版自带这个命令，但默认不在 PATH 里：<安装目录>\resources\runtime\cli\bin\dsh.cmd。把 bin 目录加进 PATH 后就能直接敲 dsh；不想改 PATH 就用完整路径（把 <安装目录> 换成实际路径，例如 C:\Program Files\DeepSeek Harness）：

& "<安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-dee-mate

安装（dsh plugin）

dsh plugin 把参数原样转给该 profile 目录里的 pnpm，安装成功后自动把声明了 dsh.bundle 的新依赖加进 profile 的 bundles，不用再手动改配置。

# 桌面版：先完全退出 DSH（desktop 是保留 profile），装完再打开
dsh plugin --profile desktop add dsh-dee-mate        # 包名方式需要已发布到 npm

# dsh web 启动的界面
dsh plugin --profile web add dsh-dee-mate

# 本地 tarball / 源码目录：把包名换成路径
dsh plugin --profile desktop add <path>\dsh-dee-mate-1.0.0.tgz
dsh plugin --profile desktop add <path>\dsh-dee-mate

• --profile 必须和界面对应：桌面版是 desktop，dsh web 是 web，自定义 profile 用它自己的名字。装错 profile，界面里不会出现。
• desktop 只接受桌面版自带的 dsh；npm 全局装的 dsh 会报 profile "desktop" is managed exclusively by the Electron application。
• 漏写 --profile 会报 required option '--profile <name>' not specified —— 这是 DSH 的约定，不是插件的问题。
• 源码目录是链接安装：改完源码执行 node build.mjs，刷新页面就能看到新版本，不必重装。

装完刷新 Web UI 就会出现；桌面版如果没变化，完全退出再打开。没有安装脚本、没有运行时依赖。

快速上手

操作	效果
点击鱼 / Enter / Space	打开面板
拖动鱼	移动位置（会记住）
H	隐藏 / 叫回
M	拍板提醒音静音 / 恢复
B	气泡报批开关
齿轮按钮	调整大小、切换配色

完整说明（快捷键、审批语义、隐私、排错、卸载）见 USAGE.md。

许可

代码以 MIT 协议开源，© 2026 EnzoX。

形象与品牌不包含在 MIT 授权内：「幻海 Dee」的角色形象、插画、图标（icon.svg、assets/*、src/ui/icons.js、src/pet-whale.js，以及由 src/pet-art.js 呈现的造型）、视觉识别与产品观感，版权归作者所有（All rights reserved）。未经许可不得复制、修改、重绘或商用；「DeeMate / 幻海 Dee」的名称与商标权也不随代码授予。商用、二创或品牌授权请联系作者（GitHub @EnzoX）。完整条款见 LICENSE。