JochenYang/dsh-app

Name: JochenYang/dsh-app
Author: JochenYang

Desktop桌面端 ⭐ 5 Clients & Launchers客户端与启动器

A community-maintained branded desktop client for DeepSeek Harness, Windows / macOS / Linux

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

DSH APP is a self-contained, no-fork desktop client for DeepSeek Harness. The shell bundles a versioned kernel in userData/kernel/ with atomic updates and auto-rollback, renders the official Web UI in a sandboxed window, and layers brand features (sidebar, minimap, model editor, themed whale background, cross-session memory, batch sub-agent swarm, usage stats, archive manager) entirely through a seven-plugin suite—no upstream changes. Requires Node 22+ and pnpm. Dev mode spawns a local checkout via tsx (~10 s); production launches the prebuilt kernel in ~2 s. Update chain ships mirror fallbacks for mainland China.

DSH APP 是 DSH（DeepSeek Harness）的自包含、零 fork 桌面客户端，外壳自带版本化内核（userData/kernel/，支持原子更新与自动回滚），在沙箱窗口渲染官方 Web UI，并通过七件套插件（侧边栏、minimap、模型高级设置、主题/鲸鱼背景、跨会话记忆、批量子代理编排、用量统计、会话归档）以 dsh 插件套件方式叠加品牌能力，不修改上游。需 Node 22+ 与 pnpm；开发模式启动较慢（10 秒级），生产模式 2 秒级就绪。官方更新链路内置镜像回退以适配大陆网络。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-app】【https://github.com/JochenYang/dsh-app】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:JochenYang/dsh-app

把 JochenYang/dsh-app 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

9.7 KB · 缓存于 2026-09-12 19:40:33 · 9.7 KB

DSH APP

DeepSeek Harness（dsh）的品牌桌面客户端，由社区开发者维护。
Windows / macOS / Linux，面向公开发布。

简体中文 · English

外壳自带一份版本化的 dsh 运行时（更新/回滚自管理），在沙箱窗口渲染官方 dsh Web UI；品牌功能以 dsh 插件套件实现，不 fork 上游。分层、内核运行时布局、更新与回滚机制、打包等架构设计见 docs/ARCHITECTURE.md。

封装客户端功能

DSH APP 是 self-contained、no-fork 的封装客户端：内核自托管（userData/kernel/，原子激活 + 回滚），功能全部以 dsh 插件套件（plugins/）叠加在上游 kernel 上，上游发布只是一个普通内核更新。当前插件能力：

