dsh-session-hygiene

DSH PLUGIN工具与能力

仓库 liudapeng0311/dsh-session-hygiene · npm dsh-session-hygiene

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

为 DSH 侧边栏补齐会话删除、孤儿会话清理与工作区分组能力,删除的会话进入可恢复回收站。

一句话选型结论

按资料字段整理

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

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

安装

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

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-session-hygiene:为 DeepSeek Harness 补齐会话删除与工作区归类

  • 会话删除进回收站
  • 清理孤儿会话
  • 工作区分组归类
  • 回收站恢复或彻底删除

适用场景

存储文件读写

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

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

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

逐项检查结果

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),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

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

不太适合

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

同类对比

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

仓库档案

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

README 全文

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

dsh-session-hygiene

English | 中文

一个插件,补上 DSH 侧边栏的三个缺口:

  1. 会话只能归档,不能删除。「删除会话(移入回收站)」把日志移出会话
    存储放进回收站,而不是直接 unlink,所以还能还原。
  2. 删除工作区会把它的会话留在磁盘上。这些会话的 cwd 已经对不上任何
    工作区,侧栏没地方显示它们。设置 → 会话清理能把它们找出来,归档或
    移入回收站。
  3. 工作区没法分组。设置 → 工作区分类提供分类、侧栏分类标题、拖拽
    归组和折叠。

全部是增量改动:不替换、不隐藏任何自带行,也不重写这些组件以外的 DOM。

它出现在哪

位置 你会看到什么
会话行 ... 菜单 删除会话(移入回收站)
侧栏工作区列表 分类标题,拖拽归组
设置 → 会话清理 孤儿扫描、回收站、还原、彻底删除
设置 → 工作区分类 分类、归属、排序、标题开关

安装

从 npm 装,走 DSH 的 Plugins 页面,或者直接让 agent 装:

plugin_manager install_bundle dsh-session-hygiene

装本地 checkout 的话,传它的绝对路径:

plugin_manager install_bundle <当前 checkout 的路径>

宿主侧 JavaScript 不热重载:装完重启一次宿主。

删除一个会话

  1. 在侧栏指向某个会话,打开它的 ... 菜单。
  2. 选 删除会话(移入回收站)。
  3. 这一行立刻消失;数据是被移动了,不是被删除。

内部按这个顺序做:停掉正在跑的工作并隐藏该行 → 把它从所有工作区 detach 并
取消置顶 → 把 /sessions/// 重命名进回收站 → 记一条
preview → 发 api-session/removed,已经打开的页面不用刷新就会移除这一行。
投影缓存会保留,所以还原之后标题和开场提示都还在。

如果移动失败并提示 「会话数据仍被占用。先切到另一个对话,再回来删除。」,
说明还有别的视图开着这个目录:切到另一个对话再重试。移动失败时归档会回滚,
会话仍按原样显示。

清理被删除工作区遗留的会话

打开 设置 → 会话清理。页面打开就会扫描一次;重新扫描可以重来。

孤儿会话指的是磁盘上还在、但 header.cwd 对不上任何已注册工作区的会话。
每一行显示标题、开场片段、原本属于哪个工作区、目录名和体积。

  • 行内:移入回收站。
  • 批量:归档 N 项 —— 收进宿主自己的归档列表,会跳过子代理会话,因为
    它们通常由父会话持有。
  • 批量:全部移入回收站 —— 包含子代理,操作前要确认一次。

未挂载是另一类情况:会话的 cwd 对得上某个工作区,但那个工作区没把它
列进去,于是侧栏把它归到「未分组」。这类会话会在标签页上方单独出一条提示,
配一个 全部挂回 按钮——比直接删掉一个本身健康的会话更划算。

回收站:还原或彻底删除

回收站标签页列出已经移进去的内容。

  • 恢复会把目录重命名回它记录的原始路径,并按 cwd 重新挂回对应的工作区。
    如果原位置已经被占用,会拒绝操作(409)——先移走或删掉占位的东西。如果
    原工作区已经不存在了,会话会回来,但显示为未分组,因为已经没有东西持有它的
    cwd。
  • 彻底删除会删掉目录,并清掉它的投影缓存。这是唯一不可逆的操作,而且它
    每次都明确指名删哪些;需要再点一次确认。

批量操作对应 全部还原 和 全部彻底删除(后者要求确认条数)。

给工作区分组

