huahai0202/dsh-better-archive 预览 preview

huahai0202/dsh-better-archive

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

DeepSeek Harness(DSH)网页GUI插件:归档会话面板,支持取消归档与删除功能

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to add a full-featured, manageable archived session view to DSH’s Web GUI. It adds an “Archived” entry to both DSH’s settings area and the right sidebar of the session section, with a revocable toast that pops up when a session is archived. To install the plugin, you need DSH version 0.1.5-rc.2 or newer, Node.js 22.19 or higher, and pnpm. You can install it directly by running dsh plugin --profile web add github:huahai0202/dsh-better-archive, then restart dsh web to activate it.

This plugin is for DSH users who regularly archive sessions and need a better way to manage them than the default DSH experience. After archiving a session, you can access the full archived list from either the dedicated settings page or a dedicated tab in the right sidebar. You can group archived sessions by project, search for sessions by keyword, filter by project, and sort them by update time or name. This streamlined interface makes it easy to quickly find any archived session you want to restore or permanently delete.

The plugin is released under the open-source MIT license, so it is free to use, modify, and distribute. It directly reuses DSH’s native UI components, so its appearance, interactions, and theme support match the core DSH experience. It automatically adapts to DSH’s language setting, switching between Chinese and English without requiring a page refresh. Permanent deletion of sessions follows DSH’s native risk confirmation flow, requiring user confirmation before execution, with different handling for cold and active sessions to prevent accidental data loss.

dsh-better-archive 是专为 DeepSeek Harness (DSH) 开发的原生插件,用于为 DSH 的 Web GUI 提供完整可管理的已归档会话视图。它在 DSH 的设置区域和会话区右侧侧边栏各提供一个「已归档」入口,归档会话时右上角会弹出带撤销操作的提示条,支持对归档会话进行查找、筛选、恢复或永久删除。安装需要 DSH 0.1.5-rc.2 及以上版本、Node.js 22.19+ 和 pnpm,可通过 DSH 内置的插件命令直接安装。

该插件面向需要频繁管理大量归档会话的 DSH 用户,解决原生 DSH 归档会话管理体验不完善的问题。日常使用中,用户完成会话归档后,可直接通过侧边栏或设置页的入口进入归档管理界面,可按项目分组查看归档内容,也能通过关键词搜索、按更新时间或会话名称排序,快速定位需要恢复或删除的归档会话,整个流程和 DSH 原生交互保持一致。

该插件遵循 MIT 开源许可,可免费使用、修改和分发。它直接复用 DSH 自身的 UI 组件,外观、交互和明暗主题都和原生 DSH 保持一致,页面文案支持跟随 DSH 的语言设置自动切换中英文,无需额外刷新页面。永久删除会话遵循 DSH 原生的风险确认流程,需要用户勾选确认后才会执行,针对冷会话和存活会话有不同的删除处理逻辑,避免误删重要内容。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 8 stars - very few users, little community feedback星标只有 8,几乎没人在用,遇到问题缺少社区反馈
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:huahai0202/dsh-better-archive

把 huahai0202/dsh-better-archive 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Better Archive

为 DeepSeek Harness (DSH) Web GUI 提供完整、可管理的已归档会话视图。

dsh-better-archive 在 DSH 的设置区域和会话区右侧的 Sidebar 各提供一个「已归档」入口(右侧是 archive 页面类型,从引导页的入口胶囊打开)。归档会话时右上角会弹出可撤销的提示条。你可以查找和筛选归档会话、恢复会话,或按需永久删除不再需要的归档记录。

界面

全部为深色模式。左上起:右侧 Sidebar 的「已归档」tab、设置区的「已归档」一节、右侧 Sidebar 的引导页(入口胶囊)、归档提示条。

右侧 Sidebar「已归档」 设置区「已归档」
右侧 Sidebar 的已归档页面 设置区的已归档页面
引导页入口胶囊 归档提示条
右侧 Sidebar 引导页的已归档入口 归档提示条

