dsh-archive-purge

DSH PLUGIN工具与能力

仓库 joyboy-yy/dsh-archive-purge

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

dsh-archive-purge 是 joyboy-yy 维护的 工具与能力 类 DSH 可安装插件, 仓库为 joyboy-yy/dsh-archive-purge,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

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

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

安装

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

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

适用场景

存储

上游标签

cordisdeepseek-harnessdshdsh-pluginsession-management

验证等级与安全审查

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

选择建议

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

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

仓库档案

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

README 全文

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

dsh-archive-purge

已归档会话的强制隐藏与统一管理:把它们彻底挡在会话列表之外,给它们一个管理面板,并补上 DSH 本身不提供的彻底删除。

> npm 上的 dsh-archive-manager 是另一个不相干的插件。本插件是 dsh-archive-purge。

本文所有截图都由虚构的会话渲染——没有真实的标题、路径或体积。

它补上的两个缺口

DSH 能归档会话,但是:

  • 归档只是显示层的事。 只要侧栏「视图选项 → 归档显示」被切成显示已归档,已归档行就会继续渲染,归档搜索结果里也一样。没有一个开关的意思是「永远别显示这些」。
  • 没有任何删除会话的路径。 dsh-client-ui-workspace 未提供会话删除,dsh-session-persistence 也没有删除 seam,于是已归档会话会在磁盘上无限堆积。

本插件两件都补上:把已归档会话钉在列表之外,并接管删除路径。

安装

dsh plugin --profile desktop add dsh-archive-purge

把 desktop 换成你自己的 profile 名(例如 web)。然后在设置 → 插件里打开它,那一行显示为 dsh-archive-purge;关掉即同时停用宿主路由与浏览器面板,会话数据不受影响。

它做什么

行为
强制隐藏 侧栏会话列表中,任何已归档会话行都不再显示——无论「视图选项 → 归档显示」被切成什么。做法是 shell.overlay 上一个常驻组件按注册表里的 archivedSessionIds 动态写入 [data-row-key="session:"]{display:none},另外附带按无障碍描述匹配的兜底规则(覆盖搜索结果行)。
筛选复位 浏览器持久化的 dsh.workspace.view.v5 里,archivedFilter 会被复位回出厂默认 default(即「隐藏已归档」),这样菜单不再显示成「全部对话(显示已归档)」而实际看不到东西。
管理面板 侧栏面板图标 →「已归档管理」:统一列出全部已归档会话,含工作区、路径、磁盘占用、创建时间、子会话数;支持搜索、多选、批量取消归档。
彻底删除 逐条或批量彻底删除,弹窗二次确认(列出会话、体积、将删除的内容)。

面板的配色取自宿主的 --dsw-alias-* token,并内置中英两套文案,因此它跟随应用当前的主题与语言,而不是自带一套外观。

彻底删除的确切边界

一次删除会移除四样东西:

  1. 会话日志目录 /sessions/<项目目录>/<编码后的会话 id>/——该会话自有目录及其全部格式代际与本地产物;
  2. 投影缓存记录 /storages/session_projcache/sessions/.json;
  3. 归档与置顶登记(workspace registry 的 archivedSessionIds / pinnedSessionIds);
  4. 浏览器里那一行——通过会话控制器自己已声明的远程事件 api-session/removed(@mode emit)通知客户端移除,而不是留下一行点开报错的幽灵行。

刻意保留:附件文件。附件按内容寻址、可能被其它会话共享,故不在此范围内(面板底部也写明了这一点)。磁盘上已无日志的归档项只会被清理登记,按钮文案会变成「清理登记」。

拒绝条件(先于任何写入)

批量操作会逐类报告结果:删掉了哪些、释放了多少,哪些已无日志可删,哪些被拒绝——被拒的会具名列出并给出原因。

  • 会话不在归档集合里 → 跳过。删除只对已归档会话开放,这是最重要的一道闸。
  • 本进程中仍存在该会话的 Agent(ctx.agents.get(id))→ 拒绝(live)。Agent 可能已打开该日志的写入句柄,删文件会让写入方把日志「复活」。
  • workspace/session-activity 瀑布仍报告进行中的工作 → 拒绝(active)。
  • 目标目录必须位于配置的会话根目录之内,且目录名正好是该会话 id 的编码形式,否则拒绝(outside-root)。

注意「仅被加载」不构成拒绝理由:浏览器为每个渲染中的会话行保留一份内存镜像,且从不释放,若据此拒绝,浏览久了之后所有已归档会话都会变成不可删除。判据与 DSH 自身的归档闸门(activity 瀑布)一致,另加一条更便宜的 Agent 检查。被跳过/失败的会话会在面板里逐条列出原因。

界面残留(幽灵行)与两层修复

