Lxiayu / DshCockpit

English | 简体中文

---

💬 交流群

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

---

✨ 为什么选择 DshCockpit？

别的壳把 dsh web 装进窗口；DshCockpit 把 dsh 变成一台后台服务，并在其上构建了四个其他项目都没有的差异化能力：

	浏览器版 dsh web	其他桌面壳	DshCockpit
关闭窗口	❌ 会话就断	✅ 托盘常驻	✅ 托盘常驻 + 后台任务照跑
运行时更新	❌ 手动 npm	❌ 无	✅ 自动更新管道 + 冒烟守卫 + 一键回滚
Token 用量	❌ 只闪一下	❌ 无	✅ 实时胶囊 + 上下文压力预警
花费多少	❌ 不知道	❌ 无	✅ 成本中心：按天/周/月/工作区统计 + 预算报警
随手提问	❌ 要开浏览器	❌ 无	✅ 全局热键 Quick Ask（后台运行）
定时任务	❌ 无	❌ 无	✅ 壳级定时任务（间隔/每天 + 通知）
历史检索	❌ 手动翻	❌ 无	✅ Ctrl+K 全文搜索全部会话
数据安全	✅ 本地	✅ 本地	✅ 本地 + 自动备份 + 隐私声明 + 备份不含密钥

一句话：它们做"窗口"，我们做"控制台"。

---

🚀 功能全景

🎛️ 驾驶舱级监控（独有）

• Token 实时胶囊：窗口右上角常驻显示当前会话 输入→输出 tokens；悬停看明细（当前/全部会话、缓存）；上下文压力达到 60%/85% 自动黄/红预警，提醒你"该开新会话了"。
• 成本控制中心：按天/周/月统计 token 与估算费用（单价可配），按工作区看谁在烧钱；月度预算 + 80%/100% 报警，再也不会月底收到吓人的账单。

🔄 更新体系（双层解耦，坏版本不激活）

• 运行时更新：registry 检查 → 安装 → --dump-config 冒烟测试守卫（坏版本绝不激活）→ 待应用 → 切换（自动快照 DSH_HOME）→ 一键回滚。预览版快速迭代期的最强稳定性保障。
• 壳自身更新：自动检查（启动 + 每 4h）→ 更新说明对话框（展示 GitHub Release 正文）→ 立即重启。

⚡ 后台 Agent 服务（独有）

• Quick Ask（全局快捷问询）：默认 Ctrl+Alt+Space 弹出小窗，随手提问 → 后台无头会话运行 → 完成通知。写代码时不用切窗口就能问。
• 定时任务：每天/每间隔跑固定提示词（日报、周报、清理），到点自动执行 + 系统通知。
• 任务完成通知：窗口最小化时，agent 跑完长任务、有人要审批、有提问待回答，都会系统通知你。
• 手机远程控制：设置中开启后，手机连同一 Wi-Fi，把设置页显示的配对链接（含一次性配对码，可一键复制）发到手机、用浏览器打开即完成配对，之后可完整使用 dsh Web UI——查看会话流式输出、发消息/插话、审批工具执行、回答提问。默认「微信/抖音打开兼容模式（HTTP）」让微信/抖音内置浏览器直接打开，也可关闭改走自签 HTTPS（系统浏览器需点「继续访问」）。一次性配对码 + 加密长期令牌；运行时本身仍只监听 127.0.0.1，局域网只能到达壳的鉴权网关（详见 DESIGN.md §17）。

🔍 历史与检索

• Ctrl+K 会话全文检索：跨全部历史会话按关键词搜索（片段高亮 + 一键复制）。
• 会话自动备份：退出时备份 + 手动备份，保留 N 份；升级/回滚另有 DSH_HOME 快照。

🧩 生态与体验

• 插件市场：浏览 GitHub「dsh-plugin」话题（2000+ 社区插件），独立窗口搜索 + 一键安装/卸载。
• 三语界面（中文/English/跟随系统）；托盘、通知、设置全本地化。
• 快捷键（Ctrl+, 设置 / Ctrl+K 搜索 / Ctrl+R 重载 / Ctrl+Shift+I 开发者工具）。
• 首次运行引导、窗口位置记忆、崩溃自动重启（60s 内 3 次防循环）、孤儿进程看门狗（壳崩溃自动清理运行时，不留幽灵进程）。
• 存储管理（占用可视化 + 一键清理）、崩溃诊断记录。

