前言¶
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 的插件化方向,而是把多个会话侧能力放到同一个工具包里,便于统一安装、统一查看和统一排查。