dsh-session-batch-manager

DSH PLUGIN工具与能力

仓库 mars401/dsh-session-batch-manager · npm dsh-session-batch-manager

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 补上会话批量管理能力:侧边栏多选会话批量归档、取消归档与删除,并提供全屏会话面板查看模型、token 用量与上下文压力。

一句话选型结论

按资料字段整理

dsh-session-batch-manager 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-11-05 创建于 2026-11-03
README 12.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:mars401/dsh-session-batch-manager
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-session-batch-manager可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-session-batch-manager:DeepSeek Harness 的会话批量管理与用量面板

  • 侧边栏多选批量归档与删除
  • 运行中会话停止并归档重试
  • 全屏会话管理仪表盘
  • token 用量与缓存读写统计
  • 上下文压力进度条与筛选

适用场景

存储

上游标签

batch-operationscordisdeepseek-harnessdshdsh-pluginsession-managertoken-usage

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-batch-manager当前 L5 · 运行验证通过 低风险 1 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方mars401仓库 dsh-session-batch-manager · 默认分支 main
分类工具与能力storage
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言TypeScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-03 · 2026-11-05最后推送 2026-11-05
本站收录2026-11-03首次进入本站目录的时间

README 全文

12.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-session-batch-manager — DeepSeek Harness 会话批量管理与会话管理面板

English | 中文


0 简介

DeepSeek Harness(DSH)会话批量管理:侧栏多选会话,批量归档 / 恢复 / 删除;另有全屏会话管理面板,可视化每个本地会话的模型、token 消耗、缓存读写与上下文占用。

DSH GUI 原生只有单个会话的归档,没有任何删除入口。本插件补上:

  • 侧栏行首选择框,点击底部「批量管理」开关后出现(退出模式选中保留,任一批量操作完成后自动清空);
  • 浮动工具条:全选 / 清空 / 归档 / 删除;归档遇到运行中会话给「停止并归档」一键重试;物理删除全链路(宿主路由 + 确认对话框 + 所有已连接 GUI 立即掉行);
  • 会话管理面板:6 列表格(模型、token 四桶、缓存读写、上下文进度条)、两档过滤(主会话 / 已归档)与树形视图(子代理折叠在主会话下)、fork 独立树根、基于血统的归档/删除级联,以及召回横幅与清单(将未分组会话重新挂回工作区)。

已在 DSH 0.2.2-alpha.2(Web UI,开发沙箱)完成实际测试,当前验证范围见「6 兼容性」。

1 演示

# 截图 说明
1 侧栏批量管理模式:选择框出现,可多选行,底部出现浮动工具条。
2 删除确认对话框,列出待删除会话后再执行物理删除。
3 全屏会话管理面板:6 列表格(模型、token 消耗、缓存、上下文压力),渐进加载,面板内批量操作。
4 四个过滤 chips(全部 / 主会话 / 子代理 / 已归档)带实时计数,点击过滤表格。
5 Token 消耗列的分桶 tooltip 明细:非缓存输入、缓存读/写、输出分项。

2 功能

2.1 侧栏批量管理

  • 选择模式:侧栏底部的「批量管理」开关。选择框默认不显示,进入选择模式后才出现。模式开启期间,点击行任意处 = 切换选中(打开会话、双击重命名、拖拽排序、Enter/Space 都被接管)。退出模式后选中保留——行高亮与工具条计数不丢;任一批量操作(归档 / 恢复 / 删除)完成后自动清空选中,手动「清空」亦可。
  • 浮动工具条(侧栏底部):有选中即显示,不限于选择模式。包含选中计数、全选、清空、归档(全部选中项已归档时切换为恢复)、删除(先确认)与退出(仅选择模式)。
  • 停止并归档重试:批量归档遇到有运行中工作的会话时单独归类报告,结果通知提供「停止并归档 N 个运行中的会话」一键重试——与原生 DSH 归档对话框同一升级路径。
  • 批量删除:确认对话框列出目标会话 → 宿主路由物理删除其 JSONL 日志目录 → 广播 api-session/removed,所有已连接 GUI 立即掉行。已删行另由客户端墓碑兜底隐藏(见「5 安全说明」)。
  • 右键菜单入口(可选贡献):带右键菜单系统的 DSH 版本自动出现「批量选择会话」;0.2.2-alpha.2 没有该服务,入口安静缺席,其余功能不受影响。

2.2 会话管理面板

