DSH Desktop — DeepSeek Harness 桌面客户端:AI 屏保 / QQ·Telegram 机器人 / 手机 PWA 遥控(已开源)

[xiaowei2025cqu23phy]

DSH Desktop — DeepSeek Harness 桌面客户端(已开源)

给 DeepSeek Harness 做的桌面客户端(Electron + TypeScript):让 agent 真正融入日常——AI 屏保、聊天机器人、手机遥控,三端一体。

仓库: https://github.com/xiaowei2025cqu23phy/dsh-desktop
下载: GitHub Releases(Windows 安装包 / zip)

---

🖥️ AI 屏保模式

空闲后全屏展示 agent 正在做什么(实时流式输出、工具调用过程),像一块"会思考的鱼缸"。可注册为系统屏保,自动启动任务、超时护栏防失控。

🤖 QQ 机器人远程控制

• 扫码登录:设置面板扫二维码,自动获取 AppID/AppSecret,不用手填
• 审批/提问按钮:agent 要权限、要选择题答案时,主动推送带「允许/拒绝」「选项按钮」的消息,点一下即应答
• 图片理解:对话里直接发图片,agent 看图分析
• 流式输出:QQ 私聊打字机效果,实时显示 agent 回复
• 定时任务:定时 10分钟 xxx / 定时 每天9:00 写日报,重启保留
• 角色扮演:角色 你是温柔的英语老师,对话模式叠加人设
• Token 用量:用量 查看今日会话/回合/Token 统计
• 更多:目录/文件浏览、会话导出 Markdown、模型切换、任务进展/停止/打开

✈️ Telegram 机器人

同样的指令集与审批/提问应答,telegram 即时推送,无需 48h 窗口。

📱 手机 PWA 遥控(局域网)

• 扫码配对,自动填地址与令牌;添加到主屏幕即当 App 用
• 会话列表/历史/实时流式聊天/停止任务;一键新任务(描述+工作区+模型)
• 文件夹浏览与文件预览:手机上直接看电脑上的项目文件(仅限工作区/预设根,越权 403)
• 手机端也能设置:预设工作区根目录、手机壁纸、定时任务、重启服务
• 安全:Bearer token + RPC 白名单 + 文件浏览白名单,仅局域网可达

🎨 壁纸体系

主窗口 / 手机 / 屏保三端独立壁纸;导入图片一键拼豆像素滤镜(本地处理);内置鲸鱼壁纸包 + 自建壁纸包收纳。

🐳 桌面宠物

右下角小鲸鱼动画,agent 忙碌时游得更快、泡泡更多;可拖动,双击隐藏。

🔒 隐私优先

• 发布包不含任何本地配置/壁纸/访问令牌/API 密钥/会话数据
• 用户数据只在系统用户目录;仓库内置提交前隐私检查脚本
• 自定义开源许可证:衍生作品非商用(DeepSeek 官方与作者除外)

---

演示

• 主界面 + 屏保: https://raw.githubusercontent.com/xiaowei2025cqu23phy/dsh-desktop/master/assets/demo-main.gif
• 手机 PWA: https://raw.githubusercontent.com/xiaowei2025cqu23phy/dsh-desktop/master/assets/demo-remote.gif
• AI 屏保: https://raw.githubusercontent.com/xiaowei2025cqu23phy/dsh-desktop/master/assets/demo-screensaver.gif

English Summary

dsh-desktop is an open-source Electron desktop client for DeepSeek Harness: an AI screensaver that visualizes the agent's work, QQ/Telegram bot channels with inline approval/question buttons, image understanding, streaming output, scheduled tasks and role-play, plus a phone PWA remote (LAN gateway, QR pairing, session/task control, folder browsing, wallpaper & preset-root management). Three-surface wallpaper system with a beads-pixel filter, session export, token usage stats and a desktop pet. Privacy-first: release packages contain no local config, wallpapers, tokens or keys. Try it via GitHub Releases, feedback and PRs welcome!

[xiaowei2025cqu23phy]

壁纸支持自定义，自由度高：支持QQ机器人扫码登录，实现远程通信，支持手机远端操作工作区

[xiaowei2025cqu23phy]

🤖 QQ 机器人板块

• 扫码登录:设置面板一键扫码,AppID/AppSecret 自动获取,无需手填
• 审批/提问零打字:agent 请求权限 → 主动推送「✅ 允许 / ❌ 拒绝」内联按钮;选择题 → 选项按钮,点一下即应答
• 图片理解:对话中直接发图,agent 看图分析(自动转 base64,≤10MB)
• 打字机流式输出:QQ 私聊实时逐字显示回复
• 定时任务:定时 10分钟 检查更新、定时 每天9:00 写日报,重启保留,多端通用
• 角色扮演:角色 你是温柔的英语老师 叠加人设,角色 无 清除,桌面端可预设默认角色
• Token 用量:用量 一查今日会话/回合/Token(流式 usage 事件实时累计)

[xiaowei2025cqu23phy]

✈️ Telegram 板块

• 同一套指令集与审批/提问应答,即时推送(无 48h 窗口限制)
• 主动汇报:任务完成/失败自动推送,失败带错误信息
• TRANSPORT 等瞬时错误自动重试一次,降低偶发失败率

[xiaowei2025cqu23phy]

📱 手机 PWA 板块

• 扫码配对自动填地址/令牌,添加到主屏幕即当 App 用
• 会话/任务/模型全遥控:实时流式聊天、插入对话(steer)、停止任务
• 文件夹浏览与文件预览:手机上直接看电脑项目文件(仅限工作区/预设根,越权 403)
• 预设根双形态:既是「根」(新建文件夹工作区),也可直接作为工作区使用(新建会话/任务落在根目录)
• 手机端也能设置:预设工作区根管理、手机壁纸、定时任务、重启服务
• 审批/提问卡片:会话内一键应答

[xiaowei2025cqu23phy]

🖥️ AI 屏保板块

• 空闲全屏展示 agent 实时工作(流式输出 + 工具调用可视化)
• 可注册为系统屏保;自动启动任务 + 超时护栏防失控
• 三端独立壁纸中的「屏保端」也可单独配置

[xiaowei2025cqu23phy]

🎨 壁纸板块

• 主窗口 / 手机 / 屏保三端独立壁纸,互不干扰
• 拼豆像素滤镜(本地处理,不碰版权)+ 裁剪布设编辑器
• 壁纸包一键应用,内置鲸鱼系列,换过的壁纸随时换回

[xiaowei2025cqu23phy]

🐳 桌面宠物板块

• 右下角小鲸鱼:agent 忙碌时游得更快、泡泡更多
• 可拖动、双击隐藏,状态记忆(重启不丢)

[xiaowei2025cqu23phy]

🔒 隐私与安全板块

• 发布包零本地数据:不含配置/壁纸/令牌/密钥/会话
• 网关三层防线:Bearer token + RPC 白名单 + 文件浏览/会话 cwd 白名单
• 仓库内置提交前隐私检查脚本(防个人壁纸/敏感文件入库)

[xiaowei2025cqu23phy]

🛠️ 工程与质量板块

• Electron + TypeScript 全栈,严格类型检查
• 命令解析 / 审批流 / 网关 HTTP 三层自动化测试 + 真实端到端验证
• 定期隐私扫描、发布资产自动校验

有任何想试的板块或建议,欢迎留言!也欢迎 Star ⭐ https://github.com/xiaowei2025cqu23phy/dsh-desktop