@funniki/dsh-session-toolkit 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 funniki
+
+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,51 @@
-# Temporary Holding Version
-
-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.
+# 会话功能增强 · dsh-session-toolkit 0.1.0
+
+给 DeepSeek Harness 增加五个会话与输入功能。插件列表中显示一个「会话功能增强」条目，五个组件保留各自的名称、图标和开关。
+
+主包和五个组件均为 **0.1.0**，不附带 `@deepseek-ai/*`、`zod` 等第三方运行时依赖。宿主端使用 Node 内置模块，浏览器端使用 DSH 提供的 React。
+
+| 组件 | 用途 |
+|---|---|
+| `@funniki/dsh-session-toolkit-archived-session-delete` | 永久删除已归档会话及其日志 |
+| `@funniki/dsh-session-toolkit-session-move` | 跨工作区移动会话，支持备份、校验、失败回滚及空闲会话热迁移 |
+| `@funniki/dsh-session-toolkit-unsent-content-guard` | 备份未发送的文字与图片 |
+| `@funniki/dsh-session-toolkit-session-history-search` | 按关键词搜索历史消息，支持中文 |
+| `@funniki/dsh-session-toolkit-auto-paste` | 将长文本保存为工作区中的 Markdown 或文本附件，并在输入框显示引用卡片 |
+
+## 安装
+
+**必须把主包和五个组件都安装到同一个 DSH profile。** 只添加外层目录不会自动安装五个组件，会出现「未运行」或 `Cannot find package`。
+
+1. 从 [GitHub Releases](https://github.com/Funniki/dsh-session-toolkit/releases) 下载 `dsh-session-toolkit-0.1.0.zip`。
+2. 解压到固定目录，进入包含本说明、`package.json` 和 `install.ps1` 的那一层。
+3. Windows 下运行：
+
+   ```powershell
+   powershell -ExecutionPolicy Bypass -File .\install.ps1
+   ```
+
+   安装到其他 profile 时可加 `-Profile <名称>`。脚本会依次安装主包和五个组件。
+4. 重启 DSH，或在插件页关闭再启用「会话功能增强」，然后确认五个组件均已运行。
+
+本地安装采用目录链接，安装后请保留解压目录的位置和内容。手动安装及排查步骤见同目录的 [安装说明](安装说明.md)。
+
+本版本通过 GitHub Release 的 ZIP 分发；npm 渠道另行发布。GitHub 自动生成的 Source code 压缩包是源码，不等同于安装包。
+
+## 配置
+
+长文本转换默认阈值为 500 字符，单次大小上限为 1 MiB。可以在「设置 → 通用 → 大段粘贴阈值」中修改阈值；用户设置保存在 `$DSH_HOME/auto-paste/user-config.json`。部署默认值由 `cordis.patch.yml` 中的 `minChars`、`maxBytes` 控制。
+
+零依赖实现不再提供原先依赖 schemastery 的自动生成配置表单。
+
+## 兼容性与使用边界
+
+- 已验证环境为 DSH `0.2.1-rc.5`、V4 会话日志格式。其他版本需要另行验证。
+- 会话运行中请等待当前轮次结束后再移动；空闲的已打开会话支持热迁移，无法直接迁移时可能需要重启后处理。
+- 删除已归档会话不可恢复。
+- 卸载插件不会自动删除迁移备份、未发送内容备份或工作区中的 `pastes/` 文件。
+
+## 开发与许可证
+
+源码、构建方式和验证脚本见 [GitHub 仓库](https://github.com/Funniki/dsh-session-toolkit)。组件源码在仓库的 `components/` 中，发布时由构建脚本同步到本目录的 `node_modules/`。
+
+MIT，见 [LICENSE](LICENSE)。auto-paste 保留上游许可证和第三方声明，随组件一起分发。

package/cordis.patch.yml

@@ -0,0 +1,26 @@
+# Bundle patch: one plugin pack with five components.
+#
+# Each row names one PUBLISHED component package, so every component keeps its
+# own display metadata (title, description, icon) and its own browser half.
+# The names are scoped on purpose: a bundle row resolves from the profile root,
+# and a bare `dsh-auto-paste` would collide with the upstream plugin of that
+# name. The five component packages are installed as profile dependencies of
+# this pack (install.ps1 does it); they are not separate bundles.
+- insert:
+    - id: archived-session-delete
+      name: '@funniki/dsh-session-toolkit-archived-session-delete'
+      config: {}
+    - id: session-move
+      name: '@funniki/dsh-session-toolkit-session-move'
+      config: {}
+    - id: unsent-content-guard
+      name: '@funniki/dsh-session-toolkit-unsent-content-guard'
+      config: {}
+    - id: session-history-search
+      name: '@funniki/dsh-session-toolkit-session-history-search'
+      config: {}
+    - id: auto-paste
+      name: '@funniki/dsh-session-toolkit-auto-paste'
+      config:
+        minChars: 500
+        maxBytes: 1048576

package/icon.svg

@@ -0,0 +1,11 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="2.5" y="2.5" width="31" height="31" rx="9" fill="url(#session-enhancements-bg)" />
+  <path d="M17.5 8 L19.76 15.24 L27 17.5 L19.76 19.76 L17.5 27 L15.24 19.76 L8 17.5 L15.24 15.24 Z" fill="#FFFFFF" />
+  <path d="M26.5 21.3 L27.49 24.51 L30.7 25.5 L27.49 26.49 L26.5 29.7 L25.51 26.49 L22.3 25.5 L25.51 24.51 Z" fill="#FFFFFF" fill-opacity="0.92" />
+  <defs>
+    <linearGradient id="session-enhancements-bg" x1="2.5" y1="2.5" x2="33.5" y2="33.5" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#74B3FF" />
+      <stop offset="1" stop-color="#5560F2" />
+    </linearGradient>
+  </defs>
+</svg>

package/install.ps1

@@ -0,0 +1,123 @@
+[CmdletBinding()]
+param(
+	[string]$Profile = "desktop",
+	[switch]$SkipChecks
+)
+
+# Installs the pack into one DSH profile, one command, both channels.
+#
+# Since 0.1.1 the pack declares the five components as its own dependencies, and
+# DSH profiles install with `nodeLinker: hoisted` — so the components land at the
+# profile ROOT, which is exactly where a bundle row resolves its `name`. That is
+# why installing the pack alone is enough now (0.1.0 needed six separate adds).
+#
+# This script therefore:
+#   1. installs the pack (from this folder when it is the extracted zip, from the
+#      registry when it came out of npm);
+#   2. checks that all five rows are resolvable from the profile root;
+#   3. only if one is not (a profile switched to the isolated linker), installs
+#      that component explicitly as a fallback.
+
+$ErrorActionPreference = "Stop"
+
+$pluginRoot = $PSScriptRoot
+$packName = "@funniki/dsh-session-toolkit"
+$components = @(
+	"@funniki/dsh-session-toolkit-archived-session-delete",
+	"@funniki/dsh-session-toolkit-session-move",
+	"@funniki/dsh-session-toolkit-unsent-content-guard",
+	"@funniki/dsh-session-toolkit-session-history-search",
+	"@funniki/dsh-session-toolkit-auto-paste"
+)
+
+$dsh = @(
+	(Join-Path $env:LOCALAPPDATA "Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"),
+	(Join-Path $env:ProgramFiles "DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd")
+) | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
+
+if (-not $dsh) {
+	$command = Get-Command dsh -ErrorAction SilentlyContinue
+	if ($command) {
+		$dsh = $command.Source
+	}
+}
+if (-not $dsh) {
+	throw "DeepSeek Harness CLI was not found. Install DSH or put dsh on PATH."
+}
+if (-not (Test-Path -LiteralPath (Join-Path $pluginRoot "package.json"))) {
+	throw "package.json is missing next to install.ps1."
+}
+
+function Add-ProfilePackage {
+	param([Parameter(Mandatory)][string]$Target)
+	Write-Host "Adding $Target"
+	& $dsh plugin --profile $Profile add $Target
+	if ($LASTEXITCODE -ne 0) {
+		throw "dsh plugin add failed for $Target (exit $LASTEXITCODE)."
+	}
+}
+
+# 1. The pack: this folder when it is the extracted zip, the registry otherwise.
+$thisPackage = Get-Content -LiteralPath (Join-Path $pluginRoot "package.json") -Raw | ConvertFrom-Json
+if ($thisPackage.name -eq $packName) {
+	Add-ProfilePackage -Target $pluginRoot
+} else {
+	Add-ProfilePackage -Target $packName
+}
+
+$dshHome = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $HOME ".dsh" }
+$profileDir = Join-Path (Join-Path $dshHome "profiles") $Profile
+$nodeModules = Join-Path $profileDir "node_modules"
+
+# 2. Do all five rows resolve from the profile root? (That is where the loader looks.)
+$missing = @()
+foreach ($component in $components) {
+	if (-not (Test-Path -LiteralPath (Join-Path $nodeModules $component))) {
+		$missing += $component
+	}
+}
+
+# 3. Fallback for a profile that is not hoisted: install each missing component.
+if ($missing.Count -gt 0) {
+	Write-Host ""
+	Write-Host "These components did not arrive with the pack (profile is not using the hoisted linker):"
+	foreach ($component in $missing) { Write-Host "  $component" }
+	foreach ($component in $missing) {
+		$bundled = Join-Path $pluginRoot "node_modules/$component"
+		if (Test-Path -LiteralPath (Join-Path $bundled "package.json")) {
+			Add-ProfilePackage -Target $bundled
+		} else {
+			Add-ProfilePackage -Target $component
+		}
+	}
+}
+
+if ($SkipChecks) {
+	Write-Host ""
+	Write-Host "Installed $packName into profile '$Profile' (post-install checks skipped)."
+	return
+}
+
+$profileManifestPath = Join-Path $profileDir "package.json"
+if (-not (Test-Path -LiteralPath $profileManifestPath)) {
+	throw "Profile manifest not found: $profileManifestPath"
+}
+$manifest = Get-Content -LiteralPath $profileManifestPath -Raw | ConvertFrom-Json
+if (-not (($manifest.dsh.profile.bundles) -contains $packName)) {
+	throw "Profile did not register $packName as a bundle."
+}
+foreach ($component in $components) {
+	if (-not (Test-Path -LiteralPath (Join-Path $nodeModules $component))) {
+		throw "Component is still not resolvable from the profile root: $component"
+	}
+}
+
+# The whole point of 0.1.x: no Harness core copy inside the profile.
+$duplicateCore = Join-Path $nodeModules "@deepseek-ai\dsh-tools"
+if (Test-Path -LiteralPath $duplicateCore) {
+	throw "Duplicate core package detected: $duplicateCore. Remove it before starting DSH."
+}
+
+Write-Host ""
+Write-Host "Installed $packName and its five components into profile '$Profile'."
+Write-Host "Restart DSH, or disable and re-enable the bundle in Plugins if it is already running."

package/lib/index.js

@@ -0,0 +1,13 @@
+/**
+ * The Session Enhancements pack.
+ *
+ * This package is a bundle (pack) only: its `cordis.patch.yml` inserts the
+ * three component rows, each naming one original plugin package. The pack has
+ * no plugin row of its own, so this module exists only to keep the package a
+ * valid module entry; adding another component is a matter of appending one
+ * `- id/name` row to `cordis.patch.yml` and installing that component package
+ * into the profile (see README).
+ *
+ * @module dsh-session-toolkit
+ */
+export {};

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Session Enhancements",
+    "description": "Handier Session management: delete archived Sessions, move a Session to another Workspace, back up unsent composer text and images, and search past messages by keyword (Chinese supported)."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "会话功能增强",
+    "description": "为会话提供更顺手的管理能力：删除已归档会话、把会话移动到其他工作区、备份未发送的文字与图片，并支持中文关键词搜索历史消息。"
+  }
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@funniki/dsh-session-toolkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Handier Session management: delete archived Sessions, move a Session to another Workspace, back up unsent composer text and images, and search past messages by keyword (Chinese supported).",
+  "license": "MIT",
+  "author": "funniki",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funniki/dsh-session-toolkit.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "cordis.patch.yml",
+    "install.ps1",
+    "locale/*.json",
+    "icon.svg",
+    "安装说明.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@funniki/dsh-session-toolkit-archived-session-delete": "^0.1.1",
+    "@funniki/dsh-session-toolkit-auto-paste": "^0.1.1",
+    "@funniki/dsh-session-toolkit-session-history-search": "^0.1.1",
+    "@funniki/dsh-session-toolkit-session-move": "^0.1.1",
+    "@funniki/dsh-session-toolkit-unsent-content-guard": "^0.1.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
 }

