DeepSeek Harness Hub
← 返回列表

会话管理器huajuan2024/dsh-session-manager

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
⚠ 装前注意

DeepSeek Harness DSH 插件:在 Web UI 的「设置 → 插件」里提供一个会话管理面板,

基本兼容但装前注意:npm 同名包「dsh-session-manager」归属 hkkz9522/dsh-session-manager,装到的可能不是本插件 · 最近上游提交 2026/9/17 · 已提供中文文档

DSH 插件,用于列出、查看、删除和导出 DeepSeek Harness 会话历史。

综合分
30.7
GitHub 分
30.7
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add huajuan2024/dsh-session-manager
npm 同名包「dsh-session-manager」归属 hkkz9522/dsh-session-manager,装到的可能不是本插件,改用 GitHub 源安装
数据截至 2026/9/18(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包dsh-session-manager @ 0.5.1
Node 引擎要求 >=22.19 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

npm 同名包「dsh-session-manager」归属 hkkz9522/dsh-session-manager,装到的可能不是本插件

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 10:27:05

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-home-paths@deepseek-ai/dsh-session-query@deepseek-ai/dsh-typert-protocol@deepseek-ai/schemastery
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-session-manager

CI
License: MIT
Awesome DSH Plugin

DeepSeek Harness (DSH) 插件:在 Web UI 的「设置 → 插件」里提供一个会话管理面板,
支持查看历史消息、删除会话、导出单条会话(JSON 或 Markdown)。

架构

- src/index.ts:Cordis Host 服务 ctx.sessionManager,通过 rc.7 正式
ctx.sessionQuery 服务读取会话,负责删除、格式转换,以及 4 个 Remote API
(list / readHistory / delete / export)。
- src/client.ts:Web 客户端插件,通过标准 /api RPC 调用 Host,注册
settings.plugins.tab slot,在「设置 → 插件」里渲染会话列表与详情面板。
- src/types.ts:Host 对浏览器公开的白名单 DTO。
- lib/:由 TypeScript 生成的发布产物,不要手工修改。

安全模型

- 本插件不向模型请求注入内容,因此不会新增 session event。
- 文件操作只发生在 Host 进程,token 或文件绝对路径不会进入 Remote 返回值。
- sessionId 必须是裸 UUID 或匹配 session-,分别兼容新版子代理会话和
传统根会话;其它格式会被拒绝,避免路径穿越。
- 正在运行的会话(running 状态)不可删除,需要先结束会话。

功能

- 列出所有已知会话(含 title / cwd / updatedAt / turns / steps / agentPreset)。
- 点击单个会话查看其消息历史。
- 删除单条会话(运行中的会话会被拒绝;删除不可恢复)。
- 导出单条会话为 JSON 或 Markdown,走浏览器 Blob URL 触发下载。

前置要求

- Node.js 22.19 或更高版本
- DeepSeek Harness 0.1.0-rc.7 兼容版本

构建

pnpm install
pnpm run typecheck
pnpm run build
pnpm run test

安装

从插件目录生成 tarball:

pnpm pack
dsh plugin --profile web add ../../plugin-releases/dsh-session-manager-0.1.5.tgz

Profile 配置

通过 dsh plugin --profile web add 安装 bundle 后,包内 cordis.patch.yml 提供默认
配置。需要覆盖时,在 ~/.dsh/profiles/web/cordis.patch.yml 中使用同一个 id:

- insert:
- id: sessionManager
name: dsh-session-manager
config:
sessionsRoot: ~/.dsh/sessions
maxExportBytes: 10485760
previewMessageLimit: 200

如果文件当前内容只有 [],必须用上面的列表替换 [],不能把列表追加在 [] 后面。
Harness 的后置 patch 会按 id 替换整份 config,因此覆盖时需要写出希望保留的全部字段。

检查最终组合结果:

dsh --profile web --dump-config

配置项

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| sessionsRoot | ~/.dsh/sessions | DSH 会话存档根目录 |
| maxExportBytes | 10485760 | 单次导出的字节上限(10 MiB),超过返回 too-large |
| previewMessageLimit | 200 | readHistory 单次返回的最大消息条数 |

验证

启动 Web profile 后检查:

1. 「设置 → 插件」tab 中出现「会话管理」面板,列出所有会话。
2. 点击行展开,显示消息历史(前 200 条)。
3. 删除按钮在 running 会话上不可点击,其它会话二次确认后可删除。
4. 导出 JSON / Markdown 触发浏览器下载,文件内容与本地 session.jsonl.zstd
解码后内容一致。

故障排查

- session-running:会话正在运行中,无法删除;请先结束该会话。
- not-found:会话目录已不存在,可能已被其他进程清理。
- invalid-session-id:sessionId 既不是裸 UUID,也不符合 session-,请求被拒绝。
- permission-denied:Host 进程没有删除或读取该目录的权限。
- upstream-error:zstd 解压或 JSONL 解析失败,文件可能损坏。
- too-large:会话存档超过 maxExportBytes,已拒绝导出。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群