dsh-new-session 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 deepseek-plugins contributors
+
+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

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# `dsh-new-session`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在输入框里敲 `/new`，直接在当前工作区开一个新会话——等价于点侧边栏的 **New Session**
+按钮，但不用把手从键盘上拿开。
+
+## 它做什么
+
+- 在 `/` 菜单里注册一个 **New session / 新建会话** 命令（`/new`，客户端 action）。
+- 执行时调用 Web GUI 的工作区导航服务，行为和 New Session 按钮完全一致：
+  - 当前工作区里已有空白会话时**复用**它——所以回到那个空白会话未发送的草稿；
+  - 没有空白会话时新建一个；
+  - 旧会话原样留在历史列表里，不会被删除或修改。
+- 命令只在当前 Peer 有 `session/create` 权限时出现；只读的远程访问者看不到这一行。
+- 不提交任何提示词：`action` 类型会消费掉 `/new` 这个 token，不会把它当消息发给模型。
+
+## 安装
+
+```sh
+# 本地 checkout
+dsh plugin --profile web add /home/ubuntu/code/deepseek-plugins/packages/dsh-new-session
+dsh --profile web --dump-config    # 应能看到 "# == dsh-new-session"
+```
+
+装完需要重启正在运行的 Web profile：浏览器半由宿主发布，页面刷新不够，Host 的
+client-module 扫描要重新 boot。
+
+构建产物由 `prepare` 脚本（tsdown）产出；改完源码后重新
+`pnpm --filter dsh-new-session build` 即可。外部安装的插件不在 `pnpm run dev:web` 的监视
+范围内，client-hmr 每 500ms 轮询 `lib/client.js`，重新构建后页面会自动换上新的浏览器半。
+
+## 在 GUI 里走一遍
+
+1. 重启 Web profile，打开任意一个会话。
+2. 在输入框里输入 `/new`：`/` 菜单里出现 **新建会话** 一行（也可以直接按回车执行）。
+3. 执行后当前视图切到一个空白会话；输入框里是空的（如果那个空白会话本来就有草稿，草稿还在）。
+4. 侧边栏里原来的会话还在，点回去内容完全没变。
+
+## 实现
+
+两半都只做一件事：
+
+- **宿主半**（`src/index.ts`）是空插件。它存在的意义是让 Loader 挂载这个包——只有挂载了，
+  client-module 扫描才会把 `lib/client.js` 发布给页面。
+- **浏览器半**（`src/client/index.tsx`）用 `ctx.commandUi.register()` 注册一个
+  `kind: 'action'` 的贡献；`run` 调用 `ctx.uiWorkspace.startSession()`。注册包在
+  `ctx.remoteAccess.whenAccess('session/create', …)` 里，权限变化时自动装上/卸下。
+
+`/new` 这个名字没有对应宿主命令，所以不会和现有 command 撞名；
+`cordis.patch.yml` 只插一行，没有配置项。
+
+## 已知边界
+
+- **只对 Web GUI 生效**。SDK / 桌面纯文本入口的斜杠命令识别只认内置白名单
+  （dsh 的 `query-input.ts`），第三方插件命令不会从那条路进入；要覆盖那些入口需要改 dsh 本体。
+- 它是「新会话」而不是「原地清空上下文」：旧对话仍然在历史里，会话 id 也不变的是**新会话**
+  的 id。想在同一个会话里清空上下文是另一件事（surface replace），这个插件不做。
+- 复用空白会话意味着连续两次 `/new` 可能停在同一个空白会话上——和按钮行为一致。
+- 菜单行的文案来自浏览器半的字典（en / zh）；`locale/*.json` 只给市场页的
+  `meta.title` / `meta.description` 用。

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# The configuration layer this bundle contributes to a dsh profile. The row
+# `name` must match the package name in package.json; the host Loader imports
+# that specifier and starts the plugin's main entry.
+#
+# This package has no host-side capability: the `/new` command is a browser
+# contribution. The row exists so the Loader owns the package lifecycle, which
+# is also what makes the client-module scanner publish `lib/client.js` to the
+# Web GUI.
+#
+# Later layers win per row id, and a patch replaces a row's whole `config`
+# value instead of merging keys. Users can therefore override this row from
+# `$DSH_HOME/profiles/<name>/cordis.patch.yml` without touching this package.
+- insert:
+    - id: dsh-new-session
+      name: 'dsh-new-session'

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="dsh plugin template">
+  <rect width="64" height="64" rx="14" fill="#1f6feb"/>
+  <path d="M18 21h28M18 32h28M18 43h17" stroke="#ffffff" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/lib/client.js