DSH 的浏览器会话列表是事件驱动的:它只会因 api-session/added/removed 增删条目,自己没有「重新拉取并丢弃缺失项」的路径。而被删除的会话同时会离开归档集合,于是它在侧栏里从「被隐藏」变成「该显示」——缓存里那一行就变成了可见、可点、点开报 session/not-found 的幽灵行。

本插件用两层消除它:

  • 宿主层(权威):删除成功后,在写归档集合之前 ctx.emit('api-session/removed', id)。这是会话控制器自己为这个事实定义并转发的远程事件,客户端拿到的是一条 { kind: 'remove', sessionId } 变更,于是该行被真正从列表移除。发在改登记之前,是为了避免「先取消归档把它露出来、再消失」的闪烁。
  • 客户端层(自愈兜底):清单里多带一份 persistedIds(宿主持久化层真正认识的会话 id)。面板把浏览器缓存的 id 与它做差集,把差集行一并纳入隐藏规则,并在标题下显示数量;差集每次读取都重算(不是并集),因此一次读失败不会永久藏掉一个活着的会话。本次页面内自己删掉的 id 另存一份并集——它不依赖任何读取,立即生效。

如果你在装上这两层之前就删过会话:那些残留行需要一次页面刷新(客户端会重新向宿主拉列表)才会消失;之后的删除不再留下它们。

已知残留

  • 工作区成员数组里的悬空 id:tables.workspaces..sessionIds 是持久化的成员数组,宿主没有提供「移除某个成员」的接口(insertSessionBefore 只做插入与排序),因此被删会话的 id 会留在里面。DSH 自身容忍缺失成员(派生行时查不到摘要就跳过),所以它不会渲染成任何一行;这属于登记层面的残留,不是界面问题。
  • Agent 生命周期:归档只「停止 + 隐藏 + 加一道禁止运行的持久闸门」,不销毁 Agent;Agent 的回收点是 agent-loop provider 卸载或进程退出。所以在同一个 DSH 进程里刚归档过的会话仍会被本插件拒绝删除,重启后可删。详见上文「拒绝条件」。

维护备注

  • 宿主半侧为了让删除精确落点,逐字复制了 dsh-session-persistence-jsonl 里的纯函数 encodeSegment。DSH 升级若改动会话目录布局,这个函数必须跟着改;在此之前,删除会因「目录名不等于编码后的会话 id / 目录内没有会话日志」而拒绝执行,而不是删错东西。
  • 客户端半侧的隐藏规则依赖侧栏会话行的 data-row-key="session:" 属性(dsh-client-ui-workspace 自己加的稳定标记),以及已归档行/搜索结果行上的 aria-description 文案。前者变化时,aria-description 兜底规则仍然生效。
  • 没有构建步骤,也没有运行时依赖:两半都是直接发布的纯 ESM,宿主半侧除了 Node 内置模块不导入任何东西。
  • 宿主半侧的代码改动不会热重载(Node 的 ESM 缓存按路径命中),改完 index.js 需要重启 DSH 或通过插件页面重新启用该 bundle 来生效;client.js 会被客户端 HMR 自动替换。

已知取舍

  • 内置「视图选项 → 归档显示」的三个选项仍然存在,但由于已归档行被强制隐藏,选「全部对话(显示已归档)」不会再让它们出现在侧栏——这是需求「已归档必须隐藏 + 统一在管理面板里管理」的直接结果。
  • 删除不会级联删除由该会话 fork 出的子会话;面板会在行上标出子会话数量作为提示。
  • 非中文/英文语言环境下,相对时间与兜底 CSS 使用英文/中文两套文案中的一套。

开发

没有构建步骤——两半都按写好的样子直接发布。改完这样检查:

npm test

npm test 跑 29 个测试,基于 node --test、零依赖。test 目录不进发布包。

  • test/smoke.test.mjs 用桩上下文驱动两半,盯的是重命名会静默破坏的那几个不变量:客户端注册所用的模块 id、宿主挂载与客户端调用的路由前缀、面板占用的 slot key,以及按 id 生成的那条隐藏规则。
  • test/host-delete.test.mjs 拿一个临时 DSH_HOME 跑真实路由,日志目录与投影缓存记录都是真的建、真的删。它把每一条拒绝都钉在做出该判断的分支上,验证被拒绝时磁盘分毫未动,并固定住宿主所承诺的顺序——先广播移除,再改写归档集合。
  • test/package.test.mjs 拿 manifest 与发布文件集对账:DSH 运行时解析的每一样东西——入口、./client 导出、bundle patch——都必须列在 files 里,且不允许存在任何会触发构建授权的安装期脚本。

许可证

MIT

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:joyboy-yy/dsh-archive-purge` 即可。

dsh-archive-purge 的验证等级是什么意思?

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

dsh-archive-purge 安全吗?

低风险。

dsh-archive-purge 装之前要先确认什么?

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

dsh-archive-purge 用的是什么许可证?

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

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 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 星

joyboy-yy 的其它插件

3 个

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