Lxiayu/DshCockpit
Desktop cockpit for DeepSeek Harness (dsh): token usage & cost tracking, budget alerts, runtime auto-update with rollback, Quick Ask hotkey, scheduled tasks, session search. Win+macOS. DeepSeek Harness 桌面驾驶舱:成本/用量监控 · 自动更新 · 定时任务
项目介绍Project Overview
DshCockpit 是一款基于 Electron 的 DeepSeek Harness 桌面客户端,开源且 MIT 协议。它常驻系统托盘,提供 Token/Context 实时监控、成本统计、官方余额、IM 渠道遥控、全局热键 Quick Ask、定时任务、全文检索、远程访问、模型与插件市场等能力,并以独立控制层方式运行,不改动 Harness 原生工作区。适合需要持续运行、成本可观测并希望扩展自动化的桌面 Agent 用户。需注意 macOS 包未签名,首次启动需用 xattr 解除隔离。
DshCockpit is an open-source Electron desktop client for DeepSeek Harness, licensed under MIT. It runs in the system tray and adds an operating layer above the native Harness workspace without modifying it, offering real-time token and context monitoring, cost tracking with budgets, official balance display, IM integrations (Feishu, WeCom, DingTalk), global Quick Ask hotkey, scheduled tasks, full-text session search, remote LAN/Tailscale/Cloudflare access, model management, and a plugin marketplace. Use it when you need a persistent, cost-aware Agent cockpit with desktop automation. Note: the macOS build is not code-signed, so first launch requires xattr to clear Gatekeeper quarantine.
请帮我了解并安装插件:【DshCockpit】【https://github.com/Lxiayu/DshCockpit】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。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.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:Lxiayu/DshCockpit
把 Lxiayu/DshCockpit 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
简体中文 | English
🛩️ DshCockpit
不是给 dsh 再套一个窗口——而是一个桌面控制平面。
DshCockpit 把 DeepSeek Harness(dsh)从一条终端命令变成常驻桌面的 Agent 服务:Harness 工作区保持 100% 原生,壳只在其外补齐安全更新、成本核算、后台任务、远程访问——全部通过稳定接口完成。内置运行时,无需安装 Node.js。
💬 交流群
欢迎扫码进群,讨论使用问题、反馈建议,或聊聊 Agent 桌面化的玩法。
为什么需要它?
如果你每天用 dsh 跑 Agent,有三个问题始终绕不开:
| 问题 | 实际会发生什么 |
|---|---|
| 更新全靠赌 | 上游 rc 版几天一个,手动升级可能弄坏 profile,降级等于重装。 |
| 花了多少钱是黑盒 | 没有用量接口、没有花费面板——等账单到了才知道一次调试狂欢的价格。 |
| Agent 活在一个窗口里 | 关掉窗口(或合上盖子),长任务就死了;审批请求只能等你回来。 |
常见的桌面壳对这三个问题都无能为力——它们只是把同一个窗口装进托盘。DshCockpit 把 Agent 当作需要运维的服务,窗口只是它恰好可见的地方。
你能得到什么
1 · 一个不会把自己搞坏的运行时
新版本并行安装,必须先通过 --dump-config 冒烟测试才允许激活,切换是原子操作。坏版本永远激活不了;一键回滚会同时恢复上一版本和数据目录快照。更新自动跟随官方 npm 通道——不 vendor、不分叉、不落后于上游。
2 · 成本与用量可观测
- 上下文压力常驻:安静的胶囊实时显示当前会话输入/输出/缓存 token,60%/85% 预警,一键压缩
- 成本中心:按天/周/月统计,按工作区归因,峰谷分时计价,月度预算 80%/100% 报警
- 官方余额:实时显示总额/赠送/充值,精确到每轮对话花费与缓存节省
全部在本地从会话日志计算(纯 JS zstd 解压),零遥测。
3 · 你不盯着它也能干活
- Quick Ask —
Ctrl+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 / Intel)→ 拖入「应用程序」→ 启动。
⚠️ 尚未签名公证——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(齿轮有红点提示)→ 选择工作区 → 开始对话。其余一切都是可选的。
📸 界面预览

![]() |
![]() |
诚实的局限
- macOS 包尚未签名公证(需要上面那行
xattr);Windows 可能因同样原因触发 SmartScreen - 单人维护的项目;主要在作者自己的机器上实战验证
- Windows 是主要开发目标;macOS arm64/x64 由 CI 构建并冒烟测试,但真实环境里程较少
🤝 贡献
欢迎 PR!请先跑 npm test(311 项测试)。架构见 DESIGN.md,产品理念见 PHILOSOPHY.md,功能清单见 FEATURES.md,竞争路线图见 ROADMAP.md。
操作层原则(产品理念)
Harness owns the workspace. DshCockpit owns the operating layer.
工作区——对话、文件、代码、审批——属于 Harness,保持原样。它周围的一切——监控、成本、自动化、更新、远程——属于驾驶舱。高频操作保持可见;Settings 只放持久配置;小问题永远不打开大面板(默认 → Peek → Cockpit → 完整配置)。Agent 不是窗口:它是持续运行、持续累积用量、随时接受指令的桌面服务,与前台是什么无关。
完整理念见 PHILOSOPHY.md。
📄 许可与致谢
MIT · 基于 DeepSeek Harness 构建。社区项目——与 DeepSeek 官方无隶属关系,也未获其背书。


nexu-io/open-design
ruvnet/ruflo
amruthpillai/reactive-resume
esengine/DeepSeek-Reasonix
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/distilly
titanwings/colleague-skill