package//345/256/211/350/243/205/350/257/264/346/230/216.md

@@ -0,0 +1,100 @@
+# 会话功能增强（dsh-session-toolkit）安装说明
+
+这是一个 **DSH 插件包**：插件列表里出现一个「会话功能增强」条目，里面包含五个组件，
+每个组件保留自己的名称、图标和独立开关。
+
+当前版本 `0.1.0`，npm 上为 `@funniki/dsh-session-toolkit` 及五个
+`@funniki/dsh-session-toolkit-*` 组件包。
+
+## 重要：不要只安装外层
+
+DSH 按 **profile 根目录** 解析 bundle 里的组件包名，不会读取外层包自己的
+`node_modules`。所以只安装 `@funniki/dsh-session-toolkit` 会让五个组件显示“未运行”，并报：
+
+```text
+ERR_MODULE_NOT_FOUND: Cannot find package '@funniki/dsh-session-toolkit-archived-session-delete'
+  imported from C:\Users\<你>\.dsh\profiles\desktop\
+```
+
+从 `0.1.1` 起，pack 把这五个组件声明成了自己的 `dependencies`，而 DSH 的 profile 用
+`nodeLinker: hoisted`，组件会被平铺到 profile 根目录 —— 也就是行解析包名的位置。
+所以插件页只填 `@funniki/dsh-session-toolkit` 就够了，安装脚本也会先尝试这一条。
+
+> ⚠️ 不要用仓库目录直接安装：本地安装会记成 `link:`，插件页「卸载」会连带清空链接目标里的文件。
+> 仓库只用于开发和构建；安装请走 npm，或把 zip 解压到独立目录再装。
+
+## 系统要求
+
+- DeepSeek Harness 桌面端，版本 `>= 0.2.0`（0.2.1-rc.5 已验证）
+- Windows PowerShell 5.1 或更高（`install.ps1`）
+- 无需 Node、无需构建；五个组件已随包内 `node_modules/@funniki/` 带好，
+  组件自身零第三方依赖，包内不再有 `@deepseek-ai/*` 依赖树
+
+## 推荐安装（zip 渠道）
+
+1. 把压缩包解压到固定目录，例如：
+   `C:\Users\<你>\dsh-plugins\dsh-session-toolkit-0.1.0`
+   > DSH 以链接方式安装本地目录；安装后不要移动或删除这个目录。
+2. 在解压目录运行：
+
+   ```powershell
+   powershell -ExecutionPolicy Bypass -File .\install.ps1
+   ```
+
+3. 重启 DSH，或在插件页先把「会话功能增强」关闭再打开。
+4. 打开「插件 → 会话功能增强」，确认：
+
+   ```text
+   共 5 个 · 5 运行中
+   ```
+
+## 安装（npm 渠道）
+
+不改用 zip 时，这个脚本也能直接装：包里没有本地组件副本，它会自动从 registry 装。
+0.1.1 起一条命令就够（组件是 pack 的依赖）：
+
+```powershell
+& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add @funniki/dsh-session-toolkit
+```
+
+下面逐条版本等价，作为兜底（例如 profile 不是 hoisted 布局时）：
+
+```powershell
+$dsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
+
+& $dsh plugin --profile desktop add @funniki/dsh-session-toolkit
+foreach ($name in @(
+  "@funniki/dsh-session-toolkit-archived-session-delete",
+  "@funniki/dsh-session-toolkit-session-move",
+  "@funniki/dsh-session-toolkit-unsent-content-guard",
+  "@funniki/dsh-session-toolkit-session-history-search",
+  "@funniki/dsh-session-toolkit-auto-paste"
+)) {
+  & $dsh plugin --profile desktop add $name
+}
+```
+
+## 装完检查
+
+安装脚本在结束前会自动核对：bundle 已注册、6 个依赖已记录、profile 里没有重复的核心包。
+想再手动确认一遍：
+
+```powershell
+$profileDir = Join-Path $HOME ".dsh\profiles\desktop"
+Test-Path (Join-Path $profileDir "node_modules\@deepseek-ai\dsh-tools")  # 应为 False
+```
+
+## 使用入口
+
+- 已归档会话行悬停 → 红色删除按钮；会话菜单 →「删除已归档会话」
+- 会话「...」菜单 →「移动到工作区…」（需要至少两个工作区）
+- 输入框下方 →「未发送备份」胶囊
+- 输入框「搜索历史」或 `Ctrl+Shift+K`
+- 粘贴超过阈值的长文本 → 自动保存到工作区 `pastes/`，输入框留一张带预览的卡片
+
+## 数据位置
+
+- 删除/移动会话：`%USERPROFILE%\.dsh\session-workspace-move\`
+- 未发送内容备份：`%USERPROFILE%\.dsh\unsent-content\`
+- 长文粘贴阈值：`%USERPROFILE%\.dsh\auto-paste\user-config.json`
+- 卸载插件不会自动删除这些数据。