Evidence snapshot reviewed Sep 16, 2026GitHub checked Aug 21, 2026
Source-reviewedApplicationAutomation & AgentsDeepseek Harness Users ProfileDesktop Agent Operators Profile

DshCockpit

Desktop control plane for operating DeepSeek Harness with cost tracking, background tasks, and session tools.

At a glance

What it does

Desktop control plane for operating DeepSeek Harness with cost tracking, background tasks, and session tools.

Capabilities
Automation & AgentsAutomationSession ManagementNotifications

Before you choose it

DshCockpit is a Windows and macOS desktop app built around DeepSeek Harness. Its README describes local calculation of session-log usage and costs, budget alerts, Quick Ask via a global hotkey, scheduled tasks, full-text session search, runtime updating with rollback, and optional remote or IM-channel workflows.

Best for

People who run DeepSeek Harness regularly and want a persistent desktop layer for monitoring usage, managing long-running work, and finding prior sessions.

Common tasks

  • Track token usage, estimated costs, workspace attribution, and monthly budget alerts.
  • Submit a Quick Ask in the background and receive a completion notification.
  • Schedule recurring agent work and review its run history.
  • Search historical sessions with the Ctrl+K shortcut.
  • Download the desktop package for Windows or Apple Silicon macOS, then configure a DeepSeek API key and workspace.

Permissions and data

The app requires a DeepSeek API key at first launch and is described as reading local session logs to calculate usage and cost.

Permissions
  • DeepSeek API key for initial setup.
  • Local filesystem access to DeepSeek Harness session logs is described for usage and cost calculation.
  • Global hotkey access is described for Quick Ask.
Data handling
  • The README claims usage and cost calculations are performed locally from session logs and states that there is no telemetry.
  • The README describes optional IM channels and authenticated remote access; their exact data flows are not established in the supplied evidence.
External services
  • DeepSeek Harness and DeepSeek API.
  • Optional Feishu, WeCom, DingTalk, Tailscale, and Cloudflare connections are described.
Credentials
  • DeepSeek API key.

Limitations

  • macOS packages are stated to be unsigned and unnotarized; the README instructs users to remove quarantine manually.
  • Windows may trigger SmartScreen.
  • The project is single-maintainer; Windows is the primary development target, while macOS arm64 has less real-world coverage.
  • Intel macOS packages are stated to be paused.

What DSHub checked

  • The source snapshot is pinned to commit fa7a5d7112b8b531c193daf83764db28e2b2017e.
  • The repository includes an MIT License.
  • The README documents Windows and macOS installation paths and the listed desktop features.

What DSHub did not check

  • No release binary was downloaded, installed, or executed during this curation.
  • Runtime compatibility with a particular DeepSeek Harness version was not declared in the supplied evidence.
  • The README's feature, privacy, update, remote-access, and test-count claims were not independently exercised.

Pinned install

Primary action

This application does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project

Maintainer source

Project README

View at commit fa7a5d7
Maintainer-authored contentCaptured from README.md on Sep 16, 2026. The text and repository-relative media are fixed to commit fa7a5d7112b8 with content hash d6c146dbe1d9; provider-hosted badges may update independently. README commands are upstream documentation; use the type-correct primary action above and verify it against this pinned source.

简体中文 | English

<div align="center">

🛩️ DshCockpit

不是给 dsh 再套一个窗口——而是一个桌面控制平面。

License Platform Tests upstream Powered by PRs Welcome

DshCockpit 把 DeepSeek Harnessdsh)从一条终端命令变成常驻桌面的 Agent 服务:Harness 工作区保持 100% 原生,壳只在其外补齐安全更新、成本核算、后台任务、远程访问——全部通过稳定接口完成。内置运行时,无需安装 Node.js。

</div>

💬 交流群

欢迎扫码进群,讨论使用问题、反馈建议,或聊聊 Agent 桌面化的玩法。

<div align="center"> <img src="photo/qrcode-group.png" width="260" alt="DshCockpit 交流群二维码" /> </div>

为什么需要它?

如果你每天用 dsh 跑 Agent,有三个问题始终绕不开:

问题 实际会发生什么
更新全靠赌 上游 rc 版几天一个,手动升级可能弄坏 profile,降级等于重装。
花了多少钱是黑盒 没有用量接口、没有花费面板——等账单到了才知道一次调试狂欢的价格。
Agent 活在一个窗口里 关掉窗口(或合上盖子),长任务就死了;审批请求只能等你回来。

常见的桌面壳对这三个问题都无能为力——它们只是把同一个窗口装进托盘。DshCockpit 把 Agent 当作需要运维的服务,窗口只是它恰好可见的地方。

你能得到什么

1 · 一个不会把自己搞坏的运行时

新版本并行安装,必须先通过 --dump-config 冒烟测试才允许激活,切换是原子操作。坏版本永远激活不了;一键回滚会同时恢复上一版本数据目录快照。更新自动跟随官方 npm 通道——不 vendor、不分叉、不落后于上游。

2 · 成本与用量可观测

  • 上下文压力常驻:安静的胶囊实时显示当前会话输入/输出/缓存 token,60%/85% 预警,一键压缩
  • 成本中心:按天/周/月统计,按工作区归因,峰谷分时计价,月度预算 80%/100% 报警
  • 官方余额:实时显示总额/赠送/充值,精确到每轮对话花费与缓存节省