功能	插件	实现位置
会话侧边栏（原生视图）：Git 页——按目录分组的变更列表、统一 diff 双行号、暂存/还原/提交、仓库文件列表、Git 图谱（点提交查看标题/正文/文件统计）。文件树页已退役：上游侧边栏原生提供工作区文件管理	`@dsh-app/plugin-sidebar`（host + client 双面）	`plugins/plugin-sidebar/src/client/git-tab.tsx`
模型高级设置页：llm-pi-ai 模型级编辑器与整表管理（推理强度、输入模态、兼容开关）；声明推理强度自动填充兼容开关（`supportsDeveloperRole` false + `maxTokensField`，仅增量、不覆盖用户显式设置）；目录外模型的伴生路由迁移；models.dev 表单预填（直连失败自动回退 gh-proxy 镜像）	`@dsh-app/plugin-client-ui`	`plugins/plugin-client-ui/src/client/models-advanced/`
品牌主题与全中文 UI：`--dsw-alias-*` 令牌覆盖	`@dsh-app/plugin-client-ui`	`plugins/plugin-client-ui/src/client.ts:58`
品牌鲸鱼背景：空闲静态帧、悬停时指针散开（指针离开即暂停渲染循环，滚动不卡顿）；主题感知对比度（亮色增强可读性、暗色低透明度水印）；悬停悬浮于输入框上方、活跃时放大并居中于会话列	`@dsh-app/plugin-client-ui`	`plugins/plugin-client-ui/src/client/whale-background.ts`
跨会话记忆：`memory_save`/`memory_recall`/`memory_forget` 工具 + 系统提示注入（预算内最新优先），全局与项目记忆按会话 cwd 路由；设置页开关；后台提炼在会话静默 60 秒后直调模型回填要点（每次调用的 token 与耗时记录在案），策展清扫按冷却窗口与文件变更检测触发（同样直调模型）	`@dsh-app/plugin-memory`	`plugins/plugin-memory/src/{tools,routes,distiller,curator}.ts`
批量子代理编排：独立子任务并行派发给可继续的子代理，自适应并发门控（失败收缩、连续成功增长）、保留会话的逐项自动重试、按子代理标识恢复；`swarm` 工具 + `/swarm` 命令	`@dsh-app/plugin-swarm`	`plugins/plugin-swarm/src/orchestrator.ts`
用量统计：余额卡（官方 deepseek providers、CNY 闲时/高峰双档计价、密钥不出主机）、每日使用热度图与趋势图；余额 5 分钟 TTL 缓存（single-flight，挂载静默刷新、点击卡片强制重查）	`@dsh-app/plugin-usage`	`plugins/plugin-usage/src/client/usage-section.tsx`
会话归档管理：按项目工作目录分组（可折叠、键盘支持）、两步删除确认；删除经 `resolveCurrentLog` 物理移除会话日志目录（迁移前格式的会话回退到按后端布局定位），归档记录保留为可见性栅栏、由面板「清理」回收	`@dsh-app/plugin-archives`	`plugins/plugin-archives/src/client/archives-section.tsx`
快速文件搜索：`fffind`/`ffgrep`/`fff-glob` 工具，每个工作区一个共享内存索引，每次搜索限定在执行会话的工作区内	`@dsh-app/plugin-fff`（host）	`plugins/plugin-fff/src/tools.ts`
MCP 服务器管理：设置页增删改查、动态挂载/卸载，服务器工具以原生 `mcp__<server>__<tool>` 注册；读取时掩码密钥值	`@dsh-app/plugin-mcp`（双面）	`plugins/plugin-mcp/src/client/mcp-section.tsx`
外部 hooks 桥：对 Claude Code / Codex 的 `hooks.json` 做设置页增删改查，挂载为生效的 hook 实例（拦截提示词、工具与轮次）	`@dsh-app/plugin-hooks`（双面）	`plugins/plugin-hooks/src/client/hooks-section.tsx`

套件接线（每次 server 启动自动完成，src/main/brand-suite.ts）：

