dsh-session-delete

DSH PLUGIN记忆与知识

仓库 147-sys/dsh-session-delete

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 会话侧栏增加「删除会话」操作,只删当前工作区会话并多重校验,绝不触碰记忆数据。

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:147-sys/dsh-session-delete
  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 包名未发布到 npm可用 npm view 查看包信息

能做什么

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

dsh-session-delete:为 DeepSeek Harness 侧栏增加会话删除入口

  • 侧栏一键删除会话
  • 五道安全校验防误删
  • 记忆路径双向重叠拒绝
  • 运行中会话先停止再删
  • 墓碑机制防会话复活

适用场景

存储文件读写记忆

上游标签

deepseek-harnessdshdsh-pluginsessionworkspace

验证等级与安全审查

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-delete当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

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

README 全文

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

dsh-session-delete

> 安装见 INSTALL.md,删除边界与安全校验见 PRIVACY.md。

为 DeepSeek Harness(DSH)会话侧栏的「…」菜单增加删除会话操作:只删除当前工作区下的会话,先停止运行中的会话,再解绑工作区记账、删除会话日志目录、清理投影缓存,并立即刷新侧栏列表。

  • 只删一个会话 —— 唯一的递归删除目标就是该会话自己的目录
  • 五道安全校验 —— 与记忆路径双向重叠即拒绝
  • 墓碑机制 —— 防止宿主内存里的活体会话把已删的行「复活」

记忆插件的存储数据绝不会被触碰:插件只对 ~/.dsh/sessions// 这一个会话自己的目录做递归删除,从不递归删除工作区目录;每个删除目标在删除前都会与记忆路径集合做双向重叠检查,一旦发现重叠就直接拒绝。

安装

方式一:dsh plugin(Web / TUI profile)

dsh plugin --profile  add link:<本仓库克隆到的绝对路径>

> 桌面版(desktop profile)由 Electron 独占管理,dsh plugin --profile desktop add 会被拒绝,请用方式二或 GUI。

安装后重启 DSH(或由桌面版热加载)即可在会话行的「…」菜单看到「删除会话」。

方式二:GUI 插件管理器 / plugin_manager 工具

把插件的绝对路径作为安装 spec:

<本仓库克隆到的绝对路径>

插件包声明了 dsh.bundle.patch 与 dsh.client.platform = "web",安装时会被加入 profile 的 bundle 列表。

> 本仓库不包含 node_modules。安装前请在插件目录执行 pnpm install --ignore-scripts(只依赖 @deepseek-ai/schemastery 及其两个小依赖,用于生成配置表单)。

使用

  1. 在左侧会话列表中,把鼠标移到某个属于工作区的会话行上,点「…」。
  2. 选择「删除会话」。
  3. 确认对话框会显示:会话名、所属工作区、将被删除的日志目录、投影缓存与会话列表记账的清理说明,以及受保护的记忆路径数量。
  4. 若会话正在运行,对话框会显示红色警告,确认按钮变为「停止并删除」:先停止当前工作(本轮对话会中断),再删除会话。
  5. 删除成功后该行立即从当前工作区消失,无需手动刷新页面。

不属于任何工作区的「未分组」会话不会显示删除入口——本插件只处理工作区会话。因此,如果删除后的行显示在
“未分组”下,它已经不再受工作区记账管理,也就没有「删除会话」入口;这通常意味着它是一次旧版本删除的残留
(新版会保留归档标记把该行隐藏),完全重启 DSH 后就会消失。

记忆数据保护

默认保护以下路径(存在与否都会参与重叠检查):

来源 路径
默认 $DSH_HOME/memory
默认 $DSH_HOME/.dsh-memory(灵枢记忆)
默认 $DSH_HOME/memories
环境变量 $DSH_MEMORY_DIR
记忆插件配置 memoryDir / dbFile(从 profile 与插件包的 cordis.patch.yml 读取)
工作区 /对话记忆、/记忆、/.dsh-memory、/memories
用户配置 memoryPathsToExclude 的每一项

安全校验(lib/paths.js 的 inspectDeletionTarget):

  1. 目标目录名必须正好等于 encodeSegment(sessionId);
  2. 目标必须严格位于 /sessions 之内(永远不是 sessions 根目录本身);
  3. 目标不能是符号链接/联接点(符号链接只 unlink,绝不 follow);
  4. 目标的 realpath 仍必须位于 sessions 根的真实路径内;
  5. 目标与任一受保护路径不得相等、不得互相包含。

任何一项不满足都会拒绝删除并给出明确错误,不会静默跳过。

配置 memoryPathsToExclude

如果记忆插件把数据放在上述默认路径之外,可在 profile 的 cordis.patch.yml 里追加:

