dsh-shutdown 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 replicant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,44 @@
+# dsh-shutdown
+
+<!-- Hero -->
+<div align="center">
+  <b style="font-size: 1.15em;">一键结束 DSH 服务</b><br /><br />
+  Settings「关机」页 · 二次确认 · 优雅退出<br /><br />
+  <b>关掉浏览器不再留下后台进程</b>。
+</div>
+
+<div align="center">
+  🌏 <a href="./README.md"><b>中文</b></a> · <a href="./README_EN.md">English</a>
+</div>
+
+## ✨ 为什么需要
+
+关闭浏览器**不会**结束 dsh 的后台服务进程——服务继续占用端口与内存。本插件在页面内提供一键关机入口，无需命令行。
+
+## ✨ 功能一览
+
+- **🖥️ Settings「关机」页**：侧栏最底部新增「关机」页签
+- **🛡️ 二次确认**：点「关闭 DSH 服务」→ 出现「确认关闭 / 取消」双按钮，防误触
+- **✅ 成功反馈**：确认后页面立即显示绿色「关闭成功」面板（并尝试自动关闭标签页）
+- **🎨 原生风格**：按钮与配色全部引用 DSH 主题 token（`--dsw-alias-*`），明暗自适应
+
+## 📦 安装
+
+```bash
+dsh plugin --profile web add <本仓库 / npm 包名>
+# 重启 dsh web 生效
+```
+
+## 🧠 设计要点
+
+- 关机端点：`/_dsh/shutdown`（仅 POST）——服务先返回「正在关闭」响应，500ms 后 `process.exit(0)` 优雅退出
+- 会话日志为逐事件落盘，空闲时退出安全；正在进行的对话请等待其完成后再关闭
+- 浏览器安全策略下脚本只能关闭自己打开的窗口——手动打开的标签页会保留「关闭成功」面板，两种情况下你都能确认结果
+
+## 🧩 生态
+
+打上 <a href="https://github.com/topics/dsh-shutdown"><code>dsh-shutdown</code></a> topic 的插件可接入同一生态。欢迎通过 PR 改进本插件。
+
+## 📄 许可
+
+[MIT](./LICENSE)

package/README_EN.md

@@ -0,0 +1,44 @@
+# dsh-shutdown
+
+<!-- Hero -->
+<div align="center">
+  <b style="font-size: 1.15em;">One-click shutdown for DeepSeek Harness</b><br /><br />
+  Settings page · double confirmation · graceful exit<br /><br />
+  <b>Closing the browser no longer leaves a background process behind</b>.
+</div>
+
+<div align="center">
+  🌏 <a href="./README.md"><b>中文</b></a> · <a href="./README_EN.md">English</a>
+</div>
+
+## ✨ Why
+
+Closing the browser does **not** stop the dsh background service——it keeps holding the port and memory. This plugin adds an in-page shutdown entry, no CLI needed.
+
+## ✨ Features
+
+- **🖥️ Settings page**: a new "Shutdown" section at the bottom of the sidebar
+- **🛡️ Double confirmation**: click "Shut down DSH service" → "Confirm / Cancel" buttons appear, preventing accidents
+- **✅ Success feedback**: a green "shut down successfully" panel renders immediately (and tries to close the tab)
+- **🎨 Native look**: all colors reference DSH theme tokens (`--dsw-alias-*`), light/dark adaptive
+
+## 📦 Install
+
+```bash
+dsh plugin --profile web add <this repo / npm package>
+# restart dsh web
+```
+
+## 🧠 Design notes
+
+- Shutdown endpoint: `/_dsh/shutdown` (POST only) —— responds "shutting down" first, then `process.exit(0)` after 500ms
+- Session logs are appended per event; exiting while idle is safe. Let an in-flight turn finish first
+- Browsers only allow scripts to close windows they opened——manually opened tabs keep the success panel, so the result is always visible
+
+## 🧩 Ecosystem
+
+Tag your own plugins with <a href="https://github.com/topics/dsh-shutdown"><code>dsh-shutdown</code></a> to join the ecosystem. PRs welcome.
+
+## 📄 License
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-shutdown bundle patch: mounts the plugin into a profile layer stack.
+- insert:
+    - id: shutdown
+      name: 'dsh-shutdown'

