桌面鲸鱼娘 kyorakuyk/dsh-wallpaper

English · 简体中文

在桌面上和鲸鱼娘交互吧！

DSH Wallpaper

快速开始

报告问题

提出建议

「开机就在 不抢焦点 一句话开始 要干活就把窗口拉到面前」

目录

- 简介
- 功能特性
- 效果展示
- 安装
- 使用
- 技术架构
- 项目结构
- 注意事项
- To Do List
- License
- 关于这个项目
- 致谢

简介

▲ 待机界面：右侧立绘 + 输入岛。

▲ 聊天入口长在桌面上：一块壁纸、一个悬浮球、一座输入岛。

AI 的摩擦往往不在「用起来难」，而在入口不在手边：先打开浏览器或桌面端、找回上次的会话，用完关掉，它又消失了。

这个项目把入口搬到桌面上——开机就在、不抢焦点、一眼能看到状态、一句话就能发起。需要认真干活时，把它拉到面前：已经开着就唤到前台，没开就启动它，网页型的用浏览器打开。复杂的事仍旧在它自己的窗口里做。

独立 Tauri 桌面应用，不修改 DSH 官方 Web UI；同时保留浏览器预览模式。

✨ 功能特性

桌面入口

| | 功能 | 说明 |
| 🐋 | 待机立绘 | 桌面右侧的鲸鱼娘，随模型分层在幼年 / 成年之间切换；点一下开始对话 |
| 💬 | 输入岛 | 会话窗本体：状态灯、模型选择、用量与费用、历史轨道；两种布局可选（中央玻璃悬浮 / 任务栏停靠胶囊） |
| ⚫ | 悬浮球 | 圆形无边框小窗，内嵌「消息」图标；鼠标靠近滑出，点一下进里桌面 |
| 🖥️ | 里桌面 | 点悬浮球进入的一层桌面工作区，输入岛就位，右上角 X 退出 |
| 📌 | 任务栏胶囊 | 折叠态的另一种形态，贴着任务栏展开 |
| 📎 | 托盘菜单 | 换后端、开设置、换背景、退出 |

会话与后端

| | 功能 | 说明 |
| 🌐 | DeepSeek 网页 DOM 桥接 | 应用内独立 WebView2 打开 chat.deepseek.com，用 DOM 适配器收发；登录态独立保存，不读取也不复制 Cookie |
| 🔑 | DeepSeek API | 官方 API 流式对话；Key 只写进 Windows 凭据管理器，界面能看到的只有脱敏形态 |
| 🔗 | DeepSeek Harness | 接兼容的 Wallpaper Bridge，与 DSH 会话同一份上下文 |
| 🔀 | 聊天模式开关 | 设置中心一键切换网页 / API，正在运行的壁纸立即生效 |
| 🚦 | 状态灯 | 绿色=已连接，黄色呼吸=正在连 / 断线重连中，熄灭=确认不在了（连续两次确认才判死） |
| 🧾 | 历史与费用 | 本地 API 会话记录可查看 / 删除 / 清空；配置价格后估算本轮与会话费用 |
| 🗂️ | 会话策略 | 固定或恢复上一次的 DeepSeek 会话；切后端时把上一个后端的转写留在轨道里并标注来历 |

形态与外观

| | 功能 | 说明 |
| 🎨 | 四个内置形态 | 蓝 / 黑 × 幼 / 成年；成年态立绘整体放大 1.15，两档站在一起头一样大 |
| 🧠 | 形态跟随模型 | 模型分层（Flash / Pro）与形态、主题色、气泡共用同一个生命周期，重启后按上次的选择立绘 |
| 🌊 | 深海背景 | 三款室内场景 + 主题渐变，可按屏幕分别指定 |
| 🖼️ | 素材库 | 导入图片 → 指定用途（桌面背景 / 四个立绘槽位），不写代码换装 |
| ✨ | 唤醒动画 | 四帧：熟睡 → 睁眼 → 打哈欠 → 醒来（variant-anima，3840×2400）；解锁后从熟睡那一帧开始播 |
| 🪟 | 多屏 | 逐屏背景与苏醒帧、立绘与会话窗的目标屏幕选择 |

设置与系统集成