打开 设置 → 工作区分类。

  • 新增分类,行内改名,用 上移 / 下移 调顺序,删除(被删分类
    下的工作区回到未分类)。
  • 用下拉框给工作区选分类,或者直接把侧栏的工作区行拖到分类标题上。
  • 保存并聚拢 会写入归属并重排工作区注册表,让同一分类的行连续;未分类的
    排在最后。宿主自带的行拖拽排序照常可用——这里只在保存时重排一次。
  • 清空归属 把所有工作区退回未分类,但保留分类本身。
  • 分类标题右侧的 + 会打开宿主的目录选择窗口,把选中的目录登记为工作区,
    直接归到这个分类下并聚拢到位。
  • 点分类标题可以折叠或展开,折叠状态会持久化。折叠时,分类下每个长列表末尾的
    展开其余 N 个会话 也会一并收起,所以折叠后屏幕上只剩分类标题。
    在侧边栏显示分类标题 可以整组隐藏标题,归属关系不受影响。

分类下的行会内缩一级,让标题看起来是它们的分组,而不是同级项。分类只有在它的行
连续成块时才会显示标题;被拆散的分类不显示标题,而不是把标题画到属于别处的
行上方。标题带和内缩都是插件自己加的改动,卸载时会一并还原,侧栏回到宿主原本
渲染的样子。

数据在哪

/storages/session-hygiene/
categories.json
trash/__/
entry.json
session.v4.jsonl.zstd ...

entry.json 记录 sessionId、cwd、from(原始目录)、title、preview、
createdAt、sizeBytes 和 deletedAt。它是这个插件唯一自己写的文件,也是
能还原的原因。

想手工清空回收站,直接删掉那棵目录树即可。投影缓存是故意在移入回收站时保留
的(它是派生数据,保留才能让还原后的会话仍然显示标题),彻底删除时才清掉。

卸载

在 DSH 的 Plugins 页面移除这个 bundle。侧栏会立刻失去分类带,也没有任何自带
行会停留在被改过的状态。

先把回收站清空或还原完。卸载后 /storages/session-hygiene/ 会留在
磁盘上,但已经在回收站里的会话不再有任何界面能还原它们——只能照着各自的
entry.json,手工把目录改回原路径。

已知限制

  • 孤儿判定是拿会话的 header.cwd 和注册表里记录的工作区目录做比较。如果一个
    会话的 cwd 在磁盘上被改过名,它会被判成孤儿,哪怕工作区其实还在。
  • 删除工作区时依然不会提示它还有多少会话;这个插件只能在事后、在设置里把它们
    列出来。想在删除那一刻拦截,就得接管 sidebar.workspaces,而那是宿主自己的
    single 槽。
  • 子代理会话会被列出并单独标记,归档 N 项 会跳过它们,批量移入回收站则
    包含它们。
  • 分类标题依赖行连续;把一行拖到两行之间时,它的分类是从上方标题推出来的,
    当一个分类只有一行时这只是个猜测。
  • 分类标题的 + 依赖宿主的原生目录选择能力(directoryPicker 的 native);
    只有浏览模式的 profile 会被拒绝并提示,不会打开浏览器里的选择器。
  • 宿主侧 JavaScript 不热重载:安装或更新后重启宿主。

开发

node tests/host-smoke.mjs

这个冒烟测试用真实的请求处理器,把一个临时 DSH_HOME 从头跑到
scan → trash → restore → purge,不会碰任何真实 profile。它通过 files 排除
在发布包之外。

维护者参考,各界面注册在这些位置:

槽 Id 用途
sidebar.workspaces.session.menu.item session-hygiene-trash 删除行,排在自带 Archive 正上方
settings.section session-hygiene 会话清理页
settings.section workspace-categories 分类页
settings.section.icon session-hygiene、workspace-categories 导航图标
sidebar.footer.action session-hygiene-labels 本身不渲染,只挂载画分类带的 DOM 观察器

常见问题

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

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

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

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

dsh-session-hygiene 安全吗?

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

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

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

dsh-session-hygiene 支持哪些 DSH 版本?

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

dsh-session-hygiene 需要什么运行环境?

Node.js >=20。环境不满足时安装会失败,建议先确认本机版本。

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

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

dsh-session-hygiene 有哪些功能?

会话删除进回收站、清理孤儿会话、工作区分组归类、回收站恢复或彻底删除。

这条记录的数据可靠吗?

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

工具与能力
按星标排序,可作替代方案

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 星

liudapeng0311 的其它插件

1 个

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