🛡️ 数据与隐私

• 完全本地运行。设置界面明示：不收集、不上传、不存储你的个人信息、API Key、会话内容与用量数据。
• 备份刻意不含 API 凭据（防明文密钥扩散）；运行时下载全程 sha512 校验；harness 自带文件沙箱与审批机制原样保留。

---

🚀 快速开始

方式一：Windows 便携版

从 Releases 下载 DshCockpit-<version>-win-x64.zip → 用 7-Zip/WinRAR 解压 → 双击根目录的 DshCockpit.exe。

约 9 秒开窗（首次启动若 DSH_HOME 尚未初始化会多花约 20–30 秒建立 profile），内置运行时，无需安装 Node/dsh、无需联网下载。后续版本自动更新。 若内置运行时被解压工具截断（极少见），应用会自动尝试从 npm registry 安装兜底，并按提示用 7-Zip 重新解压。

方式二：macOS 安装包（.dmg）

从 Releases 下载对应架构的 .dmg：

• Apple Silicon（M1/M2/M3/M4）：DshCockpit-<version>-mac-arm64.dmg
• Intel Mac：DshCockpit-<version>-mac-x64.dmg

双击挂载 → 把 DshCockpit 拖进「应用程序」→ 在启动台/访达双击启动。

⚠️ 首次打开会提示「已损坏」或「无法验证开发者」：当前 macOS 包尚未签名公证（暂无 Apple Developer 证书），这是 Gatekeeper 的正常拦截，应用本身没坏。任选其一放行即可：

• 图形界面：先双击一次（弹出警告点取消）→「系统设置 → 隐私与安全性」→ 滚到底部点「仍要打开」→ 再点「打开」。
• 终端一行（推荐，最快）：

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

放行一次后即可永久正常启动。后续接入 Apple 签名公证后此提示会消失。

方式三：从源码运行（推荐给开发者/尝鲜者）

# 前置：Node.js ≥ 22；推荐本机已安装 @deepseek-ai/dsh（未安装时首次启动会自动下载）
git clone https://github.com/Lxiayu/DshCockpit.git
cd DshCockpit
npm install
npm start

首次启动后：

1. 在窗口的 Harness 设置里配置你的 DeepSeek API Key（右上角齿轮有红点提示）；
2. 把工作区文件夹拖到右上角工具条（或设置里选择）；
3. 开始对话——右上角胶囊实时显示 token 用量。

---

📸 界面预览

---

🏗️ 技术架构

DshCockpit (Electron)
 ├─ 运行时管理：版本目录 + 更新管道（Arborist 安装 / 冒烟测试 / 切换 / 回滚）
 ├─ 数据层：会话解析（zstd）、成本历史、全文检索、备份/快照
 ├─ 事件流：订阅运行时 WebSocket（任务完成 / 审批 / 提问）
 ├─ 服务：Quick Ask、定时任务调度器、插件市场、崩溃看门狗
 └─ 界面：壳设置窗口 + 窗口内 chrome（token 胶囊 / 快捷入口）

• 壳与运行时彻底解耦：运行时版本化共存于 userData/runtime/，互不干扰；
• 接口面刻意做小：spawn 参数、URL 行、HTTP/WS——上游怎么改都不影响壳。

---

🗺️ 路线图

• 运行时/壳双层自动更新 + 回滚
• Token 监控 + 成本中心 + 预算报警
• Quick Ask + 定时任务 + 任务/审批通知
• 会话全文检索 + 自动备份 + 隐私声明
• 插件市场 + 三语界面 + 便携打包（内置运行时）
• macOS 构建（CI 自动产出 arm64 + x64 包）
• 手机远程控制（局域网安全网关：配对 + 审批 + 会话）
• macOS 代码签名与公证
• 代码签名（Windows Authenticode）
• 系统钥匙串集成（凭据加密）
• 更多工作流

---

🤝 贡献

欢迎 PR！请先跑 npm test（34 项单元测试）。架构细节见 DESIGN.md，功能清单见 FEATURES.md。

📄 许可证

MIT

🙏 致谢

• DeepSeek Harness — 本项目所驱动的 Agent 运行时与 Web UI
• 所有贡献过社区桌壳与插件的开发者