dsh-session-toolkit:把会话身份、提示词、自动恢复与 Web 重启等 DSH 本地插件合并安装

前言

DSH 的理念是「一切皆插件」,本地会话里常用的身份、提示词、恢复、重启、日志按钮和会话间消息,过去常被拆成多个本地插件分别维护。对使用 DeepSeek Harness 的开发者来说,这类能力单独装、单独配置、单独排查,成本并不低。

dsh-session-toolkit 是一个面向 DeepSeek Harness 的整合插件工具包,把六个本地插件能力合并成一个可安装的工具包。它当前版本为 0.1.4,适配 DeepSeek Harness dsh-v0.1.2-alpha.1,许可证为 MIT。社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,本文按社区插件介绍。

这是什么

dsh-session-toolkit 是 DeepSeek Harness 的整合插件工具包,合并会话身份、全局提示词、会话自动恢复、Web 重启、会话日志按钮重定位和会话间消息等本地插件能力。仓库地址在 Han-Yao94 的 GitHub 账号下;已核实资料中的 author 字段为 dsh-session-toolkit maintainers,因此本文只确认仓库来源,不额外推断个人维护关系。

它解决的问题很具体:把多个会话侧本地插件合并成同一个安装包,减少重复维护,并把会话身份、提示词、引用文件、自动恢复、Web 重启、日志按钮位置和会话间消息放进同一套插件能力里。

核心功能

会话身份

会话身份提供身份对话框和状态按钮。对话框中可用启用开关,并支持保存/重置、编辑默认、继承默认。

全局提示词

全局提示词在设置页提供 Global / Per workspace 选项卡,并注入对应系统提示词段。

工作区提示词

工作区提示词按活动会话 cwd 前缀匹配。多个匹配项同时命中时,选择最长路径。

引用文件

引用文件在每次组装时重新读取。读取失败时跳过该文件内容,并在 UI 中报告原因。

会话自动恢复

打开某个会话的自动恢复开关后,GUI 重启后自动恢复该会话。会话自动恢复的并发上限为 3,并隔离单项失败。

Web 重启

General settings 中点击 Restart service,触发 POST /api/restart 并显示进度。Web Restart 不触发 UAC 提示,重启脚本的提权分支不会被执行。

会话日志按钮重定位

插件包含会话日志按钮重定位能力,用于调整会话日志按钮的呈现位置。

会话间消息

会话间消息提供 send_to_session / list_sessions 工具和复制会话 ID 按钮。

安装与启用

插件以 dsh.bundle.patch 官方 bundle 形式发布。已核实资料中给出的安装命令入口是:

dsh plugin add

这条命令来自已核实资料。资料中未给出完整安装参数,本文不凭仓库名拼接安装参数。实际安装时,请以仓库 README 或 DSH 社区目录中给出的完整说明为准。

典型用法

下面按能力拆分,步骤都来自已核实能力说明。

配置会话身份

1、在会话身份相关入口打开身份对话框。
2、使用启用开关打开或关闭会话身份。
3、通过保存/重置、编辑默认、继承默认调整身份内容。
4、通过状态按钮查看当前状态。

配置全局与工作区提示词

1、进入设置页中的全局提示词相关入口。
2、在 Global / Per workspace 选项卡中分别配置全局提示词和工作区提示词。
3、会话组装时,按已核实说明注入对应系统提示词段。

使用工作区提示词匹配

1、配置工作区提示词。
2、活动会话按 cwd 前缀匹配工作区目录。
3、多个工作区同时匹配时,选择最长路径作为命中项。

使用引用文件

1、在提示词能力中引用文件。
2、每次组装时重新读取文件。
3、如果读取失败,跳过该文件内容,并在 UI 中查看失败原因。

启用会话自动恢复

1、选择需要恢复的会话。
2、打开该会话的自动恢复开关。
3、GUI 重启后,该会话按已核实说明自动恢复。
4、自动恢复过程受并发上限 3 限制,并隔离单项失败。

执行 Web 重启

1、进入 General settings
2、点击 Restart service
3、插件触发 POST /api/restart,并显示进度。
4、该过程不触发 UAC 提示,重启脚本的提权分支不会被执行。

使用会话间消息

1、通过复制会话 ID 按钮获取目标会话 ID。
2、使用 send_to_session 工具向目标会话发送消息。
3、使用 list_sessions 工具查看可寻址会话。

适用场景与注意

这个工具包适合正在使用 DeepSeek Harness,并希望在本地会话中统一管理身份、提示词、引用文件、恢复、重启和会话间消息的开发者。

使用前需要注意:

  • 当前版本为 0.1.4,适配 DeepSeek Harness dsh-v0.1.2-alpha.1
  • 许可证为 MIT
  • 插件以 dsh.bundle.patch 官方 bundle 形式发布。
  • 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
  • Web Restart 不触发 UAC 提示,重启脚本的提权分支不会被执行。
  • 引用文件读取失败会被跳过,不注入该文件内容。
  • 会话自动恢复并发上限为 3,并隔离单项失败。
  • 客户端若无法访问 schemastery,会优雅降级,但主机端仍做 schema 验证。
  • 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不要把插件包描述为官方应用商店内容。

目录与仓库

  • 社区目录:已核实资料未给出目录页 URL,本文不写入未核实地址。
  • GitHub 仓库:https://github.com/Han-Yao94/dsh-session-toolkit.git

经过上面的步骤,你可以先把 dsh-session-toolkit 当作一个本地整合包来评估:它不改变 DSH 的插件化方向,而是把多个会话侧能力放到同一个工具包里,便于统一安装、统一查看和统一排查。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