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）：浏览器找不到本地宿主。重跑安装脚本并完全重启浏览器——宿主注册只在浏览器启动时读取：Windows 为 native-host\install.ps1，Linux / macOS 为 native-host/install.sh。
• external 状态：页面上检测到不是本扩展启动的 dsh web（比如你在终端手工跑过 dsh web --port 4080）。可以直接打开它的 UI 查看，或点「接管」后像自启动实例一样停止 / 重启（重启按原参数重放）；不接管就不动它。
• 端口占用：popup 设置里换端口，或设成 0 自动分配动态端口（启动后自动回填实际端口）；占用者若是另一个 dsh web，会被识别为 external。
• 安全模型：扩展与宿主仅经 127.0.0.1 回环通信；宿主只接受本项目固定扩展 ID；不读不存 dsh 凭据；状态文件与日志只落在本地（Windows 为 %LOCALAPPDATA%\dsh-manager\，Linux / macOS 为 ~/.config/dsh-manager 或 ~/Library/Application Support）。

测试环境

• 已验证：Windows 11（Chrome / Edge）与 Kali WSL2（Linux）冒烟测试全过；真实 dsh 0.1.0-rc.6 的启动 / 停止 / 动态端口 / 外部发现集成验证通过；扩展 UI 自动验收（headless Chrome + CDP，33 条断言）全过；dsh-lifecycle 插件单测 21/21。
• 未实测：macOS（安装脚本同源实现，无设备）；Firefox 运行时（宿主注册已就绪，本机未装）；Chrome Web Store 上架（暂缓，本地开发者模式加载即可）。

更多

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

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