MarecGents/marec-dsh-desktop

README 摘要

mg-dsh-desktop DeepSeek Harness（ dsh ）的 Windows 桌面化插件：以原生 WebView2 窗口运行 dsh Web UI，提供托盘、主题同步、窗口记忆、右侧栏与系统通知。 功能特性 - 原生桌面化 ：用系统 WebView2 打开 dsh Web UI，无浏览器标签页干扰。 - 品牌化 Splash ：主题色 + dsh logo + spinner 覆盖从窗口打开到 SPA 首绘的加载过程，无白/黑闪块。 - 系统托盘 ： - 显示主界面 / 隐藏主界面（按窗口状态动态切换） - 打开工作区（自动激活并前置 Explorer） - 新建任务（走官方 ctx.workspaces.startSession 流程，UI 即时刷新） - 退出（写 quit.marker 后干净退出，避免误判崩溃重启） - 窗口状态记忆 ：最大化状态、分辨率、主题等持久化到 $DSH HOME/mg-dsh-desktop/config.json 。 - 主题同步 ：MutationObserver 事件驱动，标题栏深浅色实时跟随 dsh 页面主题（koffi FFI 直调 Dwm API， 1ms）。 - 设置卡片 ：dsh 设置 → 插件页提供桌面壳配置（窗口尺寸 / 主题 / 托盘行为 / 会话完成通知）。 - 右侧栏 ：概览（Token 统计）、文件树、Git 变更三页；收起后保留窄栏快捷按钮。 - 会话完成通知 ：顶层任务完成后弹 Windows 原生通知，点击恢复窗口；支持设置开关、30s 冷却。 - 启动门控 ：仅当通过本项目启动时注入桌面壳与插件页面；普通 dsh web 完全不受影响。 安装与使用 方式一：自动安装（推荐） 安装脚本会自动检测 dsh / pnpm （缺失则一并安装），并在 Windows 创建桌面快捷方式「DeepSeek Harness」。 启动： 方式二：手动 / 从源码安装 开发模式启动： 依赖 dsh 的 Web 端（ dsh web ）已可用。本项目作为 dsh 插件通过 cordis.patch.yml 挂载，不修改 dsh 源码。 验证门控 普通 CLI 启动不会加载桌面壳：无窗口、无托盘、无插件注入。 技术架构 双 half 模型 - host half （dsh 进程内，Node）： src/index.ts + src/desktop.ts + src/services/ 。 - client half （浏览器内）： src/client/ ，由 dsh 的 client-modules 自动编入 DSH BOOT 。 通信通道 通道 用途 HTTP 路由 配置读写： /api/mg-dsh-desktop/config 、 /api/mg-dsh-desktop/workspa…

分类