侧栏底部的仪表盘图标按钮打开全屏、只读的「会话管理」面板,扫描全部本地会话:

  • 6 列表格:选择框 / 会话(标题 + 运行中 / 子代理 / 已归档 / 置顶徽标 + 可折叠树) / 项目 / 模型(provider/model)/ Token 消耗(四桶合计 + 分桶明细 tooltip)/ 缓存读 · 写 / 上下文百分比(进度条,≥ 90% 警告色)。
  • 两档过滤:主会话(默认,树形视图,子代理嵌套在父会话下)/ 已归档,计数实时更新。fork 会话为独立树根,拥有完整操作权限。切换过滤自动清空面板选择集(与侧栏选择集相互独立)。
  • 面板内批量操作:归档 / 恢复 / 删除复用侧栏同一核心管线,选择集独立。
  • 渐进加载:首扫 O(全量日志)——先骨架行,随后行自新→旧追加、pending 计数递减、顶部细进度条推进;此后仅 revision 变更过的会话才重放日志。stats 路由立即响应(扫描后台进行),不阻塞等待。
  • 5 秒轮询(面板打开期间;标签页隐藏时暂停,statsPollIntervalMs 可配置);面板关闭后宿主零开销。
  • 每会话错误隔离:损坏的会话日志显示为带警告图标的行(数值列显示「—」),不炸整表。宿主 sessionQuery 服务不可用时降级为「仅列表 + 批量操作」。

3 UI入口

两个入口都是 DSH 侧栏底部的按钮:

  • 批量管理(清单图标):切换侧栏会话列表的选择模式。
  • 会话管理(仪表盘图标):打开 / 关闭全屏管理面板。

选择模式开启期间,只要有行被选中,浮动工具条即出现在侧栏底部。

4 安装

仓库随源码提交了构建产物 lib/(已入库),安装无需执行构建。

4.1 通过 CLI 从 GitHub 安装

dsh plugin --profile web add github:mars401/dsh-session-batch-manager

安装后重启 DSH Web。若浏览器仍加载旧的客户端代码,可使用 Ctrl+Shift+R 强制刷新。

验证安装:

curl -s http://127.0.0.1:<你的-dsh-web-端口>/dsh-session-batch-manager/v1/status
# {"ok":true,"service":"dsh-session-batch-manager","version":"0.2.0"}

> desktop profile 由官方 Desktop 客户端管理,普通 dsh CLI 不用于修改该 profile。Desktop 用户请通过客户端内的插件安装。

4.2 本地开发 / 测试

pnpm install
pnpm typecheck          # tsc --noEmit
pnpm build              # esbuild → lib/host/index.js + lib/client.js
node --test tests/stats.test.mjs

随后同样方式安装本地 checkout,用仓库路径代替 GitHub 规格:

dsh plugin --profile web add <本仓库路径>

对于 Client 端代码,在 HMR 正常工作的情况下,保存修改后可以自动重新加载;否则刷新页面或重启客户端。修改插件依赖、package.json、bundle 配置等安装或加载相关内容后,建议重新安装插件或重启对应客户端。

4.3 配置

可选覆盖(bundle 层 cordis.patch.yml):

键 默认 说明
routeBase /dsh-session-batch-manager/v1 宿主路由前缀;经 index-inject 注入页面全局 window.__DSH_SESSION_BATCH_MANAGER__
maxBatchSize 200 单次删除请求的会话数上限
trustedHosts [] Host 栅栏额外信任的权威;仅非回环部署需要
statsPollIntervalMs 5000 面板打开期间的 stats 轮询间隔(ms)
statsSweepConcurrency 4 冷会话观察并发上限

5 安全说明

删除逐会话独立判定,单个失败不影响其余。按顺序:

  1. 拒绝有运行中工作的会话(active):进行中的轮次、subagent、后台任务、定时器——先归档(可停止任务)再删。仅挂载于内存但空闲的 live 会话放行(与原生归档同语义,否则 GUI 打开过的会话重启前永远删不掉)。
  2. 物理删除:经持久化层定位 JSONL 日志目录(延迟落盘的 pending 会话先强制物化);目录名必须等于会话 id 的编码形式且真包含于持久化根(双重校验防误删),然后递归删除。
  3. 注册表记账(尽力而为):live 会话走归档集墓碑——活动视图立即隐藏,仍打开的旧标签页由原生「已归档」门拦截。冷会话移出归档集 / 置顶集并从工作区记录摘除。
  4. 客户端墓碑:删除成功的 id 持久化到浏览器 localStorage,跨刷新从全部视图(含归档视图)过滤,宿主重启前已删 live 会话的残行无法复活。
  5. 广播与幂等:广播 api-session/removed 让 GUI 立即掉行;此前已删 / 幽灵行目标同样按成功报告——目标状态已经达成。