功能

  • 在 DSH 设置区提供独立的「已归档」页面。
  • 在会话区右侧的 Sidebar 提供一个「已归档」页面 tab:以 sidebar://archive 页面类型(kind archive)注册,引导页的入口胶囊打开它,chip 带归档图标,正文在面板窄列里沿用同一套搜索 / 筛选 / 排序 / 删除界面。0.7.0 曾引入的左侧一级页面与侧边导航行已在 0.8.1 移除,设置区与右侧栏是仅有的两个入口。
  • 归档会话时右上角弹出提示条,带「查看」(直达右侧 Sidebar 的「已归档」tab)、「撤销」(取消归档)与「关闭」。右侧栏是每会话一份的面,所以当前没有打开的会话时,「查看」会先打开最近的一个会话(一个都没有时由 DSH 新开一个空会话)再打开该 tab。悬停不自动消失。
  • 按项目查看归档会话;支持关键词搜索、项目筛选,以及按更新时间或名称排序。
  • 一键取消归档。归档集合经由 workspace 快照推送,恢复的会话自动回到会话列表(0.8.3 起不再整表刷新,无列表重排闪动)。
  • 支持删除单个会话、某个项目下的全部归档会话,或清空全部归档会话;仍在使用的会话会在重启 DSH 后自动删除。永久删除走 DSH 自己的风险确认:需要先勾选「我已了解」才能按下确认按钮。
  • 多选管理:点击「选择」进入多选模式,点击行或复选框勾选任意多个会话,可配合搜索 / 筛选后「全选」,然后批量取消归档或批量删除;批量删除同样走勾选确认的风险门禁。
  • 页面文案跟随 DSH 的语言设置,中英文切换无需刷新页面。
  • 界面直接使用 DSH 自身的 UI 组件:弹出菜单是 DSH 的 Menu,永久删除确认是 DSH 的 RiskConfirmation,按钮、图标与卡片沿用同一套基础组件,因此外观、交互、键盘行为与明暗主题都和 DSH 保持一致。

界面实现

浏览器端不自己实现弹层与对话框,而是 require('@deepseek-ai/dsh-client-ui-primitives') 并直接渲染 DSH 自己的组件:

界面元素 使用组件
排序 / 项目筛选下拉、项目行「⋯」菜单 Menu(锚点定位、点击外部关闭、Esc 关闭、选中打勾)
多选模式的行复选框 原生 input 复刻 DSH Checkbox 模块 CSS(该组件不透传 aria-* / tabIndex);行本体是 role="checkbox" 的可操作控件,支持点击与 Space/Enter
排序 / 项目筛选下拉的触发器 Button(ghost 形状)+ DSH 设置页选择器同款底色 --dsw-alias-bg-module-platform
永久删除确认(单个 / 整个项目 / 全部) RiskConfirmation(基于 Modal,自带警告图标、勾选确认与「确认按钮在勾选前保持禁用」的门禁)
全部删除、取消归档、图标按钮 Button(outline / ghost 变体与 sm / md 尺寸)
归档提示条 自建外壳(DSH 的 Toast 只支持文字+图标,没有按钮位),取 DSH 的菜单表面、elevation 与「solid」反色药丸配方;内含 IconArchiveOutlineRegular 与 Button
右侧 Sidebar「已归档」tab ctx.sidebarRightTabs 注册页面类型(kind archive,引导页入口胶囊)+ keyed sidebar.right.pane.tab 正文与 sidebar.right.pane.tab.title chip 图标;正文接收框架注入的 useSessions / useWorkspaces,按面板窄列自适应布局;提示条「查看」经 ctx.sidebarRight.openTab('archive') 打开它。该列每会话一份,因此主视图没有会话时「查看」先经 ctx.uiWorkspace.openSession 打开最近的非归档会话(一个都没有时 startSession 新开一个空会话),再等 seat 挂载后打开 tab;是否有会话打开读会话摘要的 retainedBy.mainView(会话列表快照本身没有 current 字段)
图标 IconArchiveOutlineRegular、IconTrashOutlineRegular、IconSearchOutlineRegular、IconChevronDownOutlineRegular、IconEllipsisOutlineRegular、IconFolderOpenRegular、IconCloseOutlineRegular(dsh 0.1.7 的尺寸中性权重名,Regular 为 1px 描边)

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-network-proxy 下一个 Next dsh-superpowers →