keke-shy/dsh-desktop

README 摘要

dsh-desktop 基于官方 DeepSeek Harness 构建的 最小 Electron 桌面壳 ：在 Electron 主进程内启动官方 web profile，把浏览器界面装进一个沙箱化的原生窗口，并提供托盘、单实例、有序退出、驻留开关与安装包构建。 它不是 Harness 的替代品，也不 fork 上游源码。智能体、模型、工具、会话和 Web UI 全部来自官方 @deepseek-ai/dsh- 包；本仓库只负责「窗口 + 托盘 + 进程生命周期 + 一个极窄的启动适配面」。 设计原则 1. 极窄兼容面 ：整个仓库只有 src/boot.ts 一个文件 import 官方包。上游破坏性变更首先、也只在该文件里体现。 2. 精确锁版本 ：上游各包独立发布且 latest dist-tag 陈旧，因此所有 @deepseek-ai/ 依赖都 精确 pin 到 0.1.0-rc.6 ，不写 ^ 。升级 = 显式改版本 + 重跑 check 。 3. 轻量 ：不内置插件市场/自动更新器；v1 只有窗口、托盘、单实例、loopback-only、安全导航锁与打包。 4. 安全优先 ：渲染进程 sandbox + contextIsolation 、无 Node 集成、无 preload/IPC 桥、导航锁同源、外链白名单协议、webserver 强制 127.0.0.1:0 。 架构 详见 docs/architecture.md 与 docs/compatibility.md。 快速开始 首次运行会在 /.dsh/profiles/web/ 初始化官方 web profile（与 dsh --profile web 一致）。 实际对话需要 DEEPSEEK API KEY （可放在 /.dsh/.env ，与官方一致）。 模型选择、命令菜单、Agent 预设都来自 @deepseek-ai/dsh 包自带的 config/agent-presets ，已随依赖自动安装。 驻留开关 关闭窗口时的行为由环境变量控制，默认 关闭即退出 （最不容易误解）： 值 行为 未设置 / 0 / false 关闭窗口 = 退出应用 1 / true / yes / on 关闭窗口 = 隐藏到托盘（驻留） 打包 打包依赖 electron-builder （已列入 devDependencies）。打包前需要 完整的 npm install （不要 --ignore-scripts ，Electron 二进制与原生模块需要脚本完成）。 - 图标 ：Windows 安装包/EXE 使用 build/app-icon.png （官方蓝鲸图标，256×256）。它由 build/app-icon.ico 经 npm run gen:icon 放大生成——原始 .ico 最大…

分类