@@ -0,0 +1,76 @@
+window.__ModuleLoader__.load({ id: "dsh-new-session", factory: function (require) {
+var module = { exports: {} };
+var exports = module.exports;
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// src/client/locales.ts
+/** English copy. */
+const en = {
+	label: "New session",
+	description: "Start a fresh conversation in this workspace"
+};
+/** Simplified Chinese copy. */
+const zh = {
+	label: "新建会话",
+	description: "在当前工作区开一个全新的对话"
+};
+// src/client/index.tsx
+/** Browser module id: package name, bundle row id, plugin id. */
+const name = "dsh-new-session";
+/** Locale namespace this plugin owns. */
+const NS = "newSession";
+/** Client services the command cannot work without. */
+const inject = [
+	"commandUi",
+	"locale",
+	"remoteAccess",
+	"uiWorkspace"
+];
+/**
+* Build the `/new` contribution.
+*
+* Exported for the contract spec: the contribution is the unit under test, and
+* `apply` only decides when to install it.
+*
+* @param deps - translator and navigation callback.
+* @returns the silent action contribution.
+*/
+function createNewSessionCommand(deps) {
+	return {
+		name: "new",
+		label: () => deps.t("label"),
+		description: () => deps.t("description"),
+		available: () => true,
+		ui: {
+			kind: "action",
+			run: () => {
+				deps.start();
+			}
+		}
+	};
+}
+/**
+* Mount the browser half.
+* @param ctx - browser-side Cordis context.
+*/
+function apply(ctx) {
+	ctx.effect(() => ctx.locale.register(NS, {
+		en,
+		zh
+	}), "dsh-new-session: dictionaries");
+	const t = ctx.locale.bind(NS);
+	ctx.effect(() => ctx.remoteAccess.whenAccess("session/create", () => ctx.commandUi.register(createNewSessionCommand({
+		t,
+		start: () => {
+			ctx.uiWorkspace.startSession();
+		}
+	}))), "dsh-new-session: /new command");
+}
+exports.apply = apply;
+exports.createNewSessionCommand = createNewSessionCommand;
+exports.inject = inject;
+exports.name = name;
+
+
+return module.exports;
+} });

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+import { Context } from "@deepseek-ai/cordis";
+/** Plugin id: package name, bundle row id, and browser module id. */
+export declare const name = "dsh-new-session";
+/**
+ * Mount the inert Host half.
+ * @param ctx - the Cordis context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -0,0 +1,11 @@
+// src/index.ts
+/** Plugin id: package name, bundle row id, and browser module id. */
+const name = "dsh-new-session";
+/**
+* Mount the inert Host half.
+* @param ctx - the Cordis context.
+*/
+function apply(ctx) {}
+export { apply, name };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Host half of the `/new` command plugin.\n *\n * The command itself is a browser contribution: the slash menu and the\n * new-Session navigation both live in the Web GUI, so this Host row only mounts\n * the package — which is enough for the client-module scanner to publish\n * `lib/client.js`, and for the plugin's lifecycle to follow the bundle.\n *\n * @module dsh-new-session\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\n\n/** Plugin id: package name, bundle row id, and browser module id. */\nexport const name = 'dsh-new-session'\n\n/**\n * Mount the inert Host half.\n * @param ctx - the Cordis context.\n */\nexport function apply(ctx: Context): void {\n  // No host-side capability on purpose: a Host handler could not move the\n  // browser's current Session, so `/new` is a client-owned action instead.\n  void ctx\n}\n"],"mappings":";;AAcA,MAAa,OAAO;;;;;AAMpB,SAAgB,MAAM,KAAoB,CAI1C"}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "New Session command",
+    "description": "Type /new in the composer to start a fresh conversation in the current workspace."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "新建会话命令",
+    "description": "在输入框里输入 /new，直接在当前工作区开一个全新的对话。"
+  }
+}

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "dsh-new-session",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "A `/new` slash command in the Web GUI composer: start a fresh Session in the current Workspace without leaving the keyboard.",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "plugin",
+    "session",
+    "command"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "icon": "icon.svg",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "locale",
+    "icon.svg",
+    "README.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.2-rc.1 <0.2.3-0"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remote-access",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-commands",
+        "@deepseek-ai/dsh-client-ui-workspace"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.1.0",
+    "@deepseek-ai/dsh-api-remote-access": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-api-session-controller": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-client-ui-commands": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-client-ui-workspace": ">=0.2.2-rc.1 <0.2.3-0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.1.0",
+    "@deepseek-ai/dsh-api-remote-access": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.2-rc.1",
+    "@types/node": "^26.6.6",
+    "tsdown": "^0.23.4",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "author": "mxn404",
+  "homepage": "https://github.com/mxn404/deepseek-plugins/tree/main/packages/dsh-new-session",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mxn404/deepseek-plugins.git",
+    "directory": "packages/dsh-new-session"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }