npm - @funniki/dsh-session-toolkit - Versions diffs - 0.1.0 → 0.1.2 - Mend

@funniki/dsh-session-toolkit 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/LICENSE +21 -21
package/README.md +51 -51
package/cordis.patch.yml +26 -26
package/icon.svg +11 -11
package/install.ps1 +44 -34
package/lib/index.js +13 -13
package/locale/en.json +6 -6
package/locale/zh.json +6 -6
package/package.json +8 -1
package//345/256/211/350/243/205/350/257/264/346/230/216.md +100 -89

package/LICENSE CHANGED Viewed

@@ -1,21 +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.
+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 CHANGED Viewed

@@ -1,51 +1,51 @@
-# 会话功能增强 · 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 保留上游许可证和第三方声明，随组件一起分发。
+# 会话功能增强 · 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 CHANGED Viewed

@@ -1,26 +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
+# 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 CHANGED Viewed

@@ -1,11 +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>
+<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 CHANGED Viewed

@@ -4,17 +4,19 @@ param(
 	[switch]$SkipChecks
 )
-# Installs dsh-session-toolkit and its five components into one DSH profile.
+# Installs the pack into one DSH profile, one command, both channels.
 #
-# Works for BOTH distribution channels from the same script:
-#   * extracted zip  — the five components sit in ./node_modules/ and are
-#                      installed from there (link:, keep this folder in place);
-#   * npm package    — no bundled copies are present, so the published
-#                      @funniki/dsh-session-toolkit-* names are installed from
-#                      the registry instead.
+# 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).
 #
-# Six installs are required either way: a bundle row resolves its `name` from the
-# PROFILE root, so the pack alone leaves all five rows unable to import.
+# 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"
@@ -42,7 +44,6 @@ if (-not $dsh) {
 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."
 }
@@ -56,58 +57,67 @@ function Add-ProfilePackage {
 	}
 }
-# The pack itself: this folder when it is a local package, the registry otherwise.
-if ((Get-Content -LiteralPath (Join-Path $pluginRoot "package.json") -Raw | ConvertFrom-Json).name -eq $packName) {
+# 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) {
-	$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 (-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 into profile '$Profile' (post-install checks skipped)."
+	Write-Host "Installed $packName into profile '$Profile' (post-install checks skipped)."
 	return
 }
-$dshHome = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $HOME ".dsh" }
-$profileDir = Join-Path (Join-Path $dshHome "profiles") $Profile
 $profileManifestPath = Join-Path $profileDir "package.json"
-$lockfilePath = Join-Path $profileDir "pnpm-lock.yaml"
 if (-not (Test-Path -LiteralPath $profileManifestPath)) {
 	throw "Profile manifest not found: $profileManifestPath"
 }
 $manifest = Get-Content -LiteralPath $profileManifestPath -Raw | ConvertFrom-Json
-$bundles = @($manifest.dsh.profile.bundles)
-if ($bundles -notcontains $packName) {
+if (-not (($manifest.dsh.profile.bundles) -contains $packName)) {
 	throw "Profile did not register $packName as a bundle."
 }
 foreach ($component in $components) {
-	if (-not $manifest.dependencies.PSObject.Properties[$component]) {
-		throw "Profile dependency was not recorded: $component"
+	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.0: no Harness core copy inside the profile.
-$duplicateCore = Join-Path $profileDir "node_modules\@deepseek-ai\dsh-tools"
+# 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."
 }
-if ((Test-Path -LiteralPath $lockfilePath) -and
-	((Get-Content -LiteralPath $lockfilePath -Raw) -match "(?m)^\s*'@deepseek-ai/dsh-tools@")) {
-	throw "pnpm-lock.yaml still resolves @deepseek-ai/dsh-tools at the profile root."
-}
 Write-Host ""
-Write-Host "Installed $packName and all five components into profile '$Profile'."
+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 CHANGED Viewed

@@ -1,13 +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 {};
+/**
+ * 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 CHANGED Viewed

@@ -1,6 +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)."
-  }
-}
+{
+  "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 CHANGED Viewed

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@funniki/dsh-session-toolkit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",
@@ -28,6 +28,13 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@funniki/dsh-session-toolkit-archived-session-delete": "^0.1.2",
+    "@funniki/dsh-session-toolkit-auto-paste": "^0.1.2",
+    "@funniki/dsh-session-toolkit-session-history-search": "^0.1.2",
+    "@funniki/dsh-session-toolkit-session-move": "^0.1.2",
+    "@funniki/dsh-session-toolkit-unsent-content-guard": "^0.1.2"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"

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

@@ -1,89 +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\
-```
-必须同时把这五个组件加入 profile 依赖。安装脚本已经处理了这一步。
-## 系统要求
-- 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 装
-`@funniki/*` 的六个包。手动版本是逐条执行：
-```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`
-- 卸载插件不会自动删除这些数据。
+# 会话功能增强（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`
+- 卸载插件不会自动删除这些数据。