Vim0x3c/dsh-session-manager 预览 preview

Vim0x3c/dsh-session-manager

Plugin插件 Native原生 ⭐ 5 MIT Sessions & Context会话与上下文

DeepSeek Harness 会话管理设置面板:列出本机全部会话(运行中/空闲/已归档),支持继续会话、预览大纲、删除会话

Project Overview项目介绍

This is a native session management plugin built exclusively for DeepSeek Harness (DSH), that adds full session management capabilities to DSH without requiring any modifications to the core DSH source code. To install the plugin, you first build a tarball locally with pnpm install and pnpm pack, then install the generated tarball to your DSH web profile using the dsh plugin command. After installation, you just need to restart the dsh web service and the plugin will be fully active. The plugin automatically adds the required loader entry to your DSH profile, so no manual configuration of patch files is needed.

Once activated, you can access the plugin from the DSH web UI under Settings > Sessions. It lists all your local sessions, running, idle, and archived, sorted by update time with clear metadata like title, status, and working directory. You can resume existing sessions, preview an outline of recent activity with message and tool call stats, and permanently delete any unwanted sessions. It supports batch deletion of multiple selected sessions, and automatically cascades deletion of all child subagents when you delete a parent session. This plugin is ideal for regular DSH users who accumulate many sessions over time and need an easy way to clean up old or unused sessions.

This plugin targets DSH version 0.1.0-rc.8, and supports both of DSH’s official persistence backends: JSONL and SQLite. Custom persistence backends require a delete method implementation to work with the plugin, and bulk deletion requires an atomic deleteMany method. Delete operations are only allowed from loopback addresses like localhost, so delete options won’t show when accessing DSH over a local network. The plugin is released under the permissive MIT open source license, and has a few minor known limitations that do not block core functionality. One limitation is that session outlines only cover the recent history window, not the full session log.

这是一款专为DeepSeek Harness开发的原生会话管理插件,支持对DeepSeek Harness本地所有会话进行管理,包括运行中、空闲以及已归档会话,提供会话继续、大纲预览和永久删除等核心功能。插件不需要修改DeepSeek Harness源码,安装后仅需重启dsh web即可使用,包内同时包含浏览器端管理面板和Host端RPC服务能力。

用户安装完成后,可打开DeepSeek Harness的「设置 -> 会话」页面使用,完整会话列表按更新时间排序展示,可查看每个会话的标题、状态、工作目录等信息。支持多选批量永久删除会话,删除父会话时会自动级联删除所有受管子会话,还支持大纲预览查看近期活动统计,适合需要定期整理清理DeepSeek Harness会话的用户。

插件兼容DeepSeek Harness 0.1.0-rc.8版本,支持官方JSONL和SQLite两种持久化后端,仅允许localhost回环地址调用删除接口,局域网访问仅显示继续和大纲功能。插件采用MIT许可证开源,目前存在大纲仅统计近期日志、不清理归档会话惰性条目等已知限制,删除操作不可恢复。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Vim0x3c/dsh-session-manager

把 Vim0x3c/dsh-session-manager 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-session-manager

English | 中文

一个可直接安装的 DeepSeek Harness 会话管理插件。它列出本机全部已物化会话,包括运行中、空闲和已归档会话,并提供继续、大纲和永久删除。

关键说明

不需要修改 deepseek-harness 源码。

从 0.2.0 起,包内同时包含:

  • 浏览器端会话管理面板;
  • Host 端 session.delete RPC;
  • 实时 Agent 停止与 Session 脱离兼容逻辑;
  • JSONL 和 SQLite 持久化删除实现;
  • loopback、Host、Origin 和 Fetch Metadata 安全校验。

用户只需安装本插件并重启 dsh web。不需要复制代码到 harness,不需要修改 SessionsApi、AgentLoop、SessionPersistence 或任何 harness 文件。

功能

  • 完整会话列表:实时、冷会话、已归档或未归档会话,按更新时间展示标题、状态、工作目录等信息。
  • 继续会话:通过浏览器 sessions 服务打开已有对话。
  • 大纲预览:在浏览器内折叠 session.history 尾部窗口,展示轮次、用户/助手消息数及工具调用统计。
  • 永久删除:先停止并等待目标 Agent 静默,再重新读取 live 与 durable 会话树,预检通过后删除存储数据。删除会话时会级联删除其全部 origin: subagent 受管子会话(最深优先);普通 fork 自身保留,但会继续遍历其下的受管子会话。
  • 多选批量删除:列表左侧复选框中可多选,工具栏一次性删除全部选中项。仅"独立删除目标"可勾选(普通会话与孤儿受管子会话;有父会话的受管子会话随父级联删除,不单独出现)。批量删除逐个独立走完整安全删除流程,某个删除失败不会回滚已成功的,并会在确认框列出剩余失败项以便重试。
  • JSONL:删除该会话拥有的整个目录,包括日志和同目录快照。
  • SQLite:在当前后端连接中执行事务删除,事件行通过外键级联清理。
  • 未来兼容:若后续 harness 原生提供 AgentLoop.stop 或 SessionPersistence.delete,插件优先调用原生能力。

普通 fork 可以独立删除。origin: subagent 的受管子会话随仍存在的父会话级联删除:界面不提供子会话自己的删除按钮,删除父会话时确认框会提示将一并删除的子会话数量;直接对子会话发起删除请求仍返回 agent-busy。如果父会话已经不存在,该行会标记为孤儿并显示删除按钮,允许直接清理。删除前会先预检整棵子树,已知失败不会先删除其他成员。

兼容范围

  • 目标版本:DeepSeek Harness 0.1.0-rc.8。
  • 已支持官方持久化后端:session-persistence-jsonl、session-persistence-sqlite。
  • 自定义持久化后端必须自行提供 delete(id);如果需要级联删除多个 durable 会话,还必须提供原子 deleteMany(ids),否则插件会明确拒绝该级联请求,不会逐个删除造成半删。
  • 删除端点仅允许 loopback authority,例如 localhost、127.0.0.0/8、[::1];通过局域网地址打开页面时只显示继续和大纲。

Host 实现针对 rc.8 缺失的三处能力做兼容补齐,并使用 rc.8 的内部 lifecycle/coordinator 结构。因此升级 harness 后应先运行本仓库测试;当上游提供原生接口时,插件会优先走原生接口,减少对兼容层的依赖。

安装

先在插件仓库构建 tarball:

pnpm install
pnpm pack

再将生成的 dsh-session-manager-0.2.2.tgz 安装到 web profile:

dsh plugin --profile web add -w ./dsh-session-manager-0.2.2.tgz

安装后重启 dsh web。

-w 是必须的:profile 目录带有 pnpm-workspace.yaml,裸 add 会触发 ERR_PNPM_ADDING_TO_ROOT。建议发布构建后的 tarball;从 git URL 安装拿到的是源码,目标机器还需要完成构建,容易缺少 lib/ 产物。

本包的 dsh.bundle.patch 自动插入一个 dsh-session-manager Loader 行。该行同时激活 Host 插件和 dsh.client 浏览器插件,peer 依赖从 dsh 应用闭包解析。安装者不需要手工编辑 profile 的 cordis.patch.yml。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-llm-oauth 下一个 Next dsh-codex-web-search-mcp →