dsh-manager

dsh 的浏览器开关：一键启动 / 停止 / 重启 dsh web，不碰终端。

答应我，不爱用 dsh web UI 的请划走👉 不会或者懒得敲终端启动命令的请留下🙏

我每天的固定节目是跟 dsh web 唠嗑🤖 我唯一不想开的窗口是终端🙅 我最喜欢的动物是鲸鱼🐋 我最喜欢的端口是 3080🔌 我最喜欢的运动是一键启动🏓 我最常忘的事是开完 dsh 不关，放它一头鲸在后台默默占端口😅 我最后的倔强是点一下浏览器图标，把上面这些破事全包了🙏

祝大家的 dsh 永远一键就绪🤩

——如果你没划走，来对地方了。dsh-manager 把 dsh web 的开关装进你的浏览器工具栏：启动、停止、重启、状态徽标、日志查看、页面内管理面板，全是弹窗一下的事，不用记命令、不用开终端。

功能（全部已实现）

• ▶️ 一键启动 / 停止 / 重启：停止自动走 dsh-lifecycle 优雅停机，插件不在才强制降级
• 🔍 认领野生 dsh：终端里手工起过的 dsh web（任意端口，含 --port 0）也能自动认出来，点「接管」就归你管
• 📜 日志查看页：自动刷尾部、逐块翻更早、一键复制全部
• 🧩 页面内面板：dsh Web UI 右下角自带管理徽章——实时状态、两步确认停止、重启，不用离开页面
• 🎨 同款皮肤：popup 与 dsh Web UI 同一套设计令牌，一家人不认两家门
• ⚙️ 可配置：端口（0 = 自动分配动态端口）、profile、自动开 UI、徽标刷新间隔
• 🛡️ 克制：只走 127.0.0.1 回环；不读不存你的 dsh 凭据；宿主只认本项目固定扩展 ID

安装（三步）

前置：Node ≥ 18，dsh 全局装好：

npm i -g @deepseek-ai/dsh

第一步，跑安装脚本（先预演，再正式装）：

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -File .\native-host\install.ps1 -DryRun
powershell -ExecutionPolicy Bypass -File .\native-host\install.ps1

Linux / macOS（sh，用户级注册、无需 sudo）：

sh native-host/install.sh --dry-run
sh native-host/install.sh

第二步，chrome://extensions（或 edge://extensions）→ 打开「开发者模式」→ 「加载已解压的扩展程序」→ 选本仓库 extension 目录。浏览器正在跑的话先完全退出重启再加载（宿主注册只在浏览器启动时读取）。

第三步，点工具栏图标 → 「启动」，就绪后自动打开 Web UI。

卸载：Windows 为 powershell -ExecutionPolicy Bypass -File .\native-host\uninstall.ps1；Linux / macOS 为 sh native-host/uninstall.sh（都支持保留日志：-KeepLogs / --keep-logs）。

Windows 与 Linux 已实测；macOS 安装脚本同源（uname 分支）但未实测、Firefox 运行时未实测——详见下方「测试环境」。

配置

popup 设置面板（保存在 chrome.storage.local）：

配置项	默认值	说明
port	3080	0 = 自动分配，启动后从日志回填实际端口
profile	web	透传给 dsh --profile
host	127.0.0.1	固定回环
自动打开 UI	开	启动就绪后自动打开标签页
徽标刷新间隔	30 秒	图标徽标状态刷新周期

常见问题

HOST_NOT_INSTALLED？ 浏览器找不到本地宿主。重跑 native-host\install.ps1，然后完全重启浏览器。

popup 显示 external？ 有个不是本扩展起的 dsh web 在跑（比如你在终端敲过 dsh web --port 4080）。可直接打开它的 UI，或「接管」后像自启动实例一样停止 / 重启（重启按原参数重放）；不接管就不动它。

端口被占用？ popup 设置里换端口，或设成 0 自动分配。占用者若是另一个 dsh web，会被识别成 external。

安全吗？ 扩展与宿主仅 127.0.0.1 回环通信；宿主只接受本项目固定扩展 ID；不读不存凭据；状态文件与日志只落在本地（Windows 为 %LOCALAPPDATA%\dsh-manager\）。

测试环境

怎么测的、什么没测，都写在这里：

项目	环境	结果
Windows 冒烟	Windows 11 Pro + Chrome / Edge	全新克隆 333 PASS + 4 SKIP（3 项本地产物核对 + 1 项 POSIX 场景跳过）；开发机 339 PASS + 1 SKIP
Linux 冒烟	Kali WSL（WSL2）+ 便携 Node 22.16.0	346/346 PASS（真实 /proc 进程枚举与端口表、SIGTERM 终止、--port 0 全链路）
真实 dsh 集成	@deepseek-ai/dsh 0.1.0-rc.6（npm latest，2026-08 基线）	smoke-real：启动/停止全链路 + --port 0 真机回填 + 外部发现生产路径
扩展 UI	headless Chrome + 零依赖 CDP	verify-cdp 28 断言全过（popup / logs / 页面内面板 / 徽标 / console 检查）
生命周期插件	dsh-lifecycle	单测 21/21

没测的（不装）：

• macOS：分支代码已写，没设备，没实测
• Firefox 运行时：宿主注册已就绪，本机没装 Firefox，没实测
• Chrome Web Store：暂不上架，本地开发者模式加载即可

更多

• 详细设计（架构 / 协议 / 安全 / 路线图）：docs/design.md
• 开发、测试命令与提交规范：CONTRIBUTING.md
• dsh 本体：github.com/deepseek-ai/deepseek-harness
• 构建者：本项目完全由 deepseek-V4-pro-0813 在 dsh 中构建，视觉辅助模型为 gemini-3.5-flash-lite
• 许可证：MIT（LICENSE）。鲸鱼 logo 等品牌素材版权归 DeepSeek 所有、不随 MIT 授权，见 NOTICE。

非官方社区工具，与 DeepSeek 官方无隶属关系；极端情况下强制停止可能丢最近几秒会话状态，使用前自行评估。