| | 功能 | 说明 |
| ⚙️ | 设置中心 | 六个页签：常规 / 连接 / 外观 / 形态 / 历史 / 系统；改动即时保存，切后端与端点立即生效 |
| 🌐 | 界面语言 | 简体中文 / English，在「常规 → 语言」切换并保存（默认中文，升级不会替你换语言）；原生返回的少数消息仍是中文，属计划内的第二批 |
| 🚀 | 开机自启 | 写 HKCU\...\Run，指向固定安装路径；不依赖包身份 |
| 🔌 | 桥的自动对齐 | 启动与选中主体时把桥对齐到钉住的版本；版本相符就什么都不做；"版本豁免"提示只转达，不代你确认 |
| 🧩 | DSH Wallpaper Lite | 独立前端入口与 Rust feature：静态壁纸 + 四帧苏醒 + 开机自启；不含聊天与桌面交互 |

🖼️ 效果展示

▲ 点悬浮球 → 进入里桌面 → 输入岛就位。

▲ 设置中心切换聊天模式，正在运行的壁纸立刻换后端。

▲ 四形态立绘

▲ 设置中心六个页签：常规 / 连接 / 外观 / 形态 / 历史 / 系统。

📦 安装

前置条件

- Windows 10 / 11 x64（依赖 WorkerW 桌面宿主与 Win32 交互）（注：作者本人尚未在win10跑过，若有bug请报告）
- 安装：到 Releases 下载 dsh-wallpaper_<版本>_x64-setup.exe，双击即可 —— 当前用户安装、不请求管理员、不需要证书。安装器未签名，第一次运行会有一次 SmartScreen 提示（更多信息 → 仍要运行）
- Harness 模式（可选）：DeepSeek Harness 本体 + 兼容的 Wallpaper Bridge

从源码跑（推荐先这样试）

pnpm install
pnpm dev # 浏览器预览 http://127.0.0.1:5187
pnpm desktop:dev # 桌面应用：壁纸可独立启动；Harness 模式需要兼容的 Bridge

打包（NSIS 安装器）

pnpm desktop:build # 产物在 wallpaper/src-tauri/target/release/bundle/nsis/
pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\publish-local-nsis.ps1 -Install
发布脚本按顺序做：类型检查 → 前端与 Bridge 测试 → Rust 测试 → 构建 → 报出 SHA-256 → （-Install 时）静默安装并核对装上的版本。常用开关：-PlanOnly 只显示计划；-SkipChecks 跳过门禁；-NoLaunch 装完不启动；-Edition lite 出 Lite 包。

打包（MSIX，可选）

MSIX 那条路保留给将来的商店上架：它需要一张与本机 Publisher 匹配的签名证书（自签即可），命令是 pwsh -File .\scripts\publish-local-msix.ps1。
产品本身已经不需要它 —— 锁屏接管曾是唯一需要包身份的功能，而那块已整体退出，所以日常分发走上面的 setup.exe。

🚀 使用

1. 启动后等唤醒动画播完，进入待机：桌面右侧是立绘，下方弹出悬浮球（仅任务栏停靠胶囊模式）
2. 网页端第一次对话需要登录，API和harness端第一次需要进入设置-连接里面配置。
3. 点击悬浮球或者双击桌面空白处进入里桌面，开始对话，API模式输入岛里可以选模型。
4. 在「设置中心 → 连接 → 聊天模式」里选 网页入口 或 API，正在运行的壁纸立刻切换；输入岛上的开关可以在 Harness 与聊天后端之间快切
5. 需要认真干活时，点桌面会话左边的小图标或托盘项把工作窗口拉到面前（已经开着就唤到前台，没开就启动它，网页型的用浏览器或者tui打开）
6. 需要防误触发送键可在设置里改成 Ctrl+Enter

🏗️ 技术架构

