会话管家与控制台 Gcd1949/dsh-tools

dsh-tools

为 DeepSeek Harness 定制的实用工具集。

仓库内容

| 目录 | 说明 |
| session-manager-plugin/ | dsh 会话管理插件（/sessions 命令：列出 / 删除聊天记录） |
| dsh-control-panel/ | Windows 图形控制面板（一键启动 / 停止 dsh web 服务） |

项目背景

本机使用免费的 Qwen3.5-4B 作为主模型、glm-4-flash 兜底的 dsh 环境。日常使用中发现两个需求：控制 dsh web 服务的开关、管理积累的聊天会话记录。因此开发了这两个小工具。

环境前提

以下为本工具集正常工作所需的共同前提：

| 项 | 要求 |
| 操作系统 | Windows（控制面板为 WinForms，需 .NET Framework 4.x，系统自带） |
| Node.js | 已安装并加入 PATH（node --version 可执行） |
| dsh | 通过 npm 全局安装：npm i -g @deepseek-ai/dsh |
| dsh 数据目录 | 默认 ~/.dsh（可用环境变量 DSH_HOME 覆盖） |

兼容性说明：两个工具均不写死安装位置。控制面板会按环境变量 -> where node -> 常见目录 -> 回退默认 自动探测 node 与 dsh 的路径；插件通过 import.meta.url 自动识别自己所挂载的 preset，并在加载时输出自检日志，
dsh 升级导致存储结构变化时会打印明确提示（而非静默失败）。

session-manager-plugin

dsh 会话管理命令插件。提供 /sessions 命令，支持列出全部会话和批量删除（软删除）。

功能

- /sessions 列出全部会话：标题、工作区、创建时间、大小、归档 / 当前状态
- /sessions delete <编号或id> [<编号或id> ...] 删除一个或多个会话

特性

- 软删除：会话目录移动到 <DSH_HOME>/.session-trash/，可随时找回；彻底清除需手动删除该目录
- 命名兼容：同时兼容 session-<uuid> 与裸 <uuid> 两种会话目录 / 索引键命名，不产生幽灵会话
- 三处联动清理：删除时会话目录 + workspace.json + session_projcache.json 同步更新
- 当前会话保护：正在使用的会话禁止删除

安装

以默认 preset anchored-standard 为例（~/.dsh/.agent-presets/anchored-standard/）：

1. 将 session-manager.mjs 复制到该 preset 目录下，与 agent.cordis.yml 同级；
2. 在该 preset 的 agent.cordis.yml 中追加注册项：

- id: session-manager
name: ./session-manager.mjs

3. 重启 dsh 后，日志会输出 session-manager: loaded from preset "anchored-standard" 即安装成功；若出现 WARNING，按提示修正插件位置或注册。

插件会自动识别被挂载到哪个 preset，无需修改代码；若 dsh 升级导致存储结构变化，会在日志中给出明确告警。

存储结构（插件直接操作的文件）

<DSH_HOME>/sessions/<工作区编码>/session-<uuid>/session.jsonl.zstd # 会话正文 <DSH_HOME>/storages/workspace.json # 工作区/归档归属 <DSH_HOME>/storages/session_projcache.json # 会话标题/统计缓存

dsh-control-panel

Windows 图形控制面板，一键启动 / 停止 dsh web 服务。C# WinForms 单文件程序。

功能

- 打开：启动 dsh web（node bin.js web，监听 3080），输出重定向到 ~/.dsh/logs/
- 关闭：通过 taskkill /T /F 结束监听 3080 的进程树
- 状态：每秒自动刷新，显示运行中 / 未运行 / 正在启动 / 启动失败

状态机

打开 -> 正在启动... -> 运行中 (PID xxx) 启动于 HH:mm:ss -> 启动失败（进程已退出 | 30 秒未就绪）关闭 -> 正在停止... -> 未运行

- 已运行时再次点击"打开"：显示"已在运行"，不会重复拉起进程
- 单实例：重复双击不会打开多个面板窗口
- 已提权（manifest requireAdministrator）：双击即请求管理员权限，保证有权限 taskkill 以管理员身份启动的 node 进程

路径探测（兼容多种安装方式）

面板不再写死 node / dsh 的安装路径，启动时自动探测：

- node.exe：DSH_NODE 环境变量 -> where node -> 回退 C:\Program Files\nodejs\node.exe
- dsh bin.js：DSH_DSH_BIN 环境变量 -> 基于 node 目录的常见布局（node_modules\@deepseek-ai\dsh 或 node_global\node_modules\@deepseek-ai\dsh）-> npm root -g -> 回退默认

因此以下环境均可直接使用：默认 npm 全局安装、自定义 npm prefix（如 node_global）、 nvm / nvm-windows 多版本、或通过环境变量显式指定（适合 dsh 装在非标准位置的场景）。
找不到时会明确提示"可设置环境变量 DSH_NODE / DSH_DSH_BIN"。

编译

使用 .NET Framework 4.x 自带编译器（无需 SDK）：

csc /nologo /target:winexe /codepage:65001 /win32manifest:app.manifest ^
/out:dshf-fixed.exe /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll ^
MainForm.cs Program.cs

（csc.exe 位于 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\）

许可

个人工具，仅供学习参考。