模块解析：十个套件插件链接进 $DSH_HOME/profiles/node_modules/@dsh-app/（Windows 为 junction）；开发源是仓库 plugins/*，生产源是激活内核里的 app/node_modules/@dsh-app/*。
加载器覆盖：plugins/dsh-app.patch.yml 拷入 userData，经 dsh web --patch 注入十个套件插件条目（应用在官方 bundle 层之后，last write wins，无需改上游 profile 模板）。

两条接缝均优雅降级：内核缺少套件插件（例如回滚目标）时原样启动、无阻塞。

快速开始（开发）

需要 Node.js 22+ 与 pnpm。开发内核 = 本地的 deepseek-harness checkout。

前置（一次性）：

# 1. 本仓库旁有 deepseek-harness checkout（../deepseek-harness），
#    并且已装好依赖、构建过 web 前端：
cd ../deepseek-harness
pnpm install
pnpm run build:web

# 2. 安装外壳依赖
cd ../dsh-app
npm install

启动（注意：Windows PowerShell 不支持 VAR=1 cmd 语法）：

# PowerShell
$env:DSH_APP_DEV="1"; npm start

:: cmd
set DSH_APP_DEV=1 && npm start

开发模式下外壳会在本地 checkout 里 spawn pnpm dsh web（随机空闲端口），不下载、不产生内核产物。dev 启动比生产版慢很多：pnpm + tsx 即时转译全部 TypeScript 源码是主要开销；生产版直接 spawn 预编译的 lib/bin.js，秒级就绪。

指定其他 checkout

$env:DSH_APP_DEV="1"; $env:DSH_APP_DEV_RUNTIME="D:/codes/DSH-APP/deepseek-harness"; npm start

开发环境的已知差异

项目	开发模式	生产模式
内核来源	本地 checkout（`pnpm dsh web`，tsx 即时编译）	`userData/kernel/` 预装运行时（直连 node 二进制）
启动速度	慢（10 秒级）	快（2 秒级）
更新检查	跳过（钉在 checkout）	每 6h 自动 + 托盘手动

内核更新系统

应用自带版本化内核（userData/kernel/），不依赖系统是否安装过 dsh。更新链路：解析 npm registry 的 dist-tag 版本 → 从 GitHub Releases 下载运行时产物 → 与附带的 sha512 比对校验 → 原子激活（旧版保留为 previous）→ 连续启动失败 2 次自动回退上一版。内核运行时布局与更新流程详见 ARCHITECTURE.md §4–5。

内置运行时漂移检测：升级安装时，如果新版本内置的运行时内容与磁盘上同名内核目录不一致（例如套件新增了插件），启动时会自动检测（sha512 对比 + 版本守卫）并重新激活内置运行时——不会静默沿用旧内容导致插件缺失；在线更新过更新的内核也不会被降级覆盖。

应用（外壳）更新

Windows 使用自定义链路；macOS / Linux 使用 electron-updater。

检测：github.com/<owner>/<repo>/releases/latest/download/latest.yml（镜像回退）
下载：按架构选择安装包，官方直链优先、ghfast.top / gh-proxy.com 依次回退
校验：sha512 与 latest.yml 比对，镜像永远替换不了内容
安装：可视化安装向导——点击「立即安装」后关闭应用、打开与首次安装相同的 NSIS 向导（安装进度全程可见），完成后自动启动应用，安装包自动删除（取消安装也会删除）

中国大陆网络适配（不挂梯子也能更新）

两条更新链路都有回退链，默认开箱即用：

链路	官方源	回退	覆盖方式
版本解析	`registry.npmjs.org`	`registry.npmmirror.com`	`DSH_APP_NPM_REGISTRIES`（逗号分隔）或 `NPM_CONFIG_REGISTRY`
产物下载	`github.com` Release	`ghfast.top`、`gh-proxy.com`（依次尝试）	`DSH_APP_GITHUB_MIRRORS`（逗号分隔前缀；置空 = 关闭镜像）

安全模型：sha512 元数据优先从官方 GitHub 获取，镜像只在大文件下载阶段参与，且每个下载候选（官方 + 每个镜像）都用同一份可信 sha512 校验——镜像被劫持也换不掉内容。

连通性自检（在目标网络环境跑一遍）：

node scripts/probe-mirror.mjs

桌面化适配

外壳通过运行时注入为 Web UI 补桌面体验，harness 源码零改动：窗口拖拽、原生窗口按钮让位、顶栏配色实时同步、全中文 UI。品牌功能（侧边栏、模型页等）通过上面的插件套件以 --patch 覆盖与 slot 注入实现，同等零上游改动。注入实现细节见 ARCHITECTURE.md §2。

构建分发

npm run dist:win     # NSIS 安装器（x64 + arm64）
npm run dist:mac     # dmg + zip（x64 + arm64，公证走环境变量）
npm run dist:linux   # AppImage + deb（x64 + arm64）

应用图标：resources/icon.png 当前为占位品牌图标，发布前请替换为正式图标； npm run icon:gen 生成占位图标，npm run icon:build 由它裁剪多尺寸 PNG + ICO（需 Pillow）。

内核运行时产物由 scripts/build-runtime.mjs 构建（每个 platform/arch 一份）， CI 工作流发布到 GitHub Releases：

node scripts/build-runtime.mjs win32 x64 0.1.0-rc.8

渲染基于仓库 JochenYang/dsh-app 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令