package/dsh.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "dsh-external/dsh-shutdown",
+  "version": "0.1.0",
+  "main": "./lib/index.js",
+  "description": "一键关机：Settings 新增「关机」页，二次确认后优雅退出 DSH 服务进程",
+  "engines": {
+    "dsh": ">=0.0.1"
+  },
+  "contributes": {
+    "tools": [],
+    "skills": []
+  },
+  "client": {
+    "main": "./lib/client.js"
+  }
+}

package/lib/client.js

@@ -0,0 +1,155 @@
+window.__ModuleLoader__.load({ id: "dsh-shutdown", factory: (require) => {
+var module = { exports: {} }; var exports = module.exports;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apply = apply;
+
+/**
+ * dsh-shutdown 浏览器半部：Settings「关机」页面。
+ * 确认模式：点「关闭 DSH 服务」→ 出现「确认关闭 / 取消」双按钮；
+ * 确认后请求关机并渲染成功面板。样式引用 DSH 主题 token。
+ */
+const react_1 = require("react");
+
+const NS = 'shutdown';
+const CSS = '' +
+  '.sd-root{display:flex;flex-direction:column;gap:12px;color:var(--dsw-alias-label-primary);font-size:14px}' +
+  '.sd-title{font-size:16px;font-weight:600;margin:0}' +
+  '.sd-sub{color:var(--dsw-alias-label-secondary);font-size:12px}' +
+  '.sd-row{display:flex;align-items:center;gap:8px;flex-wrap:wrap}' +
+  '.sd-btn{padding:8px 18px;border-radius:6px;cursor:pointer;font-size:13px;background:transparent}' +
+  '.sd-btn:disabled{opacity:0.5;cursor:not-allowed}' +
+  '.sd-btn-danger{border:1px solid var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}' +
+  '.sd-btn-danger:hover:not(:disabled){background:var(--dsw-alias-bg-layer-2)}' +
+  '.sd-btn-plain{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}' +
+  '.sd-btn-plain:hover:not(:disabled){border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-brand-primary)}' +
+  '.sd-confirm{color:var(--dsw-alias-label-secondary);font-size:13px}' +
+  '.sd-ok{color:var(--dsw-alias-state-success-primary);font-weight:600}' +
+  '.sd-err{color:var(--dsw-alias-state-error-primary)}';
+
+function ShutdownSection() {
+  const [confirmOpen, setConfirmOpen] = react_1.useState(false);
+  const [closing, setClosing] = react_1.useState(false);
+  const [done, setDone] = react_1.useState(false);
+  const [error, setError] = react_1.useState(null);
+
+  function handleCancel() {
+    setConfirmOpen(false);
+    setError(null);
+  }
+
+  async function handleConfirm() {
+    if (closing) return;
+    setClosing(true);
+    setError(null);
+    try {
+      const res = await fetch('/_dsh/shutdown', {
+        method: 'POST',
+        headers: { accept: 'application/json' },
+      });
+      const body = await res.json();
+      if (body && body.ok) {
+        setDone(true);
+        // 尝试关闭标签页（仅对脚本打开的窗口生效，手动打开的标签页静默失败）
+        window.setTimeout(function () { try { window.close(); } catch (e) { /* 忽略 */ } }, 800);
+        return;
+      }
+      setError(String((body && body.error) || '关机请求失败'));
+      setClosing(false);
+      setConfirmOpen(false);
+    } catch (e) {
+      // 进程可能已退出导致 fetch 失败——这其实意味着关机成功
+      setDone(true);
+    }
+  }
+
+  if (done) {
+    const okTitle = react_1.createElement('h3', { className: 'sd-title' }, '关机');
+    const okLine = react_1.createElement(
+      'div',
+      { className: 'sd-ok' },
+      '✅ 关闭成功——DSH 服务已退出。'
+    );
+    const okDesc = react_1.createElement(
+      'div',
+      { className: 'sd-sub' },
+      '本标签页可以安全关闭。如需再次使用，请重新启动 dsh web。'
+    );
+    return react_1.createElement('div', { className: 'sd-root' }, okTitle, okLine, okDesc);
+  }
+
+  const title = react_1.createElement('h3', { className: 'sd-title' }, '关机');
+  const desc = react_1.createElement(
+    'div',
+    { className: 'sd-sub' },
+    '关闭 DSH 服务进程。关闭后需要重新启动 dsh web 才能继续使用。'
+  );
+
+  const errLine = error
+    ? react_1.createElement('div', { className: 'sd-err' }, '错误：' + error)
+    : null;
+
+  if (confirmOpen) {
+    const confirmLine = react_1.createElement(
+      'div',
+      { className: 'sd-confirm' },
+      '确定要关闭 DSH 服务吗？正在进行的对话将被中断。'
+    );
+    const confirmBtn = react_1.createElement(
+      'button',
+      { className: 'sd-btn sd-btn-danger', onClick: handleConfirm, disabled: closing },
+      closing ? '正在关闭…' : '确认关闭'
+    );
+    const cancelBtn = react_1.createElement(
+      'button',
+      { className: 'sd-btn sd-btn-plain', onClick: handleCancel, disabled: closing },
+      '取消'
+    );
+    const btnRow = react_1.createElement('div', { className: 'sd-row' }, confirmBtn, cancelBtn);
+    return react_1.createElement(
+      'div',
+      { className: 'sd-root' },
+      title,
+      desc,
+      confirmLine,
+      btnRow,
+      errLine
+    );
+  }
+
+  const shutdownBtn = react_1.createElement(
+    'button',
+    { className: 'sd-btn sd-btn-danger', onClick: function () { setConfirmOpen(true); } },
+    '关闭 DSH 服务'
+  );
+
+  return react_1.createElement(
+    'div',
+    { className: 'sd-root' },
+    title,
+    desc,
+    shutdownBtn,
+    errLine
+  );
+}
+
+function apply(ctx) {
+  const slots = ctx.get('slots');
+  if (slots === undefined) return;
+
+  const styleEl = document.createElement('style');
+  styleEl.setAttribute('data-dsh-plugin', NS);
+  styleEl.textContent = CSS;
+  document.head.appendChild(styleEl);
+
+  slots.inject('settings.section', () => slots.register(
+    { name: 'settings.section', id: 'dsh-shutdown', order: 999, label: () => '关机' },
+    () => react_1.createElement(ShutdownSection, null)
+  ));
+
+  ctx.effect(() => () => {
+    if (styleEl.parentNode) styleEl.parentNode.removeChild(styleEl);
+  }, NS + ':css');
+}
+
+return module.exports; } });

