dsh-header-controls

会话右上角电源控制：Session log 左侧的「重启 / 注销」胶囊按钮，与官方版式一致（静态 web 插件）

Power controls for the DeepSeek Harness conversation header — "Restart / Exit" capsule buttons next to the session log, styled after the official dsh-session-log-export header action.

✨ 特性 / Features

• 重启一键直达（无需二次确认）：优雅退出当前 dsh 进程，由纯 Node 助手经 launcher 配置重新拉起服务，页面轮询到服务恢复后自动刷新，不新开标签页
• 注销两步确认：关闭整个 dsh 进程（等同官方电源按钮的作用），再次启动可双击桌面快捷方式
• 纯 Node 重启助手（lib/relaunch-helper.cjs）：零 PowerShell、零第三方依赖；延迟等待旧进程退出 → netstat 查端口兜底 taskkill → 读 launcher.config.json 重新拉起 → 轮询端口就绪（可选）打开浏览器
• maid-atelier 皮肤感知：检测 data-dsh-maid-atelier 属性自动切换深海蓝 + 柔金描边配色，无皮肤时恢复默认胶囊样式
• CSRF 防护：宿主路由仅允许 loopback + 自定义请求头 x-dsh-header-controls: 1

📦 安装 / Installation

适用于 DeepSeek Harness（dev preview 0.1.0-rc.x，web profile）。

1. 克隆或下载本仓库：

   git clone https://github.com/kgwdonkey/dsh-header-controls.git
   

2. 将插件链接到 dsh 的 profile node_modules（Windows 用 mklink /J，Linux/macOS 用 ln -s）：

   # 以 Windows 为例（需管理员或开发者模式）
   mklink /J "%USERPROFILE%\.dsh\profiles\node_modules\dsh-header-controls" "<克隆到的路径>"
   

3. 在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 追加注册（如果尚未存在）：

   # 追加到现有数组末尾
   - $insert: node_modules/dsh-header-controls/lib/index.js
   

4. 重启 dsh，会话页右上角（Session log 左侧）出现「重启 / 注销」按钮。

💡 也可以使用本地的 dsh-plugin-manager（如有）在「设置 → 插件 → 插件管理」中安装管理。

🚀 使用 / Usage

按钮	行为
重启	点击即触发：服务退出 → 自动重新拉起 → 页面自动刷新（约 10~30 秒，取决于启动速度）
注销	第一次点击进入确认态（按钮变红），再点一次确认关闭 dsh

⚙️ 配置 / Configuration

重启助手从 %LOCALAPPDATA%\DeepSeekHarness\launcher.config.json 读取启动参数：

{
  "node": "node 可执行文件路径",
  "repo": "dsh 仓库目录（含 apps/cli/lib/bin.js）",
  "profile": "web",
  "port": 3080,
  "host": "127.0.0.1"
}

缺失该文件时回退默认值：node=process.execPath、repo=$env:DSH_REPO、profile=web、port=3080、host=127.0.0.1；若 dsh 无预构建产物，则回退系统 dsh 命令垫片启动。

🧩 工作原理 / How it works

• 宿主半（lib/index.js）：注入 webServer，注册 /dsh-header-controls/restart 与 /dsh-header-controls/exit 两个精确路由（loopback + 自定义头双重校验）。重启时先清除插件管理器的「待重启」标记，再 spawn 分离式 Node 助手（detached + unref），1.5 秒后 appExit(0) 优雅退出。
• 客户端半（lib/client.js）：注入 conversation.session.header.utilities 插槽（order: -10，位于 Session log 左侧），实现胶囊按钮、两步确认、5 秒防误触、皮肤感知与重启后轮询刷新。
• 重启助手（lib/relaunch-helper.cjs）：延迟 → 端口兜底杀进程 → 按配置拉起新进程（日志落盘 dsh-server.log / dsh-server.err.log、写 pid 文件 dsh-server.pid）→ 轮询端口就绪。

📄 许可证 / License

MIT © 2026 kgwdonkey