全部在本地从会话日志计算(纯 JS zstd 解压),零遥测。

3 · 你不盯着它也能干活

  • Quick AskCtrl+Alt+Space 随手提问,后台运行,完成通知
  • 定时任务 — 日报、周期任务、运行历史
  • IM 渠道 — 飞书 / 企微 / 钉钉:任务完成、审批请求、Agent 提问直达群聊,点按钮即可处理
  • 手机远程 — 手机浏览器完整 UI,经鉴权局域网网关配对;Tailscale / Cloudflare 出门在外也能连
  • 会话检索Ctrl+K 全文搜索全部历史;退出自动备份

还有:模型管理(6 家预设 + Ollama 本地模型)、插件与技能市场(安装前可预览)、双语界面、深浅主题。

横向对比

dsh web 一般桌面壳 DshCockpit
双击即用、内置运行时
更新门禁 + 回滚 + 数据快照
Token/上下文压力 + 预算报警
按工作区的成本分析
全局热键后台提问
定时任务
会话全文检索
鉴权手机远程 罕见
运行未魔改的官方运行时 常见 vendor/分叉 ✅ 始终

零侵入设计

壳从不给上游源码打补丁,从不碰它的内部实现。所有集成只走稳定边界:HTTP/WebSocket、文件系统(会话日志)、CLI 参数(--dump-config、端口发现)与显式 IPC。"Harness 可以变,DshCockpit 保持有用"在这里是工程性质,不是口号。详见 DESIGN.md

🚀 快速开始

Windows:从 Releases 下载 DshCockpit-<version>-win-x64.zip → 用 7-Zip/WinRAR 解压 → 双击根目录 DshCockpit.exe。约 9 秒开窗,后续版本自动更新。

macOS:下载 .dmg(Apple Silicon)→ 拖入「应用程序」→ 启动。

⚠️ 尚未签名公证——Gatekeeper 会拦截一次,终端执行一次即可永久放行:

xattr -dr com.apple.quarantine /Applications/DshCockpit.app

从源码运行(Node ≥ 22):

git clone https://github.com/Lxiayu/DshCockpit.git && cd DshCockpit
npm install && npm start

首次启动:设置 DeepSeek API Key(齿轮有红点提示)→ 选择工作区 → 开始对话。其余一切都是可选的。

📸 界面预览

<div align="center"><img src="photo/preview-1.png?v=0.2.7" width="720" alt="原生 DeepSeek Harness 工作区 + DshCockpit Edge Rail 上下文状态" /><table><tr> <td><img src="photo/preview-2.png?v=0.2.7" width="280" alt="成本中心:工作区花费、预算与报警" /></td> <td><img src="photo/preview-3.png?v=0.2.7" width="280" alt="控制中心与插件市场" /></td> </tr></table></div>

诚实的局限

  • macOS 包尚未签名公证(需要上面那行 xattr);Windows 可能因同样原因触发 SmartScreen
  • 单人维护的项目;主要在作者自己的机器上实战验证
  • Windows 是主要开发目标;macOS arm64 由 CI 构建并冒烟测试(Intel 包暂停发布,可在 Apple Silicon 上自行交叉构建),但真实环境里程较少

🤝 贡献

欢迎 PR!请先跑 npm test(471 项测试)。架构见 DESIGN.md,产品理念见 PHILOSOPHY.md,功能清单见 FEATURES.md,竞争路线图见 ROADMAP.md

<details> <summary><b>操作层原则(产品理念)</b></summary>

Harness owns the workspace. DshCockpit owns the operating layer.

工作区——对话、文件、代码、审批——属于 Harness,保持原样。它周围的一切——监控、成本、自动化、更新、远程——属于驾驶舱。高频操作保持可见;Settings 只放持久配置;小问题永远不打开大面板(默认 → Peek → Cockpit → 完整配置)。Agent 不是窗口:它是持续运行、持续累积用量、随时接受指令的桌面服务,与前台是什么无关。

完整理念见 PHILOSOPHY.md

</details>

📄 许可与致谢

MIT · 基于 DeepSeek Harness 构建。社区项目——与 DeepSeek 官方无隶属关系,也未获其背书。

Operate deliberately

Install and manage

Prerequisites and target Profile

Target Deepseek Harness Users Profile, Desktop Agent Operators Profile

Delivery External App — https://github.com/Lxiayu/DshCockpit

Compatibility and access

Windows and macOS desktop app; macOS release is Apple Silicon Focused Not declared in supplied evidence

Review compatibility evidence

Risk facts

Unsigned Desktop Binary

The README says the macOS app is not signed or notarized, and Windows may trigger SmartScreen.

Evidence
Credential Requirement

Initial setup requires a DeepSeek API key.

Evidence
License

Source is offered under the MIT License, without warranty.

Evidence
Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

AI reviewed

Treat this as a community desktop companion for DeepSeek Harness, not an official DeepSeek product or endorsement.

AI reviewed Sep 16, 2026, 1:53 PM UTCGitHub facts last checked Sep 16, 2026, 1:53 PM UTC

No material source change has been recorded since this evidence baseline.

Next step

Compare ecosystem artifact types

Subscribe to material changes for DshCockpit