┌──────────────────────────────────────────────────────────────┐
│ Windows 桌面（Explorer） │ │ Progman / WorkerW ── 图标层 ── 任务栏 ── 其它应用窗口 │ └───────────────────────────┬──────────────────────────────────┘ │ 注入桌面宿主（画面在图标层之下） ┌───────────────────────────┴──────────────────────────────────┐ │ Tauri 2 应用（Rust / Win32） │ │ │ │ ┌────────────────┐ ┌────────────────┐ ┌──────────────┐ │ │ │ background │ │ floating-ball │ │ settings │ │ │ │ 宿主 WebView │ │ 圆形悬浮球 │ │ 设置窗（唯一 │ │ │ │ 画面 + 热区 │ │ 独立顶层窗口 │ │ 独立窗口） │ │ │ └───────┬────────┘ └───────┬────────┘ └──────┬───────┘ │ │ │ 交互热区发布 │ enter_inner… │ 设置同步 │ │ ┌───────┴────────────────────┴────────────────────┴───────┐ │ │ │ 原生层：窗口策略 / 热区 / 焦点交接 │ │ │ │ WorkerW 宿主 · SetWindowRgn · Z 槽 · WTS 锁屏 · 托盘 │ │ │ └───────┬────────────────────┬────────────────────┬───────┘ │ │ │ │ │ │ │ ┌───────┴───────┐ ┌────────┴────────┐ ┌───────┴───────┐ │ │ │ 网页适配器 │ │ DeepSeek API │ │ Harness 桥接 │ │ │ │ WebView2 + DOM│ │ reqwest + 凭据 │ │ REST / SSE │ │ │ └───────────────┘ └─────────────────┘ └───────┬───────┘ │ └────────────────────────────────────────────────────┼──────────┘ bridge/ 插件 │ ┌─────────────────────┴───────────┐ │ DeepSeek Harness（DSH 本体） │ └─────────────────────────────────┘

核心设计理念：

- 桌面是入口，窗口才是工作台 —— 桌面层只做三件事：发起、轻量往返、拉起工作窗口；复杂操作交回窗口本体
- 单一宿主 —— 画面与桌面交互热区共用一个 background WebView 注入 WorkerW；设置窗是全应用唯一的独立窗口
- 无静默替换 —— 只探测用户在设置里选定的那个主体（客户端或源码目录）的端口，别的客户端更能用也不会被悄悄换上
- 拉起即完成 —— 把配置的主体唤到前台；系统拒绝前台切换也算"已到达"（点一下它就行），没有可拉起的窗口才开浏览器
- 凭据边界 —— API Key 只写进当前 Windows 用户的凭据管理器，请求在原生层读取；界面只能看到脱敏形态
- 原生首帧 —— 先用随包睡眠图铺一帧；Explorer 还没给出 WorkerW 时在限定时间内重试并暂挂 Progman，宿主恢复后再把首帧层挂回去

📁 项目结构

dsh-wallpaper/
├── wallpaper/
│ ├── src/
│ │ ├── scenes/ # 状态机与场景（Sleep / Wake / Idle / Chat） │ │ ├── features/chat/ # 输入岛与会话窗（含历史轨道） │ │ ├── floating/ # 悬浮球窗口 │ │ ├── persona/ # 形态注册表与立绘比例适配 │ │ ├── appearance/ # 背景、主题与素材库 │ │ ├── connect/ # 端点扫描、主体识别、Harness 状态 │ │ ├── chat/ # 会话适配器（网页 / API / Harness） │ │ ├── settings/ # 设置持久化与设置中心 │ │ ├── native/ # Tauri invoke 绑定（runtime.ts） │ │ ├── runtime/ # 交互热区发布、显示器布局 │ │ └── ui/ widgets/ # 气泡、玻璃、图标等基础件 │ ├── public/personas/ # 立绘、背景与唤醒帧资源 │ └── src-tauri/ # Rust 壳：WorkerW 宿主 / 悬浮球 / 设置窗 / 托盘 / 锁屏 / 自启 / 聊天 ├── bridge/ # DSH 会话桥插件（loopback REST/SSE + bearer token） ├── assets/personas/ # 仍在用的立绘源图（其余已归档到 archive/personas-sources-20260930/） ├── scripts/ # 素材处理与本地发布（20 个） ├── docs/ # plans / evidence / design / guides（见 docs/README.md） └── .github/workflows/ # CI（八步门禁）+ Lite 打包

🧭 出了问题看哪里

- 应用日志：%LOCALAPPDATA%\com.dsh.wallpaper\logs\dsh-wallpaper.log（设置、桥、宿主状态都写在这里）
- 启动首帧诊断：同目录的 startup-diagnostic.log。首帧挂到 WorkerW 失败、或桌面宿主（Explorer）重启时，这里逐行记录原生事件（如 event=reattach parent=WorkerW），是排查"壁纸没出来 / 黑屏 / 首帧卡住"的第一现场
- 桥的令牌：$DSH_HOME\wallpaper\bridge-token（由桥创建，权限收紧到"只有你"；读不到时设置里会说清原因）

⚠️ 注意事项