浏览器信任栅栏(对齐 dsh /api 的信任模型):删除路由仅接受携带插件专属 x-dsh-session-batch-manager 自定义头的 POST;Host 必须是回环拼写 / 绑定地址 / trustedHosts 之一;Sec-Fetch-Site: cross-site 一票否决;Origin 必须同权威;OPTIONS 一律 403、从不发 CORS 头——恶意网页无法跨源触发删除(自定义头触发 preflight 即被拦截)。stats 路由只读,cache-control: no-store、不发 CORS 头,载荷不含标题与密钥——只有 id、模型名和 token 数。

已知边界:

  • 删除只清理会话日志目录与注册表记账;附属状态(KV 存储条目、计划任务注册、附件缓存等)不在 v0.1 范围内——目标会话已按第 1 步排除运行态,残留条目惰性且无害。
  • subagent 会话不进侧栏「全选」(与原生列表行为对齐),但可单独点选删除。
  • 搜索结果列表的行不渲染选择框(宿主没在该视图开放行操作槽);批量操作面向主列表。
  • 面板的上下文百分比为参考值(contextPressure 非原子观测),切换模型后可能短暂滞后,tooltip 已注明。
  • 面板 tooltip 为纯文本(dsh Tooltip 原语仅支持字符串 label);分桶明细以换行分隔的键值对呈现。

6 兼容性

DeepSeek Harness (DSH) dsh-session-batch-manager 验证环境
>=0.2.1 0.2.0 Web UI(开发沙箱 0.2.2-alpha.2——树形看板端到端验证通过;召回段 GUI 验证进行中);桌面 App 0.2.1-rc.5——耦合点静态核验通过,运行时待确认

插件在 engines 中声明 dsh: ">=0.2.1"。0.2.2-alpha.2(开发沙箱、Web UI)已完成端到端验证。桌面 App 0.2.1-rc.5:七个耦合点(槽位、服务、事件、sessionQuery)均在 app bundle 中存在——grep 静态确认,运行时验证待补。核心功能(批量归档/删除、侧栏选择框)使用自 0.2.1 起稳定的 API。会话管理面板的统计功能需要 sessionQuery 服务,在不提供该服务的版本上面板自动降级为「仅列表 + 批量操作」(见 degraded 标记)。

无右键菜单服务的 DSH 版本上右键菜单入口安静缺席,见「2.1」。

本插件是 Cordis 插件,运行时零依赖:宿主半为纯 ESM bundle,浏览器半经 DSH 模块加载器装载。

7 开发

  • lib/host/index.js 是宿主侧 ESM 插件(删除路由、stats 路由、index-inject 配置发布);lib/client.js 是客户端 UI bundle。两者均已入库,安装无需构建;改源码后用 pnpm build 重建。
  • 提交修改前的质量门:pnpm typecheck、pnpm build、node --test tests/stats.test.mjs。
  • 源码布局:src/host/(宿主半:路由、统计聚合器、信任栅栏、结构化类型)、src/client/(浏览器半:批量操作、状态存储、管理面板与组件)、tests/(宿主单元测试)、docs/(设计 / UI 规格 / 评审 / 测试文档)。
  • 与宿主的耦合点(升级 dsh 时复核):行 DOM div[data-row-key^="session:"];槽位 sidebar.workspaces.session.row.action、sidebar.footer.action、shell.overlay;客户端服务 sessions / workspaces / locale + 可选 contextMenus;宿主服务 sessions / sessionPersistence / workspaceRegistry / webServer;事件 webserver/index-inject、workspace/session-activity、api-session/removed;归档拒绝判别 error.name === 'WorkspaceArchiveError' 且 rpcError.code === 'workspace/session-active'。完整论证见 docs/。
  • 稳定 CSS 类名契约:.dsh-batch-bar 为对外稳定类名(浮动批量工具条),共存插件可引用(如 z-index 或可见性规则),升级时保持兼容。.dsh-batch-footer(侧栏入口按钮)同为稳定类名。
  • 发布记录见 CHANGELOG.md。

8 致谢

  • 感谢 DeepSeek Harness 团队提供的平台与插件 API。
  • README 结构参考了 dsh-session-manager。
  • 感谢每一位安装和使用 dsh-session-batch-manager 的用户,也感谢提交 Issue 与 Pull Request 帮助改进本插件的朋友们。

9 开源许可

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-session-batch-manager 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:mars401/dsh-session-batch-manager` 即可。对应的 npm 包名是 `dsh-session-batch-manager`。

dsh-session-batch-manager 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-session-batch-manager 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-session-batch-manager 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-session-batch-manager 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-session-batch-manager 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-session-batch-manager 有哪些功能?

侧边栏多选批量归档与删除、运行中会话停止并归档重试、全屏会话管理仪表盘、token 用量与缓存读写统计、上下文压力进度条与筛选。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。