- id: session-delete
name: dsh-session-delete
config:
memoryPathsToExclude:
- "D:\\memory-store"
- "$DSH_HOME\\custom-memory"
- "对话记忆/长期"

支持绝对路径、~、$DSH_HOME / ${DSH_HOME} / %DSH_HOME% / $HOME,以及相对于所属工作区目录的路径。该选项同时出现在 DSH 的插件配置表单中(schemastery schema),也可以直接写进 profile 的 cordis.patch.yml。请不要把整个用户目录或 $DSH_HOME 设为排除项——那会让所有会话目录都被判定为“位于记忆路径内”而拒绝删除。

删除链路

停止运行中会话并归档(archiveSession + stopActivity,并等待 Agent 离开 running)
→ 写入活体缓冲事件(sessions.flush)
→ 删除该会话的日志目录(唯一递归删除目标,带 EBUSY/EPERM 退避重试)
→ 清理投影缓存(session_projcache*/sessions/.json + 旧版总表项)
→ 验证性复查(删除后 300ms 再检查一次)
→ 文件清理完整时:解绑工作区记账(entity.detachSession),保留归档标记作为“墓碑”
→ 文件清理不完整时:取消归档并保留工作区记账,让该行仍可见、可重试
→ 复活守卫(约 2 分钟,指数退避;被迟到写入重建的目录会被再次删除)
→ 客户端 handleSessionRemoved + 不重新拉取列表(重新拉取会让宿主仍持有的活体会话重新出现)

已知限制:宿主内存中的活体会话

DSH 的 session/list 会合并 Host 进程内仍然存活的 Session(ApiSessionList.list 遍历
sessionQuery.listSessions,而后者会把 ctx.sessions 里的每个活体会话并进结果)。插件删除的是
磁盘上的会话文件,没有办法把一个活体会话从 Host 的内存会话表里移除,因此:

  • 如果删除时该会话仍被 DSH 打开着,取消归档 + 重新拉取列表会让它立刻以“未分组”重新出现;
  • 插件的做法是删除后保留归档标记:默认视图会隐藏归档行,所以即使宿主还持有活体会话,该行也不会再出现;
    下一次重启 DSH 后,归档集合里只剩一个无对应会话的 id,不会渲染任何行;
  • 如果你在旧版本插件里已经遇到过“删除了还在”的行,完全退出并重启 DSH 即可清除(只刷新页面不够,
    因为宿主内存里仍然有它)。重启后磁盘上没有该会话,不会再回来。

异常处理

  • 文件被占用(EBUSY / EPERM / EACCES / ENOTEMPTY):自动退避重试 4 次;仍失败时在对话框内显示具体路径、错误码与处理建议,不会静默失败。
  • Windows 活体删除竞态:删除后做验证性复查;复活守卫在约 2 分钟内继续清理被重建的目录。
  • 部分清理失败:会话保留在工作区记账里并取消归档(可见、可重试,不会掉进“未分组且没有删除入口”的死角),对话框保留并显示失败清单,提供「重试清理」按钮。
  • 不是工作区会话 / 跨工作区 / 工作区不存在:Host 直接拒绝并返回可读错误。

技术说明

  • Host 半(lib/index.js)是零运行时依赖的 Cordis 插件:注册 sessionDelete 服务,通过官方 Typert Remote SRC 通道暴露 probe / delete。
  • Client 半(lib/client.js)是 window.__ModuleLoader__.load 格式的浏览器 bundle,只使用平台种子模块:react、react/jsx-runtime、@deepseek-ai/dsh-client-ui-primitives。
  • 菜单槽位:sidebar.workspaces.session.menu.item(order 500)。
  • 对话框与 Toast:shell.overlay。
  • 删除成功后走官方客户端方法 sessions.handleSessionRemoved(id),只做本地移除,不再调用 sessions.refresh()——重新拉取会让宿主仍持有的活体会话以“未分组”复活;只有部分失败(会话仍存在、需要重新显示)时才刷新。

测试

node test/verify.test.mjs

测试使用临时目录,不会访问真实 ~/.dsh。覆盖:路径编码、记忆路径生成、双向重叠检测、单会话删除零误伤、投影缓存清理、活体会话墓碑(保留归档、不再取消归档)、失败停止后的兜底隐藏、记忆重叠拒绝、非工作区会话拒绝、配置校验。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:147-sys/dsh-session-delete` 即可。

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

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

dsh-session-delete 安全吗?

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

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

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

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

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

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

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

dsh-session-delete 有哪些功能?

侧栏一键删除会话、五道安全校验防误删、记忆路径双向重叠拒绝、运行中会话先停止再删、墓碑机制防会话复活。

这条记录的数据可靠吗?

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

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

147-sys 的其它插件

2 个

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