1. 只在 Windows 上跑 —— 依赖 WorkerW 桌面宿主、Win32 窗口策略与 WTS 锁屏事件，没有跨平台计划。
2. 壁纸在图标层之下 —— 最大化窗口会盖住立绘与悬浮球，这是设计而不是 bug：桌面被盖住时，入口交给任务栏胶囊与托盘。
3. Harness 模式需要前置 —— 要先有兼容的 Wallpaper Bridge（第一次跑默认会自动装，如果失败按 bridge/README.md 装进 DSH profile），并从 /api/wallpaper/v1/status 的 bridgeVersion 确认生效。
4. 网页入口靠 DOM 适配器 —— 官方页面改版可能让它失效；适配器支持本地 override 配置修正，配置里不允许 JavaScript、Cookie 或任意域名。本应用不读取也不复制 Cookie。
5. 拉起窗口时可能被系统拒绝前台切换 —— 那也算"已经到达"，点一下那个窗口即可；壁纸不会为了拉起而抢焦点。
7. 费用与账号 —— API 模式按官方计费；网页模式使用你自己的登录态；两种情况都需要你自备账号或 Key。

📝 To Do List

- [x] 桌面宿主 + 启动首帧（WorkerW 注入、Progman 暂挂与重挂）
- [x] 叙事状态机与唤醒动画（睡眠 → 四帧苏醒 → 待机 → 会话）
- [x] 输入岛（状态灯、模型选择、用量与费用、历史轨道）
- [x] 悬浮球与里桌面（圆形区域、Z 槽、点 X 退出）
- [x] 任务栏胶囊布局
- [x] 三个聊天后端（网页入口 / DeepSeek API / Harness）+ 聊天模式开关
- [x] 无静默替换（端点作用域只认配置的主体）
- [x] 拉起工作窗口（唤前台 / 启动 / 浏览器兜底；拒绝也算到达）
- [x] 形态与模型共用生命周期（含成年态 1.15 比例适配）
- [x] 外观素材库（导入 → 指定用途）
- [x] 设置中心六页（常规 / 连接 / 外观 / 形态 / 历史 / 系统）
- [x] API Key 在设置中心内输入与测试（含模型目录缓存）
- [x] 开机自启（Run 键，不依赖包身份）
- [x] CI 八步门禁（类型检查 / JS 测试 / Rust 测试 / 前端构建 / Lite 构建与测试 / Lite 产物边界）
- [x] 桥的自动对齐（启动与选中主体时各一次；版本相符不动档案，已在两台机器实测）
- [x] 多屏真机验收
- [ ] 自定义形态扫描（用户目录 manifest）
- [ ] 主题包与插件
- [x] 完整版公开分发渠道（v0.3.0 / v0.3.1 的 setup.exe 在 Releases）
- [x] 演示视频与截图（见「效果展示」：三条录屏 + 两张界面图 + 四立绘）

📄 License
代码以 MIT 授权（见 LICENSE）。这个项目涉及网页桥接与凭证管理，所以安全上不靠许可、靠别的：安装包签名与官方发布渠道、桥的控制面只暴露壁纸真正需要的能力、以及宿主回报的桥构建可核对（见 bridge/README.md 的信任模型）。

美术素材不与代码同许可：立绘原型来自 ZipZipPipe（鲸鱼娘形象另致谢上善无形），本项目的立绘是在其基础上的衍生，因此沿用 CC BY-NC-SA 4.0（署名 + 非商业 + 相同方式共享），不适用 MIT。详见 LICENSE-ASSETS.md。

📢 关于这个项目

这是一个第三方项目，基于 DeepSeek Harness 生态做桌面侧开发，与 DeepSeek 官方没有隶属关系。

它不修改 DSH 官方 Web UI，也不接管官方或第三方客户端的窗口内容 —— 拉起只是把窗口带到你面前。

使用 DeepSeek API 或网页入口时，账号、Key 与由此产生的费用都由你自己承担。

💝 致谢

站在这些项目的肩膀上：

- DeepSeek Harness —— 这个壁纸要接入的生态本体（Bridge 协议与会话接口）
- Tauri + tauri-plugin-single-instance —— 应用壳与单实例
- keyring —— Windows 凭据管理器读写
- windows-rs —— Win32 窗口策略、Z 槽与 WTS 事件
- ZipZipPipe和上善无形大佬的鲸鱼娘形象

Made by kyorakuyk with love ❤