dsh-archived-sessions
其他 活跃维护

dsh-archived-sessions

MuWinds/dsh-archived-sessions

轻量级归档会话管理插件,可对已归档会话资源执行释放或清除操作,操作逻辑清晰,无需复杂配置即可快速管理冗余会话数据,运行稳定高效,操作响应迅速,可无缝融入开发工作流。

7
Stars 标星
0
Forks 分支
7
Watchers 关注
1
Open Issues
JavaScript
主要语言
MIT
开源协议
15 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:MuWinds/dsh-archived-sessions
git clone https://github.com/MuWinds/dsh-archived-sessions.git
git clone git@github.com:MuWinds/dsh-archived-sessions.git
README.md main

dsh-archived-sessions

归档会话管理(Archived sessions manager)—— DeepSeek Harness Web 界面的设置页扩展,以单 bundle 包分发,一条命令即可安装。

在 Harness 的「设置 → 归档会话」页面中提供:

  • 查看所有已归档会话(标题、创建时间、所属目录、磁盘上的实际文件路径)
  • 每个会话占用的磁盘空间与总占用
  • 释放(取消归档,回到原工作区)—— 单个、批量、一键全部
  • 从硬盘删除会话文件 —— 单个、批量、一键清空(两步确认)
  • 点击会话标题展开查看会话内容(用户 / 助手 / 工具消息预览)

⚠️ 安全提示:本插件包含「从硬盘删除会话文件」能力,删除不可恢复。安装即代表信任本仓库代码会在你的机器上以你的权限运行,请自行审阅源码。

安装(推荐:bundle 一键安装)

本包是一个声明了 dsh.bundle 的插件组合包,纯 JavaScript、无构建步骤,可直接从 GitHub 安装:

dsh plugin --profile web add github:MuWinds/dsh-archived-sessions

然后重启 Harness(npx @deepseek-ai/dsh web)。设置面板底部会出现「归档会话」页面。

纯 JS 包没有 prepare 构建脚本,因此不需要 pnpm allowBuilds 授权。若你习惯锁定版本,可钉住 commit:github:MuWinds/dsh-archived-sessions#<sha>。

从本地目录安装(开发调试)

dsh plugin --profile web add ./dsh-archived-sessions

dsh plugin --profile web remove @muwinds/dsh-archived-sessions 可卸载(同时移除依赖与对应的 bundle 层)。

仓库结构

dsh-archived-sessions/
├── package.json          # dsh.bundle + dsh.client 声明(单包双端)
├── cordis.patch.yml      # 插入一行 archived-sessions(宿主端 + 浏览器端)
├── lib/
│   ├── index.js          # 宿主端插件:webServer 路由 /dsh-archived/* + 全部业务逻辑
│   └── client.js         # 浏览器端插件:设置页 UI(__ModuleLoader__ bundle)
├── README.md
└── LICENSE               # MIT

宿主端 API(POST /dsh-archived/*,无鉴权、同源):

路由 请求体 返回
/dsh-archived/list {} { items, totalBytes }
/dsh-archived/unarchive { sessionId } { ok, changed, archivedSessionIds }
/dsh-archived/delete { sessionId } { ok, deleted, sessionId, path?, sizeBytes?, reason? }
/dsh-archived/detail { sessionId } { id, createdAt, cwd, totalEvents, messageCount, truncated, messages }

发布到 npm registry(可选)

包名使用自己的 scope(@muwinds/dsh-archived-sessions),与官方 @deepseek-ai/* 包区分,可以直接发布到 npm:

npm login   --registry=https://registry.npmjs.org   # 国内镜像只读,发布需显式带官方源
npm publish --registry=https://registry.npmjs.org

发布后用户安装:dsh plugin --profile web add @muwinds/dsh-archived-sessions(npm 安装的是预构建产物,同样无需 allowBuilds)。只走 GitHub 也可以,dsh plugin add github:MuWinds/dsh-archived-sessions 不受影响。

兼容性

  • 目标 Harness 版本:0.1.0-rc.6(web profile 组合结构)。
  • 宿主端插件无第三方运行时依赖(纯 ESM,不 import 任何 @deepseek-ai/*,需要的能力全部从 ctx 获取);浏览器端仅依赖 react(由 Harness 前端运行时提供,属于 platform seed)。

License

MIT