package/lib/index.js

@@ -0,0 +1,40 @@
+/**
+ * dsh-shutdown — DeepSeek Harness 关机插件（Host 半部）。
+ *
+ * 提供 `/_dsh/shutdown` 端点：收到 POST 后先返回确认响应（让浏览器
+ * 拿到"正在关闭"的反馈），500ms 后优雅退出宿主进程。会话日志为逐事件
+ * 落盘，空闲时退出安全；正在进行的 turn 请等待其完成后再关闭。
+ * @module dsh-shutdown
+ */
+export const name = 'dsh-shutdown';
+export const inject = [];
+
+const EXIT_DELAY_MS = 500;
+
+/** Plugin 入口。 */
+export async function apply(ctx) {
+  ctx.inject(['webServer'], (webCtx) => {
+    const disposeRoute = webCtx.webServer.register({
+      kind: 'exact',
+      path: '/_dsh/shutdown',
+      handler: (req, res) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405;
+          res.setHeader('Content-Type', 'application/json; charset=utf-8');
+          res.end(JSON.stringify({ ok: false, error: 'method-not-allowed' }));
+          return;
+        }
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/json; charset=utf-8');
+        res.end(JSON.stringify({ ok: true, message: '正在关闭 DSH 服务' }));
+        // 留出响应送达浏览器的时间，再退出进程
+        setTimeout(() => {
+          process.exit(0);
+        }, EXIT_DELAY_MS);
+      },
+    });
+    return () => {
+      disposeRoute();
+    };
+  });
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "dsh-shutdown",
+  "version": "0.1.0",
+  "description": "DeepSeek Harness 关机插件：Settings 增加「关机」页，一键优雅退出 DSH 服务（先响应页面再退出进程）。",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "shutdown",
+    "exit"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README_EN.md",
+    "dsh.plugin.json"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0-rc.7 <5.0.0",
+    "react": "^18.2.0"
+  },
+  "license": "MIT"
+}